El archivo kx712.yml

El archivo kx712.yml

kx712.yml, colocado en la raíz del repositorio, controla el comportamiento CI de tus despliegues: filtros de activación y checks ejecutados antes de cada puesta en línea. Es totalmente opcional.

Ejemplo completo

on:
  push:
    branches: [main]        # reaccionar solo a los push en main
    paths: [backend/**]     # ignorar si ningún archivo coincide

checks:                     # ejecutados ANTES del despliegue
  - name: Tests
    run: npm test
  - name: Lint
    run: npm run lint
    image: node:22-alpine   # imagen opcional (por defecto node:22-alpine)

La sintaxis se inspira en GitHub Actions pero no es compatible: solo existen los campos documentados aquí.

on.push: filtrar los disparadores

Estos filtros solo se aplican a los webhooks (push de GitHub). Un despliegue manual desde el dashboard siempre los ignora.

checks: bloquear un mal despliegue

Cada check es un comando ejecutado en el contexto del build, en orden. El primer fallo detiene todo: no se despliega nada, la versión en línea permanece intacta.

Hasta 10 checks por archivo. La salida de cada check aparece en los logs del despliegue.

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

Bueno saberlo

• Archivo ausente o inválido → ignorado: el despliegue se realiza normalmente, sin checks (el error de parsing es visible en la plataforma). Valida tu YAML tras cada modificación.
• El archivo se lee en el commit desplegado: cambiar los checks en un commit se aplica desde ese mismo commit.
• Para tests pesados o matrices multi-versión, mantén tu CI habitual (GitHub Actions) en paralelo. kx712.yml es la última red antes de la puesta en línea, no una CI general.