Docker’ı Güncelleyin: Adım Adım Kılavuz

Docker’ı güncellemek tamamen farklı üç anlama gelebilir. Docker Engine’i, Docker Desktop’ı veya konteynerlerinizin çalıştığı imajları güncellemeniz gerekebilir.

Çoğu geliştirici aslında hangisini güncellemesi gerektiğini bilmez; bu yüzden ya her şeyi günceller (ve kurulumlarını bozma riski alırlar) ya da güncellemelerden tamamen kaçınırlar (ve kendilerini güvenlik açıklarına maruz bırakırlar). Docker’ı güvenle güncellemek için neyi güncellediğinizi bilmeniz ve her senaryo için doğru adımları izlemeniz yeterlidir.

Bu yazıda, tahmine yer bırakmadan en güvenli ve en yaygın güncelleme yollarında size rehberlik edeceğim. Her Docker güncelleme türünün gerçekte ne yaptığını, hangisine ne zaman ihtiyaç duyduğunuzu ve mevcut konteynerlerinizi bozmadan adım adım nasıl güncelleme yapacağınızı öğreneceksiniz.

Docker’a yeniyseniz, güncellemelere ve bakıma başlamadan önce temel oluşturmak için Introduction to Docker ile başlayın.

“Docker’ı Güncellemek” Aslında Ne Demek?

Belirttiğim gibi, “Docker’ı güncellemek” üç farklı şeye atıfta bulunabilir ve bunları karıştırmak, çalışan bir sistemi yanlışlıkla bozmanın yoludur. Docker Engine’i (konteynerleri çalıştıran çekirdek yazılım), Docker Desktop’ı (GUI uygulaması) veya uygulamalarınızın kullandığı konteyner imajlarını güncelleyebilirsiniz.

Her bir güncelleme türü sisteminizi farklı şekilde etkiler. Açıklayayım.

Docker Engine’i güncellemek ile imajları güncellemek arasındaki fark

Docker Engine konteynerlerinizi yöneten çalışma zamanıdır.

Docker Engine’i güncellediğinizde, sisteminizde konteynerleri oluşturan, çalıştıran ve yöneten yazılımı yükseltirsiniz. Bu, Docker’ın nasıl çalıştığını etkileyen sistem düzeyinde bir değişikliktir. Yeni ikili dosyalar yüklersiniz, daemon’ı güncellersiniz ve Docker’ın işletim sisteminizle etkileşim biçimi potansiyel olarak değişir.

Konteyner imajları konteynerlerinizin çalıştığı planlardır.

Bir imajı güncellemek, o konteynerin içinde paketlenen uygulamanın daha yeni bir sürümünü çekmek demektir. Örneğin, bir konteynerde PostgreSQL 14 çalıştırıyorsanız ve PostgreSQL 18’e yükseltmek istiyorsanız, imajı güncellemek bu yeni sürümü çekmek anlamına gelir. Docker Engine’in kendisi değişmez — sadece konteynerlerinizin içindeki yazılım değişir.

Unutulmaması gereken ana nokta şudur: Docker Engine’i güncellemek tüm konteynerlerinizi etkileyebilirken, bir imajı güncellemek yalnızca o imajdan oluşturulmuş konteynerleri etkiler.

Çalışan konteynerlere ne olur

Docker Engine güncellemeleri konteynerlerinizi otomatik olarak yeniden başlatmaz.

Linux’ta Docker Engine’i güncellediğinizde Docker daemon’ı yeniden başlar, ancak modern kurulumların çoğunda konteynerleriniz çalışmaya devam eder. Docker, daemon güncellemeleri sırasında konteynerleri canlı tutan live restore adlı bir özellik kullanır. Etkin olup olmadığını docker info komutunu çalıştırıp “Live Restore Enabled: true” satırını arayarak kontrol edebilirsiniz.

Docker Desktop farklı bir hikâyedir.

macOS ve Windows’ta Docker Desktop’ı güncellemek tüm çalışan konteynerleri durdurur. Güncelleme sürecinde tüm Docker VM’i yeniden başlar. Güncelleme tamamlandıktan sonra konteynerleriniz otomatik olarak başlamaz. Onları manuel olarak başlatmanız veya yeniden başlatma ilkelerini kullanmanız gerekir.

İmaj güncellemeleri konteynerleri yeniden oluşturmanızı gerektirir.

Yeni bir imaj sürümü çekmek, çalışan konteynerlere hiç dokunmaz. Güncellenmiş imajı kullanmak istiyorsanız eski konteyneri durdurup kaldırmalı ve güncellenen imajdan yeni bir tane oluşturmalısınız.

