Verknüpfen von GitHub mit Azure Boards

Die Integration zwischen GitHub und Azure Boards schafft einen leistungsstarken Hybridansatz, der die entwicklerfreundliche Umgebung von GitHub mit den Enterprise Planning-Funktionen von Azure Boards kombiniert. Diese Verbindung ermöglicht Es Organisationen, die zentrale Projektgovernance aufrechtzuerhalten, während Entwicklungsteams in ihrer bevorzugten GitHub-Umgebung arbeiten können.

Geschäftliche Vorteile der Integration:

• Einheitliche Sichtbarkeit: Projektbeteiligte können den Entwicklungsfortschritt nachverfolgen, ohne direkt auf GitHub zuzugreifen.
• Compliance und Überwachung: Verwalten der formalen Projektnachverfolgung bei gleichzeitiger Beibehaltung von Entwicklerworkflows
• Funktionsübergreifende Zusammenarbeit: Brücke zwischen Projektmanagern und Entwicklungsteams
• Automatische Synchronisierung: Verringern des manuellen Aufwands beim Aktualisieren des Projektstatus

Azure Boards-App: Die Integrationsgrundlage

Die Azure Boards-App dient als technische Brücke, die einen nahtlosen Datenfluss zwischen GitHub und Azure Boards ermöglicht. Diese Marketplace-Anwendung bietet sicheren, authentifizierten Zugriff und gleichzeitig die Integrität beider Plattformen.

Wichtige Integrationsfunktionen:

• Bidirektionale Verknüpfung: Verbinden von Azure Boards-Arbeitsaufgaben mit GitHub-Commits, PRs und Problemen
• Automatisierte Zustandsübergänge: Vollständige Arbeitsaufgaben, wenn GitHub-Erwähnungen Schlüsselwörter wie "Fixes" enthalten
• Echtzeitsynchronisierung: Änderungen in GitHub spiegeln sofort in Azure Boards wider
• Flexible Bereichskontrolle: Organisationsweite oder selektive Repositoryintegration auswählen

Installationsanforderungen und Berechtigungen

Voraussetzungen für GitHub:

• Repositoryzugriff: Administrator- oder Besitzerberechtigungen für Zielrepositorys
• Organisationsberechtigungen: Besitzerrolle für organisationsweite Installationen
• Marketplace-Zugriff: Möglichkeit zum Installieren von Anwendungen über GitHub Marketplace

Voraussetzungen für Azure DevOps:

• Project-Sammlungsadministrator: Erforderlich für die anfängliche Verbindungseinrichtung
• Projektberechtigungen: Zugriff auf Projektbeteiligte oder höher zum Anzeigen verknüpfter Arbeitsaufgaben
• Authentifizierungsanmeldeinformationen: PAT oder OAuth für den sicheren API-Zugriff

Überlegungen zur Authentifizierung und Sicherheit

Die sichere Authentifizierung ist entscheidend für die Aufrechterhaltung der Datenintegrität und der Zugriffssteuerung auf beiden Plattformen. Azure Boards unterstützt mehrere Authentifizierungsmethoden mit spezifischen Sicherheitsauswirkungen und Anwendungsfällen.

GitHub-Authentifizierungsoptionen:

Bewährte Methoden für sicherheit:

• Prinzip der geringsten Berechtigungen: Nur erforderliche Berechtigungen für Integrationsfunktionen erteilen
• Tokenrotation: Regelmäßiges Aktualisieren von PATs und Überprüfen von Zugriffsberechtigungen
• Überwachungsprotokollierung: Überwachen der Integrationsaktivität auf ungewöhnliche Zugriffsmuster
• Repositoryisolation: Verbinden Sie nur Repositorys, die azure Boards-Integration erfordern

Schrittweiser Verbindungsvorgang:

1. Installieren der Azure Boards-App von GitHub Marketplace
2. Konfigurieren des Repositoryzugriffs (alle Repositorys oder selektiv)
3. Authentifizieren mit Azure DevOps mit bevorzugter Methode
4. Zuordnen von Repositorys zu Projekten in Azure Boards
5. Testen der Integration mit Beispiellinks und Commits

