Drupal i Docker – wprowadzenie dla początkujących

Drupal i Docker to zestaw, który potrafi radykalnie uprościć pracę nad projektami webowymi – od pierwszej instalacji, przez lokalne środowisko developerskie, aż po bardziej zaawansowane scenariusze testowe. Zamiast ręcznie konfigurować serwer, PHP i bazę danych, możesz zamknąć całe środowisko w lekkich kontenerach, które uruchomisz jednym poleceniem. Taki sposób pracy ułatwia współpracę w zespole, przyspiesza wdrożenia i ogranicza liczbę niespodzianek na serwerach produkcyjnych.

Dlaczego łączyć Drupal z Dockerem

Typowe problemy bez konteneryzacji

Klasyczne środowisko Drupal opiera się na instalacji serwera Apache lub Nginx, odpowiedniej wersji PHP oraz bazy danych MariaDB/MySQL. Każdy z tych elementów musi być poprawnie zainstalowany i skonfigurowany, czasem dodatkowo wzbogacony o rozszerzenia PHP czy narzędzia wiersza poleceń. Różnice w wersjach na komputerach członków zespołu prowadzą do trudnych do odtworzenia błędów – u kogoś moduł działa, u kogoś innego ten sam kod zgłasza problem.

Dochodzi do tego kwestia testowania nowych wersji Drupala czy PHP. Bez konteneryzacji często wymaga to tworzenia osobnych maszyn wirtualnych albo ryzykownej zmiany konfiguracji lokalnego systemu. W efekcie wiele osób zwleka z aktualizacjami, co obniża poziom bezpieczeństwa i utrudnia korzystanie z nowych funkcji.

Korzyści z użycia Dockera przy Drupal

Docker pozwala zdefiniować kompletne środowisko uruchomieniowe jako zestaw **obrazów** i **kontenerów**, opisanych w prostych plikach tekstowych. Zamiast konfigurować serwer ręcznie, zapisujesz jego konfigurację w pliku, który możesz przekazać innym członkom zespołu lub zintegrować z systemem kontroli wersji. Każdy uruchamia ten sam stack: tę samą wersję PHP, te same rozszerzenia, tę samą bazę danych i konfigurację serwera www.

Taki sposób pracy znacząco ułatwia odtwarzanie błędów – wystarczy uruchomić kontenery, załadować tę samą kopię bazy danych i masz niemal identyczne środowisko jak produkcyjne. Docker dobrze współgra też z praktykami DevOps, takimi jak **CI/CD**, gdzie budowanie i testowanie aplikacji odbywa się w zautomatyzowanych pipeline’ach opartych o kontenery.

Różnice między Dockerem a maszynami wirtualnymi

Wiele osób porównuje Docker do maszyn wirtualnych, takich jak VirtualBox czy VMware. Choć idea izolacji jest podobna, kontenery są znacznie lżejsze. Zamiast uruchamiać pełny system operacyjny, współdzielą one jądro systemu gospodarza, a aplikacje działają w odizolowanych środowiskach. Dzięki temu uruchomienie kontenera z Drupalem trwa zwykle sekundy, a nie minuty.

Kontenery uruchamiają się szybciej, zajmują mniej zasobów i łatwiej nimi zarządzać w dużej skali. W kontekście Drupala oznacza to możliwość równoległego testowania różnych wersji projektu bez obawy o przeciążenie komputera. To szczególnie przydatne podczas migracji między wersjami Drupala czy przy porównywaniu konfiguracji.

Kiedy Docker naprawdę się opłaca

Docker najwięcej korzyści przynosi w zespołach i projektach, w których występuje wiele środowisk: lokalne, testowe, staging, produkcja. Jeśli pracujesz samodzielnie nad małą stroną, początkowa konfiguracja Dockera może wydawać się dodatkową pracą, jednak nawet w takim scenariuszu kontenery pomagają utrzymać porządek i zapewnić przewidywalność.

