Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Установите приложение Azure Boards для GitHub, чтобы подключить Azure Boards к репозиториям GitHub. При подключении проектов Azure Boards к репозиториям GitHub.com вы поддерживаете связывание между коммитами GitHub и pull-реквестами к рабочим элементам. Вы можете использовать GitHub для разработки программного обеспечения, используя Azure Boards для планирования и отслеживания работы.
Общие сведения об интеграции, которую поддерживает приложение Azure Boards для GitHub, см. в статье об интеграции Azure Boards-GitHub. После установки приложения Azure Boards для GitHub на учетной записи или организации GitHub выберите репозитории GitHub, к которым вы хотите подключиться из проекта.
Предпосылки
| Категория | Требования |
|---|---|
| разрешения | — Член группы администраторов коллекции проектов . Если вы создали проект, у вас есть разрешения. - администратор или владелец организации GitHub для установки приложения Azure Boards. - разрешения на чтение для репозитория GitHub. |
| членство в проекте | член проекта. |
Внимание
Если репозиторий уже подключен через другой тип проверки подлинности, например OAuth, необходимо удалить этот репозиторий из существующего подключения, прежде чем повторно подключить его через приложение GitHub. Выполните действия, описанные в разделе "Добавление или удаление репозиториев GitHub" далее в этой статье, прежде чем настроить приложение GitHub.
Вы можете подключить организацию Azure DevOps к нескольким репозиториям GitHub, если вы являетесь администратором этих репозиториев. Однако не следует подключать репозиторий GitHub к нескольким организациям Azure DevOps.
Установка и настройка приложения 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 доступ к организации Azure DevOps, сделайте следующее.
На веб-портале GitHub откройте Настройки из меню профиля.
Выберите приложения в разделе "Интеграция".
Выберите Авторизованные приложения GitHub>Azure Boards.
В разделе "Доступ к организации" устраните все проблемы, которые могут возникнуть. Выберите "Предоставить", чтобы предоставить доступ к любым организациям, которые отображаются как ожидающие запроса на доступ.
Используйте подключение.
На этом этапе интеграция Azure Boards-GitHub завершена. Чтобы понять функции, поддерживаемые подключением, можно пропустить следующие шаги или пройти их.
На вашей доске выберите Новый рабочий элемент, чтобы добавить новый рабочий элемент с именем "Добавить значок в README" — задача (базовый), пользовательская история (гибкий) или элемент невыполненного продукта (Scrum) — в зависимости от модели процесса, используемой вашим проектом Azure Boards.
Рабочий элемент с заголовком "Добавить эмблему в README " появится на доске.
Откройте рабочий элемент, перейдите в раздел "Разработка " и выберите " Добавить ссылку".
Выберите GitHub Pull Request из раскрывающегося меню Тип ссылки.
Выберите репозиторий, введите ID pull request и, при необходимости, добавьте комментарий.
Выберите " Добавить ссылку".
Следующие действия выполняются в фоновом режиме автоматически:
- Добавляет значок в файл README первого репозитория в списке подключенных репозиториев GitHub.
- Создает коммит на GitHub для обновления, произведенного добавлением значка в файл README.
- Создает pull request на GitHub для объединения изменений, внесенных в файл README.
- Связывает commit и pull request GitHub с рабочим элементом, созданным на первом шаге.
Выберите первую ссылку pull request из рабочего элемента.
Пулл-реквест на GitHub открывается в новой вкладке браузера.
Выберите Объединить pull-запрос.
Перейдите в файл 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>, затем 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".
