Formation Arvida›Digital.ai Release›Cas d'usage Nexapay›Module 301

Sommaire
ARVIDA OFFRE DE SERVICE Digital.ai Release · OFR0004-301

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.

Durée 1 hExercice 30 minJour 1

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 :

ÉtatCe que ça veut direCe qu'on peut faire
PlannedCréé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 progressUne 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
PausedMise en pause par une personne. Rien n'avance, rien n'est perdu.Resume, ou Abort
FailingUne 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
FailedOn 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
CompletedToutes les tâches terminées ou sautées.Lire, exporter, mesurer. Plus rien ne bouge.
AbortedAbandonné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çonCommentDans Deploy guestbook
New releaseDepuis le template : formulaire, puis Create et StartVos essais des modules 201 à 301
REST APIUn outil externe appelle ReleaseModule 303 : la CI crée la release à l'ouverture de la pull request
Create Release taskUne release en crée une autreModule 206 : la montée de version
TriggerUn déclencheur crée une release quand sa condition est vraieDé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écanismeCe qui le débloqueExemple
GateUne personne coche des conditionsGo / No Go
Wait for JSON eventUn événement reçu de l'extérieur, qui vérifie une conditionLa pull request mergée dans Gitea
Scheduled start dateUne date et une heureLa 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.

TypeCe qui le déclencheQuand s'en servir
Webhook event triggerUn événement reçu sur un point d'entrée, filtré par une conditionCréer une release à chaque pull request ouverte, sans passer par la CI
Time triggerUne planification, à intervalle ou en expression cronUne release de vérification chaque nuit, un rapport chaque lundi
Git triggerUn nouveau commit vu en scrutant le dépôtQuand 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

ÉcranCe qu'on y voitCe qu'on y fait
Release flowLe 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.
PlannerLe 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.
HistoryLa 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.

  1. Créer le point d'entrée. Folder Sandbox, onglet Connections, ajoutez une connexion de type HTTP Endpoint for Webhooks :
    ChampValeur
    Titlegitea
    Endpoint pathgitea
    Authentication methodNo authentication
  2. Remplacer la tâche manuelle. Dans la phase int, ouvrez Attendre le merge vers int et changez son type en Webhook, Wait for JSON event.
  3. 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 quand result est vrai.
  4. Démarrer une release. New release, puis Start. La phase dev se déroule et la release s'arrête sur l'attente.
  5. Merger dans Gitea. Dépôt guestbook, New Pull Request de dev vers int : elle porte votre changement de thème du module 202. Créez-la, puis mergez-la.
  6. 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 gitea existe 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-int affiche 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.

🔒 Propriété d'ARVIDA SAS · Support réservé aux participants de la formation OFR0004, toute reproduction ou diffusion interdite.