Im bardziej złożony projekt, im więcej zewnętrznych usług (np. Redis, **Solr**, dodatkowe bazy), tym bardziej Docker staje się naturalnym wyborem. Możesz w jednym pliku opisać komplet usług potrzebnych Drupalowi, a następnie łatwo ten zestaw powielać, skalować i modyfikować bez dotykania systemu operacyjnego.

Podstawy Dockera dla użytkownika Drupala

Kluczowe pojęcia: obraz, kontener, wolumen

Obraz Dockera to szablon, z którego tworzone są kontenery. Dla Drupala zwykle używa się obrazu zawierającego Apache + PHP, a osobnego dla bazy danych. Obrazy są niezmienne – raz zbudowane, mogą być wielokrotnie wykorzystywane. W repozytoriach, takich jak Docker Hub, znajdziesz gotowe obrazy drupal, php, mariadb czy mysql, co znacząco skraca czas startu projektu.

Kontener to działająca instancja obrazu. Wyobraź sobie obraz drupal:10-apache jako plik instalacyjny, a kontener jako uruchomioną aplikację. Możesz mieć wiele kontenerów pochodzących z jednego obrazu, każdy z własną konfiguracją czy danymi. W praktyce dla Drupala uruchomisz co najmniej dwa kontenery: serwer www/PHP oraz bazę danych.

Wolumen (volume) to sposób na trwałe przechowywanie danych poza cyklem życia kontenera. Baza danych Drupala, pliki przesłane przez użytkowników czy katalog vendor powinny być przechowywane w wolumenach, aby nie zniknęły przy usuwaniu lub ponownym tworzeniu kontenera. Wolumeny są kluczowe przy aktualizacjach i przenoszeniu środowisk.

Docker CLI – podstawowe polecenia

Praca z Dockerem odbywa się głównie przez wiersz poleceń. Do najważniejszych komend należą:

• docker pull – pobiera obraz z rejestru (np. oficjalny obraz Drupala)
• docker run – uruchamia nowy kontener na podstawie obrazu
• docker ps – wyświetla aktualnie działające kontenery
• docker stop / docker start – zatrzymywanie i ponowne uruchamianie kontenerów
• docker rm – usuwanie kontenerów
• docker volume ls / rm – zarządzanie wolumenami z danymi

Dla użytkownika Drupala najbardziej praktyczne jest łączenie tych poleceń z plikami konfiguracyjnymi docker-compose, które automatyzują uruchamianie całego zestawu usług. Zamiast uruchamiać każdy kontener osobno, wpisujesz jedno polecenie i otrzymujesz kompletne środowisko z bazą, serwerem www, narzędziami developerskimi czy cache.

Docker Compose – definicja środowiska w jednym pliku

Docker Compose pozwala opisać w pliku YAML cały stack potrzebny dla Drupala. Definiujesz w nim usługi (services), takie jak web, db, redis, a także informacje o wolumenach i sieciach. Taki plik jest świetnym źródłem dokumentacji – każdy nowy członek zespołu może zobaczyć, jak wygląda środowisko i uruchomić je jednym poleceniem docker compose up.

Compose umożliwia również łatwe skalowanie i modyfikowanie ustawień. Chcesz przetestować Drupal na innej wersji PHP? Zmieniasz jedną linijkę w pliku i przebudowujesz kontener. Potrzebujesz dodatkowej usługi, np. wyszukiwarki Solr? Dodajesz kolejną sekcję service, definiujesz porty i wolumeny, a cała reszta projektu pozostaje niezmieniona.

Bezpieczeństwo i izolacja środowiska

Kontenery zapewniają izolację procesów, ale nie są pełnym zamiennikiem maszyn wirtualnych pod względem bezpieczeństwa. Nadal warto dbać o aktualizacje obrazów, ograniczanie praw użytkowników w kontenerach oraz ostrożne mapowanie portów na świat zewnętrzny. W kontekście Drupala dotyczy to szczególnie środowisk testowych wystawionych do Internetu.

