Tour pelo Ansible, parte 2: a plataforma – de um AlmaLinux pelado a um cluster Kubernetes

Parte 2 do Tour pelo Ansible: pacotes, parâmetros do kernel, e-mail, updates noturnos, K3s, Helm, cert-manager, ingress e Calico – role por role.

Ilustração da série Tour pelo Ansible

🌐 Também em: English · Deutsch · Français · Español · Italiano · Nederlands · Polski

Parte 2 do Tour pelo Ansible. A parte 1 explicou como o repositório é construído; esta parte começa lá embaixo. A série descreve o release v3.3.0, com mudanças posteriores acrescentadas como atualizações.

Todo servidor aqui começa como uma imagem cloud simples de AlmaLinux 9: um Linux mínimo, um login de root, nada mais. No fim desta parte ele é um sistema base atualizado que envia e-mail, se atualiza à noite e rotaciona os próprios logs – e roda um cluster Kubernetes de um nó só com Helm, certificados Let’s Encrypt automáticos e um ingress controller. Essa é a plataforma sobre a qual ficam o blog e o Nextcloud. Quase tudo é igual para os dois.

Índice

🖥️ Antes da primeira role: servidor, distribuição, tamanho

Os três servidores são máquinas virtuais alugadas (VPS) em dois provedores diferentes, para que uma queda ou um problema de conta em um deles não derrube tudo. Na escolha, o preço importa menos do que os pontos que contam na operação: um data center na UE com contrato de processamento de dados, endereços IPv4 e IPv6 fixos, um console web que ainda funciona quando o SSH já não funciona, e snapshots antes de mudanças arriscadas. Teste o console antes de precisar dele: com SSH endurecido e firewall, ele é o caminho de volta depois de um erro seu.

As roles são escritas para AlmaLinux 9 e nada mais. Os motivos: cerca de dez anos de atualizações de segurança por versão major, updates que carregam um tipo (o que permite instalar automaticamente só as correções de segurança), SELinux em enforcing de fábrica com uma policy para containers, e o CIS benchmark e a maioria das ferramentas saem primeiro para essa família. O AlmaLinux 10 vem depois: para o 9, EPEL, a policy SELinux do K3s e os repositórios de terceiros estão maduros, e as atualizações de segurança vão até 2032.

ServidorvCPURAMDiscoRAM em idle
Blog48 GB240 GBcerca de 2,5 GB
Nextcloud pequeno (poucos usuários)612 GB200 GBcerca de 3 GB
Nextcloud grande (cerca de 150 usuários)824 GB600 GBcerca de 4 GB

A plataforma desta parte – K3s, o container runtime, os pods de sistema, cert-manager, o ingress – ocupa cerca de 1,3 a 1,5 GB disso, Prometheus e Grafana cerca de 0,5 GB. O resto é a aplicação e o cache de arquivos, que o Linux enche com toda a memória livre. Nenhum dos servidores tem swap: um servidor que começa a usar swap já é pequeno demais, e o alerta de memória da parte 6 avisa isso antes. Antes da primeira execução, um servidor precisa só da imagem, de uma chave SSH para root, das suas entradas no inventário e de registros DNS apontando para ele – o cert-manager só consegue um certificado para um nome que resolve para o servidor.

A lição: comece pequeno, meça com o monitoramento e cresça quando os números pedirem. A maioria dos provedores permite isso sem reinstalar.

📦 blog_packages e next_packages: da imagem ao sistema base

O único par de roles no repositório que faz o mesmo trabalho em duas variantes: o blog roda tudo em containers, um host Nextcloud roda também MariaDB e Redis direto no host e precisa para isso de mais dois repositórios e mais dois serviços. A role primeiro define um hostname de verdade – uma imagem cloud se chama localhost, e cinco relatórios noturnos vindos de “localhost” não servem para nada. Depois ela configura os repositórios (EPEL; no Nextcloud também CRB e MariaDB Community com uma série de versão fixada), instala todos os updates e os pacotes base.

