Le fichier kx712.yml

Le fichier kx712.yml

kx712.yml, placé à la racine du dépôt, pilote le comportement CI de vos déploiements : filtres de déclenchement et checks exécutés avant chaque mise en ligne. Il est entièrement optionnel.

Exemple complet

on:
  push:
    branches: [main]        # ne réagir qu'aux push sur main
    paths: [backend/**]     # ignorer si aucun fichier ne matche

checks:                     # exécutés AVANT le déploiement
  - name: Tests
    run: npm test
  - name: Lint
    run: npm run lint
    image: node:22-alpine   # image optionnelle (défaut node:22-alpine)

La syntaxe s'inspire de GitHub Actions mais n'est pas compatible : seuls les champs documentés ici existent.

on.push : filtrer les déclenchements

Ces filtres ne s'appliquent qu'aux webhooks (push GitHub). Un déploiement manuel depuis le dashboard les ignore toujours.

checks : bloquer un mauvais déploiement

Chaque check est une commande exécutée dans le contexte du build, dans l'ordre. Le premier échec arrête tout : rien n'est déployé, la version en ligne reste intacte.

Jusqu'à 10 checks par fichier. La sortie de chaque check apparaît dans les logs du déploiement.

checks:
  - name: Tests Python
    run: pytest
    image: python:3.12-alpine

Bon à savoir

• Fichier absent ou invalide → ignoré : le déploiement se fait normalement, sans checks (l'erreur de parsing est visible côté plateforme). Validez votre YAML après modification.
• Le fichier est lu au commit déployé : changer les checks dans un commit s'applique dès ce même commit.
• Pour des tests lourds ou des matrices multi-versions, gardez votre CI habituelle (GitHub Actions) en parallèle. kx712.yml est le dernier filet avant la mise en ligne, pas une CI générale.