Deep Dive: WordPress su Kubernetes – pod stateless, un CMS stateful e WP-CLI come control plane

WordPress non è mai stato pensato per i container: scrive nella propria directory, si aggiorna da solo e tiene stato ovunque. Come gira comunque qui in K3s, cosa è stato necessario piegare, quanto è veloce con e senza page cache – e cosa perderebbe ancora un rebuild solo da Ansible.

Illustrazione per la serie Deep Dive

🌐 Anche in: English · Deutsch · Français · Español · Português · Nederlands · Polski

Deep Dive della serie attorno all’Ansible Tour. Il tour spiega i ruoli, i deep dive la tecnologia sottostante: come funziona, perché qui viene usata in questo modo, e cosa è andato storto lungo la strada.

Questo blog è WordPress, in esecuzione in un cluster K3s a nodo singolo (la parte 3 del tour mostra i ruoli). WordPress presuppone un web server classico: scrive nella propria directory, installa e aggiorna i plugin dalla sua pagina di amministrazione, e pianifica il lavoro appoggiandosi alle richieste dei visitatori. Kubernetes presuppone il contrario – container sostituibili, configurazione dall’esterno, nessuno stato nell’immagine. Questo post spiega come i due si incontrano qui.

Indice

🧭 Come funziona WordPress

Il percorso di una richiesta

Una richiesta raggiunge l’ingress controller (TLS, rate limit, header di sicurezza), poi il sidecar nginx nel pod WordPress. nginx cerca prima un file HTML pre-renderizzato della page cache; se c’è, PHP non viene mai coinvolto. Altrimenti passa la richiesta a PHP-FPM nello stesso pod, dove WordPress carica il suo core, i plugin e il tema, chiede a Redis gli oggetti in cache e a MariaDB il resto, e renderizza la pagina.

Dove WordPress tiene lo stato

  • File: wp-content/ – plugin, temi, upload, la page cache, i file di lingua. WordPress scrive qui da sé, per esempio quando aggiorna un plugin.
  • Database: post, pagine, utenti, e la tabella wp_options, dove WordPress e ogni plugin tengono le impostazioni – e i transient, valori in cache di breve durata.
  • wp-config.php: connessione al database e chiavi. Nell’immagine ufficiale l’entrypoint lo genera dalle variabili d’ambiente.

Modello di estensione

In WordPress tutto è un hook: azioni (“ora succede X”) e filtri (“questo valore passa di qui, cambialo se vuoi”). Plugin e temi registrano funzioni sugli hook. I must-use plugin in wp-content/mu-plugins/ si caricano automaticamente, prima dei plugin normali, e non possono essere disattivati dalla pagina di amministrazione – il posto giusto per regole che devono valere sempre.

WP-Cron

WordPress non ha un demone. Per default controlla durante le visualizzazioni di pagina se ci sono task pianificati in scadenza e, in caso affermativo, lancia una richiesta a wp-cron.php. Su un sito tranquillo i task girano in ritardo; su uno trafficato il controllo costa tempo su molte richieste.

🛡️ Perché è qui

  • Un vero editor e un ecosistema di plugin. SEO, compressione delle immagini, login a due fattori, un indice dei contenuti – ognuno è a un plugin di distanza.
  • Quattro lingue. Polylang gestisce le versioni inglese, tedesca, francese e spagnola di ogni post con traduzioni collegate.
  • Open source e portabile. Dump del database più wp-content sono l’intero sito; può trasferirsi su qualsiasi host.

🔧 Cosa fa questo repository

Pod e volumi

PodContainerStato
wordpressnginx, PHP-FPM, php-fpm_exporter/var/www/html da un hostPath (/srv/wordpress-www)
mariadbMariaDB, mysqld_exporterhostPath /srv/wordpress-db
redisRedisnessuno (solo memoria)
CronJobwordpress-cron ogni 5 min, wordpress-autoupdate alle 03:30lo stesso volume, brevemente

Le immagini sono stateless; lo stato vive in due directory dell’host con le proprie label SELinux, così il container può scrivere lì e da nessun’altra parte. Il container PHP-FPM ha un root file system in sola lettura e solo cinque capability – quelle di cui l’entrypoint dell’immagine ha davvero bisogno per spacchettare WordPress nel volume al primo avvio e per passare da root a www-data; ognuna è stata testata rimuovendola. WP-CLI viene scaricato da un init container in un volume fuori dalla web root: nginx si rifiuta solo di servire file .php, e un .phar nella document root sarebbe stato un download da 7 MB per chiunque.

Dal 26 ottobre 2026 un nuovo pod WordPress parte prima che quello vecchio si fermi (rolling update invece di Recreate). Due pod sulla stessa directory dell’host qui non sono un problema: l’immagine ufficiale copia WordPress solo in una /var/www/html vuota, quindi un nuovo pod non sovrascrive mai i file che quello vecchio sta servendo. Una modifica di configurazione o un’immagine ricostruita non mettono più offline il blog.

WP-CLI come control plane

Ansible non clicca nella pagina di amministrazione. Ogni modifica passa da WP-CLI dentro il container in esecuzione.

Il ruolo blog_wordpress lo usa per l’installazione, l’elenco dei plugin, le impostazioni, il menu e i cinque must-use plugin. Ogni task prima legge e cambia solo ciò che differisce – il task dei plugin, per esempio, installa solo i plugin mancanti e attiva solo quelli inattivi; una versione precedente reinstallava ogni plugin a ogni esecuzione e li segnalava tutti come “changed”. Una lezione dall’esercizio: WP-CLI appartiene a www-data. Un cache flush avviato come root con --allow-root una volta ha lasciato una directory di cache di proprietà di root in cui WordPress non riusciva più a scrivere. L’installazione dei plugin gira ancora come root per motivi storici ed è seguita da un chown -R in un blocco always:, così la proprietà viene ripristinata anche se un’installazione fallisce.

Il succo: chi cambia contenuti o impostazioni via script prima legge e scrive solo tramite le funzioni di WordPress. Scrivere direttamente nel database qui una volta ha rimosso i backslash dagli esempi di codice.

Cinque must-use plugin

mu-pluginCosa fa
security-hardeningNasconde le stringhe di versione, disattiva l’editor di file nell’admin (altrimenti una sessione admin sarebbe esecuzione di codice), chiude l’enumerazione degli utenti tramite la REST API.
upload-imagesConverte ogni immagine caricata in WebP, al massimo 1.536 px e sotto i 280 KB – il limite oltre il quale i messenger scartano l’immagine di anteprima.
performance-hintsPrecarica il font, carica subito l’immagine più grande di una pagina.
language-links“Disponibile anche in …” sotto ogni post, dai collegamenti di traduzione di Polylang.
ai-disclosureUna discreta nota nel footer e la pagina sull’uso dell’IA.

Cache su tre livelli

  • Page cache (WP Super Cache): file HTML finiti su disco; nginx li serve direttamente, con un controllo dei cookie così che utenti loggati e chi commenta ricevano sempre pagine fresche.
  • Object cache (Redis): risultati delle query al database dentro PHP.
  • OPcache: codice PHP compilato, con controllo dei timestamp ogni 60 s – perché di notte i plugin si aggiornano sul posto.

Sicurezza al bordo

  • xmlrpc.php, install.php, avanzi di backup e di editor (.bak, .sql, ~, .phar) e l’enumerazione ?author= rispondono 403.
  • Rate limit nell’ingress, per IP del client: login 5 richieste al secondo con burst di 5, ricerca 2 al secondo con burst di 10; oltre, 429.
  • Login e /wp-admin/ solo da reti tedesche, con la stessa lista di IP che protegge SSH (il filtro geografico); admin-ajax.php resta aperto perché il front end ne ha bisogno. In più login a due fattori per gli admin; i login falliti ripetuti vengono bannati da fail2ban (il plugin Limit Login Attempts è stato rimosso il 26 ottobre 2026 – il filtro geografico e fail2ban facevano già il suo lavoro).
  • Una Content Security Policy in modalità report-only – la parte 5 spiega perché non ancora in modalità enforcing.

Cron e aggiornamenti senza visitatori

DISABLE_WP_CRON spegne il cron attivato dai visitatori; al suo posto un CronJob Kubernetes esegue php wp-cron.php ogni cinque minuti, in un proprio container con lo stesso volume (concurrencyPolicy: Forbid, così un’esecuzione lenta non viene mai sovrapposta dalla successiva). Un secondo CronJob alle 03:30 aggiorna il core (solo versioni minori), plugin, temi e pacchetti di lingua, esegue le migrazioni del database, svuota la cache e controlla che la home page risponda ancora. Gli aggiornamenti maggiori e i cambi di immagine passano da blog-update.yml, di proposito.

📊 Misurato

Valore
WordPress7.1, PHP 8.5 (8.4 fino al 26 ottobre 2026), tema MoreNews
Post pubblicati (tutte e quattro le lingue)488
Pagine16
Database49 MB
Upload83 MB in 1.253 file (dopo la migrazione a WebP)
Plugin9 normali, 5 must-use, 2 drop-in (page cache, object cache)
Eventi cron pianificati33
Tempo del server al primo byte, pagina in cache~46 ms
Tempo del server al primo byte, renderizzata da PHP~140 ms
Richieste PHP al giorno~21.700

I tempi sono misurati dall’esterno, al netto dell’handshake TLS, quindi includono ancora un round trip di rete. La page cache fa risparmiare circa 90 ms per richiesta – e, cosa più importante, fa risparmiare worker PHP: una pagina in cache costa a nginx una lettura di file, nient’altro.

