# Die Datei kx712.yml

Source : https://webgune.cloud/de-de/docs/kx712-yml · Mis à jour le 2026-10-27

# 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

```yaml
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

| Feld | Wirkung |
|-------|-------|
| `branches` | Liste von Branches: ein Push anderswo wird ignoriert |
| `paths` | Dateimuster (`backend/**`, `*.md`…): wenn keine geänderte Datei passt, kein Build |

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.

| Feld | Rolle |
|-------|------|
| `name` | Im Build-Log angezeigte Bezeichnung |
| `run` | Der auszuführende Befehl |
| `image` | Container-Image des Checks (Standard `node:22-alpine`) |

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

```yaml
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.