Docker’da Healthcheck Komutları Nasıl Oluşturulur?
Bir Docker konteyneri çalışır görünebilir ancak uygulama arka planda aslında yanıt vermiyor olabilir. Port kapanabilir, süreç takılabilir veya veritabanı bağlantısı kesilebilir. Healthcheck, bu tür sessiz hataları otomatik olarak tespit etmek için kullanılır. Bu mekanizmanın doğru işlemesi ise uygulama içinde hazırlanan hafif bir health endpoint’e bağlıdır. Çünkü sistemin gerçek durumunu en net şekilde gösteren yer bu küçük kontrol noktasıdır.
Docker İçin HEALTHCHECK Komutu Nasıl Oluşturulur?
Dockerfile içine bir healthcheck eklemek için önce temel yapıyı oluşturalım. Örnek olarak Node.js tabanlı bir uygulamamız olduğunu varsayalım. İlk adımda Dockerfile’ı açıp ilgili bölümleri düzenleyelim ve ekleyelim.
FROM node:18-alpine
WORKDIR /app
COPY . .
RUN npm install
# Buraya healthcheck ekleyeceğizŞimdi healthcheck’i ekleyelim
HEALTHCHECK --interval=20s --timeout=5s --retries=3 \
CMD wget -qO- http://localhost:3000/health || exit 1Bu şekilde uygulamanın /health endpoint’ine her 20 saniyede bir istek göndermiş oluyoruz. Yanıt 5 saniyelik süre içinde gelmezse kontrol başarısız kabul ediliyor. Bu durum art arda 3 kez yaşanırsa Docker konteyneri unhealthy olarak işaretliyor.
Healthcheck Parametreleri Ne İşe Yarar?
Healthcheck’i doğru kurgulamak için kullanılan parametrelerin ne işe yaradığını şöyle özetleyelim.
–health-cmd
Konteynerin durumunu test etmek için çalıştırılacak komutu belirtir. Bu komutun döndürdüğü sonuç sağlık bilgisini belirler.
–health-interval
Kontrolün hangi periyotlarla yapılacağını ifade eder. Örneğin 5 saniyelik bir değer, testin her beş saniyede bir tekrar edeceği anlamına gelir.
–health-retries
Bir kontrol başarısız olduğunda kaç kez daha tekrar test yapılacağını belirler. Bu sayı aşılırsa konteyner sağlıksız kabul edilir.
–health-start-interval
Konteyner çalışır çalışmaz sağlık kontrolünü hemen başlatmak yerine belirli bir süre beklemesini sağlar. Özellikle açılış süresi uzun olan uygulamalarda başlangıç hatalarını engeller.
–health-start-period
Uygulamanın başlangıç aşamasında yapılacak kontrollerin daha toleranslı olmasını sağlar. Başlangıç evresinde meydana gelen hataların yok sayılmasına yardımcı olur.
–health-timeout
Çalıştırılan sağlık komutunun en geç ne kadar süre içinde yanıt vermesi gerektiğini belirler. Süre aşılırsa kontrol otomatik olarak başarısız sayılır.
–no-healthcheck
Bu seçenek kullanıldığında konteyner için sağlık testi tamamen devre dışı bırakılmış olur.
Terminalde Sağlık Durumunu Kontrol Edelim
Konteyneri çalıştırdıktan sonra terminalde durumunu görebiliriz.
docker psSTATUS kısmında şöyle bir şey görebiliriz
healthy (2s ago)Daha detay görmek istersek eğer
docker inspect <container-id>Burada son healthcheck log’larını dakikası dakikasına görürsün. Uygulama nerede takılmış, komut ne cevap vermiş, prolemin sebebi timeout hatası mı hepsi burada gözükür.
Health Endpoint Yoksa Nasıl Kontrol Yapılır?
Her projede /health endpoint’i olmayabilir. Bu tür durumlarda servisin portunu gerçekten dinleyip dinlemediğini basit bir komutla kontrol edebiliriz.
HEALTHCHECK CMD curl --fail http://localhost:8080 || exit 1Ya da port seviyesinde minimal bir kontrol yapmak istersek
HEALTHCHECK CMD nc -z localhost 8080 || exit 1Buradaki amaç, servisin yalnızca “ayakta durup durmadığını” değil, gerçekten erişilebilir olup olmadığını test etmektir.
Healthcheck testlerinin sağlıklı sonuç verebilmesi için container’ın doğru network üzerinde konumlandırılması da önemli.
Docker ağ sürücüleri ve özel ağ tanımlarıyla ilgili daha detaylı bir inceleme istersen, Docker Ağ Sürücüleri ve Özel Ağ Kurulumu yazısına da göz atabilirsin.
Healthcheck Yazarken Karşılaşılan Sorunlar
Healthcheck mantığı basit görünse de yanlış kurgulandığında sistemi gereksiz yere yorabilir. Mesela healthcheck içine büyük bir database sorgusu koyarsak, her 10 saniyede bir konteyneri kendi testinle boğmaya başlarız. Bunun yerine çok hafif bir kontrol mekanizması kullanılıyor olması gerekir. Küçük bir JSON dönen endpoint idealdir.
{"status": "ok"}Timeout’un çok düşük ayarlanması da yoğun anlarda gereksiz başarısız sonuçlar üretir.
Ayrıca, healthcheck’in sürekli başarısız görünmesine neden olan yaygın durumlardan biri de container’ın yanlış Docker ağına bağlı olmasıdır. Servis çalışıyor olsa bile curl hedefe ulaşamazsa test otomatik olarak başarısız olur ve loglarda network not found hatası görülür.
Bu problemi çözmek için hazırladığımız Docker Compose’da ‘network not found’ Sorunu Çözme rehberinde, ağın doğru şekilde yeniden oluşturulması için gerekli adımları ayrıntılı olarak açıkladık.
Gerçek Bir Health Endpoint Nasıl Olmalı?
Basit, hızlı ve gereksiz yük oluşturmayan bir kontrol noktası tanımlamak yeterlidir.
Node.js
app.get("/health", (req, res) => {
<br> res.status(200).json({ status: "ok", time: Date.now() });<br>
});Python Flask
@app.route('/health')<br>
def health():<br>
return {"status": "ok"}, 200PHP
<?php<br>
echo json_encode(["status" => "ok"]);Bu endpoint yalnızca uygulamanın canlı olduğunu doğrular.
Sık Sorulan Sorular
Aynı container içinde birden fazla healthcheck tanımlanabilir mi?
Dockerfile yalnızca tek bir HEALTHCHECK direktifi kabul eder. Ancak birden fazla bileşeni test etmek istersen tek bir script yazıp script içinde birden fazla kontrol yapabilirsin.
Healthcheck ile container yeniden başlamıyorsa sorun ne olabilir?
Docker’ın restart politikası aktif değilse healthcheck konteyneri sadece ‘unhealthy’ olarak işaretler, fakat yeniden başlatmaz. Otomatik restart için container şu şekilde çalıştırılmalıdır:
docker run --restart=on-failure ...Healthcheck içinde curl kullanmak yerine kendi binary’imi çalıştırabilir miyim?
Healthcheck özel scriptler, Go/Python binary’leri hatta kendi healthcheck tool’larınla da çalışabilir. Önemli olan testin hızlı çalışması ve sadece exit code üzerinden başarı durumunu iletmesidir.
Related Posts
Python ile HTTP web sunucusu nasıl kurulur?
Python Nedir ve Windows Üzerine Nasıl Kurulur?