Ausführliche Anleitungen zur Implementierung finden Sie unter: Verbinden von Azure Boards mit GitHub

Konfigurationsflexibilität und -verwaltung

GitHub-seitige Verwaltungsfunktionen:

• Repositorybereichssteuerung: Hinzufügen oder Entfernen bestimmter Repositorys aus der Integration
• Projektzuordnung: Konfigurieren, welche Azure Boards-Projekte mit den einzelnen Repositorys verbunden sind
• Integrationsaufsetzung: Vorübergehend deaktivieren, ohne die Konfiguration zu verlieren
• Vollständige Entfernung: Deinstallieren Sie die App, und entfernen Sie alle Verbindungen.

Azure Boards-seitige Verwaltungsfunktionen:

• Multirepository-Verbindungen: Verknüpfen mehrerer GitHub-Repositorys mit einzelnen Projekten
• Projektübergreifende Verknüpfung: Zulassen, dass Repositorys eine Verbindung mit mehreren Azure Boards-Projekten herstellen
• Überwachung der Verbindungsintegrität: Nachverfolgen des Integrationsstatus und Beheben von Konnektivitätsproblemen
• Berechtigungsverwaltung: Steuern, welche Benutzer GitHub-Verbindungen ändern können

Unterstützte Integrationsszenarien

Die Azure Boards-GitHub-Integration unterstützt die folgenden Verbindungen:

• Von GitHub:

  • Unterstützen der Integration für alle Repositorys für ein GitHub-Konto oder eine Organisation oder Auswählen von Repositorys.
  • Fügen Sie GitHub-Repositorys hinzu, die an der Integration teilnehmen, oder entfernen Sie sie, und konfigurieren Sie das Projekt, mit dem sie eine Verbindung herstellen.
  • Anhalten der Azure Boards-GitHub Integration oder Deinstallieren der App.

• Aus Azure Boards:

  • Verbinden Sie ein oder mehrere GitHub-Repositorys mit einem Azure Boards-Projekt.
  • Hinzufügen oder Entfernen von GitHub-Repositorys aus einer GitHub-Verbindung innerhalb eines Azure Boards-Projekts.
  • Entfernen Sie eine GitHub-Verbindung für ein Projekt vollständig.
  • Zulassen, dass ein GitHub-Repository eine Verbindung mit einem oder mehreren Azure Boards-Projekten innerhalb derselben Azure DevOps-Organisation oder -Sammlung herstellt.

Die Azure Boards-GitHub-Integration unterstützt die folgenden operativen Aufgaben:

• Erstellen Sie Verknüpfungen zwischen Arbeitsaufgaben und GitHub-Commits, Pullanforderungen und Problemen basierend auf GitHub-Erwähnungen.
• Unterstützen des Zustandsübergangs von Arbeitselementen in einen erledigten oder abgeschlossenen Zustand bei Verwendung von GitHub-Erwähnungen mit „beheben“, „wird behoben“ oder „ist behoben“.
• Unterstützen Sie die vollständige Rückverfolgbarkeit, indem Sie einen Diskussionskommentar auf GitHub veröffentlichen, wenn Sie eine Verknüpfung von einer Arbeitsaufgabe mit einem GitHub-Commit, pull-Anforderung oder Problem herstellen.
• Zeigen Sie verknüpfte GitHub-Codeartefakte im Entwicklungsabschnitt des Arbeitselements an.
• Zeigen Sie verknüpfte GitHub-Artefakte als Anmerkungen auf Kanban-Boardkarten an.
• Unterstützungsstatus-Badges für Kanban-Board-Spalten, die in GitHub-Repositories unterstützt werden.

Die folgenden Aufgaben werden zurzeit nicht unterstützt:

• Abfrage von Arbeitselementen mit Links zu GitHub-Artefakten. Sie können jedoch arbeitsaufgaben mit einer Anzahl externer Verknüpfungen abfragen, die größer als 0 sind.

Weitere Informationen finden Sie unter:

• GitHub-Repositoryzugriff ändern oder die Integrationanhalten oder deinstallieren.
• GitHub-Repositoryshinzufügen oder entfernen.
• Verknüpfen von GitHub-Commits, -Pull Requests und -Issues mit Arbeitselementen in Azure Boards.