Udostępnij za pośrednictwem

Instalacja aplikacji Azure Boards w serwisie GitHub

  • Artykuł

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Zainstaluj aplikację Usługi Azure Boards dla usługi GitHub, aby połączyć usługę Azure Boards z repozytoriami GitHub. Podczas łączenia projektów usługi Azure Boards z repozytoriami GitHub.com można łączyć się między zatwierdzeniami usługi GitHub i żądaniami ściągnięcia do elementów roboczych. Usługi GitHub można używać do tworzenia oprogramowania podczas planowania i śledzenia pracy przy użyciu usługi 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. Po zainstalowaniu aplikacji Azure Boards dla usługi GitHub na koncie lub organizacji usługi GitHub wybierz repozytoria GitHub, z którymi chcesz nawiązać połączenie z projektu.

Wymagania wstępne

  • Aby zainstalować aplikację usługi Azure Boards, musisz być administratorem lub właścicielem organizacji usługi GitHub.
  • Aby nawiązać połączenie z projektem usługi Azure Boards, musisz mieć uprawnienia do odczytu dla repozytorium GitHub. Ponadto musisz być członkiem grupy Administratorzy kolekcji projektów. Jeśli projekt został utworzony, masz uprawnienia.

Ważne

Jeśli repozytorium jest już połączone za pośrednictwem innego typu uwierzytelniania, takiego jak OAuth, musisz usunąć to repozytorium z istniejącego połączenia przed ponownym połączeniem za pośrednictwem aplikacji GitHub. Przed skonfigurowaniem aplikacji GitHub wykonaj kroki opisane w temacie Dodawanie lub usuwanie repozytoriów GitHub w dalszej części tego artykułu.

Jeśli jesteś administratorem tych repozytoriów, możesz połączyć organizację usługi Azure DevOps z wieloma repozytoriami GitHub. Nie należy jednak łączyć repozytorium GitHub z więcej niż jedną organizacją usługi Azure DevOps.

Przyznawanie dostępu organizacji w usłudze Azure Boards

Wykonaj następujące kroki, aby udzielić organizacji dostępu.

  1. W portalu internetowym usługi GitHub otwórz pozycję Ustawienia z menu profilu.

    Zrzut ekranu przedstawiający otwarty profil, wybierz pozycję Ustawienia.

  2. Wybierz pozycję Aplikacje w obszarze Integracje.

  3. Wybierz pozycję Autoryzowane aplikacje OAuth w>usłudze Azure Boards.

    Zrzut ekranu przedstawiający kartę Autoryzowane aplikacje OAuth wybierz pozycję Azure Boards.

  4. W obszarze Dostęp do organizacji rozwiąż wszelkie problemy, które mogą się pojawić. Wybierz pozycję Udziel , aby udzielić dostępu do wszystkich organizacji, które są wyświetlane jako oczekujące na żądanie dostępu.

    Zrzut ekranu przedstawiający dostęp do organizacji z organizacjami bez dostępu.

Instalowanie i konfigurowanie aplikacji usługi Azure Boards

  1. Przejdź do aplikacji Usługi Azure Boards w witrynie GitHub Marketplace.

  2. Wybierz pozycję Skonfiguruj plan.

    Zrzut ekranu witryny GitHub Marketplace, przycisk Skonfiguruj plan.

  3. Wybierz organizację usługi GitHub, z którą chcesz nawiązać połączenie z usługą Azure Boards.

    Zrzut ekranu przedstawiający okno dialogowe Instalowanie usługi Azure Boards.

  4. Wybierz repozytoria, które chcesz połączyć z usługą Azure Boards.

    W poniższym przykładzie wybieramy połączenie ze wszystkimi repozytoriami.

    Zrzut ekranu przedstawiający wybrane wszystkie repozytoria.

  5. Wybierz organizację usługi Azure DevOps i projekt usługi Azure Boards, z którym chcesz nawiązać połączenie z GitHub.com.

    Zrzut ekranu przedstawiający okno dialogowe konfigurowania połączenia.

    Jednocześnie można połączyć tylko jeden projekt. Jeśli masz inne projekty, które chcesz połączyć, możesz to zrobić później, zgodnie z opisem w temacie Konfigurowanie innych projektów lub repozytoriów w dalszej części tego artykułu.

  6. Autoryzuj organizację usługi Azure Boards, aby nawiązać połączenie z GitHub.com.

    Zrzut ekranu przedstawiający okno dialogowe autoryzacji usługi Azure Boards.

  7. Potwierdź repozytoria GitHub.com, które chcesz nawiązać połączenie. Wybierz każde repozytorium, z którym chcesz nawiązać połączenie. Usuń zaznaczenie wszystkich repozytoriów, których nie chcesz uczestniczyć w integracji.

    Zrzut ekranu przedstawiający okno dialogowe Potwierdzanie repozytoriów GitHub.

