Partage via

Azure Repos avec Slack

  • Article

Azure DevOps Services

Si vous utilisez Slack, vous pouvez utiliser l’application Azure Repos pour Slack afin de surveiller facilement vos référentiels Azure Repos. Configurez et gérez des abonnements pour recevoir des notifications dans votre canal chaque fois que du code est envoyé ou archivé et qu’une demande de tirage (PR) est créée, mise à jour ou fusionnée. Cette application prend en charge les événements Git et Team Foundation Version Control (TFVC).

Prérequis

Remarque

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

Ajouter l’application Azure Repos à votre espace de travail Slack

  1. Accédez à l’application Azure Repos Slack et sélectionnez Ajouter à Slack.

    Capture d’écran du répertoire de l’application Slack, d’Azure Repos et du bouton Ajouter à Slack.

    Une fois ajoutée, vous recevez un message de bienvenue semblable à celui ci-dessous.

    Capture d’écran du message de bienvenue de Slack.

  2. Utilisez le /azrepos handle Slack pour interagir avec l’application. La liste complète des commandes est fournie dans la section Informations de référence sur les commandes de cet article.

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

  1. Connectez-vous et authentifier-vous auprès d’Azure Repos à l’aide de la commande /azrepos signin.

    Capture d’écran de l’invite de connexion pour Slack.

  2. Cliquez sur Connexion.

  3. Acceptez l’intégration Azure Repos Slack.

    Capture d’écran du bouton Accepter dans l’écran de connexion généré.

    Un code de vérification s’affiche pour être utilisé dans votre application de conversation pour terminer l’authentification.

  4. Copiez le code d’authentification.

    Capture d’écran du code de vérification fourni par Azure Repos.

  5. Sélectionnez Entrer le code, collez le code, puis sélectionnez Envoyer.

    Capture d’écran de l’authentification finale lorsque le code de vérification est collé, puis le bouton Envoyer sélectionné.

    La confirmation de la connexion s’affiche dans la conversation.

    Capture d’écran de la confirmation de connexion dans la conversation.

Pour commencer à surveiller tous les référentiels Git dans un projet, utilisez la commande slash suivante à l’intérieur d’un canal :

/azrepos subscribe [project url]

L’URL du projet peut être à n’importe quelle page de votre projet (à l’exception des URL des référentiels). Par exemple :

/azrepos subscribe https://dev.azure.com/myorg/myproject/

Vous pouvez également surveiller un référentiel spécifique à l’aide de la commande suivante :

/azrepos subscribe [repository 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, pour les référentiels Git, utilisez :

/azrepos subscribe https://dev.azure.com/myorg/myproject/_git/myrepository

Pour les référentiels TFVC, utilisez :

/azrepos subscribe https://dev.azure.com/myorg/myproject/_versionControl

Remarque

Vous pouvez uniquement vous abonner à des dépôts publics.

La commande subscribe vous permet de démarrer avec un abonnement par défaut. Pour les dépôts Git, le canal est abonné à l’événement Demande de tirage créée (avec branche cible = primaire), et pour les dépôts 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 ou supprimer des abonnements pour un canal, utilisez la commande subscriptions suivante :

/azrepos subscriptions

Cette commande répertorie tous les abonnements actuels pour le canal et vous permet d’ajouter de nouveaux abonnements ou de supprimer ceux existants. Lors de l’ajout d’abonnements, vous pouvez personnaliser les notifications que vous recevez à l’aide de 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.

Capture d’écran qui montre une vue de la liste des abonnements.

Utilisez des filtres pour personnaliser les abonnements

Lorsqu’un utilisateur s’abonne à un dépôt à l’aide de la commande /azrepos subscribe, un abonnement par défaut est créé. Les utilisateurs ont souvent besoin de personnaliser ces abonnements. Par exemple, ils peuvent souhaiter être avertis uniquement lorsque les demandes de tirage ont un réviseur spécifique.

Les étapes suivantes montrent comment personnaliser les abonnements.

  1. Exécutez la commande /azrepos subscriptions.
  2. Si la liste des abonnements contient un abonnement indésirable ou qui doit être modifié (exemple : créer du bruit dans le canal), sélectionnez le bouton Supprimer.
  3. Sélectionnez le bouton Ajouter un abonnement.
  4. Sélectionnez le référentiel requis et l’événement souhaité.
  5. Sélectionnez les filtres appropriés.

Exemple : recevoir des notifications uniquement lorsque mon équipe figure dans la liste des réviseurs pour une demande de tirage

Capture d’écran montrant quel réviseur a mon équipe.

Exemple : me dire quand les tentatives de fusion échouent en raison d’une violation de stratégie

Capture d’écran montrant que la tentative de fusion a échoué en raison d’une violation de stratégie.

Remarque

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

URL de demande de tirage en préversion

Lorsqu’un utilisateur colle l’URL d’une demande de tirage, un aperçu s’affiche comme l’image suivante, ce qui permet de préserver le caractère contextuel et précis des conversations relatives aux demandes de tirage

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

Une fois que les utilisateurs connectés, cette fonctionnalité fonctionne pour tous les canaux d’un espace de travail.

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

Utilisez la commande suivante pour nettoyer votre canal en supprimant les dépôts et les abonnements.

/azrepos unsubscribe all [project url]

Par exemple, la commande suivante supprime tous les abonnements liés à un dépôt dans le projet et les dépôts du canal. Seuls les administrateurs de projet peuvent exécuter cette commande.

/azrepos unsubscribe all https://dev.azure.com/myorg/myproject

Informations de référence sur les commandes

Le tableau suivant répertorie tous les /azrepos commands éléments que vous pouvez utiliser dans votre canal Slack.

Commande barre oblique Fonctionnalités
/azrepos subscribe [url du référentiels/ url du projet] S’abonner à un dépôt ou à tous les dépôt d’un projet pour recevoir des notifications
Abonnements /azrepos Ajouter ou supprimer des abonnements pour ce canal
Connexion /azrepos Connectez-vous à votre organisation Azure Repos
Déconnexion /azrepos Déconnectez-vous de votre organisation Azure Repos
Feedback /azrepos Signaler un problème ou suggérer une fonctionnalité
/azrepos unsubscribe all [URL du projet] Supprimer tous les référentiels (appartenant à un projet) et leurs abonnements associés d’un canal

Notifications dans les canaux privés

L’application Azure Repos peut également vous aider à surveiller les événements du dépôt dans vos canaux privés. Invitez le bot sur votre canal privé en utilisant /invite @azrepos. Vous pouvez ensuite gérer vos notifications de la même manière que vous le feriez pour un canal public.

Résolution des problèmes

Si vous rencontrez les erreurs suivantes lors de l’utilisation de l’application Azure Repos pour Slack, 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, accédez à https://slack.com, puis connectez-vous à votre espace de travail (utilisez le client web). Exécutez la commande /azrepos signout suivie de la commande /azrepos signin.

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.

Capture d’écran montant le 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.