# El archivo kx712.yml

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

# 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

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

| Campo | Efecto |
|-------|-------|
| `branches` | Lista de ramas: un push en otro lugar se ignora |
| `paths` | Patrones de archivos (`backend/**`, `*.md`…): si ningún archivo modificado coincide, no hay build |

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.

| Campo | Función |
|-------|------|
| `name` | Etiqueta mostrada en los logs de build |
| `run` | El comando a ejecutar |
| `image` | Imagen de contenedor del check (por defecto `node:22-alpine`) |

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

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