Skip to main content

Anpassen von Benachrichtigungen für GitHub in Slack

Erfahren Sie, wie Sie Benachrichtigungen für GitHub in Slack anpassen.

Sie können Ihre Benachrichtigungen anpassen, indem Sie Aktivitäten abonnieren, die für Ihren Slack-Kanal relevant sind, und das Abmelden von Aktivitäten, die für Ihr Projekt weniger hilfreich sind.

Standardmäßig aktivierte Benachrichtigungen

Die folgenden Benachrichtigungen sind standardmäßig aktiviert, sie können jedoch mit dem /github unsubscribe owner/repo [event] Befehl deaktiviert werden.

EventDescription
issuesGeöffnete, geschlossene oder wiedereröffnete Vorgänge.
pullsNeue oder zusammengeführte Pull Requests und Entwurfs-Pull-Requests, die als bereit zur Überprüfung markiert wurden.
commitsNeue Commits im Standardbranch.
releasesVeröffentlichte Versionen.
deploymentsAktualisierungen am Bereitstellungsstatus

Standardmäßig deaktivierte Benachrichtigungen

Die folgenden Benachrichtigungen sind standardmäßig deaktiviert, sie können jedoch mit dem /github subscribe owner/repo [event] Befehl aktiviert werden.

EventDescription
reviewsÜberprüfungen von Pull-Anfragen.
workflowsAktionen-Workflow läuft.
branchesErstellte oder gelöschte Branches.
commentsNeue Kommentare bei Issues und Pull Requests.
commitsAlle Commits in jedem Branch.
discussionsErstellte oder beantwortete Diskussionen.
+label:"your label"Probleme, Pull-Requests und Kommentare auf Basis ihrer Labels.

Sie können mehrere Einstellungen gleichzeitig abonnieren oder kündigen. Beispiel:

  • Um die Aktivität für Pull-Anforderungsüberprüfungen und Kommentare zu aktivieren, verwenden Sie /github subscribe owner/repo reviews comments.
  • Verwenden Sie /github unsubscribe owner/repo issues pulls, um die Aktivität für Issues und Pull-Anfragen zu deaktivieren.

Filtern von Benachrichtigungen

Sie können Ihre Benachrichtigungen mit Branch- und Bezeichnungsfiltern weiter anpassen. Mithilfe von Verzweigungsfiltern können Sie Commit-Benachrichtigungen basierend auf Verzweigungsnamen filtern, während Labelfilter es Ihnen ermöglichen, Problem- und Pull-Request-Benachrichtigungen basierend auf Labels zu filtern, die auf sie angewendet werden.

Verzweigungsfilter für Commit-Benachrichtigungen

Mit Branch-Filtern können Sie Commit-Benachrichtigungen nach Branch-Namen filtern. Wenn Sie das commits-Ereignis abonnieren, erhalten Sie standardmäßig Benachrichtigungen für Ihren Standard-Branch. Sie können jedoch auswählen, ob sie nach einer bestimmten Verzweigung oder einem Muster von Verzweigungen oder allen Verzweigungen gefiltert werden sollen.

