Azure Boards mit Microsoft Teams verwenden

Azure DevOps Services

Mit der Azure Pipelines-App für Microsoft Teams können Sie Ereignisse für Ihre Pipelines überwachen. Sie können in Ihrem Teams-Kanal Benachrichtigungen für Releases, ausstehende Genehmigungen, abgeschlossene Builds usw. einrichten und erhalten. Sie können Releases auch in Ihrem Teams-Kanal genehmigen.

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 Feature Timeline.

Voraussetzungen

  • Ein Azure DevOps-Projekt ist obligatorisch Weitere Informationen finden Sie unter Erstellen eines Projekts.
  • Zum Einrichten von Pipelineabonnements müssen Sie Projektadministrator sein.

Einrichten der Azure Pipelines-App

  1. Navigieren Sie in Microsoft Teams zum Apps Store, 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 Öffnen 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 sie ein, und wählen Sie dann Bot einrichten aus.

    Auswählen der Schaltfläche

  4. Geben Sie im Bereich Teams-Unterhaltung die Zeichenfolge ein @azurePipelines signin.

  5. Wählen Sie Anmelden und Authentifizierung bei Azure Pipelines abschließen aus.

Verwenden von Befehlen

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

  • Überwachen sie alle Pipelines in einem Projekt. Die URL kann zu einer beliebigen Seite innerhalb Ihres Projekts führen, mit Ausnahme von URLs für Pipelines. Beispiel: @azure pipelines subscribe https://dev.azure.com/myorg/myproject/.

    @azure pipelines subscribe [project url]
    
  • Überwachen einer bestimmten Pipeline: Die Pipeline-URL kann sich auf eine beliebige Seite in Ihrer Pipeline mit oder definitionIdbuildId/releaseId in der URL befinden. Beispiel: @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_build?definitionId=123.

    @azure pipelines subscribe [pipeline url]
    

    Ein weiteres Beispiel für eine Releasepipeline, für die die Releasebereitstellung gestartet, die Releasebereitstellung abgeschlossen und Benachrichtigungen zur Genehmigung der Releasebereitstellung ausstehend sind, ist @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_release?definitionId=123&view=mine&_a=releases.

Hinweis

  • Wir unterstützen keine Bereitstellungsgenehmigungen, die vor dem Abschließen der Genehmigungsrichtlinie die Identität "Revalidate" des genehmigenden Benutzers angewendet haben.
  • Aktivieren Sie „Anwendungszugriff von Drittanbietern über OAuth“, um Benachrichtigungen für die organization in Azure DevOps zu erhalten.

Verwalten von Abonnements

Wenn Sie eine Pipeline abonnieren, werden standardmäßig einige Abonnements erstellt, ohne dass Filter angewendet werden. Möglicherweise möchten Sie diese Abonnements anpassen. Beispielsweise können Sie nur benachrichtigt werden, wenn Builds fehlschlagen oder Bereitstellungen per Push in eine Produktionsumgebung übertragen werden. Die Azure Pipelines-App unterstützt Filter, um die in Ihrem Kanal angezeigten Elemente anzupassen. Führen Sie die folgenden Schritte aus, um Ihre Abonnements zu verwalten.

  1. Führen Sie den Befehl @azure pipelines subscriptions aus.

  2. Wählen Sie Alle Abonnements anzeigen. Wenn Sie in der Liste der Abonnements ein Abonnement nicht benötigen, wählen Sie Entfernen aus. Ruft die Liste der Abonnements ab.

  3. Scrollen Sie nach unten, und wählen Sie Abonnement hinzufügen aus.

  4. Wählen Sie die erforderliche Pipeline und das erforderliche Ereignis aus.

  5. Wählen Sie die entsprechenden Filter und dann Speichern aus.

    Beispiel 1: Rufen Sie Benachrichtigungen für fehlerhafte Builds ab.

    Visuelle Fehler bei Buildfehlern in Teams.

    Beispiel 2: Erhalten Sie nur Benachrichtigungen, wenn die Bereitstellungen per Push in die Produktionsumgebung übertragen werden.

    Anzeige von Umschaltfläche für Fehlerbenachrichtigung.

    Hinweis

    • Teamadministratoren können keine Abonnements entfernen oder ändern, die von Projektadministratoren erstellt wurden.
    • Benachrichtigungen werden in Chat-/Direktnachrichten nicht unterstützt.

Genehmigen von Bereitstellungen über Ihren Kanal

Sie können Bereitstellungen in Ihrem Kanal genehmigen, ohne zum Azure Pipelines-Portal zu wechseln. Abonnieren Sie die Benachrichtigung Releasebereitstellungsgenehmigung ausstehend für klassische Releases oder die Ausführungsphase, die auf Genehmigungsbenachrichtigung für YAML-Pipelines wartet. Beide Abonnements werden standardmäßig erstellt, wenn Sie die Pipeline abonnieren.

In Teams können Sie die Genehmigung vorbereiten.

Wenn die Ausführung einer Phase zur Genehmigung aussteht, wird eine Benachrichtigung Karte mit Optionen zum Genehmigen oder Ablehnen der Anforderung im Kanal veröffentlicht. Genehmigende Personen können die Details der Anforderung in der Benachrichtigung überprüfen und entsprechende Maßnahmen ergreifen. Im folgenden Beispiel wurde die Bereitstellung genehmigt, und der Genehmigungsstatus wird auf der Karte angezeigt.

