git log –since=”1 year ago”: um ano de apt-upgrade.me && publicando os playbooks Ansible para Nextcloud no K3s

🌐 Também em: English · Deutsch · Français · Español · Italiano · Nederlands · Polski
Em toda jornada de homelab chega um momento em que você olha para a sua pilha de
scripts bash, arquivos de configuração feitos à mão e post-its que dizem coisas como
“lembrar de dar chown no /data antes de iniciar” — e decide:
chega. 😅
Este é esse post. Hoje estou publicando os playbooks Ansible que venho usando para implantar
e operar Nextcloud ☁️ e WordPress 📝 em um
cluster K3s de nó único rodando em AlmaLinux 9.
Tudo é infrastructure-as-code, totalmente idempotente,
e vem com um guia de operação completo.
Mas antes, uma breve palavra dos nossos patrocinadores — com o que quero dizer:
um momento de autorreflexão involuntária. 🙂
🎉 Parêntese: espera, este blog faz aniversário?
Ontem fez exatamente um ano desde que o primeiro post foi ao ar neste blog.
Ele continha exatamente duas palavras: Hallo Welt.
Que é alemão para Hello World,
que é programadorês para:
“Ainda não faço a menor ideia do que estou fazendo, mas tenho um domínio, uma VPS,
e por
git pushvou usar os dois." 🚀Sinceramente, eu não esperava que este blog ainda existisse um ano depois.
A maioria dos meus projetos paralelos segue um ciclo de vida bem previsível:
git init→ explosão de entusiasmo → três commits →
git stash→ esquecido para sempre 💀E mesmo assim aqui estamos com um ano de uptime, o que, em termos de projeto pessoal,
equivale mais ou menos a uma empresa da Fortune 500 comemorando seu centenário.
As métricas são proporcionalmente impressionantes:
- 📚 vários posts
- 👀 pelo menos dois leitores (um deles sou eu conferindo o layout no celular)
- 📈 um dashboard do Grafana que ninguém além de mim jamais olhou
Conquista desbloqueada. 🏆
Voltamos agora ao assunto de fato deste post.
Índice
🚀 O que este repositório faz
O código que estou publicando hoje é um toolkit de infraestrutura baseado em Ansible
que provisiona e gerencia workloads em um
cluster K3s de nó único rodando em AlmaLinux 9:
☁️ Nextcloud — sincronização de arquivos e colaboração self-hosted,
incluindo o Collabora CODE para edição de documentos online
📝 WordPress — exatamente para o tipo de blog que você está lendo agora
As duas stacks compartilham um conjunto comum de roles Ansible que cobrem:
hardening de SSH 🔐,
regras de firewall 🛡️,
monitoramento 📊,
relay de e-mail,
atualizações automáticas de segurança,
varredura de rootkits,
e logs de auditoria.
Os playbooks foram feitos para serem idempotentes:
você pode rodá-los repetidamente contra um sistema em produção e eles só mudam o que realmente
precisa mudar. ✨
Toda a infraestrutura está descrita em código.
Não há passos manuais escondidos em algum caderno por aí.
Se o servidor pegar fogo (figurativamente — é uma VPS 😄),
um novo pode ser provisionado do zero com um único
comando ansible-playbook e um restore do backup.
☸️ Arquitetura: Nextcloud no K3s
A decisão central de design é um cluster Kubernetes de nó único usando K3s.
Sem alta disponibilidade. Sem setup multi-master. Sem cluster etcd.
Só um servidor, um nó, um ponto único de falha — intencionalmente.
Para esse tipo de workload, a simplicidade operacional vale muito mais do que fingir
rodar um hyperscaler em um homelab. 🙂
O K3s ainda nos dá todos os recursos bons do Kubernetes:
- ⚙️ manifests declarativos
- 🔄 deployments com rolling update
- 🔐 cert-manager
- 🌍 ingress controllers
...sem o overhead operacional.
🛡️ Segurança: defesa em profundidade
O modelo de segurança é em camadas. Nenhum mecanismo isolado recebe confiança exclusiva.
Em vez disso, a stack combina vários controles independentes:
- 🔥 iptables com políticas padrão DROP
- 🔐 configuração de SSH endurecida
- 🚫 Fail2Ban para proteção contra força bruta
- ⚡ rate limiting no nginx
- 🧩 SELinux em modo enforcing
- 🔑 segredos criptografados via Ansible Vault
- 🕵️ monitoramento com auditd + rkhunter
- 📦 atualizações automáticas de segurança
Ou, dito de outra forma:
defesa em profundidade, e não
“tomara que ninguém escaneie esta VPS.” 😄
📊 Monitoramento: Prometheus + Grafana
O monitoramento é totalmente automatizado usando:
Prometheus 📈,
Grafana 📊,
Node Exporter,
mysqld_exporter,
e métricas do PHP-FPM.
Os dashboards são importados e configurados automaticamente pelo playbook,
incluindo:
- 📈 Node Exporter Full
- 🗄️ MySQL Overview
- ⚡ Métricas do PHP-FPM
Porque, se você vai fazer over-engineering em um homelab,
pode muito bem ter gráficos bonitos mostrando exatamente o quanto ele é over-engineered. 🙂
💾 Backup e restore
O repositório inclui scripts de backup e restore de verdade —
não só sentimentos otimistas e uma pasta chamada
backup_final_v2_REAL. 😅
Os backups cobrem:
- 🗄️ dumps do MariaDB
- 📂 arquivos da aplicação Nextcloud
- ☁️ dados dos usuários
- 🔄 automação do restore
Depois de um restore, rodar o playbook de novo garante que toda a configuração e
as definições da aplicação voltem automaticamente ao estado esperado.
🚀 Primeiros passos
O repositório tem como alvo uma instalação nova de AlmaLinux 9.
O processo de setup é propositalmente simples:
- ⚙️ Configure seu inventory e as variáveis de host
- 🔐 Criptografe seu vault com Ansible Vault
- 📦 Instale as collections Ansible necessárias
- 🚀 Rode o playbook
O deployment é totalmente idempotente, ou seja, mudanças futuras —
sejam atualizações de imagem, ajustes no firewall ou apps adicionais —
podem simplesmente ser aplicadas rodando o playbook de novo.
📥 Download
O repositório completo está disponível como arquivo ZIP.
Extraia, preencha seus host_vars,
criptografe seu vault e você está pronto para o deploy:
unzip www_k3s.zip
cd www_k3s
ansible-galaxy collection install -r requirements.yml
ansible-vault encrypt inventory/host_vars/<host>/vault.yml
ansible-playbook nextcloud-k3s.yml --limit <host> --ask-vault-pass
👉
Licença MIT, sem garantia – revise você mesmo antes de usar.
Perguntas, problemas ou sugestões? 💬
Deixe nos comentários abaixo.
Uma observação: ainda não resolvi direito como quero publicar e manter o código de forma adequada via GitLab, então por enquanto o estado atual é disponibilizado como um simples arquivo ZIP 📦. A longo prazo talvez eu mova tudo para o GitHub ou outro repositório público, mas isso ainda é um debate de infraestrutura em aberto entre mim, meu tempo livre e várias listas de TODO inacabadas. 😄
