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 kolekcji projektów Administracja istratoró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 Ustawienia z menu profilu.

    Screenshot of open profile, choose Settings.

  2. Wybierz pozycję Aplikacje w obszarze Integracje.

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

    Screenshot of Authorized OAuth Apps tab, choose 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.

    Screenshot of Organization access with organizations without access.

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.

    Screenshot of GitHub Marketplace, Set up a plan button.

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

    Screenshot showing Install Azure Boards dialog.

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

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

    Screenshot showing all repositories selected.

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

    Screenshot of setting up connection dialog.

    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.

    Screenshot of Azure Boards authorization dialog.

  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.

    Screenshot of Confirm your GitHub repositories dialog.

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.

    Screenshot of Add link action in user story, showing repository selection and empty boxes for input of pull request ID and optional comment.

    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.

    Screenshot of issue form for pull request opened in GitHub.

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

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

    Screenshot of example pull request in GitHub.

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

    Screenshot of GitHub repo with badge added.

    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.

    Screenshot of GitHub connection menu of More options.

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

    Screenshot of confirmation removal of GitHub connection.

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

    Screenshot of add or remove GitHub repos.

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

    Screenshot of confirmation of GitHub connection removal dialog.

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.
    Screenshot of open Organization account, Installed GitHub Apps, Azure Boards, Configure.

    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.

    Screenshot of Repository access, choose Only select repositories.

  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.

    Screenshot of Azure Boards configuration, Danger zone section.

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

    Screenshot of suspension confirmation.

    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.

    Screenshot of uninstall confirmation.

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.

Screenshot of uninstalled Azure Boards GitHub app.

Następne kroki

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