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.

Ilustração da série Deep Dive

🌐 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

PodContêineresEstado
wordpressnginx, PHP-FPM, php-fpm_exporter/var/www/html a partir de um hostPath (/srv/wordpress-www)
mariadbMariaDB, mysqld_exporterhostPath /srv/wordpress-db
redisRedisnenhum (só memória)
CronJobswordpress-cron a cada 5 min, wordpress-autoupdate às 03:30o 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-pluginFaz
security-hardeningOculta 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-imagesConverte 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-hintsFaz 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-disclosureUm 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.php fica 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
WordPress7.1, PHP 8.5 (8.4 até 26 de outubro de 2026), tema MoreNews
Posts publicados (os quatro idiomas)488
Páginas16
Banco de dados49 MB
Uploads83 MB em 1.253 arquivos (após a migração para WebP)
Plugins9 normais, 5 must-use, 2 drop-ins (page cache, object cache)
Eventos cron agendados33
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 .wpress dele 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 o blog.yml já 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 flush esvazia o Redis; o page cache precisa de wp_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.

SintomaComando
A página mostra conteúdo antigowp eval 'wp_cache_clear_cache();' # page cache
wp cache flush # object cache (Redis)
Página em branco ou erro 500k3s kubectl -n wordpress logs deploy/wordpress -c wordpress-fpm --tail=50
Um plugin quebrou o sitewp plugin deactivate <slug>
wp plugin install <slug> --version=<old> --force
Quais versões estão instaladas, o que está pendente?wp core version
wp plugin list --update=available
Tarefas agendadas não rodamwp cron event list --fields=hook,next_run_relative
wp cron event run --due-now
A atualização desta noite funcionou?k3s kubectl -n wordpress get jobs | grep autoupdate
k3s kubectl -n wordpress logs job/<job>
Antes de qualquer mudança em conteúdo ou pluginswp 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çãoPonto fortePor que não aqui
Hugo / site estáticoO mais rápido e seguro: sem PHP, sem banco de dadosSem editor web, sem comentários, fluxo de tradução manual.
GhostModerno, rápido, bom editorNode.js, bem menos plugins, multilíngue só com gambiarras.
WordPress headlessWordPress como editor, front end estático ou em JSDois sistemas em vez de um para um blog de um único autor.
WordPressEditor, plugins, Polylang, e o autor o conheceEscolhido.

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.

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