Aller au contenu
Blogue Krizaka

11

Comment on a construit notre CI

15–25 oct. 202620 min de lecture

Ce que j'ai affronté, Des pull requests d'agents à vérifier une par une; Ce qu'on a construit, un pipeline commun, et des règles qui ne reculent pas

Un canal à l'aube bordé d'usines de brique, un petit train vert sur le quai, son reflet dans l'eau calme

Depuis quelques semaines, des gens du métier me posent la même question. Comment vous faites votre CI, avec autant de dépôts et des agents qui ouvrent des pull requests toute la journée ?

Je réponds ici, une fois, avec les vrais fichiers. Tout ce que je montre est dans des dépôts publics de l'organisation krizaka. Vous pouvez aller vérifier chaque ligne.

Pourquoi une CI commune

Au début, chaque dépôt avait son propre fichier de CI. On copiait celui du voisin et on l'adaptait un peu. Un correctif dans un dépôt n'arrivait jamais dans les autres.

Dans le chapitre sur les agents, je parlais d'un « build pack » pour la CI, pas encore livré. Une partie est livrée. Le dépôt krizaka/.github contient des workflows réutilisables, un par type de projet : node-ci.yml, java-ci.yml, python-ci.yml, expo-ci.yml, maven.yml, mobile-e2e.yml. Chaque dépôt en appelle un, et ne dit que ce qui lui est propre.

Voici celui de krizaka.com, dans krizaka-com/.github/workflows/ci.yml (raccourci) :

yaml
jobs:
  ci:
    uses: krizaka/.github/.github/workflows/node-ci.yml@1cb2e1b6f572ba712083cb6f05fd041370c5ea0b # v1.5.0
    permissions:
      contents: read
    with:
      duplication: true      # jscpd + dup-ratchet.json: duplicated lines may only go down
      next-cache-paths: .next/cache
      container: true
      container-smoke: scripts/ci-container-smoke.sh

Le workflow est épinglé par son SHA, pas par un tag. Un tag peut bouger, un SHA non. Le commentaire # v1.5.0 dit quelle version c'est, et Dependabot propose la mise à jour, dans une PR qui passe par la même CI que le reste.

Orazaka a son propre pipeline, component.yml, dans le dépôt krizaka/orazaka. Un composant d'Orazaka ne se construit jamais seul : la CI clone tout le workspace, met le dépôt testé à sa place, et construit d'abord ses dépendances depuis leur source.

Le build pack complet, celui où chaque dépôt n'aurait qu'une ligne, n'existe toujours pas. Aujourd'hui, c'est un appel et quelques options. C'est déjà beaucoup mieux que des copies.

Le chemin d'une pull request

Voici ce qui se passe, pour krizaka.com, entre le moment où une PR s'ouvre et le moment où le changement est en ligne.

D'une pull request à la production (krizaka.com)
  1. Pull request (ouverte par un agent)L'agent pousse sa branche, ouvre la PR et arme la fusion automatique. Il ne fusionne rien lui-même.
  2. changes (docs seulement ?)Un premier job regarde les fichiers touchés. Une PR qui ne change que de la documentation saute les jobs lourds. Si ce job casse, tout tourne quand même.
  3. verify (lint, cliquets, tests)Installation avec cache, lint, les cliquets, la vérification des types, les tests avec leur couverture, puis le build. C'est la première porte : l'image et SonarCloud l'attendent.
  4. container (après verify)Quand verify est vert, l'image Docker est construite, analysée par Trivy (une faille corrigeable de niveau élevé ou critique fait échouer le job) et accompagnée d'un SBOM. Puis elle est lancée, et un vrai navigateur vérifie les pages, de 360 à 1440 pixels, en sombre et en clair. Plus d'image construite pour rien quand le lint ou les tests échouent. L'image d'une PR n'est jamais publiée.
  5. CodeQL (vérification à part, exigée, en parallèle de tout)Activé par défaut côté GitHub et imposé par une règle de l'organisation. Il lit le code source, n'a besoin ni du build ni des tests, et tourne dès l'ouverture de la PR, hors de notre workflow. Il bloque une alerte de sécurité grave.
  6. SonarCloud (après les tests, dans le pipeline)Une analyse faite dans notre CI, après verify, avec la couverture des tests ; on attend son quality gate. C'est le cas de krizaka.com, Akinaza et Yomizaka. Les autres dépôts gardent l'analyse automatique pour l'instant.
  7. CI gate (un seul verdict)Un job lit le résultat de verify, container, SonarCloud et des autres jobs du workflow, et rend un verdict. C'est lui qui est exigé sur main, avec CodeQL, qui reste une vérification à part.
  8. Squash sur main (la protection décide)Quand tout est vert, GitHub fusionne. C'est la protection de branche qui décide, pas l'agent.
  9. release-please (PR de version)Un bot tient une PR de version à jour. Quand je la fusionne, il crée le tag vX.Y.Z et la release.
  10. production (avance, déploie)La branche production avance jusqu'au tag, sans jamais forcer, et DigitalOcean déploie depuis production.

