Docker Compose stop ve down arasındaki fark nedir?
Docker Compose stop komutu container yapısını korurken down komutu container ve ağları siler. Veri kaybını önlemek için volume silme farklarını ve -v bayrağını öğrenin.
Kısa cevap
docker compose stop komutu container'ları durdurur ancak diskte tutar. docker compose down komutu ise container'ları durdurur, ardından container'ları ve Compose'un proje için oluşturduğu ağı siler. Her iki komut da isimlendirilmiş volume'lara dokunmaz. docker compose down -v komutunda olduğu gibi -v bayrağını eklemek, Compose dosyasının volumes bölümünde tanımlanan ve bu projeye ait olan, external olmayan isimlendirilmiş volume'ları kaldırır. down komutunun sildiği veriler, bir container'ın herhangi bir volume dışında, kendi yazılabilir katmanına yazdığı verilerdir; ayrıca container'ları ve proje ağını da siler.
Tüm fark tek bir paragrafta bu şekildedir. Bu kılavuzun geri kalanı, bir down işleminden sağ çıkan ancak bir down -v işlemiyle silinen bir Postgres volume'u ile bunu kanıtlar ve --force-recreate komutuna ihtiyaç duyacağınız iki durumu açıklar.
docker compose stop: containerlar kalıcıdır
stop, her container içindeki ana sürece varsayılan olarak SIGTERM olan yapılandırılmış durdurma sinyalini gönderir, bekler ve süreç hala canlıysa SIGKILL sinyalini iletir. Varsayılan bekleme süresi 10 saniyedir ve -t ile bu süre değiştirilebilir. Hiçbir şey silinmez. Container; ID bilgisini, yazılabilir katmanını ve loglarını korur.
docker compose stop
docker compose ps -adocker compose ps tek başına kullanıldığında yalnızca çalışan containerları gösterir; bu nedenle stop komutundan sonra boş bir tablo çıktısı verir ve kullanıcılar containerların silindiğini düşünebilir. ps -a komutu durdurulmuş olanları da listeler; burada her servisin yanında, sürecin döndürdüğü çıkış koduyla birlikte Exited durumunu görebilirsiniz. Temiz bir kapatma işlemi genellikle Exited (0) kodunu gösterir ancak bu her zaman geçerli değildir. Bazı sunucular düzgün bir kapatma işlemini tamamladıktan sonra durdurma sinyalini tekrar tetikler, böylece süreç bu sinyalle sonlanır; Uvicorn tam olarak bunu yapar, bu yüzden düzenli bir durdurma işlemi bile sıfır olmayan bir kod döndürebilir. Sıfır olmayan bir kod, sürecin başarısız olduğu veya zaman aşımından sonra öldürüldüğü anlamına da gelebilir. Containerları, aynı containerları yeniden kullanan docker compose start komutuyla tekrar başlatabilirsiniz.
Containerlar varlığını koruduğu için, volume dışında içlerine yazılan her şey orada kalmaya devam eder. Buna docker compose exec ile manuel olarak yüklediğiniz bir paket veya container içinde düzenlediğiniz bir yapılandırma dosyası da dahildir. Hata ayıklama yaparken stop komutunu tercih etmenin pratik nedeni budur: aynı duruma geri dönebilirsiniz.
docker compose down: konteynerler ve ağlar kaldırılır
down komutu, konteynerleri durdurur ve ardından proje için oluşturulan varsayılan ağ ile birlikte bunları kaldırır. Docker belgeleri bu işlemi, up tarafından oluşturulan konteynerlerin, ağların, birimlerin (volumes) ve imajların durdurulması ve kaldırılması olarak tanımlar; ancak birimler ve imajlar yalnızca -v ve --rmi bayrakları ile talep edildiğinde kaldırılır.
docker compose down
docker compose ps -a
docker network lsdown komutundan sonra ps -a, proje için herhangi bir çıktı vermez ve <project>_default ağı silinmiş olur. Proje ismi, Compose dosyasında name: tanımlanmadığı, COMPOSE_PROJECT_NAME ayarlanmadığı veya -p parametresi geçilmediği sürece proje dizininin adından türetilir. Konteynerin yazılabilir katmanında yapılan her değişiklik artık geri alınamaz; bu nedenle down komutunu, konteyneri silen ancak birimlerdeki verileri koruyan bir işlem olarak değerlendirin.
Compose, mevcut dizinde veya üst dizinlerinde bir yapılandırma dosyası bulamazsa ve siz -f veya COMPOSE_FILE aracılığıyla bir dosya sağlamadıysanız, no configuration file provided: not found hatası alırsınız. Compose hangi projeyi kastettiğinizi bilemediği için işlemi reddeder. Proje klasöründe olmadığınız durumlarda docker compose -f /srv/myapp/compose.yaml down parametresini kullanın.
docker compose down komutu volume verilerimi siler mi?
Hayır. En üst düzey volumes anahtarı altında tanımlanan adlandırılmış bir volume, down komutundan ve bağlı olduğu container'dan daha uzun ömürlüdür. Bu, söz konusu komutla ilgili en yaygın endişedir. Compose v5.7.0 sürümü ile down -v davranışında değişiklik yapılmıştır: artık başka bir projeye ait olan veya Compose dışında oluşturulmuş adlandırılmış volume'leri bir uyarı vererek atlar.
Test edebileceğiniz bir stack hazırlayın. Bunu voltest adlı boş bir dizin içerisinde compose.yaml dosyasına yerleştirin.
services:
db:
image: postgres:16.4
restart: unless-stopped
environment:
POSTGRES_PASSWORD: example
volumes:
- pgdata:/var/lib/postgresql/data
volumes:
pgdata:Stack'i başlatın ve daha sonra tanıyabileceğiniz bir satır yazın.
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');"Şimdi container'ı yok edin ve volume'ü kontrol edin.
docker compose down
docker volume lsÇıktı hala voltest_pgdata öğesini listeler. Container silinmiştir ancak veriler durmaktadır. Stack'i tekrar ayağa kaldırın ve satırı okuyun.
docker compose up -d
sleep 10
docker compose exec -T db psql -U postgres -c "select * from marker;"survived içeren bir satır elde edersiniz. Yeni container, farklı bir ID'ye sahip farklı bir container'dır ancak aynı volume'e bağlıdır. Daha geniş bir perspektif isterseniz, Compose temel rehberi, adlandırılmış volume'leri bind mount'lar ile karşılaştırır ve her birinin ana makinede (host) tam olarak nerede bulunduğunu açıklar.
docker compose down -v komutu tam olarak neleri siler
-v (uzun haliyle --volumes), Compose dosyasının volumes bölümünde tanımlanmış, bu projeye ait olan ve harici olmayan adlandırılmış birimleri (named volumes) ve konteynerlere bağlı anonim birimleri kaldırır. Compose v5.7.0 sürümünde, başka bir projenin sahiplik etiketine sahip veya hiçbir proje etiketi bulunmayan adlandırılmış birimler bir uyarı ile atlanır; eğer sahiplik bilgisi denetlenemezse komut başarısız olur ve birimi olduğu gibi bırakır. Komutu aynı yığın (stack) üzerinde çalıştırın.
docker compose down -v
docker volume lsvoltest_pgdata artık listelenmez. Yığını tekrar başlattığınızda, Postgres giriş noktası (entrypoint) boş bir veri dizini bulur ve yeni bir küme (cluster) başlatır. Konteyner günlüğü bunu açıkça belirtir.
The files belonging to this database system will be owned by user "postgres".
PostgreSQL init process complete; ready for start up.Aylardır çalışan bir yığında bu bloğu görmek, Postgres'in boş bir veri dizinini başlattığı anlamına gelir. marker tablonuz silinmiştir ve geri dönmenin tek yolu bir yedek dosyasıdır.
Bazı depolama alanları -v ile asla silinmez. Bind mount bir ana makine yolu olduğundan, Docker sadece bağlantıyı keser ve dosyalarınız olduğu yerde kalır. external: true olarak işaretlenmiş bir birim, bu projenin dışında bir yere ait olarak tanımlanmıştır ve Compose bunu asla kaldırmaz. down -v komutunu çalıştırmadan önce Compose dosyasından sildiğiniz adlandırılmış bir birim artık tanımlı değildir; bu nedenle Compose onu kaldırması gerektiğini bilmez ve hiçbir konteyner tarafından referans verilmediğinde docker volume prune -a için bir yetim (orphan) olarak geride kalır.
Bu son durum, yeniden yapılandırma (refactor) sırasında kullanıcıların sıkça karşılaştığı bir sorundur. Bir servisi ve birimini dosyadan kaldırdığınızda, down -v komutunu çalıştırırsanız, dosya artık o birimden bahsetmediği için birim varlığını sürdürür. down -v komutunu dosyayı düzenledikten sonra değil, önce çalıştırın.
--force-recreate komutuna gerçekten ihtiyaç duyduğunuz durumlar
docker compose up -d her seferinde her şeyi yeniden oluşturmaz. Compose, her servisin çözümlenmiş yapılandırmasının bir özetini (hash) etiket olarak container üzerinde saklar. Compose v5.7.0 sürümünde, yapılandırma özeti, image ID ve image-volume özeti eşleştiğinde, beklenen ağ bağlantıları ve adlandırılmış volume mount'ları mevcut olduğunda ve herhangi bir namespace veya volume paylaşımı yapan üst öğe yeniden oluşturulmadığında, çalışan container'a dokunulmaz. Recreated yerine Container voltest-db-1 Running alırsınız. Bu, neredeyse her zaman istediğiniz davranıştır çünkü up -d komutunun tekrar tekrar çalıştırılmasını güvenli kılar.
Bazı düzenlemelerin hiçbir işe yaramıyor gibi görünmesinin nedeni de budur. Compose, tanımın işaret ettiği dosyaların içeriğini değil, çözümlenmiş servis tanımının özetini alır. Container içine mount edilen ve başlangıçta bir kez okunan bir yapılandırma dosyası, düzenlediğinizde yeniden oluşturmayı tetiklemez; çünkü mount yolu değişmemiştir. Servis, açılışta okuduğu değerlerle çalışmaya devam eder.
docker compose up -d --force-recreateBu komut, her container'ı durdurup kaldırır ve aynı tanımdan yeni bir tane oluşturur. Mount edilmiş bir yapılandırma dosyasında değişiklik yaptıktan sonra ve bir container açıklayamadığınız bir duruma sürüklendiğinde bu komutu kullanın. Volume'lar etkilenmez, bu nedenle bir veritabanı, zorunlu yeniden oluşturma (force recreate) işleminden sonra varlığını korur. Aynı etiket (tag) üzerinde daha yeni bir image'ı kullanmak için çekme (pull) işlemini de yapmanız gerekir.
docker compose pull
docker compose up -dpull yeni image ID'sini getirir ve up -d, çalışan container'dan farklı bir image ID görerek onu kendiliğinden yeniden oluşturur. pull olmadan --force-recreate eklemek, size aynı eski image'dan yeni bir container verir. "Zorunlu yeniden oluşturdum ama hala eski sürüm" şikayetinin bu kadar yaygın olmasının nedeni budur.
docker compose restart bunların hiçbirini yapmaz. Mevcut container'ları yapılandırmalarındaki değişiklikleri uygulamadan yeniden başlatır; bu nedenle değiştirilmiş bir ortam değişkeni veya değiştirilmiş bir port eşlemesi uygulanmaz. Dosyayı düzenlediyseniz up -d kullanın.
Akılda tutulması gereken zihinsel model
Konteynerler değiştirilebilir yapılardır. Bir konteyner, bir süreç ve ince bir yazılabilir katmandan oluşur; Compose, dosya ve imajı kullanarak bunun bir yedeğini oluşturabilir. Volume'lar ise değiştirilemez; çünkü deponuzdaki hiçbir dosyanın yeniden oluşturamayacağı tek durum kopyasını barındırırlar.
Her Compose fiili bu ayrım ile uyumludur. stop ve start konteyneri korur. down ve up konteyneri değiştirir ancak volume'u korur. down -v, durumu silen tek rutin komuttur; bu nedenle açık bir bayrağa ihtiyaç duyar. Gerçek bir sistemde bu komutu çalıştırmadan önce, en az bir kez geri yüklemesini yaptığınız bir yedeğinizin olduğundan emin olun.
Aynı mantık sırlar için de geçerlidir. POSTGRES_PASSWORD aracılığıyla ayarlanan bir parola, yalnızca veritabanı ilk kez başlatıldığında veritabanı parolasını belirlemek için kullanılır; bu nedenle ortam dosyanızda bunu değiştirmek ve up -d çalıştırmak, kayıtlı parolayı değiştirmez. Konteyner yenidir ancak volume eskidir ve eski volume hala eski parolayı tutmaktadır. Compose'un ortam dosyalarını ve sırları nasıl çözümlediği konusu, aynı değişken iki kez ayarlandığında hangi katmanın geçerli olacağını açıklar.
Hata modları ve karşılaşacağınız dizgeler
no configuration file provided: not found, Compose'un mevcut dizin ve üst dizin araması, -f veya COMPOSE_FILE üzerinden bir yapılandırma dosyası bulamadığı anlamına gelir. -f bayrağını tam dosya yolu ile birlikte kullanın.
Compose v5.7.0 sürümünde down üzerinde alınan Network voltest_default Resource is still in use hatası, konteynerlerin proje ağına hâlâ bağlı olduğunu gösterir; bu durum genellikle docker run --network ile manuel olarak başlatılan ve bu projeye dahil olmayan konteynerlerden kaynaklanır. Söz konusu konteynerleri kaldırın ve ardından down komutunu tekrar çalıştırın.
Found orphan containers (voltest-old-1) for this project, bir servisi yeniden adlandırdıktan veya sildikten sonra görünür. Güncel Compose, servis isimlerini virgülle ayrılmış şekilde listeler. Daha eski Compose v2 sürümleri, aynı uyarıyı ([voltest-old-1]) örneğinde olduğu gibi köşeli parantez içinde verir. Eski konteyner, proje etiketini taşımaya devam etmektedir. docker compose down --remove-orphans bu etiketleri temizler.
Manuel bir docker volume rm işlemi sırasında alınan Error response from daemon: remove voltest_pgdata: volume is in use hatası, durdurulmuş olanlar da dahil olmak üzere herhangi bir konteynerin ilgili birime (volume) hâlâ referans verdiğini belirtir. Önce docker compose down komutunu çalıştırıp ardından birimi kaldırın veya doğrudan down -v komutunu kullanın. Daha büyük projelerde, çok servisli bir Compose yığını, tek bir projenin ne kadar çok birim biriktirebileceğini gösterir.
FAQ
docker compose down komutu veritabanımı siler mi?
Veritabanı adlandırılmış bir volume veya bind mount içerisinde tutuluyorsa silinmez. down komutu container'ları ve proje ağını kaldırır, ancak volume verileriyle birlikte diskte kalmaya devam eder. Bir sonraki docker compose up -d komutu, yeni bir container'ı aynı volume'a bağlar ve verileriniz korunmuş olur. docker compose down -v komutu, Compose dosyasının volumes bölümünde tanımlanan ve bu projeye ait olan, external olarak işaretlenmemiş adlandırılmış volume'ları siler.
Geri dönmek istediğim bir container için stop ve down arasındaki fark nedir?
stop komutu container'ı korur, bu nedenle docker compose start komutu sizi aynı yazılabilir katmana sahip aynı container'a döndürür. Container içerisinde elle kurduğunuz veya düzenlediğiniz her şey yerinde kalır. down komutu container'ı siler, bu nedenle bir sonraki up -d komutu image üzerinden yeni bir tane oluşturur ve manuel değişiklikleriniz kaybolur. Hata ayıklama yaparken stop kullanın.
Bir Compose projesinin oluşturduğu her şeyi nasıl kaldırırım?
docker compose down -v --rmi all --remove-orphans komutu container'ları, proje ağını, dosyada tanımlanan ve bu projeye ait olan external olmayan adlandırılmış volume'ları, servislerin kullandığı image'ları ve projeye ait yetim (orphan) container'ları kaldırır. Bind mount'lara veya external: true olarak işaretlenmiş volume'lara dokunmaz. Komutu çalıştırmadan önce neleri kaybedeceğinizi görmek için docker volume ls komutunu kullanın.
Container'ım mount edilen yapılandırma dosyasında yaptığım değişikliği neden görmezden geliyor?
Compose, bir container'ın yeniden oluşturulup oluşturulmayacağına çözümlenmiş servis tanımının hash değerini karşılaştırarak karar verir; bu hash değeri mount edilen dosyanın içeriğini içermez. Dosya yolu değişmediği için Compose, container'ı başlangıçta okuduğu değerlerle çalıştırmaya devam eder. Dosyayı yeniden okuyacak yeni bir container oluşturmak için docker compose up -d --force-recreate komutunu çalıştırın.
POSTGRES_PASSWORD değerini değiştirdikten sonra neden çalışmıyor?
Postgres image'ı, POSTGRES_PASSWORD değişkenini yalnızca boş bir veri dizinini başlatırken veritabanı parolasını ayarlamak için kullanır. Volume'unuz halihazırda başlatılmış bir küme içerdiğinden, değişken göz ardı edilir ve eski parola geçerliliğini korur. Yeni parola ile bağlanmaya çalışmak password authentication failed for user "postgres" hatasına yol açar. Parolayı çalışan veritabanı içerisinde ALTER USER ile değiştirin veya verilerin silinmesini göze alarak docker compose down -v ile baştan başlayın.