L'Ansible Tour, parte 3: il blog – WordPress, MariaDB e Redis su K3s, ruolo per ruolo

Parte 3 dell'Ansible Tour: perché esiste ogni pezzo del blog, come viene distribuito su K3s, configurato con WP-CLI e tenuto aggiornato.

Illustrazione per la serie Ansible Tour

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

Parte 3 dell’Ansible Tour. La parte 2 ha costruito la piattaforma; questa parte ci mette sopra il blog. La serie descrive la release v3.3.0, con le modifiche successive aggiunte come aggiornamenti.

Questo blog è WordPress. Quattro ruoli lo portano da un cluster Kubernetes vuoto a un sito web in esecuzione, configurato e monitorato: blog_k3s_deploy crea tutti gli oggetti Kubernetes, blog_wordpress configura dall’esterno il WordPress in esecuzione, blog_visitor_stats conta di notte i visitatori in forma anonima, e blog_verify controlla alla fine che tutto funzioni. Un playbook di aggiornamento tiene il blog aggiornato.

Indice

🏗️ Cosa gira, e perché

Una richiesta arriva sulla porta 443. L’ingress controller la decifra, controlla i rate limit e i percorsi bloccati e la passa all’nginx nel pod di WordPress. Se la pagina è già nella page cache, nginx serve quel file – niente PHP. Solo se la pagina va generata la richiesta va a PHP-FPM nello stesso pod. WordPress allora chiede prima a Redis e solo dopo a MariaDB.

  • nginx e PHP-FPM in un solo pod: l’immagine ufficiale contiene PHP ma nessun web server. nginx serve i file statici e le pagine in cache in modo molto più economico; PHP gira solo quando serve.
  • Page cache: la maggior parte dei visitatori e quasi tutti i bot vedono la stessa pagina. Durante un’ondata di scanner è la differenza tra un server tranquillo e un pool PHP pieno.
  • Redis come object cache: WordPress interroga il database molte volte per pagina. Redis tiene i risultati in memoria, non scrive nulla su disco e può andare perso in qualsiasi momento.
  • MariaDB in un pod – sul blog gira tutto nel cluster; la parte 4 mostra perché Nextcloud fa diversamente.
  • Due directory dell’host per i file di WordPress e per il database. I pod sono sostituibili, i dati restano, e il backup notturno copia esattamente queste directory.

🚀 blog_k3s_deploy: il blog come oggetti Kubernetes

Ogni componente è un template e un file di task, applicati nell’ordine delle loro dipendenze. Dopo MariaDB, Redis e WordPress il ruolo aspetta che i pod siano pronti; quando finisce, il blog è in esecuzione. Le parti più istruttive sono i punti in cui qualcosa è andato storto.

Proprietari come numeri. Il ruolo creava le directory dell’host come root. Gli init container dei pod correggevano il proprietario all’avvio – e l’esecuzione successiva del playbook lo rimetteva com’era. Tutto ha continuato a funzionare finché un plugin ha voluto creare una tabella ed è fallito con “Permission denied”. Da allora il ruolo imposta esattamente i valori che i container si aspettano: uid 33 per WordPress, 999 per MariaDB, e gli stessi permessi. Due punti che stabiliscono lo stesso stato devono essere d’accordo, altrimenti litigano a ogni esecuzione.

Configurazione che non arrivava mai. I file di configurazione sono montati nel pod con subPath, e questi mount non si aggiornano mai in un pod in esecuzione. Un’impostazione modificata entrava in vigore solo al successivo riavvio casuale. Ora il template del pod porta un checksum sulla configurazione: se cambia, cambia il template, e Kubernetes distribuisce un nuovo pod. “Ricordati di riavviare” è diventato qualcosa che non puoi dimenticare.

Password come file. Le variabili d’ambiente sono visibili in /proc, in kubectl describe e in alcune pagine di errore. MariaDB quindi legge le sue password da file montati da un secret. L’exporter delle metriche si collegava come root; oggi ha un utente proprio con tre privilegi e nessun accesso alle tabelle di WordPress. Se questo utente è giusto lo verifica una query SQL che conta: utente e privilegi completi danno 4, qualsiasi altro numero lo ricrea. Questo trasforma anche un cambio di password in “cambiala nel vault, esegui il playbook”.

L’entrypoint che non girava mai. Redis parte con un proprio command:, e in Kubernetes command sostituisce l’entrypoint dell’immagine – lo script che avrebbe fatto il passaggio da root all’utente redis. Fino a ottobre 2026 Redis quindi girava come root, con due capability per un passaggio che non avveniva mai. Ora il container parte direttamente come uid 999 e non ha bisogno di alcuna capability.

