Подключение Azure DevOps Server в GitHub (локальная среда)

Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019

Необходимые компоненты

• Подключение в репозитории GitHub.com путем установки Azure DevOps Server 2020.1.1 с исправлением 2. Без этого исправления вы можете подключиться только к репозиториям GitHub Enterprise Server.
• Установите приложение Azure Boards для GitHub в организациях или учетной записи GitHub .
• Подключение в проект Azure Boards или Azure DevOps. Если у вас еще нет проекта, создайте его.
• Вы должны быть членом группы Администратор istratorов коллекции проектов и группы участников проекта. Если вы создали проект, у вас есть разрешения.
• Вы должны быть администратором GitHub Enterprise Server, к которому вы подключаетесь.

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

Поддерживаются следующие параметры проверки подлинности.

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

1. Откройте веб-портал для сервера Azure DevOps.

2. Выберите логотип Azure DevOps, чтобы открыть Проекты, а затем выберите проект Azure Boards, который вы хотите настроить для подключения к репозиториям GitHub Enterprise.

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

1. Сведения о создании PAT см. в статье "Создание личного маркера доступа".

   Совет

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

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

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

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

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

   

3. Чтобы подключиться к учетной записи или организации GitHub из Azure Boards в первый раз, вы также установите приложение Azure Boards для GitHub. Выполните интеграцию, выполнив процедуры, описанные в разделе "Подтверждение подключения".

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

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

Общие сведения об интеграции, которую поддерживает приложение Azure Boards для GitHub, см. в статье об интеграции Azure Boards-GitHub.

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

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

Платформа

GitHub.com

GitHub Enterprise Server

Azure DevOps Services

• учетная запись пользователя GitHub.com
• Личный маркер доступа

• OAuth
• PAT
• Имя пользователя и пароль

Azure DevOps Server 2020

Нет данных

• PAT
• Имя пользователя и пароль

Сервер Azure DevOps 2019

Нет данных

• OAuth
• PAT
• Имя пользователя и пароль

Примечание.

Благодаря использованию приложения Azure Boards для GitHub поддерживается интеграция Azure Boards и Azure DevOps Services с репозиториями GitHub.com и GitHub Enterprise Server. Azure DevOps Server 2019 и более поздних версий поддерживают интеграцию только с репозиториями GitHub Enterprise Server. Интеграция с другими репозиториями Git не поддерживается.

Устранение проблем с доступом

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

Рассмотрим следующие решения:

• Если подключение использует OAuth:

  • Приложение Azure Boards было отказано в доступе для одной из репозиториев.

  • GitHub может быть недоступным или недоступным. Эта недоступность может быть вызвана сбоем в службе или локальной проблеме инфраструктуры или сети. Состояние службы можно проверка со следующими ссылками:

    • GitHub
    • Azure DevOps

    Удалите и повторно создайте подключение к репозиторию GitHub. Это повторное подключение приводит к тому, что GitHub запрашивает повторную проверку подлинности Azure Boards.

• Если подключение использует PAT:

  • Возможно, ПАТ был отозван или необходимые область разрешений изменены и недостаточно.

  • Возможно, пользователь потерял разрешения администратора в репозитории GitHub.

    Повторно создайте PAT и убедитесь, что область для маркера содержит необходимые разрешения: repo, read:user, user:email, admin:repo_hook

Обновление определений XML для выбора типов рабочих элементов

Если в организации используется модель размещенного XML-процесса или локального xml-процесса для настройки интерфейса отслеживания работы, и вы хотите связаться с типами ссылок GitHub из раздела "Разработка" в формах рабочих элементов, необходимо обновить определения XML для типов рабочих элементов.

Например, если вы хотите связать пользовательские истории и ошибки с фиксациями GitHub и вытягивать запросы из раздела "Разработка ", необходимо обновить xml-определения для пользовательских историй и ошибок.

Следуйте последовательности задач, предоставленных в модели процесса размещенного XML, чтобы обновить определения XML. Для каждого типа рабочего элемента найдите Group Label="Development" раздел и добавьте следующие две строки в следующем синтаксисе кода для поддержки типов внешних ссылок: GitHub Commit и GitHub Pull Request.

             <ExternalLinkFilter Type="GitHub Pull Request" />  
             <ExternalLinkFilter Type="GitHub Commit" />  

При обновлении раздел должен отображаться следующим образом.

<Group Label="Development">  
   <Control Type="LinksControl" Name="Development">  
      <LinksControlOptions ViewMode="Dynamic" ZeroDataExperience="Development" ShowCallToAction="true">  
         <ListViewOptions GroupLinks="false">   
         </ListViewOptions>  
         <LinkFilters>  
             <ExternalLinkFilter Type="Build" />  
             <ExternalLinkFilter Type="Integrated in build" />  
             <ExternalLinkFilter Type="Pull Request" />  
             <ExternalLinkFilter Type="Branch" />  
             <ExternalLinkFilter Type="Fixed in Commit" />  
             <ExternalLinkFilter Type="Fixed in Changeset" />  
             <ExternalLinkFilter Type="Source Code File" />  
             <ExternalLinkFilter Type="Found in build" />  
             <ExternalLinkFilter Type="GitHub Pull Request" />  
             <ExternalLinkFilter Type="GitHub Commit" />  
         </LinkFilters>  
      </LinksControlOptions>  
   </Control>  
</Group>  

Следующие шаги

Связь фиксаций и запросов на вытягивание GitHub с рабочими элементами

Связанные статьи

• Что такое Azure Boards?
• Устранение неполадок при интеграции между GitHub и Azure Boards
• Создание репозиториев GitHub Enterprise Server