Declarativo
Pipelines, orden de pasos, workspace Helm y hooks viven en config — no árboles shell ad hoc en el código.
v1.0.0
Mantenimiento declarativo para Kubernetes
Playbooks YAML versionados para down, up y reset ordenados — con hooks, notificaciones y dry-run por defecto.
$ curl -fsSL https://get.kzero.hermesrodriguez.com/install.sh | sh $ kzero --print-sample-config > ./kzero.yaml # adjust $ kzero analyze $ kzero down # dry-run when run.mode: dry-run
curl -fsSL https://get.kzero.hermesrodriguez.com/install.sh | sh
Defaults seguros
dry-run y analyze antes de live; preflight checks; run.api_watchdog y pipeline.stalled detectan pérdida de API y pipelines congelados.
Grado operador
Logs con timestamp, notify Slack/webhook, releases firmados con Cosign y SBOMs — para bastiones y CI, sin botones mágicos.
Flujo de reset bastion-first
De API enferma a down → up / reset ordenado: YAML declarativo en un host que alcanza el clúster out-of-band.
Releases recientes
v1.0.02026-07-15
Estable- run.execution por defecto es native si se omite; códigos de salida 0–4 (config, Kubernetes, executor, notify)
- Smoke kind en CI del producto y cookbook PVC/StatefulSet
- doctor, completion, kubectl-kzero y docs de contrato estable bastion-first
v0.9.22026-07-11
Herramientas- JSON Schema para editors; kzero completion bash/zsh/fish/powershell
- Plugin kubectl-kzero y kzero doctor (config, API, pistas RBAC)
- Reintentos live con full jitter para no alinear waits concurrentes
v0.9.12026-07-11
Seguridad- oras-go v2.6.2 (Helm OCI) — Dependabot/CVE-2026-50163
- Toolchain Go 1.26.5; imágenes distroless static-debian13:nonroot
Contrato estable en v1.0
Patch kzero v1.0.1 — retry trata connection lost como transitorio en APIs lentas/remotas; contrato estable v1.0.0 intacto.kzero v1.0.0
- v1.0.1
Retry: connection lost
El retry en live y ErrTransient del path shell coinciden con connection lost / http2: client connection lost.
- v1.0.0
Default run.execution: native
Si se omite, workloads y Helm SDK usan native. Mantén releases .sh con run.execution: shell o auto.
- v1.0.0
Códigos de salida 0–4
Config 1, Kubernetes 2, executor 3, notify 4 — aptos para cron y CI.
- v1.0.0
Kind CI + cookbook PVC
Smoke testing/kind del producto para down/up live; patrones PVC/StatefulSet documentados.
- v1.0.0
doctor · completion · kubectl-kzero
Doctor de preflight, completion de shell y plugin kubectl en el mismo set de release.
- v1.0.0
Out-of-band por diseño
Bastión/cron es el camino del producto cuando la API está mal — no automation in-cluster como modelo primario.
También en 0.9.x
- v0.9.0
Apagado graceful
SIGINT y SIGTERM cancelan down, up, reset y probe activos — distinto de pipeline.stalled del watchdog.
- v0.9.0
notify.require_delivery
Si es true, un POST notify fallido de pipeline.error o pipeline.stalled falla el pipeline.
- v0.8.0
API watchdog
run.api_watchdog consulta la API en live; tras fail_after se cancela el paso activo.
- v0.7.2
Helm SDK
release.* vía helm.sh/helm/v3 sin binario helm en el host cuando execution es native o auto.
- v0.7.0
Releases firmados
Cosign keyless para ghcr.io/hrodrig/kzero más SBOMs SPDX y CycloneDX.
Inicio rápido
Ejemplo de reset completo de plataforma:kzero-selfhosted/full-reset-example
Repositorios
| Repo | Rol |
|---|---|
| hrodrig/kzero | CLI, engine, SPEC, releases, imagen container |
| hrodrig/kzero-selfhosted | Bastión, cron, ejemplos, kind e2e (pin 0.1.13) |