Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
В этой статье вы узнаете, как связать рабочие элементы с коммитами GitHub, pull-запросами и ветками после того, как вы подключите проект Azure Boards к репозиторию GitHub. Вы можете использовать синтаксис #mention для коммитов и веток или добавить коммит GitHub, пул-реквест или ссылку на ветку из рабочего элемента Azure Boards.
Note
Поддержка интеграции GitHub:
- Azure DevOps Services: интегрируется с репозиториями GitHub.com и GitHub Enterprise Server с помощью приложения Azure Boards для GitHub.
- Azure DevOps Server 2020 и более поздних версий: поддерживает интеграцию только с репозиториями GitHub Enterprise Server.
- Другие репозитории Git: интеграция не поддерживается.
Prerequisites
| Category | Requirements |
|---|---|
| Permissions | участник как в проекте Azure Boards, так и в репозитории GitHub. |
| Подключение к проекту | Проект Azure Boards подключен к репозиторию GitHub, в котором находятся фиксации, запросы на вытягивание и ветви, к которым или от которых вы хотите создать ссылки. Дополнительные сведения см. в статье об интеграции Azure Boards-GitHub. |
Note
Проекты, использующие модель процесса Hosted XML, требуют обновления типов рабочих элементов для просмотра раздела разработки и типов ссылок GitHub. Дополнительные сведения см. в разделе "Обновление xml-определений" для выбора типов рабочих элементов.
Используйте AB# для связи рабочих элементов Azure Boards с GitHub.
Для создания ссылки на рабочий элемент Azure Boards из коммита GitHub, пул-реквеста или задачи используйте следующий синтаксис. Введите AB#ID в текст сообщения фиксации. Или для пулл-реквеста или ишью введите AB#ID в описании. Использование AB#ID в заголовке комментария или запроса на слияние не создает ссылку на рабочий элемент.
AB#{ID}
Например, AB#125 ссылается на рабочий элемент с ID 125.
Вы также можете ввести сообщение коммита или пулл-реквеста для перевода рабочего элемента в другое состояние. Система распознает {state} или {state category}, а также fix, fixes, fixed, и применяет это к элементу #-упоминания, который следует как следующий.
Если описание запроса на вытягивание содержит допустимое имя состояния, например, Closed AB#1234, система обновляет указанный рабочий элемент к этому конкретному состоянию. Если имя состояния не распознается напрямую, Azure Boards пытается сопоставить его с категорией рабочего процесса, например Resolved или Completed. Если совпадение найдено, рабочий элемент переходит в первое доступное состояние, определенное в этой категории.
По умолчанию рабочие элементы, на которые ссылаются fix, fixes или fixed, переходят в первое состояние, связанное с категорией Решенной. Если такое состояние отсутствует в текущем процессе, система вместо этого переместит рабочий элемент в первое состояние в категории "Завершено ".
Important
Вы по-прежнему можете связать рабочие элементы и нацеливаться на другие ветви, но правила перехода состояния не применяются, если только запрос на вытягивание не объединен в ветвь по умолчанию.
Для получения дополнительной информации смотрите как используются состояния категорий рабочих процессов в бэклогах и досках Azure Boards.
Ознакомьтесь со следующей таблицей примеров:
| Сообщение о фиксации или пул-реквесте. | Action |
|---|---|
Fixed AB#123 |
Связывает и перемещает рабочий элемент в категорию состояния разрешенного рабочего процесса или, если он не определен, то категория состояния завершенного рабочего процесса. |
Closed AB#123 |
Связывает и перемещает рабочий элемент в состояние закрытого рабочего процесса. Если ни один из них не определен, переходы не выполняются. |
Adds a new feature, fixes AB#123. |
Связывает и перемещает рабочий элемент в категорию состояния разрешенного рабочего процесса или, если он не определен, то категория состояния завершенного рабочего процесса. |
Fixes AB#123, AB#124, and AB#126 |
Ссылки на рабочие элементы Azure Boards 123, 124 и 126. Переходит только первый элемент, 123 в категорию состояния Resolved рабочего процесса или, если он не определен, то категорию состояния Completed рабочего процесса. |
Fixes AB#123, Fixes AB#124, Fixes AB#125 |
Ссылки на рабочие элементы Azure Boards 123, 124 и 126. Перемещает все элементы в категорию состояния рабочего процесса «Разрешено» или, если она не определена, то категорию состояния рабочего процесса «Завершено». |
Fixing multiple bugs: issue #123 and user story AB#234 |
Ссылки на проблему GitHub 123 и рабочий элемент Azure Boards 234. Переходы не осуществляются. |
Note
Если вы подключили один и тот же репозиторий GitHub к проектам, определенным в двух или более организациях Azure DevOps, вы можете увидеть непредвиденную ссылку на упоминание AB#. Дополнительные сведения см. в разделе "Устранение проблем с подключением". По этой причине рекомендуется подключить репозиторий GitHub только к проектам, определенным в одной организации Azure DevOps.
При добавлении ссылки на рабочий элемент с помощью AB#эти ссылки отображаются в разделе "Разработка " запроса на вытягивание.
Создание ветви GitHub из рабочего элемента
Чтобы создать ветвь GitHub непосредственно из рабочего элемента, сделайте следующее:
На вашей доске найдите рабочий элемент, из которого вы хотите создать ветвь GitHub.
Выберите
Действия рабочего элемента>Новая ветвь GitHub.
В диалоговом окне "Создание ветви GitHub" введите имя ветви и выберите репозиторий GitHub и базовая ветвь.
Нажмите кнопку "Создать".
Azure Boards создает ветвь в указанном репозитории GitHub и связывает ее с рабочим элементом. Дополнительные сведения см. в статье об интеграции Azure Boards-GitHub.
Добавить ссылку на рабочий элемент в ветвь GitHub, коммит или pull request
Откройте рабочий элемент и перейдите на вкладку "Ссылки ".
В диалоговом окне «Добавить ссылку», выберите один из типов ссылок GitHub, выберите репозиторий GitHub, введите URL-адрес ветки, коммита или запроса на вытягивание в GitHub, а затем выберите «Добавить ссылку».
В следующем примере мы добавляем ссылку на пулл-реквест GitHub.
Azure Boards завершает проверку, чтобы убедиться, что вы ввели действительную ссылку. Репозиторий GitHub, на который имеется ссылка, должен быть подключен к проекту Azure Boards, иначе проверка не проходит.
Note
Если вы используете Azure DevOps Server и GitHub Enterprise Server, возникает задержка при завершении работы с ссылками AB#. У нас есть двунаправленный механизм для получения событий GitHub каждый час, чтобы отслеживать добавочные изменения в коммитах, PR и задачах.
Автоматическое обновление ссылок
Несколько событий автоматически обновляют ссылки в форме рабочего элемента, поэтому их не нужно создавать вручную. К ним относятся:
| Событие GitHub | Action |
|---|---|
| Ссылка на ветвь | При создании запроса на вытягивание из ветви он автоматически связывается с рабочим элементом. |
| Фиксация слияния | После объединения запроса на вытягивание результирующая фиксация слияния автоматически связывается с рабочим элементом. |
| Удаление ветви | Если ветвь удаляется (обычно после объединения), ее ссылка автоматически удаляется из рабочего элемента. |
Просмотр или открытие ссылок из раздела "Разработка"
В разделе "Разработка" в форме рабочего элемента перечислены ссылки, созданные к коммитам GitHub и запросам на вытягивание, обозначенные значком 
GitHub.
Выберите указанную ссылку для открытия коммита или пул-реквеста в GitHub.
Просмотр объектов GitHub на доске
С включенными аннотациями GitHub на доске вы можете быстро открывать связанные коммиты GitHub, запросы на вытягивание или задачи для получения более подробной информации. Дополнительные сведения см. в разделе "Настройка карточек".
