archicratie-edition/docs/CI-BASELINE.md

CI-BASELINE — Gitea Actions + runner Synology (DS220+)

Baseline VALIDÉE :

• runner : container.network = host
• job CI : container Node 22 (conforme engines)
• checkout : sans GitHub, basé sur workflow/event.json
• zéro apt-get dans le workflow
• durcissement DNS Node : NODE_OPTIONS=--dns-result-order=ipv4first

Runner (DS220+) — configuration de référence

Fichier : /data/config.yaml dans le conteneur runner (ex: gitea-act-runner)

Section container attendue :

container:
  network: host
  options: >-
    --add-host=gitea.archicratie.trans-hands.synology.me:192.168.1.20
    -e NODE_OPTIONS=--dns-result-order=ipv4first

Pourquoi : sur cette infra, le DNS du bridge Docker (127.0.0.11) a généré ESERVFAIL / EAI_AGAIN / apt qui ne résout pas. Le host network stabilise les résolutions (npm registry, deb.debian.org, etc.).

Smoke test NAS (doit passer)

docker run --rm --network host       mcr.microsoft.com/devcontainers/javascript-node:22-bookworm       bash -lc "npm ping --registry=https://registry.npmjs.org"

Symptômes -> cause -> action

• EAI_AGAIN / ESERVFAIL : runner pas en host network -> remettre container.network: host + restart runner
• EBADENGINE : mauvais Node -> container Node 22
• MODULE_NOT_FOUND scripts/check-anchor-aliases.mjs : fichier non commité -> git add/commit/push

---

Dernière mise à jour : 2026-01-29

But : définir un minimum “incassable” (local + runner) qui garantit :

• build OK
• anchors cohérents
• aliases injectés
• dist propre (pas d’IDs dupliqués)
• pagefind généré

---

1) Commande canonique

en bash : npm test

2) Ce que npm test enchaîne

npm run test:aliases

npm run build

npm run audit:dist

node scripts/verify-anchor-aliases-in-dist.mjs

npm run test:anchors

node scripts/check-inline-js.mjs

3) Smoke test “prod-like” (Nginx statique)

Sur NAS (ou local), quand on a un service qui expose un port HTTP : ./scripts/smoke.sh 8081 ./scripts/smoke.sh 8082

Attendus :

/ répond 200

/pagefind/pagefind.js répond 200

4) Note DSM 7.3 (DS220+) — build réseau

Sur Synology, il arrive que docker build ait des soucis DNS/apt/npm. On force un build stable :

BuildKit : export DOCKER_BUILDKIT=1 export COMPOSE_DOCKER_CLI_BUILD=1

build en réseau host (dans docker-compose.yml) : build: network: host

5) Avertissement “git was not found”

BuildKit affiche parfois : buildx: git was not found ... commit information was not captured

Ce warning est sans impact sur le build du site (il concerne juste la capture d’infos de commit).