Przejdź do treści
REDO Interactive

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.

Ekran konfiguracji WordPress uruchomiony w środowisku Docker z Wardenem

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.

Formularz połączenia z bazą danych w instalatorze WordPress z danymi z pliku .env

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

Ekran instalatora WordPress z formularzem tytułu strony i konta administratora

Częste problemy

  • Polecenie warden nie zostało znalezione. Otwórz nowe okno terminala albo sprawdź, czy katalog /opt/warden/bin jest w zmiennej PATH.
  • Błąd uprawnień do Dockera. Użytkownik musi mieć dostęp do Dockera bez sudo. Zwykle oznacza to członkostwo w grupie docker i ponowne zalogowanie.
  • Przeglądarka nie otwiera example.test. Sprawdź wpis w pliku /etc/hosts oraz 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.

← Porady o sklepach, stronach i kodzie

Zacznij od rozmowy

Opisz sytuację albo umów 30 minut rozmowy. Odpowiadają ludzie, którzy będą projektować i wdrażać rozwiązanie.

Pomocny REDO

Pomocny REDO Asystent AI

Dziękujemy, wiadomość wysłana. Odezwiemy się najszybciej, jak to będzie możliwe.

Cookies do statystyki odwiedzin zapisujemy dopiero po zgodzie. Polityka prywatności