Integrieren von Azure-Pipelines in Microsoft Teams

Azure DevOps Services

In diesem Artikel erfahren Sie, wie Sie die Azure Pipelines-App für Microsoft Teams verwenden, um Pipelineereignisse zu überwachen. Sie können Benachrichtigungen in Ihrem Teams-Kanal für Pipelinebuilds, -Versionen und -Genehmigungen einrichten und erhalten. Genehmigende Personen können versionen auch innerhalb des Teams-Kanals genehmigen.

Voraussetzungen

• Zugriff auf ein Team in Microsoft Teams, in dem Sie eine App hinzufügen können.
• Projektadministrator- oder Buildadministratorberechtigungen in einem Azure DevOps-Projekt. Weitere Informationen finden Sie unter Erstellen einer Projekt - und Pipelinesicherheitsressourcen.
• Zugriff auf Drittanbieteranwendungen über OAuth , der in den Azure DevOps-Organisationseinstellungen aktiviert ist.

Einrichten der Azure Pipelines-App

1. Wählen Sie in Microsoft Teams Apps aus, suchen Sie nach Azure-Pipelines, und wählen Sie dann Azure-Pipelines aus.

   

2. Wählen Sie den Dropdownpfeil neben " Hinzufügen" und dann "Zu einem Team hinzufügen" aus.

   

3. Wählen Sie ihren Teamnamen aus, oder geben Sie sie ein, und wählen Sie dann Bot einrichten aus.

   

Verwenden von Azure Pipelines-App-Befehlen

Die Azure Pipelines Teams-App unterstützt die folgenden Befehle:

Anmelden bei Azure Pipelines

1. Geben Sie im Bereich Teams-Unterhaltung die Zeichenfolge ein @azurePipelines signin.
2. Wählen Sie Anmelden und Authentifizierung bei Azure Pipelines abschließen aus.

Abonnieren von Pipelines

Verwenden Sie die folgenden Befehle, um alle Pipelines in einem Projekt oder nur bestimmte Pipelines zu abonnieren und zu überwachen.

• Alle Pipelines in einem Projekt: Die URL kann sich auf Ihr Projekt oder eine beliebige Seite in Ihrem Projekt, mit Ausnahme einer Pipeline, befinden. Zum Beispiel:

  @azure pipelines subscribe https://dev.azure.com/myorg/myproject/
  

• Eine bestimmte Pipeline: Die Pipeline-URL kann eine beliebige Seite in einer Pipeline sein, die über eine definitionId oder buildId/releaseId in der URL verfügt. Zum Beispiel:

  @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_build?definitionId=123
  

Erweitern verknüpfter Benachrichtigungen

Alle Antworten für einen bestimmten Beitrag werden miteinander verknüpft.

Um den Thread zu erweitern, wählen Sie den komprimierten Threadlink aus.

Verwalten von Abonnements

Wenn Sie eine Pipeline abonnieren, werden standardmäßig einige Abonnements erstellt, ohne dass Filter angewendet werden. Zu diesen Abonnements gehören " Run state changed " und "Run stage waiting for approval for YAML pipelines" und release deployment approval pending for Classic releases. Sie können diese Abonnements entfernen oder weitere Abonnements hinzufügen.

Die Azure Pipelines-App unterstützt auch Filter, um anzupassen, was in Ihrem Kanal angezeigt wird. Beispielsweise können Sie nur benachrichtigt werden, wenn Builds fehlschlagen oder Bereitstellungen per Push in eine Produktionsumgebung übertragen werden.

Führen Sie die folgenden Schritte aus, um Ihre Abonnements zu verwalten.

1. Führen Sie den @azure pipelines subscriptions Befehl aus, um alle Pipelinesabonnements auflisten zu können.

   

2. Um ein Abonnement zu entfernen, wählen Sie " Alle Abonnements anzeigen" aus. Wählen Sie "Entfernen" unter einem beliebigen Abonnement aus, das Sie nicht möchten, und wählen Sie dann "OK" aus.

3. Um ein Abonnement hinzuzufügen, wählen Sie "Abonnement hinzufügen" aus.

4. Wählen Sie das Ereignis und die Pipeline aus, die Sie abonnieren möchten, und wählen Sie "Weiter" aus.

5. Wählen Sie alle gewünschten Phasen- und Umgebungsfilter aus, wählen Sie "Absenden" und dann "OK" aus.

   Das folgende Abonnement stellt beispielsweise Benachrichtigungen für die _default Phase nur bereit, wenn der Status "Abgeschlossen" fehlgeschlagen ist.

   