Não existe um módulo Ansible adequado para repositórios, então a role usa comandos com um padrão que se repete no repositório inteiro: primeiro perguntar, depois agir. Uma task só lê (por exemplo dnf repolist) e nunca reporta mudança; uma segunda task só roda se a resposta mostrar que falta algo. A primeira execução reporta uma mudança, todas as seguintes nenhuma – a pré-condição para a idempotência da parte 1.

O update do sistema deixa os kernels de fora, e o motivo é instrutivo. O hardening de SSH da parte 5 inicia toda sessão SSH com ProtectKernelModules numa visão privada do sistema de arquivos, em que o diretório de módulos do kernel está vazio e somente leitura. Ninguém que entra via SSH consegue carregar um módulo – o Ansible incluído, e um kernel novo precisa colocar seus módulos exatamente ali. Por isso os kernels chegam à noite pelo dnf-automatic, que roda como timer do systemd fora de qualquer sessão SSH. Pelo mesmo motivo a role usa systemd-run para verificar se é preciso reiniciar depois de um update da imagem: só um processo que o próprio systemd inicia vê o sistema de arquivos real.

Por fim, a role desliga o que o servidor não usa: firewalld, os helpers de NFS e LDAP. O que está mascarado nem sequer sobe como dependência de outro serviço.

A lição: um hardening vale também para a ferramenta que o configurou. Se você não quer contorná-lo, leve o trabalho para onde ele pertence – aqui, para um timer do systemd.

🧮 common_sysctl: parâmetros do kernel

Dois arquivos em /etc/sysctl.d/: um para velocidade (TCP BBR em vez de CUBIC, filas maiores para conexões de entrada, limites de inotify mais altos para o K3s, write-back mais cedo das páginas sujas) e um para segurança, os itens de rede do CIS benchmark (sem ICMP redirects, sem source routing, SYN cookies, ptrace restrito). O mais instrutivo é o que ela deixa de fora: um perfil CIS comum desliga o IP forwarding e liga o reverse path filtering estrito. Num nó Kubernetes as duas coisas quebrariam o cluster – os pods são alcançados por roteamento no host. Um comentário datado no template garante que ninguém “conserte” isso seguindo o benchmark às cegas.

Como a sessão SSH também vê /proc/sys como somente leitura, a role define os valores via systemd-run, em toda execução: um handler só reage a arquivos alterados, não a alguém ter mudado um valor em tempo de execução com sysctl -w. Desde 26 de outubro de 2026 a role também coloca psi=1 na linha de comando do kernel: o kernel EL9 vem com o pressure stall information (PSI) desligado, e por isso o painel “Pressure” no Grafana ficava vazio.

A lição: um benchmark é escrito para um servidor genérico. Onde ele prejudica um nó Kubernetes, desvie com um motivo – e anote o motivo.

✉️ common_msmtp: e-mail sem servidor de e-mail

Metade dos mecanismos de proteção avisa por e-mail: scanners, o job de update, o alerta de login SSH, o watchdog. Um servidor de e-mail seria mais um serviço com uma porta aberta. O msmtp é o oposto: sem daemon, sem fila. Um programa chama sendmail, o msmtp entrega o e-mail a uma conta SMTP externa e termina. A role pega as credenciais dos mesmos valores de inventário que o Nextcloud usa e esconde a saída da task de template com no_log, porque o arquivo contém a senha.

Dois erros de outubro de 2026 mostram por que um caminho de e-mail precisa de testes. O cron enviava e-mails com o remetente root, que o provedor rejeitava – as mensagens se perderam por semanas até a role corrigir o remetente. E a senha SMTP continha um #, que iniciava um comentário na configuração do Grafana. Desde então o Monit verifica o msmtp.log em busca de qualquer e-mail rejeitado, e o Grafana manda uma vez por semana um e-mail que sempre tem que chegar.

