Demander une exécution
Une exécution démarre de deux façons : automatiquement à la réception d'une issue sur un dépôt surveillé, ou à la demande d'un membre depuis le dossier de l'issue.
Qui peut le faire : l'Opérateur, le Responsable et l'Administrateur. Le Lecteur ne voit pas la carte Exécution.
Démarrage automatique#
Quand une issue s'ouvre ou se rouvre sur un dépôt dont la case Surveiller les nouvelles issues est cochée, la plateforme met une exécution en file, si l'issue n'en a pas déjà une. Le détail de la réception est décrit dans Réception des issues GitHub.
Le nombre d'exécutions simultanées par dépôt est limité par le champ Nombre maximal d'exécutions de la politique (de 1 à 10 exécutions). Au-delà, les nouvelles issues attendent leur tour.
Démarrage manuel, pas à pas#
- Ouvrez Issues et exécutions, puis l'issue concernée.
- Dans la carte Exécution, cliquez sur Demander une exécution.
- Le message Demande en cours d'envoi s'affiche brièvement.
- La page de l'exécution s'ouvre. Son badge indique En file, puis En cours.
La demande manuelle suit les mêmes règles que le démarrage automatique : mêmes budgets, même plafond de concurrence, mêmes contrôles par le worker.
Conditions à remplir#
Le bouton n'est actif que si toutes ces conditions sont réunies :
| Condition | Où la régler |
|---|---|
| Le dépôt est actif | Case Autoriser les travaux sur ce dépôt, voir Rattacher un dépôt |
| Le dépôt est lié à la GitHub App | Vérifier et rattacher, voir Lier le dépôt à la GitHub App |
| Le dépôt est surveillé | Case Surveiller les nouvelles issues, voir Surveillance et politique du dépôt |
| L'issue est ouverte sur GitHub | Sur GitHub |
| Aucune exécution n'existe déjà pour cette issue | Une seule exécution initiale par issue |
Quand une condition manque, la carte affiche Demande indisponible avec la raison :
- « L'issue est fermée sur GitHub : aucune exécution ne peut être demandée. »
- « Le dépôt doit être actif, lié à GitHub et sous surveillance pour demander une exécution. »
Pendant un arrêt global#
Si l'Administrateur a activé l'arrêt global, votre demande est quand même acceptée et mise en file. Le badge En file s'accompagne de En attente de la levée de l'arrêt global, et l'encadré du même nom précise : « La demande est enregistrée. Elle démarrera une seule fois après la levée de l'arrêt, avec ses budgets et ses verrous. ». Vous pouvez l'annuler en attendant.
Une exécution existe déjà#
Une issue n'a qu'une exécution initiale. Si elle existe, la carte affiche Une exécution existe déjà pour cette issue, son état et le lien Suivre l'exécution. Ce lien mène à la dernière tentative de l'issue.
Pour traiter l'issue de nouveau, utilisez les reprises : voir Relancer, annuler, archiver.
Ce qui se passe ensuite#
Le worker prend l'exécution en charge. Avant chaque appel au modèle, il revérifie l'issue, le rattachement GitHub, la politique et vos droits. Si l'un d'eux a changé, l'exécution s'arrête sans effet.
Refus courants#
| Message | Cause | Que faire |
|---|---|---|
| « Votre rôle ne permet pas de demander une exécution. » | Rôle Lecteur ou rôle retiré | Demandez un rôle Opérateur au Responsable du projet |
| « L'issue est fermée ou le dépôt n'est plus lié et surveillé. » | État changé entre l'affichage et le clic | Rechargez la page et vérifiez les conditions |
| « Exécution non demandée. Réessayez plus tard. » | Service momentanément indisponible | Réessayez dans quelques minutes |