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.
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.
| Sens | Ce qui passe | Par quoi | Vu au module |
|---|---|---|---|
| Gitea vers Release | « Crée une release depuis ce template » | La CI, qui appelle l'API de Release avec un jeton | 303 |
| 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 gitea | 301 |
| Release vers Gitea | « Merge int vers main » | Une tâche Webhook, avec le compte de service | 206 |
La CI du guestbook compte deux jobs, lancés sur les pull requests de dev vers int :
| Job | Quand | Ce qu'il fait |
|---|---|---|
build | À chaque ouverture ou mise à jour de la pull request | Construit l'application |
release | À l'ouverture ou la réouverture | Cré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
| Nom | Sorte | Valeur |
|---|---|---|
XLR_URL | Variable | L'adresse de votre Release : https://participant-N.tulipe.arvida.tech |
XLR_TEMPLATE_ID | Variable | L'identifiant de votre template, déduit de son adresse |
XLR_TOKEN | Secret | Un 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.
- Reprendre votre jeton. Retrouvez le jeton
ci-guestbookgé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. - Relever l'identifiant du template. Ouvrez votre template
Deploy guestbook: son adresse se termine par#/templates/Folderxxx-Releasexxx. L'identifiant à noter s'écritApplications/Folderxxx/Releasexxx: ajoutezApplications/devant et remplacez le tiret par une barre oblique. - Paramétrer la CI. Dans Gitea, dépôt
guestbook, Settings, Actions. Dans Variables, créezXLR_URLavec la valeurhttps://participant-N.tulipe.arvida.techetXLR_TEMPLATE_IDavec l'identifiant relevé. Dans Secrets, créezXLR_TOKENavec le jeton. - Faire une modification. Branche
dev, fichiervalues.yaml: repassez le thème àclairavec le message de commitretour au thème clair. - Ouvrir la pull request. New Pull Request de
devversint, puis Create. Ne la mergez pas encore. - 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. - Retrouver la release. Dans Release, une release
guestbook: retour au thème clairest en cours, sans que vous l'ayez créée. Elle déploie sur dev puis attend. - 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.
- Dans les variables Actions, ajoutez une lettre à la fin de
XLR_TEMPLATE_ID. - Sur
dev, modifiez un commentaire devalues.yaml, ouvrez une nouvelle pull request versintet lisez l'erreur du jobrelease. - 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.