Anzeigen von Genehmigungsbenachrichtigungen

Um Genehmigungsbenachrichtigungen anzuzeigen, stellen Sie sicher, dass Sie die Ausführungsphase abonnieren, die auf genehmigungsbenachrichtigungen für YAML-Pipelines oder die Benachrichtigung zur Freigabegenehmigung für klassische Versionen wartet . Diese Abonnements werden standardmäßig erstellt, wenn Sie die Pipeline abonnieren.

Wenn Sie die Benachrichtigung über die Genehmigung der Ausführungsphase abonnieren, können Sie auch sehen, wann die Phase genehmigt wurde.

Genehmigen von Ihrem Kanal

Wenn Sie genehmigende Personen sind, können Sie Bereitstellungen innerhalb Ihres Teams-Kanals genehmigen. Die Azure Pipelines-App unterstützt alle Azure Pipelines-Überprüfungen und Genehmigungsszenarien. Sie können Anforderungen als Einzelperson oder für ein Team genehmigen.

Wenn die Ausführung einer Phase aussteht, veröffentlicht die App eine Benachrichtigungskarte mit Optionen zum Genehmigen oder Ablehnen der Anforderung im Kanal. Sie können die Details der Anforderung in der Benachrichtigung überprüfen und entsprechende Maßnahmen ergreifen.

Die Antwort wird an die App gesendet.

Wenn Sie Benachrichtigungen zur Genehmigung der Ausführungsphase abonniert haben, können Sie auch sehen, wann die Phase genehmigt wurde.

Kündigen eines Kanals

Führen Sie den unsubscribe Befehl aus, um alle Abonnements zu löschen, die mit einer beliebigen Pipeline im Projekt zusammenhängen, und entfernen Sie die Pipelines aus dem Kanal. Zum Beispiel:

@azure pipelines unsubscribe all https://dev.azure.com/myorg/myproject

Um das Projekt und alle Abonnements aus dem Kanal zu löschen, wählen Sie "Fortfahren" aus.

Verwenden der Erstellerweiterung

Damit Sie Informationen zu Pipelines suchen und freigeben können, unterstützt die Azure Pipelines-App für Teams eine Erweiterung zum Verfassen in Nachrichten. Mithilfe der Erweiterung können Sie nach Pipelines in einem Projekt anhand der Pipeline-ID oder des Pipelinenamens suchen.

Um die Erweiterung zu verwenden, müssen Sie beim Azure Pipelines-Projekt im Teams-Kanal angemeldet sein. Wählen Sie das + Symbol im Nachrichtenfeld aus, wählen Sie Azure-Pipelines aus, und suchen Sie dann nach Ihrer Pipeline oder Freigabe.

Vorschau der Pipeline-URLs

Wenn Sie die Erstellerweiterung verwenden, um einer Teams-Nachricht eine Pipeline-URL hinzuzufügen, wird eine Vorschau ähnlich wie in den folgenden Bildern angezeigt. Die Vorschau hilft dabei, pipelinebezogene Unterhaltungen relevant und auf dem neuesten Stand zu halten.

Das folgende Beispiel zeigt eine Vorschau der Release-URL:

Verbinden mehrerer Mandanten

Wenn Sie andere E-Mail-Adressen oder Mandanten für Microsoft Teams und Azure DevOps verwenden, befolgen Sie diese Schritte, um sich anzumelden und eine Verbindung entsprechend Ihren Einstellungen herzustellen.

Behandeln von Authentifizierungsproblemen

- Starten Sie im selben Browser eine neue Registerkarte, und wechseln Sie zu https://teams.microsoft.com/. Führen Sie den @Azure Pipelines signout Befehl aus, und führen Sie dann den @Azure Pipelines signin Befehl in dem Kanal aus, in dem die Azure Pipelines-App für Microsoft Teams installiert ist.

Wählen Sie die Schaltfläche "Anmelden " aus, und schließen Sie den Anmeldevorgang ab. Stellen Sie sicher, dass das angezeigte Verzeichnis mit dem im vorherigen Schritt ausgewählten Verzeichnis übereinstimmt.

Wenn ihr Authentifizierungsproblem mit diesen Schritten nicht behoben werden kann, wenden Sie sich an die Entwicklercommunity.

Verwandte Artikel

• Azure Boards mit Microsoft Teams verwenden
• Azure Repos mit Microsoft Teams verwenden