CI : écrite pour un exécuteur shell, pas pour un conteneur

site/build/

site/.docusaurus/

public/

.ci/

# ═══════════════════════════════════════════════════════════════════════════

# Intégration continue et publication de la documentation.

#

# Deux travaux, et le second ne part que si le premier passe : publier une

# documentation depuis une révision qui ne tient pas ses garanties reviendrait

# à documenter un produit qui n'existe pas.

# Écrit pour un exécuteur « shell » : le travail tourne sur l'hôte, sous

# l'utilisateur gitlab-runner, pas dans un conteneur. Trois conséquences, qui

# expliquent tout ce qui suit :

#

# pnpm est installé par npm, pas par corepack : corepack n'est pas présent dans

# toutes les images Node, et l'espace de travail ne peut pas s'en passer — les

# dépendances internes sont déclarées en « workspace:* », que npm ne résout pas.

#   — « image: » serait ignoré : on ne le déclare pas, pour ne pas laisser

#     croire que la version de Node est maîtrisée ici.

#   — « services: » serait ignoré aussi : aucune base, aucun cache, aucun

#     stockage objet n'est disponible. La suite complète de garanties ne peut

#     donc pas tourner ici — voir le travail « garanties » plus bas.

#   — Rien ne s'installe globalement : l'utilisateur n'écrit pas dans

#     /usr/local. pnpm est donc installé dans le répertoire du projet.

#

# Ces choix restent valables sur un exécuteur Docker : ils n'y coûtent rien.

# ═══════════════════════════════════════════════════════════════════════════

stages: [verifier, publier]

default:

  image: node:24

  before_script:

    - npm install -g pnpm@9.12.3

    # pnpm installé dans le répertoire du projet, jamais globalement :

    # l'utilisateur de l'exécuteur n'écrit pas dans /usr/local. La version est

    # celle que déclare packageManager — npm ne résout pas les dépendances

    # « workspace:* » de ce dépôt, pnpm est donc requis.

    - npm install --no-save --no-audit --no-fund --prefix .ci pnpm@9.12.3

    - export PATH="$CI_PROJECT_DIR/.ci/node_modules/.bin:$PATH"

    # Le premier échec suivant sera diagnosticable sans aller-retour.

    - node --version

    - pnpm --version

    - pnpm config set store-dir "$CI_PROJECT_DIR/.pnpm-store"

cache:

    files: [pnpm-lock.yaml]

  paths: [.pnpm-store]

# ── Les garanties du produit ───────────────────────────────────────────────

# ── Ce qui se vérifie sans aucun service ───────────────────────────────────

verifications:

  stage: verifier

  services:

    - name: postgres:16

      alias: postgres

    - name: redis:7

      alias: redis

    - name: bitnami/minio:latest

      alias: minio

  variables:

    POSTGRES_USER: kastell

    POSTGRES_PASSWORD: verification

    POSTGRES_DB: kastell

    MINIO_ROOT_USER: kastell

    MINIO_ROOT_PASSWORD: verification-minio

    KASTELL_ENV: developpement

    KASTELL_URL_PUBLIQUE: http://localhost:8080

    DATABASE_URL: postgres://kastell:verification@postgres:5432/kastell

    REDIS_URL: redis://redis:6379

    S3_ENDPOINT: http://minio:9000

    S3_BUCKET: kastell

    S3_ACCES: kastell

    S3_SECRET: verification-minio

    S3_REGION: eu-west-1

    SECRET_SESSION: verification-verification-verification-01

  script:

    - pnpm install --frozen-lockfile

    - pnpm typecheck

    - pnpm verif

    - pnpm accords

    # Un lien mort fait échouer la construction : dans une documentation de

    # crise, c'est un défaut, pas un détail.

    - pnpm --filter @kastell/site build

# ── Les 602 garanties du produit ───────────────────────────────────────────

#

# Elles exigent PostgreSQL, Redis et un stockage objet. Sur un exécuteur shell

# sans ces services, ce travail ne se déclenche pas — plutôt que d'échouer à

# chaque passage et d'apprendre à tout le monde à ignorer un pipeline rouge.

#

# Pour l'activer : définir DATABASE_URL dans les variables du projet, en

# pointant vers une base dédiée à l'intégration. Le travail refuse de tourner

# si KASTELL_ENV vaut « production ».

garanties:

  stage: verifier

  needs: [verifications]

  rules:

    - if: $DATABASE_URL

  script:

    - pnpm install --frozen-lockfile

    - pnpm verif

# ── La documentation, publiée par GitLab Pages ─────────────────────────────

pages:

    # écrite en dur, pour qu'un auto-hébergeur qui reprend ce dépôt obtienne

    # la sienne sans rien modifier.

    - pnpm --filter @kastell/site build

    - mv site/build public

    - rm -rf public && mv site/build public

  artifacts:

    paths: [public]

  rules: