L’intégration GitHub pour Slack vous permet de connecter votre compte GitHub à 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 compte GitHub à 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 AUTOTITLE.
- 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 compte GitHub. Suivez les invites à l’écran dans Slack et, dans GitHub dans votre navigateur, pour authentifier et autoriser la connexion.
Une fois que votre compte GitHub est connecté, Slack affiche la liste des commandes et fonctionnalités disponibles que vous pouvez utiliser.
Utilisation de commandes Slash pour interagir avec GitHub dans Slack
Pour utiliser une commande slash, tapez suivi de la commande que vous souhaitez exécuter dans le champ d'entrée 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 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 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 , , et 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 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 compte GitHub via l’application GitHub dans Slack. Cela permet à GitHub de mapper votre identité Slack à votre identité GitHub. Voir Connexion de votre compte GitHub à l’application GitHub dans Slack.
Remarque
Si vous avez plusieurs espaces de travail Slack dans lesquels vous utilisez l’application GitHub, les mentions fonctionnent uniquement dans l’espace de travail où vous vous êtes connecté à votre application GitHub récemment. Si vous vous connectez à votre application GitHub 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 .
- 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
-
Pour la diffusion des demandes de révision, utilisez
Dérouler les liens vers les activités de GitHub dans Slack
Les aperçus de liens fournissent un contexte supplémentaire lors du partage de liens vers GitHub activités dans Slack. Les aperçus de lien sont affichés dans Slack pour les activités GitHub suivantes :
- 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 compte GitHub à 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 - Découvrez comment personnaliser vos GitHub notifications dans Slack pour répondre à vos besoins.
- AUTOTITLE - Développer des compétences et des connaissances sur l'intégration Slack de GitHub à l'aide d'exemples et d'activités pratiques.