GitHub: пул-реквесты рядом с задачами
Как подключить репозиторий GitHub к проекту, чтобы пул-реквесты находили свои задачи и их состояние было видно на карточке задачи.
Если команда ведёт код в GitHub, Syncra может показывать пул-реквесты прямо на карточке задачи. Пул-реквест — это предложение изменений в коде, которое проверяют перед тем, как влить в основную ветку. Чтобы узнать, открыт он, влит или закрыт, не нужно идти в GitHub.
Репозиторий подключают к каждому проекту Syncra отдельно.
Как подключить репозиторий
Подключать и отключать репозиторий могут владелец и администратор рабочего пространства. Остальные участники видят поле, но не могут его менять.
- Откройте настройки проекта и найдите раздел «GitHub».
- В пустом поле этого раздела стоит подсказка
owner/repository. Введите туда название в видевладелец/репозиторий, напримерacme/site. Ссылка на репозиторий целиком не подойдёт. - Нажмите «Сохранить». Появится сообщение «Репозиторий GitHub сохранён».
К проекту подключается один репозиторий. Один и тот же репозиторий нельзя подключить к двум проектам: Syncra ответит, что он уже подключён к другому. Чтобы отключить, нажмите «Отключить» в том же разделе. Появится сообщение «Репозиторий GitHub отключён».
Как пул-реквест находит задачу
У каждой задачи в Syncra есть короткий номер, например SYN-298. Syncra ищет в пул-реквесте номер задачи из подключённого проекта. Порядок такой:
- в названии пул-реквеста;
- если там нет, в названии ветки;
- если и там нет, в описании.
Syncra сверяет только номер. Если в пул-реквесте написано похожее название задачи, но номера нет, связи не будет. Поэтому называйте ветки и пул-реквесты с номером задачи, например SYN-298 Исправить вход.
Что вы увидите в Syncra
Откройте карточку задачи. В ней появится строка «Пул-реквесты» и состояние каждого связанного пул-реквеста:
- «Открыт»
- «Влит»
- «Закрыт»
Чего здесь нет
- Подключить можно только репозиторий, а не всю организацию на GitHub.
- Одного сохранённого названия репозитория мало. Пул-реквесты появятся в задачах, только когда GitHub начнёт отправлять в Syncra события о них, а экрана, где это включают, в настройках Syncra нет. Чтобы настроить передачу событий для вашего репозитория, напишите команде Syncra в Telegram: https://t.me/morzac.
- Влитый пул-реквест не закрывает задачу сам. Отметьте её выполненной вручную.
Что ещё почитать
Обновлено: