Teilen über

Integrieren von Azure-Pipelines in Microsoft Teams

  • Artikel

Azure DevOps Services

Hinweis

Dieses Feature ist nur auf Azure DevOps Services verfügbar. In der Regel werden zuerst neue Features im Clouddienst eingeführt und dann lokal in der nächsten Hauptversion oder dem nächsten Update von Azure DevOps Server verfügbar gemacht. Weitere Informationen finden Sie unter Azure DevOps-Featurezeitachse.

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.

Hinweis

Azure-Pipelines-Benachrichtigungen werden in Teams-Chats oder direktnachrichten nicht unterstützt.

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 Anwendungen von Drittanbietern über OAuth , aktiviert in den Azure DevOps-Organisationseinstellungen.

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.

    Screenshot zum Auswählen der Schaltfläche

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

    Screenshot zum Auswählen der Schaltfläche

  3. Wählen Sie Ihren Teamnamen aus, oder geben Sie ihn ein, und wählen Sie dann "Bot einrichten" aus.

    Screenshot der Auswahl der Schaltfläche

Verwenden von Azure Pipelines-App-Befehlen

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

Slash-Befehl Funktionalität
@azure Pipelines-Anmeldung Melden Sie sich bei Ihrem Azure Pipelines-Konto an.
@azure Pipelines-Abmelden Melden Sie sich bei Ihrem Azure Pipelines-Konto ab.
@azure Pipelines abonnieren <Pipeline-URL | Projekt-URL> Abonnieren Sie eine Pipeline oder alle Pipelines in einem Projekt, um Benachrichtigungen zu empfangen.
@azure Pipelines-Abonnements Anzeigen, Hinzufügen oder Entfernen von Abonnements für diesen Kanal.
@azure Pipelines kündigen alle <Projekt-URL ab> Entfernen Sie alle Pipelines, die zu einem Projekt gehören, und deren zugehörigen Abonnements aus einem Kanal.
@azure Hilfe zu Pipelines Erhalten Sie Hilfe zu den Befehlen.
@azure Feedback zu Pipelines Melden Sie ein Problem, oder schlagen Sie ein Feature vor.

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.

Screenshot der kompakten Threadansicht.

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

Screenshot der erweiterten Threadansicht.

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.

    Screenshot der Ansicht der Liste der Abonnements.

  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.

    Screenshot mit Filtern für Benachrichtigungen.

Hinweis

Teamadministratoren können keine Abonnements entfernen oder ändern, die von Projektadministratoren erstellt wurden.

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.

Karte mit genehmigter Bereitstellung.

Hinweis

Sie können keine Bereitstellungsgenehmigungen abonnieren, die über die Revalidate-Identität der genehmigenden Person verfügen, bevor Sie die angewendete Genehmigungsrichtlinie abschließen.

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.

Screenshot mit bereiter Genehmigungsbenachrichtigung.

Die Antwort wird an die App gesendet.

Screenshot mit ausstehender Genehmigungsbenachrichtigung.

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

Screenshot mit ausstehender Nachricht zum Kündigen des Abonnements.

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

Wichtig

Nur Projektadministratoren können diesen Befehl ausführen.

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.

Screenshot: Compose-Erweiterung

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.

Screenshot der Entfurmung der Build-URL.

Das folgende Beispiel zeigt eine Vorschau der Release-URL:

Screenshot der Entfurmung der Release-URL.

Verbinden mehrerer Mandanten

Wenn Sie unterschiedliche E-Mails oder Mandanten für Microsoft Teams und Azure DevOps verwenden, führen Sie die folgenden Schritte aus, um sich basierend auf Ihren Einstellungen anzumelden und eine Verbindung herzustellen.

Microsoft Teams Azure DevOps Anmeldeaktion
email1@abc.com (Mandant1) email1@abc.com (Mandant1) Wählen Sie Anmelden aus
email1@abc.com (Mandant1) email2@pqr.com (Mandant2) 1. Melden Sie sich bei Azure DevOps an.
2. Starten Sie im selben Browser eine neue Registerkarte, und wechseln Sie zu https://teams.microsoft.com/.
3. Führen Sie den sign in Befehl aus, und wählen Sie "Anmelden" aus.
email1@abc.com (Mandant1) email2@pqr.com (Mandant2) 1. Wählen Sie " Anmelden" mit einer anderen E-Mail-Adresse aus.
2. Verwenden Sie in der E-Mail-ID-Auswahl die E-Mail2, um sich anzumelden.
email1@abc.com (Mandant1) email2@pqr.com (nicht standardmäßiger Mandant3) Nicht unterstützt.

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 diese Schritte Ihr Authentifizierungsproblem nicht beheben, wenden Sie sich an die Entwicklercommunity.