Docker Compose build ve image farkı nedir?
Docker Compose dosyasında build ve image anahtarlarının farkını öğrenin. Dockerfile değişikliklerinin neden yoksayıldığını ve VPS üzerinde doğru yapılandırmayı inceleyin.
Docker Compose build ve image: kısa yanıt
Bir Docker Compose dosyasında image:, yerel bir imaj, etiket veya özet referansı dahil olmak üzere kullanılacak imajı tanımlar; build: ise Compose'a kaynaktan nasıl bir imaj oluşturulacağını bildirir. Yalnızca image: ayarlandığında, Compose imajı pull_policy değerine göre kullanır veya çeker. Yalnızca build: ayarlandığında, Compose imajı yapılandırılmış oluşturucu ile derler ve ona proje adı ile servis adından türetilen bir isim verir. Her ikisi de ayarlandığında, pull_policy Compose'un imajı çekip çekmeyeceğini veya derleyip derlemeyeceğini kontrol eder; derleme yapıldığında, sonucu image: içindeki isimle etiketler; bu, bir imajı derleyip seçtiğiniz bir isimle göndermenizi sağlar. Oluşturucu, yerel olarak veya uzak bir Docker ana bilgisayarında çalışabilir.
Tüm ayrım bundan ibarettir. Aşağıdaki her şey, bunun bir sunucuda operasyonel olarak ne anlama geldiğini açıklar. Bu metin, Docker Engine ve Compose eklentisinin halihazırda kurulu olduğunu varsayar; VPS üzerinde Docker çalıştırma bölümü bu kısmı kapsamaktadır.
Üç formun tamamı
Yayınlanmış bir etiketi kullanın; etiket eksikse varsayılan çekme politikası (pull policy) kapsamında görüntüyü çekin. Bu süreçte hiçbir aşamada Dockerfile kullanılmaz.
services:
web:
image: nginx:1.27
restart: unless-stopped
ports:
- "80:80"Proje dizinindeki bir Dockerfile dosyasından derleme yapın. Derleme işlemi, Dockerfile tarafından gereksinim duyulan görüntüleri çekebilir ve bağımlılıkları indirebilir.
services:
web:
build: .
restart: unless-stopped
ports:
- "80:80"Derleme yapın ve sonucu docker compose build ile etiketleyin; açık bir çekme politikası belirtilmediği sürece up, derleme öncesinde bu görüntüyü çekmeyi dener. docker compose push daha sonra bu etiketi doğrudan bir kayıt defterine (registry) gönderebilir.
services:
web:
build:
context: .
dockerfile: Dockerfile
image: registry.example.com/acme/web:1.4.2
restart: unless-stopped
ports:
- "80:80"context, derleyiciye gönderilen dizindir. dockerfile, bu bağlama göre çözümlenir; bu nedenle dockerfile: docker/prod.Dockerfile ile birlikte context: . kullanımı normal ve doğrudur. Her servis konteynerinin arkasındaki görüntü adını ve görüntü kimliğini görmek için docker compose images komutunu çalıştırın; servisin image:, build: veya her ikisini birden kullanıp kullanmadığını doğrulamak için Compose dosyasını kontrol edin.
Neden Dockerfile dosyasını değiştirdikten sonra docker compose up komutu yeniden derleme yapmıyor?
Çünkü normal up, siz bir derleme talep etmediğiniz veya bunu gerektiren bir politika yapılandırmadığınız sürece mevcut bir imajı yeniden kullanır.
Compose, yalnızca build: bölümüne sahip bir servisi başlattığında, eğer mevcutsa halihazırda var olan imajı kullanır. Dockerfile dosyanızı okumaz, kaynak dosyalarınızı karşılaştırmaz veya herhangi bir zaman damgasına bakmaz. Hem image: hem de build: tanımlı olduğunda ve açık bir pull_policy belirtilmediğinde, Compose önce imajı çekmeye (pull) çalışır; eğer imaj kayıt defterinde veya platform önbelleğinde yoksa derleme yapar. Mevcut olan, yeterli kabul edilir.
Bu nedenle app.py dosyasını düzenleyip docker compose up -d komutunu çalıştırdığınızda, Compose konteynerin çalıştığını raporlar ancak eski kodu sunmaya devam eder. Hiçbir şey başarısız olmadığı için sizi uyaran bir hata da oluşmaz. İpucu, Compose'un konteyner adının yanında yazdırdığı durum bilgisidir: Compose tarafından değiştirilen bir konteyner "recreated" (yeniden oluşturuldu) veya "started" (başlatıldı) olarak raporlanırken, Compose'un dokunmamaya karar verdiği bir konteyner "running" (çalışıyor) olarak raporlanır.
İki kontrol bu durumu netleştirir. docker compose images her konteynerin kullandığı imaj kimliğini (ID) yazdırır; bu yüzden dağıtım öncesinde not alın ve sonrasında karşılaştırın. docker image ls bir CREATED sütununa sahiptir, ancak önbelleğe alınmış derlemeler ve yeniden üretilebilir zaman damgaları nedeniyle, sadece bu tarih en son kaynağınızın derlenip derlenmediğini kanıtlamaz.
Hangi bayraklar yeniden derlemeyi zorunlu kılar
docker compose up -d --buildönce derleme yapar, ardından imajı değişen her container'ı yeniden oluşturur. Çoğu kullanıcının aradığı bayrak budur.docker compose build webtek bir servisi derler ve hiçbir şeyi başlatmaz. Ardındandocker compose up --no-deps -d webkullanarak sadece o container'ı değiştirebilir ve yığının geri kalanını çalışır durumda bırakabilirsiniz.docker compose build --no-cache webönbelleğe alınmış katmanları atlar ve servisi yeniden derler.docker compose build --pull,FROMiçindeki temel imajın daha yeni bir sürümünü çekmeye çalışır; böylecenode:22gibi değişken bir etiket, Mart ayında indirdiğiniz kopyayı değil, mevcut içeriği alır.docker compose up -d --force-recreate, yapılandırma ve imaj değişmemiş olsa bile container'ın yeniden oluşturulmasını zorunlu kılar. Bayrağın kendisi derleme talep etmez ancakup, imaj eksik olduğunda veya çekme politikası gerektirdiğinde yine de derleme yapabilir.--buildyerine bu bayrağa başvurmak yaygın bir çıkmazdır.
Kararı dosya içine de taşıyabilirsiniz. Compose spesifikasyonuna göre pull_policy: build, Compose'un imajı derlediği ve zaten mevcutsa yeniden derlediği anlamına gelir. Bu durumda her up bir derleme maliyeti doğurur; bu, dizüstü bilgisayarda istediğiniz ancak sunucuda nadiren tercih ettiğiniz bir durumdur.
services:
web:
build: .
image: registry.example.com/acme/web:dev
pull_policy: buildBir etkileşimi daha bilmekte fayda var. docker compose pull, build bölümüne sahip servisler için de imajları çekmeye çalışır; çekme işlemi başarısız olursa, imajın derlenmesi gerektiğini bildirir. Bu servisleri sessizce atlamak için --ignore-buildable bayrağını kullanın.
Derleme önbelleğinin dağıtım süresini belirleme yöntemi
Derleyici, bir Dockerfile yönergesindeki girdi ve yönergenin kendisi değişmediğinde, yeniden kullanılabilir bir önbellek sonucu olup olmadığını kontrol eder. COPY için girdiler, dosya içeriklerini ve meta verileri kapsar; değişiklik zamanlarını ise dışarıda tutar. Bir katman önbelleği ıskaladığında, ona bağlı olan sonraki adımlar yeniden derlenir.
Dağıtımınızın saniyeler mi yoksa dakikalar mı süreceğini belirleyen kural budur. Dockerfile dosyasını, nadiren değişen işlemlerden her commit ile değişen işlemlere doğru sıralayın.
FROM node:22-slim
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci
COPY . .
CMD ["node", "server.js"]npm ci, COPY . . üzerinde yer alır; bu nedenle bir kaynak dosyasını düzenlemek, kurulum katmanının önbellekte kalmasını sağlar ve derleme kopyalama adımından devam eder. Bu iki satırın yerini değiştirirseniz, tek karakterlik bir değişiklik bile tüm bağımlılıkları yeniden kurar; çünkü COPY . ., npm ci öğesinin üzerine inşa edildiği katmanı geçersiz kılar. Aynı mantık pip install -r requirements.txt ve go mod download için de geçerlidir.
Eski bir katmanın yaptığınız düzeltmeyi gizlediğinden şüphelendiğinizde kullanılması gereken doğru araç --no-cache komutudur. Ancak bu komutu varsayılan olarak kullanmak yanlıştır; çünkü Dockerfile sıralamasının sağladığı yeniden kullanım avantajını tamamen ortadan kaldırır.
İmajın belirlediği ve Compose ile geçersiz kılınabilen bir nokta vardır: Dockerfile içindeki CMD, imajın varsayılan olarak çalıştırdığı komuttur ve servisteki bir command: anahtarı bu komutun yerini alır. Komut ve entrypoint etkileşimi burada önem kazanır; çünkü bir Compose geçersiz kılması, yeni derlenmiş bir imajın tamamen eski imaj gibi davranmasına neden olabilir.
Derleme bağlamı ve .dockerignore
context: ., proje dizinini derleyici için erişilebilir kılar. Hariç tutma işlemleri yapılmadığı takdirde, .git ve kaynak kodunuzun yanında tuttuğunuz tüm veri dizinleri de bu kapsama dahil edilir; ancak BuildKit kullanılmayan dosyaları atlar ve değişiklikleri artımlı olarak aktarır. Aksi takdirde değişmeyen bir projede derleme işlemi "transferring-context" adımında duraklıyorsa, bağlamın çok büyük olduğu anlaşılır.
Bağlamın kök dizinindeki bir .dockerignore dosyası, belirtilen yolları bu aktarımın dışında tutar. Söz dizimi .gitignore ile benzerdir.
.git
node_modules
*.log
data/
.envBunun iki temel faydası vardır. Aktarım boyutu küçülür ve bu dosyaların gönderilmesi için harcanan süre azalır. Ayrıca COPY . ., .env dosyasını imajın içine kopyalayamaz; böylece imajı çeken herhangi birinin bu dosyayı okuması engellenmiş olur.
Zamanla yavaşlayan derleme süreçlerinin yaygın bir nedeni bind mount kullanımıdır. Adlandırılmış bir volume proje dizininizin dışında yaşar, ancak ./data:/var/lib/postgresql/data gibi bir bind mount derleme bağlamının içinde yer alır; bu nedenle veritabanı büyüdükçe derleme süreleriniz her hafta daha da uzar. .dockerignore içerisine eklenecek tek bir satır bu sorunu çözer. Adlandırılmış volume'lara karşı bind mount'lar bölümü bu konudaki genel tercihleri ele almaktadır.
Derleme argümanları (build arguments) benzer riskin daha küçük bir versiyonunu taşır. args: aracılığıyla aktarılan değerler, imaj geçmişinde veya köken meta verilerinde kalıcı olabilir; bu nedenle buraya yalnızca sürüm numarası gibi veriler girilmeli, asla token bilgisi eklenmemelidir. Önceden tanımlanmış proxy argümanları, Dockerfile içerisinde açıkça referans verilmediği sürece varsayılan olarak derleme önbelleğinden ve docker history kapsamından hariç tutulur. Compose içinde env dosyaları ve gizli veriler bölümü, kimlik bilgilerinin nerede tutulması gerektiğini açıklamaktadır.
Derleme işlemini VPS üzerinde mi yapmalı yoksa başka bir yerde yapıp çekmeli mi?
Trafiği karşılayan sunucu üzerinde derleme yapmak, en kısa yol olduğu için varsayılan yöntemdir: git pull, ardından docker compose up -d --build. Henüz kimsenin bağımlı olmadığı küçük bir sunucuda bu yöntem sorun yaratmaz. Ancak ölçülebilir iki neden ve kötü bir günde ortaya çıkacak bir neden yüzünden bu yöntem sürdürülebilirliğini yitirir.
Bellek. Derleme işlemi, canlı uygulamanızın yanında derleyicileri ve paketleyicileri çalıştırır; bunlar çoğu yığının en çok bellek tüketen parçalarıdır. Bir JavaScript paketleyicisi veya Rust derlemesi, 1 GB belleğe sahip bir VPS'in tüm kaynaklarını tüketebilir. Bellek tükendiğinde çekirdek, bellek kullanımı, ayırma bağlamı ve oom_score_adj değerlerine dayalı bir "kötülük puanı" kullanarak bir OOM kurbanı seçer; sadece en büyük süreci sonlandırmaz. Derleme işlemi Killed hatası ve 137 çıkış koduyla durabilir veya veritabanınız sonlandırılarak dağıtım sırasında siteniz erişilemez hale gelebilir. dmesg -T | grep -i oom, çekirdek günlüğünde OOM mesajlarını arar; erişim için bu günlüğü okuma izni gerekir.
Disk. Derlemeler geride imaj katmanları ve derleme önbelleği bırakır. docker system df, disk kullanımını gösterir; BuildKit'in periyodik çöp toplama mekanizması, yapılandırılmış politikalara göre önbelleği temizler. Başıboş imajlar için docker image prune, önbelleğe alınmış katmanlar için docker builder prune ile temizlik yapın. Diskin dolması sadece derlemeyi durdurmaz. Veritabanı da yazma işlemini durdurur ve bu hata, yavaş bir dağıtımdan çok daha maliyetlidir.
Tekrarlanabilirlik. İtme veya dışa aktarma işlemi yapılmadığı sürece, sunucuda oluşturulan bir imaj sadece o sunucuda var olur. Eski imaj artık mevcut değilse, geri alma işlemi eski commit'i kontrol edip yeniden derlemeyi gerektirir; temel etiket ve paket yansımaları değiştiği için bu derlemenin elinizdekiyle aynı sonucu vereceğinin garantisi yoktur. Başka bir yerde derleyip bir etiket itmek, geri alma işlemini bir düzenlemeye dönüştürür: image: değerini önceki etikete yönlendirin ve docker compose up -d komutunu çalıştırın.
En sağlam yapı basittir. Sürekli entegrasyon süreciniz derlemeyi yapar ve registry.example.com/acme/web:<git-sha> değerini iter; VPS üzerindeki Compose dosyası ise build: anahtarı olmadan image: değerini taşır. Dağıtım, neredeyse hiç bellek gerektirmeyen iki komuttan ibaret hale gelir.
docker compose pull
docker compose up -dÖzel etiketleri çekmek için kimlik bilgilerini kaydetmek üzere sunucuda docker login registry.example.com komutunu çalıştırın.
Derleme bölümünü silmek yerine, kendi adlandırdığınız bir dosyada geliştirme amaçlı tutun.
# compose.dev.yaml
services:
web:
build:
context: .
pull_policy: builddocker compose -f compose.yaml -f compose.dev.yaml up -d --buildBu dosyayı compose.override.yaml değil, compose.dev.yaml olarak adlandırın. Compose, mevcut olduğunda bir geçersiz kılma dosyasını otomatik olarak yükler; bu nedenle sunucuya kopyalanan başıboş bir geçersiz kılma dosyası, sessizce orada derleme yapmaya başlamanıza neden olabilir. Birden fazla Compose dosyasını katmanlama bölümü, birleştirme işleminin her anahtarı nasıl çözümlediğini açıklar.
Başka bir yerde derleme yaparken mimari tuzağı
Tek bir platform imajı, derlendiği CPU mimarisini taşır. Apple Silicon dizüstü bilgisayarda bir ARM imajı derleyip gönderir ve ardından bu imajı bir x86_64 VPS üzerinde kullanırsanız, Docker, açık bir platform belirtilmeden uyumsuz bir önbellek imajı kullanıldığında konteyner oluşturma sırasında uyarı verir. Emülasyon olmadan süreç, bozuk bir ikili dosya gibi görünen ancak aslında öyle olmayan exec format error hatasıyla başarısız olur. Hedef için açıkça derleme yapın:
docker buildx build --platform linux/amd64 \
-t registry.example.com/acme/web:1.4.2 --push .Dizüstü bilgisayarınız x86 ise ve x86 yerine bir ARM VPS çalıştırıyorsanız aynı uyumsuzluk tersi durumda da gerçekleşir. CI sürecinin dağıtım yaptığınız mimari üzerinde derleme yapmasını sağlamak bu sorunu ortadan kaldırır. Çoklu platform imajı da bu sorunu çözer: Docker, imajı çekerken eşleşen varyantı seçer.
Dağıtım sonrası kontrol edilecekler
docker compose imageskomutu, çalışan her container'ın arkasındaki imajı ve etiketi yazdırır. Değişen bir imaj ID'si, yeni derlemenin serviste olduğunun kanıtıdır.docker compose configkomutu, değişken değişiminden sonra birleştirilmiş dosyayı yazdırır; böylece herhangi bir işlem yapmadan önce Compose'un kullanacağı nihai imaj adını okuyabilirsiniz.docker compose logs -f webkomutu, değişimden sonraki ilk yarım dakika için kullanılır. Sürekli başlayan ve kapanan bir container, yalnızca yeniden başlatma politikası gerektiriyorsa yeniden başlatılır; nedenini görmek için logları kontrol edin.docker image lskomutu, CREATED sütununu gösterir. Derleme çıktısını ve dağıtılan imaj ID'sini de kontrol edin, çünkü yalnızca oluşturulma zaman damgası bir yeniden derlemenin çalışıp çalışmadığını kanıtlamaz.
Eğer bu kontrollerin yapıldığı dosyayı hala oluşturuyorsanız, bir VPS üzerinde Compose dosyasının temelleri bölümü ilgili anahtarları kapsar ve Compose komutları kopya kağıdı ise alt komutların geri kalanını listeler.
FAQ
Aynı serviste hem build hem de image kullanabilir miyim?
Evet, bu kendi geliştirdiğiniz projeler için standart bir yapılandırmadır. Compose, build: bölümünden bir derleme yaptığında, sonucu image: değerindeki etiketle işaretler; açık bir pull_policy belirtilmediğinde up önce çekme (pull) işlemini dener. docker compose push komutunun bir kayıt defterine gönderdiği ve başka bir makinenin çektiği etiket budur. image: anahtarı olmadan da Compose derleme yapar ancak imajı proje ve servis adına göre isimlendirir ve eksik özniteliğin imajın gönderilmesini (push) engelleyeceği konusunda uyarı verir.
docker compose up komutu neden Dockerfile değişikliklerimi algılamıyor?
Çünkü standart up, siz bir derleme talep etmedikçe veya bunu gerektiren bir politika yapılandırmadıkça mevcut imajı yeniden kullanır. Bir yeniden derlemenin gerekli olup olmadığına karar vermek için imajı Dockerfile veya kaynak dosyalarınızla karşılaştırmaz. docker compose up -d --build komutunu çalıştırın veya tek bir servisi değiştirmek için docker compose build web komutunu takiben docker compose up --no-deps -d web komutunu kullanın. Servis üzerinde pull_policy: build ayarını yapmak, her up komutunda yeniden derleme yapılmasını sağlar; bu, geliştirme makineleri için uygundur.
--build ve --force-recreate arasındaki fark nedir?
--build imajı yeniden derler ve ardından imajı değişen container'ları yeniden oluşturur. --force-recreate, yapılandırma ve imaj değişmemiş olsa bile container'ın yeniden oluşturulmasını zorlar; kendiliğinden bir derleme talep etmez. Değişikliğiniz kaynak kodda veya Dockerfile içindeyse, kullanmanız gereken bayrak --build'dır. --force-recreate, örneğin aynı imajı korurken yazılabilir katmanı temizlemek gibi, container'ın kendisini sıfırlamak için kullanılır.
Docker imajlarımı VPS üzerinde mi yoksa başka bir yerde mi derlemeliyim?
Başka bir yerde derleyin ve sunucu trafiği karşılamaya başladığında etiketli imajı çekin. Derleme işlemi bellek kullanımı açısından uygulamanızla rekabet eder; bellek tükendiğinde çekirdek, ayarlanabilir bir OOM puanı kullanarak bir kurban seçer ve bu kurban derleme süreci veya veritabanınız olabilir. Derlemeler diskte önbellek bırakır, ancak BuildKit bunu çöp toplama politikalarına göre otomatik olarak geri kazanır. Küçük ve kullanıcısı olmayan projeler için sunucuda derleme yapmak sorun yaratmaz; build: bölümünü yalnızca geliştirme ortamına özel bir Compose dosyasında tutarsanız, ileride taşıma yapmak oldukça kolaydır.
Docker derleme önbelleğinin diskimi doldurmasını nasıl engellerim?
İmajlarınızın ve derleme önbelleğinizin ne kadar yer kapladığını görmek için docker system df komutunu çalıştırın. docker builder prune önbelleğe alınmış katmanları, docker image prune ise önceki derlemelerden kalan sahipsiz imajları kaldırır. -a eklemek, kullanılmayan tüm derleme önbelleğini veya container'lar tarafından referans verilmeyen tüm imajları kaldırır; ancak bir sonraki derlemenin tamamen temiz (cold) olacağını garanti etmez. docker system prune -af --volumes komutunu bir sunucuda zamanlanmış görev olarak çalıştırmayın; çünkü bu komut durdurulmuş container'ları ve kullanılmayan anonim birimleri kaldırır, bu da bakım sırasında anonim birimde tutulan veritabanı verilerini riske atar.