Connecter GitHub Issues : guide pas à pas
Ouvre un ticket GitHub par test en échec, y ajoute un commentaire si le test échoue à nouveau et le ferme lorsque le test réussit sans problème. GitHub n'accepte aucun envoi de fichier : le ticket indique donc le dossier des preuves au lieu de joindre la capture d'écran. Ce guide vous accompagne de la configuration initiale jusqu'à 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
- Un compte GitHub autorisé à ouvrir des tickets dans le dépôt (un collaborateur ou le propriétaire).
- Un dépôt dans lequel les tickets sont activés (Paramètres du dépôt → Fonctionnalités → Tickets).
- Un jeton d'accès personnel à granularité fine avec l'autorisation Tickets → Lecture et écriture sur ce dépôt, ou un jeton classique avec la portée repo.
Obtenir les identifiants
- Ouvrez https://github.com/settings/personal-access-tokens/new (pour créer un jeton à granularité fine).
- Nommez-le, définissez une date d'expiration et, sous Accès aux dépôts, choisissez Uniquement les dépôts sélectionnés, puis sélectionnez le dépôt qui recevra les tickets.
- Sous Autorisations → Autorisations du dépôt, réglez Tickets sur Lecture et écriture. Aucune autre autorisation n'est nécessaire.
- Générez le jeton et copiez-le immédiatement. GitHub ne l'affiche qu'une seule fois. 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 GitHub Issues.
- Lorsque vous y êtes invité, saisissez le jeton et appuyez sur Enregistrer & vérifier. Le Studio indique à qui appartient le jeton et à combien de dépôts il donne accès.
- Sélectionnez le dépôt dans "Destination des tickets". La liste ne propose que les dépôts accessibles au jeton et dans lesquels les tickets sont activés.
- Activez
GITHUB_ISSUES_ENABLED.
Vérifier le fonctionnement
- Vérifier la connexion affiche "connecté en tant que <you>" et "<owner/repo> accepte les tickets". La vérification effectue uniquement des lectures ; elle n'ouvre jamais de ticket.
- Ouvrez Paramètres → Intégrations → Tickets et appuyez sur Créer un ticket de test pour la destination GitHub. Cette action ouvre un ticket portant l'étiquette nexus-test.
- Ouvrez-le sur GitHub, vérifiez l'étiquette, puis fermez-le ou supprimez-le lorsque vous avez terminé.
Erreurs courantes
| Ce que vous voyez | Cause | Solution |
|---|---|---|
| "GitHub a refusé le jeton (401)" | Le jeton est incorrect, expiré, révoqué ou n'a pas été copié intégralement. | Créez un nouveau jeton avec l'autorisation Tickets → Lecture et écriture et enregistrez-le à nouveau. |
| HTTP 403 | Le jeton ne dispose pas de l'autorisation Tickets, le dépôt n'a pas été sélectionné pour ce jeton ou la limite de requêtes est atteinte. | Modifiez le jeton : réglez Tickets sur Lecture et écriture et sélectionnez le dépôt. Si la limite de requêtes est atteinte, attendez quelques minutes. |
| HTTP 404 | Le dépôt n'existe pas, a été renommé ou n'est pas visible pour le jeton (les dépôts privés doivent être sélectionnés pour un jeton à granularité fine). | Sélectionnez le dépôt dans la liste ou ajoutez-le aux dépôts accessibles au jeton. |
| HTTP 422 | GitHub a rejeté un champ du ticket, le plus souvent une personne assignée qui n'est pas collaboratrice, ou un titre ou une étiquette que GitHub refuse. | Retirez la personne assignée dans Paramètres → Intégrations → Tickets, ou ajoutez cette personne comme collaboratrice. |
| "les tickets sont désactivés dans <repo>" | La fonctionnalité Tickets est désactivée dans le dépôt. | Activez Paramètres → Fonctionnalités → Tickets dans le dépôt ou choisissez un autre dépôt. |
| "impossible de joindre GitHub (…)" ou "n'a pas répondu à temps" | Ce PC ne peut pas joindre api.github.com : un VPN, un proxy ou une absence de connexion réseau en est la cause. | Ouvrez github.com dans un navigateur sur le même PC, puis relancez la vérification. |
| Toutes les vérifications réussissent, mais aucun ticket n'apparaît | GITHUB_ISSUES_ENABLED est défini sur false ; ou le verdict était FLAKY ou lié à l'environnement ; ou l'exécution a eu lieu dans un bac à sable ; ou le test possède déjà un ticket ouvert (un nouvel échec ajoute alors un commentaire). | Activez GITHUB_ISSUES_ENABLED et utilisez Créer un ticket de test pour confirmer que la connexion fonctionne. |
Clés de configuration
| Clé | Fonctionnalités | Valeur valide | Comment la vérifier |
|---|---|---|---|
GITHUB_ISSUES_ENABLED | Créer des tickets GitHub en cas d’échec | true ou false | Activez cette option une fois Vérifier la connexion réussi, puis lancez Créer un ticket de test. |
GITHUB_ISSUES_TOKEN | Jeton d'accès GitHub (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 révoqué. |
GITHUB_ISSUES_REPO | Dépôt GitHub pour les tickets | propriétaire/dépôt, comme acme/web | Sélectionnez-le dans la liste ; le Studio n’enregistre qu’un dépôt accessible avec le jeton et dont les tickets sont activés. |
En savoir plus : toutes les intégrations, le guide des paramètres, le dépannage. Autres guides : Jira Cloud, Azure Boards, Slack, Microsoft Teams, Telegram.
Toujours bloqué ? Écrivez à [email protected] en indiquant la ligne d’erreur exacte affichée par le Studio. N’incluez aucun jeton.