Polecenia Docker Compose

Zestawienie najważniejszych komend na potrzeby uruchamiania usług Docker Compose zdefiniowanych w plikach docker-compose.yml
Poradnik: Polecenia Docker Compose

Niniejszy zestaw komend został przygotowany specjalnie na potrzeby uruchamiania usług w środowisku konteneryzacji za pomocą Docker Compose. Skupia się on na wykorzystaniu plików konfiguracji YAML, które pozwalają na definiowanie całych stosów technologicznych jako jednej, spójnej całości. Znajdziesz tu polecenia niezbędne do codziennej orkiestracji usług, monitorowania ich wydajności oraz utrzymywania porządku w zasobach systemowych.

Polecenia z sudo czy bez

To, czy powinieneś używać sudo, zależy od tego, jak skonfigurowałeś środowisko Docker na swoim systemie. Oto jak to wygląda w praktyce:

Domyślne zachowanie (Wymagane sudo)

W większości instalacji na systemach Linux (np. Ubuntu, Debian), demon Dockera działa z uprawnieniami roota. Oznacza to, że każda komenda domyślnie wymaga przedrostka sudo. Przykład: sudo docker compose up -d

Konfiguracja "Rootless" (Bez sudo)

Możesz skonfigurować system tak, aby Twój użytkownik należał do grupy docker. Dzięki temu będziesz mógł uruchamiać wszystkie powyższe polecenia bez sudo. Jest to zalecane rozwiązanie dla wygody i bezpieczeństwa pracy deweloperskiej.

Uwaga: Jeśli nie dodałeś swojego użytkownika do grupy docker, a spróbujesz wykonać komendę bez sudo, otrzymasz błąd typu: permission denied while trying to connect to the Docker daemon socket.

Jak sprawdzić, czy potrzebujesz sudo?

Sprawdź, czy twoja instalacja docker potrzebuje sudo. Wpisz w terminalu:

Bash
docker ps

Jeśli widzisz listę kontenerów – nie potrzebujesz sudo.

Jeśli widzisz "Permission denied" – musisz używać sudo lub dodać użytkownika do grupy poleceniem:

Bash
sudo usermod -aG docker $USER

(Po tym poleceniu musisz się wylogować i zalogować ponownie).

Docker Compose (Zarządzanie aplikacjami)

Sekcja ta służy do orkiestracji wielokontenerowych środowisk. Pozwala zarządzać całą architekturą aplikacji jako jedną spójną jednostką za pomocą plików YAML.

docker compose up — uruchomienie usług

docker compose up (bez flag)

Uruchamia usługi w trybie interaktywnym (widzisz logi w terminalu).

Bash
docker compose up

docker compose up -d

Uruchamia wszystko w tle (tryb detach).

Bash
docker compose up -d

docker compose up --force-recreate

Wymusza stworzenie kontenerów na nowo, nawet jeśli konfiguracja się nie zmieniła.

Bash
docker compose up --force-recreate

docker compose up --no-deps

Uruchamia wybraną usługę bez włączania usług, od których ona zależy.

Bash
docker compose up --no-deps web

docker compose down — zatrzymanie projektu

docker compose down (bez flag)

Zatrzymuje i usuwa kontenery oraz sieci projektu zdefiniowane w pliku YAML.

Bash
docker compose down

docker compose down -v

Usuwa kontenery, sieci i powiązane z nimi wolumeny (czyści trwale dane bazy danych).

Bash
docker compose down -v

docker compose down --rmi all

Usuwa obrazy używane przez wszystkie usługi zdefiniowane w projekcie przy jego wyłączaniu.

Bash
docker compose down --rmi all

docker compose start - wznowienie usług

docker compose start

Uruchamia wcześniej zatrzymane kontenery bez ich ponownego tworzenia.

Bash
docker compose start

docker compose stop - zatrzymanie usług

docker compose stop

Zatrzymuje kontenery, ale ich nie usuwa. Stan plików zostaje zachowany.

Bash
docker compose stop

docker compose restart — restart usług

docker compose restart

Szybkie zrestartowanie usług projektu.

Bash
docker compose restart

docker compose pause — wstrzymanie usług

docker compose pause

Zamraża działanie kontenerów w pamięci RAM.

Bash
docker compose pause

docker compose ps — lista usług

docker compose ps (bez flag)

Wyświetla listę i aktualny stan działających kontenerów w obrębie projektu.

Bash
docker compose ps

docker compose ps --format json

Wyświetla stan usług w formacie JSON, co jest przydatne do dalszego przetwarzania przez skrypty.

Bash
docker compose ps --format json

docker compose ps -a

Pokazuje wszystkie kontenery projektu, włączając te, które uległy awarii lub zostały zatrzymane.

Bash
docker compose ps -a

docker compose logs — podgląd zdarzeń

docker compose logs (bez flag)

Wypisuje dotychczasowe logi ze wszystkich usług i natychmiast kończy działanie.

