Bulut & Altyapı

Docker Compose ile Gerçek Bir Stack Kurulumu

Sunucuyu yeniden başlattıktan sonra konteynerler ayağa kalkmıyorsa veya veritabanı yanlış ağa bağlanıyorsa, bu pratik Docker Compose rehberi sorunu çözer.

Bulut & Altyapı

Sunucuyu yeniden başlattınız ve şimdi site açılmıyor. docker ps hiçbir konteyner göstermiyor ya da daha kötüsü: veritabanı ayağa kalkmış ama uygulama Connection refused hatasıyla ona bağlanamıyor. Birkaç konteyneri docker run ile manuel olarak ayağa kaldırdıysanız, tam da bu noktada duvara çarparsınız. Docker Compose tam bu an için yapıldı: tek dosya, tüm stack ve her yeniden başlatmadan sonra öngörülebilir davranış.

Gerçek bir stack için docker run neden işe yaramaz

Tek bir docker run komutu yalnızca bir konteyneri tanımlar. Web, veritabanı ve önbelleğiniz olduğunda başlatma sırasını, ortak ağı, volume'ları ve ortam değişkenlerini kendiniz manuel yönetmeniz gerekir. Bu iş ilk seferde çalışır. Sunucu ikinci kez yeniden başlatıldığında, komutları kimse tekrar çalıştırmaz.

Compose bu durumu hem belgelenmiş hem de çalıştırılabilir bir compose.yaml dosyasına dönüştürür. Temel fark üç şeydedir: servislerin birbirini isimle bulduğu iç ağ, başlatma sırası bağımlılığı ve yeniden başlatma politikası.

İç ağ: uygulama neden veritabanının adını bulamıyor

Compose'da her servis, varsayılan ağda kendi adıyla erişilebilir. Yani veritabanı servisine db adını verirseniz, uygulama localhost yerine db host'una bağlanmalıdır. Burada hata yapılır: geliştirici kendi dizüstü bilgisayarında koda localhost gömüyor, sonra aynı kodu sunucuda ayağa kaldırıyor ve uygulamanın veritabanına bağlanamadığını görüyor. Belirtisi de şudur: web konteyneri sağlıklı şekilde ayağa kalkar, log bağlantı hatası verir, ama docker ps her şeyi yeşil gösterir.

Çözüm ortam değişkenidir. Veritabanı host'unu asla koda yazmayın:

services:
  web:
    image: myapp:1.4.2
    environment:
      DB_HOST: db
      REDIS_HOST: cache
    depends_on:
      db:
        condition: service_healthy
    restart: unless-stopped

  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}
    volumes:
      - db_data:/var/lib/mysql
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      interval: 10s
      retries: 5

  cache:
    image: redis:7-alpine
    restart: unless-stopped

volumes:
  db_data:

Bu dosyada dikkate değer iki nokta var. Birincisi, condition: service_healthy ile depends_on gerçekten veritabanı hazır olana kadar bekler; basit depends_on sürümü yalnızca başlatma sırasına uyar ve hazır olup olmamasıyla ilgilenmez. İkincisi, restart: unless-stopped sunucu yeniden başlatıldıktan sonra konteynerlerin kendi kendine geri gelmesini sağlar. Bu satır olmadan, tam da başta tarif edilen sahneyi görürsünüz.

Ortam değişkeni ve şifre yönetimi

Veritabanı şifresini compose.yaml içine yazmayın. Dosyayı git'e commit edersiniz ve şifre sonsuza kadar geçmişte kalır. .env dosyasını kullanın ve onu .gitignore içine koyun:

DB_ROOT_PASSWORD=uzun-rastgele-bir-sifre
APP_ENV=production

Compose, compose.yaml yanındaki .env dosyasını otomatik olarak okur ve ${DB_ROOT_PASSWORD} yerine koyar. production ortamı için şifre dosyasını kısıtlı erişimle tutun: chmod 600 .env. Bu, sunucudaki diğer kullanıcıların şifreyi okumasını engeller.

Pratik bir tuzak: değişken değeri $ karakteri içeriyorsa, Compose onu değişken olarak yorumlar. $ içerebilecek rastgele şifreler için bunu $$ olarak yazın ya da ayrı bir env_file dosyası kullanın.

Volume'lar: konteynerle birlikte ölmemesi gereken veri

Konteyner içine yazılan her veri, konteyner silindiğinde yok olur. Veritabanı için bu felakettir. Adlandırılmış volume (yukarıdaki örnekte db_data) veriyi konteynerin yaşam döngüsünün dışında tutar. Kullanıcıların yüklediği dosyalar için de aynı mantık geçerlidir; dosya hacmi artıyorsa, bunları yerel disk yerine nesne depolama alanında tutmak hem yedeklemeyi kolaylaştırır hem de sunucu alanını boş tutar.

Az söylenen bir nokta: volume'ları docker compose down -v ile silmeyin, meğer ki her şeyi sıfırdan kurmayı kasten istiyorsunuz. Bu -v komutu veritabanı verisini de siler ve production ortamında bu, tüm kayıtları kaybetmek anlamına gelir.

Başlatma sırası ve veritabanı migrasyonu

