Połączenie azure DevOps Server do usługi GitHub (lokalnie)

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

Wymagania wstępne

• Połączenie do repozytoriów GitHub.com przez zainstalowanie poprawki 2020.1.1 usługi Azure DevOps Server 2. Bez tej poprawki można łączyć się tylko z repozytoriami serwera GitHub Enterprise Server.
• Zainstaluj aplikację Usługi Azure Boards dla usługi GitHub w organizacjach lub kontach usługi GitHub.
• Połączenie do projektu usługi Azure Boards lub usługi Azure DevOps. Jeśli nie masz jeszcze projektu, utwórz go.
• Musisz być członkiem grupy project collection Administracja istrators i grupy Współautorzy projektu. Jeśli projekt został utworzony, masz uprawnienia.
• Musisz być administratorem serwera GitHub Enterprise Server, z którym nawiązujesz połączenie.

Opcje uwierzytelniania

Obsługiwane są następujące opcje uwierzytelniania.

Połączenie serwera Azure DevOps Server do usługi GitHub Enterprise Server

1. Otwórz portal internetowy dla serwera Azure DevOps Server.

2. Wybierz logo usługi Azure DevOps, aby otworzyć projekty, a następnie wybierz projekt usługi Azure Boards, który chcesz skonfigurować w celu nawiązania połączenia z repozytoriami GitHub Enterprise.

Połączenie z osobistym tokenem dostępu

1. Aby utworzyć osobisty token dostępu, zobacz Tworzenie osobistego tokenu dostępu.

   Napiwek

   Podczas tworzenia identyfikatora PAT usługi GitHub upewnij się, że zostały uwzględnione następujące zakresy: repo, admin:repo_hook, read:user, user:email.

2. Wprowadź adres URL serwera GitHub Enterprise i poświadczenia osobistego tokenu dostępu rozpoznane przez ten serwer. A następnie wybierz pozycję Połączenie.

Połączenie z nazwą użytkownika i hasłem

1. Wprowadź adres URL serwera GitHub Enterprise i poświadczenia konta administratora rozpoznane przez ten serwer. A następnie wybierz pozycję Połączenie.

2. W oknie dialogowym są wyświetlane wszystkie repozytoria, dla których masz uprawnienia administracyjne usługi GitHub. Możesz przełączać się między elementami Mine i All , aby określić, czy inne są wyświetlane, a następnie sprawdzić te, które chcesz dodać. Po zakończeniu wybierz pozycję Zapisz .

   

3. Aby nawiązać połączenie z kontem usługi GitHub lub organizacją z usługi Azure Boards po raz pierwszy, zainstaluj również aplikację Usługi Azure Boards dla usługi GitHub. Wykonaj integrację, postępując zgodnie z procedurami opisanymi w temacie Potwierdzanie połączenia.

Rozwiązywanie problemów z połączeniem

Integracja usługi Azure Boards-GitHub opiera się na różnych protokołach uwierzytelniania do obsługi połączenia. Zmiany zakresu uprawnień użytkownika lub poświadczeń uwierzytelniania mogą spowodować odwołanie repozytoriów GitHub połączonych z usługą Azure Boards.

Aby zapoznać się z omówieniem integracji obsługiwanej przez aplikację Usługi Azure Boards dla usługi GitHub, zobacz Integracja z usługą Azure Boards-GitHub.

Obsługiwane opcje uwierzytelniania

Poniższe opcje uwierzytelniania są obsługiwane na podstawie platformy GitHub, z którą chcesz nawiązać połączenie.

Platforma

GitHub.com

GitHub Enterprise Server

Azure DevOps Services

• konto użytkownika GitHub.com
• Osobisty token dostępu (PAT)

• OAuth
• Osobisty token dostępu
• Nazwa użytkownika i hasło

Oprogramowanie Azure DevOps Server 2020

Nie dotyczy

• Osobisty token dostępu
• Nazwa użytkownika i hasło

Azure DevOps Server 2019

Nie dotyczy

• OAuth
• Osobisty token dostępu
• Nazwa użytkownika i hasło

Uwaga

Dzięki aplikacji Azure Boards dla usług GitHub usługi Azure Boards i Azure DevOps Services obsługują integrację z repozytoriami GitHub.com i GitHub Enterprise Server. Serwery Azure DevOps Server 2019 i nowsze obsługują integrację tylko z repozytoriami GitHub Enterprise Server. Integracja z innymi repozytoriami Git nie jest obsługiwana.

Rozwiązywanie problemów z dostępem

Gdy połączenie usługi Azure Boards z usługą GitHub nie ma już dostępu, wyświetla stan alertu w interfejsie użytkownika z czerwonym-X. Umieść kursor na alercie i wskazuje, że poświadczenia nie są już prawidłowe. Aby rozwiązać ten problem, usuń połączenie i utwórz ponownie nowe połączenie.

Rozważ następujące rozwiązania:

• Jeśli połączenie korzysta z protokołu OAuth:

  • Aplikacja usługi Azure Boards nie mogła uzyskać dostępu do jednego z repozytoriów.

  • Usługa GitHub może być niedostępna/nieosiągalna. Ta niedostępność może być przyczyną awarii w usłudze lub problemu z infrastrukturą/siecią lokalną. Stan usługi można sprawdzić za pomocą następujących linków:

    • GitHub
    • Azure DevOps

    Usuń i ponownie utwórz połączenie z repozytorium GitHub. To ponowne utworzenie połączenia powoduje, że usługa GitHub wyświetli monit o ponowne uwierzytelnienie usługi Azure Boards.

• Jeśli połączenie korzysta z patu:

  • Być może identyfikator pat został odwołany lub zmienione wymagane zakresy uprawnień i są niewystarczające.

  • Użytkownik mógł utracić uprawnienia administratora w repozytorium GitHub.

    Utwórz ponownie identyfikator PAT i upewnij się, że zakres tokenu obejmuje wymagane uprawnienia: repo, read:user, user:email, admin:repo_hook.

Aktualizowanie definicji XML dla wybranych typów elementów roboczych

Jeśli organizacja używa hostowanego kodu XML lub lokalnego modelu przetwarzania XML w celu dostosowania środowiska śledzenia pracy, a następnie chcesz połączyć się z typami linków usługi GitHub z sekcji Programowanie w formularzach elementów roboczych, musisz zaktualizować definicje XML dla typów elementów roboczych.

Jeśli na przykład chcesz połączyć historie użytkowników i usterki z zatwierdzeniami i żądaniami ściągnięcia usługi GitHub z sekcji Programowanie , musisz zaktualizować definicje XML dla scenariuszy użytkowników i usterek.

Postępuj zgodnie z sekwencją zadań udostępnionych w modelu procesów hostowanego XML, aby zaktualizować definicje XML. Dla każdego typu elementu roboczego znajdź sekcję Group Label="Development" i dodaj następujące dwa wiersze w następującej składni kodu, aby obsługiwać typy linków zewnętrznych: Zatwierdzenie usługi GitHub i żądanie ściągnięcia w usłudze GitHub.

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

Po zaktualizowaniu sekcja powinna być wyświetlana w następujący sposób.

<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>  

Następne kroki

Łączenie zatwierdzeń usługi GitHub i żądań ściągnięcia do elementów roboczych

Powiązane artykuły

• Co to jest usługa Azure Boards?
• Rozwiązywanie problemów z integracją z usługą GitHub i usługą Azure Boards
• Tworzenie repozytoriów GitHub Enterprise Server