M205 : Maîtriser les variables pour automatiser vos tickets
Remplacer ce qui est écrit en dur par des variables
Variables de release, de folder et globales : la bonne valeur au bon niveau.
Ce que vous allez faire
Votre template fonctionne, mais il ne fonctionne que pour vous : le projet ArgoCD, le namespace et l'adresse du dépôt y sont écrits en dur. Vous les remplacez par des variables, au bon niveau, pour que le même template serve à toute une équipe.
Votre point de départ
Le pré-template Deploy guestbook (201 done) est dans votre folder Sandbox si vous n'avez pas terminé le module 201. Les variables env et appname existent déjà, vous les avez créées au module 201 : appname reçoit le nom de l'application ArgoCD, rempli par la tâche de création.
À quoi sert une variable
Une variable est une valeur nommée, qu'on écrit ${nom} et que Release remplace au moment où il en a besoin : dans un titre, une description, un champ de tâche automatisée, un script.
| Situation | Dans Deploy guestbook |
|---|---|
| La valeur n'est pas connue quand on écrit le template | Le numéro du ticket Redmine, le numéro de la pull request |
| La même valeur sert à plusieurs endroits | ${env} dans les titres et les champs des trois phases |
| La valeur change d'une équipe à l'autre | Le projet ArgoCD, l'adresse du dépôt |
| Une tâche produit une valeur que les suivantes utilisent | Le ticket créé par une tâche, lu par la suivante |
Trois niveaux, trois écritures
Une variable appartient à un périmètre. Plus il est large, plus la valeur doit être stable.
| Niveau | Où on la crée | Écriture | Qui la voit | Pour quoi faire |
|---|---|---|---|---|
| Release | Dans le template, menu Variables, New variable | ${application} | Cette release seulement | Ce qui est propre à une livraison : ticket, pull request, résultats intermédiaires |
| Folder | Sur le folder, onglet Variables | ${folder.repoUrl} | Tous les templates et releases du folder et de ses sous-folders | Ce qui est commun à une équipe : adresses des outils, projet, destinataires |
| Global | Configuration, Global variables, réservé aux administrateurs | ${global.compte.applicatif.username} | Toute la plateforme | Ce qui est vrai partout : le compte technique |
Les trois périmètres, les variables du template Deploy guestbook, et qui remplit chacune. Elles arrivent au fil des modules 201 à 206.
Release fournit aussi des valeurs prêtes à l'emploi : ${release.title}, ${release.owner}, ${release.id}. Le modèle s'en sert pour nommer les applications ArgoCD : ${release.owner}-guestbook-${env}.
Créer une variable à la volée
Tapez ${ticketRedmine} dans un champ de tâche : si la variable n'existe pas, Release propose de la créer. Pratique, mais relisez ensuite son type et ses options dans le menu Variables.
Types et options
| Type | Ce qu'il apporte | Dans Deploy guestbook |
|---|---|---|
| Text | Une chaîne libre, le type par défaut | application, env, ticketRedmine |
| Password | Masquée à l'écran et dans la History | giteaToken |
| List box | Un choix fermé, sans faute de frappe | Une liste d'applications |
| Checkbox, Number, Date | Une valeur typée, contrôlée à la saisie | Une date de fenêtre de mise en production |
| Option | Effet |
|---|---|
| Label, Description | Ce que la personne lit dans le formulaire de démarrage |
| Required | La release ne démarre pas sans valeur |
| Show on Create Release form | La variable est demandée au démarrage. Une variable remplie en cours de route reste décochée |
| Default value | Pré-remplit le formulaire |
Exercice 3.1 · Sortir du template ce qui est écrit en dur
20 minutes, chacun sur sa plateforme.
- Repérer. Ouvrez la tâche
Créer l'application ArgoCD guestbook-dev. Trois champs portent une valeur qui vous est propre : Project, Namespace et l'adresse du dépôt. Un quatrième, Application name, contient le motguestbooken dur. - Créer deux variables de folder. Sur le folder
Sandbox, onglet Variables :Clé Type Valeur folder.argoProjectText participant-N, avec votre numérofolder.repoUrlText https://gitea.tulipe.arvida.tech/participant-N/guestbook.git - Créer une variable de release. Dans le template, menu Variables : clé
namespace, type Text, valeur par défauttulipe-participant-N, non demandée au démarrage. - Remplacer dans la tâche dev. Dans la tâche de création ArgoCD de la phase dev, remplacez les trois valeurs par
${folder.argoProject},${namespace}et${folder.repoUrl}. - Reporter sur int et prod. Faites la même chose dans les deux autres tâches de création.
- Demander l'application au démarrage. Créez une variable de release
application: labelApplication à livrer, valeur par défautguestbook, Required et Show on Create Release form cochés. Dans les trois tâches de création, le champ Application name devient${release.owner}-${application}-${env}. - Vérifier. Démarrez une release : le formulaire demande l'application. Laissez la phase dev se dérouler puis abandonnez la release avec Abort.
Ce que vous devez observer
Le formulaire de démarrage affiche « Application à livrer ». La tâche de création ArgoCD réussit comme avant : Release a remplacé les trois variables par leurs valeurs, visibles dans la tâche terminée.
Preuve attendue : les deux variables dans l'onglet Variables du folder, et la tâche de création ArgoCD de la phase dev réussie.
- Plus aucune valeur
participant-Nen dur dans les trois tâches de création. - Deux variables de folder et deux variables de release créées.
applicationest demandée au démarrage avec un libellé lisible.
Bonus · Une variable créée à la volée
Facultatif, 5 minutes.
- Dans la description du gate
Go / No Go, écrivezTicket Redmine : ${ticketRedmine}et acceptez la création de la variable. - Dans le menu Variables, décochez Required et Show on Create Release form : une tâche la remplira au module 206.
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.