# 22444 — Règles de pipeline et contrôles CI

Le push de branche porte la validation du commit. Les contrôles utilisent `cluster-sandbox`, avec les [ressources qualifiées au lot 22443](22443-ressources-ci-cd.md). Le pipeline est défini dans le dépôt. Sa recette sur GitLab et l’activation de la barrière de fusion sont à faire sur le projet. [Ticket 22444](https://projets.synaltic.fr/issues/22444)

## Sources et contrôles

| Événement | Sélection |
| --- | --- |
| Push sur `main`, création de branche ou push de tag | Tous les contrôles. |
| Push sur une branche existante | Union des changements depuis `main` et des changements du push. Le diff avec `main` reprend les contrôles d’un pipeline annulé. Le diff du push couvre aussi un revert vers `main`. |
| Ouverture ou mise à jour d’une MR | La MR utilise le pipeline de branche du commit source. Le workflow refuse le doublon `merge_request_event`. |
| Web, API, planification et déclenchement upstream | Refusés par le workflow de ce lot. Cela évite qu’un pipeline d’exploitation partage le contrôle de fusion ou l’annulation d’un pipeline de validation. |

Les jobs sont interruptibles. Un nouveau commit sur la même branche annule les validations obsolètes. Les tags utilisent `on_new_commit: none`. Le futur parcours d’exploitation devra séparer ses refs et préserver les opérations durables déjà démarrées. Un futur pipeline de résultat de fusion devra distinguer son commit synthétique du commit source, qualifier `CI_MERGE_REQUEST_EVENT_TYPE` et revalider le contrôle de fusion. [Règles YAML GitLab](https://docs.gitlab.com/ci/yaml/) · [Pipelines de résultat de fusion](https://docs.gitlab.com/ci/pipelines/merged_results_pipelines/)

`Dependencies` et `Check:Docs` sont présents dans chaque pipeline. Les règles positives sélectionnent en plus les jobs suivants.

- Code et configuration des consommateurs concernés → préparation et TypeScript. Next, Common et Prisma sélectionnent aussi ESLint Next.
- Sources des deux sites et sources SPDD publiées → compilation des deux sites documentaires. Un push qui modifie du Markdown et du code garde les deux familles.
- Prisma → unitaires et intégrations Prisma et WALDEC. Database et Data Jobs → unitaires et intégration WALDEC.
- Version Node, configuration Yarn/npm, manifest racine, lockfile et configuration CI → tous les contrôles.

## Dépendances et préparation

Les jobs utilisent l’image officielle Node `24.22.2-bookworm` et vérifient Linux x64, `.nvmrc` et le Yarn de `package.json`. `Dependencies` exécute `corepack yarn install --immutable` avec le cache Yarn des téléchargements. Le runner doit joindre la source de bootstrap de Corepack et le miroir Synaltic. Fournir `NPM_PROXY_AUTH` via la plateforme avec un accès de lecture compatible avec les branches non protégées. Garder l’authentification hors des fichiers et des archives. Le cache est facultatif pour la correction de l’installation.

Les artefacts de Dependencies transmettent les `node_modules` racine et workspaces, `.yarn/install-state.gz` et le Yarn épinglé de Corepack. Prepare génère et compile Prisma, Database, Data Jobs et Common. Il transmet le client généré et les sorties `dist`. Chaque archive a `expire_in: 8 hours`. Les consommateurs récupèrent les artefacts de leur pipeline et utilisent le Corepack restauré sans téléchargement du gestionnaire de paquets. La validation s’exécute après Dependencies et le Prepare sélectionné. Le téléchargement ciblé par `dependencies` conserve la barrière des stages. Un futur Build ou Deploy devra rester derrière les contrôles sélectionnés, y compris s’il utilise `needs`.

L’arbre local des dépendances représente environ 230 Mio comprimés avec tar et gzip rapide. Mesurer l’archive réelle et confirmer que GitLab et son proxy autorisent sa taille. La conservation des derniers artefacts, activée lors de la lecture du 10 novembre 2026, peut prolonger la rétention au-delà des 8 h. Pour obtenir cette durée effective, désactiver **Keep artifacts from most recent successful jobs**. [Limites d’archives GitLab](https://docs.gitlab.com/administration/cicd/limits/#maximum-artifacts-size) · [Rétention](https://docs.gitlab.com/ci/jobs/job_artifacts/#keep-artifacts-from-most-recent-successful-jobs)

Les jobs déclarent le dossier `.ci-corepack/` en CommonJS avant de lancer Yarn. Ce dossier est dans le dépôt, dont le manifeste racine déclare `type: module`. Sans ce périmètre propre, Node charge le lanceur Yarn comme module ES et le contrôle de version échoue avant l’installation. [Échec observé sur GitLab](https://gitlab.app.synaltic.eu/retd/dataasso-spdd/-/jobs/1146323)

## PostgreSQL jetable

`Test:Integration:Prisma` et `Test:Integration:WALDEC` utilisent chacun un service PostgreSQL 18.0 dédié, dans le pod de leur job. Le service écoute sur le loopback au port 55432. Son rôle et sa base sont propres à la suite et son marqueur est contrôlé côté SQL. La sonde vérifie la version majeure, le rôle, la base, le marqueur, le port et l’absence de schémas de données existants avant toute migration. L’argument explicite `--gitlab-postgres` requiert `GITLAB_CI=true`. L’URL provient du contrat de fixture. Une erreur de connexion ou d’identité bloque le job. Les données, comptes et fichiers sont synthétiques. La suite ferme les clients et supprime ses fichiers temporaires. Le cycle de vie du pod gère le service éphémère. [Exécuteur Kubernetes](https://docs.gitlab.com/runner/executors/kubernetes/#how-the-runner-creates-kubernetes-pods)

En local, les commandes sans argument gardent leur propre réseau et conteneur Docker, avec un port loopback aléatoire et un tmpfs. Voir les procédures [Prisma](../applications/prisma.md#client-node-et-validations) et [WALDEC](../applications/waldec.md#vérifier-le-code-sans-base-existante).

## Vérifications locales

L’installation immutable, la préparation Prisma et des packages, ESLint, TypeScript, le contrôle SPDD, les deux builds documentaires et les tests unitaires ont réussi sous Node 24.22.2 et Yarn 4.18.1. Prisma et WALDEC ont chacun passé leurs six phases en mode Docker local.

Les deux suites ont aussi passé leurs six phases en mode service. Pour chaque suite, un conteneur Node Bookworm complet a partagé le namespace réseau isolé d’un nouveau PostgreSQL 18.0. Les sondes ont validé la connexion au loopback sur le port 55432 avec `CI=true`, `GITLAB_CI=true` et une URL de base héritée volontairement invalide. Le checkout était monté en lecture seule. Cette simulation couvre le contrat de connexion et les assertions des suites. La restauration d’artefacts et le cycle de vie des services sur le runner restent à observer.

## Barrière de fusion et recette GitLab

Sur le projet Data Asso, la lecture du 10 novembre 2026 a trouvé l’annulation redondante active et **Pipelines must succeed** désactivé. Un Maintainer doit activer ce contrôle, garder **Skipped pipelines are considered successful** désactivé, et vérifier que **Skip branch pipelines for merge requests** est désactivé si le réglage apparaît. Restreindre la surcharge des variables de pipeline, actuellement possible pour les Developers, afin que les variables utilisées par le workflow conservent leurs valeurs GitLab. Les pushes directs autorisés des Maintainers vers `main` relèvent de la protection de branche. [Réglages des pipelines](https://docs.gitlab.com/ci/pipelines/settings/) · [Contrôles de fusion](https://docs.gitlab.com/user/project/merge_requests/auto_merge/#require-a-successful-pipeline-for-merge) · [Restriction des variables](https://docs.gitlab.com/ci/variables/#restrict-pipeline-variables)

Après publication autorisée, collecter les preuves suivantes.

1. Sur le ref publié, vérifier les includes et les jobs via CI Lint. Sa simulation couvre un push, puis les pipelines réels apportent les preuves propres aux événements et au runner.
2. Sur le premier pipeline, relever le lien, le commit, le runner et l’exécuteur. Contrôler l’installation immutable, les deux transferts d’artefacts, la génération unique et l’exécution sans réinstallation. Relever les résultats distincts des deux intégrations, la connexion au service PostgreSQL et les six phases de chaque suite.
3. Dans une MR prête et après activation du contrôle de fusion, constater un seul pipeline de branche par commit. Avec deux pushes rapprochés, observer l’annulation des validations du premier commit. La MR doit rester bloquée tant que le dernier commit attend sa validation, même si un commit précédent est vert. Observer aussi le blocage si le dernier commit n’a aucun pipeline valide ou si son pipeline est ignoré. Vérifier l’association du succès au commit de tête avant toute fusion. Contrôler l’absence de pipeline MR historique concurrent qui pourrait prendre la priorité.

Images applicatives, Helm et livraison relèvent des lots suivants.
