Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Сервисы Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022
Из этой статьи вы узнаете, как связать рабочие элементы с коммитами GitHub, пулл-реквестами, ветками и сборками после того, как подключите проект Azure Boards к репозиторию GitHub. Вы можете использовать синтаксис #mention для фиксаций и ветвей, применять упоминания ! для ссылки на GitHub pull requests из обсуждений рабочих элементов, или добавить ссылку на фиксацию, pull request или ветвь GitHub непосредственно из рабочего элемента Azure Boards.
Note
GitHub поддержка интеграции:
- Azure DevOps Services: интегрируется с репозиториями GitHub.com и GitHub Enterprise Server через приложение Azure Boards для GitHub.
- Azure DevOps Server 2020 и более поздних версий: поддерживает интеграцию только с репозиториями enterprise Server GitHub.
- Другие репозитории Git: интеграция не поддерживается.
Prerequisites
| Category | Requirements |
|---|---|
| Разрешения | Участник в проекте Azure Boards и в репозитории GitHub. |
| Подключение к проекту | Проект Azure Boards подключен к репозиторию GitHub, где находятся коммиты, пулл-реквесты и ветвь, с которой или к которой вы хотите связать. Дополнительные сведения см. в интеграции Azure Boards-GitHub. |
Note
Чтобы просмотреть раздел "Разработка" и типы ссылок GitHub, проекты, использующие модель размещенного XML-процесса, нуждаются в обновлении типов рабочих элементов. Дополнительные сведения см. в разделе "Обновление xml-определений" для выбора типов рабочих элементов.
Используйте AB# для ссылки из GitHub на рабочие элементы Azure Boards
Из коммита GitHub, pull-запроса или проблемы используйте следующий синтаксис, чтобы создать ссылку на рабочий элемент Azure Boards. Введите 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, переходят в первое состояние, связанное с категорией Resolved. Если такое состояние отсутствует в текущем процессе, система вместо этого переместит рабочий элемент в первое состояние в категории "Завершено ".
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# в описании pull request, эти ссылки отображаются в разделе Development pull request в GitHub. Эти ссылки доступны только при использовании AB# в описании запроса на вытягивание. Они не отображаются, если вы переходите по ссылке из рабочего элемента к pull request. Удаление AB# ссылки из описания также удаляет ее из раздела "Разработка".
Создание ветви GitHub из рабочего элемента
Чтобы создать ветвь GitHub непосредственно из рабочего элемента, выполните следующие действия.
Найдите рабочий элемент, который вы хотите использовать для создания ветки на GitHub.
Выберите действия
Work item actions>New GitHub branch.
В диалоговом окне Create GitHub branch введите имя ветви. Выберите репозиторий GitHub и базовую ветвь.
Нажмите кнопку "Создать".
Azure Boards создает ветвь в указанном репозитории GitHub и связывает ее с рабочим элементом. Для получения дополнительной информации см. раздел интеграция Azure Boards и GitHub.
Добавление ссылки на рабочий элемент к ветке, коммиту или pull request в GitHub
Откройте рабочий элемент и перейдите в область разработки .
Выберите " Добавить ссылку". В каждом раскрывающемся меню выберите ваш тип ссылки, репозиторий GitHub и запрос на вытягивание GitHub. Вы можете выполнять поиск и углублённый поиск в репозитории, чтобы найти и выбрать конкретный запрос на вытягивание или коммит, без необходимости копировать и вставлять URL-адрес.
Выберите " Добавить ссылку".
Azure Boards выполняет проверку, чтобы убедиться, что введена действительная ссылка. Связанный с GitHub репозиторий должен быть подключен к проекту Azure Boards или проверка не будет пройдена.
Note
Если вы используете Azure DevOps Server и GitHub Enterprise Server, возникает задержка при обработке ссылок AB#. Процесс использует модель push-and-pull для извлечения данных из событий GitHub каждый час, чтобы отслеживать инкрементные изменения в коммитах, PR и задачах.
Автоматическое обновление ссылок
Несколько событий автоматически обновляют ссылки в форме рабочего элемента, поэтому их не нужно создавать вручную. К этим событиям относятся:
| событие GitHub | Action |
|---|---|
| Ссылка на ветвь | При создании запроса на вытягивание из ветки он автоматически связывается с соответствующим рабочим элементом. |
| Фиксация слияния | После объединения пул-реквеста результирующий коммит слияния автоматически связывается с рабочим элементом. |
| Удаление ветви | Если ветвь удаляется (обычно после объединения), ее ссылка автоматически удаляется из рабочего элемента. |
Просмотр или открытие ссылок из раздела "Разработка"
В разделе "Разработка" формы рабочего элемента перечислены ссылки, созданные на коммиты и pull requests в GitHub с использованием значка 
GitHub.
Выберите ссылку, чтобы открыть коммит или pull-реквест в GitHub.
GitHub информация о pull request
Связанные пулл-реквесты GitHub в разделе "Разработка" показывают дополнительные сведения о состоянии, чтобы вы могли оценить прогресс без открытия их в GitHub.
Предварительные требования для инcайтов по пулл-реквестам
Чтобы просмотреть аналитику по запросу на пулл-реквест, откройте приложение Azure Boards в GitHub и примите обновленные разрешения на чтение и запись для Проверок.
Просмотр статуса пул-реквеста
Откройте рабочий элемент, имеющий связанный GitHub pull запрос.
В разделе "Разработка" найдите связанный pull request. Следующие сведения о состоянии отображаются рядом со ссылкой на pull request:
- Состояние черновика: показывает, является ли запрос на вытягивание черновиком.
- Состояние проверки: отображает, требуется ли проверка pull request, одобрен он или запрошены изменения.
- Проверяет состояние: показывает, успешно проходят ли проверки CI, завершаются ли они с ошибками или находятся в ожидании.
Наведите указатель мыши на индикатор состояния, чтобы увидеть подробности, или выберите ссылку pull request, чтобы открыть её прямо в GitHub.
Указывайте GitHub pull-запросы с помощью !
Используйте ! упоминания, чтобы ссылаться и обсуждать запросы на извлечение GitHub непосредственно из любого поля с форматированным текстом рабочего элемента или комментария для обсуждения. Когда вы вводите ! в текстовом поле, появляется селектор, с помощью которого можно искать и выбирать запрос на извлечение GitHub из подключенного репозитория. Выбранный pull request вставляется в виде ссылки, щелчок по которой доступен.
Эта функция позволяет легко ссылаться на связанные pull requests в описаниях рабочих элементов, критериях принятия или потоках обсуждения, не копируя URL-адреса вручную.
Отображение статуса сборки для конвейеров на YAML (входит в состав сборки)
При использовании Azure Pipelines YAML для сборки кода, размещенного в репозитории GitHub, вы можете автоматически создавать связи интеграция в сборке на связанные с этим элементы рабочего процесса. Эта функция обеспечивает трассировимость сборки для репозиториев GitHub, достигая равенства с возможностями, доступными для Azure Repos.
Чтобы включить эту функцию:
Откройте конвейер YAML, выберите
"Дополнительные действия" и выберите "Параметры".В диалоговом окне "Параметры конвейера" включите автоматическое связывание новых рабочих элементов в этой сборке.
Когда сборка завершится, в разделе "Разработка" каждого связанного рабочего элемента автоматически отображается ссылка "Интегрировано в сборке", обеспечивая команде полную трассировку от рабочего элемента к сборке.
Дополнительные сведения о настройке этого параметра см. в разделе "Настройка конвейеров для поддержки отслеживания работы".
Просмотр объектов GitHub на доске
Включив аннотации GitHub на доске, вы можете быстро открыть связанные коммиты GitHub, запросы на вытягивание или проблемы для получения более детальной информации. Дополнительные сведения см. в разделе "Настройка карточек".
