Deep Dive: WordPress na Kubernetesie – bezstanowe pody, stanowy CMS i WP-CLI jako control plane
WordPress nigdy nie był projektowany pod kontenery: pisze do własnego katalogu, sam się aktualizuje i trzyma stan wszędzie. Jak mimo to działa tutaj w K3s, co trzeba było nagiąć, jak szybki jest z page cache i bez niego – i czego wciąż brakowałoby po odbudowie wyłącznie z Ansible.

🌐 Także w: English · Deutsch · Français · Español · Italiano · Português · Nederlands
Deep Dive z serii wokół Ansible Tour. Tour objaśnia role, a deep dive’y technologię pod spodem: jak działa, dlaczego jest tu używana właśnie tak i co po drodze poszło nie tak.
Ten blog to WordPress działający w jednowęzłowym klastrze K3s (część 3 touru pokazuje role). WordPress zakłada klasyczny serwer WWW: pisze do własnego katalogu, instaluje i aktualizuje wtyczki z panelu administracyjnego i planuje zadania, doczepiając się do żądań odwiedzających. Kubernetes zakłada coś odwrotnego – wymienialne kontenery, konfigurację z zewnątrz, żadnego stanu w obrazie. Ten wpis wyjaśnia, jak te dwa światy spotykają się tutaj.
Spis treści
🧭 Jak działa WordPress
Droga żądania
Żądanie trafia do ingress controllera (TLS, rate limity, security headers), a potem do sidecara nginx w podzie WordPressa. nginx najpierw szuka gotowego pliku HTML z page cache; jeśli taki istnieje, PHP w ogóle nie bierze udziału. W przeciwnym razie przekazuje żądanie do PHP-FPM w tym samym podzie, gdzie WordPress ładuje core, wtyczki i motyw, pyta Redisa o obiekty z cache, a MariaDB o resztę, i renderuje stronę.
Gdzie WordPress trzyma stan
- Pliki:
wp-content/– wtyczki, motywy, uploady, page cache, pliki językowe. WordPress sam tu pisze, na przykład gdy aktualizuje wtyczkę. - Baza danych: wpisy, strony, użytkownicy i tabela
wp_options, w której WordPress i każda wtyczka trzymają ustawienia – oraz transienty, krótko żyjące wartości z cache. wp-config.php: połączenie z bazą i klucze. W oficjalnym obrazie entrypoint generuje go ze zmiennych środowiskowych.
Model rozszerzeń
Wszystko w WordPressie to hook: akcje („teraz dzieje się X”) i filtry („ta wartość przechodzi tędy, zmień ją, jeśli chcesz”). Wtyczki i motywy rejestrują funkcje na hookach. Must-use plugins w wp-content/mu-plugins/ ładują się automatycznie, przed zwykłymi wtyczkami, i nie da się ich wyłączyć z panelu – to właściwe miejsce na reguły, które muszą obowiązywać zawsze.
WP-Cron
WordPress nie ma demona. Domyślnie przy wyświetleniach stron sprawdza, czy zaplanowane zadania są już do wykonania, i jeśli tak, wysyła żądanie do wp-cron.php. Na cichej stronie zadania wykonują się z opóźnieniem; na ruchliwej sprawdzanie kosztuje czas przy wielu żądaniach.
🛡️ Dlaczego jest tutaj
- Prawdziwy edytor i ekosystem wtyczek. SEO, kompresja obrazów, logowanie dwuskładnikowe, spis treści – każde to jedna wtyczka.
- Cztery języki. Polylang zarządza angielską, niemiecką, francuską i hiszpańską wersją każdego wpisu z powiązanymi tłumaczeniami.
- Open source i przenośność. Zrzut bazy plus
wp-contentto cała strona; można ją przenieść na dowolny host.
🔧 Co robi to repozytorium
Pody i wolumeny
| Pod | Kontenery | Stan |
|---|---|---|
| wordpress | nginx, PHP-FPM, php-fpm_exporter | /var/www/html z hostPath (/srv/wordpress-www) |
| mariadb | MariaDB, mysqld_exporter | hostPath /srv/wordpress-db |
| redis | Redis | brak (tylko pamięć) |
| CronJoby | wordpress-cron co 5 min, wordpress-autoupdate o 03:30 | ten sam wolumen, na krótko |
Obrazy są bezstanowe; stan mieszka w dwóch katalogach hosta z własnymi etykietami SELinux, więc kontener może pisać tam i nigdzie indziej. Kontener PHP-FPM ma główny system plików tylko do odczytu i tylko pięć capabilities – te, których entrypoint obrazu naprawdę potrzebuje, by przy pierwszym starcie rozpakować WordPressa do wolumenu i zejść z roota na www-data; każdą przetestowano, usuwając ją. WP-CLI pobiera init container do wolumenu poza katalogiem web root: nginx odmawia jedynie serwowania plików .php, a .phar w document root byłby dla każdego plikiem do pobrania o rozmiarze 7 MB.
Od 26 października 2026 nowy pod WordPressa startuje, zanim stary się zatrzyma (rolling update zamiast Recreate). Dwa pody na tym samym katalogu hosta nie są tu problemem: oficjalny obraz kopiuje WordPressa tylko do pustego /var/www/html, więc nowy pod nigdy nie nadpisze plików, które serwuje stary. Zmiana konfiguracji czy przebudowany obraz nie wyłączają już bloga.
WP-CLI jako control plane
Ansible nie klika po panelu administracyjnym. Każda zmiana idzie przez WP-CLI wewnątrz działającego kontenera.
Rola blog_wordpress używa go do instalacji, listy wtyczek, ustawień, menu i pięciu must-use plugins. Każdy task najpierw czyta i zmienia tylko to, co się różni – task wtyczek na przykład instaluje tylko brakujące wtyczki i aktywuje tylko nieaktywne; wcześniejsza wersja przy każdym uruchomieniu instalowała wszystkie wtyczki od nowa i raportowała je wszystkie jako „changed”. Lekcja z eksploatacji: WP-CLI należy do www-data. Cache flush uruchomiony jako root z --allow-root zostawił kiedyś katalog cache należący do roota, do którego WordPress nie mógł już pisać. Instalacja wtyczek z powodów historycznych nadal działa jako root, a po niej następuje chown -R w bloku always:, więc własność jest przywracana nawet wtedy, gdy instalacja się nie powiedzie.
Wniosek: Kto zmienia treść lub ustawienia skryptem, najpierw czyta i pisze wyłącznie przez funkcje WordPressa. Pisanie bezpośrednio do bazy danych usunęło tu kiedyś backslashe z przykładów kodu.
Pięć must-use plugins
| mu-plugin | Co robi |
|---|---|
| security-hardening | Ukrywa ciągi z wersją, wyłącza edytor plików w panelu (inaczej sesja admina oznaczałaby wykonanie kodu), zamyka enumerację użytkowników przez REST API. |
| upload-images | Konwertuje każdy wgrany obraz do WebP, maksymalnie 1536 px i poniżej 280 KB – limitu, powyżej którego komunikatory pomijają obrazek podglądu. |
| performance-hints | Robi preload fontu, ładuje największy obraz strony od razu (eager). |
| language-links | „Dostępne również w …” pod każdym wpisem, z linków tłumaczeń Polylanga. |
| ai-disclosure | Dyskretna informacja w stopce i strona o wykorzystaniu AI. |
Cache w trzech warstwach
- Page cache (WP Super Cache): gotowe pliki HTML na dysku; nginx serwuje je bezpośrednio, ze sprawdzeniem ciasteczek, żeby zalogowani użytkownicy i komentujący zawsze dostawali świeże strony.
- Object cache (Redis): wyniki zapytań do bazy wewnątrz PHP.
- OPcache: skompilowany kod PHP, ze sprawdzaniem znaczników czasu co 60 s – bo wtyczki aktualizują się w miejscu nocą.
Bezpieczeństwo na brzegu
xmlrpc.php,install.php, pozostałości po backupach i edytorach (.bak,.sql,~,.phar) oraz enumeracja przez?author=odpowiadają 403.- Rate limity w ingressie, na IP klienta: logowanie 5 żądań na sekundę z burstem 5, wyszukiwanie 2 na sekundę z burstem 10; powyżej 429.
- Logowanie i
/wp-admin/tylko z niemieckich sieci, z tą samą listą IP, która chroni SSH (filtr geograficzny);admin-ajax.phpzostaje otwarty, bo potrzebuje go front end. Do tego logowanie dwuskładnikowe dla adminów; powtarzające się nieudane logowania banuje fail2ban (wtyczkę Limit Login Attempts usunięto 26 października 2026 – filtr geograficzny i fail2ban już wykonywały jej pracę). - Content Security Policy w trybie report-only – część 5 wyjaśnia, dlaczego jeszcze nie w trybie wymuszania.
Cron i aktualizacje bez odwiedzających
DISABLE_WP_CRON wyłącza crona wyzwalanego przez odwiedzających; zamiast tego CronJob Kubernetesa co pięć minut uruchamia php wp-cron.php, we własnym kontenerze z tym samym wolumenem (concurrencyPolicy: Forbid, żeby wolny przebieg nigdy nie nałożył się na następny). Drugi CronJob o 03:30 aktualizuje core (tylko wersje minor), wtyczki, motywy i paczki językowe, uruchamia migracje bazy, czyści cache i sprawdza, czy strona główna nadal odpowiada. Duże aktualizacje i zmiany obrazów idą świadomie przez blog-update.yml.
📊 Zmierzone
| Wartość | |
|---|---|
| WordPress | 7.1, PHP 8.5 (8.4 do 26 października 2026), motyw MoreNews |
| Opublikowane wpisy (wszystkie cztery języki) | 488 |
| Strony | 16 |
| Baza danych | 49 MB |
| Uploady | 83 MB w 1253 plikach (po migracji do WebP) |
| Wtyczki | 9 zwykłych, 5 must-use, 2 drop-iny (page cache, object cache) |
| Zaplanowane zdarzenia cron | 33 |
| Czas serwera do pierwszego bajtu, strona z cache | ~46 ms |
| Czas serwera do pierwszego bajtu, renderowana przez PHP | ~140 ms |
| Żądania PHP dziennie | ~21 700 |
Czasy zmierzono z zewnątrz, bez handshake’u TLS, więc nadal zawierają jeden round trip sieciowy. Page cache oszczędza około 90 ms na żądanie – i, co ważniejsze, oszczędza workery PHP: strona z cache kosztuje nginx jeden odczyt pliku, nic więcej.
🔍 Czego zabrakłoby po odbudowie wyłącznie z Ansible
Sens Ansible polega na tym, że serwer da się odbudować z repozytorium. W przypadku WordPressa dotyczy to platformy, a strony tylko częściowo:
- Treść i ustawienia – wpisy, konfiguracja języków w Polylangu, ustawienia wtyczek, konfiguracja motywu – mieszkają w bazie danych. Pochodzą z nocnego backupu, nie z repozytorium. Tak ma być.
- Jednej wtyczki nie ma w Ansible. Easy Table of Contents została zainstalowana przez panel administracyjny i tak jest udokumentowana; świeża instalacja z playbooka by jej nie miała, przywrócenie z backupu – tak. Tak czy inaczej musi to być świadoma decyzja, dlatego przewodnik operacyjny ją wymienia.
- All-in-One WP Migration usunięto w październiku 2026: jej archiwa
.wpressw web root chronił tylko plik.htaccess, którego nginx nie czyta. nginx i tak je blokował; wtyczka poleciała, bo nocny backup iblog.ymljuż wykonują jej pracę.
Wniosek: „Do odbudowania z repozytorium” to prawda dla platformy. Treść i ustawienia strony zabezpiecza tylko backup.
- Dwa cache, dwa polecenia.
wp cache flushopróżnia Redisa; page cache potrzebujewp_cache_clear_cache(). Po edycji wpisu poza edytorem – oba. - Backupy. Maszyna backupowa co noc pobiera zrzut bazy i katalog
wp-content; przywracanie to zrzut do bazy i pliki do/srv/wordpress-www. - Rollback aktualizacji. Obrazy są przypięte w
versions.yml: cofnij pin i uruchom playbook. Wtyczka:wp plugin install <slug> --version=<old> --force. - Programowa edycja treści. Zapisuj treść wpisów tylko przez funkcje WordPressa, które poprawnie escapują – bezpośredni update usunął kiedyś backslashe z przykładów kodu w kilkunastu wpisach.
# 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)
🆘 Ściągawka: objaw → polecenie
Krótka wersja tego artykułu na chwilę, gdy coś jest nie tak. Uruchamiaj na hoście jako root; <…> to placeholdery. occ i wp to funkcje powłoki z deep dive’ów o Nextcloud i WordPressie.
| Objaw | Polecenie |
|---|---|
| Strona pokazuje starą treść | wp eval 'wp_cache_clear_cache();' # page cachewp cache flush # object cache (Redis) |
| Biała strona lub błąd 500 | k3s kubectl -n wordpress logs deploy/wordpress -c wordpress-fpm --tail=50 |
| Wtyczka zepsuła stronę | wp plugin deactivate <slug>wp plugin install <slug> --version=<old> --force |
| Jakie wersje są zainstalowane, co czeka? | wp core versionwp plugin list --update=available |
| Zaplanowane zadania się nie wykonują | wp cron event list --fields=hook,next_run_relativewp cron event run --due-now |
| Czy dzisiejsza nocna aktualizacja się udała? | k3s kubectl -n wordpress get jobs | grep autoupdatek3s kubectl -n wordpress logs job/<job> |
| Przed każdą zmianą treści lub wtyczek | wp db export - | gzip > before-change.sql.gz |
| Pliki nagle należą do roota | # wp-cli only as www-data (the function above), never --allow-root |
🎯 Wnioski
- Stan mieszka w dwóch katalogach i jednej bazie danych; cała reszta jest wymienialna.
- Każda zmiana przez WP-CLI i funkcje WordPressa: najpierw czytaj, potem pisz.
- Dwa cache, dwa polecenia: object cache i page cache czyści się osobno.
- To, co zainstalowano przez panel administracyjny, jest dla Ansible nieznane.
- Wymiana poda bez przestoju wymaga obrazu, który nie nadpisuje istniejących plików.
⚖️ Alternatywy – i dlaczego WordPress
| Opcja | Mocna strona | Dlaczego nie tutaj |
|---|---|---|
| Hugo / strona statyczna | Najszybsza i najbezpieczniejsza: bez PHP, bez bazy danych | Brak edytora WWW, brak komentarzy, tłumaczenia ręcznie. |
| Ghost | Nowoczesny, szybki, dobry edytor | Node.js, dużo mniej wtyczek, wielojęzyczność tylko z obejściami. |
| Headless WordPress | WordPress jako edytor, statyczny lub JS-owy front end | Dwa systemy zamiast jednego dla bloga jednego autora. |
| WordPress | Edytor, wtyczki, Polylang, a autor go zna | Wybrany. |
Uruchamianie WordPressa w Kubernetesie to mniej kwestia Kubernetesa, a bardziej uczciwości co do tego, gdzie jest stan. Tutaj jest w dwóch katalogach i jednej bazie danych, wszystkie trzy objęte backupem, cała reszta wymienialna – a control plane to nie panel administracyjny, tylko WP-CLI, wywoływane przez Ansible, jako właściwy użytkownik.