Korzystanie z połączenia

W tym momencie integracja usługi Azure Boards-GitHub została ukończona. Możesz pominąć kolejne kroki lub przejść przez nie, aby poznać funkcje obsługiwane przez połączenie.

  1. Na tablicy wybierz pozycję Nowy element, aby wprowadzić nowy element roboczy o nazwie "Add badge to README" (Problem (Basic), User Story (Agile) lub Product Backlog Item (Scrum) — w zależności od modelu procesu używanego przez projekt usługi Azure Boards.

    Na tablicy zostanie wyświetlony element roboczy o nazwie Dodaj wskaźnik do pliku README .

  2. Otwórz element roboczy i wybierz pozycję Żądanie ściągnięcia w obszarze Dodaj link.

  3. Wybierz repozytorium i wprowadź identyfikator żądania ściągnięcia i opcjonalny komentarz.

  4. Wybierz pozycję Dodaj link.

    Zrzut ekranu przedstawiający akcję Dodaj łącze w scenariuszu użytkownika z zaznaczonymi polami wyboru repozytorium i pustymi polami dla danych wejściowych identyfikatora żądania ściągnięcia i opcjonalnym komentarzem.

    W tle są wykonywane następujące akcje.

    • Dodaje wskaźnik do pliku README pierwszego repozytorium na liście połączonych repozytoriów GitHub.
    • Tworzy zatwierdzenie usługi GitHub dla aktualizacji wprowadzonej przez dodanie wskaźnika do pliku README.
    • Tworzy żądanie ściągnięcia usługi GitHub w celu scalenia zmian wprowadzonych w pliku README.
    • Łączy zatwierdzenie usługi GitHub i żądanie ściągnięcia z elementem roboczym utworzonym w kroku 1.

  5. Wybierz pierwszy link żądania ściągnięcia z elementu roboczego.

    Zrzut ekranu przedstawiający formularz problemu dla żądania ściągnięcia otwartego w usłudze GitHub.

    Żądanie ściągnięcia usługi GitHub zostanie otwarte na nowej karcie przeglądarki.

  6. Wybierz pozycję Scal żądanie ściągnięcia.

    Zrzut ekranu przedstawiający przykładowe żądanie ściągnięcia w usłudze GitHub.

  7. Przejdź do pliku README repozytorium i wyświetl wskaźnik, który został dodany.

    Zrzut ekranu repozytorium GitHub z dodanym znaczkiem.

    Aby uzyskać więcej informacji, zobacz Konfigurowanie znaczków stanu w celu dodania do plików README usługi GitHub.

Konfigurowanie innych projektów lub repozytoriów

Możesz skonfigurować inne usługi Azure Boards/Azure DevOps Projects, GitHub.com repozytoria lub zmienić bieżącą konfigurację ze strony aplikacji Usługi Azure Boards. Aby uzyskać więcej informacji, zobacz Zmienianie dostępu do repozytorium GitHub lub wstrzymanie lub odinstalowanie integracji.

Dodawanie lub usuwanie repozytoriów lub usuwanie połączenia z usługi Azure Boards

Jeśli wystąpi problem z połączeniem, zalecamy usunięcie połączenia i rozpoczęcie od nowego połączenia.

  1. Aby dodać lub usunąć repozytoria, wybierz pozycję Więcej opcji połączenia, a następnie wybierz pozycję Dodaj repozytoria lub Usuń repozytoria z menu.

    Zrzut ekranu przedstawiający menu połączenia usługi GitHub z opcją Więcej opcji.

  2. Aby usunąć wszystkie repozytoria i połączenie, wybierz opcję Usuń połączenie . Następnie wybierz pozycję Usuń , aby potwierdzić.

    Zrzut ekranu przedstawiający potwierdzenie usunięcia połączenia z usługą GitHub.

  1. Aby dodać lub usunąć repozytoria, otwórz ikonę akcji dla połączenia i wybierz pozycję Dodaj repozytoria lub Usuń repozytoria z menu.

    Zrzut ekranu przedstawiający dodawanie lub usuwanie repozytoriów GitHub.

  2. Aby usunąć wszystkie repozytoria i połączenie, wybierz opcję Usuń połączenie . Następnie wybierz pozycję Usuń , aby potwierdzić.

    Zrzut ekranu przedstawiający potwierdzenie okna dialogowego usuwania połączenia z usługą GitHub.

Zmienianie dostępu do repozytorium

  1. Zaloguj się do portalu internetowego dla organizacji usługi GitHub i otwórz ustawienia konta.

    https://github.com/organizations/fabrikam-fiber/settings/profile

  2. Wybierz pozycję Zainstalowane aplikacje GitHub, a następnie pozycję Konfiguruj obok usługi Azure Boards.
    Zrzut ekranu przedstawiający otwieranie konta organizacji, zainstalowane aplikacje GitHub, usługę Azure Boards, konfigurowanie.

    Zostanie otwarta strona konfiguracji usługi Azure Boards.

  3. Przewiń w dół do sekcji Dostęp do repozytorium.

  4. Wybierz odpowiednią opcję, Wszystkie repozytoria lub Wybierz tylko repozytoria.

    Jeśli wybierzesz pozycję Tylko wybrane repozytoria, wybierz repozytoria, które chcesz uczestniczyć w integracji z usługą Azure Boards.

    Zrzut ekranu przedstawiający dostęp do repozytorium, a następnie wybierz pozycję Tylko wybierz repozytoria.

  5. Po zakończeniu wybierz pozycję Zapisz .

Zawieszanie lub odinstalowywanie integracji z usługą Azure Boards

  1. Począwszy od kroku 2 w poprzedniej procedurze, przewiń w dół do sekcji Strefa niebezpieczeństwa.

    Zrzut ekranu przedstawiający sekcję Konfiguracja usługi Azure Boards, Strefa zagrożenia.

  2. Aby wstrzymać integrację, wybierz pozycję Wstrzymaj. W oknie potwierdzenia wyskakującego wybierz przycisk OK , aby potwierdzić zawieszenie.

    Zrzut ekranu przedstawiający potwierdzenie zawieszenia.

    Aby cofnąć wstrzymanie integracji, wybierz pozycję Cosuspend.

  3. Aby odinstalować aplikację usługi Azure Boards, wybierz pozycję Odinstaluj, a następnie wybierz przycisk OK w oknie potwierdzenia wyskakującego.

    Zrzut ekranu przedstawiający potwierdzenie odinstalowania.

Aktualizowanie połączeń usługi Azure Boards-GitHub

Jeśli zmienisz repozytoria obsługiwane przez aplikację usługi Azure Boards dla usługi GitHub, możesz przekierować do połączeń usługi GitHub usługi Azure Boards. Dobrym rozwiązaniem jest usunięcie repozytoriów w usłudze Azure Boards, które nie mogą już łączyć się z usługą GitHub. Aby uzyskać więcej informacji, zobacz Dodawanie lub usuwanie repozytoriów GitHub.

Jeśli odinstalujesz aplikację Usługi Azure Boards dla usługi GitHub, w usłudze Azure Boards zostanie wyświetlony następujący komunikat, ustawienia>projektu — połączenia usługi GitHub. Wybierz pozycję Usuń połączenie , aby usunąć wszystkie wcześniej wykonane połączenia usługi GitHub. Aby uzyskać więcej informacji, zobacz Dodawanie/usuwanie repozytoriów GitHub.

Zrzut ekranu przedstawiający odinstalowaną aplikację GitHub usługi Azure Boards.

Następne kroki

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