Интеграция с Jira

Коннектор умеет не только переносить репозитории. Он подключает вашу Jira — и тогда команда работает с Buff, не выходя из привычного тикета: упомянули бота в комментарии, получили ответ там же.

Как и с git, доступ к Jira остаётся у вас. Токен лежит на машине, где запущен агент, и к нам не попадает — агент ходит к Jira изнутри вашей сети.

Что поддерживается

Способ входа агент выбирает сам, спросив вашу Jira о её версии:

Если вы дадите токен старой Jira, мастер так и скажет, назвав найденную версию, и предложит переключиться на логин с паролем. Гадать не придётся.

Настройка

Настраивается всё в самом коннекторе — там же, где провайдеры git. Подойдёт любой из трёх способов: веб-интерфейс, терминал или YAML.

Шаг 1. Доступ к Jira

Укажите адрес вашей Jira и токен, затем нажмите «Проверить доступ».

Шаг 2. Проекты

Агент сходит к вашей Jira и покажет, что нашёл: версию, редакцию и от чьего имени он вошёл. Ниже — список проектов галочками: ключи проектов вводить руками не нужно, опечатки исключены.

Здесь же задаются:

• Название интеграции — под ним идут списания и им подписаны ответы. Понадобится, если у вас несколько привязок.
• Проект разработки — тот проект в Buff, куда попадают вопросы и задачи из этой Jira.

Одна интеграция = один проект разработки. Если Jira одна, а проектов разработки несколько — заведите несколько интеграций с разными наборами проектов Jira.

Шаг 3. Как получать события

Два независимых способа, оба можно включать и выключать галочкой:

Опрос — агент сам раз в несколько секунд спрашивает Jira, что изменилось. Работает всегда и не требует ничего открывать наружу. Это вариант по умолчанию и подходящий для закрытых сетей.

Вебхуки — Jira сама сообщает агенту об изменении. Отвечает быстрее, но нужен порт, до которого Jira дотянется. Включив вебхуки, укажите:

• Слушать на — адрес и порт на этой машине (например 0.0.0.0:8766);
• Адрес, по которому Jira достучится сюда — как этот порт виден со стороны Jira. Агент не может это угадать: за NAT или обратным прокси адрес другой.

Шаг 4. Ссылка для вебхука

После сохранения интеграция появится в списке — с готовой ссылкой и кнопкой «Скопировать».

Вставьте её в Jira: Администрирование → Система → Вебхуки → Создать вебхук. Отметьте события «Issue updated» и «Comment created»; при желании сузьте охват JQL-фильтром по нужным проектам.

Как пользоваться

Упоминание в комментарии

Упомяните бота в комментарии и напишите, что нужно. Текст вокруг упоминания тоже учитывается — можно сначала описать контекст, а потом попросить.

Упомянуть можно двумя способами, оба работают одинаково:

• Через автодополнение Jira — начните печатать @ и выберите учётную запись бота. Jira вставит настоящее упоминание, оно выглядит ссылкой и бот получит уведомление. Так — на скриншоте выше.
• Просто текстом @buff — короче, но для Jira это обычный текст: ни ссылки, ни уведомления. Бот всё равно ответит.

Без команды это вопрос — самый частый случай, поэтому он и по умолчанию.

Повторное упоминание в том же тикете продолжает тот же разговор: можно уточнять и переспрашивать, не начиная с нуля.

Метки

Вместо упоминания можно повесить на тикет метку:

Тема тикета при этом и есть запрос. Метки срабатывают в момент, когда их вешают — метка, которая уже висела, ничего не запускает. Поэтому включение интеграции не приводит к лавине запусков по всем открытым тикетам.

Совпадение ищется по целым словам: buff-task-urgent сработает, buff-tasks — нет.

Назначение

Назначьте тикет на учётную запись бота — он возьмётся за него как за вопрос. Как и с метками, срабатывает сам момент назначения.

Что бот пишет в тикет

1. Сразу — короткое «принял, работаю». Исследование идёт минутами, и без этого непонятно, услышал ли бот вообще.
2. Ссылку — на черновик, обсуждение или исследование в Buff. Она попадает в блок Links самого тикета, а не тонет в ленте комментариев. Повторный ответ обновляет ту же ссылку, а не плодит дубликаты.
3. Результат — готовый ответ или документ, комментарием.

Если что-то не получилось, бот об этом тоже напишет: молчание читалось бы как поломка.

Статусы тикета бот не трогает — это ваш рабочий процесс, и лезть в него он не должен.

Что дальше

• task из Jira создаёт черновик, а не запускает разработку. Согласование формулировки — осознанный шаг, и он остаётся в Buff.
• Списания идут на интеграцию, а не на человека: пользователи вашей Jira — не пользователи Buff.

Если что-то не работает

Состояние интеграций видно там же, где вы их заводили — в веб-интерфейсе агента. Менять список проектов и токен можно на лету, без перезапуска.