Personnalisation des notifications pour GitHub dans Slack

Vous pouvez personnaliser vos notifications en vous abonnant à l’activité pertinente pour votre canal Slack et en vous désinscrire de l’activité qui est moins utile pour votre projet.

Notifications activées par défaut

Les notifications suivantes sont activées par défaut, mais vous pouvez les désactiver à l’aide de la commande /github unsubscribe owner/repo [event].

Notifications désactivées par défaut

Les notifications suivantes sont désactivées par défaut, mais vous pouvez les activer à l’aide de la commande /github subscribe owner/repo [event].

Vous pouvez vous abonner ou vous désabonner de plusieurs paramètres à la fois. Par exemple:

• Pour activer l'activité des révisions et commentaires des pull requests, utilisez /github subscribe owner/repo reviews comments.
• Pour désactiver l’activité pour les problèmes et les pull requests, utilisez /github unsubscribe owner/repo issues pulls.

Filtrage des notifications

Vous pouvez personnaliser davantage vos notifications avec des filtres de branche et d’étiquette. Les filtres de branche vous permettent de filtrer les notifications de validation en fonction des noms de branche, tandis que les filtres d’étiquettes vous permettent de filtrer les notifications de problèmes et de propositions de modification en fonction des étiquettes appliquées.

Filtres de branches pour les notifications de validation

Les filtres de branche vous permettent de filtrer les notifications de validation en fonction des noms de branche. Par défaut, lorsque vous vous abonnez à l’événement commits , vous recevez des notifications pour votre branche par défaut. Toutefois, vous pouvez choisir de filtrer sur une branche spécifique, ou un modèle de branches ou de toutes les branches.

Filtres d'étiquettes pour les notifications de problèmes et de demande de tirage

Les filtres d’étiquettes vous permettent de filtrer les notifications en fonction des étiquettes appliquées aux issues et aux pull requests. Lorsqu’un filtre d’étiquette est défini, seules les notifications pour les événements incluant l’étiquette spécifiée sont envoyées. Pour plus d’informations sur les étiquettes, consultez Gestion des étiquettes et Filtrage et recherche de problèmes et de demandes de tirage.

Actuellement, il n’est possible d’avoir qu’un seul filtre d’étiquette requis par référentiel. Le tableau ci-dessous montre quels types d’événements sont affectés par les filtres d’étiquettes.

Création de filtres d’étiquettes

Pour créer un filtre d’étiquette, utilisez le format de commande suivant :

/github subscribe [owner/repo] +label:"your label"

/github subscribe [owner/repo] +label:"your label"

Cela crée un filtre d’étiquette obligatoire avec la valeur your label. Les événements entrants qui prennent en charge les filtres sont ignorés, sauf s’ils ont cette étiquette.

Mise à jour des filtres d’étiquettes

Vous pouvez mettre à jour un filtre d’étiquette existant en spécifiant une nouvelle valeur d’étiquette :

/github subscribe [owner/repo] +label:"new label"

/github subscribe [owner/repo] +label:"new label"

Cela remplace le filtre « votre étiquette » par le filtre « nouvelle étiquette ».

Suppression des filtres d’étiquettes

Vous pouvez supprimer un filtre d’étiquette existant à l’aide de la commande de désabonnement avec l’option +label :

/github unsubscribe [owner/repo] +label:"new label"

/github unsubscribe [owner/repo] +label:"new label"

Cela supprime le filtre « nouvelle étiquette », et le canal reçoit toutes les notifications pour les événements abonnés sans filtrage d’étiquette.

Affichage des filtres d’étiquettes actifs

Pour afficher les filtres d’étiquettes actuellement actifs pour un canal, utilisez la commande suivante :

/github subscribe list features

/github subscribe list features

Filtres valides

L’application GitHub dans Slack prend en charge les caractères spéciaux les plus courants pour les filtres d’étiquettes, y compris tous les emojis que Slack et GitHub fournissent en tant que standard. Rarement, vous pouvez rencontrer une étiquette qui contient un caractère spécial qui n’est pas supporté. Par exemple, tout caractère multioctet non codé en tant que :foo:, ou les étiquettes utilisant le , caractère peuvent ne pas fonctionner comme prévu.

Notifications de flux de tâches

Vous pouvez vous abonner aux notifications d'exécution de flux de travail GitHub Actions à partir de votre canal ou de votre application personnelle en utilisant la fonctionnalité « workflows », au format /github subscribe owner/repo workflows.

Lorsque vous êtes abonné à des « workflows », les fonctionnalités suivantes sont disponibles :

• Vous serez averti lorsqu’une nouvelle exécution de flux de travail est déclenchée.

• Vous pouvez suivre les notifications d’approbation en tant que réponse dans le thread et vous pouvez approuver les notifications directement à partir d’une application canal/personnelle.

• Une fois le flux de travail terminé, vous obtenez une mise à jour en tant que réponse dans le thread afin de pouvoir terminer le contexte et l’historique de l’exécution du flux de travail.

• En cas d'échec, vous pouvez choisir de réexécuter le workflow sur place et activer les journaux de débogage si nécessaire.

Filtres de notification de flux de travail

Vous pouvez filtrer les notifications de flux de travail à l’aide des options suivantes :

Vous pouvez configurer des filtres de notification de flux de travail au format suivant :

/github subscribe owner/repo workflows:{name:"your workflow name" event:"workflow event" branch:"branch name" actor:"username"}

/github subscribe owner/repo workflows:{name:"your workflow name" event:"workflow event" branch:"branch name" actor:"username"}

Vous pouvez également passer plusieurs valeurs pour chaque filtre, séparées par des virgules. Par exemple:

/github subscribe owner/repo workflows:{name:"your workflow name","another workflow name" event:"workflow event","another workflow event" branch:"branch name","another branch name" actor:"username","another-username"}

/github subscribe owner/repo workflows:{name:"your workflow name","another workflow name" event:"workflow event","another workflow event" branch:"branch name","another branch name" actor:"username","another-username"}

Par défaut, lorsque vous configurez des notifications de workflow sans appliquer de filtres, elles sont configurées pour les workflows déclenchés par des pull requests ciblant votre branche par défaut. Vous pouvez passer une ou plusieurs entrées.

Vous pouvez vous désabonner des notifications de flux de travail à l’aide de la commande : /github unsubscribe owner/repo workflows.

Notifications de déploiement

Vous pouvez également configurer des notifications de déploiement distinctes. Ces déploiements peuvent se produire à partir de GitHub Actions ou à partir de sources externes à l’aide de l’API déploiements. Consultez « Points de terminaison d’API REST pour les déploiements ».

Vous pouvez vous abonner/vous désabonner aux notifications de déploiement à l’aide de la commande : /github subscribe/unsubscribe owner/repo deployments.