Seed from NAS prod snapshot 20260130-190531

docs/CI-BASELINE.md

@@ -0,0 +1,97 @@
+# 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).