Réception des issues GitHub
GitHub prévient 101Maintain à chaque événement sur une issue du dépôt. La plateforme met à jour son suivi et, si les conditions sont réunies, prépare le démarrage d'une exécution.
Qui peut le faire : aucune action manuelle. La réception est automatique. Un Responsable règle les conditions de démarrage (voir Surveillance et politique du dépôt).
Les événements pris en compte#
| Événement GitHub | Effet dans 101Maintain |
|---|---|
| Issue ouverte | L'issue apparaît dans Issues et exécutions. Si les conditions sont réunies, une demande d'exécution est mise en attente de traitement. |
| Issue réouverte | Même effet qu'à l'ouverture. Une issue qui a déjà une demande en attente n'en reçoit pas une seconde. |
| Issue modifiée | Le titre et la date de mise à jour sont actualisés. Rien ne démarre. |
| Issue fermée | L'issue passe à l'état Fermées. Les demandes d'exécution en attente sont annulées. |
Quand deux événements arrivent dans le désordre, le plus récent l'emporte. À date égale, une fermeture l'emporte, pour qu'une livraison retardée ne démarre pas une issue déjà fermée. Un événement reçu deux fois n'a pas d'effet répété.
Les conditions de démarrage#
Une exécution n'est mise en attente que si toutes ces conditions sont vraies :
- le dépôt est lié à la GitHub App et son accès est actif ;
- le dépôt est autorisé : Autoriser les travaux sur ce dépôt est coché ;
- Surveiller les nouvelles issues est coché ;
- l'issue est ouverte ;
- l'arrêt global ne retient pas les travaux. S'il est actif, la demande est conservée et démarre à la levée.
Sinon, l'ouverture est ignorée et n'apparaît pas dans la liste. Le bouton Demander une exécution suit des conditions voisines : voir Demander une exécution.
Cas où rien ne démarre#
| Constat | Cause probable | Que faire |
|---|---|---|
| Une issue ouverte n'apparaît pas | La surveillance est décochée, le dépôt est Arrêté, ou l'App n'est pas liée. | Contrôlez la page du dépôt. |
| Une issue apparaît mais aucune exécution ne démarre | Le plafond Nombre maximal d'exécutions est atteint, ou l'arrêt global est actif. | Attendez ou relevez le plafond. |
| Les issues d'un dépôt renommé disparaissent | Le nom GitHub a changé et le dépôt n'a pas été revérifié. | Un Administrateur clique sur Vérifier et rattacher. |
| Les issues ne sont plus suivies | L'accès a été retiré côté GitHub (Accès GitHub retiré). | Rétablissez l'installation, puis Vérifier et rattacher. |
| Aucune issue n'arrive depuis GitHub | Le webhook de l'App n'est pas configuré ou GitHub n'a pas pu livrer. | Prévenez l'exploitant. Voir GitHub App et interrupteurs. |
Ce qu'il faut savoir sur le webhook#
L'adresse de réception est /webhooks/github sur l'instance. Elle est réservée à GitHub : chaque livraison est signée, et une livraison non signée correctement est refusée. Les types d'événements pris en charge sont les événements d'issue (ouverture, réouverture, modification, fermeture) et les changements d'installation (suppression, suspension, retrait de dépôts). Les autres sont refusés. Le contenu des livraisons n'est pas conservé : seuls des identifiants et empreintes servent à retrouver un incident.
Si GitHub ne peut pas livrer, il ne rejoue pas automatiquement. L'exploitant peut redélivrer l'événement depuis les réglages de l'App.
Pour continuer#
Voyez comment arrêter un dépôt : Arrêter ou corriger un dépôt. Pour la suite d'une issue, ouvrez Vue d'ensemble de la maintenance.