O Tour pelo Ansible, Parte 3: O blog – WordPress, MariaDB e Redis no K3s, role por role

Parte 3 do Tour pelo Ansible: por que cada peça do blog existe, como ela é implantada no K3s, configurada com WP-CLI e mantida atualizada.

Ilustração da série Tour pelo Ansible

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

Parte 3 do Tour pelo Ansible. A Parte 2 construiu a plataforma; esta parte coloca o blog em cima dela. A série descreve a release v3.3.0, com mudanças posteriores adicionadas como atualizações.

Este blog é WordPress. Quatro roles o levam de um cluster Kubernetes vazio até um site rodando, configurado e monitorado: blog_k3s_deploy cria todos os objetos Kubernetes, blog_wordpress configura o WordPress em execução por fora, blog_visitor_stats conta os visitantes de forma anônima durante a noite, e blog_verify verifica no final se tudo funciona. Um playbook de atualização mantém o blog em dia.

Índice

🏗️ O que roda, e por quê

Uma requisição chega na porta 443. O ingress controller a descriptografa, verifica rate limits e caminhos bloqueados e a entrega ao nginx no pod do WordPress. Se a página já está no page cache, o nginx serve esse arquivo – sem PHP nenhum. Só quando a página precisa ser gerada a requisição vai para o PHP-FPM no mesmo pod. O WordPress então pergunta primeiro ao Redis e só depois ao MariaDB.

  • nginx e PHP-FPM em um pod: a imagem oficial contém PHP, mas nenhum servidor web. O nginx serve arquivos estáticos e páginas em cache de forma muito mais barata; o PHP só roda quando é necessário.
  • Page cache: a maioria dos visitantes e quase todos os bots veem a mesma página. Durante uma onda de scanners, essa é a diferença entre um servidor tranquilo e um pool de PHP lotado.
  • Redis como object cache: o WordPress consulta o banco de dados muitas vezes por página. O Redis guarda os resultados na memória, não grava nada em disco e pode ser perdido a qualquer momento.
  • MariaDB em um pod – no blog tudo roda no cluster; a parte 4 mostra por que o Nextcloud faz diferente.
  • Dois diretórios no host para os arquivos do WordPress e o banco de dados. Pods são substituíveis, os dados ficam, e o backup noturno copia exatamente esses diretórios.

🚀 blog_k3s_deploy: o blog como objetos Kubernetes

Cada componente é um template e um arquivo de tasks, aplicados na ordem de suas dependências. Depois de MariaDB, Redis e WordPress, a role espera até os pods ficarem prontos; quando ela termina, o blog está rodando. As partes mais instrutivas são os lugares onde algo deu errado.

Donos como números. A role costumava criar os diretórios no host como root. Os init containers dos pods corrigiam o dono na inicialização – e a próxima execução do playbook voltava tudo atrás. Tudo continuou funcionando até um plugin querer criar uma tabela e falhar com “Permission denied”. Desde então a role define exatamente os valores que os containers esperam: uid 33 para o WordPress, 999 para o MariaDB, e as mesmas permissões. Dois lugares que estabelecem o mesmo estado precisam concordar, senão brigam a cada execução.

Configuração que nunca chegou. Os arquivos de configuração são montados no pod com subPath, e montagens assim nunca são atualizadas em um pod em execução. Uma configuração alterada só entrava em vigor no próximo restart acidental. Agora o template do pod carrega um checksum sobre a configuração: se ela muda, o template muda, e o Kubernetes faz o rollout de um novo pod. “Lembre-se de reiniciar” virou algo que você não tem como esquecer.

Senhas como arquivos. Variáveis de ambiente ficam visíveis em /proc, em kubectl describe e em algumas páginas de erro. Por isso o MariaDB lê suas senhas de arquivos montados a partir de um secret. O exporter de métricas costumava fazer login como root; hoje ele tem seu próprio usuário com três privilégios e sem acesso às tabelas do WordPress. Se esse usuário está correto é verificado por uma query SQL que conta: usuário e privilégios completos dão 4, qualquer outro número o recria. Isso também transforma uma troca de senha em “mude no vault, rode o playbook”.

O entrypoint que nunca rodou. O Redis inicia com seu próprio command:, e no Kubernetes command substitui o entrypoint da imagem – o script que teria trocado de root para o usuário redis. Até outubro de 2026 o Redis rodava, portanto, como root, com duas capabilities para uma troca que nunca aconteceu. Agora o container inicia diretamente como uid 999 e não precisa de capability nenhuma.

