Partager via

Utiliser Azure Pipelines avec Slack

Azure DevOps Services

Cet article vous montre comment utiliser l’application Azure Pipelines pour Slack pour surveiller vos événements de pipeline. Vous pouvez établir et gérer des abonnements pour les événements de pipeline tels que les builds, les versions et les approbations en attente. Les notifications pour ces événements sont envoyées directement à vos canaux Slack.

Remarque

Cette fonctionnalité est disponible uniquement sur Azure DevOps Services. En règle générale, les nouvelles fonctionnalités sont introduites dans le service cloud en premier, puis mises à disposition localement dans la prochaine version principale ou mise à jour d’Azure DevOps Server. Pour plus d’informations, consultez Chronologie des fonctionnalités Azure DevOps.

Prérequis

  • Un compte Slack disposant de l’autorisation d’installer une application sur votre espace de travail Slack.
  • Un projet Azure DevOps avec des autorisations Administrateurs de collection de projets ou Administrateurs de projet.
  • Ne doit pas être un utilisateur externe dans Microsoft Entra.

Installer l’application Azure Pipelines

Installez l’application Azure Pipelines Slack sur votre espace de travail Slack. Une fois l’application installée, le message de bienvenue suivant s’affiche. Entrez /azpipelines pour commencer à interagir avec l’application.

Une capture d’écran montrant le message de bienvenue de l’application Azure Pipelines.

Connexion à votre pipeline

Une fois l’application installée dans votre espace de travail Slack, vous pouvez connecter l’application à n’importe quel pipeline que vous souhaitez surveiller. Vous devez vous authentifier auprès d’Azure Pipelines avant d’exécuter des commandes.

Une capture d’écran montrant le message d’invite de connexion.

Remarque

Si votre organisation Azure DevOps est connectée à un locataire Microsoft Entra ID, vous devez vous connecter avec un membre natif de ce locataire. Les utilisateurs externes reçoivent l’erreur suivante s’ils tentent de se connecter à l’application Azure Pipelines : Configuration failed. Please make sure that the organization exists and that you have sufficient permissions.

S’abonner aux pipelines

Pour commencer à surveiller tous les pipelines d’un projet, entrez /azpipelines subscribe <project url> un canal, en <project url> remplaçant par votre URL de projet Azure DevOps. L’URL du projet peut créer un lien vers n’importe quelle page de votre projet, à l’exception des pages de pipeline, par exemple /azpipelines subscribe https://dev.azure.com/myorg/myproject/.

Vous pouvez surveiller un pipeline spécifique à l’aide /azpipelines subscribe <pipeline url>de . L'URL du pipeline peut lier à n'importe quelle page au sein de votre pipeline dont l'URL contient definitionId ou buildId/releaseId. Par exemple :

  • /azpipelines subscribe https://dev.azure.com/myorg/myproject/_build?definitionId=123
  • /azpipelines subscribe https://dev.azure.com/myorg/myproject/_release?definitionId=123&view=mine&_a=releases

La subscribe commande vous abonne aux notifications suivantes par défaut :

  • Pour les pipelines YAML :
    • État de l’étape d’exécution modifié
    • Étape d’exécution en attente d’approbation
  • Pour les pipelines de build classiques, les builds sont terminées
  • Pour les pipelines de mise en production classiques :
    • Démarrage du déploiement de mise en production
    • Déploiement de mise en production terminé
    • Approbation du déploiement de mise en production en attente

Une capture d’écran montrant l’exemple de notification.

Gérer les abonnements

Pour gérer les abonnements d’un canal, entrez /azpipelines subscriptions. Cette commande répertorie tous les abonnements actuels pour le canal et vous permet d’ajouter ou de supprimer des abonnements.

Une capture d’écran montrant une liste d’abonnements.

Remarque

Les administrateurs d’équipe ne peuvent pas supprimer ou modifier les abonnements créés par les administrateurs de projet.

