GitHub pour Slack

GitHub est une plateforme dédiée aux développeurs de logiciels. Elle leur permet de se constituer en équipes pour coder de façon collaborative et gérer les projets en cours. Lorsque vous connectez GitHub à Slack, vous pouvez recevoir des notifications pour toutes sortes d’activités dans les chaînes Slack de votre choix. Avec GitHub pour Slack, vous associez deux de vos outils les plus importants pour travailler plus efficacement, directement depuis votre interface Slack. 🛠


Choisir l’application que vous souhaitez utiliser

  • GitHub pour Slack : vous êtes abonné(e) au forfait GitHub Developer, Team ou Business ? Cette application est faite pour vous !
  • Github Notifications (ancienne version) : cette application est compatible avec GitHub Enterprise.


Installer l’application

GitHub pour Slack 

GitHub Notifications (ancienne version)

Avec l’application GitHub, vous pouvez obtenir des aperçus de liens dans Slack pour les référentiels publics, configurer des notifications avec des commandes barre oblique et vous tenir facilement informé de toutes les activités des projets en cours.


Installer l’application

  1. Accédez à slack.github.com et cliquez sur Add to Slack.
  2. Prenez connaissance des autorisations d’accès que l’application requiert, puis cliquez sur Continuer pour accorder ces autorisations.
  3. Sélectionnez les chaînes auxquelles l’application peut accéder : Toutes les chaînes publiques, Certaines chaînes publiques ou Aucune.

Une fois l’application GitHub installée, elle vous enverra un message direct pour vous aider dans le processus de configuration et vous expliquer le fonctionnement de la commande barre oblique /github.

Conseil : utilisez la commande barre oblique /github subscribe owner/repo pour vous abonner à vos configurations précédentes.



Personnaliser les notifications

Avec l’application GitHub, vous pouvez facilement personnaliser le contenu publié dans Slack. Vous pouvez vous abonner aux activités qui concernent l’ensemble de la chaîne et vous désabonner de celles qui sont moins utiles. Par défaut, certaines activités déclencheront des notifications dans Slack tandis que d’autres resteront sans effet.

Fonctionnalités activées par défaut

  • issues
  • pulls
  • statuses
  • commits
  • deployments
  • public

Fonctionnalités non activées par défaut

  • reviews
  • comments
  • branches
  • commits:all

 

Vous pouvez utiliser les commandes barre oblique suivantes pour personnaliser vos notifications :

  • /github subscribe owner/repo [fonctionnalité]
  • /github unsubscribe owner/repo [fonctionnalité]


Remarque sur l’application GitHub

Si vous utilisez d’autres applications Slack, vous remarquerez peut-être que l’installation de GitHub présente quelques différences. En effet, cette application fonctionne au niveau de l’espace de travail, et non au niveau des membres. Et c’est une bonne chose ! Voilà pourquoi :

  • L’application ne se déconnectera jamais si la personne à l’origine de l’installation vient à quitter votre espace de travail.
  • Vous pouvez ajouter l’application GitHub à des chaînes spécifiques. Vous pouvez choisir ces chaînes pendant l’installation ou utiliser /inviter @github pour ajouter l’application à une chaîne par la suite.

💡 Vous trouverez plus d’informations sur le devenir des applications Slack sur le blog de la plateforme Slack.

 

Si vous utilisez GitHub Enterprise (l’option sur site de GitHub), vous devez installer l’application GitHub Notifications (ancienne version).


Installer l’application

  1. Retrouvez GitHub dans la liste des applications Slack.
  2. Cliquez sur Installer, ou sur Ajouter la configuration en cas de configuration existante.
  3. Sélectionnez la chaîne sur laquelle les événements GitHub seront publiés ou cliquez sur Créer une chaîne pour en créer une nouvelle.
  4. Cliquez sur Ajouter une intégration GitHub .
  5. Dans votre compte GitHub, accédez au repository que vous souhaitez suivre. Cliquez sur Paramètres en haut du menu de navigation.
  6. Cliquez sur Webhooks à gauche du menu de navigation, puis appuyez sur le bouton Ajouter un webhook.
  7. Dans la fenêtre de la liste des applications Slack, cliquez sur Copier l’URL.
  8. Revenez à votre compte GitHub et collez l’URL en dessous de URL de la charge utile.
  9. Pour le Type de contenu, vérifiez que vous avez sélectionné application/json.
  10. Assurez-vous que l’option  Vérification SSL est activée.
  11. Cliquez sur Ajouter un webhook.
  12. Revenez à la page Configuration de Slack et cliquez sur Enregistrer l’intégration.

Vous avez des questions ? N’hésitez pas à nous contacter. Nous sommes là pour vous aider !