Deep Dive: WordPress op Kubernetes – stateless pods, een stateful CMS en WP-CLI als control plane

WordPress is nooit voor containers gebouwd: het schrijft in zijn eigen map, werkt zichzelf bij en houdt overal state vast. Hoe het hier toch in K3s draait, wat er moest worden omgebogen, hoe snel het is met en zonder page cache – en wat een rebuild puur uit Ansible nog zou missen.

Illustratie bij de Deep Dive-serie

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

Deep Dive in de serie rond de Ansible Tour. De tour legt de roles uit, de deep dives de techniek eronder: hoe het werkt, waarom het hier zo wordt gebruikt en wat er onderweg misging.

Deze blog is WordPress, draaiend in een K3s-cluster met één node (deel 3 van de tour laat de roles zien). WordPress gaat uit van een klassieke webserver: het schrijft in zijn eigen map, installeert en updatet plugins vanuit de adminpagina en plant werk door mee te liften op verzoeken van bezoekers. Kubernetes gaat uit van het tegendeel – vervangbare containers, configuratie van buitenaf, geen state in het image. Deze post legt uit hoe die twee elkaar hier ontmoeten.

Inhoud

🧭 Hoe WordPress werkt

Het pad van een request

Een request bereikt de ingress controller (TLS, rate limits, security headers) en daarna de nginx-sidecar in de WordPress-pod. nginx zoekt eerst naar een vooraf gerenderd HTML-bestand uit de page cache; als dat er is, komt PHP er niet eens aan te pas. Anders geeft het de request door aan PHP-FPM in dezelfde pod, waar WordPress zijn core, de plugins en het theme laadt, Redis om gecachete objecten vraagt en MariaDB om de rest, en de pagina rendert.

Waar WordPress state bewaart

  • Bestanden: wp-content/ – plugins, themes, uploads, de page cache, taalbestanden. WordPress schrijft hier zelf, bijvoorbeeld wanneer het een plugin bijwerkt.
  • Database: posts, pagina’s, gebruikers en de tabel wp_options, waarin WordPress en elke plugin instellingen bewaren – en transients, kortlevende gecachete waarden.
  • wp-config.php: databaseverbinding en sleutels. In het officiële image genereert het entrypoint dit bestand uit omgevingsvariabelen.

Uitbreidingsmodel

Alles in WordPress is een hook: actions (“nu gebeurt X”) en filters (“deze waarde komt hier langs, pas haar aan als je wilt”). Plugins en themes registreren functies op hooks. Must-use plugins in wp-content/mu-plugins/ laden automatisch, vóór de normale plugins, en kunnen niet vanuit de adminpagina worden uitgezet – de juiste plek voor regels die altijd moeten gelden.

WP-Cron

WordPress heeft geen daemon. Standaard controleert het bij paginaweergaven of geplande taken aan de beurt zijn en vuurt dan een request af naar wp-cron.php. Op een rustige site lopen taken te laat; op een drukke kost de controle tijd bij veel requests.

🛡️ Waarom het hier draait

  • Een echte editor en een plugin-ecosysteem. SEO, beeldcompressie, tweefactorlogin, een inhoudsopgave – elk zit één plugin verderop.
  • Vier talen. Polylang beheert Engelse, Duitse, Franse en Spaanse versies van elke post met gekoppelde vertalingen.
  • Open source en draagbaar. Databasedump plus wp-content is de hele site; die kan naar elke host verhuizen.

🔧 Wat deze repository doet

Pods en volumes

PodContainersState
wordpressnginx, PHP-FPM, php-fpm_exporter/var/www/html uit een hostPath (/srv/wordpress-www)
mariadbMariaDB, mysqld_exporterhostPath /srv/wordpress-db
redisRedisgeen (alleen geheugen)
CronJobswordpress-cron elke 5 min, wordpress-autoupdate om 03:30hetzelfde volume, kort

De images zijn stateless; de state woont in twee hostmappen met eigen SELinux-labels, zodat de container daar mag schrijven en nergens anders. De PHP-FPM-container heeft een read-only root-bestandssysteem en maar vijf capabilities – precies die het entrypoint van het image echt nodig heeft om WordPress bij de eerste start in het volume uit te pakken en van root naar www-data te wisselen; elke capability is getest door haar weg te halen. WP-CLI wordt door een init container gedownload naar een volume buiten de webroot: nginx weigert alleen .php-bestanden te serveren, en een .phar in de document root was voor iedereen een download van 7 MB geweest.

Sinds 26 oktober 2026 start een nieuwe WordPress-pod voordat de oude stopt (rolling update in plaats van Recreate). Twee pods op dezelfde hostmap zijn hier geen probleem: het officiële image kopieert WordPress alleen naar een lege /var/www/html, dus een nieuwe pod overschrijft nooit de bestanden die de oude serveert. Een configuratiewijziging of een opnieuw gebouwd image haalt de blog niet meer offline.

