Um ano depois: finalmente abri o código da minha stack K3s do homelab

🌐 Também em: English · Deutsch · Français · Español · Italiano · Nederlands · Polski
Em alguns dos meus posts recentes eu mencionei que estava tentando descobrir como publicar o código de automação do meu homelab *sem, sem querer, abrir junto o código da minha infraestrutura inteira* 😅
Acontece que isso é um problema surpreendentemente nada trivial quando o seu inventário Ansible parece um baú de tesouro cyberpunk cheio de vaults, segredos e variáveis específicas de cada host. 🔐🐉
Depois de um pouco de tentativa, erro, cafeína e escolhas de vida questionáveis… finalmente encontrei um setup que funciona lindamente:
👉 dois git remotes separados.
Uma instância Gitea privada e self-hosted guarda o repositório *de verdade* — incluindo segredos criptografados, arquivos de vault e todas as partes internas picantes.
Enquanto isso, um repo público no GitHub recebe só o código de automação limpo, com os arquivos sensíveis excluídos via .gitignore e substituídos por simpáticos templates .example. 🧼✨
Tudo o que é secreto é criptografado com Ansible Vault (AES-256) de qualquer forma — então, mesmo que algo escape de algum jeito, tudo o que um atacante leva é um monte de bobagem criptografada. 🧠💾
📦 Repo:
👉 github.com/aptupgrademe/www_k3s
O projeto provisiona Nextcloud ou WordPress num cluster K3s de nó único novinho rodando em AlmaLinux 9.
Um comando.
Zero click-ops.
Energia nerd máxima. ⚡🤓
Índice
🧠 A ideia
Rode:
ansible-playbook blog.yml --limit <host> --ask-vault-pass
…contra uma VPS completamente nova e veja ela se transformar num servidor WordPress ou Nextcloud totalmente endurecido, com TLS e monitorado, como uma espécie de evolução Pokémon de infraestrutura. 🐛➡️🐉
Nada de ficar mexendo no SSH na mão.
Nada de passos de setup misteriosos.
Nada de cemitério de “TODO: documentar depois”. 💀
Tudo é idempotente — rode de novo quando quiser sem detonar seus dados nem invocar os demônios do configuration drift.
⚙️ A stack num relance
- 🏗️ K3s — Kubernetes sem o trauma corporativo
- 🔀 F5 nginx-ingress — rodando como DaemonSet com
hostNetwork: true - 🔒 cert-manager — certificados Let’s Encrypt automáticos, porque os navegadores anseiam por cadeados verdes
- 📝 WordPress 6.9-fpm + sidecar nginx + MariaDB 10.11
- ☁️ Nextcloud 33-fpm + Redis + Collabora CODE para vibes de escritório self-hosted nível nerd
- 📊 Prometheus + Grafana — porque se você não consegue fazer um gráfico, será que existe mesmo?
- 🛡️ iptables — DROP por padrão, detecção de portscan, rate limiting de ICMP, um pequeno fosso digital 🏰
- 🔐 Fail2Ban, auditd, rkhunter, dnf-automatic — paranoia as code™
🚀 O que uma única execução do playbook realmente faz
- 🔑 Endurece o SSH — porta customizada, autenticação só por chave, configs mais apertadas
- 🔥 Monta regras de firewall IPv4 + IPv6 com detecção de portscan via
xt_recent - 🧱 Ativa o SELinux em enforcing com os contextos de container corretos
- ☸️ Instala K3s, Helm, cert-manager e nginx-ingress
- 📦 Implanta automaticamente a stack completa de workloads Kubernetes
- 📝 Configura o WordPress via WP-CLI como um goblin de automação civilizado
- ☁️ Configura o Nextcloud via
occ, incluindo Redis, SMTP e trusted domains - 📈 Configura exporters de monitoramento + scraping do Prometheus + dashboards do Grafana
- 🛡️ Implanta Fail2Ban, auditd, scans do rkhunter e atualizações de segurança automáticas
- ☕ Provavelmente consome menos café do que eu consumi depurando tudo isso
🔐 Segredos & segurança
Todas as credenciais são criptografadas com Ansible Vault (AES-256).
Arquivos sensíveis como:
vault.ymlvars.ymlhosts.yml
…nunca tocam o repositório público. 🚫🌍
O repo no GitHub contém só código de automação reutilizável e templates .example:
vars.yml.example
vault.yml.example
hosts.yml.example
Clone → preencha os valores → criptografe → faça o deploy. ✨
🙃 Coisas que foram muito mais difíceis do que o esperado
Desafio HTTP-01 do Let’s Encrypt retornando 301
Acontece que redirecionar tudo para HTTPS também redireciona o desafio ACME. Quem diria? 🙃
Resolvido com F5 Mergeable Ingresses (padrão master/minion), para que
/.well-known/passe por fora dos redirects.Loop infinito de redirect HTTPS
Minha primeira lógica no nginx basicamente fez um DDoS filosófico em si mesma.
Resolvido com um padrão de redirect mais limpo, de três variáveis.
mysqld_exporter v0.19.0 matou o
DATA_SOURCE_NAMEAs credenciais agora precisam de um arquivo
.my.cnfmontado.Também descobri que permissões
0600não ajudam se o container roda comonobody. 🤡iptables OUTPUT DROP quebrou as entranhas do K3s
Porque, ao que parece, o Kubernetes adora conversar consigo mesmo o tempo todo.
Resolvido com regras ACCEPT explícitas para os CIDRs de pods/services.
O dashboard 1860 do Grafana mostrava “No data”
Dashboards modernos do Grafana não contêm mais
__inputs.Solução: um script Python minúsculo de patch conversando com a API do Grafana como um pequeno goblin de automação.
🧪 Experimente você mesmo
git clone https://github.com/aptupgrademe/www_k3s.git
cd www_k3s
cp inventory/hosts.yml.example inventory/hosts.yml
cp inventory/host_vars/test/vars.yml.example inventory/host_vars/myhost/vars.yml
# fill in your values, then:
ansible-vault encrypt inventory/host_vars/myhost/vault.yml
ansible-playbook blog.yml --limit myhost --ask-vault-pass
O quickstart completo, a visão geral das roles e a documentação das variáveis estão no README do GitHub.
PRs, feedback e outros nerds de infraestrutura são bem-vindos. 🚀🐧☸️
