Czego szukasz?

Wpisz temat, narzędzie lub problem do rozwiązania.

← Wszystkie artykuły

Docker: co to jest, jak działa i do czego służy?

Trzy odseparowane aplikacje nad wspólną warstwą systemu, w niebiesko-żółtej ilustracji.

Docker pozwala uruchamiać aplikacje w kontenerach, czyli wydzielonych środowiskach z potrzebnymi bibliotekami i narzędziami. Dzięki temu łatwiej uruchomić ten sam projekt na swoim komputerze i na serwerze.

Załóżmy, że jedna aplikacja potrzebuje Pythona 3.11, a druga wersji 3.12. Zamiast dopasowywać cały system do obu projektów, przygotowujesz dla każdego osobny obraz. Docker uruchamia z tych obrazów kontenery.

Najpierw wyjaśnię podstawowe pojęcia. Następnie uruchomisz prostą aplikację i sprawdzisz jej logi. Na końcu przeniesiesz konfigurację do pliku Docker Compose. Ćwiczenia dotyczą kontenerów linuksowych na własnym komputerze.

Docker - co to jest i jaki problem rozwiązuje?

Docker służy do przygotowania środowiska aplikacji i uruchamiania go na różnych maszynach. Najpierw budujesz lub pobierasz obraz, czyli pakiet z programem i jego zależnościami. Następnie tworzysz z niego kontener, w którym działa program.

Dzięki temu projekty mogą korzystać z różnych wersji bibliotek. Każdy dostaje własne środowisko, więc aktualizacja jednego nie musi zmieniać plików drugiego.

Możesz też przekazać taki obraz innej osobie. Nie musi wtedy odtwarzać listy bibliotek z pamięci ani instalować ich ręcznie.

Warto rozdzielić trzy nazwy:

Nazwa Do czego służy
Docker Engine Silnik, który tworzy i uruchamia kontenery
Docker Desktop Aplikacja do pracy z Dockerem na komputerze
Docker Hub Rejestr, z którego pobierasz obrazy

To różne elementy ekosystemu. Korzystanie z kontenerów na serwerze nie oznacza konieczności instalowania tam graficznej aplikacji Desktop.

Obraz, kontener i Dockerfile - trzy różne rzeczy

Dockerfile to przepis, obraz to gotowy pakiet, a kontener to środowisko utworzone z tego pakietu. Obraz zawiera między innymi kod i biblioteki. Gdy chcesz zmienić jego zawartość, budujesz nowy obraz.

Obrazy składają się z warstw. Wspólna warstwa może służyć kilku obrazom, co ogranicza powielanie tych samych danych.

Pojęcie Co oznacza Przykład zastosowania
Dockerfile Instrukcje budowania obrazu Dodanie kodu aplikacji i instalacja zależności
Obraz Gotowy pakiet potrzebny do utworzenia kontenera Wydanie aplikacji przygotowane do wdrożenia
Kontener Instancja utworzona z obrazu Działająca aplikacja albo zakończone zadanie
Rejestr obrazów Miejsce przechowywania i udostępniania obrazów Docker Hub lub prywatny rejestr

Jeden obraz może posłużyć do utworzenia kilku kontenerów. Nie oznacza to, że będą współdzieliły wszystkie zmiany w plikach. Każdy otrzymuje własną warstwę zapisu, chyba że świadomie udostępnisz im wspólne dane.

Dockerfile nie jest natomiast opisem całej infrastruktury. Odpowiada na pytanie, jak zbudować obraz. Połączenia między usługami, porty i miejsca przechowywania danych wygodniej opisać osobno, na przykład w Compose.

Plik Dockerfile, warstwowy obraz i uruchomiony kontener połączone strzałkami.
Dockerfile opisuje budowę obrazu, z którego uruchamiasz kontener.

Jak działa Docker po wydaniu polecenia?

Po wpisaniu docker run zwykle dzieją się cztery rzeczy:

  1. Klient w terminalu wysyła polecenie do usługi Docker Engine.
  2. Jeśli obrazu brakuje na dysku, Docker go pobiera.
  3. Następnie tworzy kontener z ustawieniami podanymi w poleceniu.
  4. Na koniec uruchamia program wewnątrz kontenera.