Il pod di WordPress. WP-CLI, lo strumento con cui Ansible controlla WordPress, stava nella web root. nginx rifiutava solo i file .php, non i .phar – chiunque poteva scaricare lo strumento da 7 MB. Oggi vive fuori, con una versione fissata e verificato con un checksum, perché in seguito gira come root. Ogni container rinuncia a tutte le capability e si riprende solo quelle che gli servono, con un commento per capability, e gira con un root file system in sola lettura. DISALLOW_FILE_EDIT toglie l’editor di codice dall’area di amministrazione: senza, una password di admin rubata è a un clic da PHP arbitrario sul server.

Dal 26 ottobre 2026 il pod di WordPress si aggiorna con un rolling update: il nuovo pod diventa pronto, poi il vecchio si ferma. Qui è sicuro perché l’immagine ufficiale copia WordPress solo in una web root vuota. MariaDB resta con Recreate – due processi di database sugli stessi file sarebbero la via sicura verso un database rotto.

I job pianificati. Invece del WP-Cron guidato dai visitatori, un CronJob esegue wp-cron.php ogni cinque minuti. Aveva due bug che vale la pena raccontare. I suoi pod portavano la stessa label del pod di WordPress, quindi per i loro dieci secondi di vita appartenevano al service – e l’ingress mandava visitatori veri a un pod senza web server: un 502 occasionale ogni cinque minuti. E al container del cron mancava la configurazione di Redis; ogni esecuzione moriva su un errore di connessione, in silenzio, perché in quel caso WordPress esce con 0. Un secondo CronJob aggiorna di notte plugin, temi, traduzioni e versioni minori del core – ma solo dopo che un dump del database è riuscito.

Routing. L’ingress controller di F5 divide un hostname in un master (certificato, redirect a HTTPS, rate limit per login e ricerca) e dei minion (i percorsi, gli header di sicurezza). La pagina di login ha ricevuto una propria location per il rate limit – e per un po’ è stata servita senza l’header HSTS, perché le regole degli header stanno nel minion. Dal 19 ottobre 2026 /wp-login.php e /wp-admin/ rispondono solo a indirizzi dalla Germania, usando la stessa lista di paesi che protegge SSH.

Regole di rete con un modello di minaccia. PHP-FPM elabora input non fidato ed è il punto più probabile in cui un attaccante esegue codice. Però ha bisogno del database e di Redis. Le NetworkPolicy quindi fanno sì che solo i pod di WordPress raggiungano MariaDB e Redis, e limitano ciò che un pod WordPress compromesso può raggiungere nel cluster. L’HTTPS in uscita resta aperto, con un commento onesto: gli aggiornamenti arrivano da indirizzi CDN che cambiano, e le NetworkPolicy non conoscono nomi di dominio. In più una admission policy controlla che partano solo immagini da una lista di repository consentiti.

In sintesi: in un container molto è diverso da ciò che la configurazione fa pensare – un entrypoint che non gira, un file che non si aggiorna, una label che trasforma un pod di cron in un web server. Lo vedi solo quando guardi cosa gira davvero.

🔧 blog_wordpress: configurare dall’esterno un sito in esecuzione

Non esiste un modulo Ansible per WordPress; tutto passa da WP-CLI nel pod, e l’intero ruolo è una lunga applicazione di “prima chiedi, poi agisci”. In cima c’è una regola: i comandi che installano codice girano come root e sono sempre seguiti da un cambio di proprietario di nuovo a www-data; tutto il resto gira subito come www-data. La regola esiste perché una volta una directory di cache è rimasta di proprietà di root e il plugin di cache non poteva più scriverci.

I piccoli must-use plugin del ruolo – hardening, avviso IA, link tra le lingue, suggerimenti di performance, elaborazione delle immagini – vengono prima scritti come .new, confrontati tramite checksum e sostituiti solo se diversi. Prima, ogni esecuzione sovrascriveva il file e riavviava WordPress – da trenta a sessanta secondi di 502 ogni volta. La lista dei plugin vive nell’inventario; il ruolo installa solo ciò che manca, invece di reinstallare ogni plugin con --force a ogni esecuzione tirandosi dietro in silenzio versioni più nuove. Una sezione always ripristina i proprietari anche quando un download si interrompe a metà di un’esecuzione.