Une chose à lire dans ce schéma : après verify, l'image et SonarCloud tournent côte à côte, et CodeQL tourne depuis le début, en parallèle de tout. Les flèches disent l'ordre du récit, pas celui de l'exécution. La liste en dessous donne le détail.

Le point le plus important, c'est la case 7. Une PR peut sauter des jobs, légitimement : une PR de documentation n'a pas besoin d'un build Docker. Mais une vérification exigée qui ne s'affiche jamais bloque la PR pour toujours. Et une vérification qui passe au vert parce qu'un job a été sauté par erreur, c'est pire.

Alors un seul job, CI gate, tourne toujours, et il décide. Un extrait, dans .github/.github/workflows/node-ci.yml :

yaml
  gate:
    name: CI gate
    needs: [changes, ui-changes, docker-changes, plan, verify, e2e, duplication, container, sonar]
    if: ${{ always() }}

Et la règle qu'il applique, dans le même fichier :

bash
# The heavy jobs run unless the gate answered exactly `false`: a skip without that answer is a bug, not a pass.
if [ "$CODE" != "false" ]; then
  [ "$VERIFY" = success ] || { echo "::error::verify must run when the gate did not answer false"; fail=1; }
fi

Un job sauté n'est accepté que si le premier job a dit, exactement, « rien à faire ». Le reste du temps, sauter, c'est échouer.

Ce qui est exigé sur main

Sur la branche main de nos dépôts, GitHub refuse une fusion tant que certaines vérifications ne sont pas vertes. Pour krizaka.com, Akinaza ou Yomizaka, ce sont :

  • ci / CI gate, le verdict du pipeline ;
  • SonarCloud Code Analysis, exigé dans 25 dépôts depuis le 25 octobre ;
  • pour les deux applications mobiles, mobile-e2e / gate, j'y reviens plus bas.

CodeQL passe par une autre porte : l'analyse de code est activée par défaut côté GitHub, et une règle de l'organisation l'impose. C'est une vérification à part, exigée pour fusionner, qui tourne en parallèle du reste. Elle bloque une PR qui apporte une erreur, ou une alerte de sécurité de niveau élevé ou critique.

SonarCloud est sur le plan Team depuis le 26 octobre. On garde le quality gate par défaut, qui juge surtout le nouveau code. Pour krizaka.com, Akinaza et Yomizaka, l'analyse se fait maintenant dans notre CI, après les tests, avec la couverture : c'est un job du workflow, et son résultat entre dans le CI gate. L'application GitHub continue de poster la vérification SonarCloud Code Analysis, la même qu'avant. Pour les autres dépôts, c'est encore l'analyse automatique, qui ne lit pas la couverture : la condition « 80 % sur le nouveau code » n'y est pas évaluée.

OpenSSF Scorecard tourne aussi, chaque semaine et quand la protection d'une branche change. Il n'est pas exigé, et c'est voulu : il ne tourne jamais sur une PR, donc il ne pourrait pas l'être. Il nous dit si nos pratiques tiennent, il ne bloque rien.

La protection s'applique aussi aux administrateurs, donc à moi. L'historique reste linéaire, et une conversation de relecture doit être résolue avant la fusion. Il n'y a aucune approbation obligatoire. On est une seule personne à relire. Je ne voulais pas d'un deuxième compte ou d'un bot qui approuve dès que la CI est verte : ce serait une signature vide. La relecture, je la fais. Le droit de fusionner, c'est la CI qui le donne.