Karte mit genehmigter Bereitstellung.

Die Azure Pipelines-App unterstützt alle Überprüfungen und Genehmigungsszenarien, die im Azure Pipelines-Portal vorhanden sind. Sie können Anforderungen als Einzelperson oder für ein Team genehmigen.

Suchen und Freigeben von Pipelineinformationen mithilfe der Compose-Erweiterung

Damit Benutzer Informationen zu Pipelines suchen und freigeben können, unterstützt die Azure Pipelines-App für Microsoft Teams die Erstellungserweiterung. Sie können jetzt nach Pipelines nach Pipelines-ID oder nach Pipelinename suchen. Damit die Compose-Erweiterung funktioniert, müssen sich Benutzer beim Azure Pipelines-Projekt anmelden, an dem sie interessiert sind, indem sie entweder den Befehl ausführen @azure pipelines signin oder sich direkt bei der Compose-Erweiterung anmelden.

Erweiterung erstellen.

Vorschau von Pipeline-URLs

Wenn Sie Teams eine Pipeline-URL hinzufügen, wird eine Vorschau ähnlich den folgenden Bildern angezeigt. Die Vorschau hilft dabei, pipelinebezogene Unterhaltungen relevant und auf dem neuesten Stand zu halten. Sie können zwischen kompakten und erweiterten Karten wählen.

Beispiel 1: Vorschau der Build-URL

URL erstellen, die entrollt wird.

Beispiel 2: Vorschau der Release-URL

URL veröffentlichen, die entrollt wird.

Sobald Sie angemeldet sind, funktioniert dieses Feature für alle Kanäle in einem Team in Microsoft Teams.

Kündigen eines Pipelinekanals

Verwenden Sie den folgenden Befehl, um alle Pipelines innerhalb eines Projekts abzubestellen.

@azure pipelines unsubscribe all [project url]

Beispiel: Alle mit DER URL kündigen

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

Dieser Befehl löscht alle Abonnements, die sich auf eine Pipeline im Projekt beziehen, und entfernt die Pipelines aus dem Kanal.

Wichtig

Nur Projektadministratoren können diesen Befehl ausführen.

Alle Benachrichtigungen, die mit einer bestimmten Ausführung einer Pipeline verknüpft sind, werden miteinander verknüpft.

Beispiel 1: Kompakte Ansicht von verknüpften Benachrichtigungen.

Kompakter Thread

Beispiel 2: Erweiterte Ansicht der verknüpften Benachrichtigungen.

Erweiterter Thread

Verwenden von Befehlen in der Azure Pipelines-App

Sehen Sie sich die folgenden Befehle an, die von der Azure Pipelines-App unterstützt werden:

Slash-Befehl Funktionalität
@azure Pipelines abonnieren [Pipeline-URL/Projekt-URL] Abonnieren einer Pipeline oder aller Pipelines in einem Projekt zum Empfangen von Benachrichtigungen
@azure Pipelines-Abonnements Mit folgendem Befehl fügen Sie Abonnements für diesen Kanal hinzu oder entfernen Abonnements
@azure Feedback zu Pipelines Ein Problem melden oder ein Feature vorschlagen
@azure Hilfe zu Pipelines Hilfe zu den Schrägstrichbefehlen erhalten
@azure Pipelines-Anmeldung Melden Sie sich bei Ihrem Azure Pipelines-Konto an.
@azure Pipelines-Abmelden Vom Azure Pipelines-Konto abmelden
@azure Pipelines kündigen alle [Projekt-URL] Entfernen aller Pipelines (die zu einem Projekt gehören) und der zugehörigen Abonnements aus einem Kanal

Verbinden mehrerer Mandanten

Wenn Sie eine andere E-Mail oder einen anderen Mandanten für Microsoft Teams und Azure DevOps verwenden, führen Sie die folgenden Schritte aus, um sich basierend auf Ihrem Anwendungsfall anzumelden und eine Verbindung herzustellen.

Anwendungsfall Email-ID und Mandant in Microsoft Teams Email-ID und Mandant in Azure DevOps Anmeldeaktion
1 email1@abc.com (Mandant 1) email1@abc.com (Mandant 1) Wählen Sie Anmelden aus
2 email1@abc.com (Mandant 1) email2@pqr.com (Mandant 2) - Bei Azure DevOps anmelden
- Starten Sie im selben Browser eine neue Registerkarte, und wechseln Sie zu https://teams.microsoft.com/.
- Führen Sie den sign in Befehl aus, und wählen Sie Anmelden aus.
3 email1@abc.com (Mandant 1) email2@pqr.com (Mandant 2) - Wählen Sie Mit anderer E-Mail-Adresse anmelden aus.
- Verwenden Sie in der E-Mail-ID-Auswahl die E-Mail2,um sich anzumelden.
4 email1@abc.com (Mandant 1) email2@pqr.com (Standardmandant 3) Wird derzeit nicht unterstützt.

Problembehandlung

- 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 Sign in Schaltfläche aus, und Sie werden zu einer Zustimmungsseite wie im folgenden Beispiel weitergeleitet. Stellen Sie sicher, dass das neben der E-Mail angezeigte Verzeichnis mit dem verzeichnis identisch ist, das Sie im vorherigen Schritt ausgewählt haben. Akzeptieren und den Anmeldevorgang abschließen.

Zustimmung zu den angeforderten App-Berechtigungen

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