Fiche vérifiée le 31 octobre 2026 · Canal production · Meteor Factory
Pourquoi utiliser GitHub Issues ?
Parcourez les issues GitHub de votre dépôt dans Singularity et transformez une demande en ticket lié, en conservant son contexte et ses images.
Pour les équipes produit et développement qui trient les demandes avant de les traiter dans le board.
Consultez les issues ouvertes et fermées, leur description Markdown et leurs commentaires. Créez un ticket lié ou retrouvez le ticket existant. Le menu contextuel propose consultation, ouverture sur GitHub, clôture/réouverture, épinglage, clonage et suppression confirmée. Le détail propose aussi les liens et sous-issues.
Démonstration locale sur données fictives : les captures ne prouvent pas une connexion GitHub distante.
Prérequis et activation
Utilisez Singularity 2.x, un espace de travail de démonstration et une licence autorisant ce plugin payant. Dans le Marketplace, recherchez GitHub Issues, installez-le, acceptez ses permissions obligatoires et activez-le dans cet espace.
Pour le service réel, préparez un dépôt GitHub de démonstration avec Issues activé et un jeton personnel autorisé sur ce dépôt. Le jeton doit permettre la lecture des issues ; commentaires et changements exigent les droits d’écriture correspondants. Les pièces jointes envoyées par le plugin sont enregistrées dans le dépôt et demandent des droits sur son contenu. Ne saisissez pas un jeton de production dans une démonstration.
Premier résultat
- Ouvrez GitHub Issues dans le panneau des plugins. Dans la gestion des connexions, choisissez Add a connection. Certains formulaires de l’hôte restent en anglais.
- Saisissez un nom, le dépôt au format propriétaire/dépôt et votre jeton. Enregistrez la connexion ; sélectionnez-la si vous en avez plusieurs.
- Ouvrez le groupe des issues ouvertes dans le navigateur. La séparation ouvertes/fermées sert au tri ; la surface du plugin ne propose pas de recherche textuelle.
- Sélectionnez une issue contenant une description Markdown et une image autorisée. Vérifiez le titre, l’état, les labels et les commentaires.
- Choisissez Créer un ticket dans le détail, ou Create ticket dans le menu contextuel. Si le formulaire de création s’ouvre, vérifiez sa description, son projet et son agent avant de valider. Le détail ouvre également le formulaire de création.
- Ouvrez le ticket lié et retrouvez-le dans le board. Vérifiez le lien vers l’issue et les images de la description.
Résultat attendu : un ticket lié conserve le contexte GitHub ; une nouvelle demande sur la même issue réutilise le ticket encore existant.
Exemple 1 — de la demande au board
Dans votre dépôt de démonstration, préparez une issue intitulée « Clarifier le message de bienvenue », avec le corps suivant. Joignez une capture de votre application depuis GitHub puis conservez le lien Markdown ajouté :
## Demande
Afficher un message de bienvenue compréhensible.
## Résultat attendu
Le texte explique la prochaine action.
- [ ] Vérifier le texte sur une fenêtre étroite
Suivez les six étapes ci-dessus. Les captures montrent le même parcours avec le jeu fictif demo-lab/issue-guide : issue #42, label documentation et ticket F-42. Le menu contextuel s’ouvre par clic droit sur l’issue dans le navigateur.
Exemple 2 — aucune issue ouverte
Sur une connexion de démonstration sans issue ouverte, développez le groupe fermé ou consultez la section Fermées. Résultat attendu : l’état vide est explicite et les issues fermées restent consultables. Une liste vide ne prouve pas une panne. Si un message d’échec apparaît, contrôlez plutôt le dépôt et la connexion ; ne créez pas de ticket sans avoir chargé l’issue.
Commentaires, sous-issues et clôture
Dans le détail, le champ Ajouter un commentaire publie le texte sur GitHub avec Commenter. Lier une issue et Ajouter une sous-issue demandent un numéro d’issue ; vérifiez le dépôt sélectionné. Fermer modifie l’état sur GitHub ; Rouvrir fait l’inverse. Épingler, cloner et supprimer modifient aussi les données distantes ; la suppression demande confirmation et est irréversible. Ces actions sont décrites mais ne sont pas exécutées sur un dépôt réel dans la recette.
Un ticket lié terminé peut fermer son issue. De nouveaux commentaires externes peuvent remettre le ticket en attente et rouvrir l’issue. L’auto-validation des commentaires peut relancer un ticket terminé : laissez-la désactivée pendant une démonstration.
Configuration
Les connexions et l’activation sont propres à l’espace de travail. Les jetons sont stockés via le coffre isolé du plugin, pas dans la documentation. Les réglages permettent la synchronisation toutes les 45 secondes, les notifications et l’auto-validation des commentaires. Les permissions réseau servent aux API GitHub et aux images autorisées ; les permissions tickets servent à créer, consulter et ouvrir les tickets liés. Une permission obligatoire refusée empêche l’activation.
Limites et provenance
Les captures proviennent de composants réellement exécutés en Chromium headless, avec un pont hôte et des réponses GitHub simulés en mémoire. Aucun dépôt distant n’a été modifié. Elles ne valident pas l’authentification réelle, les droits GitHub, les limites de débit ou la synchronisation distante. Le code et la commande de reproduction sont dans scripts/github-issues-docs/README.md du dépôt Particles, version 1.3.15.
Les images externes non autorisées ne sont pas téléchargées. La préparation d’un ticket limite ses images à 5 Mo au total ; les pièces jointes d’une nouvelle issue sont limitées à 10 Mo chacune. Une connexion privée reste dépendante de la validité du jeton et des autorisations du dépôt.
Dépannage
| Symptôme | Vérification et action |
|---|---|
| Aucune connexion | Ajoutez une connexion dans le bon espace de travail. |
| Échec GitHub | Vérifiez propriétaire/dépôt, jeton, droits et accès réseau ; réessayez après une limite de débit. |
| Image indisponible | Vérifiez que son URL est accessible et autorisée ; réduisez sa taille si la création du ticket échoue. |
| Ticket déjà lié | Ouvrez le ticket existant ; la création ne doit pas le dupliquer. |
| Plugin inactif | Vérifiez installation, licence et consentement aux permissions. |
<!-- captures -->
Le détail affiche le contexte et une capture de la liste du plugin. (en)
Un clic droit propose les actions sur l’issue ; ces libellés restent en anglais. (en)
Le board réel affiche le ticket de démonstration et son badge GitHub #42. (en)
Continuer avec Singularity
Ce plugin s’utilise dans un espace de travail Singularity. Consultez les permissions et les conditions de licence dans le Marketplace avant de l’activer.