Поделиться через

Свяжите коммиты, запросы на вытягивание, ветки и задачи GitHub с рабочими элементами в Azure Boards.

  • Статья

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

В этой статье вы узнаете, как связать рабочие элементы с коммитами GitHub, pull-запросами и ветками после того, как вы подключите проект Azure Boards к репозиторию GitHub. Вы можете использовать синтаксис #mention для коммитов и веток или добавить коммит GitHub, пул-реквест или ссылку на ветку из рабочего элемента Azure Boards.

Примечание.

С приложением Azure Boards для GitHub, Azure Boards и Azure DevOps Services интегрируются с репозиториями GitHub.com и GitHub Enterprise Server. Azure DevOps Server 2019 и более поздних версий поддерживают интеграцию только с репозиториями GitHub Enterprise Server. Интеграция с другими репозиториями Git не поддерживается.

Требования

Категория Требования
Разрешения участник как в проекте Azure Boards, так и в репозитории GitHub.
подключение к проекту Проект Azure Boards подключен к репозиторию GitHub, в котором находятся фиксации, запросы на вытягивание и ветви, к которым или от которых вы хотите создать ссылки. Дополнительные сведения см. в статье об интеграции Azure Boards-GitHub.

Примечание.

Проекты, использующие модель процесса Hosted XML, требуют обновления типов рабочих элементов для просмотра раздела разработки и типов ссылок GitHub. Дополнительные сведения см. в разделе "Обновление xml-определений" для выбора типов рабочих элементов.

Для создания ссылки на рабочий элемент Azure Boards из коммита GitHub, пул-реквеста или задачи используйте следующий синтаксис. Введите AB#ID в текст сообщения фиксации. Или для pull request или задачи введите AB#ID в заголовке или описании. Использование AB#ID примечания не создает ссылку на рабочий элемент.

AB#{ID}

Например, AB#125 ссылается на рабочий элемент с ID 125.

Вы также можете ввести сообщение коммита или пулл-реквеста для перевода рабочего элемента в другое состояние. Система распознает fix, fixes, и fixed, и применяет их к элементу #-упоминания, который следует за ними. Упомянутые рабочие элементы переходили в первое состояние, связанное с состоянием категории разрешенных рабочих процессов. Если с Состоянием не связано Разрешено, рабочий элемент переходит в Состояние, связанное с состоянием категории Завершено рабочего процесса. Для получения дополнительной информации смотрите как используются состояния категорий рабочих процессов в бэклогах и досках Azure Boards.

Ознакомьтесь со следующей таблицей примеров:

Сообщение о фиксации или пул-реквесте. Действие
Fixed 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. Переходы не выполняются.

Примечание.

Если вы подключили один и тот же репозиторий GitHub к проектам, определенным в двух или более организациях Azure DevOps, вы можете увидеть непредвиденную ссылку на упоминание AB#. Дополнительные сведения см. в разделе "Устранение проблем с подключением". По этой причине рекомендуется подключить репозиторий GitHub только к проектам, определенным в одной организации Azure DevOps.

При добавлении ссылки на рабочий элемент с помощью AB#эти ссылки отображаются в разделе "Разработка " запроса на вытягивание.

Снимок экрана ссылок AB# в разделе разработки в pull-реквесте на GitHub.

Создание ветви GitHub из рабочего элемента

Чтобы создать ветвь GitHub непосредственно из рабочего элемента, сделайте следующее:

  1. На вашей доске найдите рабочий элемент, из которого вы хотите создать ветвь GitHub.

  2. Выберите Действия рабочего элемента>Новая ветвь GitHub.

    Снимок экрана рабочего элемента: выбор 'Дополнительные действия' и выделение параметра 'Создать новую ветвь GitHub'.

  3. В диалоговом окне "Создание ветви GitHub" введите имя ветви и выберите репозиторий GitHub и базовая ветвь.

  4. Нажмите кнопку создания.

    Снимок экрана: диалоговое окно

    Azure Boards создает ветвь в указанном репозитории GitHub и связывает ее с рабочим элементом. Дополнительные сведения см. в статье об интеграции Azure Boards-GitHub.

  1. Откройте рабочий элемент и перейдите на вкладку "Ссылки ".

    Снимок экрана: форма рабочего элемента, вкладка

  2. В диалоговом окне «Добавить ссылку», выберите один из типов ссылок GitHub, выберите репозиторий GitHub, введите URL-адрес ветки, коммита или запроса на вытягивание в GitHub, а затем выберите «Добавить ссылку».

    В следующем примере мы добавляем ссылку на пулл-реквест GitHub.

    Снимок экрана: форма элемента работы, вкладка

    Azure Boards завершает проверку, чтобы убедиться, что вы ввели действительную ссылку. Репозиторий GitHub, на который имеется ссылка, должен быть подключен к проекту Azure Boards, иначе проверка не проходит.

Примечание.

Если вы используете Azure DevOps Server и GitHub Enterprise Server, возникает задержка при завершении работы с ссылками AB#. У нас есть двунаправленный механизм для получения событий GitHub каждый час, чтобы отслеживать добавочные изменения в коммитах, PR и задачах.

В разделе "Разработка" в форме рабочего элемента перечислены ссылки, созданные для фиксаций GitHub и запросов на вытягивание с помощью значка GitHub.

Снимок экрана: форма рабочего элемента, раздел

Выберите указанную ссылку для открытия коммита или пул-реквеста в GitHub.

Просмотр объектов GitHub на доске

С включенными аннотациями GitHub на доске вы можете быстро открывать связанные коммиты GitHub, запросы на вытягивание или задачи для получения более подробной информации. Дополнительные сведения см. в разделе "Настройка карточек".

Снимок экрана: доска с ссылками GitHub на карточках рабочих элементов.

Следующие шаги

Настройка индикаторов состояния