...
← Curs Docker: toate lecțiile
Lecția 5 · Containere

Lista containerelor: docker ps

Pe măsură ce lucrezi cu Docker, containerele se adună: unele rulează, altele s-au oprit de mult. docker ps este comanda pe care o vei tasta cel mai des: îți arată ce containere ai și în ce stare sunt. În această lecție înveți să citești fiecare coloană a tabelului.

Punctul de plecare

Pentru exemplele din lecție (și pentru exercițiu) au fost pornite deja patru containere: trei din alpine, care au afișat câte un cuvânt și s-au oprit, și unul din nginx, un server web care rămâne pornit. Serverul a fost pornit cu docker run -d nginx; ce înseamnă -d afli în lecția 7.

docker run alpine echo unu
docker run alpine echo doi
docker run alpine echo trei
docker run -d nginx
De ce nginx nu se oprește

echo se termină într-o clipă, deci containerul se oprește. Un server web, în schimb, rulează la nesfârșit, așteptând vizitatori; containerul lui rămâne pornit până îl oprești tu.

Exercițiul tău

În terminal sunt deja patru containere: trei din alpine (oprite) și unul din nginx (pornit). Afișează întâi doar containerele care rulează, apoi toate containerele. Câte rulează? (Răspunsul corect: unul singur, nginx.)

  • Afișează containerele pornite cu docker ps.
  • Afișează toate containerele, inclusiv cele oprite, cu docker ps -a.
Fără opțiuni, docker ps arată doar containerele pornite; cu -a le arată pe toate.

Soluția exercițiului

docker ps
docker ps -a
Excelent! Continuă cu lecția următoare →
Vrei să afli mai mult?Containerele care rulează: docker ps · Toate containerele: docker ps -a · Numele generate și ID-urile · Variante utile · Greșeli frecvente și cazuri reale

Containerele care rulează: docker ps

Fără opțiuni, docker ps afișează doar containerele pornite:

docker ps
CONTAINER ID   IMAGE     COMMAND                  CREATED        STATUS        PORTS     NAMES
b0fc34625674   nginx     "/docker-entrypoint.…"   1 second ago   Up 1 second   80/tcp    friendly_torvalds

Apare un singur rând, cel al lui nginx. Cele trei containere alpine există în continuare, dar sunt oprite, așa că nu apar aici.

Toate containerele: docker ps -a

Cu -a (*all*) vezi și containerele oprite:

docker ps -a
CONTAINER ID   IMAGE     COMMAND                  CREATED         STATUS                     PORTS     NAMES
b0fc34625674   nginx     "/docker-entrypoint.…"   2 seconds ago   Up 2 seconds               80/tcp    friendly_torvalds
2d70c2227e31   alpine    "echo trei"              3 seconds ago   Exited (0) 3 seconds ago             determined_mayer
2fa4375b606c   alpine    "echo doi"               4 seconds ago   Exited (0) 4 seconds ago             charming_galileo
a70e4837ffc8   alpine    "echo unu"               5 seconds ago   Exited (0) 5 seconds ago             angry_bohr

Fiecare coloană are un rost:

ColoanaCe înseamnă
CONTAINER IDprimele 12 caractere din ID-ul unic al containerului; poți folosi ID-ul în comenzi
IMAGEimaginea din care a pornit containerul
COMMANDcomanda care rulează (sau a rulat) în container, scurtată cu … dacă e lungă
CREATEDcând a fost creat containerul
STATUSUp 5 seconds = pornit de 5 secunde; Exited (0) 3 seconds ago = oprit, cu codul de ieșire 0
PORTSporturile containerului (nginx ascultă pe 80/tcp; în lecția 9 le faci accesibile din browser)
NAMESnumele containerului; dacă nu dai tu unul, Docker generează unul amuzant, ca angry_bohr
Codul din Exited

Exited (0) înseamnă că programul s-a terminat cu succes. Orice alt număr (Exited (1), Exited (127)) e un semn că ceva n-a mers, și primul pas e să citești jurnalul containerului (lecția 12).

Numele generate și ID-urile

Numele automate sunt formate dintr-un adjectiv și numele unui om de știință (angry_bohr, charming_galileo). Sunt alese la întâmplare, deci pe calculatorul tău vor fi altele; la fel ID-urile și timpii din CREATED.

Le poți folosi pe amândouă în comenzi: docker logs angry_bohr sau docker logs a70e4837ffc8 (numele și ID-ul din tabelul de mai sus). Pentru ID ajung chiar și primele câteva caractere (docker logs a70e), dacă nu mai începe niciun alt container la fel. În lecția 8 vei da tu nume clare containerelor, cu --name.

Variante utile

docker ps are câteva opțiuni pe care le vei folosi des. -q (*quiet*) afișează doar ID-urile, foarte util în scripturi:

docker ps -aq
b0fc34625674
2d70c2227e31
2fa4375b606c
a70e4837ffc8

-l (*latest*) afișează doar ultimul container creat, iar -n 2 ultimele două:

docker ps -l
CONTAINER ID   IMAGE     COMMAND                  CREATED         STATUS         PORTS     NAMES
b0fc34625674   nginx     "/docker-entrypoint.…"   4 seconds ago   Up 4 seconds   80/tcp    friendly_torvalds

--filter (sau -f) păstrează doar containerele care îndeplinesc o condiție, de exemplu doar cele oprite:

docker ps -a --filter status=exited
CONTAINER ID   IMAGE     COMMAND       CREATED         STATUS                     PORTS     NAMES
2d70c2227e31   alpine    "echo trei"   6 seconds ago   Exited (0) 6 seconds ago             determined_mayer
2fa4375b606c   alpine    "echo doi"    7 seconds ago   Exited (0) 7 seconds ago             charming_galileo
a70e4837ffc8   alpine    "echo unu"    8 seconds ago   Exited (0) 8 seconds ago             angry_bohr
Alt nume pentru aceeași comandă

docker ps are și o formă „nouă”, docker container ls (cu -a, -q la fel). Le vei întâlni pe amândouă în documentații; fac exact același lucru.

Greșeli frecvente și cazuri reale

  • „Containerul meu a dispărut!” De obicei nu a dispărut, s-a oprit. Folosește docker ps -a, nu doar docker ps.
  • Containerele oprite ocupă puțin spațiu, dar se adună. În lecția 11 înveți să le ștergi.
  • Coloana STATUS e primul loc unde te uiți când o aplicație nu răspunde: rulează (Up) sau s-a oprit (Exited)?
Site-ul nu merge

Primul lucru verificat de un programator: docker ps. Dacă serverul nu apare, s-a oprit și trebuie aflat de ce.

Curățenie

docker ps -a arată zecile de containere de test rămase după o zi de lucru.

Scripturi

docker ps -q dă ID-urile containerelor pornite, ca să le oprești pe toate dintr-o comandă.

terminalDocker
VerificareSe încarcă...
Mediul de lucru se încarcă. Poți citi lecția între timp.
Parcursul tău Primii pași cu Docker Lecția 5 · Lista containerelor: docker ps
Progres 0% 0 din 17
Lecția curentă 5 / 15 Containere