Freigeben über

Azure Repos mit Slack

  • Artikel

Azure DevOps Services

Wenn Sie Slackverwenden, können Sie die Azure Repos-App für Slack verwenden, um Ihre Azure Repos-Repositories einfach zu überwachen. Richten Sie Abonnements ein und verwalten Sie diese, um Benachrichtigungen in Ihrem Kanal zu erhalten, wenn Code gepusht oder eingecheckt wird und wenn eine Pull-Anfrage (PR) erstellt, aktualisiert oder zusammengeführt wird. Diese App unterstützt sowohl Git- als auch Team Foundation Version Control (TFVC)-Ereignisse.

Voraussetzungen

Anmerkung

  • Sie können die Azure Repos-App nur für Slack mit einem Projekt verknüpfen, das derzeit in Azure DevOps Services gehostet wird.
  • Benachrichtigungen werden derzeit in direkten Nachrichten nicht unterstützt.

Hinzufügen der Azure Repos-App zu Ihrem Slack-Arbeitsbereich

  1. Gehen Sie zur Azure Repos Slack-App und wählen Sie Zu Slack hinzufügen.

    Screenshot des Slack-App-Verzeichnisses, Azure Repos und der Schaltfläche Zu Slack hinzufügen.

    Sobald Sie etwas hinzugefügt haben, erhalten Sie eine Willkommensnachricht wie die folgende.

    Screenshot der Willkommensnachricht von Slack.

  2. Verwenden Sie das /azrepos Slack-Handle, um mit der App zu interagieren. Eine vollständige Liste der Befehle finden Sie im Abschnitt Befehlsreferenz in diesem Artikel.

Verbinden Sie die Azure Repos-App mit Ihren Repositories

  1. Stellen Sie eine Verbindung mit Azure Repos her, und authentifizieren Sie sich mit /azrepos signin Befehl.

    Screenshot der Anmeldeaufforderung für Slack.

  2. Wählen Sie anmelden aus.

  3. Akzeptieren Sie die Azure Repos Slack Integration.

    Screenshot der Schaltfläche

    Ein Überprüfungscode wird zur Verwendung in Ihrer Chat-App angezeigt, um die Authentifizierung abzuschließen.

  4. Kopieren Sie den Authentifizierungscode.

    Screenshot des Überprüfungscodes, der von Azure Repos bereitgestellt wird.

  5. Wählen Sie Code eingeben, fügen Sie den Code ein und wählen Sie dann Senden.

    Screenshot des endgültigen Authentifizierungsbildschirms, wenn der Überprüfungscode eingefügt und die Schaltfläche

    Die Bestätigung der Anmeldung wird im Chat angezeigt.

    Screenshot der Anmeldebestätigung im Chat.

Um die Überwachung aller Git Repositorys in einem Projekt zu starten, verwenden Sie den folgenden Schrägstrichbefehl in einem Kanal:

/azrepos subscribe [project url]

Die Projekt-URL kann auf jede beliebige Seite innerhalb Ihres Projekts verweisen, außer auf URLs von Repositorys. Zum Beispiel:

/azrepos subscribe https://dev.azure.com/myorg/myproject/

Sie können ein bestimmtes Repository auch mit dem folgenden Befehl überwachen:

/azrepos subscribe [repository url]

Die Repository-URL kann auf jede Seite innerhalb Ihres Repositorys verweisen, die den Namen Ihres Repositorys enthält. Verwenden Sie z. B. für Git-Repositorys Folgendes:

/azrepos subscribe https://dev.azure.com/myorg/myproject/_git/myrepository

Für TFVC-Repositorys verwenden Sie Folgendes:

/azrepos subscribe https://dev.azure.com/myorg/myproject/_versionControl

Anmerkung

Sie können nur öffentliche Repositories abonnieren.

