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

Ilustração: um homem comemorando um primeiro aniversário com fogos de artifício e logos de tecnologia

🌐 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 push vou 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:

  1. ⚙️ Configure seu inventory e as variáveis de host
  2. 🔐 Criptografe seu vault com Ansible Vault
  3. 📦 Instale as collections Ansible necessárias
  4. 🚀 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

👉

Baixar www_k3s.zip

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. 😄

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