Skip to main content

Enterprise Server 3.20 ist derzeit als Release Candidate verfügbar.

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 Probleme und Pullanforderungen 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 schließen. 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 Labels 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

Sie können Benachrichtigungen über die Ausführung von GitHub Actions Workflows aus Ihrem Kanal oder Ihrer persönlichen App mithilfe der Funktion "Workflows" und 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 Ziel-Branch, für den die Pull-Anfrage 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 das Abonnement von Workflowbenachrichtigungen mit dem Befehl "/github unsubscribe owner/repo workflows" kündigen.

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 Sie GitHub Actions verwenden und Ihre Bereitstellungen in Umgebungen nachverfolgen möchten, wird die Funktion workflows empfohlen, da sie ein umfassenderes Bild bietet, und die Möglichkeit bietet, Ihre Bereitstellungen direkt aus Slack zu genehmigen.