Der Befehl "Abonnieren" ermöglicht den Start mit einem Standardabonnement. Für Git-Repositories wird der Kanal auf das Ereignis Pull request created (mit target branch = main) abonniert, und für TFVC-Repositories wird der Kanal auf das Ereignis Code checked in abonniert.

Der Screenshot zeigt die Standardmeldung zur Erstellung von Abonnements.

Verwalten von Abonnements

Um Abonnements für einen Kanal anzuzeigen, hinzuzufügen oder zu entfernen, verwenden Sie den folgenden subscriptions Befehl:

/azrepos subscriptions

Dieser Befehl listet alle aktuellen Abonnements für den Kanal auf und ermöglicht es Ihnen, neue Abonnements hinzuzufügen oder vorhandene zu entfernen. Beim Hinzufügen von Abonnements können Sie die erhaltenen Benachrichtigungen mithilfe verschiedener Filter anpassen, wie im folgenden Abschnitt beschrieben.

Anmerkung

Teamadministratoren können abonnements, die von Project-Administratoren erstellt wurden, nicht entfernen oder ändern.

Screenshot der Ansicht der Abonnementliste.

Verwenden von Filtern zum Anpassen von Abonnements

Wenn ein Benutzer ein Repository mit dem Befehl /azrepos subscribe abonniert, wird ein Standardabonnement erstellt. Häufig müssen Benutzer diese Abonnements anpassen. Zum Beispiel könnten Benutzer nur benachrichtigt werden wollen, wenn PRs einen bestimmten Gutachter haben.

Die folgenden Schritte veranschaulichen, wie Abonnements angepasst werden.

  1. Führen Sie den Befehl /azrepos subscriptions aus.
  2. Wenn in der Liste der Abonnements ein Abonnement vorhanden ist, das unerwünscht ist oder geändert werden muss (Beispiel: Verursachen von Störungen im Kanal), wählen Sie die Schaltfläche Entfernen aus.
  3. Wählen Sie die Schaltfläche Abonnement hinzufügen aus.
  4. Wählen Sie das erforderliche Repository und das gewünschte Ereignis aus.
  5. Wählen Sie die entsprechenden Filter aus.

Beispiel: Nur Benachrichtigungen erhalten, wenn sich mein Team in der Reviewerliste für einen PR befindet.

Der Screenshot zeigt, dass Reviewer mein Team hat.

Beispiel: Sagen Sie mir, wenn Zusammenführungsversuche aufgrund eines Richtlinienverstoßes fehlschlagen

Screenshot zeigt, dass der Zusammenführungsversuch fehlgeschlagen ist – aufgrund von Richtlinienverstößen.

Anmerkung

  • Bei allen Filtern handelt es sich in der Regel um Dropdownlisten. Wenn die Dropdownliste jedoch mehr als 100 Elemente enthält, müssen Benutzer die Werte manuell eingeben.
  • Für das TFVC-Ereignis Code eingecheckt muss der Filter Unter Pfad das Format $/myproject/path aufweisen.

Pull-Request-URLs in der Vorschau anzeigen

Wenn ein Nutzer die URL einer PR einfügt, wird eine Vorschau wie das folgende Bild angezeigt, was dazu beiträgt, dass PR-bezogene Konversationen kontextbezogen und korrekt bleiben.

Der Screenshot zeigt die Entfaltung der URL.

Sobald sich Benutzer anmelden, funktioniert dieses Feature für alle Kanäle in einem Arbeitsbereich.

Entfernen Sie Abonnements und Repositorys aus einem Kanal

Verwenden Sie den folgenden Befehl, um Ihren Kanal zu bereinigen, indem Sie Repositorys und Abonnements entfernen.

/azrepos unsubscribe all [project url]

Mit dem folgenden Befehl werden beispielsweise alle Abonnements gelöscht, die sich auf ein beliebiges Repository im Projekt beziehen, und die Repositorys werden aus dem Kanal entfernt. Nur Projektadministratoren können diesen Befehl ausführen.

