Deep Dive: WordPress no Kubernetes – pods stateless, um CMS stateful e o WP-CLI como plano de controle
O WordPress nunca foi feito para contêineres: ele escreve no próprio diretório, se atualiza sozinho e guarda estado em todo lugar. Como ele roda aqui no K3s mesmo assim, o que precisou ser adaptado, quão rápido ele é com e sem o page cache – e o que um rebuild só a partir do Ansible ainda deixaria de fora.

🌐 Também em: English · Deutsch · Français · Español · Italiano · Nederlands · Polski
Deep Dive da série em torno do Ansible Tour. O tour explica os roles; os deep dives, a tecnologia por baixo: como funciona, por que é usada assim aqui e o que deu errado no caminho.
Este blog é WordPress, rodando num cluster K3s de um único nó (a parte 3 do tour mostra os roles). O WordPress pressupõe um servidor web clássico: ele escreve no próprio diretório, instala e atualiza plugins pela página de administração e agenda tarefas pegando carona nas requisições dos visitantes. O Kubernetes pressupõe o contrário – contêineres substituíveis, configuração vinda de fora, nenhum estado na imagem. Este post explica como os dois se encontram aqui.
Índice
🧭 Como o WordPress funciona
O caminho da requisição
Uma requisição chega ao ingress controller (TLS, rate limits, security headers) e depois ao sidecar nginx no pod do WordPress. O nginx procura primeiro um arquivo HTML pré-renderizado do page cache; se existir, o PHP nem entra em cena. Caso contrário, ele repassa a requisição ao PHP-FPM no mesmo pod, onde o WordPress carrega o core, os plugins e o tema, pede objetos em cache ao Redis e o resto ao MariaDB, e renderiza a página.
Onde o WordPress guarda estado
- Arquivos:
wp-content/– plugins, temas, uploads, o page cache, arquivos de idioma. O próprio WordPress escreve aqui, por exemplo quando atualiza um plugin. - Banco de dados: posts, páginas, usuários e a tabela
wp_options, onde o WordPress e cada plugin guardam configurações – e transients, valores em cache de vida curta. wp-config.php: conexão com o banco e chaves. Na imagem oficial, o entrypoint gera esse arquivo a partir de variáveis de ambiente.
Modelo de extensão
Tudo no WordPress é um hook: actions (“agora acontece X”) e filters (“este valor passa por aqui, altere se quiser”). Plugins e temas registram funções nos hooks. Must-use plugins em wp-content/mu-plugins/ carregam automaticamente, antes dos plugins normais, e não podem ser desativados pela página de administração – o lugar certo para regras que precisam valer sempre.
WP-Cron
O WordPress não tem daemon. Por padrão, a cada visualização de página ele verifica se há tarefas agendadas vencidas e, se houver, dispara uma requisição para wp-cron.php. Num site tranquilo as tarefas rodam atrasadas; num site movimentado a verificação custa tempo em muitas requisições.
🛡️ Por que ele está aqui
- Um editor de verdade e um ecossistema de plugins. SEO, compressão de imagens, login em dois fatores, um sumário – cada um está a um plugin de distância.
- Quatro idiomas. O Polylang gerencia versões em inglês, alemão, francês e espanhol de cada post, com traduções vinculadas.
- Open source e portátil. Dump do banco mais
wp-contenté o site inteiro; ele pode mudar para qualquer host.
🔧 O que este repositório faz
Pods e volumes
| Pod | Contêineres | Estado |
|---|---|---|
| wordpress | nginx, PHP-FPM, php-fpm_exporter | /var/www/html a partir de um hostPath (/srv/wordpress-www) |
| mariadb | MariaDB, mysqld_exporter | hostPath /srv/wordpress-db |
| redis | Redis | nenhum (só memória) |
| CronJobs | wordpress-cron a cada 5 min, wordpress-autoupdate às 03:30 | o mesmo volume, por pouco tempo |
As imagens são stateless; o estado mora em dois diretórios do host com rótulos SELinux próprios, então o contêiner pode escrever ali e em nenhum outro lugar. O contêiner PHP-FPM tem um sistema de arquivos raiz somente leitura e apenas cinco capabilities – aquelas de que o entrypoint da imagem realmente precisa para descompactar o WordPress no volume na primeira inicialização e para trocar de root para www-data; cada uma foi testada removendo-a. O WP-CLI é baixado por um init container para um volume fora da raiz web: o nginx só se recusa a servir arquivos .php, e um .phar na raiz de documentos teria sido um download de 7 MB para qualquer um.
Desde 26 de outubro de 2026, um novo pod do WordPress sobe antes de o antigo parar (rolling update em vez de Recreate). Dois pods no mesmo diretório do host não são problema aqui: a imagem oficial só copia o WordPress para um /var/www/html vazio, então um pod novo nunca sobrescreve os arquivos que o antigo está servindo. Uma mudança de configuração ou uma imagem reconstruída não tira mais o blog do ar.
WP-CLI como plano de controle
O Ansible não fica clicando na página de administração. Toda mudança passa pelo WP-CLI dentro do contêiner em execução.
O role blog_wordpress usa o WP-CLI para a instalação, a lista de plugins, as configurações, o menu e os cinco must-use plugins. Cada task lê primeiro e só muda o que difere – a task de plugins, por exemplo, instala só os plugins que faltam e ativa só os inativos; uma versão anterior reinstalava todos os plugins a cada execução e reportava todos como “changed”. Uma lição da operação: o WP-CLI pertence ao www-data. Um cache flush iniciado como root com --allow-root deixou uma vez um diretório de cache de propriedade do root, no qual o WordPress não conseguia mais escrever. A instalação de plugins ainda roda como root por razões históricas e é seguida de um chown -R num bloco always:, para que a propriedade seja restaurada mesmo se uma instalação falhar.
A lição: Quem muda conteúdo ou configurações por script lê primeiro e só escreve por meio de funções do WordPress. Escrever direto no banco de dados já removeu aqui as barras invertidas de exemplos de código.
Cinco must-use plugins
| mu-plugin | Faz |
|---|---|
| security-hardening | Oculta strings de versão, desativa o editor de arquivos no admin (senão uma sessão de admin seria execução de código), fecha a enumeração de usuários via REST API. |
| upload-images | Converte toda imagem enviada para WebP, no máximo 1.536 px e abaixo de 280 KB – o limite acima do qual os mensageiros descartam a imagem de pré-visualização. |
| performance-hints | Faz preload da fonte, carrega a maior imagem de uma página de forma eager. |
| language-links | “Também disponível em …” abaixo de cada post, a partir dos links de tradução do Polylang. |
| ai-disclosure | Um aviso discreto no rodapé e a página de uso de IA. |
Cache em três camadas
- Page cache (WP Super Cache): arquivos HTML prontos no disco; o nginx os serve diretamente, com uma verificação de cookie para que usuários logados e quem comenta sempre recebam páginas atualizadas.
- Object cache (Redis): resultados de consultas ao banco dentro do PHP.
- OPcache: código PHP compilado, com verificação de timestamp a cada 60 s – porque os plugins se atualizam no lugar durante a noite.
Segurança na borda
xmlrpc.php,install.php, restos de backup e de editor (.bak,.sql,~,.phar) e a enumeração via?author=respondem 403.- Rate limits no ingress, por IP de cliente: login 5 requisições por segundo com burst de 5, busca 2 por segundo com burst de 10; acima disso, 429.
- Login e
/wp-admin/só a partir de redes alemãs, com a mesma lista de IPs que protege o SSH (o filtro geográfico);admin-ajax.phpfica aberto porque o front end precisa dele. Além disso, login em dois fatores para admins; falhas de login repetidas são banidas pelo fail2ban (o plugin Limit Login Attempts saiu em 26 de outubro de 2026 – o filtro geográfico e o fail2ban já faziam o trabalho dele). - Uma Content Security Policy em modo report-only – a parte 5 explica por que ainda não está em modo enforcing.
Cron e atualizações sem visitantes
DISABLE_WP_CRON desliga o cron disparado por visitantes; em vez disso, um CronJob do Kubernetes executa php wp-cron.php a cada cinco minutos, num contêiner próprio com o mesmo volume (concurrencyPolicy: Forbid, para que uma execução lenta nunca seja sobreposta pela próxima). Um segundo CronJob às 03:30 atualiza o core (só versões menores), plugins, temas e pacotes de idioma, roda as migrações do banco, limpa o cache e verifica se a página inicial ainda responde. Atualizações maiores e mudanças de imagem passam pelo blog-update.yml, de propósito.
📊 Medido
| Valor | |
|---|---|
| WordPress | 7.1, PHP 8.5 (8.4 até 26 de outubro de 2026), tema MoreNews |
| Posts publicados (os quatro idiomas) | 488 |
| Páginas | 16 |
| Banco de dados | 49 MB |
| Uploads | 83 MB em 1.253 arquivos (após a migração para WebP) |
| Plugins | 9 normais, 5 must-use, 2 drop-ins (page cache, object cache) |
| Eventos cron agendados | 33 |
| Tempo do servidor até o primeiro byte, página em cache | ~46 ms |
| Tempo do servidor até o primeiro byte, renderizada pelo PHP | ~140 ms |
| Requisições PHP por dia | ~21.700 |
Os tempos foram medidos de fora, descontando o handshake TLS, então ainda incluem uma ida e volta de rede. O page cache economiza cerca de 90 ms por requisição – e, mais importante, economiza workers PHP: uma página em cache custa ao nginx uma leitura de arquivo, nada mais.
🔍 O que um rebuild só a partir do Ansible perderia
A graça do Ansible é que o servidor pode ser reconstruído a partir do repositório. Para o WordPress isso vale para a plataforma e só em parte para o site:
- Conteúdo e configurações – posts, a configuração de idiomas do Polylang, configurações de plugins, a configuração do tema – moram no banco de dados. Eles vêm do backup noturno, não do repositório. Isso é intencional.
- Um plugin não está no Ansible. O Easy Table of Contents foi instalado pela página de administração e está documentado assim; uma instalação nova pelo playbook não o teria, uma restauração do backup sim. De qualquer forma, tem de ser uma decisão consciente, e por isso o guia de operação o lista.
- O All-in-One WP Migration foi removido em outubro de 2026: os arquivos
.wpressdele na raiz web eram protegidos apenas por um arquivo.htaccess, que o nginx não lê. O nginx os bloqueava de qualquer forma; o plugin saiu porque o backup noturno e oblog.ymljá fazem o trabalho dele.
A lição: “Reconstruível a partir do repositório” vale para a plataforma. O conteúdo e as configurações do site só ficam salvos pelo backup.
- Dois caches, dois comandos.
wp cache flushesvazia o Redis; o page cache precisa dewp_cache_clear_cache(). Depois de editar um post fora do editor, os dois. - Backups. Uma máquina de backup puxa toda noite um dump do banco e o diretório
wp-content; restaurar é o dump no banco e os arquivos em/srv/wordpress-www. - Rollback de uma atualização. As imagens estão fixadas em
versions.yml: reverta o pin e rode o playbook. Um plugin:wp plugin install <slug> --version=<old> --force. - Editar conteúdo por programa. Escreva o conteúdo dos posts só por meio de funções do WordPress que fazem o escape correto – um update direto já removeu as barras invertidas de exemplos de código em uma dúzia de posts.
# a WP-CLI shell function on the host
wp() { k3s kubectl -n wordpress exec deploy/wordpress -c wordpress-fpm -- \
su -s /bin/sh www-data -c "php /usr/local/lib/wp-cli/wp-cli.phar --path=/var/www/html $*"; }
wp core version; wp plugin list
wp cron event list --fields=hook,next_run_relative
wp eval 'wp_cache_clear_cache();' # WP Super Cache (wp cache flush = object cache only)
wp db export - | gzip > before-change.sql.gz
# nightly update log
k3s kubectl -n wordpress logs job/$(k3s kubectl -n wordpress get jobs \
-o name | grep autoupdate | tail -1 | cut -d/ -f2)
🆘 Cola: sintoma → comando
A versão curta deste artigo para o momento em que algo dá errado. Execute no host como root; <…> são placeholders. occ e wp são as funções de shell dos deep dives de Nextcloud e WordPress.
| Sintoma | Comando |
|---|---|
| A página mostra conteúdo antigo | wp eval 'wp_cache_clear_cache();' # page cachewp cache flush # object cache (Redis) |
| Página em branco ou erro 500 | k3s kubectl -n wordpress logs deploy/wordpress -c wordpress-fpm --tail=50 |
| Um plugin quebrou o site | wp plugin deactivate <slug>wp plugin install <slug> --version=<old> --force |
| Quais versões estão instaladas, o que está pendente? | wp core versionwp plugin list --update=available |
| Tarefas agendadas não rodam | wp cron event list --fields=hook,next_run_relativewp cron event run --due-now |
| A atualização desta noite funcionou? | k3s kubectl -n wordpress get jobs | grep autoupdatek3s kubectl -n wordpress logs job/<job> |
| Antes de qualquer mudança em conteúdo ou plugins | wp db export - | gzip > before-change.sql.gz |
| Arquivos de repente pertencem ao root | # wp-cli only as www-data (the function above), never --allow-root |
🎯 As lições
- O estado mora em dois diretórios e um banco de dados; todo o resto é substituível.
- Toda mudança via WP-CLI e funções do WordPress: primeiro ler, depois escrever.
- Dois caches, dois comandos: o object cache e o page cache são limpos separadamente.
- O que foi instalado pela página de administração é desconhecido para o Ansible.
- Uma troca de pod sem downtime precisa de uma imagem que não sobrescreva arquivos existentes.
⚖️ Alternativas – e por que WordPress
| Opção | Ponto forte | Por que não aqui |
|---|---|---|
| Hugo / site estático | O mais rápido e seguro: sem PHP, sem banco de dados | Sem editor web, sem comentários, fluxo de tradução manual. |
| Ghost | Moderno, rápido, bom editor | Node.js, bem menos plugins, multilíngue só com gambiarras. |
| WordPress headless | WordPress como editor, front end estático ou em JS | Dois sistemas em vez de um para um blog de um único autor. |
| WordPress | Editor, plugins, Polylang, e o autor o conhece | Escolhido. |
Rodar WordPress no Kubernetes tem menos a ver com Kubernetes do que com ser honesto sobre onde está o estado. Aqui ele está em dois diretórios e um banco de dados, os três com backup, todo o resto substituível – e o plano de controle não é a página de administração, mas o WP-CLI, chamado pelo Ansible, como o usuário certo.