O pod do WordPress. O WP-CLI, a ferramenta que o Ansible usa para controlar o WordPress, ficava no web root. O nginx recusava só arquivos .php, não .phar – qualquer um podia baixar a ferramenta de 7 MB. Hoje ela mora do lado de fora, com versão fixada e conferida contra um checksum, porque depois ela roda como root. Cada container descarta todas as capabilities e recebe de volta só as que precisa, com um comentário por capability, e roda com um sistema de arquivos raiz somente leitura. DISALLOW_FILE_EDIT remove o editor de código da área administrativa: sem isso, uma senha de admin roubada fica a um clique de PHP arbitrário no servidor.

Desde 26 de outubro de 2026 o pod do WordPress é atualizado com rolling update: o novo pod fica pronto, depois o antigo para. Isso é seguro aqui porque a imagem oficial só copia o WordPress para um web root vazio. O MariaDB continua com Recreate – dois processos de banco de dados nos mesmos arquivos seriam o caminho garantido para um banco corrompido.

Os jobs agendados. Em vez do WP-Cron disparado pelos visitantes, um CronJob roda wp-cron.php a cada cinco minutos. Ele teve dois bugs que valem a história. Seus pods tinham o mesmo label do pod do WordPress, então durante seus dez segundos de vida eles pertenciam ao service – e o ingress mandava visitantes reais para um pod sem servidor web: um 502 ocasional a cada cinco minutos. E o container de cron não tinha a configuração do Redis; cada execução morria com um erro de conexão, em silêncio, porque o WordPress sai com 0 nesse caso. Um segundo CronJob atualiza plugins, temas, traduções e versões menores do core durante a noite – mas só depois que um dump do banco de dados deu certo.

Roteamento. O ingress controller da F5 divide um hostname em um master (certificado, redirecionamento para HTTPS, rate limits para login e busca) e minions (os caminhos, os security headers). A página de login ganhou sua própria location para o rate limit – e por um tempo foi servida sem o header HSTS, porque as regras de header ficam no minion. Desde 19 de outubro de 2026, /wp-login.php e /wp-admin/ só respondem a endereços da Alemanha, usando a mesma lista de países que protege o SSH.

Regras de rede com um modelo de ameaças. O PHP-FPM processa entrada não confiável e é o lugar mais provável para um atacante executar código. Mas ele precisa do banco de dados e do Redis. Por isso as NetworkPolicies garantem que só os pods do WordPress alcancem o MariaDB e o Redis, e limitam o que um pod do WordPress comprometido consegue alcançar no cluster. HTTPS de saída continua aberto, com um comentário honesto: as atualizações vêm de endereços de CDN que mudam, e NetworkPolicies não conhecem nomes de domínio. Além disso, uma admission policy verifica que só iniciam imagens de uma lista de repositórios permitidos.

A lição: em um container, muita coisa é diferente do que a configuração sugere – um entrypoint que não roda, um arquivo que não atualiza, um label que transforma um pod de cron em servidor web. Isso só aparece quando você olha o que realmente está rodando.

🔧 blog_wordpress: configurando um site em execução por fora

Não existe módulo Ansible para WordPress; tudo passa pelo WP-CLI no pod, e a role inteira é uma longa aplicação de “primeiro pergunte, depois aja”. Uma regra está no topo: comandos que instalam código rodam como root e são sempre seguidos de uma troca de dono de volta para www-data; todo o resto roda como www-data direto. A regra existe porque um diretório de cache certa vez ficou com dono root e o plugin de cache não conseguia mais gravar nele.

Os pequenos must-use plugins da role – hardening, aviso de IA, links de idioma, dicas de performance, processamento de imagens – são primeiro gravados como .new, comparados por checksum e só substituídos se forem diferentes. Antes disso, cada execução sobrescrevia o arquivo e reiniciava o WordPress – trinta a sessenta segundos de 502 a cada vez. A lista de plugins fica no inventory; a role instala só o que falta, em vez de reinstalar todo plugin com --force a cada execução e puxar versões mais novas em silêncio pelo caminho. Uma seção always restaura a propriedade dos arquivos mesmo quando um download é interrompido no meio de uma execução.

