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.
| Event | Description |
|---|---|
issues | Geöffnete, geschlossene oder wiedereröffnete Vorgänge. |
pulls | Neue oder zusammengeführte Pull Requests und Entwurfs-Pull-Requests, die als bereit zur Überprüfung markiert wurden. |
commits | Neue Commits im Standardbranch. |
releases | Veröffentlichte Versionen. |
deployments | Aktualisierungen 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.
| Event | Description |
|---|---|
reviews | Überprüfungen von Pull-Anfragen. |
workflows | Aktionen-Workflow läuft. |
branches | Erstellte oder gelöschte Branches. |
comments | Neue Kommentare bei Issues und Pull Requests. |
commits | Alle Commits in jedem Branch. |
discussions | Erstellte 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.
| Beispielkonfiguration | Description |
|---|---|
/github subscribe owner/repo commits | Commit-Benachrichtigungen für den Standardbranch erhalten. |
/github subscribe owner/repo commits:main | Empfangen 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.
| Ereignistyp | Wird nach Bezeichnung gefiltert |
|---|---|
| Pull Requests | |
| Probleme | |
| Kommentare | |
| Reviews | |
| Commits/Pushes | |
| Branches |
Erstellen von Bezeichnungsfiltern
Verwenden Sie zum Erstellen eines Bezeichnungsfilters das folgende Befehlsformat:
/github subscribe [owner/repo] +label:"your label"
/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:
/github subscribe [owner/repo] +label:"new label"
/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:
/github unsubscribe [owner/repo] +label:"new label"
/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:
/github subscribe list features
/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:
| Filter | Description |
|---|---|
name | Filtern Sie nach dem Namen des Workflows. |
actor | Filtern Sie nach dem Benutzer, der den Workflow ausgelöst hat. |
branch | Filtern 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. |
event | Filtern Sie nach dem Ereignis, das den Workflow ausgelöst hat (z. B. Push, pull_request). |
Sie können Workflowbenachrichtigungsfilter mit dem folgenden Format konfigurieren:
/github subscribe owner/repo workflows:{name:"your workflow name" event:"workflow event" branch:"branch name" actor:"username"}
/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:
/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"}
/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.