service_healthy olsa bile, veritabanı migrasyonları (migration) uygulama ayağa kalkmadan önce çalıştırılmalıdır. İki yolunuz var: yalnızca migration'ı çalıştırıp sonra çıkan ayrı bir servis ya da migration'ı uygulamanın kendi entrypoint'inde çalıştırmak. İlk yol daha temizdir çünkü migration başarısız olursa uygulama hiç ayağa kalkmaz ve hatayı daha erken görürsünüz.

  migrate:
    image: myapp:1.4.2
    command: ["./manage.sh", "migrate"]
    depends_on:
      db:
        condition: service_healthy
    restart: "no"

restart: "no" değeri kasten böyledir. Bu servis bir kez çalışmalı ve bitmelidir. unless-stopped koyarsanız, başarılı olduktan sonra bile sürekli yeniden çalışır.

Compose ne zaman yeterli değildir

Compose tek sunucu, birkaç servis ve orta düzey yük için doğru seçimdir. Basittir, hata ayıklaması kolaydır ve ağır orchestration'a ihtiyaç duymaz. Ancak gerçek bir sınırlaması vardır: birden fazla sunucuya ölçeklenmez. Birden çok node'a, makineler arası yük dağıtımına ve konteynerin sağlıklı node üzerinde otomatik yeniden başlatılmasına ihtiyacınız varsa, Compose artık işe yaramaz ve Kubernetes'e yönelmeniz gerekir. Küçük ekipler için bu geçiş, zamanından önce çok fazla bakım maliyeti yükler; yönetilen Kubernetes'i seçiyorsanız, bunu yalnızca gerçekten birden çok node'a ihtiyaç duyduğunuzda yapın.

Tek sunuculu bir stack için önerim nettir: Compose'u seçin ve sunucu sayısı birden fazla olana kadar Kubernetes'e yaklaşmayın. Sonradan yatay ölçekleme gerekirse, servislerin mimarisi aynı kalır ve yalnızca orchestration katmanı değişir. Ölçekleme yolunu daha iyi anlamak için otomatik ölçekleme; yatay mı dikey mi? rehberi iyi bir başlangıç noktasıdır.

Çalıştırma ve stack sağlık kontrolü

Dosyayı yazdıktan sonra önce doğrulayın, sonra ayağa kaldırın:

docker compose config
docker compose up -d
docker compose ps
docker compose logs -f web

config komutu dosyayı değişkenler yerine konmuş halde yazdırır ve sözdizimi hatalarını dağıtımdan önce gösterir. Bir şifre yanlış yerine konmuşsa, bunu production logunda değil tam burada görürsünüz. Servislerin sürekli izlenmesi ve kesinti üzerine uyarı için sunucu izleme ve akıllı uyarılandırma rehberine bakın; Compose servisi ayağa kaldırır, ama izleme size ne zaman düştüğünü söyler.

Stack'i bir bulut sunucusunda çalıştırıyorsanız, kaynakları baştan doğru seçin. Veritabanının NVMe disk üzerinde olması sorgu yanıt sürelerinde belirgin bir fark yaratır ve sonradan veriyi taşımak pahalıya mal olur. Bulut altyapısı (IaaS) ServerNet, kaynakları baştan seçme imkânı verir.

Sık sorulan sorular

Sunucu yeniden başlatıldıktan sonra konteynerler neden ayağa kalkmıyor?

Neredeyse her zaman servislerde restart: unless-stopped olmamasındandır. Docker varsayılan olarak durdurulmuş konteynerleri sistem açılışından sonra yeniden çalıştırmaz. Bu satırı her zaman çalışır durumda olması gereken her servise ekleyin ve sonra docker compose up -d ile bir kez uygulayın.

Basit depends_on ile condition: service_healthy arasındaki fark nedir?

Basit depends_on yalnızca konteynerlerin başlatma sırasını belirler ve servisin hazır olması konusunda garanti vermez. condition: service_healthy ile Compose, veritabanının healthcheck'i başarılı olana kadar bekler ve sonra bağımlı servisi ayağa kaldırır. Veritabanları için her zaman ikinci sürümü seçin.

Şifreleri Docker Compose'da nerede tutmalıyız?

compose.yaml yanındaki .env dosyasında, chmod 600 erişimiyle ve git dışında. Compose dosyasında bunlara yalnızca ${VAR} ile başvurun. Şifre $ içeriyorsa, Compose'un yanlış yorumlamaması için $$ olarak yazın.

Compose production için uygun mu?

Orta düzey yüklü tek sunuculu bir stack için evet ve Kubernetes'ten daha mantıklı bir seçimdir. Temel sınırlaması birden çok sunucuya yatay ölçeklenmesidir. Tek makinede çalıştığınız sürece Compose daha basit, hata ayıklaması daha hızlı ve bakımı daha düşük maliyetlidir.

Hemen şimdi kendi compose.yaml dosyanızı açın ve hangi servisin restart içermediğine bakın. O tek satır, yeniden başlatmadan sonra geri gelen site ile sabaha kadar kapalı kalan site arasındaki farktır.

ServerNet Destek

ServerNet mühendislik ve yayın ekibi — altyapı, ağ ve web barındırma uzmanları.

Bulut Altyapı (IaaS)
Paylaş:

Yorumlar 0

Henüz yorum yok — ilk siz olun!

Yorum bırakın

İlgili hizmet

Bulut Altyapı (IaaS)

Sunucular, özel ağlar, güvenlik duvarları ve depolama — hepsi API ile, saatlik faturalandırma.