Personnaliser les abonnements

Les abonnements par défaut n’ont pas de filtres appliqués, mais vous pouvez personnaliser ces abonnements en fonction de vos préférences. Par exemple, vous pouvez recevoir des notifications uniquement pour les builds ou les déploiements ayant échoué en production. Vous pouvez appliquer des filtres pour personnaliser les messages que vous recevez dans votre canal.

Pour personnaliser un abonnement :

  1. Exécutez la commande /azpipelines subscriptions pour répertorier tous vos abonnements.
  2. Sélectionnez Ajouter un abonnement.
  3. Sélectionnez l’événement auquel vous souhaitez vous abonner, puis sélectionnez votre configuration souhaitée.
  4. Cliquez sur Enregistrer.

Par exemple, pour obtenir des notifications uniquement pour les builds ayant échoué, sélectionnez Échec sous état de build.

Capture d’écran montrant comment personnaliser un abonnement.

Approuver des déploiements

Vous pouvez approuver les déploiements à partir de votre canal Slack sans accéder à Azure Pipelines. Abonnez-vous à l’étape d’exécution en attente des notifications d’approbation pour les pipelines YAML ou l’approbation de déploiement de mise en production en attente de notifications pour les versions classiques. Ces deux abonnements sont créés par défaut lorsque vous vous abonnez à un pipeline.

Une capture d’écran montrant l’approbation du pipeline dans Slack.

L’application Azure Pipelines pour Slack vous permet de gérer tous les scénarios de vérification et d’approbation disponibles dans le portail Azure Pipelines. Ces scénarios incluent un approbateur unique, plusieurs approbateurs et une approbation basée sur l’équipe. Vous pouvez approuver des demandes individuellement ou au nom d’une équipe.

Une capture d’écran montrant un pipeline de prédéploiement approuvé dans Slack.

Supprimer tous les abonnements

Pour déséclérer votre canal, vous pouvez utiliser la /azpipelines unsubscribe all <project url> commande pour vous désabonner de tous les pipelines d’un projet. Par exemple : /azpipelines unsubscribe all https://dev.azure.com/myorg/myproject.

Important

Seuls les administrateurs de projet peuvent exécuter cette commande.

Informations de référence sur les commandes

L’application Azure Pipelines pour Slack prend en charge les commandes suivantes :

Commande Description
/azpipelines subscribe <pipeline url or project url> S’abonner à un pipeline ou à tous les pipelines d’un projet et recevoir des notifications.
/azpipelines subscriptions Ajouter ou supprimer des abonnements pour ce canal.
/azpipelines feedback Signaler un problème ou suggérer une fonctionnalité.
/azpipelines help Obtenir de l’aide sur les commandes.
/azpipelines signin Connectez-vous à votre compte Azure Pipelines.
/azpipelines signout Déconnectez-vous de votre compte Azure Pipelines.
/azpipelines unsubscribe all <project url> Supprimez tous les pipelines de projet et leurs abonnements associés d’un canal.

Notifications dans les canaux privés

L’application Azure Pipelines peut également vous aider à surveiller l’activité des pipelines dans vos canaux privés. Vous devez inviter le bot à votre canal privé à l’aide /invite @azpipelinesde . Une fois que vous avez ajouté le bot, vous pouvez configurer et contrôler vos notifications de la même façon que pour un canal public.

Dépannage

Si vous obtenez les erreurs suivantes lors de l’utilisation de l’application Azure Pipelines pour Slack, essayez la procédure suivante.

La configuration a échoué. Assurez-vous que l’organisation existe et que vous disposez des autorisations suffisantes.

Si vous voyez cette erreur, vous êtes probablement un utilisateur invité dans le locataire Microsoft Entra connecté à votre organisation Azure DevOps. Vous devez disposer d’un membre Microsoft Entra pour suivre les étapes de configuration.

  • Last updated on