Chapitre 10 — CI/CD de tout l'écosystème on Ocarina — précis

10.01 — Matrice récapitulative des workflows

Wed, 20 May 2026 00:00:00 +0000

10.01 — Matrice récapitulative des workflows#

Vue d’ensemble synthétique de tous les workflows de l’écosystème.

Récap.#

Dépôt	Workflow	Trigger	OS	Stack	Effet	Détail
`ocarina`	`main_ci.yml`	push/PR main, dispatch	ubuntu + windows × py 3.14 (option 3.15-dev)	venv cache, make install-on-ci	make check-coding-style + make test + Allure history + Pages deploy	`02-ocarina-workflows.md`
`ocarina`	`dev_ci.yml`	push dev/feature/fix, PR dev, dispatch	ubuntu × py 3.14	venv cache	check-coding-style + test + récap couverture (non bloquant)	`02-ocarina-workflows.md`
`ocarina`	`unstable_python_full_build.yml`	cron (mensuel), dispatch	ubuntu + windows × py 3.15-dev	`PIP_ONLY_BINARY=":all:"`	full build sur Python pré-release	`02-ocarina-workflows.md`
`ocarina-example`	`main_ci.yml`	push/PR main, dispatch	ubuntu + windows × py 3.14	venv cache	check-coding-style	`03-example-workflows.md`
`ocarina-example`	`dev_ci.yml`	push dev, dispatch	ubuntu × py 3.14	venv cache	check-coding-style	`03-example-workflows.md`
`ocarina-example`	`e2e.yml`	dispatch (env `OC`)	ubuntu + service `redis:8.x` + Firefox + geckodriver 0.35.0	venv cache	run complet, upload traces	`03-example-workflows.md`
`ocarina-with-ai-example`	`ai_proof_ci.yml`	push main, PR, dispatch	ubuntu × py 3.14	venv cache	ruff format check + ruff check + mypy	`04-ai-workflows.md`
`ocarina-with-ai-example`	`ai_proof_e2e.yml`	dispatch	ubuntu × matrice firefox+chrome	venv cache, geckodriver 0.36.0 / chromedriver auto-matché	warm-up Heroku dyno, run, filtrage sed des stacktraces ChromeDriver, upload	`04-ai-workflows.md`
`igoristan`	`ci-pr.yml`	PR `**`, dispatch	ubuntu × node 24 + pnpm 11	wireit	format check + lint + typecheck (parallélisés)	`05-igoristan-workflows.md`
`igoristan`	`deploy.yml`	push main, dispatch	ubuntu × node 24 + pnpm 11	concurrency group `pages`	`pnpm install --frozen-lockfile` + `pnpm build` + upload Pages	`05-igoristan-workflows.md`
`ocarina-holy-book`	`deploy.yml`	push main, PR, dispatch	ubuntu × node 24 + pnpm 11	`TZ=Europe/Paris`, concurrency group `pages`	`pnpm install` + `pnpm build` + upload Pages	`06-holy-book-workflow.md`
`tests-workers`	aucun	—	—	Vercel	`vercel deploy`	`07-tests-workers-vercel.md`

Action composite#

Action	Localisation	Usage
`allure-history`	`ocarina/.github/actions/allure-history/action.yml`	Composite : Bun + Allure 3.9.0 + restore/save `history.jsonl` sur branche dédiée

Patterns#

Workflows PR (légers, auto)#

ocarina/main_ci.yml                                       # python 3.14
ocarina/dev_ci.yml
ocarina-example/main_ci.yml
ocarina-example/dev_ci.yml
ocarina-with-ai-example/ai_proof_ci.yml
igoristan/ci-pr.yml

Tous tournent rapidement.

10.02 — Workflows ocarina (framework)

Wed, 20 May 2026 00:00:00 +0000

10.02 — Workflows `ocarina` (framework)#

Trois workflows : main_ci.yml (production), dev_ci.yml (branches dev/feature/fix), unstable_python_full_build.yml (cron mensuel sur Python 3.15-dev).

`main_ci.yml`#

Trigger#

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
  workflow_dispatch:
    inputs:
      python_versions:
        description: "Python versions to test"
        type: choice
        required: false
        default: "Stable only"
        options:
          - "Stable only"
          - "Stable + unstable (uses pre-built wheels)"

workflow_dispatch avec un choix de version Python. Permet à l’utilisateur de déclencher un build avec 3.15-dev (pre-built wheels only) sans attendre le cron mensuel.

10.03 — Workflows ocarina-example

Wed, 20 May 2026 00:00:00 +0000

