Carta do cluster · folha 01última versão

Do terreno vazio ao cluster em produção

Uma CLI que prepara o cluster (k3d local, k3s numa VPS ou EKS, AKS e GKE), instala o GitOps com Argo CD e investiga problemas com IA.

curl -sfL https://raw.githubusercontent.com/casheiro/yby-cli/main/install.sh | sh -
ou go install github.com/casheiro/yby-cli/cmd/yby@latest
Quadro 02Levantamento

Sem o yby, terreno bruto. Com ele, carta.

Arraste a linha para comparar. À esquerda, o cluster montado à mão; à direita, o mesmo cluster depois do yby.

Terreno bruto✗ YAML escrito à mão✗ segredos em texto puro✗ kubectl apply sem histórico
Carta yby✓ projeto gerado pelo yby init✓ segredos: sealed-secrets, ESO ou sops✓ tudo no Git, aplicado pelo Argo CD
Quadro 03Rota

Do init ao app no ar, sem kubectl apply

O caminho local do yby: o cluster nasce no k3d, o Git é espelhado dentro dele e o Argo CD aplica cada commit.

01 yby initparada 01
02 yby upparada 02
03 bootstrapparada 03
04 commitparada 04
05 argo cdparada 05
Caderneta de camporota local
  1. +0.0s$ yby init --topology standard
  2. +0.6scharts, manifests e CI gerados
  3. +1.2s$ yby up
  4. +1.8sk3d: cluster local criado
  5. +2.4sgit mirror: repositório espelhado no cluster
  6. +3.0sargo cd: instalado via helm
  7. +3.6sroot-app aplicada
  8. +4.2s$ git commit -m "feat: nova api"
  9. +4.8smirror: commit sincronizado
  10. +5.4sargo cd: root-app Healthy
  11. +6.0s✓ app no ar
Quadro 04Instrumentos

Cinco instrumentos de campo

Os plugins do yby. Cada um é um binário separado, instalado com yby plugin install.

Instr. 01topografia

Atlas

Lê Helm, manifests, Compose, Kustomize e Terraform e desenha a topologia em Mermaid.

yby atlas diagram
Instr. 02sismografia

Sentinel

Audita o cluster (CIS, PCI-DSS, SOC 2) e investiga pods com problema.

yby sentinel investigate <pod>
Instr. 03orientação

Bard

Assistente de IA no terminal, que usa sentinel e kubectl como ferramentas.

yby bard -p "por que o pod reinicia?"
Instr. 04registro

Synapstor

Guarda o conhecimento do projeto em UKIs e responde com busca semântica.

yby synapstor search "ingress"
Instr. 05observação

Viz

Painel do cluster no terminal: pods, deployments, statefulsets e services.

yby viz
Quadro 05Perfil do terreno

O que o yby planta, camada por camada

Corte do cluster que o yby monta, da base ao que você toca. Passe o mouse para ler o perfil.

0100200300400cotaAtmosferayby cli · pluginsgithub actions (CI gerado)Troncotraefik · cert-managersecrets: sealed, ESO ou sopsRaízesargo cd · argo workflowsargo eventsSubstratok3s / k3d · helmsystem-upgrade-controlleropcionais: headlamp · minio · keda · kepler · metrics-servercota 47 · substrato
Quadro 06Protocolo de campo

Fale a sua própria língua

Um plugin é um binário yby-plugin-<nome> que fala JSON. Sem DSL proprietária.

O yby pede o manifesto pelo stdin e lê a resposta no stdout. Nos comandos, o pedido chega em YBY_PLUGIN_REQUEST e o plugin usa o terminal direto.

  • go
  • rust
  • python
  • bash
  • qualquer coisa que fale JSON
Documentação de plugins ↗
// 1. handshake: stdin → stdout
→ {"hook": "manifest"}
← {"data": {"name": "meu-plugin", "version": "1.0.0",
           "hooks": ["command"]}}
ybyyby-plugin-meu
// 2. comando: $ yby meu-plugin scan -n default
YBY_PLUGIN_REQUEST={"hook": "command",
                    "args": ["scan", "-n", "default"]}