Utiliser Azure Pipelines avec Microsoft Teams

Azure DevOps Services

L’application Azure Pipelines pour Microsoft Teams vous permet de surveiller les événements de vos pipelines. Vous pouvez configurer et recevoir des notifications dans votre canal Teams pour les versions, les approbations en attente, les builds terminées, et ainsi de suite. Vous pouvez également approuver des versions à partir de votre canal Teams.

Notes

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

• Vous devez avoir un projet Azure DevOps. Pour plus d’informations, consultez Créer un projet.
• Pour configurer des abonnements de pipeline, vous devez être Administrateur de Projet.

Configurer l’application Azure Pipelines

1. Dans Microsoft Teams, accédez au magasin Applications , recherchez Azure Pipelines, puis sélectionnez Azure Pipelines.

   

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

   

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

   

4. Dans le volet de conversation Teams, entrez @azurePipelines signin.

5. Sélectionnez Connexion et terminez l’authentification auprès d’Azure Pipelines.

Utiliser des commandes

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

• Surveillez tous les pipelines d’un projet. L’URL peut être vers n’importe quelle page de votre projet, à l’exception des URL des pipelines. Par exemple : @azure pipelines subscribe https://dev.azure.com/myorg/myproject/.

  @azure pipelines subscribe [project url]
  

• Surveillez un pipeline spécifique : l’URL du pipeline peut être vers n’importe quelle page de votre pipeline qui a une definitionId ou buildId/releaseId présente dans l’URL. Par exemple : @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_build?definitionId=123.

  @azure pipelines subscribe [pipeline url]
  

  Un autre exemple de pipeline de mise en production abonné au déploiement de la mise en production a démarré, au déploiement de mise en production terminé et à l’approbation du déploiement de mise en production en attente de notifications est @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_release?definitionId=123&view=mine&_a=releases.

Notes

• Nous ne prenons pas en charge les approbations de déploiement qui ont appliqué Revalider l’identité de l’approbateur avant de terminer la stratégie d’approbation .
• Activez « l’accès aux applications tierces via OAuth » afin de recevoir des notifications pour l’organisation dans Azure DevOps.

Gérer les abonnements

Lorsque vous vous abonnez à un pipeline, quelques abonnements sont créés par défaut sans filtres appliqués. Vous souhaiterez peut-être personnaliser ces abonnements. 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. L’application Azure Pipelines prend en charge les filtres pour personnaliser ce que vous voyez dans votre canal. Pour gérer vos abonnements, procédez comme suit.

1. Exécutez la commande @azure pipelines subscriptions.

2. Sélectionnez Afficher tous les abonnements. Dans la liste des abonnements, s’il existe un abonnement que vous ne désirez pas, sélectionnez Supprimer.

3. Faites défiler vers le bas et sélectionnez Ajouter un abonnement.

4. Sélectionnez le pipeline et l’événement requis.

5. Sélectionnez les filtres appropriés, puis Enregistrer.

   Exemple 1 : obtenir des notifications pour les builds ayant échoué.

   

   Exemple 2 : Recevez des notifications uniquement si les déploiements sont envoyés (push) à l’environnement de production.

   

   Notes

   • Les administrateurs d’équipe ne peuvent pas supprimer ou modifier les abonnements créés par les administrateurs de projet.
   • Les notifications ne sont pas prises en charge dans les messages de conversation/direct.

Approuver les déploiements à partir de votre canal

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

Chaque fois que l’exécution d’une étape est en attente d’approbation, une carte de notification avec des options d’approbation ou de rejet de la requête est publiée dans le canal. Les approbateurs peuvent consulter les détails de la requête dans la notification et prendre les mesures appropriées. Dans l’exemple suivant, le déploiement a été approuvé et l’état d’approbation s’affiche sur la carte.

L’application Azure Pipelines prend en charge tous les scénarios de vérification et d’approbation présents dans le portail Azure Pipelines. Vous pouvez approuver des demandes en tant qu’individu ou pour une équipe.

