SSD Nodes Learn Hosting plans →
Mga Gabay Matt ConnorNi Matt Connor

Docker Compose down vs stop: Ano ang Nabubura?

stop ay naghihinto pero nag-iiwan ng containers; down ay nagtatanggal ng containers, writable layers at project network. Named volumes, hindi kasama sa alinman.

Maikling sagot

docker compose stop ang humihinto sa mga container at iniiwan ang mga ito sa disk. docker compose down ang humihinto sa mga container at pagkatapos ay nagtatanggal sa mga container at network na ginawa ng Compose para sa project. Walang named volume na naaapektuhan sa alinmang command. Kapag idinagdag ang -v, gaya ng nasa docker compose down -v, inaalis ang mga non-external named volume na idineklara sa seksyong volumes ng Compose file at kabilang sa project na ito. Ang itinatapon ng down ay anumang isinulat ng container sa sarili nitong writable layer, sa labas ng anumang volume.

Iyan ang buong pagkakaiba sa isang talata. Pinatutunayan ito ng natitirang bahagi ng guide gamit ang Postgres volume na makikitang nananatili pagkatapos ng down at nawawala kapag ginamitan ng down -v. Ipinapaliwanag din nito ang dalawang sitwasyong nangangailangan ng --force-recreate.

docker compose stop: nananatili ang mga container

Ipinapadala ng stop ang naka-configure na stop signal ng container, na SIGTERM bilang default, sa pangunahing proseso ng bawat container. Naghihintay ito, at pagkatapos ay nagpapadala ng SIGKILL kung tumatakbo pa rin ang proseso. 10 segundo ang default na paghihintay, at binabago ito ng -t. Walang dine-delete. Nananatili ang ID ng container, ang writable layer nito, at ang mga log nito.

docker compose stop
docker compose ps -a

Mga tumatakbong container lamang ang ipinapakita ng docker compose ps kapag ginamit nang mag-isa. Kaya pagkatapos ng stop, isang walang-laman na table ang ipinapakita nito at iniisip ng mga tao na nawala na ang mga container. Kasama naman sa ps -a ang mga natigil na container. Doon makikita ang status na Exited katabi ng bawat service, kasama ang exit code na ibinalik ng proseso nito. Madalas ipinapakita ng maayos na shutdown ang Exited (0), pero hindi ito palaging ganoon. May mga server na kumukumpleto ng graceful shutdown at pagkatapos ay muling nagpapasa ng stop signal, kaya nagtatapos ang proseso dahil sa signal na iyon. Ganito mismo ang ginagawa ng Uvicorn, kaya maaari pa ring mag-iwan ng non-zero code ang maayos na paghinto. Maaari ding mangahulugan ang non-zero code na nag-fail ang proseso o pinatay ito matapos ang timeout. Ibalik ang mga ito gamit ang docker compose start. Gagamitin nito muli ang eksaktong parehong mga container.

Dahil umiiral pa rin ang mga container, nananatili roon ang anumang isinulat sa loob ng mga ito na wala sa volume. Kasama rito ang package na mano-mano mong in-install gamit ang docker compose exec, pati ang config file na in-edit mo sa loob ng container. Ito ang praktikal na dahilan kung bakit mas mainam gamitin ang stop habang nagde-debug: maaari kang mag-restart gamit ang parehong state.

docker compose down: inaalis ang containers at networks

down ihihinto ang mga container at pagkatapos ay inaalis ang mga ito, kasama ang default network na ginawa ng Compose para sa project. Inilalarawan ito ng Docker documentation bilang paghinto sa mga container at pag-alis ng mga container, network, volume, at image na ginawa ng up, pero mangyayari lamang ang pag-alis ng volumes at images kapag hiniling mo ito gamit ang -v at --rmi.

docker compose down
docker compose ps -a
docker network ls

Pagkatapos ng down, walang inilalabas na output ang ps -a para sa project at wala na ang <project>_default network. Ang pangalan ng project ay nagmumula sa pangalan ng project directory maliban kung itinakda mo ang name: sa Compose file, itinakda ang COMPOSE_PROJECT_NAME, o ipinasa ang -p. Hindi na mababawi ang anumang pagbabagong ginawa mo sa loob ng writable layer ng container, kaya ituring ang down bilang command na nagtatapon ng container at nagpapanatili lamang ng data na inilagay mo sa volumes.

