Mit der GitHub Integration für Slack können Sie Ihr GitHub Konto mit der GitHub App in Slack verbinden. Sobald die Verbindung hergestellt ist, können Sie Schrägstrichbefehle verwenden, um mit GitHub zu interagieren, Benachrichtigungen über Aktivitäten des Repositories zu erhalten und direkt in Slack mit Ihrem Team zusammenzuarbeiten.
Verbinden Ihres GitHub Kontos mit der GitHub App in Slack
Hinweis
Bevor Sie Ihre Konten verbinden können, muss ein Administrator für Ihren Slack-Arbeitsbereich die GitHub App installiert haben. Weitere Informationen findest du unter Integrieren von GitHub mit Slack.
- Starten Sie in Slack eine direkte Nachricht mit der GitHub App.
- Die direkte Nachricht wird bereits mit einer Willkommensnachricht und einem Link zum Verbinden Ihres GitHub Kontos ausgefüllt. Folgen Sie den Anweisungen auf dem Bildschirm in Slack und in GitHub Ihrem Browser, um die Verbindung zu authentifizieren und zu autorisieren.
Sobald Ihr GitHub Konto verbunden ist, zeigt Slack Ihnen eine Liste der verfügbaren Befehle und Features an, die Sie verwenden können.
Verwenden von Schrägstrichbefehlen zur Interaktion mit GitHub in Slack
Wenn Sie einen Schrägstrichbefehl verwenden möchten, geben Sie /github gefolgt von dem Befehl ein, den Sie im Nachrichteneingabefeld eines beliebigen Slack-Kanals oder einer direkten Nachricht ausführen möchten, wo die GitHub App installiert ist. Um die App zu einem Kanal einzuladen, geben Sie /invite @github im Kanal ein.
| Command | Description |
|---|---|
/github help | Zeigt eine Liste der wesentlichen Befehle und deren Beschreibungen an. |
/github subscribe owner/repo | Abonniert den Kanal für Benachrichtigungen für das angegebene Repository. |
/github unsubscribe owner/repo | Meldet den Kanal von Benachrichtigungen für das angegebene Repository ab. |
/github subscribe list | Listet alle Repositorys auf, denen der Kanal abonniert ist. |
/github open owner/repo | Öffnet ein Problem im angegebenen Repository. Sie werden aufgefordert, einen Titel und eine Beschreibung für das Problem anzugeben. |
/github close [issue link] | Schließt das angegebene Problem als abgeschlossen. |
/github close [issue link] reason:"not planned" | Schließt das angegebene Issue mit einer Begründung. Ersetzen Sie "not planned" durch Ihren Grund. |
/github reopen [issue link] | Öffnet das angegebene Problem erneut. |
/github signin | Startet den Workflow "Ihr GitHub Konto verbinden" neu. |
/github signout | Trennt Ihr GitHub Konto von Ihrem Slack-Benutzer. |
Hinweis
Wenn Sie einen Kanal für ein Repository abonnieren, empfängt der Kanal Benachrichtigungen für alle open, closeund reopen Ereignisse bei Pullanforderungen und Problemen in diesem Repository. Der Channel erhält zudem Benachrichtigungen zu sämtlichen push-Ereignissen direkt für den Standardbranch des Repositorys.
Erwähnungen in Slack
Wenn Sie ein Repository in Slack abonnieren, werden Sie in Benachrichtigungen für Repository-Ereignisse erwähnt, bei denen Sie referenziert wurden. Wurdest Du zum Beispiel einem Issue zugewiesen oder in einem Kommentar erwähnt, wirst Du Deine Erwähnung in der Benachrichtigung in Slack sehen.
Erwähnungen erfordern, dass Sie über die GitHub App in Slack bei Ihrem GitHub Konto angemeldet sind. Auf diese Weise ermöglicht GitHub Ihnen, Ihre Slack-Identität Ihrer GitHub Identität zuzuordnen. Siehe Verbinden Ihres GitHub Kontos mit der GitHub App in Slack.
Hinweis
Wenn Sie über mehrere Slack-Arbeitsbereiche verfügen, in denen Sie die GitHub App verwenden, funktionieren Erwähnungen nur im Arbeitsbereich, in dem Sie sich zuletzt bei Ihrer GitHub App angemeldet haben. Wenn Sie sich bei Ihrer GitHub App in einem anderen Arbeitsbereich anmelden, funktionieren Erwähnungen im vorherigen Arbeitsbereich nicht mehr.
Es folgen Szenarien, in denen Sie erwähnt werden:
- Ihnen wird ein Problem zugewiesen.
- Ihre Rezension wird bei einer Pull-Anforderung angefordert.
- Sie werden in einer Pull-Anforderung, Problembeschreibung, Kommentar oder Diskussion erwähnt.
- Deine Überprüfung wird für eine Bereitstellung angefordert.
- Du erhältst eine geplante Erinnerung für eine Pull-Review-Anforderung.
Sie können eine Zusammenfassung Ihrer GitHub Erwähnungen in der Ansicht „Erwähnungen” in Slack anzeigen. Weitere Informationen findest Du unter Triage von Benachrichtigungen auf dem Tab „Aktivität“ in der Dokumentation von Slack.
Thread-Konversationen
Benachrichtigungen für jedes Problem oder jede Pullanforderung werden in einem Thread in Slack gruppiert. Die übergeordnete Nachricht zeigt stets den aktuellen Status des Problems oder Pull Requests, sowie andere Metadaten wie Titel, Beschreibung, Zugewiesene, Reviewer, Labels und Checks an. Threading hilft, Unterhaltungen organisiert zu halten, wodurch es einfacher ist, Updates und Diskussionen im Zusammenhang mit einem bestimmten Problem oder Pull-Anforderung zu verfolgen. Wenn sich der Status eines Problems oder einer Pullanforderung ändert, wird die zugeordnete Antwort sowohl im Thread als auch im Kanal gepostet, damit jeder im Kanal das Update kennt.
Sie können Threading für Problem- und Pullanforderungsbenachrichtigungen in einzelnen Kanälen deaktivieren.
- Geben Sie im Slack-Kanal, wo Sie das Threading deaktivieren möchten,
/github settingsein. - Klicken Sie im Menü "Einstellungen" rechts neben "Threading für Pullanforderungs- und Problembenachrichtigungen deaktivieren" auf "Deaktivieren".
Sie oder ein beliebiges anderes Mitglied des Kanals können threading jederzeit erneut aktivieren, indem Sie die gleichen Schritte ausführen und im Menü "Einstellungen " auf "Aktivieren" klicken.
Senden von Kommentaren und Rezensionen an den Slack-Kanal
Standardmäßig werden Kommentare und Rezensionen nur in ihrem zugehörigen Thread angezeigt. Wenn Sie möchten, dass die Kanalmitglieder sie sehen, anstatt nur diejenigen, die Teilnehmer des Problems sind, können Sie sich für die Übertragung mit den folgenden Befehlen anmelden:
-
Verwenden Sie für die Kommentarübertragung
/github subscribe owner/repo comments:"channel" -
Verwende
/github subscribe owner/repo reviews:"channel"für das Übertragen von Reviews
Unfurling-Links zu GitHub-Aktivitäten in Slack
Linkvorschauen bieten zusätzlichen Kontext beim Freigeben von Links zu GitHub Aktivitäten in Slack. Linkvorschauen werden in Slack für die folgenden GitHub Aktivitäten angezeigt:
- Pull Requests
- Probleme
- Direkt verknüpfte Kommentare
- Code-Blobs mit Zeilennummern
- Organisationen, Repositorys und Benutzer
Vorschauen von Links werden nicht angezeigt, wenn eine der folgenden Bedingungen zutrifft:
- Linkvorschauen sind in Ihrem Slack-Arbeitsbereich deaktiviert. Weitere Informationen finden Sie unter "Freigabelinks", und legen Sie die Vorschaueinstellungen in der Slack-Dokumentation fest.
- Derselbe Link wurde bereits in den letzten 30 Minuten im Kanal freigegeben.
- 3 oder mehr Links werden in derselben Nachricht geteilt.
- Das Repository ist privat und der Benutzer, der den Link freigegeben hat:
- Hat ihr GitHub Konto nicht mit der GitHub App in Slack verbunden.
- Gebeten wurden, keine Linkvorschauen anzuzeigen, wenn dazu aufgefordert.
- Die GitHub App befindet sich nicht im Kanal, in dem der Link freigegeben wird. Siehe Verwendung von Slash-Befehlen zur Interaktion mit GitHub in Slack.
Weiterführende Lektüre
-
[AUTOTITLE](/integrations/how-tos/slack/customize-notifications) – Erfahren Sie, wie Sie Ihre GitHub Benachrichtigungen in Slack an Ihre Anforderungen anpassen. -
[AUTOTITLE -](/integrations/tutorials/slack) Bauen Sie Fähigkeiten und Wissen über die GitHub Slack-Integration durch Beispiele und praktische Aktivitäten auf.