Usługa zarządzająca kontenerami to demon Dockera. Może działać na tym samym komputerze co terminal lub na zdalnym serwerze.

Kontenery linuksowe korzystają z mechanizmów jądra systemu. Namespaces oddzielają między innymi widok procesów i sieci. Natomiast cgroups pozwalają kontrolować zużycie zasobów.

Na początek wystarczy zapamiętać: kontener to wydzielone środowisko dla procesów aplikacji. Nie uruchamia własnego jądra systemu.

Wniosek praktyczny: sam fakt użycia kontenera nie przydziela aplikacji dowolnej ilości pamięci. Nadal korzysta ona z zasobów maszyny, na której działa.

Docker a maszyna wirtualna

Maszyna wirtualna ma własny system operacyjny i jądro. Kontenery linuksowe współdzielą jądro środowiska, w którym są uruchamiane. Dzięki temu nie trzeba uruchamiać osobnego systemu dla każdej aplikacji.

Cecha Kontener linuksowy Maszyna wirtualna
Jądro systemu Współdzielone z hostem kontenerów Własne jądro systemu gościa
Podstawowa jednostka Środowisko procesu aplikacji Cały system operacyjny
Typowe zastosowanie Uruchamianie usług i zadań Oddzielenie pełnych systemów
Koszt dodatkowego środowiska Zwykle mniejszy Obejmuje kolejny system gościa

Oba rozwiązania mogą działać razem. Przykładowo VPS może być maszyną wirtualną, wewnątrz której uruchamiasz kilka kontenerów.

Docker może jednak sam korzystać z wirtualizacji. Na przykład Docker Desktop na macOS uruchamia kontenery linuksowe w środowisku z jądrem Linux. Dopiero wewnątrz niego kontenery współdzielą jądro.

Do czego służy Docker w codziennej pracy?

Najłatwiej ocenić przydatność Dockera przez zadanie, które chcesz wykonać. Samo przeniesienie programu do kontenera nie jest jeszcze usprawnieniem.

Środowiska developerskie i testowe

Jeżeli projekt wymaga aplikacji, bazy danych i dodatkowej usługi, wspólny opis środowiska ogranicza liczbę ręcznych instrukcji dla nowych osób. Zamiast prośby o odtworzenie konfiguracji z pamięci przekazujesz pliki projektu.

Praktyczny przykład: testujesz zmianę w aplikacji korzystającej z bazy. Przygotowujesz osobne środowisko z testowymi danymi, zamiast eksperymentować na bazie używanej przez działającą stronę. Kontenery ułatwiają taki podział, ale poprawny wybór danych nadal należy do Ciebie.

Własny serwer i self-hosting

Możesz podzielić projekt na usługę aplikacji, bazę i proces wykonujący zadania w tle. Dzięki temu opisujesz ich konfigurację oddzielnie.

Dla początkującego administratora istotne są konkretne pytania: gdzie aplikacja zapisuje pliki, jak komunikuje się z bazą i co trzeba zachować przy aktualizacji. Dopiero odpowiedzi na nie pozwalają sensownie zaplanować wdrożenie.

Automatyzacja i zadania jednorazowe

Kontener nie musi działać bez przerwy. Możesz użyć go do wykonania skryptu, wygenerowania pliku albo przetworzenia danych. Po zakończeniu głównego procesu kontener może pozostać zatrzymany. Nie jest to automatycznie awaria. Cykl uruchomienia zależy od polecenia wykonywanego w środku.

Dobrym kryterium jest powtarzalność: jeżeli często odtwarzasz te same zależności na różnych maszynach, warto rozważyć opisanie tego środowiska jako obrazu.

Pierwszy kontener Docker krok po kroku

Do ćwiczenia potrzebujesz:

  • działającego Docker Desktop lub Docker Engine w trybie kontenerów linuksowych,
  • dostępu do internetu,
  • wolnego portu 8080.

Poniżej zaczynamy od sprawdzenia gotowej instalacji. Wszystkie polecenia wykonuj w terminalu na swoim komputerze.

