Установка приложения Azure Boards для GitHub
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Установите приложение Azure Boards для GitHub, чтобы подключить Azure Boards к репозиториям GitHub. При подключении проектов Azure Boards с GitHub.com репозиториями вы поддерживаете связывание между фиксациями GitHub и запросами на вытягивание рабочих элементов. Вы можете использовать GitHub для разработки программного обеспечения, используя Azure Boards для планирования и отслеживания работы.
Общие сведения об интеграции, которую поддерживает приложение Azure Boards для GitHub, см. в статье об интеграции Azure Boards-GitHub. После установки приложения Azure Boards для GitHub на учетной записи или организации GitHub выберите репозитории GitHub, к которым вы хотите подключиться из проекта.
Необходимые компоненты
Разрешения:
- Чтобы установить приложение Azure Boards, необходимо быть администратором или владельцем организации GitHub.
- У вас должны быть разрешения на чтение для репозитория GitHub.
- Вы должны быть членом группы "Администраторы коллекции проектов". Если вы создали проект, у вас уже есть эти разрешения.
Внимание
Если репозиторий уже подключен через другой тип проверки подлинности, например OAuth, необходимо удалить этот репозиторий из существующего подключения, прежде чем повторно подключить его через приложение GitHub. Выполните действия, описанные в разделе "Добавление или удаление репозиториев GitHub" далее в этой статье, прежде чем настроить приложение GitHub.
Вы можете подключить организацию Azure DevOps к нескольким репозиториям GitHub, если вы являетесь администратором этих репозиториев. Однако не следует подключать репозиторий GitHub к нескольким организациям Azure DevOps.
Предоставление доступа к организации Azure Boards
Чтобы предоставить GitHub доступ к организации Azure DevOps, сделайте следующее.
На веб-портале GitHub откройте меню профилей параметры.
Выберите приложения в разделе "Интеграция".
Выберите авторизованные GitHub Apps>Azure Boards.
В разделе "Доступ к организации" устраните все проблемы, которые могут возникнуть. Выберите "Предоставить", чтобы предоставить доступ к любым организациям, которые отображаются как ожидающие запроса на доступ.
Установка и настройка приложения Azure Boards
Перейдите в приложение Azure Boards в GitHub Marketplace.
Выберите " Настройка плана".
Выберите организацию GitHub, которую вы хотите подключить к Azure Boards.
Выберите репозитории, которые требуется подключить к Azure Boards.
В следующем примере мы выбираем подключение ко всем репозиториям.
Выберите организацию Azure DevOps и проект Azure Boards, к которому вы хотите подключиться к GitHub.com.
Одновременно можно подключить только один проект. Если у вас есть другие проекты, которые вы хотите подключить, это можно сделать позже, как описано в разделе "Настройка других проектов или репозиториев " далее в этой статье.
Чтобы подключиться к GitHub.com, авторизуйте организацию Azure Boards.
Подтвердите GitHub.com репозитории, которые требуется подключить. Выберите каждый репозиторий, к которому требуется подключиться. Отмените выбор любых репозиториев, которые вы не хотите участвовать в интеграции.
Используйте подключение.
На этом этапе интеграция Azure Boards-GitHub завершена. Чтобы понять функции, поддерживаемые подключением, можно пропустить следующие шаги или пройти их.
На доске выберите новый рабочий элемент, чтобы ввести новый рабочий элемент с именем "Добавить значок в README", проблема (базовый), история пользователя (гибкий) или элемент невыполненной работы продукта (Scrum) в зависимости от модели процесса, используемой проектом Azure Boards.
Рабочий элемент с заголовком "Добавить эмблему в README " появится на доске.
Откройте рабочий элемент, перейдите в раздел "Разработка " и выберите " Добавить ссылку".
Выберите запрос на вытягивание GitHub в раскрывающемся меню "Тип ссылки".
Выберите репозиторий и введите идентификатор запроса на вытягивание и необязательный комментарий.
Выберите " Добавить ссылку".
Следующие действия выполняются в фоновом режиме автоматически:
- Добавляет значок в файл README первого репозитория в списке подключенных репозиториев GitHub.
- Создает фиксацию GitHub для обновления, добавив эмблему в файл README.
- Создает запрос на вытягивание GitHub для объединения изменений, внесенных в файл README.
- Связывает запрос фиксации и извлечения GitHub с рабочим элементом, созданным на шаге 1.
Выберите первую ссылку запроса на вытягивание из рабочего элемента.
Запрос на вытягивание GitHub открывается на новой вкладке браузера.
Выберите Объединить запросы на вытягивание.
Перейдите в файл README репозитория и просмотрите добавленную эмблему.
Дополнительные сведения см. в разделе "Настройка индикаторов состояния" для добавления в файлы GitHub README.
Настройка других проектов или репозиториев
Вы можете настроить другие проекты Azure Boards и Azure DevOps, репозитории GitHub.com, а также изменить текущую конфигурацию на странице приложения Azure Boards. Дополнительные сведения см. в разделе "Изменение доступа к репозиторию GitHub" или приостановка или удаление интеграции.
Добавление или удаление репозиториев или удаление подключения из Azure Boards
При возникновении проблемы с подключением рекомендуется удалить подключение и начать работу с новым подключением.
В проекте в Azure DevOps перейдите к параметрам>проекта GitHub.
Чтобы добавить или удалить репозитории, выберите многоточие дополнительных параметров для подключения и выберите " Добавить репозитории " или "Удалить репозитории " в меню.
Чтобы удалить все репозитории и подключение, выберите параметр "Удалить подключение ". Затем нажмите кнопку "Удалить ", чтобы подтвердить.
Чтобы добавить или удалить репозитории, откройте значок действий для подключения и выберите "Добавить репозитории" или "Удалить репозитории " в меню.
Чтобы удалить все репозитории и подключение, выберите параметр "Удалить подключение ". Затем нажмите кнопку "Удалить ", чтобы подтвердить.
Изменение доступа к репозиторию
Войдите в GitHub и откройте параметры профиля организации.
https://github.com/organizations/fabrikam-fiber/settings/profile
Перейдите к настройке установленных приложений GitHub Apps>Azure Boards.>
Откроется страница конфигурации Azure Boards.
Прокрутите вниз до раздела доступа к репозиторию.
Выберите нужный вариант: все репозитории или только репозитории.
Если выбрать только репозитории, выберите репозитории, которые вы хотите участвовать в интеграции с Azure Boards.
Выберите Сохранить.
Приостановка или удаление интеграции с Azure Boards
Начиная с шага 2 в предыдущей процедуре прокрутите вниз до раздела "Зона опасности".
Чтобы приостановить интеграцию, нажмите кнопку "Приостановить". В окне подтверждения всплывающего окна нажмите кнопку "ОК ", чтобы подтвердить приостановку.
Чтобы отменить интеграцию, выберите unsuspend.
Чтобы удалить приложение Azure Boards, нажмите кнопку "Удалить" и нажмите кнопку "ОК " в окне подтверждения всплывающего окна.
Обновление подключений Azure Boards-GitHub
Если изменить репозитории, поддерживаемые приложением Azure Boards для GitHub, вы можете перенаправиться на подключения GitHub к Azure Boards. Рекомендуется удалить репозитории в Azure Boards, которые больше не могут подключаться к GitHub. Дополнительные сведения см. в разделе "Добавление или удаление репозиториев GitHub".
Если удалить приложение Azure Boards для GitHub, в Azure Boards отображается следующее сообщение, параметры GitHub для параметров>проекта. Выберите "Удалить подключение", чтобы удалить все ранее сделанные подключения GitHub. Дополнительные сведения см. в разделе "Добавление и удаление репозиториев GitHub".