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


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

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

Из этой статьи вы узнаете, как связать рабочие элементы с фиксациями GitHub и запросами на вытягивание после подключения проекта 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.

Примечание.

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

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

Примечание.

Для связывания с GitHub требуется azure DevOps Server 2019 с обновлением 1 или более поздней версии.

AB#{ID}

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

Вы также можете ввести сообщение о фиксации или запросе на вытягивание для перехода рабочего элемента. Система распознает fixи fixesfixedприменяет его к элементу #-упоминания, который следует за ним. Упомянутые рабочие элементы переходили в первое состояние, связанное с состоянием категории разрешенных рабочих процессов. Если состояние не связано с разрешенным, рабочий элемент переходит в состояние, связанное с состоянием категории завершенного рабочего процесса. Дополнительные сведения см. в статье о том, как используются состояния категорий рабочих процессов в невыполненных работах и досках 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 в категорию состояния разрешенного рабочего процесса или, если он не определен, то категория состояния завершенного рабочего процесса.
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.

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

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

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

  2. Выберите действия>"Рабочий элемент" "Создать ветвь GitHub".

    Снимок экрана: выбор дополнительных действий рабочего элемента и выделен параметр

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

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

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

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

Примечание.

Для связывания с проблемой GitHub требуется azure DevOps Server 2019 с обновлением 1 или более поздней версии.

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

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

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

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

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

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

Примечание.

При выполнении ссылок AB# возникает задержка при использовании Azure DevOps Server и GitHub Enterprise Server. У нас есть дизайн push-и-pull, чтобы извлечь из событий GitHub каждый час на добавочные изменения в фиксации, PR и проблеме.

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

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

Выберите ссылку, указанную для открытия запроса фиксации или извлечения в GitHub.

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

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

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

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