Ce face docker search
docker search interoghează Docker Hub și afișează numele imaginilor, descrierea, numărul de stele și dacă imaginea este oficială ([OK] în coloana OFFICIAL). Implicit afișează cel mult 25 de rezultate.
Comanda nu arată etichetele (versiunile) disponibile ale unei imagini și nici mărimea; pentru acestea folosește pagina imaginii de pe Docker Hub sau docker buildx imagetools inspect. Preferă imaginile oficiale sau pe cele publicate de producătorul programului.
Parametri
| Parametru | Descriere |
|---|---|
-f, --filter is-official=true |
Doar imagini oficiale. |
-f, --filter stars=N |
Doar imagini cu cel puțin N stele. |
--limit N |
Numărul maxim de rezultate (implicit 25, maxim 100). |
--no-trunc |
Nu scurta descrierile. |
--format |
Șablon Go, de exemplu '{{.Name}}: {{.StarCount}}'. |
Exemple
Exemplul 1: Doar imaginea oficială PostgreSQL
Filtrul elimină sutele de imagini neoficiale cu nume asemănătoare.
docker search --filter is-official=true postgres
Ieșire în terminal
NAME DESCRIPTION STARS OFFICIAL
postgres The PostgreSQL object-relational database sy… 14512 [OK]
Exemplul 2: Primele rezultate, cu format propriu
Afișăm doar numele și stelele pentru primele trei rezultate.
docker search --limit 3 --format '{{.Name}}\t{{.StarCount}}\t{{.IsOfficial}}' redis
Ieșire în terminal
redis 13245 true
redis/redis-stack 132 false
redis/redis-stack-server 89 false
Greșeli frecvente
- Alegerea unei imagini doar după numărul de stele: verifică editorul, data ultimei actualizări și Dockerfile-ul. Imaginile neoficiale pot conține programe vechi sau rău intenționate.
- Căutarea versiunilor cu
docker search redis:8: comanda nu caută etichete. Versiunile se văd pe Docker Hub.
Comenzi înrudite
docker history: Afișează straturile unei imagini, cu instrucțiunea Dockerfile care a creat fiecare strat și mărimea lui.docker manifest: Inspectează și creează liste de manifeste: o singură etichetă de imagine pentru mai multe arhitecturi (amd64, arm64).