docker inspect în Docker

Containere Docker 1.0+

Afișează în format JSON toate detaliile de nivel jos ale unui obiect Docker.

Sintaxă comandă
docker inspect [opțiuni] nume|id [nume|id...]

Ce face docker inspect

Comanda docker inspect afișează configurația completă a unui container, imagini, volum sau rețele, în format JSON: variabile de mediu, montări, adrese IP, politica de repornire, starea healthcheck-ului, codul de ieșire și multe altele.

Ieșirea completă are sute de linii, de aceea se folosește adesea opțiunea --format (șabloane Go) pentru a extrage un singur câmp, de exemplu adresa IP sau starea containerului.

Comenzi specializate precum docker image inspect, docker volume inspect sau docker network inspect fac același lucru, dar restrâng căutarea la un singur tip de obiect.

Opțiuni și argumente

Opțiune / Parametru Descriere
-f, --format Șablon Go pentru extragerea unor câmpuri, de exemplu "{{.State.Status}}".
--type Restrânge căutarea la un tip: container, image, volume, network.
-s, --size Pentru containere, afișează și dimensiunile (SizeRw, SizeRootFs).
{{json .Câmp}} Funcție de șablon care afișează o substructură în format JSON.

Exemple

Exemplul 1: Adresa IP a unui container

Parcurgem rețelele containerului și afișăm adresa din fiecare.

docker inspect -f "{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}" db

Ieșire în terminal

172.18.0.3

Exemplul 2: Starea și codul de ieșire

Util în scripturi de monitorizare.

docker inspect -f "{{.State.Status}} exit={{.State.ExitCode}} restart={{.RestartCount}}" worker

Ieșire în terminal

exited exit=1 restart=0

Exemplul 3: Montările unui container în JSON

Funcția json afișează o substructură întreagă.

docker inspect -f "{{json .Mounts}}" db

Ieșire în terminal

[{"Type":"volume","Name":"pgdata","Source":"/var/lib/docker/volumes/pgdata/_data","Destination":"/var/lib/postgresql/data","Driver":"local","Mode":"z","RW":true,"Propagation":""}]

Greșeli frecvente

  • Folosirea ghilimelelor simple pentru --format în Windows CMD, unde nu sunt recunoscute. Folosește ghilimele duble.
  • Bazarea pe adresele IP interne ale containerelor: se pot schimba la recreare. Containerele din aceeași rețea definită de utilizator se pot găsi după nume.

Comenzi înrudite

  • docker ps: Listează containerele care rulează (sau toate, cu -a).
  • docker network: Gestionează rețelele virtuale prin care containerele comunică între ele și cu exteriorul.
  • docker volume: Creează, listează, inspectează și șterge volume gestionate de Docker pentru date persistente.
  • docker stats: Afișează în timp real consumul de CPU, memorie, rețea și disc al containerelor.