Bu yüzden Engine güncellemeleri ile imaj güncellemeleri arasındaki farkı anlamak önemlidir. Biri kesinti planlaması gerektirebilir, diğeri gerektirmez.

Docker’ı Neden Güncellemelisiniz

Eski Docker sürümleri bilinen güvenlik açıklarına ve uyumluluk sorunlarına maruz kalmanıza neden olur. Bu tek başına sizi ikna etmiyorsa, okumaya devam edin.

Güvenlik ve kararlılık

Her Docker sürümü, önceki sürümlerde keşfedilen güvenlik açıklarını yamalar.

Eski bir sürüm çalıştırmak, saldırganların zaten bildiği istismarlara karşı savunmasız olduğunuz anlamına gelir. Güvenlik araştırmacıları ve Docker topluluğu bu sorunları aktif olarak bulur ve bildirir; Docker’ın arkasındaki şirket ise bunları yeni sürümlerde düzeltir. Güncelleme yapmıyorsanız kapıyı açık bırakıyorsunuz demektir.

Ayrıca, her sürümle birlikte kararlılık artar. Yeni sürümlerdeki hata düzeltmeleri, çoğu kullanıcıyı rahatsız eden ve üretimde konteynerlerinizi devre dışı bırakabilecek şeyleri giderir.

Her yeni sürüm çıktığında güncellemeniz gerekmez, ancak aylarca güncelleme atlamak onlarca güvenlik yaması ve kararlılık iyileştirmesini kaçırdığınız anlamına gelir.

Modern sistemlerle uyumluluk

İşletim sistemleri ve geliştirme araçları, siz Docker’ı güncelleseniz de güncellemeseniz de ilerlemeye devam eder.

İşletim sisteminiz güncellemeler alır, CI/CD araçlarınız yeni özellikler kazanır ve Kubernetes gibi orkestrasyon platformları eninde sonunda eski Docker sürümlerine desteği bırakır. İki yıl öncesinin Docker’ını çalıştırıyorsanız önce uyumluluk uyarıları, sonra hatalar, ardından da tamamen bozulmalar görmeye başlarsınız.

Modern konteyner imajları da daha yeni Docker özelliklerini bekler. İmaj oluşturucuları çok aşamalı derlemeler, BuildKit iyileştirmeleri ve eski Docker sürümlerinin desteklemediği daha yeni depolama sürücüleri kullanır. Güncel olmayan kurulumunuzda basitçe çalışmayacak bir imaj çekebilirsiniz.

Docker ile birlikte orkestrasyon araçları kullanmayı planlıyorsanız, Introduction to Kubernetes kursumuz başlamak için harika bir seçenektir.

Mevcut Docker Sürümünüz Nasıl Kontrol Edilir

Güncellemeden önce mevcut sürümünüzü kontrol etmek iyi bir pratiktir.

Yüklü sürümünüzü doğrulama

Mevcut Docker sürümünüzü görmek için bu komutu çalıştırın:

docker --versionAltyapı:

Bu, sisteminizde yüklü olan Docker Engine sürümünü gösterir:

Sürüm numarası anlamsal sürümleme biçimini izler: major.minor.patch. Bu örnekte 29 ana sürüm, 1 alt sürüm ve 3 yama sürümüdür.

Docker kurulumunuz hakkında daha fazla ayrıntı için bunun yerine şu komutu çalıştırın:

docker infoAltyapı:

Bu komut; sunucu sürümü, depolama sürücüsü, çekirdek sürümü ve live restore gibi özelliklerin etkin olup olmadığı dahil olmak üzere Docker kurulumunuz hakkında çok miktarda bilgi döker. Temel bir güncelleme için tümüne ihtiyacınız yoktur, ancak sorun giderme için kullanışlıdır.

Güncellemenin gerekip gerekmediğine karar verme

Alt sürüm güncellemeleri genellikle güvenlidir ve düzenli olarak uygulanmalıdır.

Docker 29.1.0 kullanıyorsanız ve 29.1.3 mevcutsa, bu hata düzeltmeleri ve güvenlik yamaları içeren bir alt sürüm güncellemesidir. Bu güncellemeler nadiren bir şeyi bozar ve uygun olduğunda uygulamalısınız.

Ana sürüm güncellemeleri daha fazla dikkat gerektirir. Docker 24’ten Docker 29’a geçmek, uyumluluğu bozabilecek değişiklikler, kullanım dışı bırakılan özellikler veya yeni gereksinimler getirebilir. Ana sürümler arasında güncellemeden önce, hedef sürümünüz için Docker sürüm notlarını kontrol ederek nelerin değiştiğine bakın.

