Documentação
por etapas reais.
HeroCtl é um orquestrador de contêineres self-hosted distribuído como binário único. Esta documentação cobre a operação completa: instalar em qualquer Linux com Docker, subir um cluster com plano de controle replicado em 3 nós, fazer rolling/canary/blue-green deploys com zero downtime, configurar TLS automático via Let's Encrypt, gerenciar secrets, métricas e backup — tudo em 14 documentos curtos, com comandos reais e manifestos que rodam.
Guias curtos, comandos reais, manifestos que rodam. Do primeiro instalar até o quinto incidente — na ordem que você vai precisar.
Instalar, subir cluster, comandos do dia a dia.
Instalação
Instale o HeroCtl em qualquer servidor Linux com Docker em um único comando. Cobre pré-requisitos, bootstrap e verificação.
Subir cluster de 3 nós
Forme um cluster com 3 servidores em menos de 10 minutos. Tolera falha de 1 nó sem indisponibilidade.
Referência completa do CLI
Todos os comandos heroctl com sinopse, flags e exemplo. Use como cola de mesa.
Multi-region (em planejamento Q4 2026)
O que esperar de multi-region no HeroCtl, como rodar em várias regiões hoje e o roadmap até 2027.
Levar código pra produção sem ceder downtime.
Deploy do primeiro app
Suba uma aplicação Node.js com banco Postgres em 50 linhas de YAML. Inclui health check, rolling deploy e rollback.
Rolling, canary, blue-green e rainbow
Quatro estratégias de deploy. Quando usar cada uma, com exemplos completos e trade-offs honestos.
Domínio, certificado e firewall sem ferramenta externa.
Ingress e TLS automático
Como expor aplicações pela porta 443 com certificados emitidos e renovados automaticamente, sem operar um roteador externo.
Configuração de firewall
Quais portas o HeroCtl usa, quais precisam ficar abertas, e quais nunca deveriam ser expostas à internet.
Secrets, RBAC e quem pode tocar no que.
Gerenciamento de segredos
Como guardar senhas, tokens e chaves fora do spec do job, com criptografia em repouso e rotação versionada.
RBAC e controle de acesso (Business+)
Modelo de papéis, políticas e tokens para limitar quem pode submeter, ler e operar o cluster.
Métricas, logs e backup do estado do cluster.
Métricas e logs
Coleta de métricas, logs e traces sem montar uma pilha de observabilidade externa. Quando vale, e quando integrar com ferramenta de fora.
Backup e restore do estado do cluster
Como salvar, agendar e restaurar snapshots do plano de controle do HeroCtl. Estratégia de disaster recovery.
Endpoints HTTP pra automação e integração.
Quando algo dá errado: do alerta ao diagnóstico.
Comece pelo começo.
Se é seu primeiro contato, siga a ordem da lista acima. Em meia hora você tem cluster de 3 nós com app rodando atrás de HTTPS.