Rechercher et partager des informations de pipeline à l’aide de l’extension compose

Pour aider les utilisateurs à rechercher et partager des informations sur les pipelines, l’application Azure Pipelines pour Microsoft Teams prend en charge l’extension compose. Vous pouvez maintenant rechercher des pipelines par ID de pipeline ou par nom de pipeline. Pour que l’extension compose fonctionne, les utilisateurs doivent se connecter au projet Azure Pipelines qui les intéresse en exécutant la commande @azure pipelines signin ou en se connectant directement à l’extension compose.

Préversion des URL de pipeline

Lorsque vous ajoutez une URL de pipeline à Teams, vous voyez une préversion similaire aux images suivantes. La préversion permet de maintenir les conversations liées au pipeline pertinentes et à jour. Vous pouvez choisir entre les cartes compactes et développées.

Exemple 1 : préversion de l’URL de build

Exemple 2 : préversion de l’URL de mise en production

Une fois que vous êtes connecté, cette fonctionnalité fonctionne pour tous les canaux d’une équipe dans Microsoft Teams.

Se désabonner d’un canal de pipeline

Utilisez la commande suivante pour vous désabonner de tous les pipelines au sein d’un projet.

@azure pipelines unsubscribe all [project url]

Exemple : désabonner tout avec l’URL

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

Cette commande supprime tous les abonnements liés à n’importe quel pipeline dans le projet et supprime les pipelines du canal.

Important

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

Liez vos notifications

Toutes les notifications liées à une exécution particulière d’un pipeline sont liées entre elles.

Exemple 1 : affichage compact des notifications liées.

Exemple 2 : vue développée des notifications liées.

Utiliser des commandes dans l’application Azure Pipelines

Consultez les commandes suivantes prises en charge par l’application Azure Pipelines :

Commande barre oblique	Fonctionnalités
@azure pipelines subscribe [URL de pipeline/URL du projet]	S’abonner à un pipeline ou à tous les pipelines d’un projet pour recevoir des notifications
abonnements pipelines @azure	Ajouter ou supprimer des abonnements pour ce canal
@azure commentaires sur les pipelines	Signaler un problème ou suggérer une fonctionnalité
@azure aide sur les pipelines	Obtenir de l’aide sur les commandes de barre oblique
@azure connexion aux pipelines	Connectez-vous à votre compte Azure Pipelines
@azure déconnexion des pipelines	Déconnectez-vous de votre compte Azure Pipelines
@azure les pipelines se désabonnent de toutes les [URL du projet]	Supprimer tous les pipelines (appartenant à un projet) et leurs abonnements associés d’un canal

Connecter des locataires multiples

Si vous utilisez un autre e-mail ou locataire pour Microsoft Teams et Azure DevOps, procédez comme suit pour vous connecter en fonction de votre cas d’usage.

Cas d’usage	ID de l’Email et locataire dans Microsoft Teams	ID de l’Email et locataire dans Azure DevOps	Action de connexion
1	email1@abc.com (locataire 1)	email1@abc.com (locataire 1)	Sélectionnez Se connecter.
2	email1@abc.com (locataire 1)	email2@pqr.com (locataire 2)	- Connectez-vous à Azure DevOps. - Dans le même navigateur, démarrez un nouvel onglet et accédez à https://teams.microsoft.com/. - Exécutez la sign in commande et sélectionnez Se connecter.
3	email1@abc.com (locataire 1)	email2@pqr.com (locataire 2)	- Sélectionnez Se connecter avec une adresse e-mail différente. - Dans le sélecteur d’ID d’e-mail, utilisez l’adresse e-mail2 pour vous connecter.
4	email1@abc.com (locataire 1)	email2@pqr.com (locataire non par défaut 3)	Non prise en charge.

Dépanner

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 Sign in et vous serez redirigé vers une page de consentement comme celle de l’exemple suivant. Vérifiez que le répertoire affiché à côté de l’e-mail est identique à ce que vous avez choisi à l’étape précédente. Acceptez et terminez le processus de connexion.

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

Articles connexes

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