En son Docker sürümünü resmi Docker dokümanlarında veya GitHub yayımları sayfasında bulabilirsiniz. Ne kadar geride olduğunuzu görmek için docker –version çıktısıyla karşılaştırın.

Docker Engine Nasıl Güncellenir

Güncelleme süreci, Linux’ta Docker Engine’i mi yoksa macOS/Windows’ta Docker Desktop’ı mı çalıştırdığınıza bağlıdır.

Linux’ta Docker’ı güncelleme

Linux, Docker Engine’i güncellemek için sisteminizin paket yöneticisini kullanır.

Tam komutlar dağıtıma göre değişir, ancak süreç aynıdır:

• Paket listenizi güncelleyin
• Docker’ı yükseltin

Ubuntu ve Debian tabanlı sistemlerde şu şekilde yapılır:

sudo apt update
sudo apt upgrade docker-ce docker-ce-cli containerd.ioAltyapı:

CentOS veya Fedora gibi Red Hat tabanlı sistemler için şunları çalıştırın:

sudo yum update docker-ce docker-ce-cli containerd.ioAltyapı:

Güncelleme sırasında Docker daemon’ı otomatik olarak yeniden başlar.

Live restore etkinse ( docker info ile kontrol edin), çalışan konteynerleriniz çalışmaya devam eder. Değilse, dururlar ve onları manuel olarak başlatmanız gerekir.

Güncelleme tamamlandıktan sonra yeni sürümü doğrulayabilirsiniz:

docker --versionAltyapı:

Docker’ı paket depoları yerine kolaylık betiğiyle yüklediyseniz, güncellemek için betiği tekrar indirip çalıştırmanız gerekir.

macOS ve Windows’ta Docker Desktop’ı güncelleme

Docker Desktop, Linux’taki Docker Engine’den farklı şekilde güncellenir.

Otomatik güncelleme varsayılan olarak etkindir. Docker Desktop başlarken güncellemeleri kontrol eder ve yeni bir sürüm mevcut olduğunda bir bildirim gösterir. Bildirime tıklayın; Docker Desktop güncellemeyi indirip sizin için kurar.

Manuel güncellemeyi tercih ediyorsanız Docker Desktop ayarlarını açın ve “Check for updates” seçeneğini arayın. Buradan otomatik güncellemeleri devre dışı bırakabilir ve istediğiniz zaman manuel olarak kontrol edebilirsiniz.

El ile güncelleme yapmak da gayet uygundur.

Docker web sitesinden en son Docker Desktop yükleyicisini indirip çalıştırın. Yükleyici mevcut kurulumu algılar ve imajlarınızı veya konteynerlerinizi kaldırmadan yükseltir.

Şunu unutmayın: Docker Desktop güncelleme sırasında tüm konteynerleri durdurur. Tüm Docker VM’i yeniden başlar, bu yüzden birkaç dakikalık kesinti planlayın. --restart always gibi yeniden başlatma ilkeleri yapılandırmadıysanız konteynerleriniz otomatik başlamaz.

Güncellemeden sonra Docker Desktop’ı açın ve docker –version komutunu çalıştırmadan önce tamamen açılmasını bekleyin.

Birden çok konteyneri tek tek yönetmek övünülecek bir şey değil. Çok konteynerli derlemeler için Docker Compose Rehberi yazımıza göz atın.

Docker Güncellemesini Nasıl Doğrularsınız

Docker şimdi güncellenmiş olmalı — ama gerçekten öyle mi, doğrulayalım.

Yüklü sürümü doğrulama

Önce sürüm numarasını kontrol edin:

docker --versionAltyapı:

Çıktı hedef sürümünüzü göstermelidir. Hâlâ eski sürümü gösteriyorsa, güncelleme düzgün tamamlanmamış olabilir veya yeni ikili dosyaları algılamak için terminalinizi yeniden başlatmanız gerekebilir.

Benim makinemde sürüm değişmedi, ancak bunun nedeni zaten en güncel sürümde olmamdı.

Sonraki adım Docker daemon durumunu kontrol etmektir:

docker infoAltyapı:

“Cannot connect to the Docker daemon” hatasıyla başarısız olursa daemon çalışmıyordur. Linux’ta şu komutla yeniden başlatın:

sudo systemctl restart dockerAltyapı:

macOS ve Windows’ta Docker Desktop’ı açın ve başlatmasını bekleyin.

