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 :

Prérequis

• Gérez votre abonnement, de sorte que vous recevez des notifications dans votre canal chaque fois que le code est envoyé ou archivé, ou lorsqu’une demande de tirage est créée, mise à jour ou fusionnée. Pour créer des abonnements pour les événements liés au référentiel, vous devez être membre du groupe Administrateurs du projet ou d’un administrateur d’équipe. Pour être ajouté, consultez Modifier les autorisations au niveau du projet ou Ajouter un administrateur d’équipe.
• Pour recevoir des notifications, activez l’accès à l’application tierce via le paramètre OAuth pour l’organisation Azure DevOps. Consultez Modifier les stratégies d’accès aux applications pour votre organisation.

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

   

   

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é .

   

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

   

5. Choisissez un référentiel, 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 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.

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.

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 notifications

Vue développée des notifications

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.

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.

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.
• La configuration a échoué. Vérifiez que l’organisation « {nom organisation} » existe et que vous disposez des autorisations suffisantes.

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.

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.

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.

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