10.03 — Workflows `ocarina-example`#

Voir aussi ../07-ocarina-example/11-ci.md

Vue d’ensemble#

Workflow	Trigger	OS	Effet	Note
`main_ci.yml`	push/PR main, dispatch	ubuntu + windows × py 3.14	`make check-coding-style` (mypy + ruff).	Gate PR rapide
`dev_ci.yml`	push dev, dispatch	ubuntu × py 3.14	Idem	Pour branches dev
`e2e.yml`	`workflow_dispatch` (env `OC`)	ubuntu + service Redis + Firefox + geckodriver 0.35.0	Run complet de la suite + upload `.screenshots/` `.ocarina_logs/` `.reports/`	Manuel uniquement

vs `ocarina/main_ci.yml`#

Aspect	`ocarina/main_ci.yml`	`ocarina-example/main_ci.yml`
Tests unitaires	Oui (pytest + cram)	Non
Allure history	Oui	Non
GitHub Pages deploy	Oui (Allure report)	Non
Matrice OS	Oui (ubuntu + windows)	Oui (idem)
Matrice Python	Optionnel (3.14 ou 3.14+3.15)	Non (3.14 seul)

→ ocarina se teste (tests unitaires) en CI. ocarina-example n’est soumis qu’à des tests statiques en CI ; ses tests dynamiques (e2e) sont déclenchés à la demande via e2e.yml.

10.04 — Workflows ocarina-with-ai-example

Wed, 20 May 2026 00:00:00 +0000

10.04 — Workflows `ocarina-with-ai-example`#

Voir aussi ../08-ai-example/09-ci-matrix.md

Vue d’ensemble#

Workflow	Trigger	OS	Effet	Note
`ai_proof_ci.yml`	push main, PR, dispatch	ubuntu × py 3.14	`ruff format src/ --check` + `ruff check src/` + `mypy src/`	Gate PR, rapide
`ai_proof_e2e.yml`	dispatch	ubuntu × matrice firefox+chrome	warm-up Heroku + run + sed filter ChromeDriver C++ stacks + upload	Manuel uniquement

Différences avec `ocarina-example`#

Aspect	`ocarina-example`	`ocarina-with-ai-example`
Matrice browser	Firefox seul (e2e.yml)	Firefox + Chrome (parallélisés)
SUT	Igoristan (GitHub Pages)	CURA (Heroku eco-dyno)
Pre-run	warm-up Redis client	warm-up Heroku dyno
Filtre output	aucun	sed filtre les stack frames C++ ChromeDriver
`WAIT_TIMEOUT`	default 10	15 (compense les latences Heroku)

warm-up Heroku#

curl -sf --retry 6 --retry-delay 5 --retry-all-errors \
  --max-time 30 https://katalon-demo-cura.herokuapp.com/ > /dev/null
echo "Dyno is warm"

CURA runs on a Heroku dyno that sleeps after inactivity. Tests hitting a cold dyno produce timeouts (false fails) and slow confirmations (false passes on gap tests). Wake it explicitly before any browser opens.

10.05 — Workflows igoristan

Wed, 20 May 2026 00:00:00 +0000

10.05 — Workflows `igoristan`#

Voir aussi ../05-igoristan/07-ci-deploy.md

Vue d’ensemble#

Workflow	Trigger	OS	Effet	Note
`ci-pr.yml`	PR `**`, dispatch	ubuntu × node 24 + pnpm 10	3 jobs parallélisés : `wireit ci:format-check` + `wireit lint` + `wireit typecheck`	Gate PR
`deploy.yml`	push main, dispatch	ubuntu × node 24 + pnpm 10	`pnpm install --frozen-lockfile` + `pnpm build` + upload Pages	Production

`ci-pr.yml`#

jobs:
  format-check:
    env:
      WIREIT_CACHE: github
    steps:
      - uses: actions/checkout@v6
      - uses: pnpm/action-setup@v5
        with: { version: 11 }
      - uses: actions/setup-node@v6
        with: { node-version: 24, cache: "pnpm" }
      - uses: google/wireit@setup-github-actions-caching/v2
      - run: make install
      - name: Formatcheck
        run: make ci:format-check

  lint:
    env:
      WIREIT_CACHE: github
    steps:
      # ... idem setup ...
      - uses: actions/cache@v5
        with:
          path: .eslintcache
          key: eslint-cache-${{ hashFiles('eslint.config.ts', 'src/**/*.*', 'package.json') }}
      - name: Lint
        run: pnpm lint

  typecheck:
    env:
      WIREIT_CACHE: github
    steps:
      # ... idem setup ...
      - name: Typecheck
        run: pnpm typecheck

