L’intégration GitHub de Slack vous permet de connecter votre GitHub compte à l’application GitHub dans Slack. Une fois connecté, vous pouvez utiliser des commandes de barre oblique pour interagir avec GitHub, recevoir des notifications sur l’activité du référentiel et collaborer avec votre équipe directement dans Slack.
Connexion de votre GitHub compte à l’application GitHub dans Slack
Remarque
Avant de pouvoir connecter vos comptes, un administrateur de votre espace de travail Slack doit avoir installé l’application GitHub . Consultez « Intégration de GitHub à Slack ».
- Dans Slack, démarrez un message direct avec l’application GitHub .
- Le message direct est prérempli avec un message d’accueil et un lien pour connecter votre GitHub compte. Suivez les invites à l'écran dans Slack et, dans GitHub, dans votre navigateur, pour authentifier et autoriser la connexion.
Une fois votre GitHub compte connecté, Slack affiche une liste de commandes et de fonctionnalités disponibles que vous pouvez utiliser.
Utilisation de commandes Slash pour interagir avec GitHub dans Slack
Pour utiliser une commande slash, tapez /github, suivie par la commande que vous souhaitez exécuter, dans le champ de saisie de message de n’importe quel canal Slack ou message direct où l’application GitHub est présente. Pour inviter l'application dans un canal, tapez /invite @github dans le canal.
| Command | Descriptif |
|---|---|
/github help | Affiche une liste de commandes essentielles et de leurs descriptions. |
/github subscribe owner/repo | Abonne le canal aux notifications pour le référentiel spécifié. |
/github unsubscribe owner/repo | Désabonne le canal des notifications pour le référentiel spécifié. |
/github subscribe list | Répertorie tous les dépôts auxquels le canal est abonné. |
/github open owner/repo | Ouvre un problème dans le référentiel spécifié. Vous serez invité à fournir un titre et une description pour le problème. |
/github close [issue link] | Ferme le problème spécifié comme terminé. |
/github close [issue link] reason:"not planned" | Ferme le problème spécifié avec une raison. Remplacez "not planned" par votre raison. |
/github reopen [issue link] | Rouvre le problème spécifié. |
/github signin | Redémarre le flux de travail « Connecter votre compte GitHub ». |
Remarque
Lorsque vous abonnez un canal à un référentiel, celui-ci recevra des notifications pour tous les événements open, close, et reopen liés aux demandes de tirage et aux problèmes dans ce référentiel. Le canal recevra également des notifications de tous les événements push directement dans la branche par défaut du référentiel.
Mentions dans Slack
Lorsque vous vous abonnez à un référentiel dans Slack, vous verrez vous-même mentionné dans les notifications pour les événements de référentiel dans lesquels vous avez été référencé. Par exemple, si vous êtes affecté à un problème ou mentionné dans un commentaire, vous serez mentionné dans la notification sur Slack.
Les mentions nécessitent que vous soyez connecté à votre GitHub compte via l’application GitHub dans Slack. Cela permet GitHub de mapper votre identité Slack à votre GitHub identité. Consultez Connexion de votre GitHub compte à l’application GitHub dans Slack.
Remarque
Si vous avez plusieurs espaces de travail Slack où vous utilisez l’application GitHub , les mentions fonctionnent uniquement dans l’espace de travail où vous vous êtes connecté à votre GitHub application le plus récemment. Si vous vous connectez à votre GitHub application dans un autre espace de travail, les mentions cesseront de fonctionner dans l’espace de travail précédent.
Voici les scénarios dans lesquels vous serez mentionné :
- Vous êtes affecté à un problème.
- Votre révision est demandée sur une demande de tirage.
- Vous êtes mentionné dans une pull request, la description d'une anomalie, un commentaire ou une discussion.
- Votre révision est demandée sur un déploiement.
- Vous recevez un rappel planifié pour une demande de révision de code.
Vous pouvez voir un résumé de vos GitHub mentions dans la vue « Mentions » dans Slack. Pour plus d’informations, consultez Notifications de triage sous l’onglet Activité dans la documentation Slack.
Conversations en fil
Les notifications pour chaque issue ou pull request sont regroupées dans un thread dans Slack. Le message parent affiche toujours l’état le plus récent du problème ou de la pull request, ainsi que d’autres métadonnées telles que le titre, la description, les attributaires, les réviseurs, les étiquettes et les vérifications. Le threading permet de maintenir les conversations organisées, ce qui facilite le suivi des mises à jour et des discussions liées à un problème ou à une pull request spécifique. Lorsque l’état d’un problème ou d’une demande de tirage change, la réponse associée est publiée à la fois dans le thread et dans le canal, afin que tous les utilisateurs du canal soient au courant de la mise à jour.
Vous pouvez désactiver le threading pour les notifications d'incidents et de "pull request" dans des canaux individuels.
- Dans le canal Slack où vous souhaitez désactiver le threading, tapez
/github settings. - Dans le menu des paramètres, à droite de “Désactiver le threading pour les notifications de pull request et d'incident”, cliquez sur Désactiver.
Vous ou tout autre membre du canal pouvez réactiver le thread à tout moment en suivant les mêmes étapes et en cliquant sur Activer dans le menu paramètres.
Transmission de commentaires et d'avis sur le canal Slack
Par défaut, les commentaires et les révisions s’affichent uniquement dans leur thread associé. Si vous souhaitez que les membres du canal voient les messages plutôt que seulement ceux qui participent à la discussion, vous pouvez activer la diffusion avec les commandes suivantes :
-
Pour la diffusion de commentaires, utilisez
/github subscribe owner/repo comments:"channel" -
Pour la diffusion des demandes de révision, utilisez
/github subscribe owner/repo reviews:"channel"
Déployer les liens des GitHub activités dans Slack
Les aperçus de liens fournissent un contexte supplémentaire lors du partage de liens vers des activités dans Slack. Les aperçus des liens sont affichés dans Slack pour les activités suivantes GitHub :
- Demandes de tirage
- Problèmes
- Commentaires directement liés
- Blocs de code numérotés
- Organisations, référentiels et utilisateurs
Les aperçus des liens ne s’affichent pas si l’un des éléments suivants s’applique :
- Les aperçus de lien sont désactivés dans votre espace de travail Slack. Consultez les liens Partager et définir des préférences d’aperçu dans la documentation Slack.
- Le même lien a déjà été partagé dans le canal au cours des 30 dernières minutes.
- 3 liens ou plus sont partagés dans le même message.
- Le référentiel est privé et l’utilisateur qui a partagé le lien :
- N’a pas connecté son GitHub compte à l’application GitHub dans Slack.
- Il est demandé de ne pas afficher les aperçus de lien lorsque vous y êtes invité.
- L’application GitHub n’est pas dans le canal où le lien est partagé. Consultez Utilisation des commandes slash pour interagir avec GitHub dans Slack.
Lectures complémentaires
-
[AUTOTITLE](/integrations/how-tos/slack/customize-notifications) - Découvrez comment personnaliser vos GitHub notifications dans Slack pour répondre à vos besoins. -
[AUTOTITLE](/integrations/tutorials/slack) - Créez des compétences et des connaissances sur l’intégration GitHub de Slack par le biais d’exemples et d’activités pratiques.