Declarativo
Pipelines, ordem de passos, workspace Helm e hooks na config — não árvores shell ad hoc no código.
v1.1.0
Manutenção declarativa para Kubernetes
Playbooks YAML versionados para down, up e reset ordenados — com hooks, notificações e dry-run por padrão.
$ 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 e analyze antes de live; preflight checks; run.api_watchdog e pipeline.stalled detectam perda de API e pipelines congelados.
Nível operador
Logs com timestamp, notify Slack/webhook, releases assinados com Cosign e SBOMs — para bastions e CI, sem botões mágicos.
Fluxo de reset bastion-first
De API doente a down → up / reset ordenado: YAML declarativo num host que alcança o cluster fora de banda.
Releases recentes
v1.1.02026-08-01
Minor- kzero diff — desejado vs live com --phase up|down; sai 2 se houver drift
- Passos nativos job/cronjob (ciclo de Job + suspend/resume de CronJob)
- Helm SDK v4.2.3; grpc v1.82.1; ignores GO-2026-5932 removidos
v1.0.22026-07-31
Patch- command.shell — interpretador opt-in para hooks, pre/post, custom e scripts release .sh (default /bin/sh)
- Pin golang.org/x/crypto v0.54.0 e higiene Grype até Helm SDK v4
v1.0.12026-07-15
Patch- Taxonomia retry/subprocess: connection lost e http2: client connection lost como transitórios
v1.0.02026-07-15
Estável- run.execution padrão é native quando omitido; códigos de saída 0–4
- Smoke kind na CI do produto e cookbook PVC/StatefulSet
- doctor, completion, kubectl-kzero e docs de contrato estável bastion-first
v0.9.22026-07-11
Ferramentas- JSON Schema para editors; kzero completion bash/zsh/fish/powershell
- Plugin kubectl-kzero e kzero doctor (config, API, dicas RBAC)
- Retries live com full jitter para não alinhar waits
Novidades em v1.1
kzero v1.1.0 — kzero diff, passos job/cronjob nativos, Helm SDK v4; contrato estável v1.0 intacto.kzero v1.1.0
- v1.1.0
kzero diff
Compara o estado desejado de pipelines.up ou pipelines.down com o cluster (--phase up|down). Sai 2 se houver drift.
- v1.1.0
Passos job / cronjob
Refs compactas sempre nativas: CronJob suspend/resume; Job apaga no down e cria a partir do manifesto no up.
- v1.1.0
Helm SDK v4
O caminho nativo do Helm usa helm.sh/helm/v4; o CLI helm v3 do host continua ok com run.execution: shell.
- v1.0.2
command.shell
Interpretador opt-in para hooks de fase, pre/post por passo, custom e scripts release .sh. Default /bin/sh; doctor verifica o interpretador quando há hooks.
- v1.0.1
Retry: connection lost
O retry em live e ErrTransient do path shell batem com connection lost / http2: client connection lost.
- v1.0.0
Default run.execution: native
Quando omitido, workloads e Helm SDK usam native. Manter releases .sh com run.execution: shell ou auto.
- v1.0.0
Códigos de saída 0–4
Config 1, Kubernetes 2, executor 3, notify 4 — adequados a cron e CI.
- v1.0.0
Kind CI + cookbook PVC
Smoke testing/kind do produto para down/up live; padrões PVC/StatefulSet documentados.
- v1.0.0
doctor · completion · kubectl-kzero
Doctor de preflight, completion de shell e plugin kubectl no mesmo conjunto de release.
- v1.0.0
Out-of-band por desenho
Bastion/cron é o caminho do produto quando a API está doente — não automation in-cluster como modelo primário.
Também em 0.9.x
- v0.9.0
Encerramento graceful
SIGINT/SIGTERM cancelam down/up/reset/probe ativos — distinto de pipeline.stalled.
- v0.9.0
notify.require_delivery
Se true, um POST notify falho de pipeline.error ou pipeline.stalled falha o pipeline.
- v0.8.0
API watchdog
run.api_watchdog consulta a API em live; após fail_after, o passo ativo é cancelado.
- v0.7.2
Helm SDK
release.* via helm.sh/helm/v3 sem binário helm no host quando execution é native ou auto.
- v0.7.0
Releases assinados
Cosign keyless para ghcr.io/hrodrig/kzero mais SBOMs SPDX e CycloneDX.
Início rápido
Exemplo de reset completo de plataforma:kzero-selfhosted/full-reset-example
Repositórios
| Repo | Papel |
|---|---|
| hrodrig/kzero | CLI, engine, SPEC, releases, imagem container |
| hrodrig/kzero-selfhosted | Bastion, cron, exemplos, kind e2e (pin 0.1.15) |