Günlük konteyner çalışmalarında gerekli komutları öğrenmek için yakın zamanda yayımladığımız En İyi 18 Docker Komutu yazımıza göz atın.

Test konteyneri çalıştırma

Güncellemeden sonra hiçbir şeyin bozulmadığını doğrulamak için basit bir konteyneri çekip çalıştırmayı deneyin:

docker run hello-worldAltyapı:

Bu komut küçük hello-world imajını çeker ve çalıştırır. Docker’ın doğru çalıştığını açıklayan bir mesaj göreceksiniz:

Engine Güncellemesinden Sonra Docker İmajları Nasıl Güncellenir

Docker Engine’i güncellemek konteyner imajlarınızı güncellemez — bunları ayrı ele almanız gerekir.

Daha yeni imaj sürümlerini çekmek

docker pull komutunu kullanarak bir imajın en son sürümünü alabilirsiniz:

docker pull postgresAltyapı:

Bu komut, latest etiketiyle PostgreSQL imajının en yeni sürümünü çeker. Ancak bu her zaman sandığınız anlama gelmez — bu yalnızca imaj bakıcılarının istedikleri herhangi bir sürüme işaret edebileceği bir etikettir.

Sürprizlerden kaçınmak için etiketleri açıkça belirtmeniz her zaman önerilir:

docker pull postgres:18Altyapı:

Bu, özellikle PostgreSQL sürüm 18’i çeker. 18.1 sürümü çıktığında, bu komutu tekrar çalıştırmak 18 serisi içinde kalarak güncellenmiş 18.1 imajını çeker.

Diğer imajlar için önce docker images komutuyla mevcut sürümlerini kontrol edin. Ardından gerektiğinde daha yeni sürümleri çekin. Mevcut konteynerleriniz, siz onları yeni imajla yeniden oluşturana kadar eski imajı çalıştırmaya devam eder.

Özel imajları yeniden derlemek

Dockerfile’larla kendi imajlarınızı oluşturuyorsanız, temel imaj güncellemelerini çektikten sonra bunları yeniden derlemeniz gerekir.

Diyelim ki Dockerfile’ınız FROM python:3.14 ile başlıyor. En son python:3.14 imajını çekmiş olsanız bile, özel imajınız hâlâ eski önbelleğe alınmış katmanları kullanır. Güncellemeleri almak için yeniden derleyin:

docker build --no-cache -t myapp:latest .Altyapı:

Bu, tüm önbelleğe alınmış katmanları yok sayar ve her şeyi sıfırdan yeniden derler. Daha uzun sürer ancak en güncel temel imajları ve bağımlılıkları kullandığınızdan emin olmanızı sağlar.

Yeniden derledikten sonra eski konteynerlerinizi durdurun ve güncellenmiş imajla yenilerini başlatın — güncellemeler çalışan konteynerlere otomatik olarak uygulanmaz.

Güncellemeden sonra disk alanı boşaltmanız mı gerekiyor? Docker Prune eğitimimiz, kullanılmayan imajları ve konteynerleri güvenle nasıl temizleyeceğinizi gösterir.

Yaygın Docker Güncelleme Sorunları

Docker güncellemeleri öngörülebilir şekillerde başarısız olur ve çoğu sorunun hızlı çözümleri vardır. Bizzat karşılaştığım birkaçını göstereyim.

İzin, servis ve kurulum hataları

“Permission denied” hataları, kullanıcınızın Docker soketine erişemediği anlamına gelir.

Linux’ta kullanıcıyı docker grubuna ekleyin:

sudo usermod -aG docker $USERAltyapı:

Değişikliğin etkili olması için oturumu kapatıp yeniden açın. Bundan sonra docker komutları için sudo gerekmez.

“Cannot connect to the Docker daemon” hataları Docker’ın çalışmadığı anlamına gelir.

Servis durumunu kontrol edin:

sudo systemctl status dockerAltyapı:

Durdurulmuşsa veya başarısızsa başlatın:

sudo systemctl start dockerAltyapı:

Başlamıyorsa, sorunu görmek için journalctl -u docker ile günlükleri kontrol edin.

macOS ve Windows’ta Docker Desktop uygulamasını başlatmanız yeterlidir.

Kurulum sırasında paket çakışmaları, eski Docker paketleri yenileriyle çakıştığında ortaya çıkar.

Güncel sürümü kurmadan önce eski Docker paketlerini kaldırmak için şu komutu çalıştırabilirsiniz:

sudo apt remove docker docker-engine docker.io containerd runcAltyapı:

Ardından dağıtımınıza uygun resmi kurulum talimatlarını izleyerek Docker’ı yeniden kurun.