WP-CLI als control plane

Ansible klikt niet door de adminpagina. Elke wijziging gaat via WP-CLI in de draaiende container.

De role blog_wordpress gebruikt het voor de installatie, de pluginlijst, instellingen, het menu en de vijf must-use plugins. Elke task leest eerst en wijzigt alleen wat afwijkt – de plugin-task bijvoorbeeld installeert alleen ontbrekende plugins en activeert alleen inactieve; een eerdere versie installeerde bij elke run alle plugins opnieuw en meldde ze allemaal als “changed”. Een les uit de praktijk: WP-CLI hoort bij www-data. Een cache flush die als root met --allow-root was gestart, liet ooit een cachemap achter die van root was en waarin WordPress niet meer kon schrijven. De plugininstallatie draait om historische redenen nog als root en wordt gevolgd door een chown -R in een always:-blok, zodat de eigendom ook wordt hersteld als een installatie mislukt.

De les: Wie inhoud of instellingen per script wijzigt, leest eerst en schrijft alleen via WordPress-functies. Rechtstreeks in de database schrijven heeft hier ooit de backslashes uit codevoorbeelden gehaald.

Vijf must-use plugins

mu-pluginDoet
security-hardeningVerbergt versiestrings, schakelt de bestandseditor in de admin uit (anders zou een adminsessie code-uitvoering zijn), sluit gebruikersenumeratie via de REST API af.
upload-imagesZet elke geüploade afbeelding om naar WebP, maximaal 1.536 px en onder 280 KB – de grens waarboven messengers de previewafbeelding laten vallen.
performance-hintsPreloadt het lettertype, laadt de grootste afbeelding van een pagina eager.
language-links“Ook beschikbaar in …” onder elke post, uit de vertaallinks van Polylang.
ai-disclosureEen discrete melding in de footer en de pagina over AI-gebruik.

Caching in drie lagen

  • Page cache (WP Super Cache): kant-en-klare HTML-bestanden op schijf; nginx serveert ze direct, met een cookiecheck zodat ingelogde gebruikers en reageerders altijd verse pagina’s krijgen.
  • Object cache (Redis): resultaten van databasequery’s binnen PHP.
  • OPcache: gecompileerde PHP-code, met timestampcontrole elke 60 s – omdat plugins ’s nachts ter plekke worden bijgewerkt.

Beveiliging aan de rand

  • xmlrpc.php, install.php, restanten van backups en editors (.bak, .sql, ~, .phar) en enumeratie via ?author= antwoorden met 403.
  • Rate limits in de ingress, per client-IP: login 5 requests per seconde met een burst van 5, zoeken 2 per seconde met een burst van 10; daarboven 429.
  • Login en /wp-admin/ alleen vanuit Duitse netwerken, met dezelfde IP-lijst die SSH bewaakt (het geofilter); admin-ajax.php blijft open omdat de front end het nodig heeft. Daarbij tweefactorlogin voor admins; herhaalde mislukte logins worden door fail2ban geband (de plugin Limit Login Attempts is op 26 oktober 2026 geschrapt – het geofilter en fail2ban deden zijn werk al).
  • Een Content Security Policy in report-only-modus – deel 5 legt uit waarom nog niet afdwingend.

Cron en updates zonder bezoekers

DISABLE_WP_CRON zet de door bezoekers getriggerde cron uit; in plaats daarvan draait een Kubernetes-CronJob elke vijf minuten php wp-cron.php, in een eigen container met hetzelfde volume (concurrencyPolicy: Forbid, zodat een trage run nooit door de volgende wordt ingehaald). Een tweede CronJob om 03:30 werkt core (alleen minor versies), plugins, themes en taalpakketten bij, draait databasemigraties, leegt de cache en controleert of de homepage nog antwoordt. Grote updates en imagewijzigingen gaan bewust via blog-update.yml.

📊 Gemeten

Waarde
WordPress7.1, PHP 8.5 (8.4 tot 26 oktober 2026), theme MoreNews
Gepubliceerde posts (alle vier talen)488
Pagina’s16
Database49 MB
Uploads83 MB in 1.253 bestanden (na de WebP-migratie)
Plugins9 gewone, 5 must-use, 2 drop-ins (page cache, object cache)
Geplande cron-events33
Servertijd tot de eerste byte, gecachete pagina~46 ms
Servertijd tot de eerste byte, door PHP gerenderd~140 ms
PHP-requests per dag~21.700

De tijden zijn van buitenaf gemeten, min de TLS-handshake, dus ze bevatten nog één netwerk-round-trip. De page cache scheelt zo’n 90 ms per request – en, belangrijker, PHP-workers: een gecachete pagina kost nginx één bestandsread, verder niets.

