Docker ps -a nie pokazuje kontenera? Sprawdź, co zrobić

Tymoteusz Maciejewski • 21 listopada 2026
Widok konsoli z listą uruchomionych kontenerów Docker. Widać kontener jovial_wescoff.

Spis treści

Po wdrożeniu aplikacji widzisz ją w logach, ale zwykłe docker ps nie pokazuje kontenera, który właśnie zakończył pracę. Żeby wyświetlić działające i zatrzymane kontenery, użyj docker ps -a albo docker container ls -a, choć pusty wynik może oznaczać, że patrzysz na inny Docker context lub kontener został usunięty.

Jedna flaga pokazuje kontenery działające i zatrzymane

  • Pełna lista: docker ps -a lub docker container ls -a.
  • Tylko zatrzymane: dodaj filtr --filter status=exited.
  • Same identyfikatory: połącz opcje -a i -q.
  • Pusta lista: sprawdź aktywny context i to, czy uruchomienie nie użyło --rm.

docker ps -a pokazuje więcej niż zwykłe docker ps

Bez dodatkowej opcji Docker wyświetla tylko uruchomione kontenery. Dodanie -a (czyli --all) obejmuje także te, które zakończyły pracę, zostały zatrzymane lub jeszcze nie wystartowały. Pełna postać polecenia brzmi docker container ls --all; obie wersje korzystają z tego samego polecenia.

Wynik zawiera między innymi identyfikator, obraz, uruchomione polecenie, status, porty i nazwę kontenera. Przy szybkim przeglądzie skup się na kolumnie STATUS: „Up” wskazuje działający proces, a „Exited” kontener, który zakończył pracę. Dokumentacja polecenia docker container ls opisuje też dodatkowe filtry i formatowanie wyników.

Potrzebujesz tylko nazw albo identyfikatorów, na przykład do dalszego polecenia? Użyj docker ps -aq, a Docker zwróci same ID wszystkich kontenerów. Uważam, że to wygodny skrót do skryptów, ale przed przekazaniem wyniku do polecenia usuwającego kontenery zawsze sprawdź, co obejmuje lista.

Filtruj listę, gdy szukasz konkretnego stanu

Kilkaset wierszy w terminalu utrudnia znalezienie jednego zatrzymanego zadania. Filtr ogranicza wynik do potrzebnego przypadku: docker ps -a --filter "status=exited" pokaże kontenery ze statusem exited, a docker ps -a --filter "name=api" wyszuka nazwy zawierające api.

Sytuacja Co może oznaczać wynik Co zrobić
Kontener ma status Exited (0) Proces zakończył się bez zgłoszenia błędu. Jeśli chcesz go uruchomić ponownie, użyj docker start NAZWA_LUB_ID.
Kontener ma status Exited z kodem różnym od zera Proces zakończył się z błędem; sam status nie wyjaśnia jego przyczyny. Sprawdź wynik poleceniem docker logs NAZWA_LUB_ID.
Wynik jest pusty Kontener mógł zostać usunięty albo polecenie łączy się z innym daemonem. Sprawdź aktywny context poleceniem docker context ls.
Lista pokazuje kontener z Restarting Docker próbuje go uruchamiać ponownie zgodnie z polityką restartu. Sprawdź logi, zamiast uruchamiać kolejny egzemplarz.

Filtry można łączyć, na przykład docker ps -a --filter "status=exited" --filter "name=api". To zawęża listę do zatrzymanych kontenerów pasujących nazwą do api; filtr statusu przydaje się też przy sprawdzaniu kodu zakończenia, np. docker ps -a --filter "exited=1". Obsługiwane stany obejmują między innymi created, running, paused, exited i dead.

Pusta lista nie zawsze oznacza, że kontener zniknął

Możesz wyświetlić pusty wynik na komputerze, choć wdrożenie działa na serwerze. Jednym z powodów jest inny Docker context, czyli konfiguracja określająca, z którym daemonem komunikuje się klient Docker. Polecenie docker context ls pokazuje dostępne konteksty, a gwiazdka oznacza aktualnie wybrany.

Jeśli lista kontekstów wskazuje niewłaściwy cel, wybierz właściwy poleceniem docker context use NAZWA, a dopiero potem ponów docker ps -a. Ta kontrola często wyjaśnia pozornie zaginione kontenery w pracy z kilkoma środowiskami, na przykład lokalnym, testowym i produkcyjnym. Szczegóły działania kontekstów opisuje dokumentacja Docker contexts.

