M208 : Industrialiser vos templates, sandbox, version control et distribution
Traiter un template comme du code : versionner, relire, publier
Le folder Sandbox relié à la branche dev, le folder Published à la branche main, et une pull request entre les deux.
Ce que vous allez faire
Votre template fonctionne. Reste à le traiter comme du code : le versionner dans Git, savoir qui a changé quoi, et ne le mettre à disposition des autres équipes qu'après une relecture. Dans ce module, vous branchez votre folder Sandbox sur un dépôt Git, vous enregistrez une version de votre template, puis vous le publiez vers le folder Published par une pull request.
Votre point de départ
Le pré-template Deploy guestbook (301 done) est dans votre folder Sandbox. Votre dépôt Git de versioning existe déjà, avec ses deux branches dev et main. Le folder Published est déjà relié à la branche main.
Sandbox, Published et les deux branches
Un template se travaille dans un folder et s'utilise dans un autre. Chaque folder est relié à une branche du même dépôt Git.
| Folder Release | Branche Git | Ce que Release a le droit d'y faire | Qui s'en sert |
|---|---|---|---|
| Sandbox | dev | Lire et écrire : chaque version enregistrée est un commit | Les designers de templates |
| Published | main | Lire seulement : on récupère les commits, on ne modifie rien | Les équipes qui démarrent des releases |
La règle à retenir
On ne publie jamais depuis Release. Release écrit dans dev et lit main. Le passage de l'une à l'autre se fait dans Git, par une pull request : c'est là qu'une autre personne relit avant que le template n'arrive chez ceux qui l'utilisent.
Exercice 6.1 · Versionner et publier votre template
35 minutes, chacun sur sa plateforme. Les cinq premières étapes publient le template, les trois suivantes publient une modification.
- Créer la connexion Git. Menu de gauche Connections, au niveau racine, type Git Repository. Renseignez :Enregistrez, puis cliquez Test : la connexion doit répondre.
Champ Valeur Title Git et VersioningURL L'adresse de votre dépôt de versioning, celle qui se termine par .git:https://git.tulipe.arvida.tech/participant-N/<dépôt>.git, avec votre numéro à la place de NAuthentication method PAT (Personal Access Token) Password / PAT Votre jeton Gitea release-versioning, généré lors de la vérification de votre environnement - Brancher le folder Sandbox. Ouvrez le folder
Sandbox, Git Versioning : choisissez la connexionGit et Versioninget la branchedev. - Enregistrer une version. Toujours dans Git Versioning, créez une version avec le message
Deploy guestbook : première version. Release pousse le contenu du folder dans la branchedev. - Publier par une pull request. Dans Gitea, ouvrez votre dépôt de versioning, placez-vous sur la branche
dev, New Pull Request versmain. Créez-la, puis mergez avec Create merge commit. - Récupérer dans Published. Dans Release, ouvrez le folder
Published, Git Versioning, Fetch. Votre template apparaît dansPublished. - Modifier le template. Dans
Sandbox, renommez une tâche du template, puis enregistrez une nouvelle version avec un message qui dit ce que vous avez changé. - Relire et merger. Dans Gitea, ouvrez une pull request de
devversmainet regardez le diff : c'est ce qu'un relecteur verrait. Mergez. - Mettre à jour Published. Dans
Published, Git Versioning, Fetch : la tâche a changé de nom, sans que personne n'ait touché au folder à la main.
Ce que vous devez observer
Dans Gitea, la branche dev porte un commit avec votre message, et main le reçoit après le merge. Dans Release, le template de Published est identique à celui de Sandbox, et vous ne pouvez pas enregistrer de version depuis Published : la branche main est en lecture seule pour Release.
Preuve attendue : le commit de votre version sur la branche dev, la pull request mergée dans Gitea, le template présent dans le folder Published après Fetch, et la tâche renommée visible dans Published.
- La connexion Git répond au Test.
- Sandbox est relié à dev, et votre version est un commit visible dans Gitea.
- La pull request de dev vers main est mergée.
- Published contient le template après Fetch.
- Une modification faite dans Sandbox arrive dans Published après une seconde pull request.
Bonus · Essayer de publier depuis Release
Facultatif, 5 minutes. Rien dans la suite n'en dépend.
- Dans
Published, modifiez le titre d'une tâche du template, puis essayez d'enregistrer une version depuis Git Versioning. - Notez ce que Release répond, puis refaites Fetch pour revenir à la version publiée. Vous venez de vérifier la règle : on ne publie jamais depuis Release.
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.