Kung hindi makahanap ang Compose ng configuration file sa kasalukuyang directory o sa mga parent directory nito, at wala kang ibinigay na file gamit ang -f o COMPOSE_FILE, makakatanggap ka ng no configuration file provided: not found. Hindi alam ng Compose kung aling project ang tinutukoy mo, kaya tumatanggi itong magpatuloy. Gamitin ang docker compose -f /srv/myapp/compose.yaml down kapag wala ka sa project folder.

A docker compose down törli a volume-okat?

Nem. A top-level volumes kulcs alatt deklarált named volume tovább él a down matapos, pati sa container na pinag-attach-an nito. Ito ang pinakakaraniwang pangamba tungkol sa command na ito. Binago ng Compose v5.7.0 ang down -v: nilalaktawan na nito ang mga named volume na pagmamay-ari ng ibang project o ginawa sa labas ng Compose, at nagpapakita ito ng warning.

Mag-set up ng stack na maaari mong gamitin sa test. Ilagay ito sa compose.yaml sa isang walang laman na directory na tinatawag na voltest.

services:
  db:
    image: postgres:16.4
    restart: unless-stopped
    environment:
      POSTGRES_PASSWORD: example
    volumes:
      - pgdata:/var/lib/postgresql/data

volumes:
  pgdata:

Simulan ito at magsulat ng row na makikilala mo mamaya.

docker compose up -d
sleep 10
docker compose exec -T db psql -U postgres -c "create table marker (note text);"
docker compose exec -T db psql -U postgres -c "insert into marker values ('survived');"

Ngayon, burahin ang container at suriin ang volume.

docker compose down
docker volume ls

Nakalista pa rin sa output ang voltest_pgdata. Wala na ang container, pero naroon pa rin ang data. Ibalik ang stack at basahin ang row.

docker compose up -d
sleep 10
docker compose exec -T db psql -U postgres -c "select * from marker;"

Makakakuha ka ng isang row na naglalaman ng survived. Ibang container ang bagong container, na may ibang ID, pero naka-attach ito sa parehong volume. Kung kailangan mo ng mas malawak na paliwanag, tinatalakay sa gabay sa mga pangunahing kaalaman sa Compose ang pagkakaiba ng named volumes at bind mounts, pati kung saan talaga naka-store ang bawat isa sa host.

Ano mismo ang winawasak ng down -v

-v (mahabang anyo: --volumes) ang nag-aalis ng mga non-external named volume na idineklara sa seksyong volumes ng Compose file at kabilang sa project na ito, pati ng mga anonymous volume na naka-attach sa mga container. Sa Compose v5.7.0, nilalaktawan na may warning ang named volume na may ownership label ng ibang project o walang project label. Kung hindi ma-inspect ang ownership nito, magfa-fail ang command at pananatilihin ang volume. Patakbuhin ito laban sa parehong stack.

docker compose down -v
docker volume ls

Hindi na nakalista ang voltest_pgdata. Simulan muli ang stack. Makakakita ang Postgres entrypoint ng walang lamang data directory, kaya mag-i-initialize ito ng bagong cluster. Malinaw itong sinasabi sa container log.

The files belonging to this database system will be owned by user "postgres".
PostgreSQL init process complete; ready for start up.

Kapag nakita mo ang block na iyon sa stack na ilang buwan nang tumatakbo, ibig sabihin ay nag-i-initialize ang Postgres ng walang lamang data directory. Wala na ang table na marker, at backup lang ang paraan para maibalik ito.

May storage na hindi kailanman inaalis ng -v. Host path ang bind mount, kaya ina-unmount lamang ito ng Docker at nananatili ang iyong mga file sa dati nilang lokasyon. Ang volume na may markang external: true ay idineklarang pagmamay-ari ng nasa labas ng project na ito, kaya hindi ito inaalis ng Compose. Ang named volume na tinanggal mo sa Compose file bago patakbuhin ang down -v ay hindi na idineklara. Dahil dito, hindi alam ng Compose na dapat itong alisin, kaya naiiwan ito bilang orphan para sa docker volume prune -a kapag wala nang container na gumagamit dito.

