Łączenie usługi GitHub z usługą Azure Boards

Ukończone

Integracja między usługami GitHub i Azure Boards tworzy zaawansowane podejście hybrydowe, które łączy przyjazne dla deweloperów środowisko usługi GitHub z możliwościami planowania przedsiębiorstwa w usłudze Azure Boards. To połączenie umożliwia organizacjom utrzymanie scentralizowanego ładu projektu przy jednoczesnym umożliwieniu zespołom deweloperów pracy w preferowanym środowisku Usługi GitHub.

Korzyści biznesowe wynikające z integracji:

  • Ujednolicona widoczność: Uczestnicy projektu mogą śledzić postęp programowania bez bezpośredniego uzyskiwania dostępu do usługi GitHub
  • Zgodność i audyt: Utrzymanie formalnego śledzenia projektów przy jednoczesnym zachowaniu przepływów pracy deweloperów
  • Współpraca międzyfunkcyjna: Budowanie mostu między menedżerami projektów a zespołami deweloperskimi
  • Automatyczna synchronizacja: zmniejszanie obciążenia ręcznego w utrzymaniu bieżącego stanu projektu

Zrzut ekranu przedstawiający elementy robocze usługi Azure Boards ze zintegrowanymi linkami GitHub, bezpośrednie wyświetlanie commitów, pull requestów i problemów w interfejsie elementu roboczego.

Aplikacja usługi Azure Boards: podstawy integracji

Aplikacja usługi Azure Boards służy jako most techniczny umożliwiający bezproblemowy przepływ danych między usługą GitHub i usługą Azure Boards. Ta aplikacja marketplace zapewnia bezpieczny, uwierzytelniony dostęp przy zachowaniu integralności obu platform.

Kluczowe możliwości integracji:

  • Łączenie dwukierunkowe: łączenie elementów roboczych usługi Azure Boards z zatwierdzeniami usługi GitHub, żądaniami ściągnięciami i problemami
  • Automatyczne przejścia stanu: Zakończ elementy robocze, gdy wzmianki w usłudze GitHub zawierają słowa kluczowe, takie jak "poprawki"
  • Synchronizacja w czasie rzeczywistym: zmiany w usłudze GitHub natychmiast odzwierciedlają się w usłudze Azure Boards
  • Elastyczna kontrola zakresu: wybierz integrację repozytorium dla całej organizacji lub wybierz integrację selektywną dla poszczególnych repozytoriów

Zrzut ekranu przedstawiający stronę instalacji aplikacji usługi Azure Boards w witrynie GitHub Marketplace z opcjami konfiguracji i uprawnieniami wymaganymi do integracji.

Wymagania i uprawnienia instalacji

Wymagania wstępne usługi GitHub:

  • Dostęp do repozytorium: uprawnienia administratora lub właściciela dla repozytoriów docelowych
  • Uprawnienia organizacji: rola właściciela dla instalacji w całej organizacji
  • Dostęp do witryny Marketplace: możliwość instalowania aplikacji z witryny GitHub Marketplace

Wymagania wstępne usługi Azure DevOps:

  • Administrator kolekcji projektu: wymagany do nawiązania pierwszego połączenia
  • Uprawnienia projektu: dostęp uczestników projektu lub wyższy do wyświetlania połączonych elementów roboczych
  • Poświadczenia uwierzytelniania: pat lub OAuth na potrzeby bezpiecznego dostępu do interfejsu API

Zagadnienia dotyczące uwierzytelniania i zabezpieczeń

Bezpieczne uwierzytelnianie ma kluczowe znaczenie dla utrzymania integralności danych i kontroli dostępu na obu platformach. Usługa Azure Boards obsługuje wiele metod uwierzytelniania, z których każda ma określone implikacje dotyczące zabezpieczeń i przypadki użycia.

Opcje uwierzytelniania w usłudze GitHub:

Metoda Poziom zabezpieczeń Najlepsze dla Zagadnienia do rozważenia
Osobisty token dostępu High Zautomatyzowane integracje, ciągła integracja/ciągłe wdrażanie Wymaga starannego zarządzania zakresem
Nazwa użytkownika/hasło Średni Połączenia poszczególnych użytkowników Mniej bezpieczne, niezalecane do użytku produkcyjnego
Aplikacje OAuth High Integracje dla całej organizacji Scentralizowane zarządzanie dostępem

