Utiliser GitHub avec Slack

GitHub est un service de repository Git en ligne (un système qui permet à plusieurs personnes de travailler sur le même code en même temps). GitHub facilite l'hébergement des projets Git, le travail en équipe sur ces projets, le suivi des problèmes et l'organisation du travail.

À l'aide de l'application GitHub pour Slack, vous pouvez recevoir des alertes pour les événements suivants :

  • Faire un commit
  • Faire des « pull requests »
  • Déclarer des « issues » pour les événements
  • Événements de vérification des PR
  • Vérifier l'état de déploiement

 

Associer GitHub à Slack

Conseil : Avant de démarrer, vous devez avoir créé créé votre compte GitHub. Si nécessaire, accédez à github.com pour créer votre compte.

Lorsque vous êtes prêt(e) à associer GitHub à Slack, suivez les étapes ci-dessous :

  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.

 

Remarque sur 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.

Les seules autorisations que Slack utilisera sont celles requises pour lire les données des repositories (pour obtenir la liste de vos repositories publics et privés) et l'autorisation en écriture pour configurer vos webhooks sur GitHub.


Mode aucune authentification

Vous pouvez configurer l’application GitHub en utilisant le mode aucune authentification. Ceci est pratique pour deux raisons : votre équipe utilise GitHub Enterprise ou vous ne voulez pas accorder à Slack l’accès total en lecture et écriture.

Pour configurer l’application GitHub sous le mode aucune authentification, suivez les étapes 1 à 4 exposées 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, 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 à Slack

Lorsque vous rejoignez une nouvelle organisation GitHub, vous aurez besoin d'autoriser son accès à Slack. Suivez les étapes ci-dessous pour autoriser l’organisation et l’afficher sur l’application actuelle.

Autoriser l'accès à une nouvelle organisation

  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.

Articles associés

Articles consultés récemment