/azrepos unsubscribe all https://dev.azure.com/myorg/myproject

Befehlsreferenz

In der folgenden Tabelle sind alle /azrepos commands aufgeführt, die Sie in Ihrem Slack-Kanal verwenden können.

Slash-Befehl Funktionalität
/azrepos subscribe [Repository-URL/Projekt-URL] Abonnieren eines Repositorys oder aller Repositorys in einem Projekt für Benachrichtigungen
/azrepos-Abonnements Hinzufügen oder Entfernen von Abonnements für diesen Kanal
/azrepos signin Anmelden bei Ihrer Azure Repos-Organisation
/azrepos signout Abmelden von Ihrer Azure Repos-Organisation
/azrepos feedback Melden eines Problems oder Vorschlagen eines Features
/azrepos unsubscribe all [Projekt-URL] Löschen Sie alle Repositorys, die zu einem Projekt gehören, und deren zugehörige Abonnements aus einem Kanal.

Benachrichtigungen in privaten Kanälen

Die Azure Repos-App kann Ihnen helfen, die Repositoryereignisse auch in Ihren privaten Kanälen zu überwachen. Laden Sie den Bot zu Ihrem privaten Kanal ein, indem Sie /invite @azrepos verwenden. Anschließend können Sie Ihre Benachrichtigungen auf die gleiche Weise wie für einen öffentlichen Kanal verwalten.

Problembehandlung

Wenn bei der Verwendung der Azure Repos App für Slack die folgenden Fehler auftreten, befolgen Sie die Anweisungen in diesem Abschnitt.

Leider ist ein Fehler aufgetreten. Versuchen Sie es bitte erneut.

Die Azure Repos-App verwendet das OAuth-Authentifizierungsprotokoll und erfordert die Aktivierung von Zugriff auf Anwendungen von Drittanbietern über OAuth für die Organisation. Um diese Einstellung zu aktivieren, navigieren Sie zu Organisationseinstellungen>Sicherheit>Richtlinien, und legen Sie die Einstellung Zugriff auf Anwendungen von Drittanbietern über OAuth für die Organisation auf Ein fest.

Aktivieren Sie den Zugriff von Drittanbieter-Anwendungen über OAuth für die Organisationseinstellungen

Fehler bei der Konfiguration. Stellen Sie sicher, dass die Organisation "{Organisationsname}" vorhanden ist und über ausreichende Berechtigungen verfügt.

Melden Sie sich bei Azure DevOps ab, indem Sie mit Ihrem Browser zu https://aka.ms/VsSignout navigieren.

Öffnen Sie ein Browserfenster vom Typ InPrivate oder Inkognito, und navigieren Sie zu https://aex.dev.azure.com/me, um sich anzumelden. Wählen Sie in der Dropdownliste unter dem Profilsymbol auf der linken Seite das Verzeichnis aus, das die Organisation enthält, in der sich das Repository befindet, das Sie abonnieren möchten.

Auswählen des Verzeichnisses, das die Organisation enthält, die wiederum das Projekt enthält

Starten Sie im gleichen Browser eine neue Registerkarte, navigieren Sie zu https://slack.com, und melden Sie sich an Ihrem Arbeitsplatz an (Webclient verwenden). Führen Sie den befehl /azrepos signout gefolgt vom Befehl /azrepos signin aus.

Wählen Sie die Schaltfläche Sign in aus, und Sie werden wie im folgenden Beispiel zu einer Zustimmungsseite weitergeleitet. Stellen Sie sicher, dass das neben der E-Mail angezeigte Verzeichnis mit dem im vorherigen Schritt ausgewählten Verzeichnis übereinstimmt. Akzeptieren Sie und schließen Sie den Anmeldevorgang ab.

Der Screenshot zeigt die Zustimmung zu den angeforderten App-Berechtigungen.

Wenn Diese Schritte Ihr Authentifizierungsproblem nicht beheben, wenden Sie sich bei Developer Communityan uns.