Connecter Jira Cloud : guide pas à pas
Crée un ticket de type Bug par test en échec, y ajoute un commentaire si le test échoue à nouveau et le passe à l’état Terminé lorsque le test réussit sans erreur. Ce guide vous accompagne de zéro jusqu’à une connexion vérifiée et répertorie les erreurs que vous pourriez rencontrer avec leur cause et leur solution.
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
- Un site Jira Cloud, par exemple https://your-team.atlassian.net (Jira Cloud uniquement ; l’adresse doit être en https).
- L’adresse e-mail de votre compte Atlassian et un jeton d’API créé avec ce même compte.
- Une clé de projet, par exemple QA, dont le projet possède un type de ticket nommé Bug.
- Dans ce projet, les autorisations permettant à ce compte de parcourir le projet, de créer des tickets, d’ajouter des commentaires et des pièces jointes, et de changer l’état des tickets.
Obtenir les identifiants
- Ouvrez https://id.atlassian.com/manage-profile/security/api-tokens et choisissez Créer un jeton d’API.
- Nommez-le (par exemple "Nexus StudioQA"), choisissez une date d’expiration, créez-le et copiez immédiatement le jeton. Atlassian ne l’affiche 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 Jira.
- Collez n’importe quel lien de votre Jira (la page d’accueil, un tableau ou un ticket) et appuyez sur Vérifier la connexion. Le Studio conserve l’adresse du site et la clé du projet.
- Lorsque vous y êtes invité, saisissez votre adresse e-mail Atlassian et le jeton, puis appuyez sur Enregistrer & vérifier.
- Choisissez le projet dans "Destination des bugs", puis activez
JIRA_ENABLED.
Vérifier le fonctionnement
- Vérifier la connexion affiche "Connecté en tant que <votre nom>" et "<KEY> accepte les tickets de type Bug". Cette vérification se limite à la lecture ; elle ne crée jamais de ticket.
- Ouvrez Paramètres → Intégrations → Tickets et appuyez sur Créer un ticket de test. Cette action crée un ticket portant l’étiquette nexus-test et constitue le seul clic de cette section qui sollicite Jira.
- Ouvrez ce ticket dans Jira et vérifiez qu’il porte les étiquettes auto-generated, nexus-studioqa-automation et nexus-test. Supprimez-le lorsque vous avez terminé.
Erreurs courantes
| Ce que vous voyez | Cause | Solution |
|---|---|---|
| "Ce n’est pas un lien" ou "Un lien Jira commence par https://" | Le texte collé n’est pas une adresse web complète, ou commence par http://. | Copiez l’adresse depuis la barre d’adresse lorsque vous êtes sur votre site Jira. Elle doit commencer par https://. |
| HTTP 401 | L’adresse e-mail ou le jeton est incorrect, le jeton a expiré ou a été révoqué, ou l’adresse e-mail ne correspond pas au compte qui a créé le jeton. | Créez un nouveau jeton sur id.atlassian.com avec le compte dont vous avez enregistré l’adresse e-mail, puis enregistrez à nouveau les deux dans Paramètres. |
| HTTP 403 | L’authentification fonctionne, mais Jira indique que ce compte n’est pas autorisé à effectuer cette action : il lui manque généralement l’autorisation de créer des tickets, d’ajouter des commentaires ou d’ajouter des pièces jointes dans le projet. | Demandez ces autorisations à l’administrateur du projet ou choisissez un autre projet. Nexus StudioQA ne peut pas les accorder. |
| HTTP 404 | L’adresse du site ou la clé du projet n’existe pas, ou ce compte ne peut pas accéder au projet (Jira renvoie une erreur 404 pour les projets qu’il masque). | Collez n’importe quel lien du bon site et choisissez le projet dans la liste. |
| "Cette adresse a répondu, mais pas avec un compte Jira" | L’adresse ne correspond pas à un site Jira Cloud (par exemple, il s’agit d’une adresse Server ou Data Center, ou d’une autre page web). | Utilisez l’adresse https://<team>.atlassian.net de votre site Jira Cloud. |
| "<KEY> n’a aucun type de ticket nommé Bug" | Le projet n’a aucun type de ticket appelé Bug, il est donc impossible de créer un ticket. | Dans Jira, ouvrez Paramètres du projet → Types de tickets et ajoutez Bug, ou choisissez un autre projet. |
| "impossible de joindre Jira (ENOTFOUND)" ou "aucune réponse sous 20 s" | Ce PC ne peut pas joindre le site : erreur de saisie dans l’adresse, VPN ou proxy, ou absence de connexion réseau. | Corrigez l’adresse, puis ouvrez le site dans un navigateur sur le même PC. Relancez la vérification. |
| Toutes les vérifications réussissent, mais aucun ticket n’apparaît | JIRA_ENABLED vaut false ; ou le verdict était FLAKY ou lié à l’environnement ; ou l’exécution a eu lieu dans un bac à sable ; ou un Bug ouvert existe déjà pour ce test (un nouvel échec ajoute alors un commentaire) ; ou un Bug portant le même titre a été créé au cours des dernières 24 heures. | Activez JIRA_ENABLED, lisez "Un ticket par test" sur la page des intégrations et utilisez Créer un ticket de test pour vérifier la connexion. |
| Un test réussi ne ferme pas son ticket | Le flux de travail ne comporte aucune transition portant le nom défini dans JIRA_DONE_TRANSITION, donc seul un commentaire est ajouté au ticket. | Définissez JIRA_DONE_TRANSITION sur le nom exact du bouton de transition dans votre flux de travail. |
Clés de configuration
| Clé | Fonctionnalités | Valeur valide | Comment la vérifier |
|---|---|---|---|
JIRA_ENABLED | Créer des tickets Jira en cas d’échec | true ou false | Activez l’intégration, puis lancez Créer un ticket de test. |
JIRA_BASE_URL | Adresse du site Jira | https://<site>.atlassian.net | Vérifier la connexion affiche le site ; coller un lien renseigne ce champ. |
JIRA_EMAIL | Adresse e-mail de connexion à Jira | L’adresse e-mail du compte Atlassian propriétaire du jeton | Vérifier la connexion affiche "Connecté en tant que …" avec cette adresse e-mail. |
JIRA_API_TOKEN | Jeton d’accès Jira (secret, enregistré uniquement sur cet ordinateur) | Une seule ligne, sans guillemets ni espaces | Vérifier la connexion : HTTP 401 signifie que la paire adresse e-mail/jeton est incorrecte. |
JIRA_PROJECT_KEY | Projet Jira pour les tickets Bug | La clé du projet, généralement en majuscules, par exemple QA | La liste déroulante des projets l’affiche ; "accepte les tickets Bug" confirme le type. |
JIRA_DONE_TRANSITION | Statut Jira lorsque le test réussit | Le nom exact d’une transition du flux de travail, sans distinction entre majuscules et minuscules | Une réussite sans anomalie fait changer le ticket de statut ; si le flux de travail ne comporte pas cette transition, seul un commentaire est ajouté. |
En savoir plus : toutes les intégrations, le guide des paramètres, le dépannage. Autres guides : Azure Boards, 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.