Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
В этом кратком руководстве вы установите приложение Azure Boards для GitHub, чтобы подключить Azure Boards к репозиториям GitHub. При подключении проектов Azure Boards к репозиториям GitHub.com вы поддерживаете связывание между коммитами GitHub и pull-реквестами к рабочим элементам. Вы можете использовать GitHub для разработки программного обеспечения, используя Azure Boards для планирования и отслеживания работы. После установки приложения Azure Boards для GitHub на учетной записи или организации GitHub выберите репозитории GitHub, к которым вы хотите подключиться из проекта.
Общие сведения об интеграции, которую поддерживает приложение Azure Boards для GitHub, см. в статье об интеграции Azure Boards-GitHub.
Prerequisites
| Category | Requirements |
|---|---|
| Permissions | — Член группы администраторов коллекции проектов . Если вы создали проект, у вас есть разрешения. - администратор или владелец организации GitHub для установки приложения Azure Boards. - разрешения на чтение для репозитория GitHub. |
| членство в проекте | член проекта. |
Important
Если репозиторий уже подключен с помощью другого типа проверки подлинности, такого как OAuth, необходимо удалить этот репозиторий из существующего подключения, прежде чем повторно подключить его с помощью приложения GitHub. Выполните действия, описанные в разделе "Добавление или удаление репозиториев GitHub" далее в этой статье, прежде чем настроить приложение GitHub.
Вы можете подключить организацию Azure DevOps к нескольким репозиториям GitHub, если вы являетесь администратором этих репозиториев. Не следует подключать репозиторий GitHub к нескольким организациям Azure DevOps.
Установка и настройка приложения Azure Boards
Последовательность установки может отличаться из-за конфигурации учетной записи. При необходимости следуйте указаниям на экране между следующими шагами.
Перейдите в приложение Azure Boards в GitHub Marketplace.
В разделе "Планы и цены" в разделе "Бесплатный" выберите "Установить".
В разделе "Установка и авторизация досок Azure" выберите репозитории, которые требуется подключить к Azure Boards, а затем нажмите кнопку "Установить" и "Авторизовать".
В этом примере используются все репозитории:
Выберите организацию Azure DevOps и проект Azure Boards, к которому вы хотите подключиться к GitHub.com.
Одновременно можно подключить только один проект. Если у вас есть другие проекты, которые вы хотите подключить, это можно сделать позже, как описано в разделе "Настройка других проектов или репозиториев " далее в этой статье.
Предоставьте доступ к организации Azure Boards
При необходимости, чтобы предоставить GitHub доступ к организации Azure DevOps, сделайте следующее.
На веб-портале GitHub откройте Настройки из меню профиля.
Выберите приложения в разделе "Интеграция".
Выберите Авторизованные приложения GitHub>Azure Boards.
В разделе "Доступ к организации" устраните все проблемы, которые могут возникнуть. Выберите "Предоставить", чтобы предоставить доступ к любым организациям, которые отображаются как ожидающие запроса на доступ.
Проверка политики доступа к сторонним приложениям
Убедитесь, что организация GitHub разрешает сторонним приложениям доступ к приложению Azure Boards. Если сторонний доступ ограничен, добавление репозиториев из Azure DevOps может отобразить пустой список или создать ошибку.
Разрешение доступа
В GitHub откройте свою организацию и перейдите в раздел настроек политики приложений OAuth >.
Утверждайте приложение 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.
Настройка других проектов или репозиториев
Вы можете настроить другие проекты Azure Boards и Azure DevOps, репозитории GitHub.com, а также изменить текущую конфигурацию на странице приложения Azure Boards. Дополнительные сведения см. в статье "Добавление или удаление репозиториев" или удаление подключения из Azure Boards.
Добавление или удаление репозиториев или удаление подключения из Azure Boards
При возникновении проблемы с подключением рекомендуется удалить подключение и начать работу с новым подключением.
В вашем проекте в Azure DevOps перейдите к параметрам проекта>подключения GitHub.
Чтобы добавить или удалить репозитории, выберите Дополнительные параметры для подключения и выберите "Добавить репозитории" или "Удалить репозитории" в меню.
Чтобы удалить все репозитории и подключение, выберите параметр "Удалить подключение ". Затем нажмите кнопку "Удалить ", чтобы подтвердить.
Изменение доступа к репозиторию
На веб-портале GitHub откройте Настройки из меню профиля.
Выберитеприложения>. В разделе "Установленные приложения GitHub" выберите "Настроить".
Откроется страница конфигурации 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".