1. Sprawdź połączenie z Dockerem

W terminalu wykonaj:

docker version

Zwróć uwagę na informacje o kliencie i serwerze. Jeżeli klient nie może połączyć się z demonem, najpierw uruchom odpowiednią usługę albo Docker Desktop. Ponawianie polecenia tworzącego kontener nie rozwiąże braku połączenia.

2. Uruchom aplikację demonstracyjną

Wpisz jako jedną linię:

docker run --name tt-demo -d -p 127.0.0.1:8080:80 docker/welcome-to-docker

Poszczególne elementy oznaczają:

  • --name tt-demo nadaje kontenerowi nazwę używaną w kolejnych poleceniach.
  • -d uruchamia go w tle.
  • -p 127.0.0.1:8080:80 kieruje ruch z lokalnego portu 8080 do portu 80 kontenera.
  • docker/welcome-to-docker wskazuje obraz demonstracyjny używany w dokumentacji Dockera.

Otwórz w przeglądarce http://127.0.0.1:8080. Powinna pojawić się strona demonstracyjna. To lokalna aplikacja.

3. Sprawdź stan i logi

docker ps
docker logs tt-demo

Jeżeli aplikacja nie odpowiada, sprawdź również zatrzymane kontenery:

docker ps -a

Przy konflikcie portu możesz użyć mapowania 127.0.0.1:8081:80. Wtedy w przeglądarce wpisz port 8081. Jeśli nazwa tt-demo jest już zajęta, sprawdź istniejący kontener przed utworzeniem kolejnego.

4. Zakończ przykład

Poniższe polecenia dotyczą wyłącznie utworzonego kontenera demonstracyjnego:

docker stop tt-demo
docker rm tt-demo

Zatrzymanie i usunięcie to różne operacje. Pierwsza kończy działanie procesu, druga usuwa kontener. Pobrany obraz może pozostać na dysku.

Polecenia do sprawdzania kontenerów, logów i zużycia zasobów znajdziesz w ściądze Docker i Compose. Jeśli proces kończy się zaraz po starcie, przejdź przez diagnostykę wyłączającego się kontenera.

Porty: dlaczego aplikacja nie zawsze jest dostępna?

Port aplikacji w kontenerze i port na komputerze to dwa różne punkty. Mapowanie 8080:80 oznacza: połącz port 8080 hosta z portem 80 kontenera. Nie zmienia konfiguracji samej aplikacji na port 8080.

Pomijając adres hosta w mapowaniu, domyślnie publikujesz port na wszystkich jego adresach. Dlatego w przykładzie używamy 127.0.0.1. Wyjaśnia to dokumentacja publikowania portów, która wskazuje również historyczny wyjątek dla wersji Engine starszych niż 28.0.0. Ćwiczenie wykonuj na aktualnej instalacji i przy standardowej konfiguracji sieci.

W typowej sieci Compose kontenery odnajdują się po nazwach usług. Jeżeli baza ma nazwę db, aplikacja łączy się z usługą db na porcie bazy, a nie z localhost swojego kontenera. Nie trzeba publikować portu bazy na hoście wyłącznie po to, by korzystała z niej druga usługa w tej samej sieci.

Gdy publikacja portu kończy się błędem, sprawdź poradnik Docker: port is already allocated. Osobno opisuję brak połączenia kontenera z bazą, gdzie znaczenie mają adres usługi i wspólna sieć.

Gdzie Docker przechowuje dane?

Dane zapisane wyłącznie w zapisywalnej warstwie kontenera znikają przy jego usunięciu. Samo zatrzymanie kontenera ich nie kasuje. Do trwałego przechowywania danych możesz użyć wolumenu, którego cykl życia jest oddzielny od kontenera.

W praktyce rozdziel:

  • Obraz aplikacji, który można pobrać lub zbudować ponownie.
  • Konfigurację, potrzebną do poprawnego uruchomienia.
  • Dane użytkowników, których nie odtworzysz z samego obrazu.

Wolumenem zarządza Docker. Możesz go podłączyć do nowego kontenera po usunięciu starego.