Drugi przypadek jest mniej oczywisty: kontener uruchomiony z opcją --rm jest automatycznie usuwany po zakończeniu pracy, więc nie pojawi się na liście zatrzymanych. Zwykłe zatrzymanie kontenera nie usuwa go automatycznie, dlatego nie myl statusu Exited z usunięciem zasobu.

Wybierz polecenie zależnie od tego, co chcesz zrobić

W krótkim zadaniu z CI łatwo pomylić dwa cele: sprawdzić, co istnieje, albo przygotować identyfikatory do dalszej komendy. Do diagnostyki wygodniejsza jest czytelna tabela docker ps -a; do automatyzacji, która oczekuje wyłącznie ID, użyj docker ps -aq.

  • Przegląd całego środowiska: docker ps -a.
  • Kontenery zakończone: docker ps -a --filter "status=exited".
  • Jeden kontener po nazwie: docker ps -a --filter "name=api".
  • Lista ID do skryptu: docker ps -aq.
  • Kontener, który mógł zniknąć po zakończeniu: sprawdź, czy podczas uruchamiania użyto --rm.

Przykład: zadanie testowe kończy się, a po chwili nie ma go nawet w docker ps -a. Najpierw sprawdź, czy skrypt uruchamia je z --rm; jeśli tak, brak wpisu jest oczekiwanym skutkiem automatycznego sprzątania. Gdy tej opcji nie ma, sprawdź context, a potem listę kontenerów z filtrem nazwy.

Najpierw sprawdź context, potem szukaj kontenera

Gdy kontenera brakuje, nie zaczynaj od ponownego uruchamiania aplikacji. Najpierw wykonaj docker context ls i upewnij się, że CLI łączy się z właściwym daemonem; później sprawdź pełną listę, filtr statusu i logi.

Ta kolejność ogranicza ryzyko utworzenia drugiego egzemplarza, gdy pierwszy działa na innym środowisku albo tylko zakończył pracę. Jeśli kontener miał być widoczny po zakończeniu procesu, przejrzyj też komendę startową pod kątem --rm, bo wtedy nie znajdziesz go nawet wśród zatrzymanych.

FAQ - Najczęstsze pytania

Użyj polecenia docker ps -a albo jego pełnej wersji docker container ls --all. Opcja -a obejmuje kontenery działające, zatrzymane, zakończone oraz takie, które jeszcze nie wystartowały. Status Up oznacza działający kontener, a Exited kontener, który zakończył pracę.

Najpierw sprawdź aktywny Docker context poleceniem docker context ls. Jeśli klient łączy się z niewłaściwym daemonem, wybierz właściwy kontekstem docker context use NAZWA. Kontener może też nie pojawić się na liście, jeśli został uruchomiony z opcją --rm, która usuwa go po zakończeniu pracy.

Zatrzymane kontenery wyświetli polecenie docker ps -a --filter status=exited, a wyszukiwanie po nazwie wykonasz przez docker ps -a --filter name=api. Filtry można łączyć, na przykład używając obu warunków jednocześnie. Do znalezienia kontenerów zakończonych kodem 1 służy docker ps -a --filter exited=1.

Exited (0) oznacza zakończenie procesu bez zgłoszenia błędu i taki kontener można ponownie uruchomić poleceniem docker start NAZWA_LUB_ID. Inny kod wyjścia wskazuje błąd, którego przyczynę sprawdzisz przez docker logs NAZWA_LUB_ID. Status Restarting oznacza, że Docker próbuje uruchamiać kontener ponownie zgodnie z polityką restartu, dlatego warto najpierw przejrzeć logi.

Oceń artykuł

Ocena: 0.00 Liczba głosów: 0

Tagi

docker
kontenery
logi
konteksty
Autor Tymoteusz Maciejewski
Tymoteusz Maciejewski
Moje dni wypełnia zgłębianie kodu i analiza nowych technologii, zawsze z myślą o tym, jak najlepiej przekazać tę wiedzę dalej. Nazywam się Tymoteusz Maciejewski i od 12 lat aktywnie działam w świecie programowania, technologii i kariery w IT. Interesuje mnie nie tylko samo tworzenie oprogramowania, ale także proces, który prowadzi do zrozumienia złożonych zagadnień i uporządkowania ich w przystępny sposób. Na lukasz-zielinski.pl staram się dzielić się tym, co sam odkrywam, sprawdzając informacje u podstaw i dbając o to, by treści były aktualne i zrozumiałe dla każdego, kto chce rozwijać się w tej dynamicznej branży.

Udostępnij artykuł

Napisz komentarz