Intégrer Azure Pipelines à Microsoft Teams

Azure DevOps Services

Cet article explique comment utiliser l’application Azure Pipelines pour Microsoft Teams pour surveiller les événements de pipeline. Vous pouvez configurer et obtenir des notifications dans votre canal Teams pour les builds, versions et approbations de pipeline. Les approbateurs peuvent également approuver des versions à partir du canal Teams.

Prérequis

• Accès à une équipe dans Microsoft Teams où vous pouvez ajouter une application.
• Autorisations d’administrateur de projet ou d’administrateur de build dans un projet Azure DevOps. Pour plus d’informations, consultez Créer un projet et des ressources de sécurité de pipeline.
• Accès aux applications tierces via OAuth activé dans les paramètres de l’organisation Azure DevOps.

Configurer l’application Azure Pipelines

1. Dans Microsoft Teams, sélectionnez Applications, recherchez Azure Pipelines, puis sélectionnez Azure Pipelines.

   

2. Sélectionnez la flèche déroulante en regard de Ajouter, puis sélectionnez Ajouter à une équipe.

   

3. Sélectionnez ou entrez le nom de votre équipe, puis sélectionnez Configurer un bot.

   

Utiliser des commandes d’application Azure Pipelines

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

Se connecter à Azure Pipelines

1. Dans le volet de conversation Teams, entrez @azurePipelines signin.
2. Sélectionnez Connexion et terminez l’authentification auprès d’Azure Pipelines.

S’abonner aux pipelines

Utilisez les commandes suivantes pour vous abonner et surveiller tous les pipelines d’un projet ou uniquement des pipelines spécifiques.

• Tous les pipelines d’un projet : l’URL peut être vers votre projet ou n’importe quelle page de votre projet, à l’exception d’un pipeline. Par exemple :

  @azure pipelines subscribe https://dev.azure.com/myorg/myproject/
  

• Pipeline spécifique : l’URL du pipeline peut être vers n’importe quelle page d’un pipeline qui a ou definitionId buildId/releaseId dans l’URL. Par exemple :

  @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_build?definitionId=123
  

Développer les notifications liées

Toutes les réponses pour un billet particulier sont liées.

Pour développer le fil de discussion, cliquez sur le lien du fil réduit.

Gérer les abonnements

Lorsque vous vous abonnez à un pipeline, quelques abonnements sont créés par défaut sans filtres appliqués. Ces abonnements incluent l’état d’exécution modifié et l’étape d’exécution en attente d’approbation pour les pipelines YAML et l’approbation du déploiement de mise en production en attente pour les versions classiques. Vous pouvez supprimer ces abonnements ou ajouter d’autres abonnements.

L’application Azure Pipelines prend également en charge les filtres pour personnaliser ce que vous voyez dans votre canal. Par exemple, vous voudriez peut-être être averti uniquement lorsque les builds échouent ou lorsque les déploiements sont envoyés (push) à un environnement de production.

Pour gérer vos abonnements, procédez comme suit.

1. Pour répertorier tous les abonnements pipelines, exécutez la @azure pipelines subscriptions commande.

   

2. Pour supprimer un abonnement, sélectionnez Afficher tous les abonnements. Sélectionnez Supprimer sous n’importe quel abonnement que vous ne souhaitez pas, puis sélectionnez OK.

3. Pour ajouter un abonnement, sélectionnez Ajouter un abonnement.

4. Sélectionnez l’événement et le pipeline auquel vous souhaitez vous abonner, puis sélectionnez Suivant.

5. Choisissez les filtres d’étape et d’environnement souhaités, sélectionnez Envoyer, puis OK.

   Par exemple, l’abonnement suivant fournit des notifications pour l’étape de _default uniquement lorsque l’état Terminé a échoué.

   

Voir les notifications d’approbation

Pour afficher les notifications d’approbation, veillez à vous abonner à l’étape d’exécution en attente de notification d’approbation pour les pipelines YAML ou la notification d’approbation de déploiement de mise en production en attente pour les versions classiques. Ces abonnements sont créés par défaut lorsque vous vous abonnez au pipeline.

Si vous vous abonnez à la notification d’approbation de l’étape d’exécution terminée , vous pouvez également voir quand l’étape est approuvée.

Approuver à partir de votre canal

Si vous êtes approbateur, vous pouvez approuver les déploiements à partir de votre canal Teams. L’application Azure Pipelines prend en charge tous les scénarios de vérification et d’approbation d’Azure Pipelines. Vous pouvez approuver des demandes en tant qu’individu ou pour une équipe.

Chaque fois que l’exécution d’une étape est en attente de votre approbation, l’application publie une carte de notification avec des options d’approbation ou de rejet de la demande dans le canal. Vous pouvez consulter les détails de la demande dans la notification et prendre les mesures appropriées.

La réponse est envoyée à l’application.

Si vous vous êtes abonné aux notifications d’approbation d’étape d’exécution terminées , vous pouvez également voir quand la phase est approuvée.

Se désabonner d’un canal

Exécutez la unsubscribe commande pour supprimer tous les abonnements liés à n’importe quel pipeline dans le projet et supprimer les pipelines du canal. Par exemple :

@azure pipelines unsubscribe all https://dev.azure.com/myorg/myproject

Pour supprimer le projet et tous les abonnements du canal, sélectionnez Continuer.

Utiliser l’extension compose

Pour vous aider à rechercher et partager des informations sur les pipelines, l’application Azure Pipelines pour Teams prend en charge une extension de composition dans les messages. Vous pouvez utiliser l’extension pour rechercher des pipelines dans un projet par ID de pipeline ou par nom de pipeline.

Pour utiliser l’extension, vous devez être connecté au projet Azure Pipelines dans le canal Teams. Sélectionnez le + symbole dans le champ de message, sélectionnez Azure Pipelines, puis recherchez votre pipeline ou votre mise en production.

Aperçu des URL de pipeline

Lorsque vous utilisez l’extension compose pour ajouter une URL de pipeline à un message Teams, vous voyez un aperçu similaire aux images suivantes. La préversion permet de maintenir les conversations liées au pipeline pertinentes et à jour.

L’exemple suivant montre une préversion de l’URL de mise en production :

Connecter plusieurs locataires

Si vous utilisez différentes adresses e-mail ou différents locataire pour Microsoft Teams et Azure DevOps, procédez comme suit pour vous connecter en fonction de vos paramètres.

Résoudre les erreurs d’authentification

Dans le même navigateur, démarrez un nouvel onglet et connectez-vous à https://teams.microsoft.com/. Exécutez la commande @Azure Pipelines signout, puis exécutez la commande @Azure Pipelines signin dans le canal où l’application Azure Pipelines pour Microsoft Teams est installée.

Sélectionnez le bouton Se connecter, puis terminez le processus de connexion. Vérifiez que le répertoire affiché est le même que celui que vous avez choisi à l’étape précédente.

Si ces étapes ne résolvent pas votre problème d’authentification, contactez la Communauté des développeurs.

Articles connexes

• Utiliser Azure Boards avec Microsoft Teams
• Utiliser Azure Repos avec Microsoft Teams