Jedną z ważnych praktyk jest korzystanie z możliwie oficjalnych lub dobrze utrzymywanych obrazów. Regularne aktualizacje, skanowanie pod kątem podatności i przejrzyste Dockerfile pomagają ograniczać ryzyko. Dla początkujących użytkowników Drupal + Docker oznacza przede wszystkim izolację środowiska developerskiego od systemu, co samo w sobie jest dużym krokiem naprzód.

Tworzenie prostego środowiska Drupal w Docker

Struktura katalogów projektu

Podstawą uporządkowanego projektu jest jasna struktura katalogów. Dla środowiska Drupal z Dockerem warto stworzyć katalog główny projektu, w którym znajdą się pliki drupala, konfiguracja Dockera oraz dane pomocnicze. Przykładowy układ może wyglądać tak:

• ./drupal – kod źródłowy, np. zinstalowany przez Composer
• ./docker – pliki konfiguracyjne Docker, Dockerfile, skrypty
• ./db-data – dane bazy, powiązane z wolumenem

Taki podział pozwala łatwo wykluczyć katalog db-data z systemu kontroli wersji, zachowując jednocześnie pełną reprodukowalność kodu i konfiguracji. W repozytorium trzymasz więc Dockerfile, docker-compose.yml, pliki konfiguracyjne serwera www, a dane dynamiczne pozostają lokalne.

Przykładowy plik docker-compose.yml dla Drupala

W pliku docker-compose.yml definiujesz usługi, z których składa się środowisko. Typowa konfiguracja obejmuje co najmniej dwie usługi: web z Apache/PHP oraz db z MariaDB lub MySQL. Dodatkowo możesz zdefiniować wolumen na dane bazy. Dla początkujących szczególnie istotne jest poprawne mapowanie portów (np. 8080:80), aby móc odwiedzić stronę Drupal w przeglądarce pod adresem localhost:8080.

W sekcji service:web wskazujesz obraz bazowy, katalog z kodem Drupala montowany jako wolumen oraz zmienne środowiskowe, takie jak ustawienia PHP lub konfiguracja wirtualnego hosta. Service:db zawiera konfigurację bazy danych: nazwę, użytkownika, hasło oraz wolumen, w którym przechowywane będą dane. Dzięki temu nawet po usunięciu kontenera baza nie znika.

Instalacja Drupala w kontenerze

Po uruchomieniu docker compose up środowisko powinno wystartować, a serwer www nasłuchiwać na wskazanym porcie. Kolejny krok to instalacja Drupala. Możesz to zrobić na dwa sposoby: korzystając z instalatora w przeglądarce lub używając narzędzi takich jak **Composer** i Drush wewnątrz kontenera. Dla prostoty początkujący często wybierają opcję instalatora webowego.

W przeglądarce podajesz dane bazy zdefiniowane w docker-compose.yml, takie jak nazwa bazy, login i hasło. Kontenery współdzielą sieć, więc zamiast localhost jako host bazy zwykle wpisujesz nazwę usługi z Compose, np. db. Po zakończeniu instalacji otrzymujesz w pełni działający serwis Drupal, zamknięty w kontenerach, z bazą w wolumenie i kodem w katalogu projektu.

Praca z kodem: edycja plików i cache

Wraz z postępem projektu będziesz modyfikować moduły, motywy i pliki konfiguracyjne. Dzięki montowaniu katalogu z kodem jako wolumenu, możesz edytować pliki na swoim komputerze w ulubionym edytorze, a zmiany są natychmiast widoczne w kontenerze. Nie ma potrzeby logowania się do kontenera w celu edycji plików – wszystko odbywa się lokalnie.