Gli aggiornamenti confrontano due istantanee di tutte le versioni, prima e dopo; WordPress si riavvia solo se qualcosa è cambiato. I plugin e i temi non usati vengono cancellati, perché anche disattivati stanno sul disco e possono essere attaccati. Il 26 ottobre 2026 è andato via così anche il plugin Limit Login Attempts: la protezione che offriva è già data dal filtro per paese davanti alla pagina di login e da una jail di fail2ban. Dal 19 ottobre ogni immagine caricata viene anche salvata come WebP, larga al massimo 1.536 pixel e sotto i 280 KB – WhatsApp ignora le immagini di anteprima più grandi e mostra invece il logo.

In sintesi: configurare un’applicazione dall’esterno significa conoscerne le stranezze – chi possiede i file, quando ricarica il codice, quale output significa “niente da fare”. Riavviare solo in caso di vera modifica è la differenza tra un’esecuzione del playbook invisibile e una che disturba.

📊 Statistiche dei visitatori e il controllo finale

Invece di uno script di tracciamento, un servizio notturno conta i visitatori dai log dell’ingress, sul server, e tiene solo i numeri – niente cookie, nessuna terza parte. Gira in una sandbox di systemd che gli permette di scrivere solo nella propria directory di dati.

Alla fine di ogni esecuzione blog_verify e il ruolo condiviso common_verify controllano circa 30 punti: firewall, fail2ban, SELinux, K3s, i pod, HTTPS e i suoi header, percorsi bloccati come xmlrpc.php, nessun nome utente tramite la REST API. Tutti i controlli girano prima e registrano solo il loro risultato, poi il report parte via mail, e solo dopo un assert può far fallire l’esecuzione. Dal 26 ottobre 2026 ne fanno parte anche test di efficacia, per esempio se un ban di fail2ban arriva davvero nel kernel.

🔄 blog-update.yml: l’aggiornamento di routine

Il playbook di aggiornamento tocca solo l’applicazione, e allo stesso modo del job notturno: lo avvia. Prima si rifiuta di girare senza --limit e su un sito che non ha già un pod in esecuzione – due problemi insieme sarebbero difficili da distinguere. Dopo controlla se Docker Hub ha ricostruito un’immagine con lo stesso tag, per esempio per una correzione di sicurezza di PHP; K3s non scarica mai da solo immagini del genere. Si riavviano solo i deployment interessati, in un ordine fisso, prima il database. Infine la home page deve rispondere con 200. Se qualcosa fallisce, la parte rescue mostra pod, eventi e l’ultimo dump del database – e si ferma. Non c’è rollback automatico: un ripristino è una decisione.

In sintesi: un tag d’immagine non dice nulla sul suo contenuto. L’aggiornamento di PHP del 21 ottobre 2026 l’ha mostrato: lo stesso tag conteneva una versione di PHP diversa prima e dopo la correzione.

🛠️ Nell’esercizio

QuandoCosa
Ogni notteAggiornamenti di plugin, temi, traduzioni e versioni minori del core dopo un dump del database – automatici
Quando deve essere adessoansible-playbook blog-update.yml --limit <host>, prima con --check
Quando cambia versions.yml--tags blog_k3s_deploy dopo una prova a secco
Dopo ogni esecuzioneLeggi la mail di verify
  • 502 Bad Gateway: nginx gira, PHP-FPM non risponde. Guarda i log del container wordpress-fpm; un riavvio con k3s kubectl rollout restart deployment/wordpress -n wordpress non causa downtime grazie al rolling update.
  • Esegui WP-CLI sempre come www-data, a meno che non installi codice e sistemi il proprietario dopo.
  • Un aggiornamento di un plugin ha rotto il sito: il job notturno ha fatto prima il dump del database (14 giorni); ripristina il dump e fissa il plugin all’ultima versione buona.
  • L’intero server è perso: preparane uno nuovo con il playbook completo, ripristina file e database dal backup esterno, esegui il playbook ancora una volta.

🎯 Le lezioni della parte 3

  • Ciò che un ruolo e un container impostano entrambi, devono impostarlo allo stesso modo.
  • La configurazione montata ha bisogno di un checksum nel template del pod, altrimenti non arriva mai.
  • Un command personalizzato sostituisce l’entrypoint – imposta l’utente nel pod, non nello script.
  • Riavvia un’applicazione solo quando qualcosa è cambiato davvero.
  • Un tag d’immagine non dice nulla sul suo contenuto; le immagini ricostruite vanno rilevate.

🧭 Dove va il tour adesso

La parte 4 è Nextcloud: gli stessi mattoni, ma con il database e Redis sull’host, una suite per ufficio e un servizio push. Se gestisci solo un blog, puoi saltare direttamente alla parte 5, i ruoli di sicurezza. La tecnologia sotto questa parte è spiegata nei deep dive su WordPress, PHP-FPM, MariaDB e Redis.

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