Partage via


Utiliser Azure Repos avec Microsoft Teams

Azure DevOps Services

Si vous utilisez Microsoft Teams et Azure Repos, vous pouvez utiliser l’application Azure Repos pour Teams pour surveiller vos référentiels. L’application prend en charge la surveillance des référentiels Git et Team Foundation Version Control (TFVC), mais elle ne prend pas en charge l’intégration avec les référentiels GitHub.

Cet article vous montre comment effectuer les tâches suivantes :

  • Ajouter l’application Azure Repos à votre équipe dans Microsoft Teams
  • Connecter l’application Azure Repos à vos référentiels
  • Gérer les abonnements pour les événements liés au référentiel dans votre canal
  • Rechercher et partager des informations de demande de tirage à l’aide de l’extension compose
  • URL de demande de tirage en préversion
  • Supprimer les abonnements et les référentiels d’un canal

Prérequis

Notes

  • Les notifications ne sont actuellement pas prises en charge dans les messages directs.
  • Vous ne pouvez lier l’application Azure Repos pour Microsoft Teams qu’à un projet hébergé sur Azure DevOps Services.

Ajouter l’application Azure Repos à une équipe dans Microsoft Teams

  1. Accédez à l’application Azure Repos dans Microsoft Teams, Microsoft Teams > Azure Repos.

  2. Sélectionnez Ajouter ou si vous avez déjà téléchargé l’application, sélectionnez le menu déroulant en regard de Ouvrir, puis sélectionnez Ajouter à une équipe.

  3. Entrez un nom d’équipe ou de canal, puis sélectionnez Configurer un bot.

    Capture d’écran du message d’accueil d’Azure Repos dans Teams.

Connecter l’application Azure Repos à vos référentiels

  1. Une fois l’application installée dans votre équipe, entrez le texte suivant dans le champ de réponse : @azure repos signin

    Si vos clients Microsoft Teams et Azure Boards se trouvent dans différents locataires, sélectionnez Se connecter avec un e-maildifférent.

    Capture d’écran montrant l’entrée de connexion Teams pour Azure Repos.

    Capture d’écran montrant la réponse complète de connexion.

  2. Pour surveiller tous les référentiels Git dans un projet, entrez @azure repos subscribe [project url] dans le canal. Veillez à ajouter l’URL de votre projet. L’URL du projet peut être vers n’importe quelle page de votre projet (à l’exception des URL de référentiel).

    Vous pouvez également surveiller un référentiel spécifique à l’aide de : @azure repos subscribe [repo url].

    L’URL du référentiel peut être vers n’importe quelle page de votre référentiel qui a le nom de votre référentiel, par exemple @azure repos subscribe https://dev.azure.com/myorg/myproject/_git/myrepo, ou pour les dépôts TFVC : @azure repos subscribe https://dev.azure.com/myorg/myproject/_versionControl.

  3. La subscribe commande commence par un abonnement par défaut. Pour les référentiels Git, le canal est abonné à l’événement créé par demande de tirage (avec la branche cible = primaire). Pour les référentiels TFVC, le canal est abonné à l’événement Code archivé .

    Capture d’écran montrant le message de création d’abonnements par défaut.

Gérer les abonnements

Pour afficher, ajouter et supprimer des abonnements pour un canal, entrez le texte suivant : @azure repos subscriptions.

Vous voyez une liste de tous les abonnements actuels pour le canal et vous pouvez ajouter de nouveaux abonnements ou supprimer des abonnements existants. Personnalisez vos notifications avec différents filtres, comme décrit dans la section suivante.

Notes

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

Voir les abonnements

Utiliser des filtres pour obtenir uniquement les notifications souhaitées

Lorsque vous vous abonnez à un référentiel avec @azure repos subscribe, un abonnement par défaut est créé sans filtre appliqué. Souvent, les utilisateurs doivent personnaliser ces abonnements pour être avertis uniquement lorsque certaines conditions sont remplies. Les captures d’écran suivantes montrent un exemple de configuration des notifications uniquement lorsque notre équipe se trouve dans la liste des réviseurs pour une demande de tirage.

  1. Entrez le texte suivant dans votre canal : @azure repos subscriptions.

  2. Dans la liste des abonnements, s’il existe un abonnement que vous ne souhaitez pas ou doit être modifié, sélectionnez Supprimer pour le supprimer.

  3. Sélectionnez le bouton Ajouter un abonnement.

  4. Choisissez un type d’événement, puis sélectionnez Suivant.

    Capture d’écran montrant la sélection du type d’événement.

  5. Choisissez un référentiel, puis sélectionnez Suivant.

    Capture d’écran montrant la sélection du référentiel.

  6. Sélectionnez les filtres appropriés pour personnaliser votre abonnement, puis sélectionnez Envoyer.

    Capture d’écran montrant les filtres choisis.

