0
DockerResmî

Docker Compose ile Uygulama VPS Üzerinde Nasıl Dağıtılır?

Mustafa G.·18 Kasım 20263

Bir uygulamayı VPS'e kurarken asıl mesele genelde uygulamanın kendisi değil, etrafındaki şeylerdir: veritabanı, reverse proxy, ortam değişkenleri, yeniden başlatma politikaları. Tek tek container'ları docker run ile yönetmeye kalktığınızda parametreler el yordamıyla kaybolur, bir gün sunucu değiştirmeniz gerektiğinde hiçbir şeyi hatırlamazsınız. Docker Compose tam bu noktada devreye girer: tüm yığını tek bir docker-compose.yml dosyasında tanımlarsınız, dağıtım tek komuta iner.

Bu rehberde güncel Docker kurulu bir Ubuntu VPS üzerinde örnek bir uygulama (web + veritabanı) Compose ile nasıl yayınlanır, sık yapılan hatalar nelerdir, bunları adım adım ele alacağız.

Ön Gereksinimler

Başlamadan önce şunların hazır olduğundan emin olun:

  • Docker kurulu bir VPS (kurulum için SSH bağlantısı sonrası resmi apt deposunu kullanmanızı öneririz; Ubuntu'nun default docker.io paketi eski kalır)
  • Compose v2 — docker compose version komutu çıktı veriyorsa hazırsınız. Eskiden ayrı bir docker-compose ikili dosyasıydı, artık Docker CLI'nın içinde geliyor.
  • Uygulamanızın bir container imajı (kendi Dockerfile'ınız ya da Docker Hub'daki hazır bir imaj)
  • Domain'iniz varsa sunucu IP'sine yönlendirilmiş bir A kaydı
Not: Komutları root dışındaki, docker grubuna eklenmiş bir kullanıcıyla çalıştırmak daha güvenlidir: sudo usermod -aG docker kullaniciadi. Grup değişikliği için yeniden oturum açmanız gerekir.

Proje Dizinini ve Compose Dosyasını Oluşturma

Compose dosyası proje yapısının kalbidir. Örnek olarak bir Flask uygulaması ve PostgreSQL'i birlikte çalıştıracağımız bir senaryo kuralım:

mkdir -p /opt/uygulama && cd /opt/uygulama

Ardından docker-compose.yml dosyasını oluşturun:

services:
  web:
    build: .
    restart: unless-stopped
    ports:
      - "8000:8000"
    env_file:
      - .env
    depends_on:
      db:
        condition: service_healthy
  db:
    image: postgres:16
    restart: unless-stopped
    environment:
      POSTGRES_PASSWORD: ${DB_PASSWORD}
      POSTGRES_DB: uygulama
    volumes:
      - dbdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 5s
      timeout: 3s
      retries: 5

volumes:
  dbdata:

Burada dikkat edilmesi gereken birkaç nokta var. restart: unless-stopped sayesinde sunucu yeniden başladığında container'lar kendiliğinden ayağa kalkar — VPS'te bunu belirtmeyi unutan müşterilerimiz bakım sonrası "site neden kapalı" diye bize yazıyor, çoğu zaman sebep budur. healthcheck ise web servisinin veritabanı hazır olmadan başlamamasını garanti eder; depends_on'u tek başına yazmak yeterli değildir, çünkü o yalnızca sırayı belirler, hazır olup olmadığını beklemez.

Ortam Değişkenlerini .env ile Yönetin

Şifreleri doğrudan Compose dosyasına yazmak, dosyayı Git'e atırsanız kötü bir sürprize dönüşür. Aynı dizine bir .env dosyası açıp değerleri oraya koyun:

DB_PASSWORD=cok_gizli_bir_parola

ve .env dosyasını mutlaka .gitignore'a ekleyin. İzinleri de sıkılaştırın: chmod 600 .env.

Uygulamayı Başlatma ve Doğrulama

Dağıtım komutu oldukça basit:

  1. docker compose up -d — tüm servisleri arka planda başlatır. İlk çalıştırmada imaj build edilir, birkaç dakika sürebilir.
  2. docker compose ps — servislerin durumunu kontrol edin. PostgreSQL sağlıklı duruma geçmeden web container'ı beklemede görünür, bu normaldir.
  3. docker compose logs -f web — uygulama loglarını canlı izleyin. Başlangıç hatalarının %90'ı burada görünür: eksik ortam değişkeni, yanlış bağlantı adresi, port çakışması.

Test için: curl -I http://localhost:8000 komutu 200 ya da yönlendirme kodu döndürüyorsa uygulama çalışıyor demektir. Dışarıdan erişilemiyorsa iki şüpheli vardır: VPS güvenlik duvarı (portun açık olup olmadığını sudo ufw status ile teyit edin) veya WEBKUR kontrol panelindeki firewall kuralı. İkisini de kontrol etmek gerekir.

Sık yapılan hata: ports: "8000:8000" yazıp uygulamayı doğrudan internete açmak. Veritabanı gibi dahili servislerde ports tanımlamayın; Compose ağı içinde servis adıyla (burada db) erişilir. İnternete açmanız gereken yalnızca web servisinizdir — onu da ideal olarak aşağıdaki reverse proxy arkasına alın.

Güncelleme ve Geri Alma Süreci

Compose'un asıl gücü, uygulamanın yaşam döngüsü yönetiminde ortaya çıkar. Yeni bir sürüm dağıtmak için:

git pull
docker compose build
docker compose up -d

up -d yalnızca yapılandırması veya imajı değişen servisleri yeniden başlatır; kesinti saniyelerle sınırlı kalır. Geri alma gerekirse önceki imaj etiketiyle tekrar up -d çalıştırmanız yeterli. Bu yüzden imajlarınızda latest yerine sürüm etiketleri (v1.4.2 gibi) kullanmanızı öneririz.

Veritabanı şeması değişen sürümlerde dağıtımdan önce yedek almayı alışkanlık haline getirin: docker compose exec db pg_dump -U postgres uygulama > yedek.sql. Volume silinmediği sürece veriler korunur, ancak migration hataları veriyi bozulmuş halde bırakabilir — yedeksiz dönüşü olmayan bir hata yapmamak için iki dakikanızı ayırın.

Reverse Proxy ile Üretim Seviyesine Taşıma

Uygulamayı 8000 portundan yayına almak çalışır ama üretim için eksiktir. Önerimiz, Compose yığınına bir Nginx Proxy Manager veya Traefik ekleyip TLS sertifikasını otomatik almak. Basit bir alternatif olarak ana makinede Nginx çalıştırıp proxy_pass http://127.0.0.1:8000; ile yönlendirme yapabilir, Let's Encrypt ile sertifika alabilirsiniz.

Bu yapıda Compose dosyasındaki ports tanımını 127.0.0.1:8000:8000 olarak değiştirmek önemli bir detaydır; aksi halde uygulama proxy'yi bypass edip doğrudan erişilebilir kalır ve SSL'iniz etrafından dolanır.

Hangi boyut VPS gerekir?

Bu, uygulamanın yapısına göre değişir ama pratik bir çerçeve çizebiliriz: tek web uygulaması + PostgreSQL + Nginx için 2 vCPU / 4 GB RAM'lik bir VPS rahat bir başlangıçtır. Container'lar paylaşılan çekirdek üzerinde çalıştığı için LXC tabanlı VPS'lerde de sorunsuz çalışır; yalnızca Docker içinde iç içe container (DinD) gerektiren senaryolarda tam sanallaştırma tercih edilmelidir. Bellek tüketimini docker stats ile izleyip deploy.resources veya mem_limit ile servis başına limit koymanız, tek bir container'ın sunucuyu kilitlemesini engeller.

Dağıtım Sonrası Kontrol Listesi

Yayına almadan önce şu hızlı kontrolü yapın:

  • docker compose ps çıktısında tüm servisler running ya da healthy durumda mı?
  • Sunucu yeniden başlatıldığında uygulama kendiliğinden geliyor mu? (sudo reboot ile test etmek en sağlamı)
  • Log rotasyonu: /etc/docker/daemon.json içinde log-opts tanımlı değilse container logları diski doldurabilir; max-size belirleyin.
  • Veri içeren tüm servislerin volume'ü var mı? Container silindiğinde volume olmayan veri de silinir.
  • Yedekleme görevi (crontab) tanımlı mı?

Bu maddeler tamamlandıysa dağıtımınız üretim için sağlamdır. Sonraki adım olarak izleme (monitoring) tarafına bakmanızı öneririz; Prometheus + Grafana ikilisi de aynı yöntemle, yani Compose ile saniyeler içinde VPS'inize kurulabilir.

0 cevap

Henüz cevap yok — ilk cevabı siz verin

Cevap yazmak için giriş yapmalısınız

Giriş Yap