Najlepsze rozwiązania w zakresie zabezpieczeń:

  • Zasada najniższych uprawnień: przyznawanie tylko niezbędnych uprawnień do funkcji integracji
  • Rotacja tokenów: Regularnie aktualizuj punkty dostępu i przejrzyj uprawnienia dostępu
  • Rejestrowanie audytów: Monitorowanie aktywności integracji pod kątem nietypowych wzorców dostępu
  • Izolacja repozytorium: łączenie tylko repozytoriów, które wymagają integracji z usługą Azure Boards

Proces połączenia krok po kroku:

  1. Instalowanie aplikacji usługi Azure Boards z witryny GitHub Marketplace
  2. Konfigurowanie dostępu do repozytorium (wszystkie repozytoria lub selektywne)
  3. Uwierzytelnianie za pomocą usługi Azure DevOps przy użyciu preferowanej metody
  4. Przypisz repozytoria do projektów w Azure Boards
  5. Testowanie integracji z przykładowymi linkami i zatwierdzeniami

Aby uzyskać szczegółowe wskazówki dotyczące implementacji, zobacz Connect Azure Boards to GitHub (Łączenie usługi Azure Boards z usługą GitHub)

Elastyczność konfiguracji i zarządzanie nią

Możliwości zarządzania po stronie usługi GitHub:

  • Kontrola zakresu repozytorium: dodawanie lub usuwanie określonych repozytoriów z integracji
  • Mapowanie projektu: Konfigurowanie, które projekty usługi Azure Boards łączą się z każdym repozytorium
  • Zawieszenie integracji: tymczasowo wyłącz bez utraty konfiguracji
  • Zakończono usuwanie: Odinstaluj aplikację i usuń wszystkie połączenia

Możliwości zarządzania po stronie usługi Azure Boards:

  • Połączenia z wieloma repozytoriami: łączenie wielu repozytoriów GitHub z pojedynczymi projektami
  • Łączenie między projektami: zezwalaj repozytoriom na łączenie się z wieloma projektami usługi Azure Boards
  • Monitorowanie kondycji połączenia: śledzenie stanu integracji i rozwiązywanie problemów z łącznością
  • Zarządzanie uprawnieniami: kontrolowanie, którzy użytkownicy mogą modyfikować połączenia usługi GitHub

Obsługiwane scenariusze integracji

Integracja usługi Azure Boards-GitHub obsługuje następujące połączenia:

  • Z usługi GitHub:

    • Integracja dla wszystkich repozytoriów powiązanych z kontem GitHub lub organizacją, lub dla wybranych repozytoriów.
    • Dodaj lub usuń repozytoria GitHub biorące udział w integracji i skonfiguruj projekt, z którymi się łączą.
    • Wstrzymaj integrację Boards-GitHub platformy Azure lub odinstaluj aplikację.
  • Z usługi Azure Boards:

    • Połącz co najmniej jedno repozytoria GitHub z projektem usługi Azure Boards.
    • Dodawanie lub usuwanie repozytoriów GitHub z połączenia usługi GitHub w projekcie usługi Azure Boards.
    • Całkowicie usuń połączenie z usługą GitHub dla projektu.
    • Zezwól repozytorium GitHub na łączenie się z co najmniej jednym projektem usługi Azure Boards w ramach tej samej organizacji lub kolekcji usługi Azure DevOps.

Integracja usługi Azure Boards-GitHub obsługuje następujące zadania operacyjne:

  • Tworzenie linków między elementami roboczymi i zatwierdzeniami usługi GitHub, żądaniami ściągnięcia i problemami w oparciu o wzmianki w usłudze GitHub.
  • Obsługa przejścia elementów roboczych do stanu Gotowe lub Ukończone w przypadku używania wzmianki w usłudze GitHub przy użyciu poprawki, poprawek lub naprawy.
  • Wspieraj pełną śledzialność przez opublikowanie komentarza do dyskusji w usłudze GitHub, gdy łączysz element roboczy z zatwierdzeniem, żądaniem ściągnięcia lub zgłoszeniem w usłudze GitHub.
  • Pokaż powiązane z artefaktami kodu GitHub w sekcji Rozwój elementu roboczego.
  • Pokaż artefakty powiązane z GitHub w formie adnotacji na kartach tablic Kanban.
  • Oznaczenia statusu wsparcia kolumn tablicy Kanban dodane do repozytoriów GitHub.

Następujące zadania nie są obecnie obsługiwane:

  • Wykonywanie zapytań o elementy robocze za pomocą linków do artefaktów usługi GitHub. Można jednak wykonywać zapytania dotyczące elementów roboczych z liczbą linków zewnętrznych większą niż 0.

Uwaga / Notatka

Dokumentacja: integracja z usługą Azure Boards-GitHub.

Aby uzyskać więcej informacji, zobacz: