SSD Nodes Learn Hosting plans →
Rehberler Matt ConnorYazan Matt Connor

Docker Compose exec ile etkileşimli kabuk açma

Calisan bir Docker Compose servisine docker compose exec komutu ile nasil baglanacaginizi ogrenin. Servis durdugunda ise yeni container olusturmak icin run komutunu kullanin.

docker compose exec ile etkileşimli bir kabuk elde etme

docker compose exec web bash, hâlihazırda web servisi olarak çalışan container içerisinde etkileşimli bir kabuk açar. exec ifadesinden sonra gelen isim, container adı değil, compose.yaml dosyanızdaki servis adıdır. Eğer imaj içerisinde bash bulunmuyorsa, bunun yerine sh komutunu deneyin.

docker compose ps
docker compose exec web bash

Önce docker compose ps komutunu çalıştırın. Bu komut, running durumundaki web öğelerini listelemelidir. Ardından ikinci komut sizi container içerisinde bir komut satırına ulaştırır; exit veya Ctrl-D tuş kombinasyonu sizi ana makineye geri döndürür. exec komutu ana sürecin yanında ikinci bir süreç başlattığı için, siz çıktıktan sonra servis çalışmaya devam eder. Kabuğu kapatmak, container'ın çalışması için oluşturulduğu PID 1 (süreç kimliği 1) sürecine müdahale etmez.

Bu, içerideki sisteme erişmenin iki yolundan biridir. exec, hâlihazırda var olan bir container'a katılır. docker compose run ise aynı servis tanımından yeni bir container oluşturur. Bu kılavuzdaki hemen hemen her şey, bu temel farktan türetilmiştir.

Compose'da -it neden isteğe bağlı, ancak düz docker ile neden zorunludur

Etkileşimli bir oturumun parçalarını iki bayrak kontrol eder. -i, stdin'i açık tutar; böylece yazdıklarınız sürece ulaşır. -t, TTY adı verilen bir sözde terminal ayırır; böylece kabuk bir komut istemi yazdırır ve ok tuşlarını işler. Düz docker exec, varsayılan olarak her ikisini de kapalı bırakır; bu nedenle gördüğünüz her örnekte docker exec -it yazılır. docker compose exec, her ikisini de sizin için açar; bu nedenle docker compose exec -it web bash ve docker compose exec web bash aynı işi yapar. Compose, -it bayrağını kabul etmeye devam eder, böylece eski alışkanlıklarınız çalışmaya devam eder.

Eksik bir TTY'yi saniyeler içinde fark edersiniz. Kabuk çalışır ancak hiçbir komut istemi yazdırmaz ve Ctrl-C tuşları sürece asla ulaşmaz. Compose'dan bir TTY ayırmamasını istemeniz gereken ters durumun kendi bayrağı ve aşağıda kendi bölümü vardır.

İmajda bash bulunmadığında ne yapılmalı

Alpine tabanlı bir imajdan bash isterseniz ve exec şu şekilde başarısız olursa:

OCI runtime exec failed: exec failed: unable to start container process: exec: "bash": executable file not found in $PATH: unknown

Bu mesaj bir exec sorunu değildir. İmajın PATH dizinlerinde listelenen yerlerde bash bulunamadığını belirtir; bir kabuk için bu neredeyse her zaman imajın onu içermediği anlamına gelir. Alpine, /bin/sh olarak ash sağlayan BusyBox ile gelir ve bash içermez, bu yüzden sh isteyin:

docker compose exec web sh

Debian ve Ubuntu tabanlı imajlar, -slim etiketleri dahil olmak üzere, bash içerir; bash size komut geçmişi ve daha iyi tamamlama özellikleri sunar. Bu yüzden önce bash deneyin, başarısız olursa sh seçeneğine dönün. sh neredeyse tüm genel amaçlı imajlarda bulunur.

Bazı imajlar hiçbir kabuk içermez. Distroless imajlar ve FROM scratch ile oluşturulan imajlar, uygulama ikili dosyasını ve kütüphanelerini barındırır; başka hiçbir şey içermezler. Bu kasıtlıdır, çünkü orada olmayan bir kabuk size karşı kullanılamaz. Bu durumlarda sh aynı mesajla başarısız olur ve denenecek başka bir şey kalmaz. İki yaklaşım işe yarar. Google'ın distroless imajları, BusyBox kabuğu ekleyen :debug etiketlerini yayınlar, bu yüzden etiketi geçici olarak değiştirmek sizi içeri alır. Alternatif olarak, hedefin namespace'leri içinde ayrı bir container başlatın:

CID=$(docker compose ps -q web)
docker run --rm -it --network "container:$CID" --pid "container:$CID" nicolaka/netshoot

Artık netshoot araçlarını uygulamanın ağına yönlendirdiniz, bu sayede curl localhost:8080 ve ss -lntp sanki içerideymişsiniz gibi davranır. Gördüğünüz dosya sistemi uygulamaya değil, netshoot'a aittir. Süreç namespace'i paylaşıldığı için /proc/1/root/ hedef sürecin dosya sistemini işaret eder, ancak ls /proc/1/root/ çekirdeğin ptrace izin denetimini geçmelidir. Her iki sürecin de root olarak çalışması yeterli değildir: denetim ayrıca kimlik bilgilerini, yetenekleri (capabilities), hedefin dumpable özniteliğini ve güvenlik modüllerini dikkate alır. 1'den farklı bir dumpable değeri, çağıran süreç hedefin kullanıcı namespace'inde CAP_SYS_PTRACE yetkisine sahip değilse erişimi engeller. Docker varsayılan olarak SYS_PTRACE vermez. docker run satırına --cap-add SYS_PTRACE eklemek kimlik bilgisi ve dumpable denetimlerini çözer, ancak güvenlik modülleri erişimi yine de reddedebilir.

Servis çalışmadığında docker compose run --rm kullanın

exec komutu çalışan bir container gerektirir. Durdurulmuş bir servise işaret ettiğinde reddeder:

service "web" is not running

Sizin için hiçbir şeyi başlatmayacaktır. docker compose run ise başlatacaktır:

docker compose run --rm web bash

run komutu, web servis tanımından; aynı image, environment, volumes ve networks değerlerine sahip yeni bir container oluşturur ve servisin komutunu sizin yazdığınız komutla değiştirir. --rm, çıktığınızda bu container'ı siler. --rm seçeneğini kullanmazsanız, geriye kalanlar myproject-web-run-4f1c2b gibi isimler altında birikir. docker compose ps -a bunları listeler, docker compose rm ise servisin diğer durdurulmuş container'ları ile birlikte bunları kaldırır.

run komutunun iki davranışı kullanıcıları şaşırtır. --service-ports eklemediğiniz veya -p ile manuel olarak eşleme yapmadığınız sürece servisin portlarını dışarıya açmaz; bu kasıtlıdır: ilk container 8080 numaralı host portunu tutarken ikinci bir container'ın aynı porta bağlanması bind: address already in use hatasıyla başarısız olur. Ayrıca, shell ekranınız gelmeden önce servisin depends_on altında listelediği her şeyi başlatır; bu nedenle içeride hızlı bir inceleme yapmak bir veritabanını ve önbelleği başlatabilir. --no-deps bu işlemi atlar.

run komutu image'ın ENTRYPOINT değerini işler, exec ise işlemez. exec komutunuzu doğrudan mevcut container içinde başlatır, bu yüzden entrypoint betiği komutu görmez. run altında ise bash değeriniz o betiğe argüman olarak iletilir. Birçok resmi image, entrypoint'ini exec "$@" ile bitirir; böylece komut doğrudan geçer ve shell ekranına ulaşırsınız. Kendi argümanlarını yorumlayan bir betik ise bunlarla farklı bir işlem yapacaktır; bu durumda o çalıştırma için entrypoint'i değiştirmeniz gerekir:

docker compose run --rm --entrypoint sh web

exec altında çalışan bir komutun run altında farklı davranmasının en yaygın nedeni budur ve command ve entrypoint arasındaki ayrım, her seferinde image yapılandırmasının hangi yarısını değiştirdiğinizi açıklar.

exec mi run mı: nasıl seçim yapılır

  • exec komutu çalışan bir container gerektirir. run komutu ise gerektirmez ve run komutu bağımlılıkları başlatabilir.
  • exec, canlı süreç listesini ve uygulamanın başladığı andan itibaren yazdığı dosyalar dahil olmak üzere mevcut dosya durumunu görür. run komutu, imajdan temiz ve yazılabilir bir katman alır; ancak adlandırılmış volume'lar ve bind mount'lar, servisin mevcut verilerini yine de gösterir.
  • exec, entrypoint'i atlar. run ise onu çalıştırır.
  • run, --rm bayrağını kullanmadığınız sürece geride bir container bırakır.

Gerçekte neler olduğunu incelemek için exec kullanın. run --rm komutunu ise aynı ortamın tek kullanımlık bir kopyası için, bir defalık migration komutları çalıştırmak için veya gerçek servisin içine exec ile giremeyecek kadar kısa süre ayakta kaldığı durumlarda kullanın.

Faydalı exec bayrakları: kullanıcı, çalışma dizini ve kopyalar

Çoğu imaj root olmayan bir kullanıcıya düşer, bu nedenle exec kabuğunuzun içinde bir tanılama aracı kurmak burada durur:

E: Could not open lock file /var/lib/dpkg/lock-frontend - open (13: Permission denied)

-u root size aynı container içinde bir root kabuğu sağlar:

docker compose exec -u root web sh

-w /srv/app çalışma dizinini yalnızca o komut için ayarlar. -e KEY=value oturumunuza bir ortam değişkeni ekler, ancak bunu servise eklemez. Bir servis birden fazla kopya (replica) çalıştırdığında, --index 2 hangi container içine gireceğinize karar verir. Eğer mount edilmiş bir dizindeki dosya sahipliğinin peşindeyseniz, container imajlarında PUID ve PGID konusu, oraya kimin yazabileceğine kullanıcı adlarının değil, sayısal kimliklerin neden karar verdiğini açıklar.

Veritabanı container'ı içinde psql veya mysql kabuğuna erişim

İstemci zaten veritabanı imajının içinde olduğundan, ana makinede bir istemciye ihtiyacınız yoktur ve portu dışarıya açmanız gerekmez:

docker compose exec db psql -U postgres -d app
docker compose exec db mariadb -u root -p

Postgres imajları psql, MySQL imajları mysql ve MariaDB imajları mariadb içerir. Bağlantı container içinden yapıldığı için, compose dosyası hiçbir veritabanı portunu dışarıya açmasa bile bu yöntem çalışır. Docker'ın varsayılan köprü (bridge) ağ yapısında bu daha güvenli bir düzenlemedir: dış ana makineler yayınlanmamış bir veritabanı portuna doğrudan erişemez, ancak Docker ana makinesi ve aynı ağdaki diğer container'lar erişebilir.

Bir tuzak, kullanıcıların vaktini boşa harcamasına neden olur. Komut Docker'a ulaşmadan önce kabuğunuz değişkenleri ana makinede genişletir; bu nedenle -U "$POSTGRES_USER", değişken yalnızca container içinde mevcut olduğunda boş bir dizge gönderir. Tek tırnak işaretleri ve container içindeki bir kabuk, değişkeni doğru yerde genişletir:

docker compose exec db sh -c 'psql -U "$POSTGRES_USER" -d "$POSTGRES_DB"'

Burada komutsuz bir docker compose run --rm db kullanmaya çalışmayın. Bu, aynı veri birimi üzerinde ikinci bir Postgres sunucusu başlatmaya çalışır ve sunucu başlamayı reddeder:

FATAL:  lock file "postmaster.pid" already exists

Kilit dosyası görevini yapmaktadır; çünkü aynı veri dizinine yazan iki sunucu veriyi bozacaktır. Veritabanı çalışır durumdayken, çalışan container'a exec ile giriş yapın. Veritabanının Compose içinde yer alıp almaması ayrı bir karardır ve veritabanını Docker içinde veya ana makinede çalıştırma konusu bu kararın avantaj ve dezavantajlarını açıklamaktadır.

Başlangıçta konsola ihtiyaç duyan servisler: stdin_open ve tty

exec ve run komutları, elle açtığınız kabukları kapsar. Ana süreci doğası gereği etkileşimli olan bir servis, compose dosyasında iki anahtar gerektirir:

services:
  console:
    image: python:3.12-slim
    command: python
    stdin_open: true
    tty: true

stdin_open: true değeri docker run -i ve tty: true değeri docker run -t olmalıdır. Bu anahtarlar olmadan container başlar ve 0 koduyla hemen çıkar; docker compose ps -a ise Exited (0) çıktısını verir. Hiçbir şey çökmemiştir. stdin üzerinde terminal olmayan python, dosya sonunu (EOF) hemen okur ve normal şekilde kapanır; bu, kimsenin yazmadığı bir program için beklenen davranıştır.

Her iki anahtar da ayarlandığında, çalışan sürece şu şekilde bağlanın:

docker attach $(docker compose ps -q console)

Süreci çalışır durumda bırakarak ayrılmak için Ctrl-P ve ardından Ctrl-Q tuşlarını kullanın. Bu dizi yalnızca container hem bir TTY'ye sahip olduğunda hem de stdin açık olduğunda çalışır. Bunun yerine Ctrl-C kullanmak, PID 1'e bir kesme sinyali (SIGINT) gönderir. Bu, yalnızca program SIGINT ile çıkacak şekilde yazılmışsa servisi durdurur; çünkü Linux, PID 1'e varsayılan bir sinyal işleme mekanizması sağlamaz. Bu nedenle Ctrl-C'yi bir ayrılma yöntemi olarak kullanmayın.

Sıradan servisler için her iki anahtarı da kapalı tutun. Bir web sunucusu asla stdin okumaz ve tty: true, birçok programın bir insan tarafından izlendiğini varsayarak renkli çıktıya ve satır tamponlamaya geçmesine neden olur; bu da docker compose logs dosyasının kaçış kodlarıyla dolmasına yol açar.

Neden betik tabanlı exec cron ve CI ortamlarında hata verir: -T bayrağı

Terminalinizde çalışan bir exec komutu; bir betik çalıştırıldığında, cron işinde, sürekli entegrasyon (CI) çalıştırıcısında veya bir pipe (boru hattı) işleminde başarısız olabilir:

the input device is not a TTY

Compose, kendi çıktısı bir terminale gittiğinde bir sözde terminal (pseudo terminal) talep eder; eğer stdin bir terminal değilse, komutunuz çalışmadan önce bu talep başarısız olur. Güncel Docker CLI kaynakları aynı hatayı cannot attach stdin to a TTY-enabled container because stdin is not a terminal olarak ifade eder. Mevcut Compose, cron altında olduğu gibi çıktı yönlendirildiğinde veya pipe edildiğinde bu talebi kendiliğinden atlar. Bazı eski sürümler ise durum ne olursa olsun talep ederdi ve bugün bile kendi isteminizde yazdığınız cat dump.sql | docker compose exec db psql bunu tetiklemeye devam eder. -T, her durumda bu talebi devre dışı bırakır; bu nedenle algılama mekanizmasına güvenmek yerine betiklerinizde bu bayrağı kullanın:

0 3 * * * docker compose -f /srv/app/compose.yaml exec -T db pg_dump -U postgres -Fc app > /srv/backups/app.dump

-T ikinci bir nedenden dolayı önemlidir. Bir TTY, çıkış yolundaki bayt akışını yeniden yazar; bu nedenle bir TTY üzerinden geçen sıkıştırılmış bir döküm, hedefe hasarlı ulaşır. Yönlendirilen veya pipe edilen her türlü çıktı için açıkça -T bayrağını kullanın.

Cron ile ilgili iki detay daha bulunmaktadır. -f bayrağını mutlak bir yol (absolute path) ile birlikte kullanın; çünkü cron işi, compose dosyasının bulunmadığı ev dizininde çalıştırır ve Compose bu durumda no configuration file provided: not found hatasıyla durur. Ayrıca exec, çalıştırdığı komutun çıkış kodunu döndürür; bu nedenle başarısız olan bir pg_dump, boş bir yedek oluşturup başarılı raporu vermek yerine set -e altında betiğinizi başarısız duruma düşürür. Günlük kullanılan diğer komutların geri kalanı, betiklerinizin yanında bulundurmaya değer bir Compose komut kopya kağıdında toplanmıştır.

Konteyner içinde yaptığınız değişiklikler neden kaybolur

Bir aracı exec ile kurar, bir yapılandırma dosyasını düzenler ve sorunu çözersiniz; ancak bir hafta sonra yaptığınız düzeltme kaybolur. Bu, konteynerin yazılabilir katmanının tasarlandığı gibi çalışmasıdır. docker compose up -d, image etiketi veya servis tanımındaki herhangi bir değişiklikten sonra eski konteyneri yok eder ve image üzerinden yenisini oluşturur; bu durumda elle yapılan tüm düzenlemeler eski konteyner ile birlikte silinir.

docker compose restart ise farklıdır. Aynı konteyneri durdurup yeniden başlatır, bu nedenle elle yapılan düzenlemeler bu işlemden etkilenmez. Manuel bir düzeltmenin haftalarca kalıcı gibi görünüp alakasız bir güncelleme sırasında yok olmasının nedeni budur. Named volumes ve bind mounts her iki işlemde de varlığını korur, çünkü verileri konteynerin dışında yaşar. bind mounts and named volumes bölümü, saklamak istediğiniz veriler için hangisinin seçilmesi gerektiğini açıklar.

