Maintenance assistée

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#

  1. Ouvrez Issues et exécutions, puis l'issue concernée.
  2. Dans la carte Exécution, cliquez sur Demander une exécution.
  3. Le message Demande en cours d'envoi s'affiche brièvement.
  4. 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 :

ConditionOù la régler
Le dépôt est actifCase Autoriser les travaux sur ce dépôt, voir Rattacher un dépôt
Le dépôt est lié à la GitHub AppVé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 GitHubSur GitHub
Aucune exécution n'existe déjà pour cette issueUne 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#

MessageCauseQue 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 clicRechargez la page et vérifiez les conditions
« Exécution non demandée. Réessayez plus tard. »Service momentanément indisponibleRéessayez dans quelques minutes

Pour continuer#

Les cinq agents