Warden i Docker: lokalne środowisko WordPress krok po kroku
Jak zainstalować WordPress lokalnie w Dockerze przy użyciu narzędzia CLI Warden: instalacja Dockera i Wardena, plik .env, certyfikat, plik hosts i dane bazy.
Docker
Pokażemy, jak zainstalować WordPress w Dockerze za pomocą narzędzia CLI Warden. Warden przygotowuje za nas wiele elementów środowiska projektu, więc osoba, która nie zna dobrze Dockera, może szybko uruchomić lokalną instalację WordPress.
Narzędzie działa na systemach Linux i macOS. W czasie pisania artykułu nie było wspierane na Windows. Sprawdź w dokumentacji Warden, czy aktualne wersje obsługują Windows (przez WSL2).
Wprowadzenie do Dockera znajdziesz w poprzednim artykule: Instalacja WordPress i Docker z własną lokalną domeną.
Wymagania
- System Linux lub macOS. Artykuł opisuje Linux Ubuntu 20.04.1 LTS.
- Docker i Docker Compose.
- Uprawnienia administratora (
sudo), potrzebne m.in. do zmiany pliku/etc/hosts.
Uwaga: polecenia instalacji i wymagania wersji Wardena zmieniają się z czasem. Aktualne informacje znajdziesz w dokumentacji Warden.
Instalujemy CLI Warden w systemie Linux Ubuntu
Pracujemy na Linuxie Ubuntu 20.04.1 LTS. Najpierw przygotowujemy system i instalujemy Dockera oraz Wardena.
Instalacja Dockera
Do instalacji Dockera użyjemy polecenia:
sudo snap install docker
Uwaga: pakiet snap to najprostsza opcja. Dokumentacja Dockera opisuje też instalację Docker Engine z oficjalnego repozytorium, która może być lepszym wyborem na stałe środowisko. Warden uruchamiamy bez sudo, więc nasz użytkownik musi mieć dostęp do Dockera (zwykle przez grupę docker).
Instalacja Wardena
Wardena instalujemy przez Homebrew albo klonujemy z repozytorium.
Homebrew:
brew install davidalger/warden/warden
warden svc up
Git:
sudo mkdir /opt/warden
sudo chown $(whoami) /opt/warden
git clone -b master https://github.com/davidalger/warden.git /opt/warden
echo 'export PATH="/opt/warden/bin:$PATH"' >> ~/.bashrc
PATH="/opt/warden/bin:$PATH"
warden svc up
Tworzymy projekt WordPress za pomocą Wardena i Dockera
Tworzymy folder o nazwie example i przechodzimy do niego.
mkdir example
cd example/
W folderze uruchamiamy usługi Wardena i tworzymy plik .env poleceniami:
warden svc up
warden env-init
Po env-init wpisujemy nazwę projektu example, a następnie typ projektu wordpress. Jeśli Warden nie zapyta o te wartości, podajemy je jako argumenty: warden env-init example wordpress.
Budujemy i uruchamiamy kontenery środowiska:
warden env up -d --build
Aby strona działała po HTTPS, dodajemy certyfikat:
warden sign-certificate example.test
Teraz wchodzimy do powłoki kontenera naszego projektu example.test:
warden shell
W powłoce kontenera, w katalogu głównym projektu, pobieramy najnowszą wersję WordPress, rozpakowujemy ją i usuwamy paczkę:
wget https://wordpress.org/latest.tar.gz
tar xfz latest.tar.gz
mv wordpress/* ./
rmdir ./wordpress/
rm -f latest.tar.gz
Dodajemy domenę do pliku /etc/hosts
Aby przeglądarka połączyła się z naszą stroną, dodajemy domenę do pliku hosts. Otwieramy go z uprawnieniami administratora (w nowym oknie terminala, poza kontenerem):
sudo nano /etc/hosts
W pliku dodajemy nową linię:
127.0.0.1 example.test
Teraz możemy połączyć się ze stroną: https://example.test. Jeśli przeglądarka zgłasza błąd certyfikatu, sprawdź w dokumentacji Warden, jak dodać certyfikat CA Wardena do zaufanych.
Pojawia się ekran konfiguracji WordPress.

Instalacja WordPress
Do instalacji potrzebujemy danych połączenia z bazą danych i hostem. Znajdują się w pliku .env w folderze projektu example. Przechodzimy do folderu projektu (poza kontenerem) i wyświetlamy plik:
cat .env
Plik zawiera wartości:
WARDEN_ENV_NAME=example
WARDEN_ENV_TYPE=wordpress
WARDEN_WEB_ROOT=/
TRAEFIK_DOMAIN=example.test
TRAEFIK_SUBDOMAIN=app
MARIADB_VERSION=10.4
NODE_VERSION=10
PHP_VERSION=7.4
WARDEN_DB=1
WARDEN_REDIS=0
APP_ENV=local
APP_DEBUG=true
DB_CONNECTION=mysql
DB_HOST=db
DB_PORT=3306
DB_DATABASE=wordpress
DB_USERNAME=wordpress
DB_PASSWORD=wordpress
Wersje MariaDB, Node.js i PHP zależą od wersji Wardena, więc w Twoim pliku mogą być inne.
Nazwę bazy, użytkownika i hasło mamy w wartościach DB_DATABASE, DB_USERNAME i DB_PASSWORD.
Potrzebujemy jeszcze nazwy hosta bazy danych. Odczytujemy ją poleceniem w terminalu:
docker ps
Dostajemy listę aktywnych kontenerów. Nazwa hosta jest związana z silnikiem mariadb:
78582457150a wardenenv/mariadb:10.4 "docker-entrypoint.s…" 22 minutes ago Up 22 minutes 3306/tcp example_db_1
U nas jest to example_db_1. Uwaga: w Docker Compose v2 nazwy kontenerów mają myślniki zamiast podkreślników (example-db-1), więc zawsze kopiuj nazwę z własnego wyniku docker ps. Ponieważ WordPress działa w tej samej sieci Dockera co baza, zwykle działa też nazwa usługi z DB_HOST (db).
W konfiguracji WordPressa wpisujemy odpowiednio dane naszego projektu.

Przechodzimy dalej. Podajemy tytuł strony oraz nazwę i hasło użytkownika administratora. Gotowe: mamy projekt WordPress uruchomiony w Dockerze za pomocą Wardena.

Częste problemy
- Polecenie
wardennie zostało znalezione. Otwórz nowe okno terminala albo sprawdź, czy katalog/opt/warden/binjest w zmiennejPATH. - Błąd uprawnień do Dockera. Użytkownik musi mieć dostęp do Dockera bez
sudo. Zwykle oznacza to członkostwo w grupiedockeri ponowne zalogowanie. - Przeglądarka nie otwiera
example.test. Sprawdź wpis w pliku/etc/hostsoraz to, czy kontenery działają (docker ps).
Podsumowanie
Za pomocą CLI Warden stworzyliśmy projekt WordPress w Dockerze. Przygotowanie środowiska jest szybkie. Warden pozwala też uruchomić kilka środowisk z różnymi projektami WordPress. Każde działa lokalnie pod własną domeną i nie koliduje z pozostałymi.
Zobacz też nasze inne artykuły: Przydatne artykuły.