10.01 — Matrice récapitulative des workflows

10.01 — Matrice récapitulative des workflows#

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

Récap.#

DépôtWorkflowTriggerOSStackEffetDétail
ocarinamain_ci.ymlpush/PR main, dispatchubuntu + windows × py 3.14 (option 3.15-dev)venv cache, make install-on-cimake check-coding-style + make test + Allure history + Pages deploy02-ocarina-workflows.md
ocarinadev_ci.ymlpush dev/feature/fix, PR dev, dispatchubuntu × py 3.14venv cachecheck-coding-style + test + récap couverture (non bloquant)02-ocarina-workflows.md
ocarinaunstable_python_full_build.ymlcron (mensuel), dispatchubuntu + windows × py 3.15-devPIP_ONLY_BINARY=":all:"full build sur Python pré-release02-ocarina-workflows.md
ocarina-examplemain_ci.ymlpush/PR main, dispatchubuntu + windows × py 3.14venv cachecheck-coding-style03-example-workflows.md
ocarina-exampledev_ci.ymlpush dev, dispatchubuntu × py 3.14venv cachecheck-coding-style03-example-workflows.md
ocarina-examplee2e.ymldispatch (env OC)ubuntu + service redis:8.x + Firefox + geckodriver 0.35.0venv cacherun complet, upload traces03-example-workflows.md
ocarina-with-ai-exampleai_proof_ci.ymlpush main, PR, dispatchubuntu × py 3.14venv cacheruff format check + ruff check + mypy04-ai-workflows.md
ocarina-with-ai-exampleai_proof_e2e.ymldispatchubuntu × matrice firefox+chromevenv cache, geckodriver 0.36.0 / chromedriver auto-matchéwarm-up Heroku dyno, run, filtrage sed des stacktraces ChromeDriver, upload04-ai-workflows.md
igoristanci-pr.ymlPR **, dispatchubuntu × node 24 + pnpm 11wireitformat check + lint + typecheck (parallélisés)05-igoristan-workflows.md
igoristandeploy.ymlpush main, dispatchubuntu × node 24 + pnpm 11concurrency group pagespnpm install --frozen-lockfilepnpm build + upload Pages05-igoristan-workflows.md
ocarina-holy-bookdeploy.ymlpush main, PR, dispatchubuntu × node 24 + pnpm 11TZ=Europe/Paris, concurrency group pagespnpm installpnpm build + upload Pages06-holy-book-workflow.md
tests-workersaucun —  — Vercelvercel deploy07-tests-workers-vercel.md

Action composite#

ActionLocalisationUsage
allure-historyocarina/.github/actions/allure-history/action.ymlComposite : 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)

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

10.03 — Workflows ocarina-example#

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

Vue d’ensemble#

WorkflowTriggerOSEffetNote
main_ci.ymlpush/PR main, dispatchubuntu + windows × py 3.14make check-coding-style (mypy + ruff).Gate PR rapide
dev_ci.ymlpush dev, dispatchubuntu × py 3.14IdemPour branches dev
e2e.ymlworkflow_dispatch (env OC)ubuntu + service Redis + Firefox + geckodriver 0.35.0Run complet de la suite + upload .screenshots/ .ocarina_logs/ .reports/Manuel uniquement

vs ocarina/main_ci.yml#

Aspectocarina/main_ci.ymlocarina-example/main_ci.yml
Tests unitairesOui (pytest + cram)Non
Allure historyOuiNon
GitHub Pages deployOui (Allure report)Non
Matrice OSOui (ubuntu + windows)Oui (idem)
Matrice PythonOptionnel (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

10.04 — Workflows ocarina-with-ai-example#

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

Vue d’ensemble#

WorkflowTriggerOSEffetNote
ai_proof_ci.ymlpush main, PR, dispatchubuntu × py 3.14ruff format src/ --checkruff check src/mypy src/Gate PR, rapide
ai_proof_e2e.ymldispatchubuntu × matrice firefox+chromewarm-up Heroku + run + sed filter ChromeDriver C++ stacks + uploadManuel uniquement

Différences avec ocarina-example#

Aspectocarina-exampleocarina-with-ai-example
Matrice browserFirefox seul (e2e.yml)Firefox + Chrome (parallélisés)
SUTIgoristan (GitHub Pages)CURA (Heroku eco-dyno)
Pre-runwarm-up Redis clientwarm-up Heroku dyno
Filtre outputaucunsed filtre les stack frames C++ ChromeDriver
WAIT_TIMEOUTdefault 1015 (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

10.05 — Workflows igoristan#

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

Vue d’ensemble#

WorkflowTriggerOSEffetNote
ci-pr.ymlPR **, dispatchubuntu × node 24 + pnpm 103 jobs parallélisés : wireit ci:format-checkwireit lintwireit typecheckGate PR
deploy.ymlpush main, dispatchubuntu × node 24 + pnpm 10pnpm install --frozen-lockfilepnpm build + upload PagesProduction

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
JobCache supplémentaire
format-checkwireit
lintwireit + .eslintcache (actions/cache)
typecheckwireit + 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

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

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).