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.

🌐 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
| Quando | O quê |
|---|---|
| Toda noite | Atualizações de plugins, temas, traduções e versões menores do core após um dump do banco – automático |
| Quando tem que ser agora | ansible-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ção | Ler 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 comk3s kubectl rollout restart deployment/wordpress -n wordpressnã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
commandpró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.
