docker compose pull în Docker

Docker Compose Docker Compose v2

Descarcă imaginile tuturor serviciilor din compose.yaml (sau doar ale celor alese), fără să pornească containerele.

Sintaxă comandă
docker compose pull [opțiuni] [serviciu...]

Ce face docker compose pull

docker compose pull descarcă din registru imaginile din câmpurile image:, în paralel. Este primul pas al unei actualizări: descarci noile versiuni cât timp vechile containere încă rulează, apoi docker compose up -d recreează doar serviciile a căror imagine s-a schimbat, cu o întrerupere scurtă.

Pentru serviciile care au doar build:, nu are ce descărca. Cu --ignore-buildable le sari explicit, iar --policy missing descarcă doar imaginile care nu există local.

Parametri

Parametru Descriere
-q, --quiet Nu afișează progresul.
--ignore-buildable Sare peste serviciile care se construiesc local.
--ignore-pull-failures Continuă dacă o imagine nu poate fi descărcată.
--include-deps Descarcă și imaginile serviciilor din depends_on.
--policy missing|always Când se descarcă: doar dacă lipsește sau întotdeauna.

Exemple

Exemplul 1: Actualizarea serviciilor pe server

Descărcăm noile versiuni, apoi recreăm doar ce s-a schimbat și ștergem imaginile vechi rămase fără etichetă.

docker compose pull
docker compose up -d
docker image prune -f

Ieșire în terminal

[+] Pulling 3/3
 ✔ redis Pulled                                                        2.1s
 ✔ db Pulled                                                           3.4s
 ✔ api Pulled                                                          6.8s
[+] Running 3/3
 ✔ Container magazin-redis-1  Running                                  0.0s
 ✔ Container magazin-db-1     Running                                  0.0s
 ✔ Container magazin-api-1    Started                                  1.2s
Total reclaimed space: 182.4MB

Exemplul 2: Doar un serviciu, fără mesaje de progres

Util în scripturi de deploy.

docker compose pull -q api && docker compose up -d api

Ieșire în terminal

[+] Running 1/1
 ✔ Container magazin-api-1  Started                                    1.1s

Greșeli frecvente

  • Folosirea etichetei latest și surpriza că pull aduce o versiune majoră nouă: fixează versiunea (postgres:17, redis:8.2) ca actualizările să fie controlate.
  • Așteptarea ca pull să repornească serviciile: doar descarcă. Containerele folosesc noua imagine abia după docker compose up -d.

Comenzi înrudite

  • docker compose restart / stop / start: Repornește, oprește sau pornește containerele existente ale serviciilor, fără să le recreeze și fără să aplice modificări din compose.yaml.
  • docker compose config: Validează fișierul compose.yaml și afișează configurația finală, după înlocuirea variabilelor și combinarea fișierelor.