BeispielkonfigurationDescription
/github subscribe owner/repo commitsCommit-Benachrichtigungen für den Standardbranch erhalten.
/github subscribe owner/repo commits:mainEmpfangen Sie nur Commit-Benachrichtigungen für den main Branch.
/github subscribe owner/repo commits:feature/*Empfangen Sie Commit-Benachrichtigungen für alle Branches, die mit feature/ beginnen.
/github subscribe owner/repo commits:*Commit-Benachrichtigungen für alle Branches erhalten.

Hinweis

Möglicherweise haben Sie früher den commits:all-Filter verwendet, um Commit-Benachrichtigungen für alle Branches zu erhalten. Dieser Filter ist veraltet. Um Commit-Benachrichtigungen für alle Zweige zu erhalten, verwenden Sie stattdessen den commits:*-Filter. Wenn Sie den commits:all Filter zuvor eingerichtet haben, funktioniert er weiterhin, bis Sie Die Konfiguration so aktualisieren, dass der commits:* Filter verwendet wird.

Label-Filter für Issue- und Pull-Request-Benachrichtigungen

Mit Bezeichnungsfiltern können Sie Benachrichtigungen basierend auf Bezeichnungen filtern, die auf Probleme und Pullanforderungen angewendet wurden. Wenn ein Bezeichnungsfilter festgelegt ist, werden nur Benachrichtigungen für Ereignisse einschließlich der angegebenen Bezeichnung gesendet. Weitere Informationen zu Bezeichnungen finden Sie unter Verwalten von Bezeichnungen und Filtern und Suchen von Problemen und Pull-Anforderungen.

Derzeit ist es nur möglich, einen erforderlichen Bezeichnungsfilter pro Repository zu haben. Die folgende Tabelle zeigt, welche Ereignistypen von Bezeichnungsfiltern betroffen sind.

EreignistypWird nach Bezeichnung gefiltert
Pull Requests
Probleme
Kommentare
Reviews
Commits/Pushes
Branches

Erstellen von Bezeichnungsfiltern

Verwenden Sie zum Erstellen eines Bezeichnungsfilters das folgende Befehlsformat:

Text
/github subscribe [owner/repo] +label:"your label"

Dadurch wird ein Filter für erforderliche Bezeichnungen mit dem Wert your labelerstellt. Eingehende Ereignisse, die Filter unterstützen, werden verworfen, es sei denn, sie sind mit dieser Bezeichnung versehen.

Aktualisieren von Bezeichnungsfiltern

Sie können einen vorhandenen Bezeichnungsfilter aktualisieren, indem Sie einen neuen Bezeichnungswert angeben:

Text
/github subscribe [owner/repo] +label:"new label"

Dadurch wird der Filter "Ihre Bezeichnung" durch den Filter "Neue Bezeichnung" ersetzt.

Entfernen von Labelfiltern

Sie können einen vorhandenen Bezeichnungsfilter entfernen, indem Sie den Befehl "Abonnement kündigen" mit der +label Option verwenden:

Text
/github unsubscribe [owner/repo] +label:"new label"

Dadurch wird der Filter "neue Bezeichnung" entfernt, und der Kanal empfängt alle Benachrichtigungen für die abonnierten Ereignisse ohne Bezeichnungsfilterung.

Filter der aktiven Labels anzeigen

Verwenden Sie den folgenden Befehl, um die derzeit aktiven Bezeichnungsfilter für einen Kanal anzuzeigen:

Text
/github subscribe list features

Gültige Filter

Die GitHub app in Slack unterstützt die am häufigsten verwendeten Sonderzeichen für Bezeichnungsfilter, einschließlich aller Emojis, die Slack und GitHub als Standard bereitstellen. Selten stößt man auf eine Bezeichnung, die ein Sonderzeichen enthält, das nicht unterstützt wird. Beispielsweise funktionieren multibyte-Zeichen, die nicht mit :foo:dem Zeichen codiert sind, oder Bezeichnungen, die das , Zeichen verwenden, möglicherweise nicht wie erwartet.

Aktions-Workflow Benachrichtigungen

Du kannst GitHub Actions-Workflowausführungsbenachrichtigungen aus Deinem Channel oder Deiner persönlichen App mithilfe des „Workflows“-Features unter Verwendung des Formats /github subscribe owner/repo workflows abonnieren.

Wenn Sie "Workflows" abonniert haben, ist die folgende Funktionalität verfügbar:

  • Sie werden benachrichtigt, wenn eine neue Workflowausführung ausgelöst wird.

  • Du kannst die Genehmigungsbenachrichtigungen als Antwort im Thread verfolgen und die Benachrichtigungen direkt im Channel/der persönlichen App genehmigen.

  • Sobald der Workflow abgeschlossen ist, erhalten Sie eine Aktualisierung als Antwort im Thread, damit Sie den Kontext und den Verlauf der Workflowausführung nachvollziehen können.

  • Wenn ein Fehler auftritt, können Sie den Workflow erneut ausführen und bei Bedarf auch Debugprotokolle aktivieren.

Hinweis

Nach 2025-03-10 (GHES Version 3.17) werden Sie nicht mehr über den Fortschritt einzelner Workflowaufträge benachrichtigt. Weitere Informationen finden Sie unter { % data variables.product.github %} changelog .

Workflow-Benachrichtigungs-Filter

Sie können Workflowbenachrichtigungen mithilfe der folgenden Optionen filtern:

FilterDescription
nameFiltern Sie nach dem Namen des Workflows.
actorFiltern Sie nach dem Benutzer, der den Workflow ausgelöst hat.
branchFiltern nach der Verzweigung, auf der der Workflow ausgeführt wird. In Fällen, in denen das pull_request-Ereignis enthalten ist, ist der Branch der Zielbranch, für den der Pull Request erstellt wird.
eventFiltern Sie nach dem Ereignis, das den Workflow ausgelöst hat (z. B. Push, pull_request).

Sie können Workflowbenachrichtigungsfilter mit dem folgenden Format konfigurieren:

Text
/github subscribe owner/repo workflows:{name:"your workflow name" event:"workflow event" branch:"branch name" actor:"username"}

Sie können auch mehrere Werte für jeden Filter übergeben, getrennt durch Kommas. Beispiel:

Text
/github subscribe owner/repo workflows:{name:"your workflow name","another workflow name" event:"workflow event","another workflow event" branch:"branch name","another branch name" actor:"username","another-username"}

Standardmäßig werden von Dir ohne Filter konfigurierte Workflowbenachrichtigungen für durch Pull Requests ausgelöste Workflows konfiguriert, die auf Deinen Standardbranch abzielen. Sie können einen oder mehrere Einträge übergeben.

Sie können workflowbenachrichtigungen mit dem Befehl kündigen: /github unsubscribe owner/repo workflows.

Hinweis

Um GitHub Actions-Benachrichtigungen in Slack zu erhalten, erfordert die GitHub-App zusätzliche Berechtigungen. Wenn Sie versuchen, Workflows zum ersten Mal zu abonnieren, werden Sie aufgefordert, diese Berechtigungen zu erteilen.

Bereitstellungsbenachrichtigungen

Sie können auch separate Bereitstellungsbenachrichtigungen konfigurieren. Diese Bereitstellungen können von GitHub Actions oder von externen Quellen mithilfe der Bereitstellungs-API durchgeführt werden. Weitere Informationen findest du unter REST-API-Endpunkte für Bereitstellungen.

Sie können Bereitstellungsbenachrichtigungen mit dem Befehl abonnieren/kündigen: /github subscribe/unsubscribe owner/repo deployments.

Hinweis

Wenn Du GitHub Actions verwendest und Deine Bereitstellungen an Umgebungen verfolgst, empfiehlt sich das Feature workflows, da es ein vollständigeres Bild sowie die Möglichkeit bietet, Deine Bereitstellungen direkt via Slack zu genehmigen.