Docker Compose, uygulamayı veritabanından önce başlatıyor: Bu hatayı nasıl önleyebiliriz?

Docker Compose ile çalışırken en sinir bozucu sorunlardan biri, bir projeyi başlattığınızda ve uygulama veritabanına bağlanmaya çalıştığında ortaya çıkar. hazır olmadan önceBu karmaşanın içinde mi kaldınız? Docker Compose'un uygulamayı veritabanından önce başlattığı durumlarda ne yapmanız gerektiğini açıklayacağız: çözüm göründüğünden daha basit.

Docker Compose neden veritabanından önce uygulamayı başlatır?

Öncelikle Docker Compose'un neden veritabanından önce uygulamayı başlattığını anlayarak başlayalım. Tipik bir projede, Web uygulamasının bir veritabanına bağlanması gerekiyor. MySQL, PostgreSQL veya MariaDB gibi veritabanı servisleri kullanılır. Genellikle her iki servis de ayrı konteynerlerde çalışır ve bir yapılandırma dosyası aracılığıyla koordine edilir. compose.yaml o docker-compose.yml.

Ancak sorun başlatma sırasında ortaya çıkıyor. Docker Compose önce veritabanı konteynerini, ardından uygulama konteynerini başlatabilir (depends_onAncak, bu Bu, veritabanı motorunun başlatma işleminin tamamlandığını garanti etmez.Örneğin, MySQL'in dahili dosyalarını hazırlaması, sistem tablolarını oluşturması, yapılandırmaları uygulaması ve bağlantıları etkinleştirmesi birkaç saniye sürebilir.

Bu arada, uygulama zaten çalışıyor ve sunucuya erişmeye çalışıyor. Ancak, bu Henüz bağlantı almaya hazır değil.Uygulama aşağıdaki gibi hataları kaydeder: bağlantı reddedildi, Sunucuya bağlanılamadı. o Veritabanı kullanılamıyor.Bir kesinti meydana gelirse de aynı durum geçerlidir. Konteynerleri yeniden başlatıyorsunuz.Uygulama çok erken yeniden bağlantı kurmaya çalışıyor olabilir.

Burada iki farklı kavramı birbirinden ayırmamız gerekiyor: kapların başlangıç ​​sırası ve hizmetlerin fiili kullanılabilirliğiSunucu senkronize olurken, uygulama anında başlar ve bağlanmaya çalışır. Ancak, yeniden deneme mantığı yoksa, sonunda çöker ve ancak ikinci bir manuel bağlantı denemesiyle yeniden çalışmaya başlar.docker compose restart appElbette: ikinci denemede veritabanı bir süredir çalışıyor ve hazır durumda.

Docker Compose, uygulamayı veritabanından önce başlatıyor: Bu hatayı nasıl önleyebiliriz?

Özetle, Compose, kapsayıcıları belirtilen sırayla başlatır. depends_onAncak konteynerin hazır olmasını beklemez, sadece çalışır durumda olmasını bekler. `depends_on`'un kısa formu (hizmetlerin basit listesi) yalnızca oluşturulma sırasını garanti eder, bağımlı hizmetin kullanılabilirliğini değil. Çözüm? gerçekten senkronize etmekUzun halini kullanmanız gerekiyor. condition ve veritabanı tarafında, bir healthcheck Bu, "sağlıklı olmak"ın ne anlama geldiğini tanımlar.

Hangi resmi olarak Bunu, Docker Compose uygulamayı veritabanına ihtiyaç duymadan önce başlattığında yapmanız önerilir. iki unsurİlk olarak, bir healthcheck Veritabanı servisinde, gerçek bir teşhis komutu yürütülür. Örneğin, PostgreSQL için standart şöyledir: pg_isreadyBu, sunucunun bağlantıları kabul edip etmediğini kontrol eder.

İkinci olarak, uygulamanın hizmet tarafında, bir depends_on ile condition: service_healthyBu, Compose'a uygulama kapsayıcısını oluşturmaması gerektiğini söyler. healthcheck Veritabanında meydana gelen olay. Ardından, bir compose.yaml PostgreSQL için minimal ve işlevsel Şöyle görünürdü:

Hizmetler: db: imaj: postgres:16-alpine ortam: POSTGRES_USER: uygulama POSTGRES_PASSWORD: gizli POSTGRES_DB: uygulama sağlık kontrolü: test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"] aralık: 5s zaman aşımı: 5s yeniden deneme: 10 başlangıç ​​süresi: 30s birimler: - pgdata:/var/lib/postgresql/data uygulama: derleme: . bağımlılıklar: db: koşul: hizmet_sağlıklı yeniden başlatma: doğru birimler: pgdata:

Veritabanını ve uygulamayı doğru şekilde yapılandırın.

Yukarıdaki yapılandırma, Docker Compose'un uygulamayı veritabanından önce başlatması durumunda ortaya çıkan hatayı düzeltir. Kodun ardındaki mantığı anlamak için dikkatlice incelenmesi gereken üç ayrıntı kilit noktayı oluşturmaktadır. Birincisi şudur: çift ​​dolar ($$) içinde healthcheck.

Bildiğiniz gibi, Compose komutu konteynere iletmeden önce ana bilgisayarın ortam değişkenlerini yorumlar. Eğer şunu yazarsanız... $${POSTGRES_USER}Compose kelimesi kelimesine aynı kalır. $${POSTGRES_USER} y Konteynerin içindeki kabuk, onu kendi değişkeniyle genişletir.Ama, eğer yazarsanız ${POSTGRES_USER}Compose, sunucuda bu dosyayı değiştirmeye çalışacak ve eğer dosya mevcut değilse, komut boş bir değerle çalıştırılacaktır. healthcheck Bu her zaman başarısız olacaktır.

İkinci ayrıntıyı ise şöyle görüyorsunuz: Değere 30 saniye ayrıldı. start_periodBu, PostgreSQL'e başlatma için verdiğiniz süredir ve yeni bir disk biriminde bu işlem oldukça uzun sürebilir. Bu süre zarfında, sağlık kontrolü hataları sınıra dahil edilmez. retriesAma, olmadan start_period, A retries: 5 ile interval: 5s veritabanını şu şekilde işaretleyebilir unhealthy Önyükleme işlemi tamamlanmadan önce Compose, uygulamanın başlatılmasını iptal edecektir.

Ve eğer Docker Compose uygulamayı veritabanından önce başlatıyorsa, başarısızlığı önlemek için üçüncü unsur değerdir. restart: true Bağımlılıkta. Bu seçenek olmadan, hizmeti yeniden başlattığınızda db ile docker compose restart dbUygulama otomatik olarak yeniden başlatılmıyor ve bağlantı kesintileri yaşanabiliyor. Ancak, restart: true, Compose ayrıca bağımlı hizmetleri de yeniden başlatır. Bağımlı oldukları hizmet, onların yönetimi altında güncellendiğinde veya yeniden başlatıldığında.

Docker Compose, uygulamayı veritabanından önce başlatır: çözümün çalıştığını doğrulayın.

Compose dosyasını değiştirdikten sonra aşağıdaki adımları izlemeniz önerilir: Yapılandırmanın geçerli olduğunu ve hizmetlerin beklendiği gibi çalıştığını doğrulayın.Önce koşun. docker compose config Oluşturulan yapılandırmayı doğrulamak ve görüntülemek için kullanılır. Bu, özellikle sözdizimi hatalarını ve ortam değişkenleriyle ilgili sorunları tespit etmek için kullanışlıdır.

Ardından, aşağıdaki hizmetleri başlatın: docker compose up -d –build ve, için kapların durumunu kontrol edin, kullanır docker compose psAyrıca, veritabanındaki mesajları sorgulamanız gerekiyorsa, şu komutu çalıştırın: docker compose logs -f dbUygulama hatalarını kontrol etmek için ise şunu kullanın: docker compose logs -f web.

Son olarak, veritabanı şu şekilde görünüyorsa: healthyAncak uygulama hala bağlanmıyor. Ana bilgisayar adını, kimlik bilgilerini, dahili bağlantı noktasını ve kullanıcı izinlerini kontrol edin.Bu sayede, Docker Compose'un uygulamayı veritabanından önce başlatmasından kaynaklanan sıkıntıyı artık yaşamayacaksınız.

Sonuç: Veritabanı hazır olana kadar bekleyin.

Docker Compose, veritabanı hazır olmadan önce uygulamayı başlattığında, sorun her zaman başlatma sırası değildir. Çoğu durumda, asıl sorun veritabanı konteynerinin zaten çalışıyor olmasıdır, ancak Henüz bağlantı kabul etmiyor..

Bunu önlemek için şunu kullanın: depends_on ile condition: service_healthy ve yapılandırın healthcheck MySQL, PostgreSQL veya kullandığınız veritabanı motoru için uygundur. Bu önlemleri aşağıdakilerle tamamlayın. bağlantı yeniden denemeleri Önyükleme sonrası kesintileri desteklemek için uygulamada.