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 les contenus publiés 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 êtes développeur, renseignez-vous sur la conception de la nouvelle génération d’applications Slack et rejoignez l’aperçu développeur !

 

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.
  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. Cliquez sur Authentifiez votre compte GitHub .
  6. Sélectionnez les repositories pour lequels vous souhaitez recevoir des notifications sur Slack. 
  7. Choisissez les événements GitHub que vous souhaitez publier sur Slack.
  8. Si vous le souhaitez, vous pouvez personnaliser les publications de GitHub dans Slack en choisissant un nom d’affichage et une icône personnalisés.
  9. Lorsque vous avez terminé, cliquez sur Enregistrer l’intégration.


Comprendre les autorisations 

Slack demande l'autorisation d'accéder à certains repositories GitHub la première fois que vous vous connectez à l'application. Nous avons besoin d'un accès en lecture et en écriture à toutes les données publiques et privées des repositories : code, problèmes, pull requests, wikis, paramètres, clés de déploiement, ainsi que les webhooks et services.

Nous en demandons beaucoup, et nous en sommes conscients ! Pour que Slack puisse accéder à la liste complète de vos repositories publics et privés, vous devez utiliser l'ensemble « repo » de GitHub, qui octroie en outre toutes les autorisations mentionnées ci-dessus.

Remarque : Slack n’utilise ces autorisations que pour lire les données des repositories (afin d’obtenir la liste de vos repositories publics et privés) et pour configurer vos webhooks sur GitHub.


Mode aucune authentification

Vous pouvez choisir de configurer l’application en utilisant le Mode aucune authentification. Pour ce faire, suivez les étapes 1 à 4 de la section ci-dessus, puis procédez comme suit :

  1. Sur la page Configuration de Slack, cliquez sur Mode aucune authentification.
  2. Dans votre compte GitHub, accédez au repository que vous souhaitez suivre. Cliquez sur Paramètres à droite du menu de navigation.
  3. Cliquez sur Webhooks & Services à gauche du menu de navigation, puis cliquez sur Ajouter un webhook.
  4. Dans la fenêtre de la liste des applications Slack, cliquez sur Copier l’URL
  5. Revenez à votre compte GitHub et collez l’URL en dessous de URL de la charge utile.
  6. Pour le Type de contenu, vérifiez que vous avez sélectionné application/json.
  7. Assurez-vous que l’option  Vérification SSL est activée.
  8. Cliquez sur Ajouter un webhook.
  9. Revenez à la page Configuration de Slack et cliquez sur Enregistrer l’intégration.


Ajouter une nouvelle organisation GitHub

Lorsque vous rejoignez une nouvelle organisation GitHub, vous devez autoriser son accès à Slack. Une fois l’autorisation activée, la nouvelle organisation sera affichée dans l’application actuelle. Pour faire la configuration, procédez comme suit :

  1. Accédez aux paramètres GitHub : github.com/settings.
  2. Sous Applications OAuth autorisées, cliquez sur Slack.
  3. Sous Accès à l’organisation, cliquez sur Donner l’accès à côté de votre nouvelle organisation.

Votre nouvelle organisation et ses repositories s’affichent sur la page de l’application GitHub sur Slack : my.slack.com/apps/manage.

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

Articles associés

Articles consultés récemment