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. Vous pouvez configurer et gérer des abonnements pour recevoir des notifications dans votre canal chaque fois que du code est envoyé/archivé et qu’une demande de tirage (PR) est créée, mise à jour ou qu’une fusion est tentée. Cette application prend en charge les événements Git et Team Foundation Version Control (TFVC).

Image de notifications

Lisez cet article pour découvrir comment :

  • Ajouter l’application Azure Repos à votre espace de travail Slack
  • Connecter l’application Azure Repos à vos référentiels
  • Gérer les abonnements aux événements liés au référentiel dans votre canal Slack
  • Utilisation efficace de filtres pour personnaliser les abonnements
  • Obtenir des notifications dans les canaux Slack privés

Prérequis

Notes

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

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

  1. Accédez à l’application Slack Azure Repos pour installer l’application Azure Repos dans votre espace de travail Slack.

  2. Une fois ajouté, un message de bienvenue de l’application s’affiche, comme illustré dans l’image suivante.

    Message de bienvenue

  3. 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. Une fois l’application installée dans votre espace de travail Slack, connectez-vous à Azure Repos à l’aide de la commande /azrepos signin.

    Image invite de connexion

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

    Notes

    Vous pouvez vous abonner uniquement aux référentiels publics.

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

    Message de création d’abonnements par défaut

Gérer les abonnements

Pour afficher, ajouter et supprimer des abonnements pour un canal, utilisez la commande subscriptions :

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

Voir les abonnements

Utilisation efficace de filtres pour personnaliser les abonnements

Lorsqu’un utilisateur s’abonne à un référentiels à l’aide de la commande /azrepos subscribe, un abonnement par défaut est créé. Souvent, les utilisateurs ont besoin de personnaliser ces abonnements. Par exemple, les utilisateurs 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. Dans la liste des abonnements, s’il existe un abonnement qui est indésirable ou doit être modifié (exemple : création de 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 pour personnaliser votre abonnement.

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

Le réviseur a mon équipe

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

Échec de la tentative de fusion : en raison d’une violation de stratégie

Notes

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

Aperçus des URL des demandes de tirage

Lorsqu’un utilisateur colle l’URL d’une demande de tirage, un aperçu semblable à celui de l’image suivante s’affiche. Cela permet de garder les conversations liées aux demandes de tirage contextuelles et précises.

Déploiement de l’URL

Pour que cette fonctionnalité fonctionne, les utilisateurs doivent être connectés. Une fois qu’ils sont 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

  • Souvent, les utilisateurs souhaitent propre leur canal en supprimant les référentiels et les abonnements. Utilisez la commande ci-dessous pour obtenir la même chose.

      /azrepos unsubscribe all [project url]

    Par exemple :

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

Cette commande supprime tous les abonnements liés à n’importe quel référentiels dans le projet et supprime les référentiels du canal. Seuls les administrateurs de projet peuvent exécuter cette commande.

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 référentiel ou à tous les référentiels 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 de référentiels dans vos canaux privés. Vous devrez inviter le bot à votre canal privé à l’aide de /invite @azrepos. Après cela, vous pouvez configurer et gérer vos notifications de la même façon que pour un canal public.

Dépannage

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 bouton Sign in et vous serez 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.