A lição: um caminho de e-mail que só carrega alertas só é notado quando um alerta falta. Ele precisa de um sinal de vida regular.

🌙 common_dnf_automatic: updates à noite

O dnf-automatic instala toda noite só os pacotes marcados como correções de segurança; todo o resto continua sendo uma execução planejada com o playbook. A parte interessante é o horário da noite, porque vários jobs dependem uns dos outros:

HoraO quê
00:00O AIDE compara os arquivos do sistema com sua baseline
01:00–02:00Os updates de segurança são instalados
03:30Reboot, se um update precisar
03:45Serviços que ainda rodam código substituído são reiniciados
04:00A baseline do AIDE é renovada
04:30O ClamAV escaneia os dados dos usuários (Nextcloud)
06:00E-mail de aviso se ainda houver reboot pendente

O timer de fábrica rodava às 06:00 – depois da janela de reboot e depois da renovação do AIDE. Assim, todo update de segurança aparecia como alerta do AIDE na noite seguinte, e um kernel novo esperava quase um dia pelo reboot. A role move o timer com um drop-in do systemd. Uma armadilha se esconde numa linha vazia: OnCalendar= sem valor primeiro limpa a lista de fábrica; sem ela o timer rodaria às 01:00 e às 06:00.

A lição: jobs noturnos formam uma corrente. Mover um deles significa conferir a ordem inteira.

🗂️ common_logrotate

Grafana e Prometheus vêm sem regras de rotação, fail2ban e rkhunter com regras incompletas. A role as acrescenta. A única diretiva que você precisa entender é postrotate: um programa em execução mantém seu arquivo de log aberto e continua escrevendo no arquivo renomeado até que alguém mande ele reabrir.

☸️ common_k3s: Kubernetes num servidor só

Por que Kubernetes num único servidor? Cada aplicação é descrita como um conjunto de objetos no repositório e pode ser recriada de forma idêntica num servidor novo; um update significa trocar uma tag de imagem, e o rollback funciona do mesmo jeito; cada aplicação tem seu próprio namespace com suas próprias regras de rede e limites de recursos; e as duas stacks são implantadas da mesma forma. O preço é complexidade e cerca de 1,5 GB de memória. O K3s é a distribuição certa: um binário com API server, scheduler, kubelet, containerd e Flannel. O que ele traz além disso fica desligado – Traefik, ServiceLB e local-storage. O que não roda não pode ser atacado.

A configuração é escrita antes de o K3s subir pela primeira vez: um audit log para o API server (quem fez o quê; para secrets só quem, nunca o conteúdo), um limite de eventos por segundo e os admission plugins. Foi aí que estava uma das armadilhas mais instrutivas: no Kubernetes, enable-admission-plugins acrescenta à lista padrão; no K3s, substitui. Com só o EventRateLimit, o NodeRestriction sumiu em silêncio – o plugin que mantém um kubelet comprometido restrito aos próprios objetos. Uma nova execução do kube-bench encontrou isso.

Binário e script de instalação são fixados na mesma versão e vêm do release no GitHub, não de get.k3s.io, que sempre entrega o script mais recente e respondeu com HTTP 500 por um tempo durante a primeira instalação de um servidor. A role lê a versão instalada e só baixa se houver diferença. Até 19 de outubro de 2026 faltava force: true no download: o Ansible pulava a tarefa porque o arquivo já existia, e nenhum aumento de versão desde a primeira instalação chegou de fato, sem que nada reclamasse. Desde então uma verificação no fim de cada execução compara a versão que o kubelet informa com a fixada.

Como todas as roles depois desta falam com o cluster, a role não espera o fim do play para reiniciar o K3s: meta: flush_handlers executa o restart na hora, e uma task espera até a API responder – com retries em vez de uma pausa fixa.