Job	Cache supplémentaire
`format-check`	wireit
`lint`	wireit + `.eslintcache` (actions/cache)
`typecheck`	wireit + `tsbuildinfo` (via wireit)

`WIREIT_CACHE: github`#

env:
  WIREIT_CACHE: github
steps:
  - uses: google/wireit@setup-github-actions-caching/v2

Active le cache wireit. Les runs successifs réutilisent les artefacts wireit.

10.06 — Workflow ocarina-holy-book

Wed, 20 May 2026 00:00:00 +0000

10.06 — Workflow `ocarina-holy-book`#

Un seul workflow : deploy.yml. Sur push main → build VitePress → upload Pages.

Code#

name: Deploy Ocarina Holy Book

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
  workflow_dispatch:

env:
  TZ: Europe/Paris

permissions:
  contents: read
  pages: write
  id-token: write

concurrency:
  group: pages
  cancel-in-progress: false

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 0 # ← full clone

      - uses: pnpm/action-setup@fcf821c621167805dd63a29662bd7cb5676c81a8
        name: Install pnpm
        with:
          version: 11

      - name: Use Node.js
        uses: actions/setup-node@v6
        with:
          node-version: 24
          cache: "pnpm"

      - name: Install dependencies
        run: pnpm install --frozen-lockfile

      - name: Build
        run: pnpm build

      - uses: actions/upload-pages-artifact@v4
        with:
          path: docs/.vitepress/dist

  deploy:
    needs: build
    runs-on: ubuntu-latest
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    steps:
      - id: deployment
        uses: actions/deploy-pages@v5

Analyse#

1. `TZ: Europe/Paris`#

env:
  TZ: Europe/Paris

Force la timezone du runner à Europe/Paris.
Les dates rendues par VitePress (« Last update: 18/05/2026 11h42 ») sont à l’heure de Paris, pas en UTC.

10.07 — tests-workers : pas de CI GitHub, déploiement Vercel auto

Wed, 20 May 2026 00:00:00 +0000

10.07 — `tests-workers` : pas de CI GitHub, déploiement Vercel auto#

Le seul dépôt de l’écosystème sans workflow GitHub Actions. Tout passe par Vercel.

Le contenu du `.github/`#

tests-workers/
└── (aucun .github/ — pas de workflows)

Pas de ci.yml. Pas de deploy.yml. Pas d’action GitHub.

`vercel.json`#

{
  "version": 2,
  "buildCommand": "echo 'No build required'",
  "outputDirectory": ".",
  "framework": null
}

Vercel détecte le projet comme TypeScript Edge Functions, build à la volée (transpile TS au runtime).

Chapitre 10 — CI/CD de tout l'écosystème on Ocarina — précis

10.01 — Matrice récapitulative des workflows

10.01 — Matrice récapitulative des workflows#

Récap.#

Action composite#

Patterns#

Workflows PR (légers, auto)#

10.02 — Workflows ocarina (framework)

10.02 — Workflows ocarina (framework)#

main_ci.yml#

Trigger#

10.03 — Workflows ocarina-example

10.03 — Workflows ocarina-example#

Vue d’ensemble#

vs ocarina/main_ci.yml#

10.04 — Workflows ocarina-with-ai-example

10.04 — Workflows ocarina-with-ai-example#

Vue d’ensemble#

Différences avec ocarina-example#

warm-up Heroku#

10.05 — Workflows igoristan

10.05 — Workflows igoristan#

Vue d’ensemble#

ci-pr.yml#

WIREIT_CACHE: github#

10.06 — Workflow ocarina-holy-book

10.06 — Workflow ocarina-holy-book#

Code#

Analyse#

1. TZ: Europe/Paris#

10.07 — tests-workers : pas de CI GitHub, déploiement Vercel auto

10.07 — tests-workers : pas de CI GitHub, déploiement Vercel auto#

Le contenu du .github/#

vercel.json#

10.02 — Workflows `ocarina` (framework)#

`main_ci.yml`#

10.03 — Workflows `ocarina-example`#

vs `ocarina/main_ci.yml`#

10.04 — Workflows `ocarina-with-ai-example`#

Différences avec `ocarina-example`#

10.05 — Workflows `igoristan`#

`ci-pr.yml`#

`WIREIT_CACHE: github`#

10.06 — Workflow `ocarina-holy-book`#

1. `TZ: Europe/Paris`#

10.07 — `tests-workers` : pas de CI GitHub, déploiement Vercel auto#

Le contenu du `.github/`#

`vercel.json`#