Natomiast bind mount udostępnia konkretny plik lub katalog z komputera. Przydaje się na przykład wtedy, gdy edytujesz pliki lokalnie i chcesz od razu widzieć je w kontenerze.

Trwałość nie oznacza jednak kopii zapasowej. Jeśli wolumen i baza działają na tym samym serwerze, utrata tego serwera może oznaczać utratę danych. Zaplanuj osobny backup i sprawdź odtwarzanie. Dla bazy danych sposób wykonania spójnej kopii dobierz do używanego silnika.

Stary i nowy kontener wskazują ten sam wolumen umieszczony pod nimi.
Wymiana kontenera nie musi usuwać danych zapisanych w osobnym wolumenie.

Różnicę między warstwą kontenera, bind mountem i wolumenem możesz zobaczyć w teście trwałości danych po usunięciu kontenera. Do eksperymentu dołączone są wyniki i skrypt.

Docker Compose: konfiguracja zapisana w pliku

Przy kolejnych usługach ręczne polecenia stają się trudniejsze do utrzymania. Docker Compose pozwala opisać aplikację w YAML i zarządzać jej usługami razem. W pliku zapisujesz między innymi używane obrazy i mapowania portów.

Po zakończeniu poprzedniego ćwiczenia utwórz osobny katalog. Zapisz w nim plik compose.yaml:

services:
  web:
    image: docker/welcome-to-docker
    ports:
      - "127.0.0.1:8080:80"

Uruchom polecenia z tego katalogu:

docker compose -p tt-nauka config
docker compose -p tt-nauka up -d
docker compose -p tt-nauka ps
docker compose -p tt-nauka logs web

Polecenie config sprawdza i wyświetla konfigurację. Następnie up -d uruchamia usługę w tle. Za pomocą ps sprawdzasz stan, a logs web odczytujesz logi. Nazwa projektu tt-nauka oddziela to ćwiczenie od innych projektów Compose. Aplikacja jest dostępna pod tym samym lokalnym adresem co wcześniej.

Po ćwiczeniu usuń jego kontener i sieć projektu:

docker compose -p tt-nauka down

Jedna usługa wystarcza do poznania składni. Rozbudowując projekt, pamiętaj jednak, że uruchomiony kontener bazy nie musi jeszcze oznaczać gotowej bazy. Samo określenie kolejności startu nie wystarcza; Compose obsługuje oczekiwanie na poprawny healthcheck przy warunku service_healthy.

Pełny przykład aplikacji i proxy opisuję w poradniku Docker Compose: uruchomienie kilku kontenerów razem. Możesz też pobrać gotową konfigurację Nginx z Compose do własnych prób.

Czego Docker nie rozwiązuje automatycznie?

Zgodność platformy i wersji

Obraz przygotowany dla jednej architektury procesora nie zawsze zadziała natywnie na innej. Potrzebujesz odpowiedniego wariantu obrazu albo emulacji, która może obniżać wydajność. Obrazy wieloplatformowe pozwalają udostępnić kilka wariantów pod wspólnym odwołaniem.

W przykładach pominęliśmy tag obrazu, więc używane jest domyślne latest. To wygodne w ćwiczeniu, ale nie identyfikuje niezmiennej zawartości. W kontrolowanym wdrożeniu określ wersję, a gdy potrzebujesz jednoznacznie wskazać zawartość, użyj identyfikatora digest.

Bezpieczeństwo i utrzymanie

Kontener nie jest gwarancją bezpiecznego wykonania dowolnego kodu. Dostęp do demona Dockera oraz zbyt szerokie udostępnienie plików hosta mogą dać bardzo duże uprawnienia. Dlatego sprawdzaj pochodzenie obrazu i zakres wymaganych uprawnień.

Przed pierwszym wdrożeniem przygotuj odpowiedzi na pięć pytań:

  1. Z jakiego obrazu korzystam i jak będę go aktualizować?
  2. Które dane muszą przetrwać wymianę kontenera?
  3. Które porty rzeczywiście powinny być dostępne z zewnątrz?
  4. Jak sprawdzę, czy aplikacja działa poprawnie?
  5. Jak odtworzę usługę i dane po awarii?

