Configuration de Slack

Slack est un système de messagerie et de notification en temps réel, basé sur le cloud.

Vous pouvez désormais distribuer des notifications d'événements en utilisant l'intégration de l'outil Event Notifications. IBM Cloud® Event Notifications est la méthode préférée pour distribuer des notifications à Slack et à d'autres canaux de communication tels que PagerDuty, email, SMS, notifications push, webhook, Microsoft® Teams, ServiceNow, et IBM Cloud Functions. Pour plus d'informations sur l'utilisation de Event Notifications, voir Activation des notifications d'événements pour les chaînes d'outils.

Les événements de chaîne d'outils personnalisés client générés par l'API POST /toolchains/{toolchain_id}/events ne sont pas envoyés à l'intégration d'outils Slack. Les événements de chaîne d'outils sur mesure sont envoyés uniquement à IBM Cloud® Event Notifications.

Slack fournit un système de discussion permanente, alternative plus interactive au courrier électronique pour la collaboration des équipes. Vous pouvez communiquer avec votre équipe sur un canal dédié ou sur un ensemble de canaux directement liés à votre travail. Vous pouvez également partager des fichiers et des images via ces canaux, ou dans des messages directs entre deux personnes ou plus. Les communications dans les messages directs ou sur les canaux sont conservées pour que vous puissiez y faire des recherches.

Les notifications publiées sur les canaux Slack publics sont visibles par tous les membre de l'équipe. Vous êtes responsable du contenu que vous publiez.

Configurez Slack pour la réception de notifications concernant votre chaîne d'outils depuis les intégrations d'outils, par exemple les activités de test et de déploiement :

Si vous configurez cette intégration d'outils lorsque vous créez la chaîne d'outils, à la section Intégrations configurables, cliquez sur Slack.
Si vous avez une chaîne d'outils et que vous y ajoutez cette intégration d'outils, à partir de la console IBM Cloud, cliquez sur l' Menu > Automatisation de la plateforme > Chaînes d'outils. Sur la page Chaînes d'outils, cliquez sur la chaîne d'outils afin d'ouvrir sa page Vue d'ensemble. Vous pouvez également, depuis votre page de présentation de l'application, sur la carte Distribution continue, cliquer sur Afficher la chaîne d'outils. Ensuite, cliquez sur Vue d'ensemble.

a. Cliquez sur Ajouter un outil.

b. Dans la section Intégrations d'outils, cliquez sur Slack.
Entrez l'URL de webhook Slack, qui est générée par Slack en tant que webhook entrant. Vous avez besoin d'une URL de webhook Slack pour un canal Slack afin de recevoir des notifications concernant votre chaîne d'outils depuis les intégrations d'outils. Pour savoir comment créer ou trouver votre webhook, reportez-vous à la section Webhooks entrants.

Si vous utilisez une clé d'API pour que votre canal Slack reçoive des notifications sur votre chaîne d'outils depuis les intégrations d'outils, vous devez mettre à jour votre configuration pour utiliser un webhook à la place.

Entrez le nom du canal Slack sur lequel vous souhaitez recevoir les notifications. La chaîne doit exister et être active dans votre équipe Slack.
Saisissez le nom d'hôte d'URL pour votre équipe Slack, qui est le mot ou l'expression avant .slack.com dans l'URL de votre équipe. Par exemple, si l'URL de votre équipe est https://team.slack.com, le nom d'hôte est team.
Cliquez sur Créer une intégration.

Si le canal Slack et l'équipe que vous avez spécifiés ne sont pas accessibles, l'erreur Setup Failed s'affiche sur la carte Slack. Survolez le message Setup Failed et cliquez sur Reconfigurer. Assurez-vous que vous utilisez des paramètres de configuration valides pour l'URL de webhook Slack, le canal Slack et le nom d'hôte d'URL de votre équipe Slack. Mettez à jour les paramètres si nécessaire et cliquez sur Sauvegarder l'intégration.
Sur la page Présentation de la chaîne d'outils, sur la carte Outils tiers, cliquez sur Slack. Vous pouvez afficher toutes les activités de votre chaîne d'outils dans le canal Slack configuré.

Configurer Slack en utilisant l'API

L'intégration d'outils Slack prend en charge les paramètres de configuration suivants que vous pouvez utiliser avec l'API HTTP de chaîne d'outils et les SDK lorsque vous créez, lisezet mettez à jour les intégrations d'outils.

Vous devez spécifier la propriété tool_type_id dans le corps de la demande avec la valeur slack.

Paramètres d'intégration de l'outil Slack
Paramètre	Utilisation	Type	Argument Terraform	Description
jeton_API	requis, pouvant être mis à jour	Mot de passe	webhook	Webhook entrant utilisé par Slack pour recevoir des événements. Vous pouvez utiliser une référence de secrets de chaîne d'outils pour ce paramètre. Pour plus d'informations sur les références de secrets, voir Protection de vos données sensibles dans IBM Cloud.
channel_name	requis, pouvant être mis à jour	Chaîne	channel_name	Le canal Slack sur lequel les notifications doivent être envoyées.
pipeline_fail	facultatif, pouvant être mis à jour, `Default: true`	Booléen	pipeline_fail	Génère des notifications `pipeline failed`.
pipeline_start	facultatif, pouvant être mis à jour, `Default: true`	Booléen	pipeline_start	Génère des notifications `pipeline start`.
pipeline_success	facultatif, pouvant être mis à jour, `Default: true`	Booléen	pipeline_success	Génère des notifications `pipeline succeeded`.
url_équipe	facultatif, pouvant être mis à jour	Chaîne	nom_équipe	Nom de l'équipe Slack, qui correspond au mot ou à la phrase précédant .slack.com dans l'URL de l'équipe.
toolchain_bind	facultatif, pouvant être mis à jour, `Default: true`	Booléen	toolchain_bind	Génère des notifications `tool added to toolchain`.
toolchain_unbind	facultatif, pouvant être mis à jour, `Default: true`	Booléen	toolchain_unbind	Génère des notifications `tool removed from toolchain`.

Activation des notifications Slack pour les pipelines Tekton

Vous pouvez configurer un pipeline Tekton pour envoyer des événements aux intégrations Slack.

Dans la page Aperçu de votre chaîne d'outils, sur la carte Pipelines de livraison, cliquez sur Delivery Pipeline pour ouvrir le tableau de bord Delivery Pipeline Tekton.
Dans la page Paramètres > Paramètres avancés, activez Event Notifications.
Sauvegardez vos modifications.