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é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 Install pour installer GitHub.
  3. Sélectionnez une chaîne pour y afficher les événements GitHub.
  4. Cliquez sur Add GitHub Integration pour ajouter l'intégration GitHub. 
  5. Cliquez sur Authenticate your GitHub account pour authentifier votre compte GitHub.
  6. Sélectionnez les repositories pour lequels vous souhaitez recevoir des notifications sur Slack. 
  7. Sélectionnez les événements GitHub que vous souhaitez afficher sur Slack.
  8. Vous pouvez personnaliser le nom qui s'affiche sur les posts GitHub et même ajouter une icône personnalisée.
  9. Lorsque vous avez terminé, cliquez sur Save Integration pour 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, webhooks et services, ainsi que les clés de déploiement.

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 utile pour les deux raisons suivantes :

  • Votre équipe utilise GitHub Enterprise
  • Vous ne souhaitez pas permettre à Slack un accès complet en lecture et en é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 switch to unauthed mode pour passer au mode Aucune authentification.
  2. Dans votre compte GitHub, accédez au repository que vous souhaitez suivre. Cliquez sur Settings à droite du menu de navigation.
  3. Cliquez sur Webhooks & Services à gauche du menu de navigation, puis cliquez sur Add webhook.
  4. Dans la fenêtre Slack App Directory, cliquez sur copy URL.
  5. Revenez à votre compte GitHub et collez l'URL en dessous de Payload URL.
  6. Pour le type de contenu (Content type), vérifiez que vous avez sélectionné application/json.
  7. Vérifiez que vous avez activé SLL verification.
  8. Cliquez sur Add webhook.
  9. Revenez à la page Configuration de Slack et cliquez sur Save Integration pour 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 Authorized OAuth applications (Applications OAuth autorisées), cliquez sur Slack.
  3. Sous Organization access (Accès à l'organisation), cliquez sur Grant Access (Autoriser 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