Подключение Azure Boards GitHub (облако)

Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019

для поддержки связывания GitHub фиксаций и запросов на вытягивание для Azure Boards рабочих элементов вы подключаете проект Azure Boards к GitHubм репозитории com. затем можно использовать GitHub для разработки программного обеспечения, используя Azure Boards для планирования и мониторинга работы. общие сведения о Azure Boards приложении для GitHub см. в статье интеграция Boards-GitHub Azure.

при создании подключения из Azure Boards список репозиториев GitHub соответствует тем, к которым разрешен доступ Azure Boards. можно ограничить количество репозиториев, к которым Azure Boards может получить доступ, и ограничить доступ конкретного проекта или разделить управление работой в разных проектах Azure Boards.

Примечание

Azure Boards и Azure DevOps Services поддерживают интеграцию с репозиториями GitHub.com и GitHub Enterprise Server. если вы хотите подключиться из локальной Azure DevOps Server, см. раздел Подключение Azure DevOps Server to GitHub Enterprise Server.

Предварительные требования

  • необходимо подключиться к проекту Azure Boards или Azure DevOps. Если у вас еще нет проекта, создайте его.
  • необходимо быть членом группы "администраторы Project " и группы "участники" проекта. Если вы создали проект, у вас есть разрешения.
  • вы должны быть администратором или владельцем репозитория GitHub, к которому вы будете подключаться. можно подключиться к нескольким GitHub репозиториям, пока вы являетесь администратором этих репозиториев.

Параметры проверки подлинности

в зависимости от платформы GitHub, к которой необходимо подключиться, поддерживаются следующие параметры проверки подлинности.

GitHub. com

GitHub Enterprise Server

откройте Project Параметры>GitHub подключения.

  1. войдите в Azure Boards для проекта, который вы хотите подключить к GitHub репозиториям.

  2. выберите (1) Project Параметры> (2) GitHub подключений.

    снимок экрана: открытые Project Параметры>GitHub подключения.

  3. если подключение из проекта впервые устанавливается, выберите Подключение учетной записи GitHub , чтобы использовать учетные данные GitHub.

    снимок экрана: первый раз при подключении с учетными данными GitHub.

    В противном случае выберите создать подключение и выберите метод проверки подлинности в диалоговом окне Создание соединения .

    при подключении с использованием учетной записи GitHub для проверки подлинности используются учетные данные GitHub учетной записи. при подключении с помощью pat см. статью добавление GitHub подключения с помощью pat. при подключении к серверу Enterprise GitHub см. раздел регистрация Azure DevOps в GitHub в качестве приложения OAuth.

добавление GitHub подключения с учетными данными GitHub

Вы можете подключить к проекту Azure Boards до 250 репозиториев GitHub.

  1. если вы впервые подключаетесь к GitHub из Azure Boards, вам будет предложено выполнить вход с использованием учетных данных GitHub. Выберите учетную запись, которой вы являетесь администратором для репозиториев, к которому вы хотите подключиться.

  2. если вы принадлежите нескольким GitHub учетной записи или организации, выберите ту, чьи репозитории вы хотите подключить. Перечислены только те организации, которыми вы владеете или являетесь администратором.

    снимок экрана: выбор из нескольких GitHub организаций для подключения.

    если все репозитории для организации уже подключены к Azure Boards, вы увидите следующее сообщение.

    Снимок экрана сообщения, в котором больше нет репозиториев для подключения.

  3. при появлении запроса введите учетные данные GitHub.

    диалоговое окно входа GitHub
    если вы включили двухфакторную проверку подлинности, введите код проверки подлинности, который GitHub отправить, и нажмите кнопку проверить.

    диалоговое окно GitHub двухфакторной проверки подлинности

    в противном случае система автоматически распознает GitHubную организацию, так как учетная запись GitHub ранее была связана с учетной записью Azure DevOps Services.

Выбор репозиториев

