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

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

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.

Durée 1 hExercice 20 minJour 1

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.

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.

ObjetCe que c'estDans Nexapay
FolderLe 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
TemplateLe modèle d'une release : la liste ordonnée de ce qu'il faut faire, sans date ni valeur réelle.Deploy guestbook
ReleaseUne exécution du template, avec des valeurs, des dates, des personnes et un historique.« guestbook: ajout du thème terminal »
PhaseUn 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 taskUne 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
GateUn 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 groupUn 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
VariableUne 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}
PreconditionUne 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 handlerCe 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
TagUne étiquette libre sur une tâche, pour filtrer et sécuriser.production sur toutes les tâches de prod
TriggerCe 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 patternUn train qui synchronise plusieurs releases sur des étapes communes.Train trimestriel Nexapay : guestbook, payment-api et fraud-detection
DashboardDes 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.

  1. Créer le template. Dans votre folder Sandbox, onglet Templates, créez un nouveau template nommé Livraison manuelle guestbook.
  2. Poser les trois phases. Renommez la phase existante en dev, puis ajoutez les phases int et prod avec Add phase. Donnez une couleur différente à chacune.
  3. 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.
  4. Créer la variable. Ouvrez le menu Variables du template, puis New variable. Exemple à reproduire :
    ChampValeur
    Nameapplication
    LabelApplication à livrer
    TypeText
    RequiredCoché
    Show on Create Release formCoché : c'est cette option qui affiche la variable sur le formulaire de création de la release
  5. 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}.
  6. Démarrer une release. Bouton New release : le formulaire demande l'application. Saisissez guestbook, puis Create et Start.
  7. 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, puis int, puis prod, jusqu'à ce que la release soit Completed.
  8. Tester la variable. Démarrez une seconde release avec la valeur payment-api et 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é.

Preuve attendue : une release Completed dont les titres portent guestbook, et une seconde release dont les titres portent payment-api.

  • Le template compte trois phases et neuf tâches manuelles.
  • La variable application est 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.

Bonus · Passer en Table view

Facultatif, 5 minutes.

  1. Dans votre template, passez du Flow à la Table view : toutes les tâches tiennent sur un écran.
  2. Renseignez une durée planifiée de 10 minutes sur chaque tâche de déploiement.

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.