docker images în Docker

docker images [opțiuni] [depozit[:etichetă]]

Ce face docker images

Comanda docker images (echivalentă cu docker image ls) afișează imaginile aflate local pe mașina ta: depozitul (REPOSITORY), eticheta (TAG), ID-ul imaginii, când a fost creată și cât spațiu ocupă.

Aceeași imagine poate apărea pe mai multe rânduri dacă are mai multe etichete; în acest caz coloana IMAGE ID este identică. Imaginile marcate <none> sunt așa-numitele imagini dangling: straturi rămase fără etichetă după o reconstruire, care pot fi șterse în siguranță.

Dimensiunea afișată este cea necomprimată; straturile comune între imagini sunt stocate o singură dată, deci suma coloanei SIZE poate fi mai mare decât spațiul real ocupat pe disc (vezi docker system df).

Opțiuni și argumente

Opțiune / Parametru	Descriere
-a, --all	Afișează și imaginile intermediare.
-q, --quiet	Afișează doar ID-urile imaginilor (util în scripturi).
-f, --filter	Filtrează rezultatele, de exemplu dangling=true sau reference=nginx:*.
--format	Șablon Go pentru ieșire, de exemplu "{{.Repository}}:{{.Tag}} {{.Size}}".
--digests	Afișează și digest-ul fiecărei imagini.
--no-trunc	Afișează ID-urile complete, netrunchiate.

Exemple

Exemplul 1: Lista imaginilor locale

Ieșirea standard, cu un tabel pe coloane.

docker images

Ieșire în terminal

REPOSITORY          TAG         IMAGE ID       CREATED        SIZE
dexblog/api         2.3.1       5c1f0a7e9b42   2 hours ago    187MB
dexblog/api         latest      5c1f0a7e9b42   2 hours ago    187MB
nginx               1.27        3b25b682ea82   3 weeks ago    192MB
python              3.12-slim   e5f0a7c3d1b8   4 weeks ago    124MB
postgres            16          f49abb9855df   5 weeks ago    438MB
<none>              <none>      9a8d7c6b5e4f   2 days ago     187MB

Exemplul 2: Doar imaginile dangling

Filtrul dangling=true găsește imaginile fără etichetă, candidate la ștergere.

docker images -f dangling=true

Ieșire în terminal

REPOSITORY   TAG       IMAGE ID       CREATED      SIZE
<none>       <none>    9a8d7c6b5e4f   2 days ago   187MB

Exemplul 3: Format personalizat

Cu --format obținem o listă compactă, ușor de prelucrat în scripturi.

docker images --format "{{.Repository}}:{{.Tag}}\t{{.Size}}" nginx

Ieșire în terminal

nginx:1.27	192MB

Greșeli frecvente

• Confuzia între imagini și containere: docker images nu arată ce rulează. Pentru containere folosește docker ps.
• Interpretarea sumei coloanei SIZE drept spațiu ocupat pe disc: straturile comune sunt numărate de mai multe ori.

Comenzi înrudite

• docker pull: Descarcă o imagine (sau o anumită etichetă a ei) dintr-un registry, implicit Docker Hub.
• docker rmi: Șterge una sau mai multe imagini locale (sau doar o etichetă a lor).
• docker tag: Adaugă un nume nou (etichetă) unei imagini existente, fără a o copia.
• docker system prune: Verifică spațiul ocupat de Docker (system df) și șterge resursele nefolosite (system prune).