Bitbucket Cloud

Интеграция связывает Buff с вашим рабочим пространством на bitbucket.org. Разработчик пишет боту в обсуждении pull request — ответ приходит туда же и разобран по коду ИМЕННО этой ветки. Своего трекера задач у Bitbucket Cloud больше нет: Atlassian убрал его из API, поэтому обращения живут в pull request — как и у Bitbucket Data Center, для которого есть отдельная интеграция со своим API. Задачи вашей команды подключаются отдельной интеграцией того трекера, в котором они на самом деле лежат.

• Вопрос по коду прямо в ревью

  Ревьюер открыл чужой pull request и не понимает, зачем понадобилась правка сразу в трёх местах. Спрашивать автора — ждать до завтра, читать ветку самому — полдня.

  Результат. Он пишет боту в обсуждении. Ответ приходит туда же и разобран по коду ЭТОЙ ветки: что меняется, почему связаны три места и на что это влияет.

• Что здесь меняется по существу

  Pull request на восемьсот строк, а вопрос простой: что меняется по делу и чего не хватает.

  Результат. Бот читает изменения одним diff и отвечает по существу — что меняется, что осталось недоделанным, где тесты не покрывают новую ветку кода.

• Задачи лежат в другом трекере

  Своего трекера у Bitbucket Cloud больше нет — Atlassian убрал его, — а задачи команды живут в Jira, GitLab или Redmine.

  Результат. Ревью остаётся в Bitbucket, задачи — там, где они есть: интеграция того трекера ставится рядом, и бот отвечает в обоих местах. Подключений может быть сколько угодно.

• Ответ там, где его ждут

  Заказчик правки не заходит в интерфейс Buff и не собирается. Ему нужен ответ в том обсуждении, которое он открыл.

  Результат. Готовый разбор или ссылка на задачу разработки приходит комментарием туда же. Единственный инструмент интеграции, который что-то пишет, — и он недоступен на стадиях, где модель только читает.

1. @buff, что меняет этот pull request и чего в нём не хватает?

   комментарий в обсуждении pull request

   инструмент: get_pull_diff

   Ветка добавляет сборку выгрузки в CSV: новый модуль export.py, который берёт товары в наличии и считает цену со скидкой. Не хватает тестов на пустой каталог и на товар без скидки; заголовок ответа отдаётся без charset — на кириллице это тот же старый баг.

2. @buff, зачем здесь понадобился отдельный кеш?

   комментарий в обсуждении pull request

   инструмент: get_pull

   Прочитал pull request вместе с обсуждением: кеш появился после жалобы на задержку выгрузки, обсуждали два варианта и выбрали этот, чтобы не трогать общий слой. В описании это есть только одной строкой, остальное — в комментариях.

3. /task доделать тесты на пустой каталог

   комментарий в обсуждении pull request

   инструмент: get_pull

   Слово после обращения выбирает работу: без него — короткий ответ, «research» — глубокое исследование с документом, «task» — черновик задачи разработки со ссылкой обратно в это обсуждение.

4. @buff, найди pull request про кеширование каталога

   комментарий в любом отмеченном репозитории

   инструмент: search_pulls

   Нашёл три: открытый «TTL для кеша каталога», влитый «прогрев кеша после деплоя» и закрытый без слияния — там от кеша отказались в пользу материализованного представления, и это стоит прочитать до того, как повторять.

1. Шаг 1

   Установка занимает одно нажатие

   Откройте раздел «Маркетплейс» на локальной странице коннектора. До установки видно, что интеграция получит: адреса, по которым она сможет ходить, какие учётные данные попросит и сколько инструментов увидит модель. Коннектор скачивает подписанный бандл из нашего реестра и проверяет подпись до того, как что-то запишет на диск.

   Коннектор

   

2. Шаг 2

   Настройка — учётная запись, токен и список репозиториев

   Адрес API уже подставлен (`https://api.bitbucket.org`) — он существует как поле ровно затем, чтобы было видно, куда ходит интеграция. Дальше нужны учётная запись бота и её пароль приложения (или API-токен), а также репозитории в виде `пространство/репозиторий`. Секрет хранится на вашей машине; интеграция его не видит.

   Коннектор

   

3. Шаг 3

   Заведите боту отдельную учётную запись

   Пригласите её в рабочее пространство и дайте доступ только к нужным репозиториям: права учётной записи — внешняя граница, а список отмеченных репозиториев — внутренняя. Паролю приложения достаточно прав на чтение репозиториев и запись в pull request и задачи.

4. Шаг 4

   То же самое из командной строки

   Установка без графики равноправна, а не запасной вариант: `connector install bitbucket-cloud`, затем `connector instance add bitbucket-cloud --config base_url=https://api.bitbucket.org --config repos=acme/api`.

5. Шаг 5

   События приходят сами

   После настройки ничего запускать не нужно: интеграция сама следит за отмеченными репозиториями. Хотите быстрее — включите приём событий у коннектора и добавьте в Bitbucket вебхук на комментарии к pull request и задачам. Bitbucket Cloud свои вызовы не подписывает, поэтому пропуском служит секрет в самой ссылке — коннектор выдаёт её сам и никому больше не показывает.

   Коннектор

   

Интеграция работает отдельным процессом под собственным пользователем операционной системы: она не видит ключа коннектора, не читает файлы других подключений и не может выйти в сеть мимо коннектора. Подробнее — в разделе о безопасности.

• Bitbucket Cloud (bitbucket.org). Для Data Center и Server — отдельная интеграция: у них другой API.
• Учётная запись бота в вашем рабочем пространстве и её пароль приложения или API-токен с правом читать репозитории и писать комментарии.
• Сетевой доступ от машины с коннектором до bitbucket.org — наружу из вашей сети ничего открывать не нужно.
• Коннектор, запущенный с правом заводить отдельного пользователя ОС для интеграции (root или CAP_SETUID).
• Чтобы ответы разбирались по коду, подключите те же репозитории к Buff как источник кода — тем же коннектором, в разделе «Репозитории».

У нас Bitbucket Server, а не облако. Подойдёт?

Нет, для Data Center и Server есть отдельная интеграция — у них другой API. На витрине она называется Bitbucket Data Center.

Пароль приложения уходит к вам в облако?

Нет. Он хранится на машине с коннектором и не покидает её. Интеграция тоже его не видит: коннектор подставляет его в исходящий запрос сам.

У части репозиториев трекер задач выключен. Это сломает интеграцию?

Нет. Там, где трекера нет, интеграция просто работает в pull request. Проверка связи прямо говорит, у скольких отмеченных репозиториев трекер включён.

Bitbucket не подписывает вебхуки. Как вы отличаете чужой вызов?

Пропуском служит секрет внутри самой ссылки — её выдаёт коннектор, она не угадывается и не показывается никому, кроме вас. Вызов с неверной ссылкой не доходит до интеграции вовсе.

Бот будет менять статусы и закрывать задачи?

Нет. Интеграция читает и пишет комментарии. Статусы, ревьюеры и слияние остаются за вашей командой.