Connecter Azure Boards : guide pas à pas
Crée un élément de travail par test en échec, y ajoute un commentaire si le test échoue à nouveau et le passe à un état terminé lorsque le test réussit sans erreur. Le même jeton permet aussi de publier les résultats des tests et de mettre des pipelines en file d’attente. Ce guide vous accompagne de la configuration initiale à la vérification de la connexion et répertorie les erreurs possibles, leurs causes et leurs solutions.
Dernière mise à jour :
Gardez vos identifiants confidentiels. Ne collez jamais de jeton, de clé, de mot de passe ou d’URL de webhook dans une conversation. Saisissez-les uniquement dans Studio → Paramètres → Intégrations, où ils sont enregistrés dans le fichier .env de votre espace de travail et affichés sous forme de points. Cela vaut aussi pour un assistant IA : il peut vous accompagner dans ce guide, mais il n’a jamais besoin de votre jeton.
Prérequis
- Une organisation Azure DevOps Services : https://dev.azure.com/<organization> ou https://<organization>.visualstudio.com (Azure DevOps Server installé sur vos propres machines n’est pas pris en charge).
- Le nom du projet qui recevra les éléments de travail.
- Un jeton d’accès personnel (PAT) avec les autorisations Éléments de travail → Lecture & écriture, ainsi que Build → Lecture & exécution si vous utilisez aussi Exécuter en CI.
- Connaître le processus de votre projet, car il détermine le type d’élément de travail : Basic propose Issue, Epic et Task (sans Bug) ; Agile, Scrum et CMMI proposent Bug.
Obtenir les identifiants
- Ouvrez dev.azure.com, puis Paramètres utilisateur → Jetons d’accès personnels → Nouveau jeton.
- Sélectionnez votre organisation, définissez une date d’expiration et, sous Étendues, choisissez Définies personnalisées.
- Cochez Éléments de travail → Lecture & écriture (ajoutez Build → Lecture & exécution pour Exécuter en CI), créez le jeton et copiez-le immédiatement. Il n’est affiché qu’une seule fois.
- Gardez-le dans votre presse-papiers. Ne le collez nulle part ailleurs que dans le Studio (étape suivante).
Configurer la connexion dans le Studio
- Dans le Studio, ouvrez Paramètres → Intégrations → Connecter Azure DevOps.
- Collez n’importe quel lien Azure DevOps (un tableau, un élément de travail ou la page du projet), puis cliquez sur Vérifier la connexion. Le Studio conserve l’organisation et le projet.
- À l’invite, saisissez le PAT et cliquez sur Enregistrer & vérifier. Sélectionnez le projet dans "Destination des éléments de travail".
- Si la vérification indique que le projet ne possède aucun type d’élément de travail nommé Bug, définissez
AZURE_BOARDS_WORK_ITEM_TYPEsur l’un des types répertoriés (Issue dans un projet Basic), etAZURE_BOARDS_DONE_STATEsur un état disponible dans ce processus (Basic : Done). - Activez
AZURE_BOARDS_ENABLED.
Vérifier le fonctionnement
- Vérifier la connexion affiche "Le jeton donne accès à N projets" et "<project> accepte les éléments de travail de type <type>". La vérification effectue uniquement des lectures ; elle ne crée jamais d’élément de travail.
- Ouvrez Paramètres → Intégrations → Tickets et cliquez sur Créer un ticket de test. Cette action crée un élément de travail portant l’étiquette nexus-test, avec une capture d’écran en pièce jointe.
- Ouvrez-le dans Azure Boards, vérifiez l’étiquette et la pièce jointe, puis supprimez-le lorsque vous avez terminé.
Erreurs courantes
| Ce que vous voyez | Cause | Solution |
|---|---|---|
| "Azure DevOps a refusé le jeton" (HTTP 203 ou 401) | Le PAT est incorrect, a expiré, a été révoqué, n’a pas été copié intégralement ou a été créé dans une autre organisation. | Créez un nouveau PAT dans la même organisation que AZURE_DEVOPS_ORG_URL avec les autorisations Éléments de travail → Lecture & écriture, puis enregistrez-le à nouveau. |
| HTTP 403 | Le PAT est valide, mais il lui manque une étendue, ou votre compte ne dispose pas des autorisations nécessaires dans ce projet. | Modifiez les étendues du PAT (Éléments de travail → Lecture & écriture ; Build → Lecture & exécution pour Exécuter en CI), ou demandez l’accès à l’administrateur du projet. |
| HTTP 404 | L’organisation ou le nom du projet n’existe pas, ou le projet a été renommé. | Collez un lien provenant du bon projet et sélectionnez ce projet dans la liste. |
| VS402323 "Le type d’élément de travail Bug n’existe pas" | Le processus du projet ne possède aucun type d’élément de travail portant ce nom. Un projet Basic propose Issue, Epic et Task, mais pas Bug. | Définissez AZURE_BOARDS_WORK_ITEM_TYPE sur un type répertorié par la vérification (Basic : Issue) et AZURE_BOARDS_DONE_STATE sur l’un de ses états (Basic : Done), puis cliquez à nouveau sur Vérifier la connexion. |
| "<project> n’a aucun type d’élément de travail nommé …" | La même cause que VS402323, détectée par Vérifier la connexion avant toute création. | Définissez AZURE_BOARDS_WORK_ITEM_TYPE sur l’un des types indiqués dans ce message, ou choisissez un autre projet. |
| "Ce n’est pas un lien Azure DevOps" | L’adresse n’est pas sur dev.azure.com/<organization> ou <organization>.visualstudio.com, ou elle commence par http://. | Copiez l’adresse depuis la barre d’adresse d’Azure DevOps Services. Azure DevOps Server n’est pas pris en charge. |
| "impossible de joindre Azure DevOps (…)" ou "n’a pas répondu dans les 20 s" | Ce PC ne peut pas joindre Azure DevOps : un VPN ou un proxy bloque l’accès, ou aucune connexion réseau n’est disponible. | Ouvrez dev.azure.com dans un navigateur sur le même PC, puis relancez la vérification. |
| Un test réussi ne fait pas passer l’élément à l’état terminé | Le processus refuse AZURE_BOARDS_DONE_STATE pour ce type, donc seul le commentaire est ajouté à l’élément. | Définissez AZURE_BOARDS_DONE_STATE sur un état de ce type (Basic : Done ; bogue Agile : Resolved). |
| Tout est correct, mais aucun élément de travail n’apparaît | AZURE_BOARDS_ENABLED vaut false ; ou le verdict était FLAKY ou lié à l’environnement ; ou l’exécution était en bac à sable ; ou le test possède déjà un élément de travail ouvert (un nouvel échec ajoute alors un commentaire). | Activez AZURE_BOARDS_ENABLED et utilisez Créer un ticket de test pour valider la connexion. |
Clés de configuration
| Clé | Fonctionnalités | Valeur valide | Comment la vérifier |
|---|---|---|---|
AZURE_BOARDS_ENABLED | Créer des éléments de travail Azure pour les échecs | true ou false | Activez cette option une fois Vérifier la connexion réussi, puis lancez Créer un ticket de test. |
AZURE_DEVOPS_ORG_URL | Adresse de l’organisation Azure DevOps | https://dev.azure.com/<organization> ou https://<organization>.visualstudio.com | Vérifier la connexion affiche l’organisation ; coller un lien renseigne ce champ. |
AZURE_DEVOPS_PROJECT | Nom du projet Azure DevOps | Le nom du projet, exactement tel qu’il apparaît dans Azure DevOps | Vérifier la connexion répertorie les projets accessibles avec le jeton. |
AZURE_DEVOPS_PAT | Jeton d’accès Azure DevOps (secret, enregistré uniquement sur cet ordinateur) | Une seule ligne, sans guillemets ni espaces | Vérifier la connexion : "jeton refusé" signifie qu’il est incorrect, expiré ou issu d’une autre organisation. |
AZURE_BOARDS_WORK_ITEM_TYPE | Type de ticket Azure pour les échecs | Un type disponible dans le processus du projet : Bug (Agile, Scrum, CMMI) ou Issue (Basic) | Vérifier la connexion indique "<project> accepte les éléments de travail de type <type>" ou répertorie les types disponibles dans le projet. |
AZURE_BOARDS_DONE_STATE | État Azure lorsque le test réussit | Un état de ce type d’élément de travail : Resolved (bogue Agile), Done (problème Basic) | Une réussite sans anomalie fait changer l’élément d’état ; si le processus refuse cet état, seul un commentaire est ajouté. |
AZURE_PIPELINE_ID | Pipeline Azure à exécuter en CI | L’identifiant numérique d’un pipeline Azure (uniquement pour Exécuter en CI) | nexus ci-remote --provider=azure met ce pipeline en file d’attente ; nécessite Génération → Lire & exécuter. |
Pour en savoir plus : toutes les intégrations, le guide des paramètres, le dépannage. Autres guides : Jira Cloud, Slack, Microsoft Teams, Telegram, GitHub Issues.
Toujours bloqué ? Écrivez à [email protected] en indiquant la ligne d’erreur exacte affichée par le Studio. N’incluez aucun jeton.