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
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.
Î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.
Soluția exercițiului
docker ps docker ps -a
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:
| Coloana | Ce înseamnă |
|---|---|
| CONTAINER ID | primele 12 caractere din ID-ul unic al containerului; poți folosi ID-ul în comenzi |
| IMAGE | imaginea din care a pornit containerul |
| COMMAND | comanda care rulează (sau a rulat) în container, scurtată cu … dacă e lungă |
| CREATED | când a fost creat containerul |
| STATUS | Up 5 seconds = pornit de 5 secunde; Exited (0) 3 seconds ago = oprit, cu codul de ieșire 0 |
| PORTS | porturile containerului (nginx ascultă pe 80/tcp; în lecția 9 le faci accesibile din browser) |
| NAMES | numele containerului; dacă nu dai tu unul, Docker generează unul amuzant, ca angry_bohr |
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
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)?
Primul lucru verificat de un programator: docker ps. Dacă serverul nu apare, s-a oprit și trebuie aflat de ce.
docker ps -a arată zecile de containere de test rămase după o zi de lucru.
docker ps -q dă ID-urile containerelor pornite, ca să le oprești pe toate dintr-o comandă.