Docker nie zastępuje tych decyzji. Jeśli uruchamiasz pojedynczy skrypt tylko raz, dodatkowa konfiguracja może być zbędna. Zyskujesz więcej, gdy regularnie odtwarzasz środowisko lub przekazujesz je innym osobom.

Czy Docker jest darmowy?

Trzeba odróżnić otwarte komponenty, takie jak Docker Engine, od warunków korzystania z Docker Desktop. Według dokumentacji Desktop jest bezpłatny między innymi do użytku osobistego, edukacji, niekomercyjnych projektów open source oraz dla małych firm spełniających oba warunki: mniej niż 250 pracowników i mniej niż 10 mln USD rocznego przychodu.

Użycie zawodowe poza bezpłatnym zakresem oraz przez podmioty rządowe wymaga płatnej subskrypcji. Przed wdrożeniem firmowym sprawdź zasady licencjonowania Docker Desktop. Te warunki nie oznaczają automatycznej opłaty za każdy kontener uruchomiony na serwerze z Docker Engine.

Najczęstsze pytania

Od czego zacząć naukę Dockera?

Zacznij od jednej aplikacji demonstracyjnej. Uruchom ją, sprawdź port, odczytaj logi, zatrzymaj i usuń kontener. Dopiero potem przenieś konfigurację do Compose i dodaj trwałe dane. Taka kolejność pozwala oddzielić problemy z Dockerem od problemów konkretnego projektu.

Czy Docker zastępuje VPS?

Nie. VPS dostarcza maszynę, na której mogą działać aplikacje. Docker organizuje ich uruchamianie w kontenerach. Możesz więc korzystać z Dockera na VPS-ie, ale nadal potrzebujesz zasobów obliczeniowych, miejsca na dysku i połączenia sieciowego. Kontenery i maszyny wirtualne mogą się uzupełniać.

Dlaczego kontener od razu się zatrzymuje?

Możliwe, że główny proces zakończył zadanie albo wystąpił błąd aplikacji. Sprawdź docker ps -a oraz docker logs NAZWA_KONTENERA. Dla zadania jednorazowego zakończenie może być prawidłowe; dla serwera WWW wymaga wyjaśnienia. Zachowanie kontenera zależy od uruchomionego polecenia.

Czy usunięcie kontenera usuwa bazę danych?

Może ją usunąć, jeśli pliki bazy były zapisane tylko w warstwie kontenera. Przy poprawnie podłączonym nazwanym wolumenie usunięcie samego kontenera nie usuwa wolumenu. Nadal możesz jednak skasować go osobną operacją, dlatego potrzebujesz również kopii zapasowej.

Dlaczego aplikacja nie widzi bazy pod localhost?

W typowej konfiguracji Compose localhost wewnątrz kontenera wskazuje ten kontener, nie oddzielną usługę bazy. Jeśli obie usługi są w tej samej sieci Compose, użyj nazwy usługi bazy i jej wewnętrznego portu, na przykład db:5432 dla tak skonfigurowanego PostgreSQL.

Czy Docker Compose wystarczy na początek?

Do poznania konfiguracji usług w jednym projekcie jest dobrym punktem startowym. Zacznij od małego środowiska, którego dane i połączenia rozumiesz. Jeśli później pojawią się wymagania dotyczące wielu serwerów lub odporności na awarie, oceniaj narzędzia pod te konkretne potrzeby, zamiast rozbudowywać infrastrukturę na zapas.

Źródła

Data publikacji: 23.09.2026.

KP
O AUTORZE

Krystian Proć

Tworzę narzędzia do pracy z danymi, systemy backendowe i automatyzacje. Pracuję z SQL, PHP, TypeScriptem i Dockerem; rozwijam m.in. dragon-island.com. AI pomaga mi przyspieszać pracę, a architekturę, weryfikację i decyzje techniczne biorę na siebie. Na Trybie Technicznym dzielę się doświadczeniami z budowania i utrzymywania własnych projektów.

Dyskusja

Dodaj komentarz

Twój adres email nie zostanie opublikowany. Wymagane pola są oznaczone *