Les cliquets : la dette ne fait que descendre

Un cliquet, c'est la pièce qui laisse tourner une roue dans un seul sens. On en a trois, et ils marchent tous de la même façon. Un fichier dans le dépôt garde un compte. La CI recompte. Si le compte monte, elle refuse.

  • lint-ratchet compte des dettes d'interface : une couleur écrite en dur au lieu d'un token, un fetch dans un effet côté client, un import direct de TanStack au lieu de notre façade. L'outil s'appelle krizaka-ratchet, il vient du paquet @krizaka/config.
  • sg-ratchet compte les violations de nos règles ast-grep, règle par règle.
  • dup-ratchet compte les lignes dupliquées, avec jscpd. Pour krizaka.com, le compte est à zéro.

Le cœur de sg-ratchet tient en quelques lignes, dans krizaka-com/scripts/sg-ratchet.mjs :

js
for (const id of [...ruleIds].sort()) {
  const current = found[id] ?? 0;
  if (!(id in recorded)) {
    unrecorded.push(id);
    next[id] = current;
    continue;
  }
  if (current > recorded[id]) increased.push(id);
  if (current < recorded[id]) decreased.push(id);
  next[id] = Math.min(recorded[id], current);
}

La dernière ligne est la règle. Quand on corrige des violations, on enregistre le nouveau compte, et Math.min fait qu'on ne peut jamais l'augmenter de cette façon. Une règle sans compte enregistré fait échouer la CI aussi : on ne peut pas ajouter une règle en douce.

Pourquoi pas tout corriger d'un coup ? Parce qu'une nouvelle règle trouve souvent des dizaines de cas. Les corriger tous dans la même PR, c'est une PR énorme que personne ne relit bien. Avec un cliquet, la règle protège tout de suite le nouveau code, et la dette existante descend petit à petit.

Sur krizaka.com, le compte des tableaux et formulaires écrits à la main le montre bien. À l'arrivée du compteur, le 12 octobre, il en trouvait 20. Deux jours plus tard, quatre changements l'avaient fait passer à 11, 8, 3, puis 2, et il est resté à 2 depuis. Personne ne peut en ajouter un troisième.

Un compteur qui ne fait que descendre : les tableaux et formulaires écrits à la main sur krizaka.com, tels qu'enregistrés dans son lint-ratchet.json.

Lu dans l'historique du lint-ratchet.json de krizaka-com (compteur localTableOrForm), le 30 octobre.

Graphique en barres, 6 (12 octobre – 30 octobre). Compte enregistré : de 20 à 2, minimum 2 (14 octobre, 4e changement), maximum 20 (12 octobre), en baisse de 90 %.

Un compteur qui ne fait que descendre : les tableaux et formulaires écrits à la main sur krizaka.com, tels qu'enregistrés dans son lint-ratchet.json. — données
ÉlémentCompte enregistré
12 octobre20
14 octobre, 1er changement11
14 octobre, 2e changement8
14 octobre, 3e changement3
14 octobre, 4e changement2
30 octobre2
Un compteur qui ne fait que descendre : les tableaux et formulaires écrits à la main sur krizaka.com, tels qu'enregistrés dans son lint-ratchet.json.

Un bug devient une règle

C'est l'habitude qui a le plus changé notre façon de travailler. Quand on trouve un bug, on se demande s'il est seul, ou s'il fait partie d'une famille. Si c'est une famille, on écrit une règle qui la refuse, avec ses tests.

Le premier exemple vient d'Akinaza. Un test de confidentialité vérifiait qu'un webhook ne laissait pas fuir le numéro de téléphone d'un client. Il cherchait « 514 » dans le contenu envoyé. Mais ce contenu contient des identifiants aléatoires, et environ une fois sur dix, un UUID contient « 514 ». Le test échouait au hasard. On l'a vu dans Akinaza : cinq échecs dans un seul passage de CI, qui passaient en le relançant.

On aurait pu relancer et passer à autre chose. On a écrit rules/no-bare-digits-on-serialized.yml :

yaml
id: no-bare-digits-on-serialized
language: Tsx
severity: error
rule:
  pattern: expect(JSON.stringify($$$A)).not.toMatch($R)
