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

Ilustração: um homem comemorando diante de um teclado brilhante, cercado de ícones de nuvem e código

🌐 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

  1. 🔑 Endurece o SSH — porta customizada, autenticação só por chave, configs mais apertadas
  2. 🔥 Monta regras de firewall IPv4 + IPv6 com detecção de portscan via xt_recent
  3. 🧱 Ativa o SELinux em enforcing com os contextos de container corretos
  4. ☸️ Instala K3s, Helm, cert-manager e nginx-ingress
  5. 📦 Implanta automaticamente a stack completa de workloads Kubernetes
  6. 📝 Configura o WordPress via WP-CLI como um goblin de automação civilizado
  7. ☁️ Configura o Nextcloud via occ, incluindo Redis, SMTP e trusted domains
  8. 📈 Configura exporters de monitoramento + scraping do Prometheus + dashboards do Grafana
  9. 🛡️ Implanta Fail2Ban, auditd, scans do rkhunter e atualizações de segurança automáticas
  10. ☕ 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.yml
  • vars.yml
  • hosts.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_NAME

    As credenciais agora precisam de um arquivo .my.cnf montado.

    Também descobri que permissões 0600 não ajudam se o container roda como nobody. 🤡

  • 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. 🚀🐧☸️

Alguns textos e imagens deste site foram criados com a ajuda de IA ou gerados por IA. Detalhes