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 :
- Ajouter l’application Azure Repos à votre équipe dans Microsoft Teams
- Connecter l’application Azure Repos à vos dépôts
- Gérer les abonnements pour les événements liés au dépôt dans votre canal
- Recherchez et partagez des informations de PR en utilisant l’extension compose
- URL de demande de tirage en préversion
- Supprimer les abonnements et les dépôts d’un canal
Conditions préalables
- Gérez votre abonnement afin de recevoir des notifications dans votre canal chaque fois que du code est envoyé (push) ou validé, ou lorsqu'un pull request est créé, mis à jour ou fusionné. Pour créer des abonnements pour les événements liés au dépôt, vous devez être membre du groupe Administrateurs de projet ou administrateur d'équipe. Pour être ajouté, consultez Modifier les autorisations au niveau du projet ou Ajouter un administrateur d’équipe.
- Pour recevoir des notifications, vous devez activer le paramètre Accès aux applications tierces via OAuth pour l’organisation Azure DevOps. Consultez Modifier les stratégies d’accès aux applications pour votre organisation.
Remarque
- 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
Accédez à l’application Azure Repos dans Microsoft Teams, Microsoft Teams > Azure Repos.
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.
Entrez un nom d’équipe ou de canal, puis sélectionnez Configurer un bot.
Connecter l’application Azure Repos à vos dépôts
Une fois l’application installée dans votre équipe, entrez le texte suivant dans le champ de réponse :
@azure repos signinSi vos clients Microsoft Teams et Azure Boards se trouvent dans différents locataires, sélectionnez Se connecter avec une autre adresse e-mail.
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.La commande
subscribevous 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.
Remarque
Les administrateurs d’équipe ne peuvent pas supprimer ou modifier les abonnements créés par les administrateurs de projet.
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.
Entrez le texte suivant dans votre canal :
@azure repos subscriptions.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.
Sélectionnez le bouton Ajouter un abonnement.
Choisissez un type d’événement, puis sélectionnez Suivant.
Choisissez un dépôt, puis sélectionnez Suivant.
Sélectionnez les filtres appropriés pour personnaliser votre abonnement, puis sélectionnez Envoyer.
Remarque
- 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 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.
| Commande | Fonctionnalité |
|---|---|
@azure repos subscribe [repo url/ project url] |
S’abonner à un référentiel ou à tous les dépôts 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 |
Se déconnecter 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 dépôts (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'utilisation | ID Email + locataire Microsoft Teams | ID de messagerie + tenant 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 différentes adresses e-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é, quelque chose s’est passé. Réessayez.
- Échec de la configuration. Vérifiez que l’organisation « {nom de l’organisation} » existe et que vous disposez d’autorisations suffisantes.
Désolé, quelque chose s’est passé. Réessayez.
L’application Azure Repos utilise le protocole d’authentification OAuth et nécessite accès à une application tierce 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.
É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.
Sélectionnez le bouton Sign in 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.
Si ces étapes ne résolvent pas votre problème d’authentification, contactez-nous à Communauté des développeurs.