Azure Repos mit Slack

  • Artikel

Azure DevOps Services

Wenn Sie Slack verwenden, können Sie die Azure Repos-App für Slack verwenden, um Ihre Azure Repos-Repositorys problemlos 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-Versionskontrolle-Ereignisse (TFVC).

Voraussetzungen

Hinweis

  • Sie können die Azure Repos-App für Slack nur mit einem Projekt verknüpfen, das derzeit in Azure DevOps Services gehostet wird.
  • Benachrichtigungen werden derzeit nicht in Direktnachrichten 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.

    Nach dem Hinzufügen erhalten Sie etwa die folgende Willkommensnachricht.

    Screenshot der Willkommensnachricht von Slack.

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

Verbinden der Azure Repos-App mit Ihren Repositorys

  1. Verbinden und authentifizieren Sie sich mit Azure Repos mit dem Befehl /azrepos signin.

    Screenshot der Anmeldeaufforderung für Slack.

  2. Wählen Sie anmelden aus.

  3. Akzeptieren Sie die Azure Repos Slack Integration.

    Screenshot der Schaltfläche Akzeptieren im Anmeldebildschirm.

    Es wird ein Verifizierungscode angezeigt, den Sie in Ihrer Chat-App verwenden können, um die Authentifizierung abzuschließen.

  4. Kopieren Sie den Authentifizierungscode.

    Screenshot des von Azure Repos bereitgestellten Verifizierungscodes.

  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 Verifizierungscode eingefügt und dann die Schaltfläche „Senden“ ausgewählt wird.

    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 zu einer beliebigen Seite innerhalb Ihres Projekts führen (außer URLs zu Repositorys). Beispiel:

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

Sie können auch ein bestimmtes Repository überwachen, indem Sie den folgenden Befehl verwenden:

/azrepos subscribe [repository url]

Die Repository-URL kann zu einer beliebigen Seite innerhalb Ihres Repositorys führen, 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

Hinweis

Sie können nur öffentliche Repositories abonnieren.

Mit dem subscribe-Befehl können Sie mit einem Standardabonnement beginnen. 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 Befehl subscriptions:

/azrepos subscriptions

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

Hinweis

Teamadministratoren können keine von Projektadministratoren erstellten Abonnements entfernen oder ändern.

Screenshot der Ansicht der Abonnementliste.

Verwenden Sie Filter zum Anpassen von Abonnements

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

Die folgenden Schritte zeigen Ihnen, wie Sie Abonnements anpassen können.

  1. Führen Sie den Befehl /azrepos subscriptions aus.
  2. Wenn es in der Liste der Abonnements ein Abonnement gibt, das unerwünscht ist oder geändert werden muss (Beispiel: Rauschen im Kanal), wählen Sie die Schaltfläche Entfernen.
  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: Informieren Sie mich, wenn Mergeversuche aufgrund eines Richtlinienverstoßes fehlerhaft sind.

Screenshot zeigt Zusammenführungsversuch erfolglos – aufgrund von Richtlinienverletzung.

Hinweis

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

Anzeigen einer Vorschau der Pull Request-URLs

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 diese Funktion für alle Kanäle in einem Arbeitsbereich.

Entfernen von Abonnements und Repositorys aus einem Kanal

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

/azrepos unsubscribe all [project url]

Der folgende Befehl löscht beispielsweise alle Abonnements, die sich auf ein beliebiges Repository im Projekt beziehen, und entfernt die Repositories aus dem Channel. 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 Sie ein Repository oder alle Repositories in einem Projekt für Benachrichtigungen
/azrepos subscriptions 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] Entfernen aller Repositorys (die zu einem Projekt gehören) und der zugehörigen Abonnements aus einem Kanal

Benachrichtigungen in privaten Kanälen

Mit der Azure Repos-App können Sie auch die Repository-Ereignisse in Ihren privaten Kanälen überwachen. Laden Sie den Bot zu Ihrem privaten Kanal ein, indem Sie /invite @azrepos verwenden. Dann können Sie Ihre Benachrichtigungen genauso verwalten wie bei einem öffentlichen Kanal.

Problembehandlung

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

Das hat leider nicht geklappt. Wiederholen Sie den Vorgang.

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 der Einstellung „Zugriff auf Anwendungen von Drittanbietern über OAuth für die Organisation“

Die Konfiguration ist fehlgeschlagen. Vergewissern Sie sich, dass die Organisation „{organization name}“ existiert und dass Sie über ausreichende Berechtigungen verfügen.

Melden Sie sich von Azure DevOps ab, indem Sie mithilfe Ihres Browsers 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 von dem Befehl /azrepos signin aus.

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.

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

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