Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Сервисы Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022
В этом кратком руководстве по быстрому старту вы установите приложение Azure Boards для GitHub, чтобы подключить Azure Boards к вашим репозиториям GitHub. При подключении проектов Azure Boards к репозиториям GitHub.com поддерживается связывание между коммитами GitHub и pull request’ами с рабочими элементами. Вы можете использовать GitHub для разработки программного обеспечения при использовании Azure Boards для планирования и отслеживания работы. После установки приложения Azure Boards для GitHub в вашей учетной записи или организации GitHub выберите из проекта те репозитории GitHub, к которым вы хотите подключиться.
Для получения сведений об интеграции, которую поддерживает приложение Azure Boards для GitHub, см. раздел Azure Boards-GitHub integration.
Prerequisites
| Category | Requirements |
|---|---|
| Разрешения | — Член группы администраторов коллекции проектов . Если вы создали проект, у вас есть разрешения. - Administrator или владелец организации GitHub для установки приложения Azure Boards. Права Read для репозитория на GitHub. |
| членство в проекте | член проекта. |
Important
Если репозиторий уже подключен с помощью другого типа проверки подлинности, например OAuth, необходимо удалить этот репозиторий из существующего подключения, прежде чем повторно подключить его с помощью приложения GitHub. Выполните действия, описанные в Add или удалите репозитории GitHub далее в этой статье перед настройкой приложения GitHub.
Вы можете подключить организацию Azure DevOps к нескольким репозиториям GitHub, если вы являетесь администратором этих репозиториев. Не следует подключать репозиторий GitHub к более чем одной организации Azure DevOps.
Установка и настройка приложения Azure Boards
Последовательность установки может отличаться из-за конфигурации учетной записи. При необходимости следуйте указаниям на экране между следующими шагами.
Перейдите к приложению Azure Boards в
GitHub< Marketplace .В разделе "Планы и цены" в разделе "Бесплатный" выберите "Установить".
В Установите и авторизуйте Azure Boards, выберите репозитории, которые требуется подключить к Azure Boards, а затем выберите Установите и авторизуйте.
В этом примере используются все репозитории:
Выберите организацию Azure DevOps и проект Azure Boards, к которым вы хотите подключиться на GitHub.com.
Одновременно можно подключить только один проект. Если у вас есть другие проекты, которые вы хотите подключить, это можно сделать позже, как описано в разделе "Настройка других проектов или репозиториев " далее в этой статье.
Предоставление организации доступа к Azure Boards
При необходимости, чтобы предоставить GitHub доступ к организации Azure DevOps, сделайте следующее.
На веб-портале GitHub откройте Settings из меню профиля.
Выберите приложения в разделе "Интеграция".
Выберите Авторизованные приложения GitHub>Azure Boards.
В разделе "Доступ к организации" устраните все проблемы, которые могут возникнуть. Выберите "Предоставить", чтобы предоставить доступ к любым организациям, которые отображаются как ожидающие запроса на доступ.
Проверка политики доступа к сторонним приложениям
Убедитесь, что ваша GitHub организация разрешает сторонним приложениям доступ к приложению Azure Boards. Если сторонний доступ ограничен, добавление репозиториев из Azure DevOps может отобразить пустой список или создать ошибку.
Разрешение доступа
В GitHub откройте свою организацию и перейдите в политику приложения OAuth в разделе «Параметры» >.
Утверждайте приложение Azure Boards специально (рекомендуется) или удалите ограничения для всех сторонних приложений.
Замечание
Чтобы изменить этот параметр, необходимо быть владельцем организации или администратором.
Используйте подключение.
На этом этапе интеграция Azure Boards-GitHub завершена. Чтобы понять функции, поддерживаемые подключением, можно пропустить следующие шаги или пройти их.
На доске выберите New work item, чтобы ввести новый рабочий элемент с именем "Добавить значок в README"— проблема (базовый), история пользователя (гибкая версия) или элемент невыполненной работы продукта (Scrum) в зависимости от модели процесса, используемой проектом Azure Boards.
Рабочий элемент с заголовком "Добавить эмблему в README " появится на доске.
Откройте рабочий элемент, перейдите в раздел "Разработка " и выберите " Добавить ссылку".
В Тип ссылки выберите GitHub пулл-реквест.
Выберите репозиторий, введите ID pull request и, при необходимости, добавьте комментарий.
Выберите " Добавить ссылку".
Следующие действия выполняются в фоновом режиме автоматически:
- Добавляет значок в файл README первого репозитория в списке подключенных GitHub репозиториев.
- Создает GitHub коммит для обновления, сделанного путем добавления значка в файл README.
- Создает pull request на GitHub для объединения изменений, внесенных в файл README.
- Связывает коммит и pull request в GitHub с рабочим элементом, созданным на шаге 1.
Выберите первую ссылку pull request из рабочего элемента.
Запрос на «pull request» GitHub открывается на новой вкладке браузера.
Выберите Объединить pull-запрос.
Перейдите в файл README репозитория и просмотрите добавленную эмблему.
Для получения дополнительной информации см. раздел Индикаторы состояния для репозитория GitHub.
Настройка других проектов или репозиториев
Вы можете настроить другие Azure Boards/Azure DevOps Проекты, GitHub.com репозитории или изменить текущую конфигурацию на странице приложения Azure Boards. Дополнительные сведения см. в статье Добавить или удалить репозитории, или удалить соединение с Azure Boards.
Добавление или удаление репозиториев или удаление подключения из Azure Boards
При возникновении проблемы с подключением рекомендуется удалить подключение и начать работу с новым подключением.
Перейдите к параметрам проекта в Azure DevOps и настройкам GitHub подключений>.
Чтобы добавить или удалить репозитории, выберите Дополнительные параметры для подключения и выберите "Добавить репозитории" или "Удалить репозитории" в меню.
Чтобы удалить все репозитории и подключение, выберите параметр "Удалить подключение ". Затем нажмите кнопку "Удалить ", чтобы подтвердить.
Изменение доступа к репозиторию
На веб-портале GitHub откройте Settings из меню профиля.
Выберите Интеграции>Приложения. В разделе Installed GitHub Apps выберите Configure.
Откроется страница конфигурации Azure Boards.
Прокрутите вниз до раздела доступа к репозиторию.
Выберите нужный вариант: все репозитории или только репозитории.
Если выбрать Only select repositories, выберите репозитории, которые вы хотите участвовать в интеграции с Azure Boards.
Нажмите кнопку "Сохранить".
Приостановка или удаление интеграции Azure Boards
Начиная с шага 2 в предыдущей процедуре прокрутите вниз до раздела "Зона опасности".
Чтобы приостановить интеграцию, нажмите кнопку "Приостановить". В окне подтверждения нажмите кнопку "ОК ", чтобы подтвердить приостановку.
Чтобы отменить интеграцию, выберите unsuspend.
Чтобы удалить приложение Azure Boards, выберите Uninstall и выберите OK в окне подтверждения всплывающего окна.
Обновление подключений Azure Boards-GitHub
Если изменить репозитории, которые поддерживает приложение Azure Boards для GitHub, возможно, вы будете перенаправлены на подключения Azure Boards для GitHub. Рекомендуется удалить репозитории в Azure Boards, которые больше не могут подключаться к GitHub. Дополнительные сведения см. в разделе Добавление или удаление репозиториев GitHub.
При удалении приложения Azure Boards для GitHub следующее сообщение отображается в Azure Boards, Project settings>GitHub подключения. Выберите Удалить подключение, чтобы удалить все ранее созданные подключения GitHub. Для получения дополнительной информации см. Добавление или удаление репозиториев GitHub.
