Die Datei kx712.yml

Die Datei kx712.yml

kx712.yml, platziert im Wurzelverzeichnis des Repositories, steuert das CI-Verhalten Ihrer Deployments: Auslöserfilter und vor jeder Veröffentlichung ausgeführte Checks. Sie ist vollständig optional.

Vollständiges Beispiel

on:
  push:
    branches: [main]        # nur auf Pushes auf main reagieren
    paths: [backend/**]     # ignorieren, wenn keine Datei passt

checks:                     # VOR dem Deployment ausgeführt
  - name: Tests
    run: npm test
  - name: Lint
    run: npm run lint
    image: node:22-alpine   # optionales Image (Standard node:22-alpine)

Die Syntax ist von GitHub Actions inspiriert, aber nicht kompatibel: nur die hier dokumentierten Felder existieren.

on.push: Auslöser filtern

Diese Filter gelten nur für Webhooks (GitHub-Push). Ein manuelles Deployment vom Dashboard ignoriert sie immer.

checks: ein fehlerhaftes Deployment blockieren

Jeder Check ist ein Befehl, der im Kontext des Builds ausgeführt wird, in Reihenfolge. Der erste Fehlschlag stoppt alles: nichts wird deployt, die Live-Version bleibt unverändert.

Bis zu 10 Checks pro Datei. Die Ausgabe jedes Checks erscheint in den Deployment-Logs.

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

Gut zu wissen

• Fehlende oder ungültige Datei → ignoriert: das Deployment läuft normal ab, ohne Checks (der Parsing-Fehler ist auf Plattformseite sichtbar). Validieren Sie Ihr YAML nach einer Änderung.
• Die Datei wird beim deployten Commit gelesen: eine Änderung der Checks in einem Commit gilt ab genau diesem Commit.
• Für aufwendige Tests oder Multi-Versions-Matrizen behalten Sie Ihre gewohnte CI (GitHub Actions) parallel bei. kx712.yml ist das letzte Netz vor der Veröffentlichung, keine allgemeine CI.