constraints:
  R:
    regex: "^/(?:[^/]*\\|)?[0-9]+(?:\\|[^/]*)?/[a-z]*$"

Chaque règle a ses tests, des cas valides et des cas refusés, dans rule-tests/no-bare-digits-on-serialized-test.yml :

yaml
valid:
  - |
    expect(JSON.stringify(m)).not.toMatch(/\bIA\b|intelligen/i);
invalid:
  - |
    expect(JSON.stringify(body)).not.toMatch(/42/);

Le premier cas passe : le motif cherche des mots, pas une suite de chiffres. Le second est refusé.

Quelques jours plus tard, la même erreur est revenue sous une autre forme : un test cherchait « 4821 » dans un texte chiffré, et un texte chiffré, c'est aussi des octets au hasard. Le ticket correspondant dit : corriger la famille, pas le cas. Les tests vérifient maintenant le texte en clair en entier, et une deuxième règle, no-bare-digits-on-random-bytes, refuse le motif.

  • akinaza

    Le bug
    « 514 » trouvé au hasard dans un UUID.
    La règle
    no-bare-digits-on-serialized Une règle ast-grep, avec ses cas valides et refusés.
  • akinaza

    Le bug
    Une page serveur lisait une valeur d'un module client : la puce d'état d'une facture avait perdu sa couleur.
    La règle
    Le test de la frontière client Un fichier serveur n'importe d'un module « use client » que des composants et des types.
  • krizaka-ui

    Le bug
    Le build regroupait les fichiers, et chaque groupe avait son propre routeur : certains composants ignoraient celui de l'application.
    La règle
    Un garde dans tsup, et son test Le routeur est toujours l'entrée du paquet, jamais une copie.

Le troisième est intéressant parce que ce n'est pas un test qui l'a trouvé. Une PR de krizaka-ui a dépassé de 6 ko la limite de taille du paquet. En cherchant pourquoi, on a vu que chaque groupe du build embarquait sa propre copie du contexte du routeur. Le correctif est un petit plugin, dans krizaka-ui/packages/ui/tsup.config.ts :

ts
const oneRouter: NonNullable<Options["esbuildPlugins"]>[number] = {
  name: "krizaka-one-router",
  setup(build) {
    build.onResolve({ filter: /^\.\.\/router$/ }, (args) =>
      args.importer.includes("/src/router/") ? undefined : { path: "@krizaka/ui/router", external: true },
    );
  },
};

Un test vérifie que ce plugin est bien branché. Si quelqu'un le retire un jour, la CI le dira.

Un bug corrigé, c'est un bug de moins. Une règle, c'est toute sa famille de moins, dans tous les dépôts qui partagent la règle.

