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.

🌐 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-contentis de hele site; die kan naar elke host verhuizen.
🔧 Wat deze repository doet
Pods en volumes
| Pod | Containers | State |
|---|---|---|
| wordpress | nginx, PHP-FPM, php-fpm_exporter | /var/www/html uit een hostPath (/srv/wordpress-www) |
| mariadb | MariaDB, mysqld_exporter | hostPath /srv/wordpress-db |
| redis | Redis | geen (alleen geheugen) |
| CronJobs | wordpress-cron elke 5 min, wordpress-autoupdate om 03:30 | hetzelfde 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-plugin | Doet |
|---|---|
| security-hardening | Verbergt versiestrings, schakelt de bestandseditor in de admin uit (anders zou een adminsessie code-uitvoering zijn), sluit gebruikersenumeratie via de REST API af. |
| upload-images | Zet elke geüploade afbeelding om naar WebP, maximaal 1.536 px en onder 280 KB – de grens waarboven messengers de previewafbeelding laten vallen. |
| performance-hints | Preloadt het lettertype, laadt de grootste afbeelding van een pagina eager. |
| language-links | “Ook beschikbaar in …” onder elke post, uit de vertaallinks van Polylang. |
| ai-disclosure | Een 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.phpblijft 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 | |
|---|---|
| WordPress | 7.1, PHP 8.5 (8.4 tot 26 oktober 2026), theme MoreNews |
| Gepubliceerde posts (alle vier talen) | 488 |
| Pagina’s | 16 |
| Database | 49 MB |
| Uploads | 83 MB in 1.253 bestanden (na de WebP-migratie) |
| Plugins | 9 gewone, 5 must-use, 2 drop-ins (page cache, object cache) |
| Geplande cron-events | 33 |
| 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 enblog.ymlzijn 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 flushleegt Redis; de page cache heeftwp_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-contentop; 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.
| Symptoom | Commando |
|---|---|
| De pagina toont oude inhoud | wp eval 'wp_cache_clear_cache();' # page cachewp cache flush # object cache (Redis) |
| Witte pagina of fout 500 | k3s kubectl -n wordpress logs deploy/wordpress -c wordpress-fpm --tail=50 |
| Een plugin heeft de site gesloopt | wp plugin deactivate <slug>wp plugin install <slug> --version=<old> --force |
| Welke versies zijn geïnstalleerd, wat staat er open? | wp core versionwp plugin list --update=available |
| Geplande taken lopen niet | wp cron event list --fields=hook,next_run_relativewp cron event run --due-now |
| Is de update van vannacht gelukt? | k3s kubectl -n wordpress get jobs | grep autoupdatek3s kubectl -n wordpress logs job/<job> |
| Vóór elke wijziging aan inhoud of plugins | wp 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
| Optie | Sterk punt | Waarom niet hier |
|---|---|---|
| Hugo / statische site | Snelst en veiligst: geen PHP, geen database | Geen webeditor, geen reacties, vertaalworkflow met de hand. |
| Ghost | Modern, snel, goede editor | Node.js, veel minder plugins, meertalig alleen met omwegen. |
| Headless WordPress | WordPress als editor, een statische of JS-front end | Twee systemen in plaats van één voor een blog met één auteur. |
| WordPress | Editor, plugins, Polylang, en de auteur kent het | Gekozen. |
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.
