M101 : Terminologie et principes de conception
Traduire le récit d'un release manager en template
Les objets de Release, puis un premier template manuel sur trois environnements, lancé à la main.
Ce que vous allez faire
Avant d'ouvrir l'éditeur, il faut savoir nommer les choses. Dans ce module, vous apprenez les objets de Release, puis vous traduisez le récit d'un release manager en un premier template, que vous lancez à la main.
Votre point de départ
Aucun pré-template : vous partez d'un template vide, dans votre folder Sandbox, que vous créez dans cet exercice au sein du dossier racine Guestbook.
Les objets de Release
Release organise tout autour d'un petit nombre d'objets. Les noms sont ceux de l'interface, en anglais ; ce sont ceux que vous retrouverez dans les slides et dans les menus. Les connaître évite l'erreur la plus fréquente des débutants : tout mettre dans des tâches manuelles au même niveau.
| Objet | Ce que c'est | Dans Nexapay |
|---|---|---|
| Folder | Le rangement et le périmètre de sécurité. Il porte les permissions, les variables partagées, les connexions. | Nexapay › Sandbox, votre espace de travail |
| Template | Le modèle d'une release : la liste ordonnée de ce qu'il faut faire, sans date ni valeur réelle. | Deploy guestbook |
| Release | Une exécution du template, avec des valeurs, des dates, des personnes et un historique. | « guestbook: ajout du thème terminal » |
| Phase | Un chapitre de la release. Les phases s'enchaînent dans l'ordre. | dev, int, prod |
| Task (manuelle) | Une action qu'une personne doit faire et déclarer terminée. Elle a un responsable, une durée planifiée, une description. | « Valider la recette sur int » |
| Automated task | Une action que Release exécute seul : appel d'API, script, tâche d'un plugin. Elle réussit ou échoue. | Synchroniser l'application ArgoCD, créer le ticket dans Redmine |
| Gate | Un point d'arrêt qui attend des conditions cochées à la main et des dépendances. Rien ne passe tant qu'il n'est pas ouvert. | Go / No Go avant prod |
| Parallel group | Un conteneur dont les tâches s'exécutent en même temps. Par défaut, les tâches d'une phase sont séquentielles. | Tests fonctionnels et tests de performance sur int |
| Variable | Une valeur nommée, réutilisée partout avec ${nom}. Elle peut être demandée au démarrage, calculée, ou masquée (mot de passe). | ${appname}, ${env}, ${ticketRedmine}, ${giteaToken} |
| Precondition | Une règle évaluée avant une tâche : si elle est fausse, la tâche est sautée. | Ne déployer en prod que si aucune étape n'a échoué |
| Failure handler | Ce que Release fait quand une tâche automatisée échoue : relancer, sauter, redémarrer la phase. | Relancer un appel d'API tombé sur une limite de débit |
| Tag | Une étiquette libre sur une tâche, pour filtrer et sécuriser. | production sur toutes les tâches de prod |
| Trigger | Ce qui démarre une release sans clic : une planification, un événement reçu. | Module 301 : un événement Gitea fait avancer la release, un trigger peut la créer |
| Delivery pattern | Un train qui synchronise plusieurs releases sur des étapes communes. | Train trimestriel Nexapay : guestbook, payment-api et fraud-detection |
| Dashboard | Des tuiles d'indicateurs calculés sur les releases passées. | Durée moyenne d'un passage en prod, taux d'échec |
Les états à connaître
Une tâche est Planned, puis In progress, puis Completed, Skipped ou Failed. Une phase prend l'état de ses tâches. Une release est Planned, In progress, Paused, Failing, Completed ou Aborted. Quand une tâche automatisée échoue, la release passe en Failing et attend une décision : réessayer, sauter, ou abandonner.
Ce que dit le release manager
Voici comment le release manager de Nexapay décrit une livraison de guestbook. C'est votre matière première.
Le récit
« Quand une nouvelle version est prête, je crée un ticket Redmine. Un ops la déploie sur dev et vérifie que l'application répond. Le développeur merge ensuite vers int, un ops déploie sur int et les testeurs valident la recette. On se réunit pour le Go / No Go. Si c'est oui, un ops déploie en prod, puis je clos le ticket. »
Exercice 1.1 · Votre premier template, à la main
20 minutes, chacun sur sa plateforme. Aucune automatisation : uniquement des tâches manuelles.
- Créer l'arborescence. Si ce n'est pas déjà fait, créez le dossier racine
Guestbookà la racine de Release, puis, à l'intérieur, le sous-folderSandbox: c'est votre espace de travail pour toute la formation. - Créer le template. Dans votre folder
Sandbox, onglet Templates, créez un nouveau template nomméLivraison manuelle guestbook. - Poser les trois phases. Renommez la phase existante en
dev, puis ajoutez les phasesintetprodavec Add phase. Donnez une couleur différente à chacune. - Traduire le récit en tâches. Le récit contient neuf actions : créez neuf tâches de type Task avec Add task, réparties dans les trois phases. À vous de choisir les titres. Chaque fois qu'un titre cite l'application, écrivez la variable à la place de son nom. Exemple :
Déployer ${application} sur dev. - Créer la variable. Ouvrez le menu Variables du template, puis New variable. Exemple à reproduire :
Champ Valeur Name applicationLabel Application à livrerType Text Required Coché Show on Create Release form Coché : c'est cette option qui affiche la variable sur le formulaire de création de la release - Utiliser la variable dans une description. Dans la description d'une de vos tâches, écrivez une phrase qui utilise la variable. Exemple :
Mise en production de ${application}, demandée par ${release.owner}. - Démarrer une release. Bouton New release : le formulaire demande l'application. Saisissez
guestbook, puis Create et Start. - Dérouler à la main jusqu'en production. La release s'arrête sur chaque tâche et attend. Pour avancer, cliquez sur la tâche en cours, puis Assign to me, puis Complete : la release passe à la tâche suivante. Recommencez sur chaque tâche, phase
dev, puisint, puisprod, jusqu'à ce que la release soit Completed. - Tester la variable. Démarrez une seconde release avec la valeur
payment-apiet comparez les titres des tâches des deux releases. Abandonnez cette seconde release avec Abort.
Ce que vous devez observer
Dans la release, un titre écrit Déployer ${application} sur dev s'affiche Déployer guestbook sur dev : Release a remplacé la variable par la valeur saisie au démarrage. Votre description porte l'application et votre nom. La seconde release affiche payment-api partout, sans que le template ait changé.
Bonus · Passer en Table view
Facultatif, 5 minutes.
- Dans votre template, passez du Flow à la Table view : toutes les tâches tiennent sur un écran.
- Renseignez une durée planifiée de 10 minutes sur chaque tâche de déploiement.
Preuve attendue : une release Completed dont les titres portent guestbook, et une seconde release dont les titres portent payment-api.
- Le dossier racine
Guestbooket son sous-folderSandboxexistent. - Le template compte trois phases et neuf tâches manuelles.
- La variable
applicationest demandée au démarrage. - Une release complète a été déroulée à la main.
- La même variable donne des titres différents dans deux releases.
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.