Azure Repos mit Slack

Azure DevOps Services

Wenn Sie Slack verwenden, können Sie die Azure Repos App für Slack verwenden, um Ihre Azure Repos Repositorys ganz einfach zu überwachen. Sie können Abonnements einrichten und verwalten, um Benachrichtigungen in Ihrem Kanal zu empfangen, wenn Code pusht/eingecheckt wird und wann immer eine Pullanforderung (PR) erstellt, aktualisiert oder eine Zusammenführung versucht wird. Diese App unterstützt sowohl Git- als auch Team Foundation-Versionskontrolle -Ereignisse (TFVC).

Notifications image

Lesen Sie diesen Artikel, um zu erfahren, wie Sie:

  • Hinzufügen der Azure Repos-App zu Ihrem Slack-Arbeitsbereich
  • Verbinden Azure Repos App zu Ihren Repositorys
  • Verwalten von Abonnements für repositorybezogene Ereignisse in Ihrem Slack-Kanal
  • Effektives Anpassen von Abonnements mithilfe von Filtern
  • Abrufen von Benachrichtigungen in privaten Slack-Kanälen

Voraussetzungen

Hinweis

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

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

  1. Navigieren Sie zur Azure Repos Slack-App, um die Azure Repos-App in Ihrem Slack-Arbeitsbereich zu installieren.

  2. Nachdem Sie hinzugefügt haben, wird eine Willkommensnachricht aus der App angezeigt, wie in der folgenden Abbildung dargestellt.

    Welcome message

  3. Verwenden Sie das /azrepos Slack-Handle, um mit der App zu interagieren. Eine vollständige Liste der Befehle wird im Abschnitt "Befehlsreferenz " dieses Artikels bereitgestellt.

Verbinden der Azure Repos-App zu Ihren Repositorys

  1. Nachdem die App in Ihrem Slack-Arbeitsbereich installiert wurde, stellen Sie eine Verbindung her, und authentifizieren Sie sich selbst/azrepos signin, um mithilfe des Befehls Azure Repos zu können.

    Sign in prompt image

  2. 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 eine beliebige Seite innerhalb Ihres Projekts (außer URLs für Repositorys) festgelegt werden.

    Beispiel:

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

    Sie können auch ein bestimmtes Repository mithilfe des folgenden Befehls überwachen:

    /azrepos subscribe [repository url]
    

    Die Repository-URL kann eine beliebige Seite innerhalb Ihres Repositorys sein, die ihren Repositorynamen enthält.

    Verwenden Sie beispielsweise für Git-Repositorys:

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

    Verwenden Sie für TFVC-Repositorys:

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

    Hinweis

    Sie können nur öffentliche Repositorys abonnieren.

  3. Der Befehl "Abonnieren" ruft Sie mit einem Standardabonnement ab. Bei Git-Repositorys wird der Kanal für das erstellte Pull-Anforderungsereignis (mit Target branch = master) und für TFVC-Repositorys abonnieren, der Kanal wird dem in Das Ereignis eingecheckten Code abonniert.

    Default subscriptions creation message

Verwalten von Abonnements

Um Abonnements für einen Kanal anzuzeigen, hinzuzufügen und zu entfernen, verwenden Sie den 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 Benachrichtigungen anpassen, die Sie erhalten, indem Sie verschiedene Filter verwenden, wie im folgenden Abschnitt beschrieben.

[! HINWEIS] Teamadministratoren können abonnements, die von Project Administratoren erstellt wurden, nicht entfernen oder ändern.

View subscriptions

Effektives Anpassen von Abonnements mithilfe von Filtern