Notes

  • Tous les filtres sont généralement des listes déroulantes. Toutefois, si la liste déroulante a plus de 100 éléments, vous devez entrer manuellement les valeurs.
  • Pour l’événement Code vérifié de TFVC, le filtre Sous le chemin doit être au format $/myproject/path.

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

Pour aider les utilisateurs à rechercher et partager des informations sur les demandes de tirage, l’application Azure Repos pour Microsoft Teams prend en charge une extension compose. Vous pouvez rechercher des demandes de tirage par ID ou par nom. Pour que l’extension fonctionne, connectez-vous au projet Azure Repos en entrant @azure repos signin ou en vous connectant directement à l’extension compose.

Capture d’écran montrant l’extension compose.

URL de demande de tirage en préversion

Lorsque vous collez l’URL d’une demande de tirage, un aperçu s’affiche comme celui de l’image suivante, ce qui permet de conserver les conversations liées aux demandes de tirage contextuelles et précises. Vous devez être connecté, puis vous pouvez afficher un aperçu des demandes de tirage pour les URL dans tous les canaux d’une équipe.

Capture d’écran montrant le déploiement d’URL.

Supprimer les abonnements et les référentiels d’un canal

Pour supprimer tous les abonnements liés à n’importe quel référentiel dans le projet et supprimer les référentiels du canal, entrez le texte suivant dans Teams : @azure repos unsubscribe all [project url]. Veillez à entrer l’URL du projet. Seuls les administrateurs de projet peuvent effectuer cette tâche.

Notifications threaded

Pour lier un ensemble de notifications associées et pour réduire également l’espace occupé par les notifications dans un canal, les notifications sont threaded. Toutes les notifications liées à une demande de tirage particulière sont liées.

Affichage compact des notificationsthreaded Capture d’écran montrant l’affichage compact des notifications threaded.

Vue développée des notificationsthreaded Capture d’écran montrant l’affichage développé des notifications threaded.

Informations de référence sur les commandes

Le tableau suivant répertorie toutes les azure repos commandes que vous pouvez utiliser dans votre canal Teams.

Commande Fonctionnalités
@azure repos subscribe [repo url/ project url] S’abonner à un référentiel ou à tous les référentiels d’un projet pour recevoir des notifications
@azure repos subscriptions Ajouter ou supprimer des abonnements pour ce canal
@azure repos signin Connectez-vous à votre organisation Azure Repos
@azure repos signout Déconnectez-vous de votre organisation Azure Repos
@azure repos feedback Signaler un problème ou suggérer une fonctionnalité
@azure repos unsubscribe all [project url] Supprimer tous les référentiels (appartenant à un projet) et leurs abonnements associés d’un canal

Assistance multi-locataire

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 messagerie + locataire Microsoft Teams ID de messagerie + locataire Azure DevOps Étapes
1 email1@abc.com (locataire 1) email1@abc.com (locataire 1) Sélectionnez Connexion.
2 email1@abc.com (locataire 1) email1@abc.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 commande de connexion et sélectionnez Se connecter.
3 email1@abc.com (locataire 1) email2@pqr.com (locataire 2) Sélectionnez Se connecter avec une autre adressee-mail, puis dans le sélecteur d’ID de messagerie, utilisez l’adresse e-mail2 pour vous connecter à Azure DevOps.
4 email1@abc.com (locataire 1) email2@pqr.com (locataire non par défaut 3) Ce scénario n’est pas pris en charge.

Dépanner

Si vous rencontrez les erreurs suivantes lors de l’utilisation de l’application Azure Repos, suivez les procédures décrites dans cette section.

Désolé, une erreur s’est produite. Recommencez.

L’application Azure Repos utilise le protocole d’authentification OAuth et nécessite l’accès aux applications tierces via OAuth pour que l’organisation soit activée. Pour activer ce paramètre, accédez à Paramètres de l’organisation Stratégies>>de sécurité et définissez l’accès aux applications tierces via OAuth pour le paramètre organisationsur Activée.

Activer l’accès à l’application tierce via OAuth pour le paramètre de l’organisation

La configuration a échoué. Vérifiez que l’organisation « {nom organisation} » existe et que vous disposez des autorisations suffisantes.

Déconnectez-vous d’Azure DevOps en accédant à l’aide https://aka.ms/VsSignout de votre navigateur.

Ouvrez une fenêtre de navigateur Dans privé ou incognito, accédez à https://aex.dev.azure.com/me et connectez-vous. Dans la liste déroulante sous l’icône de profil à gauche, sélectionnez le répertoire qui contient l’organisation contenant le référentiels auquel vous souhaitez vous abonner.

Sélectionnez le répertoire qui contient l’organisation qui contient le projet

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

Sélectionnez le Sign in bouton et vous êtes 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 qui a été choisi à l’étape précédente. Acceptez et terminez le processus de connexion.

Consentement aux autorisations d’application demandées

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