После проверки подлинности вы сможете выбрать репозитории, которые нужно подключить.

  1. диалоговое окно добавление GitHub репозиториев автоматически отображает и выбирает все репозитории GitHub. com, для которых вы являетесь администратором выбранной организации. Отмените выбор всех репозиториев, которые не должны участвовать в интеграции.

    выберите репозитории GitHub.

    Совет

    рекомендуется подключать репозиторий GitHub только к проектам, определенным в одной Azure DevOpsной организации. Подключение одного репозитория GitHub к проектам, которые определены в двух или более организациях Azure DevOps, может привести к созданию непредвиденных связей между упоминаниями AB# . Дополнительные сведения см. в разделе Устранение неполадок при интеграции между GitHub и Azure Boards.

    Если все репозитории уже подключены к текущей или другой организации, отображается следующее сообщение.

    Снимок экрана сообщения, в котором больше нет репозиториев для подключения.

  2. По завершении нажмите кнопку сохранить.

Подтверждение подключения

на этом шаге вы установите Azure Boards приложение для GitHub в учетной записи GitHub или организации, связанной с репозиториями, к которым вы выбрали подключение.

  1. просмотрите страницу GitHub, на которой отображаются и выберите утвердить, установить, & авторизовать.

    подтверждение репозиториев GitHub

  2. укажите пароль GitHub для подтверждения.

  3. После этого вы увидите новое подключение с выбранными репозиториями.

    подключенные репозитории GitHub

чтобы изменить конфигурацию или управлять приложением Azure Boards для GitHub, см. статью изменение доступа к репозиторию до Azure Boards.

добавление GitHub подключения с помощью PAT

для подключения к репозиторию GitHub рекомендуется использовать учетные данные учетной записи GitHub. Однако, если необходимо использовать PAT, можно выполнить следующие процедуры.

Совет

при создании GitHub PAT убедитесь, что включены следующие области: repo, read:user, user:email, admin:repo_hook .

  1. чтобы выбрать PAT при подключении к репозиторию GitHub, выберите личный маркер доступа при первом подключении.

    Первое подключение, выберите личный маркер доступа.

    или в диалоговом окне создания подключения GitHub.

    новое диалоговое окно подключения GitHub выберите личный маркер доступа.

    чтобы создать GitHub PAT, перейдите на страницу GitHub Developer Параметры>личные маркеры доступа.

  2. введите PAT и выберите Подключение.

    введите PAT и выберите Подключение.

  3. Выберите репозитории, которые нужно подключить к проекту, выполнив процедуры, описанные в разделе Выбор репозиториев выше в этой статье.

  4. если вы впервые подключаетесь к GitHub учетной записи или организации из Azure Boards, вы также сможете установить Azure Boards приложение для GitHub. Завершите интеграцию, выполнив процедуры, описанные в разделе подтверждение подключения ранее в этой статье.

регистрация Azure DevOps в GitHub в качестве приложения OAuth

если вы планируете использовать OAuth для подключения Azure DevOps Services или Azure DevOps Server к серверу GitHub Enterprise, сначала необходимо зарегистрировать приложение в качестве приложения OAuth. Дополнительные сведения см. в разделе Создание приложения OAuth.

Регистрация Azure DevOps Services

  1. войдите на веб-портал для сервера GitHub Enterprise.

    вход в GitHub Enterprise server

  2. откройте Параметры>параметры разработчика>приложения oauth и выберите новое приложение oauth.

    откройте Параметры>параметры разработчика>приложения oauth и выберите новое приложение oauth.

  3. заполните форму, чтобы зарегистрировать приложение Azure DevOps Server.

    В качестве URL-адреса домашней страницыукажите URL-адрес Организации в Организации.
    Для URL-адреса обратного вызова авторизациииспользуйте следующий шаблон для создания URL-адреса.

    {Azure DevOps Services Organization URL}/_admin/oauth2/callback

    Пример:

    https://dev.azure.com/fabrikam/_admin/oauth2/callback

    регистрация проекта Azure DevOps Server

  4. Выберите зарегистрировать приложение.

  5. После успешного выполнения вы увидите страницу, которая предоставляет идентификатор клиента и секрет клиента для зарегистрированного приложения OAuth.

    Идентификатор клиента и секрет клиента для зарегистрированного приложения OAuth.