Wenn ein Benutzer ein Repository mithilfe /azrepos subscribe des Befehls abonniert, wird ein Standardabonnement erstellt. Häufig müssen Benutzer diese Abonnements anpassen. Benutzer können beispielsweise nur benachrichtigt werden, wenn PRs über einen bestimmten Prüfer verfügen.

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ünschte oder geändert werden muss (Beispiel: Erstellen von Rauschen 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, um Ihr Abonnement anzupassen.

Beispiel: Abrufen von Benachrichtigungen nur, wenn sich mein Team in der Prüferliste für eine PR befindet

Reviewer has my team

Beispiel: Sagen Sie mir, wenn Seriendruckversuche aufgrund einer Richtlinienverletzung fehlschlagen

Merge attempt unsuccessful – due to policy violation

Hinweis

  • Alle Filter sind in der Regel Dropdowns. Wenn die Dropdownliste jedoch größer als 100 Elemente sein soll, werden Benutzer aufgefordert, die Werte manuell einzugeben.
  • Für das aktivierte TFVC-Codeereignis muss der Filter "Unter" das Format $/myproject/pathaufweisen.

Vorschau von Pullanforderungs-URLs

Wenn ein Benutzer die URL einer PR einfüge, wird eine Vorschau wie in der folgenden Abbildung angezeigt. Dies hilft, PR-bezogene Unterhaltungen kontextbezogen und präzise zu halten.

URL unfurling

Damit dieses Feature funktioniert, müssen Benutzer angemeldet sein. Sobald sie angemeldet sind, funktioniert dieses Feature für alle Kanäle in einem Arbeitsbereich.

Entfernen von Abonnements und Repositorys aus einem Kanal

  • Oft möchten Benutzer ihren Kanal bereinigen, indem Repositorys und Abonnements entfernt werden. Verwenden Sie den folgenden Befehl, um dasselbe zu erreichen.

      /azrepos unsubscribe all [project url]
    

    Beispiel:

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

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

Befehlsreferenz

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

Befehl "Schrägstrich" Funktionalität
/azrepos subscribe [repository url/project url] Abonnieren eines Repositorys oder aller Repositorys in einem Projekt zum Empfangen von Benachrichtigungen
/azrepos-Abonnements Hinzufügen oder Entfernen von Abonnements für diesen Kanal
/azrepos signin Melden Sie sich bei Ihrer Azure Repos Organisation an
/azrepos signout Abmelden von Ihrer Azure Repos Organisation
/azrepos Feedback Melden eines Problems oder Vorschlagen eines Features
/azrepos kündigen alle [Projekt-URL] Entfernen aller Repositorys (gehört zu einem Projekt) und deren zugeordneten Abonnements aus einem Kanal

Benachrichtigungen in privaten Kanälen

Die Azure Repos-App kann Ihnen auch helfen, die Repositoryereignisse in Ihren privaten Kanälen zu überwachen. Sie müssen den Bot mithilfe von ./invite @azrepos Posten Sie dies, sie können Ihre Benachrichtigungen auf die gleiche Weise einrichten und verwalten wie für einen öffentlichen Kanal.

Problembehandlung

Wenn Beim Verwenden der Azure Repos App für Slack die folgenden Fehler auftreten, folgen Sie den Verfahren in diesem Abschnitt.

Das hat leider nicht geklappt. Wiederholen Sie den Vorgang.

Die Azure Repos-App verwendet das OAuth-Authentifizierungsprotokoll und erfordert den Zugriff von Drittanbietern über OAuth für die Organisation, die aktiviert werden soll. Um diese Einstellung zu aktivieren, navigieren Sie zu Organisation Einstellungen>SecurityPolicies>, und legen Sie den Anwendungszugriff von Drittanbietern über OAuth für die Organisationseinstellung auf "On" fest.

Enable the Third-party application access via OAuth for the organization setting

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

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

Öffnen Sie ein privates oder inkognito-Browserfenster , und navigieren Sie zu https://aex.dev.azure.com/me und melden Sie sich an. Wählen Sie im Dropdownfeld unter dem Profilsymbol links das Verzeichnis aus, das die Organisation enthält, die das Repository enthält, für das Sie abonnieren möchten.

Select the directory that contains the organization that contains the project

Starten Sie in demselben Browser eine neue Registerkarte, navigieren Sie zu https://slack.com, und melden Sie sich bei Ihrem Arbeitsbereich an (Verwenden des Webclients). Führen Sie den /azrepos signout/azrepos signin Befehl gefolgt vom Befehl aus.

Wählen Sie die Sign in Schaltfläche aus, und Sie werden auf eine Zustimmungsseite wie das folgende Beispiel umgeleitet. Stellen Sie sicher, dass das verzeichnis, das neben der E-Mail angezeigt wird, gleich dem ist, was im vorherigen Schritt ausgewählt wurde. Akzeptieren und Abschließen des Anmeldevorgangs.

Consent to the requested app permissions

Wenn diese Schritte Ihr Authentifizierungsproblem nicht beheben, wenden Sie sich an uns an Entwicklercommunity.