M301 : Piloter l'exécution des releases
Faire avancer une release par un événement
Le cycle de vie, les triggers, et une tâche qui attend le merge dans Gitea.
Ce que vous allez faire
Jusqu'ici, c'est vous qui dites à Release que la pull request est mergée. Dans ce module, Gitea le lui dit directement : vous créez le point d'entrée qui reçoit les événements, puis vous remplacez la tâche manuelle par une attente d'événement.
Votre point de départ
Le pré-template Deploy guestbook (205 done) est dans votre folder Sandbox si vous n'avez pas terminé les modules précédents. Gitea envoie déjà ses événements vers l'adresse /webhooks/gitea de votre Release : il ne manque que le point d'entrée pour les recevoir.
Le cycle de vie d'une release
Une release naît d'un template, à l'état Planned : c'est une copie, rien ne tourne. Toute release vient au monde Planned, systématiquement, que vous la démarriez juste après, que vous la laissiez en attente, ou que vous ayez coché un démarrage automatique à une date. Au démarrage elle passe In progress et Release exécute phases et tâches dans l'ordre : une tâche manuelle attend qu'on la termine, une tâche automatisée s'exécute et passe à la suivante. Quand tout est fait, la release est Completed. Entre les deux, quatre états disent qu'il se passe quelque chose :
| État | Ce que ça veut dire | Ce qu'on peut faire |
|---|---|---|
| Planned | Créée, pas démarrée. Le formulaire a été rempli, les variables ont leurs valeurs. | Éditer, replanifier dans le Planner, démarrer, ou démarrer automatiquement à une date |
| In progress | Une tâche au moins est active. La flèche orange du flow la désigne. | Terminer les tâches manuelles, ajouter ou déplacer des tâches à venir, Pause, Abort |
| Paused | Mise en pause par une personne. Rien n'avance, rien n'est perdu. | Resume, ou Abort |
| Failing | Une tâche automatisée a échoué. La release attend une décision sur cette tâche. | Retry, Skip ou Fail sur la tâche, Restart phase, Abort |
| Failed | On a choisi Fail sur la tâche en échec : la release est arrêtée, en échec déclaré. | Restart phase pour repartir d'une phase, ou Abort |
| Completed | Toutes les tâches terminées ou sautées. | Lire, exporter, mesurer. Plus rien ne bouge. |
| Aborted | Abandonnée volontairement, avec une raison saisie. | Lire le journal. Une release abandonnée reste dans l'historique. |
La règle à retenir
Une release ne connaît plus son template. Ce que vous modifiez dans une release en cours, une tâche ajoutée, une date déplacée, ne remonte jamais dans le template. Et ce que vous corrigez dans le template ne touche pas les releases déjà créées. Pour corriger un défaut pour de bon, on corrige le template ; pour sauver la release en cours, on la corrige elle.
Démarrer une release, et la faire avancer
| Façon | Comment | Dans Deploy guestbook |
|---|---|---|
| New release | Depuis le template : formulaire, puis Create et Start | Vos essais des modules 201 à 301 |
| REST API | Un outil externe appelle Release | Module 303 : la CI crée la release à l'ouverture de la pull request |
| Create Release task | Une release en crée une autre | Module 206 : la montée de version |
| Trigger | Un déclencheur crée une release quand sa condition est vraie | Décrit ci-dessous, non utilisé dans l'exercice |
Une fois démarrée, une release avance seule tant que ses tâches sont automatisées. Trois mécanismes la font attendre le bon moment :
| Mécanisme | Ce qui le débloque | Exemple |
|---|---|---|
| Gate | Une personne coche des conditions | Go / No Go |
| Wait for JSON event | Un événement reçu de l'extérieur, qui vérifie une condition | La pull request mergée dans Gitea |
| Scheduled start date | Une date et une heure | La fenêtre de mise en production |
Les triggers, en détail
Un trigger se crée sur un folder, onglet Triggers. Il désigne un template, les valeurs de ses variables, et ce qui le déclenche.
| Type | Ce qui le déclenche | Quand s'en servir |
|---|---|---|
| Webhook event trigger | Un événement reçu sur un point d'entrée, filtré par une condition | Créer une release à chaque pull request ouverte, sans passer par la CI |
| Time trigger | Une planification, à intervalle ou en expression cron | Une release de vérification chaque nuit, un rapport chaque lundi |
| Git trigger | Un nouveau commit vu en scrutant le dépôt | Quand l'outil Git ne sait pas envoyer d'événement |
Une expression cron tient en cinq ou six champs. 0 0 2 * * MON-FRI : à 2 heures, du lundi au vendredi.
Scruter ou être prévenu
Un trigger qui scrute interroge l'outil à intervalle régulier : simple, mais en retard d'un intervalle et bavard. Un webhook est prévenu à la seconde par l'outil lui-même. Quand l'outil sait envoyer un événement, préférez le webhook.
Les trois écrans de pilotage
| Écran | Ce qu'on y voit | Ce qu'on y fait |
|---|---|---|
| Release flow | Le même éditeur que pour le template, avec la flèche orange sur la tâche courante et les tâches terminées en gris, non modifiables. | Ouvrir une tâche, la terminer, la réassigner, ajouter une tâche ou une phase à venir. Boutons Abort et Restart phase. |
| Planner | Le diagramme de Gantt de la release : phases, tâches, durées, dépendances séquentielles. | Tirer le bord droit pour la durée, le bord gauche pour la date de début planifiée, déplacer une tâche. Une date de début planifiée bloque la tâche jusqu'à cette date. |
| History | La piste d'audit : qui a fait quoi, quand. Par défaut, seule la catégorie Important est affichée. | Filtrer par catégories (Release life cycle, Release edits, Task edits, Task assignment, Comments, Security), par personne ou action, par dates. Trier par la colonne Date. |
La History est la réponse à la question qui fâche chez Nexapay : « qui a dit Go, et quand ? ». L'ouverture d'un gate, le cochage de ses conditions, la saisie d'une raison d'abandon, tout y est, horodaté et nominatif.
Exercice 5.1 · Laisser Gitea faire avancer la release
30 minutes, chacun sur sa plateforme.
- Créer le point d'entrée. Folder
Sandbox, onglet Connections, ajoutez une connexion de type HTTP Endpoint for Webhooks :Champ Valeur Title giteaEndpoint path giteaAuthentication method No authentication - Remplacer la tâche manuelle. Dans la phase
int, ouvrezAttendre le merge vers intet changez son type en Webhook, Wait for JSON event. - La configurer. Champ Endpoint :
gitea. Champ Condition :# Gitea : merge d'une PR vers la branche int du guestbook pr = event.get('pull_request') or {} base = (pr.get('base') or {}).get('ref') repo = (event.get('repository') or {}).get('name') result = (event.get('action') == 'closed' and pr.get('merged') == True and base == 'int' and repo == 'guestbook')La condition lit l'événement reçu : la tâche se termine quandresultest vrai. - Démarrer une release. New release, puis Start. La phase dev se déroule et la release s'arrête sur l'attente.
- Merger dans Gitea. Dépôt
guestbook, New Pull Request dedevversint: elle porte votre changement de thème du module 202. Créez-la, puis mergez-la. - Regarder la release. Sans rien toucher dans Release, la tâche d'attente se termine et la phase int se déroule. Arrêtez-vous au gate et abandonnez la release.
La CI est rouge, c'est attendu
À l'ouverture de la pull request, Gitea lance une CI qui essaie de créer une release et échoue : elle ne connaît pas encore votre Release. Vous la branchez au module 303.
Ce que vous devez observer
La tâche Attendre le merge vers int passe à Completed dans les secondes qui suivent le merge. Dans Gitea, paramètres du dépôt, Webhooks, les livraisons récentes montrent l'événement envoyé et la réponse de Release.
Preuve attendue : la tâche d'attente terminée sans intervention, et la livraison de l'événement visible dans Gitea.
- Le point d'entrée
giteaexiste dans le folder. - L'attente du merge vers int est une tâche Wait for JSON event.
- Un merge dans Gitea fait avancer la release.
- L'application
guestbook-intaffiche le thème terminal.
Bonus · Attendre autre chose
Facultatif, 5 minutes.
La même tâche peut attendre un autre événement. Lisez ces deux conditions et dites ce que chacune attend :
result = event.get('commits') is not None and event.get('ref') == 'refs/heads/dev'result = (event.get('action') == 'reviewed'
and (event.get('review') or {}).get('type') == 'pull_request_review_approved')
Support d'exercices de l'offre de service Digital.ai Release - Administration (ACOSS) (OFR0004). Le cas Nexapay est fictif et l'outil Redmine est simulé pour la formation. Une erreur, une suggestion ? Écris à William Gravier, wgravier@arvida.fr.