Declarativo
Pipelines, orden de pasos, workspace Helm y hooks viven en config — no árboles shell ad hoc en el código.
v1.1.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.1.02026-08-01
Minor- kzero diff — deseado vs live con --phase up|down; sale 2 si hay drift
- Pasos nativos job/cronjob (ciclo de Job + suspend/resume de CronJob)
- Helm SDK v4.2.3; grpc v1.82.1; se quitan ignores GO-2026-5932
v1.0.22026-07-31
Patch- command.shell — intérprete opt-in para hooks, pre/post, custom y scripts release .sh (default /bin/sh)
- Pin golang.org/x/crypto v0.54.0 e higiene Grype hasta Helm SDK v4
v1.0.12026-07-15
Patch- Taxonomía retry/subprocess: connection lost y http2: client connection lost como transitorios
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
Novedades en v1.1
kzero v1.1.0 — kzero diff, pasos job/cronjob nativos, Helm SDK v4; contrato estable v1.0 intacto.kzero v1.1.0
- v1.1.0
kzero diff
Compara el estado deseado de pipelines.up o pipelines.down con el cluster (--phase up|down). Sale 2 si hay drift.
- v1.1.0
Pasos job / cronjob
Refs compactos siempre nativos: CronJob suspend/resume; Job borra en down y crea desde manifest en up.
- v1.1.0
Helm SDK v4
El path nativo de Helm usa helm.sh/helm/v4; el CLI helm v3 del host sigue valiendo con run.execution: shell.
- v1.0.2
command.shell
Intérprete opt-in para hooks de fase, pre/post por paso, custom y scripts release .sh. Default /bin/sh; doctor comprueba el intérprete si hay hooks.
- 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.15) |