Madalas itong nangyayari kapag may refactor. Alisin ang isang service at ang volume nito sa file, saka patakbuhin ang down -v. Mananatili ang volume dahil hindi na ito binabanggit ng file. Patakbuhin ang down -v bago mo i-edit ang file, hindi pagkatapos.

Kailan talaga kailangan ang --force-recreate

docker compose up -d ay hindi muling binubuo ang lahat sa bawat pagtakbo. Nag-iimbak ang Compose ng hash ng resolved configuration ng bawat service bilang label sa container. Sa Compose v5.7.0, hindi gagalawin ang tumatakbong container kapag nagtutugma ang configuration hash, image ID, at image-volume digest, naroroon ang inaasahang network connections at named volume mounts nito, at walang nire-recreate na parent na nagbabahagi ng namespace o volume. Container voltest-db-1 Running ang makukuha mo sa halip na Recreated. Ito ang karaniwang ninanais na behavior dahil ginagawa nitong ligtas na patakbuhin nang paulit-ulit ang up -d.

Ito rin ang dahilan kung bakit may ilang edit na tila walang epekto. Ang hina-hash ng Compose ay ang resolved service definition, hindi ang laman ng mga file na tinutukoy ng definition. Kapag may config file na naka-mount sa container at isang beses lang binabasa sa startup, hindi ito magti-trigger ng recreate kapag in-edit mo ito dahil hindi nagbago ang mount path. Patuloy na tatakbo ang service gamit ang mga value na nabasa nito noong boot.

docker compose up -d --force-recreate

Hinihinto at inaalis nito ang bawat container, pagkatapos ay gumagawa ng bago mula sa parehong definition. Gamitin ito pagkatapos mag-edit ng naka-mount na config file, at kapag napunta ang isang container sa state na hindi mo maipaliwanag. Hindi ginagalaw ang volumes, kaya mananatili ang database pagkatapos ng force recreate. Para makuha ang mas bagong image gamit ang parehong tag, kailangan mo ring magsagawa ng pull.

docker compose pull
docker compose up -d

Kinukuha ng pull ang bagong image ID, at nakikita naman ng up -d na iba ang image ID nito sa image ID ng tumatakbong container, kaya awtomatiko itong nagre-recreate. Kapag idinagdag ang --force-recreate nang walang pull, gagawa ito ng bagong container mula sa parehong lumang image. Kaya karaniwan ang reklamo na “nag-force recreate ako pero lumang version pa rin ito.”

Wala sa mga prosesong ito ang ginagawa ng docker compose restart. Ni-re-restart lamang nito ang mga kasalukuyang container nang hindi ina-apply ang mga pagbabago sa configuration ng mga ito, kaya hindi maa-apply ang binagong environment variable o port mapping. Kung in-edit mo ang file, gamitin ang up -d.

Ang mental model na dapat tandaan

Napapalitan ang mga container. Ang isang container ay binubuo ng isang process at manipis na writable layer. Maaaring gumawa ang Compose ng kapalit na container mula sa file at image. Hindi napapalitan ang mga volume dahil nasa mga ito ang nag-iisang kopya ng state na hindi kayang muling buuin ng anumang file sa iyong repository.

Nakaayon sa paghahating ito ang bawat Compose verb. Pinananatili ng stop at start ang container. Pinapalitan ng down at up ang container at pinananatili ang volume. Ang down -v lamang ang karaniwang command na nag-aalis ng state, kaya kailangan nito ng explicit na flag. Bago mo ito i-type sa anumang aktuwal na environment, tiyaking mayroon kang backup na na-restore mo nang kahit isang beses.

Ganoon din ang logic para sa mga secret. Ang password na itinakda sa pamamagitan ng POSTGRES_PASSWORD ay ginagamit lamang upang itakda ang database password sa unang pag-initialize ng database. Kaya kung babaguhin mo ito sa iyong environment file at patatakbuhin ang up -d, mananatiling hindi nagbabago ang naka-store na password. Bago ang container, samantalang luma ang volume. Nasa lumang volume pa rin ang lumang password. Ipinapaliwanag ng Paano nireresolba ng Compose ang mga env file at secret kung aling layer ang mananaig kapag dalawang beses itinakda ang parehong variable.

Mga failure mode at mga string na makikita mo

