infra local para desenvolvimento

Sua stack local em um só comando.

Pyahu CLI provisiona PostgreSQL, ZITADEL, RabbitMQ, Kafka, Kafka Connect, Debezium e Kafka UI em um cluster k3d, com TLS local e endpoints previsíveis. Sem transformar o setup em um projeto paralelo.

Começar agora Ver comandos

$ curl -fsSL https://cli.pyahu.io/install.sh | sh

macOS e Linux · requer Docker ou Podman + k3d

pyahu-local

$ pyahu up
[preflight] Docker, k3d e portas locais OK
[cluster]   k3d pyahu-local pronto
[certs]     Secret pyahu-local-tls aplicado
[services]  postgres · zitadel · rabbitmq · kafka

Pyahu local stack is ready

$ pyahu services
SERVICE        STATUS  ENDPOINTS
postgres       ready   localhost:5432
zitadel        ready   https://zitadel.localhost
rabbitmq       ready   localhost:5672
kafka-connect  ready   http://localhost:8083

$ curl https://zitadel.localhost/debug/healthz
ok▋

o que sobe

Seis serviços, prontos para desenvolver e testar.

Tudo roda local em k3d. Os endpoints batem com o que os apps já esperam: convenção sobre configuração, sem reconfigurar nada.

PostgreSQL

Banco relacional primário, com réplicas de leitura opcionais.

localhost:5432

ZITADEL

Identidade e OIDC em HTTPS local, sem CA pública.

zitadel.localhost

RabbitMQ

Mensageria AMQP com console de management embutido.

localhost:5672

Kafka

Broker em modo KRaft para streaming de eventos.

localhost:9092

Kafka Connect + Debezium

CDC declarativo do Postgres direto no pyahu.yaml.

localhost:8083

Kafka UI

Inspeção visual de tópicos, conectores e consumers.

kafka-ui.localhost

plataforma pyahu

Kubernetes de verdade, não uma abstração.

A Pyahu CLI é a porta de entrada local para a Plataforma Pyahu: um subconjunto fiel da experiência real, rodando na sua máquina. É k3d/k3s de verdade, com Traefik, PersistentVolumes, ConfigMaps e Secrets. A CLI não esconde o Kubernetes do dev. Ela só facilita o provisionamento e a operação, e o cluster continua seu para inspecionar quando quiser.

Conheça a stack local →

$ export KUBECONFIG="$(pyahu kubeconfig)"
$ kubectl get ingress,pvc,cm,secret -n pyahu-local-dev
ingress/zitadel         zitadel.localhost
ingress/kafka-ui        kafka-ui.localhost
pvc/postgres-data       Bound
configmap/rabbitmq-config
secret/pyahu-local-tls  kubernetes.io/tls

começo rápido

Do zero ao cluster rodando em três passos.

Gere a stack

Um preset escreve um pyahu.yaml legível com os serviços, portas e credenciais locais.

$ pyahu init --preset platform

Suba o cluster

A CLI valida dependências, cria o k3d e reconcilia os recursos Kubernetes de forma idempotente.

$ pyahu up

Conecte os apps

Endpoints previsíveis em localhost e variáveis de ambiente prontas para colar.

$ eval "$(pyahu env)"

instalação

Escolha como instalar a CLI.

Binário único, sem runtime. Releases assinadas no GitHub para macOS, Linux e Windows.

# macOS e Linux · instala em /usr/local/bin
$ curl -fsSL https://cli.pyahu.io/install.sh | sh
$ pyahu --version

# requer Go 1.26+
$ go install github.com/pyahu/cli/cmd/pyahu@latest

# baixe o tar da release e extraia
$ tar -xzf pyahu_Linux_x86_64.tar.gz
$ sudo mv pyahu /usr/local/bin/

Detalhes, verificação e autocomplete em Instalação.

localhost com TLS

HTTPS local de verdade, sem CA pública.

A CLI gera uma CA local, emite o certificado para localhost e *.localhost (que cobre zitadel.localhost, kafka-ui.localhost…), grava o Secret TLS no Kubernetes e deixa o trust do host explícito, em um comando.

Como funcionam os certificados →

$ pyahu certs status
CA status:   valid until 2036-06-19
host trust:  not trusted

$ pyahu certs trust
trusted local CA

$ curl https://zitadel.localhost/debug/healthz
ok

change data capture

Debezium declarado no YAML, aplicado no up.

Declare o conector no pyahu.yaml. A CLI renderiza o JSON do Connect, grava em um Secret e aplica via REST API, idempotente a cada pyahu up.

Guia de Kafka Connect →

services:
  kafkaConnect:
    enabled: true
    connectors:
      - name: app-cdc
        type: source
        kind: debezium.postgres
        tables:
          include:
            - public.orders

por que pyahu

Simples por design, do boot ao teardown.

Stack local completa

k3d + manifests gerados pela CLI. Sem kubectl ou helm no fluxo normal.

Auth em HTTPS local

ZITADEL em zitadel.localhost com CA própria e trust explícito no host.

CDC sem cerimônia

Debezium para Postgres declarado no YAML. A CLI renderiza e aplica o conector.

Backup direto

Dumps reais do Postgres para o disco do host; restore de arquivo local ou S3.

Configuração mínima

Um pyahu.yaml define serviços, portas e credenciais. O resto fica nos comandos.

referência

Um verbo para cada etapa do ciclo local.

Ciclo de vida

pyahu init
pyahu up
pyahu down
pyahu doctor

Inspeção

pyahu status
pyahu services
pyahu describe
pyahu logs

Conexão e dados

pyahu env
pyahu kubeconfig
pyahu backup
pyahu restore

TLS local

pyahu certs status
pyahu certs trust
pyahu certs rotate

Referência completa de comandos

pronto para começar

A infraestrutura local fica pronta. O time foca no produto.

Instalar a Pyahu CLI Abrir documentação