Docker’ı geri alma veya düşürme

Güncelleme kurulumunuzu bozarsa, önceki bir sürüme düşürebilirsiniz.

Linux’ta kullanılabilir sürümleri paket yöneticinizde bulun:

apt list -a docker-ceAltyapı:

Belirli bir eski sürümü kurun:

sudo apt install <specific-version>Altyapı:

Etiketi ihtiyacınız olan sürümle değiştirin. Düşürme sırasında konteynerleriniz ve imajlarınız olduğu gibi kalır.

macOS ve Windows için geri alma daha basittir. Docker’ın sürüm arşivinden daha eski yükleyiciyi indirip çalıştırın. Yükleyici, konteynerlerinize veya imajlarınıza dokunmadan mevcut sürümü eskisiyle değiştirir.

Docker Güncelleme En İyi Uygulamaları

En iyi tavsiye, Docker’ı düzenli olarak güncel tutmaktır. Bunu yıllardır yapmadıysanız, kırıcı değişiklikler için sürüm sayfalarını arayın.

Docker’ı güvenle güncel tutmak

Sorunları beklemek yerine Docker güncellemelerini kontrol etmek için bir hatırlatıcı ayarlayın.

Aylık olarak güncellemeleri kontrol edin — her birini kurmanız gerektiği için değil, nelerin mevcut olduğunu bilmeniz gerektiği için. Ve sizi hatırlatacak bir şeye ihtiyacınız var. Güvenlik yamaları, özellik güncellemelerinden daha önemlidir; yayımlandıklarında öncelik verin.

Güncellemeden önce mevcut kurulumunuzu belgelemek iyi bir uygulamadır. Docker sürümünüzü not alın, docker ps ile çalışan konteynerlerinizi listeleyin ve özel yapılandırmalarınızı kaydedin. Bir şeyler bozulursa tam olarak neyin değiştiğini bilirsiniz.

Docker’ı üretimde çalıştırıyorsanız, güncellemeleri önce bir geliştirme makinesinde test edin. Benzer bir ortam kurun, Docker’ı orada güncelleyin ve üretime dokunmadan önce konteynerlerinizin hâlâ çalıştığından emin olun.

Ne zaman otomatikleştirmeli

Kesintinin önemli olmadığı geliştirme ortamları için otomasyon mantıklıdır.

Docker Desktop’ı otomatik güncellemeye ayarlayabilir veya Linux’ta güvenlik yamaları için gözetimsiz yükseltmeler yapılandırabilirsiniz. Bu, yerel geliştirme makinelerinde, yeniden başlatmanın kritik hizmetleri aksatmayacağı durumlarda iyi çalışır.

Uygun korumalar olmadan üretimde güncellemeleri otomatikleştirmeyin.

Gerçek iş yüklerini çalıştıran sistemlere güncelleme uygulamadan önce izleme, geri alma stratejileri ve test gereklidir. Docker güncellemeleri bir şeyleri bozabilir — üretim sistemlerinde döngüde bir insan istiyorsunuz.

Aylık hatırlatıcılarla manuel güncellemeler benim tercih ettiğim yöntemdir ve hiç sorun yaşamadım.

Sonuç

Docker’ı güncellemek, aslında neyi güncellediğinizi anlamakla başlar.

Docker Engine güncellemeleri, Docker Desktop güncellemeleri ve imaj güncellemeleri; sisteminiz üzerinde farklı etkileri olan üç ayrı şeydir. Hangisine ihtiyaç duyduğunuzu bilin, platformunuza uygun doğru süreci izleyin ve ardından test edin. Hepsi bu.

Telefonunuza bir hatırlatıcı kurun. Aylık olarak güncellemeleri kontrol edin, güvenlik yamalarına öncelik verin ve bir şeyi değiştirmeden önce ne çalıştırdığınızı belgeleyin. Güncellemeler stres yapacağınız bir şey olmamalı — rutin bir bakım görevi olmalı.

Üretim ortamları için şunu unutmayın: Konteynerlerinizin düzgün çalışması Docker’ın doğru çalışmasına bağlıdır. Güncellemeleri diğer kritik altyapı değişikliklerine göstereceğiniz özenle ele alın — planlı, test ederek ve işler ters giderse bir geri alma planıyla.

Artık Docker’ı nasıl güncelleyeceğinizi biliyorsunuz — sonraki adım, Intermediate Docker kursumuzla konteyner becerilerinizi ileri taşımaktır. Ağ yapıları, gelişmiş konteyner imajları ve Docker Compose hakkında her şeyi öğreneceksiniz.