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.

Ilustracja do serii Deep Dive

🌐 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-content to cała strona; można ją przenieść na dowolny host.

🔧 Co robi to repozytorium

Pody i wolumeny

PodKonteneryStan
wordpressnginx, PHP-FPM, php-fpm_exporter/var/www/html z hostPath (/srv/wordpress-www)
mariadbMariaDB, mysqld_exporterhostPath /srv/wordpress-db
redisRedisbrak (tylko pamięć)
CronJobywordpress-cron co 5 min, wordpress-autoupdate o 03:30ten 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-pluginCo robi
security-hardeningUkrywa 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-imagesKonwertuje 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-hintsRobi 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-disclosureDyskretna 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.php zostaje 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ść
WordPress7.1, PHP 8.5 (8.4 do 26 października 2026), motyw MoreNews
Opublikowane wpisy (wszystkie cztery języki)488
Strony16
Baza danych49 MB
Uploady83 MB w 1253 plikach (po migracji do WebP)
Wtyczki9 zwykłych, 5 must-use, 2 drop-iny (page cache, object cache)
Zaplanowane zdarzenia cron33
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 .wpress w web root chronił tylko plik .htaccess, którego nginx nie czyta. nginx i tak je blokował; wtyczka poleciała, bo nocny backup i blog.yml już 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 flush opróżnia Redisa; page cache potrzebuje wp_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.

ObjawPolecenie
Strona pokazuje starą treśćwp eval 'wp_cache_clear_cache();' # page cache
wp cache flush # object cache (Redis)
Biała strona lub błąd 500k3s 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 version
wp plugin list --update=available
Zaplanowane zadania się nie wykonująwp cron event list --fields=hook,next_run_relative
wp cron event run --due-now
Czy dzisiejsza nocna aktualizacja się udała?k3s kubectl -n wordpress get jobs | grep autoupdate
k3s kubectl -n wordpress logs job/<job>
Przed każdą zmianą treści lub wtyczekwp 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

OpcjaMocna stronaDlaczego nie tutaj
Hugo / strona statycznaNajszybsza i najbezpieczniejsza: bez PHP, bez bazy danychBrak edytora WWW, brak komentarzy, tłumaczenia ręcznie.
GhostNowoczesny, szybki, dobry edytorNode.js, dużo mniej wtyczek, wielojęzyczność tylko z obejściami.
Headless WordPressWordPress jako edytor, statyczny lub JS-owy front endDwa systemy zamiast jednego dla bloga jednego autora.
WordPressEdytor, wtyczki, Polylang, a autor go znaWybrany.

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.

Część tekstów i obrazów na tej stronie powstała z pomocą AI lub została wygenerowana przez AI. Szczegóły