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

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

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.

Durée 1 h 30Exercice 35 minJour 1Livrable template publié

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 ReleaseBranche GitCe que Release a le droit d'y faireQui s'en sert
SandboxdevLire et écrire : chaque version enregistrée est un commitLes designers de templates
PublishedmainLire seulement : on récupère les commits, on ne modifie rienLes équipes qui démarrent des releases
Folder SandboxRelease · vous modifiezBranche devGit · lecture et écritureBranche mainGit · lecture seule pour ReleaseFolder PublishedRelease · on démarre les releases1 · version2 · pull request3 · Fetch

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.

  1. Créer la connexion Git. Menu de gauche Connections, au niveau racine, type Git Repository. Renseignez :
    ChampValeur
    TitleGit et Versioning
    URLL'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 N
    Authentication methodPAT (Personal Access Token)
    Password / PATVotre jeton Gitea release-versioning, généré lors de la vérification de votre environnement
    Enregistrez, puis cliquez Test : la connexion doit répondre.
  2. Brancher le folder Sandbox. Ouvrez le folder Sandbox, Git Versioning : choisissez la connexion Git et Versioning et la branche dev.
  3. 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 branche dev.
  4. Publier par une pull request. Dans Gitea, ouvrez votre dépôt de versioning, placez-vous sur la branche dev, New Pull Request vers main. Créez-la, puis mergez avec Create merge commit.
  5. Récupérer dans Published. Dans Release, ouvrez le folder Published, Git Versioning, Fetch. Votre template apparaît dans Published.
  6. 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é.
  7. Relire et merger. Dans Gitea, ouvrez une pull request de dev vers main et regardez le diff : c'est ce qu'un relecteur verrait. Mergez.
  8. 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.

  1. Dans Published, modifiez le titre d'une tâche du template, puis essayez d'enregistrer une version depuis Git Versioning.
  2. 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.