Docker konteyneri hemen kapanıyor: nedeni nasıl bulunur ve düzeltilir

Sorun nasıl anlaşılır

• `docker ps` konteyneri göstermiyor, ancak `docker ps -a` onu Exited olarak listeliyor
• Konteyner başlatılıyor ve saniyeler içinde kayboluyor
• Günlüklerde hiçbir şey yok veya yalnızca başlangıçta bir hata mesajı var
• Uygulama yerel olarak çalışıyor, ancak konteynerde hemen çıkıyor
• Çıkış kodu 0, 1, 127 veya 137

En yaygın nedenler

Adım adım çözüm

1. 1

   Durumu ve çıkış kodunu kontrol edin

   Tüm konteynerleri, kapanmış olanlar dahil görmek için docker ps -a çalıştırın. STATUS sütununa ve çıkış koduna dikkat edin. 0 kodu sürecin normal sonlandığını, 1 genel bir hatayı, 127 var olmayan bir komutu, 137 ise genellikle bellek nedeniyle zorla durdurulduğunu gösterir.

2. 2

   Günlükleri inceleyin

   docker logs <ad_veya_id> çalıştırın. Konteyner kapalıysa son yüz satırı görmek için --tail 100 ekleyin. Günlükler genellikle tam nedeni içerir, örneğin yapılandırma hatası veya komutun bulunamadığı mesajı.

3. 3

   Konteyneri etkileşimli olarak başlatın

   Başlatma komutunu atlayıp kabuğa girin: docker run -it --entrypoint /bin/sh <imaj>. İmajda sh yoksa bash deneyin. Konteyner içinde uygulamayı elle çalıştırın ve normalde görmediğiniz hatayı görün.

4. 4

   Komutu ve entrypoint'i kontrol edin

   Dockerfile'a ve docker run komutuna bakın. CMD veya ENTRYPOINT'in doğru biçimde olduğundan ve yürütülebilir dosyanın yolunun var olduğundan emin olun. docker compose kullanıyorsanız docker-compose.yml içindeki command alanını kontrol edin.

5. 5

   Ana sürecin ön planda kaldığından emin olun

   Uygulama arka planda başlatılmamalı veya hemen sonlanmamalıdır. Bir betikse sonuna bir döngü ekleyin veya dinleyen bir sunucu başlatın. Yalnızca etkin kalması gereken konteynerler için geçici çözüm olarak tail -f /dev/null kullanın.

6. 6

   Ortam değişkenlerini ve yapılandırmayı kontrol edin

   docker inspect <konteyner> çıktısını uygulamanın beklediğiyle karşılaştırın. Eksik değişkenleri -e ile veya environment bölümünde ekleyin. Yapılandırma dosyalarının doğru yola bağlandığından da emin olun.

7. 7

   İzinleri ve sahipliği kontrol edin

   Uygulama bir birime veya klasöre yazıyorsa konteyner içindeki kullanıcının izni olduğundan emin olun. docker run komutuna --user ekleyin veya Dockerfile'ı uyarlayın. İzin hataları günlüklerde genellikle Permission denied olarak görülür.

8. 8

   Healthcheck ve bağımlılıkları devre dışı bırakın

   Compose kullanıyorsanız konteynerin tek başına çalışıp çalışmadığını görmek için healthcheck ve depends_on satırlarını geçici olarak yorum satırı yapın. Ardından bunları tek tek geri açın ve davranışı izleyin.

9. 9

   İmajı yeniden oluşturun

   Dockerfile'ı değiştirdiyseniz docker build --no-cache -t <ad> . çalıştırın ve konteyneri yeniden başlatın. Önbelleğe alınmış bir katman, sorunun nedeni olan değişikliği gizleyebilir.

Hiçbir şey yardımcı olmazsa

Tekrarlanmaması için

• Herhangi bir şeyi değiştirmeden önce her zaman `docker logs` ve çıkış kodunu kullanın.
• Dockerfile'da `CMD` veya `ENTRYPOINT`'i açıkça belirtin ve yerel olarak test edin.
• Durdurulmuş konteynerleri, kullanılmayan ağları ve başıboş imajları zaman zaman `docker system prune` komutuyla temizleyin; başlatmadan önce nelerin kaldırılacağını kontrol edin ve önemli verilerin yedeğini alın.
• Sürekli çalışması gereken servisler için Compose dosyasında healthcheck ve `restart: unless-stopped` tanımlayın.

Sık sorulan sorular