Связывание фиксаций 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-определений" для выбора типов рабочих элементов.
Использование AB#
ссылки с GitHub на рабочие элементы Azure Boards
Из фиксации GitHub, запроса на вытягивание или проблему используйте следующий синтаксис, чтобы создать ссылку на рабочий элемент Azure Boards. AB#ID
Введите текст сообщения фиксации. Или для запроса на вытягивание или проблемы введите AB#ID
в заголовке или описании. Использование AB#ID
примечания не создает ссылку на рабочий элемент.
Примечание.
Для связывания с GitHub требуется azure DevOps Server 2019 с обновлением 1 или более поздней версии.
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 в категорию состояния разрешенного рабочего процесса или, если он не определен, то категория состояния завершенного рабочего процесса. |
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#эти ссылки отображаются в разделе "Разработка " запроса на вытягивание.
Создание ветви GitHub из рабочего элемента
Чтобы создать ветвь GitHub непосредственно из рабочего элемента, сделайте следующее:
Найдите рабочий элемент, из которого вы хотите создать ветвь GitHub.
Выберите действия>"Рабочий элемент" "Создать ветвь GitHub".
В диалоговом окне "Создание ветви GitHub" введите имя ветви и выберите репозиторий GitHub и базовая ветвь.
Нажмите кнопку создания.
Azure Boards создает ветвь в указанном репозитории GitHub и связывает ее с рабочим элементом. Дополнительные сведения см. в статье об интеграции Azure Boards-GitHub.
Добавление ссылки на рабочий элемент в ветвь GitHub, фиксацию или запрос на вытягивание
Примечание.
Для связывания с проблемой GitHub требуется azure DevOps Server 2019 с обновлением 1 или более поздней версии.
Откройте рабочий элемент и перейдите на вкладку "Ссылки ".
В диалоговом окне "Добавить ссылку" выберите один из типов ссылок 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, запросы на вытягивание или дополнительные сведения о проблемах. Дополнительные сведения см. в разделе "Настройка карточек".