Skip to main content

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

Benachrichtigungen für GitHub in Teams anpassen

Passen Sie GitHub Benachrichtigungen an, um Ihre Arbeit in Teams zu verwalten.

Sie können Ihre Benachrichtigungen anpassen, indem Sie Aktivitäten abonnieren, die für Ihren Microsoft Teams 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 Befehl @GitHub Notifications unsubscribe owner/repo [feature] deaktiviert werden.

MerkmalBeschreibung
issuesGeöffnete, geschlossene oder wiedereröffnete Vorgänge.
pullsNeue, zusammengeführte, geschlossene oder erneut geöffnete Pullanforderungen.
commitsNeue Commits für die Standardverzweigung (in der Regel main).
commentsNeue Kommentare bei Issues und Pull Requests.
deploymentsAktualisierungen am Bereitstellungsstatus
releasesNeue Veröffentlichungen und veröffentlichte Vorabversionen.

Hinweis

Repositorybenachrichtigungen sind ebenfalls standardmäßig aktiviert. Sie werden benachrichtigt, wenn Ihr Repository öffentlich gemacht oder gelöscht wird. Diese Benachrichtigung kann nicht deaktiviert werden, da Repositoryupdates destruktive Aktivitäten sind.

Standardmäßig deaktivierte Benachrichtigungen

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

MerkmalBeschreibung
reviewsÜberprüfungen von Pull-Anfragen.
workflowsGitHub Actions-Workflowausführungen und Genehmigungsbenachrichtigungen.
branchesVerzweigungserstellung und -löschung.
discussionsErstellte oder beantwortete Diskussionen.
+label:"your label"Filtern Sie Probleme, Pullanforderungen und Kommentare basierend auf ihren Bezeichnungen.

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

  • Verwenden Sie @GitHub Notifications subscribe owner/repo reviews comments, um die Aktivität für Pullanforderungsüberprüfungen und Kommentare zu aktivieren.
  • Verwenden Sie @GitHub Notifications 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.

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

Sie können sich von dem Commits-Feature mit @GitHub Notifications unsubscribe owner/repo commits abmelden.

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
Bewertungen
Commits/Pushes
Filialen

Erstellen von Bezeichnungsfiltern

Verwenden Sie zum Erstellen eines Bezeichnungsfilters das folgende Befehlsformat:

Text
@GitHub Notifications 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 Notifications 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 Notifications 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 Notifications subscribe list features

Gültige Filter

Die GitHub App in Teams unterstützt die am häufigsten verwendeten Sonderzeichen für Bezeichnungsfilter, einschließlich aller Emojis, die Teams 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.

GitHub Actions Workflowbenachrichtigungen

Du kannst GitHub Actions-Workflowausführungsbenachrichtigungen aus Deinem Channel oder Deiner persönlichen App mithilfe des „Workflows“-Features unter Verwendung des Formats @GitHub Notifications 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.
  • Sie können die Genehmigungsbenachrichtigungen als Antwort im Thread nachverfolgen und die Benachrichtigungen direkt über den Kanal oder die persönliche App genehmigen.
  • Nachdem der Workflow abgeschlossen ist, erhalten Sie eine Aktualisierung als Antwort im Thread, damit Sie den vollständigen Kontext und den Verlauf der Workflowausführung sehen können.
  • Wenn ein Fehler auftritt, können Sie den Workflow erneut ausführen und bei Bedarf auch Debugprotokolle aktivieren.

Hinweis

Nach dem 10. März 2025 und für GitHub Enterprise Server, Version 3.17 und höher, wirst du 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:

FilterBeschreibung
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 Notifications 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 Notifications 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 Notifications unsubscribe owner/repo workflows" kündigen.

Hinweis

Um GitHub Actions Benachrichtigungen in Teams 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 den folgenden Befehlen abonnieren oder kündigen:

Text
@GitHub Notifications subscribe owner/repo deployments
@GitHub Notifications 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 Ihnen die Genehmigung Ihrer Bereitstellungen direkt über Teams ermöglicht.