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 dépôts. L’application prend en charge la surveillance des dépôts Git et Team Foundation Version Control (TFVC), mais elle ne prend pas en charge l’intégration avec les dépôts GitHub.

Dans cet article, découvrez comment effectuer les tâches suivantes :

Conditions préalables

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.

   

Connecter l’application Azure Repos à vos dépôts

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 une autre adresse e-mail.

   

   

2. Pour surveiller tous les dépôts Git dans un projet, saisissez @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 à repos).

   Vous pouvez également surveiller un dépôt spécifique à l’aide de : @azure repos subscribe [repo url].

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

3. La commande subscribe vous permet de commencer avec un abonnement par défaut. Pour les dépôts Git, le canal est abonné à l’événement Demande de tirage créée (branche cible = branche principale). Pour les dépôts TFVC, le canal est abonné à l'événement Code enregistré dans.

   capture d’écran

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.

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 figure sur 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.

   

5. Choisissez un dépôt, puis sélectionnez Suivant.

   

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

   

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

Pour aider les utilisateurs à rechercher et partager des informations sur les pull requests, l’application Azure Repos pour Microsoft Teams prend en charge une fonctionnalité de composition. Vous pouvez rechercher des pull requests 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.

Prévisualiser les URLs de pull request

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. Connectez-vous pour voir un aperçu des PRs pour les URL dans tous les canaux d'une équipe.

Supprimer les abonnements et les dépôts d’un canal

Pour supprimer tous les abonnements liés à n’importe quel dépôt dans le projet et supprimer les dépôts 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 groupées

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 threadées. Toutes les notifications liées à un pull request particulier sont connectées.

Vue compacte des notifications enfilées

vue développée des notifications threadées

Référence de commande

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

Prise en charge 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.

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.

Échec de la configuration. Vérifiez que l’organisation « {nom de l’organisation} » existe et que vous disposez d’autorisations suffisantes.

Déconnectez-vous d’Azure DevOps en accédant à https://aka.ms/VsSignout à l’aide 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érentiel auquel vous souhaitez vous abonner.

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

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

Articles connexes

• Azure Boards avec Teams
• Azure Pipelines avec Teams