Интеграция связывает компанию с внешней системой, где идет разработка, и показывает на задачах то, что там происходит: ветки, коммиты, пул-реквесты и их состояния.
Что общего у всех интеграций
- Только чтение. Во внешнюю систему ничего не уходит: ни комментарии, ни метки, ни статусы. Поэтому правило автоматизации, разбуженное событием интеграции, не может вызвать новое событие той же интеграции.
- Подключает компания, выбирает проект. Подключение делается в Администрировании, и его может сделать тот, у кого есть право "Настраивать компанию". Репозитории проекта выбирают в настройках проекта, и это может тот, кто управляет доступом к нему.
- Связь по ключу задачи. Продукт читает имена веток, заголовки пул-реквестов и тексты коммитов, находит в них ключ задачи и связывает найденное с этой задачей. Ключ должен принадлежать проекту, который смотрит на этот репозиторий.
- Люди показываются как записаны там. Автор коммита показывается под тем именем, которое записано во внешней системе, и пользователем продукта не становится.
- Поиск задач идет по задачам. QQL спрашивает о задачах; ветки и коммиты видны на задаче, к которой привязаны.
- Ничего чужого не хранится. Тело каждой доставки стирается сразу после чтения. Токен человека, которым проверяется право на установку, нигде не сохраняется.
- Связь, снятую руками, продукт сам не возвращает. Кнопка "Убрать связь" есть у любой связи; после нее события по этому пул-реквесту или этой ветке к этой задаче больше не привязываются, пока кто-нибудь не привяжет их снова по ссылке.
Системы
| Система | Что читает |
|---|---|
| GitHub | Ветки, коммиты, пул-реквесты, отзывы, проверки |
Следующая система становится новой страницей этого раздела и новой строкой этой таблицы.