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 -alubdocker container ls -a. - Tylko zatrzymane: dodaj filtr
--filter status=exited. - Same identyfikatory: połącz opcje
-ai-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.