🔍 Cosa perderebbe un rebuild solo da Ansible

Lo scopo di Ansible è che il server si possa ricostruire dal repository. Per WordPress questo vale per la piattaforma e solo in parte per il sito:

  • Contenuti e impostazioni – post, la configurazione delle lingue di Polylang, le impostazioni dei plugin, la configurazione del tema – vivono nel database. Vengono dal backup notturno, non dal repository. È voluto.
  • Un plugin non è in Ansible. Easy Table of Contents è stato installato dalla pagina di amministrazione ed è documentato come tale; un’installazione nuova dal playbook non lo avrebbe, un ripristino dal backup sì. In ogni caso dev’essere una decisione consapevole, ed è per questo che la guida operativa lo elenca.
  • All-in-One WP Migration è stato rimosso a ottobre 2026: i suoi archivi .wpress nella web root erano protetti solo da un file .htaccess, che nginx non legge. nginx li bloccava comunque; il plugin se n’è andato perché il backup notturno e blog.yml fanno già il suo lavoro.

Il succo: “ricostruibile dal repository” vale per la piattaforma. Contenuti e impostazioni del sito li salva solo il backup.

  • Due cache, due comandi. wp cache flush svuota Redis; la page cache ha bisogno di wp_cache_clear_cache(). Dopo aver modificato un post fuori dall’editor, entrambi.
  • Backup. Una macchina di backup scarica ogni notte un dump del database e la directory wp-content; il ripristino è il dump nel database e i file in /srv/wordpress-www.
  • Rollback di un aggiornamento. Le immagini sono fissate in versions.yml: ripristina la versione e lancia il playbook. Un plugin: wp plugin install <slug> --version=<old> --force.
  • Modificare contenuti via programma. Scrivi il contenuto dei post solo tramite funzioni di WordPress che gestiscono correttamente gli slash – un update diretto una volta ha tolto i backslash dagli esempi di codice in una dozzina di post.
# 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)

🆘 Cheat sheet: sintomo → comando

La versione breve di questo articolo per il momento in cui qualcosa non va. Da eseguire sull’host come root; <…> sono segnaposto. occ e wp sono le funzioni shell dei deep dive su Nextcloud e WordPress.

SintomoComando
La pagina mostra contenuti vecchiwp eval 'wp_cache_clear_cache();' # page cache
wp cache flush # object cache (Redis)
Pagina bianca o errore 500k3s kubectl -n wordpress logs deploy/wordpress -c wordpress-fpm --tail=50
Un plugin ha rotto il sitowp plugin deactivate <slug>
wp plugin install <slug> --version=<old> --force
Quali versioni sono installate, cosa è in sospeso?wp core version
wp plugin list --update=available
I task pianificati non giranowp cron event list --fields=hook,next_run_relative
wp cron event run --due-now
L’aggiornamento di stanotte ha funzionato?k3s kubectl -n wordpress get jobs | grep autoupdate
k3s kubectl -n wordpress logs job/<job>
Prima di qualsiasi modifica a contenuti o pluginwp db export - | gzip > before-change.sql.gz
File improvvisamente di proprietà di root# wp-cli only as www-data (the function above), never --allow-root

🎯 Le lezioni

  • Lo stato vive in due directory e un database; tutto il resto è sostituibile.
  • Ogni modifica tramite WP-CLI e funzioni di WordPress, prima leggere, poi scrivere.
  • Due cache, due comandi: object cache e page cache si svuotano separatamente.
  • Ciò che è stato installato dalla pagina di amministrazione è sconosciuto ad Ansible.
  • Un cambio di pod senza downtime richiede un’immagine che non sovrascriva i file esistenti.

⚖️ Alternative – e perché WordPress

OpzionePunto di forzaPerché non qui
Hugo / sito staticoIl più veloce e sicuro: niente PHP, niente databaseNessun editor web, niente commenti, flusso di traduzione a mano.
GhostModerno, veloce, buon editorNode.js, molti meno plugin, multilingua solo con espedienti.
WordPress headlessWordPress come editor, un front end statico o JSDue sistemi invece di uno per un blog con un solo autore.
WordPressEditor, plugin, Polylang, e l’autore lo conosceScelto.

Far girare WordPress in Kubernetes ha meno a che fare con Kubernetes che con l’essere onesti su dove sta lo stato. Qui sta in due directory e un database, tutti e tre sotto backup, tutto il resto sostituibile – e il control plane non è la pagina di amministrazione ma WP-CLI, chiamato da Ansible, con l’utente giusto.

Alcuni testi e immagini di questo sito sono creati con l’aiuto dell’IA o generati dall’IA. Dettagli