Bash
docker compose logs

docker compose logs -f

Uruchamia śledzenie logów na żywo (tryb follow), aktualizując widok w miarę pojawiania się nowych zdarzeń.

Bash
docker compose logs -f

docker compose logs --tail 100

Ogranicza wyświetlane logi tylko do ostatnich 100 linii dla każdej z usług.

Bash
docker compose logs --tail 100

docker compose exec — wejście do kontenera

docker compose exec (bez flag)

Umożliwia wykonanie dowolnego polecenia bezpośrednio wewnątrz działającego kontenera usługi.

Bash
docker compose exec app ls

docker compose exec -u root

Uruchamia powłokę lub polecenie wewnątrz kontenera z uprawnieniami administratora (root).

Bash
docker compose exec -u root db bash

docker compose exec -e KEY=VAL

Wykonuje polecenie w kontenerze, wstrzykując dodatkową, tymczasową zmienną środowiskową.

Bash
docker compose exec -e DEBUG=1 app php artisan

Docker Container (Zarządzanie kontenerami)

Ta sekcja zawiera polecenia do bezpośredniej kontroli nad cyklem życia pojedynczych kontenerów. Służy do ich monitorowania wydajności oraz interakcji z ich systemem plików.

docker ls / ps — status kontenerów

docker ps

Wyświetla listę wszystkich aktualnie uruchomionych kontenerów na danym hoście.

Bash
docker ps

docker docker ps -a

Wyświetla wszystkie kontenery na serwerze, w tym te niepowiązane z obecnym projektem Compose oraz te zatrzymane.

Bash
docker ps -a

docker ps -s

Dodaje do widoku kolumnę informującą o całkowitym rozmiarze danych zapisanych na dysku przez każdy kontener.

Bash
docker ps -s

docker inspect — szczegóły techniczne

docker inspect

Zwraca kompletne informacje techniczne o kontenerze lub obrazie w formacie JSON.

Bash
docker inspect container_id

docker inspect -f

Wyciąga konkretne wartości z konfiguracji (np. adres IP) przy użyciu szablonów Go.

Bash
docker inspect -f '{{.NetworkSettings.IPAddress}}' container_id

docker stats — zużycie zasobów

docker stats

Wyświetla na żywo statystyki zużycia procesora (CPU), pamięci RAM oraz sieci przez wszystkie kontenery.

Bash
docker stats

docker cp — kopiowanie plików

docker cp

Pozwala na kopiowanie plików i folderów pomiędzy systemem operacyjnym hosta a wnętrzem kontenera.

Bash
docker cp container:/var/log/app.log .

Logistyka Obrazów (Gotowe artefakty)

Sekcja poświęcona zarządzaniu gotowymi obrazami. Pozwala na pobieranie ich z rejestrów, listowanie zasobów lokalnych oraz archiwizowanie obrazów.

docker pull — pobieranie obrazu

docker pull

Ściąga najnowszą wersję obrazu (tag: latest) z publicznego lub prywatnego rejestru.

Bash
docker pull nazwa-obrazu

docker images — lista obrazów

docker images

Wypisuje listę wszystkich obrazów pobranych na dysk lokalny.

Bash
docker images

Sieci i Wolumeny (Logistyka)

Ta sekcja służy do zarządzania infrastrukturą pomocniczą. Sieci odpowiadają za komunikację, a wolumeny za trwałe przechowywanie danych.

docker network — obsługa sieci

docker network ls

Wyświetla wszystkie sieci stworzone przez Docker, w tym te automatycznie wygenerowane przez Compose.

Bash
docker network ls

docker volume — obsługa danych

docker volume ls

Wypisuje listę wszystkich wolumenów nazwalnych dostępnych na hoście.

Bash
docker volume ls

docker volume prune

Usuwa wszystkie wolumeny, które nie są aktualnie używane przez żaden działający kontener (uwalnianie miejsca).

Bash
docker volume prune

System (Porządki)

Sekcja ta zawiera narzędzia diagnostyczne i porządkowe dla całego silnika Docker. Pozwala monitorować ogólne zużycie zasobów systemowych.

docker system df — analiza dysku

docker system df

Pokazuje procentowe i ilościowe zajęcie miejsca na dysku przez obrazy, kontenery i wolumeny.

Bash
docker system df

docker system prune — czyszczenie systemu

docker system prune

Generalne sprzątanie: usuwa zatrzymane kontenery, nieużywane sieci i obrazy bez tagów (dangling).

Bash
docker system prune

docker system prune -a

Bardziej agresywne czyszczenie: usuwa absolutnie wszystkie nieużywane obrazy, a nie tylko te bez tagów.

Bash
docker system prune -a

Kategoria: Usługi | Autor: Rafał Wójcik
Utworzono: 2026-01-02 21:17 | Ostatnia edycja: 2026-04-07 15:52

Pytania & Komentarze

Brak komentarzy. Bądź pierwszy!

Dodaj nowy komentarz