Bu nedenle exec kabuğunu yalnızca okuma ve test yapma alanı olarak görün. Düzeltmeyi belirledikten sonra, kalıcı olacağı yere yazın: bir paketi Dockerfile içine, bir ayarı ise compose dosyasına ekleyin. Ardından değişikliği uygulamak için docker compose up -d komutunu çalıştırın ve yeni konteynerin düzeltmeyi içerdiğini başka bir exec ile doğrulayın.

FAQ

docker compose exec ve docker compose run arasındaki fark nedir?

exec, halihazırda çalışan bir container içinde, ana süreçten bağımsız olarak bir komut çalıştırır ve image içindeki entrypoint'i atlar. run ise aynı servis tanımını, aynı image, environment, volume ve network ayarlarını kullanarak yeni bir container oluşturur, komutunuzu entrypoint üzerinden iletir ve önce tüm depends_on servislerini başlatır. run ayrıca, --service-ports veya bir -p eşlemesi eklemediğiniz sürece servisin portlarını dışarıya açmaz. Canlı servisi incelemek için exec kullanın. Servis durdurulmuşsa veya ayrı bir container gerekiyorsa run --rm kullanın; ancak named volume ve bind mount'ların paylaşıldığını unutmayın.

docker compose exec neden servisin çalışmadığını bildiriyor?

exec mevcut bir container'a bağlanır ve yeni bir tane oluşturamaz; bu nedenle durdurulmuş veya çökmüş bir servis service "web" is not running hatası verir. Exited (1) gibi bir durumla çıkış yapmış container'ları listeleyen docker compose ps -a komutunu kontrol edin ve durma nedenini öğrenmek için docker compose logs web komutunu okuyun. Yine de bir shell erişimi sağlamak için docker compose run --rm --entrypoint sh web komutunu çalıştırın. Bu, hatalı başlatma komutunun çalışmasına izin vermeden, aynı servis tanımından yeni bir container oluşturur.

Image içinde bash yoksa nasıl shell açabilirim?

docker compose exec web bash komutunun exec: "bash": executable file not found in $PATH hatası vermesi, container'ın PATH dizinlerinde bash bulunamadığı anlamına gelir; bu durum genellikle image'ın bash içermediğini gösterir. Alpine tabanlı yapılarda bu normaldir. BusyBox, /bin/sh sağladığı için docker compose exec web sh kullanın. Shell içermeyen bir image'da exec ile shell açılamaz ancak image içindeki çalıştırılabilir dosyalar yine de yürütülebilir. Yayıncı sunuyorsa image'ın :debug etiketine geçin veya docker compose ps -q web üzerinden alınan $CID ile hedef namespace'lerde bir hata ayıklama container'ı başlatmak için docker run --rm -it --network "container:$CID" --pid "container:$CID" nicolaka/netshoot kullanın.

exec komutum cron içinde neden "the input device is not a TTY" hatası veriyor?

docker compose exec, çıktısı bir terminale gittiğinde bir pseudo terminal talep eder ve stdin bir terminal değilse bu talep başarısız olur. Mevcut Compose, cron'da olduğu gibi çıktı yönlendirildiğinde bu talebi kendiliğinden atlar; ancak bazı eski sürümler bunu yine de talep eder ve etkileşimli bir shell'den exec'e girdi yönlendirmek de bu hatayı tetikler. Kapatmak için -T ekleyin: docker compose exec -T db pg_dump -U postgres app. TTY, bayt akışını değiştirip ikili dökümleri bozduğu için, yönlendirilmiş veya boru hattına (pipe) alınmış çıktılar için de -T kullanın. Cron içinde ayrıca compose dosyanızın mutlak yolunu içeren -f parametresini geçin, aksi takdirde Compose no configuration file provided: not found hatası ile sonlanır.

exec ile container içinde yaptığım değişiklikler yeniden başlatma sonrasında kalıcı olur mu?

Bu değişiklikler, aynı container'ı yeniden kullanan docker compose restart işleminden sonra kalıcı olur. Herhangi bir image veya yapılandırma değişikliğinden sonra yapılan docker compose up -d işleminde ise container image'dan yeniden oluşturulduğu ve yazılabilir katmanı atıldığı için bu değişiklikler kaybolur. Named volume veya bind mount içine yazılan veriler, container dışında yaşadıkları için her iki durumda da korunur. Tanısal değişiklikleri exec ile yapın, ardından kalıcı sürümü Dockerfile veya compose dosyasına işleyin.

Bu yazı işinize yaradı mı?