🔍 Wat een rebuild puur uit Ansible zou missen

Het punt van Ansible is dat de server uit de repository kan worden herbouwd. Voor WordPress geldt dat voor het platform en maar gedeeltelijk voor de site:

  • Inhoud en instellingen – posts, de taalinstellingen van Polylang, plugininstellingen, de themeconfiguratie – wonen in de database. Die komen uit de nachtelijke backup, niet uit de repository. Dat is zo bedoeld.
  • Eén plugin zit niet in Ansible. Easy Table of Contents is via de adminpagina geïnstalleerd en staat ook zo gedocumenteerd; een verse installatie uit het playbook zou hem niet hebben, een restore uit de backup wel. Hoe dan ook moet het een bewuste beslissing zijn, en daarom noemt de operations guide hem.
  • All-in-One WP Migration is in oktober 2026 verwijderd: zijn .wpress-archieven in de webroot waren alleen beschermd door een .htaccess-bestand, en dat leest nginx niet. nginx blokkeerde ze toch al; de plugin ging eruit omdat de nachtelijke backup en blog.yml zijn werk al doen.

De les: “Herbouwbaar uit de repository” klopt voor het platform. De inhoud en instellingen van de site worden alleen door de backup bewaard.

  • Twee caches, twee commando’s. wp cache flush leegt Redis; de page cache heeft wp_cache_clear_cache() nodig. Na het bewerken van een post buiten de editor: allebei.
  • Backups. Een backupmachine haalt elke nacht een databasedump en de map wp-content op; terugzetten is de dump in de database en de bestanden in /srv/wordpress-www.
  • Rollback van een update. Images zijn vastgepind in versions.yml: draai de pin terug en run het playbook. Een plugin: wp plugin install <slug> --version=<old> --force.
  • Inhoud programmatisch bewerken. Schrijf postinhoud alleen via WordPress-functies die correct slashen – een directe update heeft ooit de backslashes uit codevoorbeelden in een dozijn posts gestript.
# 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)

🆘 Spiekbriefje: symptoom → commando

De korte versie van dit artikel voor het moment dat er iets mis is. Uitvoeren op de host als root; <…> zijn placeholders. occ en wp zijn de shellfuncties uit de deep dives over Nextcloud en WordPress.

SymptoomCommando
De pagina toont oude inhoudwp eval 'wp_cache_clear_cache();' # page cache
wp cache flush # object cache (Redis)
Witte pagina of fout 500k3s kubectl -n wordpress logs deploy/wordpress -c wordpress-fpm --tail=50
Een plugin heeft de site geslooptwp plugin deactivate <slug>
wp plugin install <slug> --version=<old> --force
Welke versies zijn geïnstalleerd, wat staat er open?wp core version
wp plugin list --update=available
Geplande taken lopen nietwp cron event list --fields=hook,next_run_relative
wp cron event run --due-now
Is de update van vannacht gelukt?k3s kubectl -n wordpress get jobs | grep autoupdate
k3s kubectl -n wordpress logs job/<job>
Vóór elke wijziging aan inhoud of pluginswp db export - | gzip > before-change.sql.gz
Bestanden ineens van root# wp-cli only as www-data (the function above), never --allow-root

🎯 De lessen

  • De state woont in twee mappen en één database; al het andere is vervangbaar.
  • Elke wijziging via WP-CLI en WordPress-functies: eerst lezen, dan schrijven.
  • Twee caches, twee commando’s: object cache en page cache worden apart geleegd.
  • Wat via de adminpagina is geïnstalleerd, kent Ansible niet.
  • Een podwissel zonder downtime vraagt om een image dat bestaande bestanden niet overschrijft.

⚖️ Alternatieven – en waarom WordPress

OptieSterk puntWaarom niet hier
Hugo / statische siteSnelst en veiligst: geen PHP, geen databaseGeen webeditor, geen reacties, vertaalworkflow met de hand.
GhostModern, snel, goede editorNode.js, veel minder plugins, meertalig alleen met omwegen.
Headless WordPressWordPress als editor, een statische of JS-front endTwee systemen in plaats van één voor een blog met één auteur.
WordPressEditor, plugins, Polylang, en de auteur kent hetGekozen.

WordPress in Kubernetes draaien gaat minder over Kubernetes dan over eerlijk zijn over waar de state zit. Hier zit die in twee mappen en één database, alle drie geback-upt, al het andere vervangbaar – en de control plane is niet de adminpagina maar WP-CLI, aangeroepen door Ansible, als de juiste gebruiker.

Sommige teksten en afbeeldingen op deze site zijn met hulp van AI gemaakt of door AI gegenereerd. Details