Un bug devient une règle : le « 514 » trouvé par hasard dans un UUID, d'un échec au hasard à une famille refusée partout
  1. Un échec au hasard (akinaza#341)Un test de confidentialité cherche « 514 » dans un contenu plein d'identifiants aléatoires : cinq échecs dans une seule CI.
  2. Seul, ou une famille ? (la question)Chercher une suite de chiffres dans un texte aléatoire échoue par hasard. C'est une famille, pas un test.
  3. Une règle (ast-grep)no-bare-digits-on-serialized refuse le motif, avec ses cas valides et refusés.
  4. Le cliquet (un compte enregistré)Une règle sans compte enregistré fait échouer la CI : on ne peut pas la glisser en douce.
  5. La famille revient (akinaza#358)« 4821 » dans un texte chiffré : une seconde règle, no-bare-digits-on-random-bytes. On corrige la classe, pas l'instance.

Le mobile : Maestro dans la CI

Pour le web, c'était déjà en place. Pour le mobile, jusqu'à cette semaine, un agent ouvrait l'émulateur et vérifiait à la main. Ça coûtait une session de modèle à chaque fois, et ça ne prouvait rien le lendemain.

Un ticket a changé ça. Le workflow mobile-e2e.yml fait tout tourner dans GitHub Actions :

Un test mobile dans la CI (Yomizaka, Akinaza)
  1. Backend jetable (PostgreSQL neuf)Une base PostgreSQL vide et l'application web construite, sur la machine de CI. Rien ne sort de la machine.
  2. Persona de démo (données semées)On sème un compte de démo. Pour Yomizaka, c'est Éric. La base est neuve à chaque passage, donc les données repartent toujours de zéro.
  3. APK release (JavaScript inclus)Une APK en variante release, signée avec la clé de debug, avec le JavaScript dedans. Pas de serveur Metro.
  4. Émulateur (Android, KVM)Un émulateur Android démarre sur la machine de CI.
  5. Flux Maestro (captures, vidéo)Maestro joue les parcours de l'application. Les captures, la vidéo et le rapport JUnit sont toujours gardés.
  6. mobile-e2e / gate (exigé sur main)Un verdict qui s'affiche toujours. Un parcours qui échoue le fait échouer.

L'en-tête du workflow le dit lui-même, dans .github/.github/workflows/mobile-e2e.yml :

yaml
#   gate      ALWAYS reports: `mobile-e2e / gate`. It is never skipped to get green: a failed or cancelled flow run fails it.

La règle d'adoption, c'est 3 passages verts de suite avant que la vérification devienne exigée. Pas avant : une vérification exigée qui échoue au hasard bloque tout le monde, et on finit par la contourner. Après trois passages verts, mobile-e2e / gate est devenu exigé sur main pour Yomizaka et pour Akinaza. Un parcours instable est corrigé, ou mis de côté avec un ticket. Il n'est jamais supprimé.

Sur le web, c'est Playwright. Pour krizaka.com, la CI lance l'image Docker de production et un vrai navigateur la visite, dans krizaka-com/scripts/ci-container-smoke.sh :

bash
# 360–1440 px, dark and light: no page scrolls sideways (a real browser on the real container).
npx playwright install --with-deps chromium
node scripts/check-overflow.mjs --base http://localhost:3000

Dans krizaka-ui, les captures des composants sont comparées pixel par pixel, dans l'image Docker de Playwright où les références ont été faites. Mêmes polices, même Chromium, sinon chaque comparaison serait fausse.

Les versions et la mise en production

Nos bibliothèques, Krizaka UI et Krizaka TypeScript, utilisent changesets. Chaque PR qui change un paquet ajoute un petit fichier qui dit quoi, et à quel niveau : correctif, mineure ou majeure. Sur main, une action tient une PR « chore: version packages » à jour. Quand on la fusionne, les paquets partent sur npm, avec leur provenance.

Je dois être précis sur un point. La provenance est là, mais pas encore la publication de confiance d'npm, celle qui se passe de token. npm a refusé notre première tentative, parce que les paquets n'avaient pas encore d'éditeur de confiance déclaré. Pour l'instant, un token d'automatisation fait la publication.

Pour krizaka.com, on a mis en place un train de versions le 25 octobre, dans krizaka-com#390. C'est la fin du premier schéma. release-please tient une PR de version. Quand je la fusionne, le tag est créé, et un workflow avance la branche production jusqu'à elle. Dans krizaka-com/scripts/promote-production.mjs :

js
  if (tagIsAncestor) return { action: "noop", reason: `${BRANCH} already contains ${tag}: never moved backwards` };
  if (productionIsAncestor) return { action: "forward", reason: `${BRANCH} fast-forwarded to ${tag}` };
  return { action: "refuse", reason: `${BRANCH} has diverged from main: it is never forced, look at it` };

Trois cas, pas un de plus. La branche est déjà à jour, elle avance, ou elle a divergé, et alors on s'arrête et on regarde. Jamais de --force. Le site, lui, se déploie depuis production, pas depuis main, dans krizaka-com/deploy/digitalocean/app.yaml :

yaml
services:
  - name: web
    github:
      repo: krizaka/krizaka-com
      branch: production
      deploy_on_push: true

Fusionner sur main ne met donc rien en ligne. C'est la release qui le fait, et je sais toujours quelle version tourne.

Ce qui a cassé cette semaine

Je ne veux pas donner l'impression que tout ça marche du premier coup. Voici ce qui a cassé, rien que cette semaine.

Une race condition dans turbo, dans krizaka-ts. La publication a échoué avec Failed to resolve entry for package "@krizaka/db". La vérification de chaque paquet finissait par un build, qui effaçait dist/ pendant que les tests d'un autre paquet l'importaient. On a d'abord construit tout avant de vérifier (krizaka-ts#79), puis on a corrigé la cause dans turbo.json (krizaka-ts#75), avec un test qui garde la configuration :

json
"check": { "dependsOn": ["^build", "^check"], "outputs": ["dist/**"] }

Le test des polices avant leur build, dans krizaka-ui. Après une PR de version, la publication a échoué : le test de packages/fonts cherchait dist/index.js, qui n'existait pas encore. Le test dépendait du build des autres paquets, pas du sien. krizaka-ui#702 ajoute la dépendance manquante.

pnpm qui refuse les scripts d'installation. Les versions récentes de pnpm refusent de lancer les scripts d'installation d'une dépendance qu'on n'a pas autorisée, avec ERR_PNPM_IGNORED_BUILDS. Le build de développement d'orazaka-web-client était cassé depuis la veille. Le correctif liste les trois dépendances permises, dans pnpm-workspace.yaml (orazaka-web-client#283) :

yaml
allowBuilds:
  "@ast-grep/cli": true
  "@parcel/watcher": true
  unrs-resolver: true

npm sur un projet pnpm. Le déploiement lançait npm install sur l'arbre pnpm du client web. npm plantait, à chaque déploiement, avec un message qui ne disait rien d'utile. La commande de build est devenue pnpm run build (orazaka#412).

Deux dépôts qui s'attendaient. Pour passer à Krizaka UI 3.55, le workspace d'Orazaka devait régénérer son lockfile. Sa CI échouait contre le client web, qui déclarait encore l'ancienne version. Et la PR du client web avait besoin du nouveau lockfile. Chacun attendait l'autre. On s'en est sortis en rendant le client web autonome : il ne fait plus partie du workspace npm, il s'installe depuis son propre pnpm-lock.yaml (orazaka#415). Le prix, c'est qu'il prend maintenant deux paquets partagés depuis le registre, et plus depuis leur source.

Aucune de ces pannes n'a été réglée en relançant la CI. Chacune a été corrigée là où elle naissait.

Les agents dans la boucle

La plupart de nos PR sont ouvertes par des agents. Un agent prend un ticket, travaille sur une branche, construit et teste avant de pousser, ouvre la PR et arme la fusion automatique. Ensuite, il a fini.

C'est la protection de branche qui décide quand la PR est fusionnée. Pas l'agent, et pas moi qui clique au bon moment. Si la CI est rouge, rien ne se passe. Les mises à jour de Dependabot suivent le même chemin, dans .github/.github/workflows/dependabot-automerge.yml :

yaml
      - name: Enable auto-merge (not a major)
        if: steps.meta.outputs.update-type != 'version-update:semver-major'
        run: gh pr merge --auto --squash "$PR_URL"

Une mise à jour majeure reste à la main.

Un test instable est un bug. On ne relance pas à l'aveugle. Le ticket sur un test du navigateur qui faisait la course avec une transition de page le dit en toutes lettres : commencer par un test qui échoue à coup sûr, en le répétant vingt fois en local, et ne jamais rendre la vérification optionnelle ni la relancer à l'aveugle. C'est la même idée que les règles plus haut : on corrige la famille.

Un agent ne regarde pas la CI tourner. Attendre qu'un passage de CI finisse, pour un agent, c'est une session de modèle qui tourne pour rien. GitHub sait attendre, gratuitement. L'agent pousse, arme la fusion, et s'arrête. Si la CI échoue, on lit le rapport et les captures gardées par le workflow. Personne n'ouvre un émulateur pour vérifier à la main.

On a aussi arrêté d'utiliser l'agent de code de Copilot, après un pic de coût. Je ne donne pas de chiffre ici. Les tickets passent maintenant par nos autres sessions d'agents, avec la même CI et les mêmes règles.

Pourquoi CodeQL est à part, et pourquoi Sonar et l'image passent après verify

Je me suis trompé dans la première version de ce chapitre : je dessinais une file, verify, container, Sonar, CodeQL. Ce n'était pas vrai. verify et container tournaient en même temps, CodeQL et SonarCloud aussi. Voici ce que j'ai changé, et pourquoi.

  • CodeQL est resté en parallèle, et exigé. Il lit le code source. Il n'a besoin ni du build ni des tests, donc c'est lui qui répond le plus vite. Le mettre derrière verify l'aurait fait attendre pour rien. La seule chose à faire a été de vérifier qu'il est bien exigé : c'est le cas, par une règle, dans Akinaza, Orazaka et Yomizaka.
  • Sonar est entré dans le pipeline, après les tests. C'est la seule façon de lire la couverture : l'analyse automatique ne sait pas l'importer, donc la condition « 80 % sur le nouveau code » n'était jamais évaluée. Le job sonar attend verify, reprend les rapports de couverture des tests, et on attend le verdict de SonarCloud. C'est le ticket qu'on a ouvert pour ça. Il tourne sur krizaka.com, Akinaza et Yomizaka. Pour chaque dépôt, j'ai coupé l'analyse automatique (les deux ne peuvent pas tourner ensemble) puis relancé la CI aussitôt, prêt à la remettre si la CI était rouge. Elle a été verte, et les trois sont passés. Les autres dépôts suivront un par un. Orazaka demande d'abord d'ajouter la couverture Java au parent commun.
  • L'image attend verify, et elle est analysée. Avant, elle était construite même quand le lint échouait, ce qui coûtait du temps pour rien. Maintenant elle passe après verify. Trivy y cherche les vulnérabilités et le job échoue sur une faille corrigeable de niveau élevé ou critique ; une exception acceptée s'écrit dans un fichier, avec sa raison et une date de fin. Un SBOM est gardé à chaque passage.
  • Les images ne sont publiées que depuis main, après la fusion. Ça n'a pas changé : l'image d'une PR n'est jamais publiée, et le déploiement construit depuis la branche production. Seul du code qui a passé toutes les vérifications exigées part en ligne.

Le premier jour, l'analyse de l'image a trouvé de vraies choses. Une faille critique dans la version de Next.js de l'image de krizaka.com, corrigée et publiée depuis. Et des failles de niveau élevé dans npm lui-même, qui est livré avec l'image de Node alors que l'application ne l'utilise jamais en production : on l'a retiré des images d'exécution d'Akinaza, de Yomizaka et de krizaka.com.

Le dépôt krizaka/.github a aussi son propre CI gate depuis ce changement. Ses suites de tests ne tournaient que si leurs fichiers changeaient, donc aucune ne pouvait être exigée, et deux PR avaient été fusionnées avec un test rouge. Un job qui tourne toujours décide maintenant lesquelles s'appliquent, et c'est lui qui est exigé.

Ce qui n'est pas réglé

Il reste des trous, et je préfère les nommer.

La couverture n'arrive pas encore partout à SonarCloud. Elle y arrive pour krizaka.com, Akinaza et Yomizaka. Les autres dépôts, Orazaka compris, gardent l'analyse automatique, qui lit le code mais pas nos tests. Le seuil de 80 % de couverture sur le nouveau code reste à exiger, après une semaine au vert.

Le test iOS n'est pas commencé. Le workflow mobile ne fait qu'Android. iOS est une ligne dans son en-tête, rien de plus.

Le DNS est du code, mais son application reste manuelle. Nos domaines sont maintenant décrits dans un dépôt, et la CI lance un plan en lecture seule à chaque pull request et chaque jour, pour repérer les écarts. Modifier les enregistrements réels reste une étape manuelle.

Les tests Playwright du web ne sont pas des vérifications exigées à part. Sur krizaka.com, ils comptent à travers le CI gate. En faire des vérifications exigées à part entière, c'est la suite prévue dans #241.

Et le build pack d'une seule ligne, je l'attends toujours.

Ce que j'en retiens

Une CI, ce n'est pas un fichier. C'est une suite de petites décisions qu'on n'a plus à reprendre : un seul verdict, des comptes qui ne montent pas, une règle après chaque famille de bugs, une branche de production qu'on ne force jamais.

Avec des agents, ça compte encore plus. Un agent travaille vite et ne se fatigue pas, mais il ne sait que ce qu'on lui a écrit. La CI, c'est l'endroit où ce qu'on a écrit est vérifié, à chaque PR, pour tout le monde. Moi compris.

Chapitre 11

Résultats

dépôts où SonarCloud est exigé sur main

25

Ce qui est exigé sur main

passages verts de suite avant d'exiger un test mobile

3

Le mobile : Maestro dans la CI

pannes de CI racontées dans ce chapitre

5

Ce qui a cassé cette semaine