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

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

M303 : Intégrer la chaîne CI/CD avec Gitea

Une pull request crée la release

La CI de Gitea appelle Release : plus personne n'ouvre l'outil pour demander une livraison.

Durée 1 h 30Exercice 35 minJour 2

Ce que vous allez faire

Personne ne devrait avoir à ouvrir Release pour demander une livraison. Vous branchez la CI de Gitea sur votre Release : ouvrir une pull request crée et démarre la release.

Votre point de départ

Le pré-template Deploy guestbook (301 done) est dans votre folder Sandbox si besoin. Le dépôt guestbook contient déjà son workflow de CI, .gitea/workflows/ci.yml : vous ne l'écrivez pas, vous le paramétrez.

Qui parle à qui

Deux flux relient Gitea et Release, dans les deux sens.

SensCe qui passePar quoiVu au module
Gitea vers Release« Crée une release depuis ce template »La CI, qui appelle l'API de Release avec un jeton303
Gitea vers Release« Cette pull request vient d'être mergée »Le webhook du dépôt, reçu par le point d'entrée gitea301
Release vers Gitea« Merge int vers main »Une tâche Webhook, avec le compte de service206

La CI du guestbook compte deux jobs, lancés sur les pull requests de dev vers int :

JobQuandCe qu'il fait
buildÀ chaque ouverture ou mise à jour de la pull requestConstruit l'application
releaseÀ l'ouverture ou la réouvertureCrée une release depuis votre template et la démarre. Son titre : guestbook: <titre du dernier commit>

Un job s'exécute sur un runner : un agent enregistré auprès de Gitea, qui prend les jobs en attente et les exécute. Sans runner disponible, un job reste en file d'attente.

Ce dont la CI a besoin

NomSorteValeur
XLR_URLVariableL'adresse de votre Release : https://participant-N.tulipe.arvida.tech
XLR_TEMPLATE_IDVariableL'identifiant de votre template, déduit de son adresse
XLR_TOKENSecretUn jeton d'accès personnel créé dans Release

Trouver l'identifiant du template

Ouvrez votre template : son adresse se termine par #/templates/Folderxxx-Releasexxx. L'identifiant s'écrit Applications/Folderxxx/Releasexxx : on ajoute Applications/ devant, et le tiret devient une barre oblique.

Avec Jenkins ou GitLab CI

Le principe est le même quel que soit l'outil : une étape du pipeline appelle l'API de Release pour créer la release, avec l'adresse, l'identifiant du template et un jeton. Seule la syntaxe du pipeline change. Digital.ai fournit aussi un plugin Jenkins qui fait cet appel pour vous.

Exercice 7.1 · La pull request qui crée la release

35 minutes, chacun sur sa plateforme.

  1. Reprendre votre jeton. Retrouvez le jeton ci-guestbook généré lors de la vérification de votre environnement. Si vous ne l'avez plus, créez-en un : dans Release, votre profil en haut à droite, Access tokens. Il n'est affiché qu'une fois.
  2. Relever l'identifiant du template. Ouvrez votre template Deploy guestbook : son adresse se termine par #/templates/Folderxxx-Releasexxx. L'identifiant à noter s'écrit Applications/Folderxxx/Releasexxx : ajoutez Applications/ devant et remplacez le tiret par une barre oblique.
  3. Paramétrer la CI. Dans Gitea, dépôt guestbook, Settings, Actions. Dans Variables, créez XLR_URL avec la valeur https://participant-N.tulipe.arvida.tech et XLR_TEMPLATE_ID avec l'identifiant relevé. Dans Secrets, créez XLR_TOKEN avec le jeton.
  4. Faire une modification. Branche dev, fichier values.yaml : repassez le thème à clair avec le message de commit retour au thème clair.
  5. Ouvrir la pull request. New Pull Request de dev vers int, puis Create. Ne la mergez pas encore.
  6. Suivre la CI. Onglet Actions du dépôt : ouvrez l'exécution, puis le job release. Retrouvez dans son journal l'appel envoyé à Release.
  7. Retrouver la release. Dans Release, une release guestbook: retour au thème clair est en cours, sans que vous l'ayez créée. Elle déploie sur dev puis attend.
  8. Merger. Dans Gitea, mergez la pull request. La release reprend, déploie sur int et s'arrête au gate. Laissez-la là : vous la terminerez au module 206.

Ce que vous devez observer

Vous n'avez cliqué sur aucun bouton de Release : la release est née de la pull request et a avancé à le merge. Son titre reprend le message de votre commit.

Preuve attendue : le job release en vert dans Gitea, et la release arrêtée au gate dans Release.

  • Les deux variables et le secret sont en place dans Gitea.
  • L'ouverture de la pull request a créé la release.
  • Le merge a fait avancer la release jusqu'au gate.

Bonus · Quand la CI ne peut pas joindre Release

Facultatif, 5 minutes.

  1. Dans les variables Actions, ajoutez une lettre à la fin de XLR_TEMPLATE_ID.
  2. Sur dev, modifiez un commentaire de values.yaml, ouvrez une nouvelle pull request vers int et lisez l'erreur du job release.
  3. Remettez la bonne valeur, fermez la pull request sans la merger.

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.