Регистрация конфигурации OAuth в Azure DevOps Services

  1. Войдите на веб-портал для Azure DevOps Services.

  2. добавьте GitHub Enterprise конфигурации Oauth в свою организацию.

  3. Откройте Параметры организации>конфигурации OAuth, а затем выберите Добавить конфигурацию OAuth.

    откройте Параметры организации, конфигурации OAuth.

  4. Заполните форму в появившейся форме, а затем нажмите кнопку создать.

    Диалоговое окно конфигураций OAuth.

Подключение Azure DevOps Services GitHub Enterprise Server

Важно!

чтобы подключить Azure DevOps Services к серверу GitHub Enterprise, сервер GitHub Enterprise должен быть достаточно доступен из интернета. убедитесь, что Azure DNS можете разрешить имя сервера GitHub Enterprise и брандмауэр разрешает доступ из IP-адресов центра обработки данных Azure. сведения об определении диапазона ip-адресов см. в разделе Microsoft Azure ip-диапазонов центра обработки данных. При наличии проблем с подключением возникает общее сообщение об ошибке:

Не удалось разрешить удаленное имя: "github-enterprise-server.contoso.com"

При возникновении этой ошибки убедитесь, что сервер доступен. Дополнительные сведения см. в разделе Azure DNS часто задаваемые вопросы.

  1. на странице Project Параметры>GitHub подключения выберите GitHub Enterprise server (GitHub Enterprise server ) при первом подключении.

    первое подключение выберите GitHub Enterprise Server.

    либо в диалоговом окне GitHub новое подключение выберите GitHub Enterprise Server.

    новое диалоговое окно подключения GitHub выберите GitHub Enterprise Server.

  2. Выберите метод проверки подлинности.

    Выберите диалоговое окно метода проверки подлинности.

    Подключение с помощью OAuth

    выберите конфигурацию, настроенную на шаге 4, из раздела регистрация конфигурации OAuth в Azure DevOps Services, а затем выберите Подключение.

    новое подключение Enterprise GitHub, диалоговое окно подключения OAuth

    Подключение с помощью личного маркера доступа

    введите URL-адрес сервера GitHub Enterprise и личные данные маркера доступа, распознаваемые этим сервером. и выберите Подключение.

    новое GitHub Enterprise подключение, диалоговое окно подключения личного маркера доступа

    Подключение с использованием имени пользователя и пароля

    введите URL-адрес сервера GitHub Enterprise и учетные данные администратора, распознаваемые этим сервером. и выберите Подключение.

    новое GitHub Enterprise подключение, диалоговое окно соединения с именем пользователя

    Выберите репозитории для подключения

  3. в этом диалоговом окне перечислены все репозитории, для которых у вас GitHub права администрирования. Можно переключаться между режимами " Мой " и " все ", чтобы определить, отображаются ли другие пользователи, а затем проверить, какие из них нужно добавить. По завершении нажмите кнопку сохранить .

    Выберите репозитории для добавления.

    Совет

    подключение можно установить только к репозиториям, определенным в одной организации GitHub. чтобы подключить проект к другим репозиториям, определенным в другой GitHub организации, необходимо добавить еще одно подключение.

  4. если вы впервые подключаетесь к GitHub учетной записи или организации из Azure Boards, вы также сможете установить Azure Boards приложение для GitHub. Завершите интеграцию, выполнив процедуры, описанные в разделе подтверждение подключения ранее в этой статье.

Устранение неполадок с подключением

см. раздел устранение неполадок GitHub подключении к репозиторию.

Возможные дальнейшие действия