Drupal silnie korzysta z cache, dlatego warto znać sposób na szybkie jego odświeżanie. W środowisku Docker często używa się Drusha uruchamianego w kontenerze web, np. poprzez docker compose exec web drush cr. Dzięki temu cache konfiguracji, widoków czy motywów jest czyszczony bezpośrednio wewnątrz środowiska, co minimalizuje problemy z niespójnymi danymi.

Dobre praktyki i rozszerzanie środowiska

Utrzymywanie identycznych środowisk

Jednym z największych atutów Dockera jest możliwość standaryzacji środowisk. Aby to faktycznie osiągnąć, warto trzymać pliki Dockerfile i docker-compose.yml w repozytorium wraz z kodem Drupala. Każda zmiana w konfiguracji, np. instalacja nowego rozszerzenia PHP czy zmiana wersji bazy, przechodzi przez review i historię zmian, co zwiększa przewidywalność.

W zespołach projektowych dobrze jest też ustalić jasną instrukcję uruchamiania projektu, w której opiszesz wymagania wstępne, komendy startowe i typowe problemy. Dokumentacja w połączeniu z wersjonowaną konfiguracją Dockera sprawia, że dołączenie nowego developera do projektu jest szybsze, a czas potrzebny na konfigurację środowiska spada do minimum.

Rozszerzanie stacku o dodatkowe usługi

Wraz z rozwojem projektu pojawia się potrzeba wykorzystania dodatkowych usług, takich jak cache Redis, wyszukiwarka Solr, narzędzia do kolejek czy serwery plików. Docker i Compose są do tego naturalnym narzędziem: wystarczy dodać nowe service w pliku i zdefiniować odpowiednie zależności oraz zmienne środowiskowe.

Dla Drupala typową rozbudową jest dodanie usług cache i wyszukiwania pełnotekstowego. W praktyce sprowadza się to do uruchomienia kolejnego kontenera z oficjalnym obrazem, np. redis, oraz skonfigurowania odpowiednich modułów w Drupal. Dzięki izolacji kontenerowej testowanie wpływu nowych usług na wydajność staje się znacznie prostsze i bezpieczniejsze.

Kopie zapasowe i migracje między środowiskami

Docker ułatwia tworzenie spójnych kopii zapasowych. Możesz backupować zarówno bazę danych, jak i katalogi z plikami w wolumenach. Często stosuje się dedykowane kontenery pomocnicze do wykonywania zrzutów bazy (dump) i kompresji katalogów. Tak przygotowane archiwa można przenosić między środowiskami, odtwarzając w ten sposób identyczny stan strony Drupal.

Migracja między środowiskiem lokalnym a testowym lub produkcyjnym sprowadza się do przeniesienia danych i uruchomienia kontenerów z tą samą konfiguracją. W praktyce oznacza to mniejszą liczbę niespodzianek typu działa lokalnie, nie działa na serwerze. Kluczem jest konsekwentne używanie tych samych obrazów i plików konfiguracyjnych, a także regularne testowanie procesu odtwarzania kopii.

Optymalizacja wydajności w kontenerach

Choć Docker wprowadza pewną warstwę abstrakcji, przy odpowiedniej konfiguracji środowisko Drupal może działać bardzo wydajnie. Warto zwrócić uwagę na ustawienia PHP (limity pamięci, opcache), konfigurację serwera www, a także strategię cache’owania. Kontenery umożliwiają szybkie testowanie różnych konfiguracji – możesz przygotować kilka wariantów Dockerfile i porównać ich efekty.

Dla dużych projektów kluczowe jest również wydzielenie komponentów odpowiedzialnych za cięższe operacje, takich jak generowanie raportów czy integracje z zewnętrznymi API. W Dockerze mogą one działać w osobnych kontenerach workers, komunikujących się z główną aplikacją. Taka architektura ułatwia skalowanie i pozwala lepiej wykorzystać zasoby, a jednocześnie utrzymuje porządek w konfiguracji całego systemu.