Ang no configuration file provided: not found ay nangangahulugang hindi nakahanap ang Compose ng configuration file sa paghahanap nito sa kasalukuyang directory at mga parent directory, -f, o COMPOSE_FILE. Ipasa ang -f kasama ang buong path.

Ang Network voltest_default Resource is still in use sa down sa Compose v5.7.0 ay nangangahulugang may mga container pang naka-attach sa project network. Karaniwan, ang mga ito ay mga container na wala sa project na ito at manu-manong sinimulan gamit ang docker run --network. Alisin ang mga container na iyon, pagkatapos ay patakbuhin muli ang down.

Lumilitaw ang Found orphan containers (voltest-old-1) for this project kapag nag-rename o nag-delete ka ng service. Inililista ng kasalukuyang Compose ang mga pangalan nang walang karagdagang palatandaan at pinaghihiwalay ang mga ito gamit ang kuwit. Nagpi-print ang mga mas lumang Compose v2 release ng parehong warning, ngunit nasa square brackets ang mga pangalan, gaya ng ([voltest-old-1]). Nananatili sa lumang container ang project label. Tinatanggal ng docker compose down --remove-orphans ang mga ito.

Ang Error response from daemon: remove voltest_pgdata: volume is in use sa manu-manong docker volume rm ay nangangahulugang may container pang gumagamit sa volume, kabilang ang mga stopped container. Patakbuhin muna ang docker compose down, pagkatapos ay alisin ang volume, o gamitin na lang ang down -v. Sa mas malaking project, ipinapakita ng isang multi-service Compose stack kung ilang volume ang maaaring maipon ng isang project.

FAQ

Idedesis ba ng docker compose down ang database ko?

Hindi kung nasa named volume o bind mount ang database. Inaalis ng down ang mga container at project network, habang nananatili sa disk ang volume kasama ang lahat ng data nito. Sa susunod na docker compose up -d, ikinakabit ang bagong container sa parehong volume at naroon pa rin ang data. Inaalis ng docker compose down -v ang mga non-external na named volume na idineklara sa seksyong volumes ng Compose file at kabilang sa project na ito.

Ano ang pagkakaiba ng stop at down para sa container na gusto kong ibalik?

Pinananatili ng stop ang container, kaya ibinabalik ka ng docker compose start sa parehong container at sa parehong writable layer. Nananatili ang anumang mano-mano mong in-install o binago sa loob ng container. Tinatanggal ng down ang container, kaya gumagawa ang susunod na up -d ng bago mula sa image at nawawala ang mga mano-manong pagbabago. Habang nagde-debug ka, gamitin ang stop.

Paano ko aalisin ang lahat ng ginawa ng Compose project?

Inaalis ng docker compose down -v --rmi all --remove-orphans ang mga container, project network, mga non-external na named volume na idineklara sa file at kabilang sa project na ito, mga image na ginamit ng mga service, at mga orphan container ng project. Hindi nito hinahawakan ang mga bind mount o volume na may markang external: true. Suriin muna kung ano ang mawawala gamit ang docker volume ls bago ito patakbuhin.

Bakit hindi nakikita ng container ang pagbabagong ginawa ko sa naka-mount na config file?

Tinutukoy ng Compose kung kailangan nitong gumawa muli ng container sa pamamagitan ng paghahambing ng hash ng resolved service definition. Hindi kasama sa hash na iyon ang nilalaman ng naka-mount na file. Hindi nagbago ang path, kaya hinahayaan ng Compose na tumakbo ang container gamit ang mga value na binasa nito noong startup. Patakbuhin ang docker compose up -d --force-recreate para gumawa ng bagong container na muling magbabasa ng file.

Bakit hindi gumagana ang bago kong POSTGRES_PASSWORD matapos ko itong baguhin?

Ginagamit lang ng Postgres image ang POSTGRES_PASSWORD upang itakda ang database password kapag nag-i-initialize ito ng walang lamang data directory. May initialized cluster na ang volume mo, kaya binabalewala ang variable at ginagamit pa rin ang dating password. Kapag kumonekta ka gamit ang bagong password, makakakuha ka ng password authentication failed for user "postgres". Palitan ang password gamit ang ALTER USER sa loob ng tumatakbong database, o tanggapin ang pagkawala ng data at magsimula muli gamit ang docker compose down -v.

Nakatulong ba ang artikulong ito?