cert-manager busca os certificados no Let’s Encrypt e os renova. Ele é instalado com o módulo Helm do Ansible, que só atualiza quando há uma diferença real; o comando shell anterior reportava mudança em toda execução. Antes de o ClusterIssuer poder ser criado, o Kubernetes precisa conhecer o novo tipo de objeto – a role espera por isso. E como o ingress controller da F5 ignora em silêncio um segundo ingress para o mesmo hostname, o cert-manager cria seu ingress de challenge como “minion”, que é mesclado ao ingress da aplicação.

O ingress controller é a única coisa que responde nas portas 80 e 443: um pod com hostNetwork, configurado para TLS 1.2 e 1.3, HTTP/2, sem número de versão no header do servidor, e com as zonas para rate limiting das páginas de login. Um detalhe custou uma sessão de debug: para um hostname sem certificado, esse controller simplesmente fecha a conexão – no navegador, impossível de distinguir de um servidor fora do ar. Um certificado de fallback autoassinado torna a diferença visível. Desde 26 de outubro de 2026 o access log dele também registra o content type e o tamanho de cada requisição.

Por fim, a conta default de cada namespace não recebe mais um token de API montado: uma aplicação web não precisa falar com o API server, e uma comprometida não deveria conseguir.

A lição: uma task de update que reporta “ok” não necessariamente atualizou alguma coisa, e uma flag com o mesmo nome não necessariamente faz o mesmo no K3s e no Kubernetes. Confira o que roda, não o que está configurado.

Calico: o componente que nunca fez nada

Até 19 de outubro de 2026 o Calico rodava ao lado do K3s para aplicar as NetworkPolicies. Um teste mostrou que ele nunca tinha aplicado uma única: o agente do Calico reconhece pods só por interfaces chamadas cali*, enquanto o Flannel do K3s as chama de veth*. A aplicação das regras vinha o tempo todo do policy controller embutido no K3s. A observação anterior de que “a regra deny-all só funcionava com Calico” não pode ter sido verdadeira. O Calico saiu; o deep dive sobre K3s conta a história inteira.

A lição: um componente de segurança só funciona quando um teste mostra que ele bloqueia algo. Que ele roda só mostra que ele usa memória.

🛠️ Na operação

A maior parte desta parte roda sozinha. Dois e-mails fazem parte dela: “Rebooting now after security update” significa que um kernel ou uma biblioteca central chegou à noite e o servidor reiniciou às 03:30 – nada a fazer. “WARNING: reboot still required” significa que o reboot automático não aconteceu; olhe journalctl -b -1 e reinicie manualmente.

  • Pacotes do host que não são correções de segurança só vêm com a role de pacotes (--tags blog_packages ou next_packages).
  • K3s, Helm e os charts: mude o pin em versions.yml, drift check com --tags common_k3s, depois a execução de verdade. K3s sempre uma versão minor por vez; leia antes as release notes e faça um snapshot.
  • Confira as NetworkPolicies: um pod de outro namespace não pode alcançar uma porta protegida.
  • Parâmetros do kernel: mude o template, --tags common_sysctl. Nunca “conserte” IP forwarding ou reverse path filtering pelo manual.

🎯 As lições da parte 2

  • Um hardening vale também para o Ansible – trabalho que ele proíbe vai para um timer do systemd ou para trás de systemd-run.
  • Abandone um benchmark com motivo documentado onde ele prejudica um nó Kubernetes.
  • Jobs noturnos formam uma corrente; a ordem deles faz parte da configuração.
  • Depois de um update, conta a versão em execução, não a mensagem da task.
  • Prove um componente de segurança com um teste, não com o status dele.

🧭 Para onde o tour vai agora

A plataforma está de pé: um sistema base atualizado com e-mail, updates noturnos e logs rotacionados, e um cluster Kubernetes com certificados, uma porta de entrada e regras de rede que funcionam. A parte 3 coloca o blog em cima dela, a parte 4 o Nextcloud. SSH, firewall, hardening e SELinux estão na parte 5.

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