As atualizações comparam dois snapshots de todas as versões, antes e depois; o WordPress só reinicia se algo mudou. Plugins e temas não usados são apagados, porque desativados eles continuam no disco e ainda podem ser atacados. Em 26 de outubro de 2026 o plugin Limit Login Attempts também seguiu esse caminho: a proteção que ele oferecia já é dada pelo filtro de países na frente da página de login e por uma jail do fail2ban. Desde 19 de outubro, todo upload de imagem também é salvo como WebP, com no máximo 1.536 pixels de largura e abaixo de 280 KB – o WhatsApp ignora imagens de prévia maiores e mostra o logo no lugar.

A lição: configurar uma aplicação por fora significa conhecer suas manias – quem é dono dos arquivos, quando ela recarrega o código, qual saída significa “nada a fazer”. Reiniciar só em uma mudança real é a diferença entre uma execução de playbook invisível e uma que atrapalha.

📊 Estatísticas de visitantes e a verificação final

Em vez de um script de rastreamento, um serviço noturno conta os visitantes a partir dos logs do ingress, no servidor, e guarda só os números – sem cookies, sem terceiros. Ele roda em um sandbox do systemd que só permite gravar no seu próprio diretório de dados.

No final de cada execução, blog_verify e a role compartilhada common_verify verificam cerca de 30 itens: firewall, fail2ban, SELinux, K3s, os pods, HTTPS e seus headers, caminhos bloqueados como xmlrpc.php, nenhum nome de usuário pela REST API. Todos os checks rodam primeiro e só registram seu resultado, depois o relatório sai por e-mail, e só depois disso um assert pode fazer a execução falhar. Desde 26 de outubro de 2026, testes de efeito fazem parte disso, por exemplo se um ban do fail2ban realmente chega no kernel.

🔄 blog-update.yml: a atualização de rotina

O playbook de atualização mexe só na aplicação, e da mesma forma que o job noturno: ele o dispara. Antes disso, ele se recusa a rodar sem --limit e em um site que já não tem um pod rodando – dois problemas ao mesmo tempo seriam difíceis de separar. Depois ele verifica se o Docker Hub reconstruiu uma imagem com a mesma tag, por exemplo para uma correção de segurança do PHP; o K3s nunca puxa essas imagens sozinho. Só os deployments afetados reiniciam, em uma ordem fixa, banco de dados primeiro. Por fim, a página inicial precisa responder com 200. Se algo falha, a parte rescue mostra pods, eventos e o dump mais recente do banco – e para. Não há rollback automático: um restore é uma decisão.

A lição: uma tag de imagem não diz nada sobre o seu conteúdo. A atualização do PHP de 21 de outubro de 2026 mostrou isso: a mesma tag continha uma versão diferente do PHP antes e depois da correção.

🛠️ Operação

QuandoO quê
Toda noiteAtualizações de plugins, temas, traduções e versões menores do core após um dump do banco – automático
Quando tem que ser agoraansible-playbook blog-update.yml --limit <host>, com --check primeiro
Quando versions.yml muda--tags blog_k3s_deploy depois de um dry run
Depois de cada execuçãoLer o e-mail do verify
  • 502 Bad Gateway: o nginx roda, o PHP-FPM não responde. Olhe os logs do container wordpress-fpm; um restart com k3s kubectl rollout restart deployment/wordpress -n wordpress não causa downtime desde o rolling update.
  • Rode o WP-CLI sempre como www-data, a menos que você instale código e corrija o dono depois.
  • Uma atualização de plugin quebrou o site: o job noturno fez o dump do banco antes (14 dias); restaure o dump e fixe o plugin na última versão boa.
  • O servidor inteiro sumiu: monte um novo com o playbook completo, restaure arquivos e banco de dados do backup externo, rode o playbook mais uma vez.

🎯 As lições da parte 3

  • O que uma role e um container definem ao mesmo tempo, eles precisam definir do mesmo jeito.
  • Configuração montada precisa de um checksum no template do pod, senão nunca chega.
  • Um command próprio substitui o entrypoint – defina o usuário no pod, não no script.
  • Reinicie uma aplicação só quando algo realmente mudou.
  • Uma tag de imagem não diz nada sobre o seu conteúdo; imagens reconstruídas precisam ser detectadas.

🧭 Para onde o tour vai agora

A Parte 4 é o Nextcloud: os mesmos blocos de construção, mas com o banco de dados e o Redis no host, uma suíte de escritório e um serviço de push. Se você só roda um blog, pode pular direto para a parte 5, as roles de segurança. A tecnologia por trás desta parte é explicada nos deep dives sobre WordPress, PHP-FPM, MariaDB e Redis.

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