SSD Nodes Learn Hosting plans →
নির্দেশিকা Matt Connorদ্বারা Matt Connor · আপডেট করা হয়েছে 2026-10-23

Docker Compose-এ command বনাম entrypoint: পার্থক্য কী

ENTRYPOINT প্রোগ্রাম চালায়, আর command তার argument দেয়। Compose-এ চারটি override সমন্বয় দেখুন এবং কেন entrypoint সেট করলে image-এর CMD মুছে যায় তা জানুন।

Docker Compose-এর command বনাম entrypoint: একটি নিয়মে

Docker Compose-এ entrypoint: চালু হওয়া প্রোগ্রাম নির্ধারণ করে, আর command: সেই প্রোগ্রামে পাঠানো argument নির্ধারণ করে। Container-এর process হলো entrypoint list, যার শেষে command list যুক্ত হয়। এই পৃষ্ঠার অন্য সব আচরণ ওই একটি বাক্য থেকেই বোঝা যায়।

এই দুটি key Dockerfile-এর দুটি instruction-এর সঙ্গে সম্পর্কিত। entrypoint: image-এর ENTRYPOINT প্রতিস্থাপন করে। command: image-এর CMD প্রতিস্থাপন করে। এগুলো স্বাধীন নয়। এখানেই সাধারণত সমস্যা হয়: entrypoint: নির্ধারণ করলেও image-এর CMD বাদ পড়ে। Compose specification-এ বিষয়টি সরাসরি বলা আছে। entrypoint non-null হলে Compose image থেকে আসা default command উপেক্ষা করে।

ইমেজে ইতিমধ্যে ঘোষিত বিষয়গুলো দেখুন

কোনো কিছু override করার আগে ইমেজের সঙ্গে থাকা ঘোষণাগুলো দেখুন।

docker image inspect --format '{{json .Config.Entrypoint}}' postgres:16
docker image inspect --format '{{json .Config.Cmd}}' postgres:16

আপনি ["docker-entrypoint.sh"] এবং ["postgres"] দেখতে পাচ্ছেন। তাই container docker-entrypoint.sh postgres চালায়। এই script প্রথম boot-এর সময় data directory তৈরি করে, POSTGRES_* variable পড়ে, privileges কমিয়ে postgres user-এ নিয়ে যায় এবং শেষে তাকে দেওয়া arguments exec করে। কোন অংশটি পরিবর্তন করতে চান, সিদ্ধান্তটি মূলত তার ওপরই নির্ভর করে। Database-এ কোনো flag পাঠাতে হলে command: প্রতিস্থাপন করুন। entrypoint: প্রতিস্থাপন করলে এই setup-এর কোনো অংশই আর চালানো হবে না।

চারটি সমন্বয়, একটি ছোট ছবিতে দেখানো

এমন একটি image তৈরি করুন, যার একমাত্র কাজ হলো এটি যে argument list দিয়ে শুরু হয়েছে তা print করা।

FROM alpine:3.20
ENTRYPOINT ["/bin/echo", "ep"]
CMD ["cmd"]
docker build -t argdemo .
services:
  demo:
    image: argdemo

প্রতিটি edit-এর পরে docker compose up চালান এবং এটি যে এক লাইনের log লিখেছে তা পড়ুন।

  • কোনো key set করা নেই। Process হলো /bin/echo ep cmd এবং log-এ ep cmd দেখা যায়।
  • শুধু command: ["cmd2"]। Process হলো /bin/echo ep cmd2। Entrypoint অপরিবর্তিত থাকে, শুধু argument পরিবর্তিত হয়।
  • শুধু entrypoint: ["/bin/echo", "ep2"]। Process হলো /bin/echo ep2 এবং log-এ ep2 দেখা যায়। Image-এর cmd বাদ পড়ে, এবং কোনো warning দেখানো হয় না।
  • উভয় key set করা আছে। Process হলো /bin/echo ep2 cmd2। সম্পূর্ণ argument list নিয়ন্ত্রণ করার একমাত্র পরিস্থিতি এটি।

entrypoint সেট করলে image-এর CMD কেন মুছে যায়

একটি image-এর CMD ওই image-এর ENTRYPOINT-এর জন্য ডিফল্ট argument list হিসেবে লেখা থাকে। entrypoint প্রতিস্থাপন করলে সেই argument-গুলো এমন একটি program-এর জন্য নির্ধারিত থাকে, যা আর চলছে না। তাই Compose সেগুলো বাদ দেয়। image-এর লেখক যে command line নির্ধারণ করেননি, Compose তা তৈরি করে না। docker run --entrypoint-ও একইভাবে কাজ করে। তাই এটি Compose-এর বিশেষ আচরণ নয়; এটি Docker-এর আচরণ।

এর ফল সরাসরি দেখা যায়। nginx:1.27-এ ENTRYPOINT ["/docker-entrypoint.sh"] এবং CMD ["nginx", "-g", "daemon off;"] নির্ধারিত আছে। entrypoint: /custom-init.sh সেট করলে আপনার script খালি argument list নিয়ে শুরু হয়। সাধারণত exec "$@" দিয়ে শেষ হওয়া script-এর কাছে তখন exec করার মতো কিছু থাকে না। ফলে exec কিছু করে না, script তার শেষ লাইনে পৌঁছে যায়, এবং container কোনো error message ছাড়াই code 0 দিয়ে বন্ধ হয়ে যায়। নিজে arguments যোগ করুন:

services:
  web:
    image: nginx:1.27
    entrypoint: /custom-init.sh
    command: ["nginx", "-g", "daemon off;"]

মনে রাখার নিয়ম: যখনই entrypoint: সেট করবেন, একই পরিবর্তনে command: কী হবে তা নির্ধারণ করুন।

Exec form ও shell form এবং Compose যেভাবে আলাদা

Dockerfile দুটি syntax গ্রহণ করে। CMD ["nginx", "-g", "daemon off;"] হলো exec form: binary সরাসরি চলে, কোনো shell ব্যবহৃত হয় না। CMD nginx -g "daemon off;" হলো shell form: Docker এটিকে /bin/sh -c 'nginx -g "daemon off;"' হিসেবে পুনর্লিখন করে। তাই প্রথমে একটি shell চলে এবং আপনার program তার child হিসেবে চলে।

Compose একই নিয়ম অনুসরণ করে না, যা অনেককে বিভ্রান্ত করে। command:-এর একটি string argument-এ বিভক্ত হয়ে সরাসরি execute হয়; কোনো /bin/sh -c wrapper ব্যবহৃত হয় না। Compose reference-এ বিষয়টি স্পষ্টভাবে বলা আছে: command field image-এ নির্ধারিত SHELL context-এর মধ্যে চলে না। তাই shell feature প্রয়োজন হলে আপনাকেই নিজে shell invoke করতে হবে।

এই কারণেই command: echo "hello $$HOSTNAME" আক্ষরিক text hello $HOSTNAME print করে। কোনো shell string-টি process করেনি, তাই কিছু expand হয়নি। shell ব্যবহার করতে চাইলে shell-কে explicitভাবে invoke করুন:

services:
  demo:
    image: alpine:3.20
    command: /bin/sh -c 'echo "hello $$HOSTNAME"'

Signals, PID 1 এবং পরিচ্ছন্ন docker compose down

docker compose stop এবং docker compose down প্রতিটি container-এর ভেতরের PID 1-এ container-এর stop signal পাঠায়। Image-এর STOPSIGNAL অথবা service-এর stop_signal: ভিন্ন signal নির্ধারণ না করলে সেই signal হলো SIGTERM। এরপর Compose সর্বোচ্চ stop_grace_period পর্যন্ত অপেক্ষা করে এবং container তখনও চলমান থাকলে শুধু তখনই SIGKILL পাঠায়। Default grace period হলো 10 seconds।

Linux-এ PID 1 বিশেষ। Kernel PID 1-এর ক্ষেত্রে signal-এর default action প্রয়োগ করে না। তাই PID 1 হিসেবে চলার সময় কোনো process SIGTERM handler ইনস্টল না করলে SIGTERM উপেক্ষা করে। এটি পুরো grace period ধরে চলতে থাকে। এরপর process-টিকে সরাসরি kill করা হয়। এতে খোলা connection বা commit না হওয়া transaction বিচ্ছিন্ন হয়ে যায়।

আপনার program-এর সামনে একটি shell থাকলে এই সমস্যা আরও সম্ভাব্য হয়। কারণ shell-টি PID 1 থাকে এবং অধিকাংশ shell child process-এ signal forward করে না। কিছু shell -c string-এর শেষ command দিয়ে নিজেদের প্রতিস্থাপন করে। তাই কখনও কখনও আপনার program-ই PID 1 হয়। এটি shell এবং নির্দিষ্ট string-এর ওপর নির্ভর করে। তাই অনুমান করবেন না। পরীক্ষা করুন:

docker compose exec -T web cat /proc/1/cmdline | tr '\0' ' '; echo

আপনার program-এর বদলে PID 1 হিসেবে /bin/sh -c ... দেখা গেলে দুটি সমাধান আছে। Image-এ exec form ব্যবহার করুন। অথবা shell রেখে exec দিয়ে process-এর দায়িত্ব হস্তান্তর করুন:

services:
  web:
    image: myapp:1.4
    command: /bin/sh -c 'exec myapp --config /etc/myapp.toml'

exec child process fork না করে shell process-কে আপনার program দিয়ে প্রতিস্থাপন করে। ফলে আপনার program PID 1 পায় এবং signal গ্রহণ করে।

কিছু program child process তৈরি করে কিন্তু সেগুলো কখনও reap করে না। এর ফলে zombie process থেকে যায়। কারণ PID 1 reaper হিসেবেও কাজ করে। Compose-এ এর জন্য একটি switch আছে:

services:
  web:
    image: myapp:1.4
    init: true
    stop_grace_period: 30s

init: true PID 1 হিসেবে একটি ছোট init process চালায়। এটি আপনার process-এ signal forward করে এবং child process reap করে। stop_grace_period সত্যিই ধীর shutdown-এর জন্য আরও সময় দেয়। আপনার program যদি ভিন্ন signal প্রত্যাশা করে, stop_signal: SIGQUIT Compose কোন signal পাঠাবে তা পরিবর্তন করে। কোনো image ইতিমধ্যে কী চেয়েছে তা docker image inspect --format '{{.Config.StopSignal}}' nginx:1.27 দিয়ে দেখুন।

যে stack-এ docker compose down প্রতিটি service-এর জন্য সবসময় দশ seconds নেয়, সেটি জানায় যে SIGTERM সামলানোর মতো কিছু নেই। Tooling-কে দোষ দেওয়ার আগে এটি ঠিক করুন। প্রতিটি subcommand কী সরিয়ে দেয়, তা জানতে docker compose down এবং stop-এর পার্থক্য দেখুন।

একই exec বনাম shell বিভাজন আরও একটি জায়গায় দেখা যায়। test: ["CMD", "curl", "-f", "http://localhost/"] হিসেবে লেখা healthcheck binary সরাসরি চালায়। অন্যদিকে test: ["CMD-SHELL", "curl -f http://localhost/ || exit 1"] shell-এর মাধ্যমে চলে, যাতে ||-এর অর্থ কার্যকর হয়। এই field-এর বাকি বিষয় জানতে সঠিকভাবে ব্যর্থ হওয়া Compose healthcheck লেখা দেখুন।

একটি অফিসিয়াল image-এ একটি flag যোগ করা

বেশিরভাগ পাঠক এই বিষয়টির জন্যই এসেছেন। আপনি postgres-এ আরও একটি flag যোগ করতে চান, কিন্তু initialisation script-এ কোনো পরিবর্তন করতে চান না।

services:
  db:
    image: postgres:16
    environment:
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    volumes:
      - pgdata:/var/lib/postgresql/data
    command: postgres -c max_connections=200 -c shared_buffers=256MB

volumes:
  pgdata:

শুধু command: পরিবর্তন হয়েছে। তাই docker-entrypoint.sh এখনও চলে এবং আপনি যে command দিয়েছেন সেটিই এখনও exec করে। অনুমান না করে ফলাফল পরীক্ষা করুন:

docker compose up -d db
docker compose exec -T db psql -U postgres -c 'show max_connections;'

আউটপুটে 200 দেখা উচিত। যদি এখনও 100 দেখা যায়, docker compose config চালান এবং merged output-এ প্রত্যাশিত command আছে কি না নিশ্চিত করুন। Compose override file merge করার সময় command-কে সরাসরি প্রতিস্থাপন করে; এর সঙ্গে নতুন কিছু যোগ করে না। তাই দ্বিতীয় কোনো file-এ command: সেট থাকলে সেটিই নীরবে কার্যকর হয়।

উপরের ${POSTGRES_PASSWORD}-টি container তৈরি হওয়ার আগে host-এ আপনার .env file থেকে Compose expand করে। সেই value নিরাপদে কোথায় রাখা যায়, তা Compose-এ environment file ও secret-এ ব্যাখ্যা করা হয়েছে।

docker compose run ব্যবহার করে একবারের migration চালানো

docker compose run একই service definition থেকে একটি নতুন container তৈরি করে এবং service name-এর পরে আপনি যে command লিখেছেন, সেটি দিয়ে মূল command প্রতিস্থাপন করে। Image-এর entrypoint চালু থাকে। তাই container-টি দীর্ঘসময় চালু থাকা container-এর মতোই প্রস্তুত হয়।

docker compose run --rm app python manage.py migrate
  • --rm command শেষ হলে container মুছে দেয়। এটি না থাকলে প্রতিটি run-এর পরে একটি stopped container থেকে যায়, যা docker compose ps -a-এ দেখা যায়।
  • Port publish করা হয় না। একটি run container service-এর ports: উপেক্ষা করে, যদি না আপনি --service-ports যোগ করেন। তাই এটি ইতিমধ্যে চালু থাকা service-এর সঙ্গে port সংঘর্ষ তৈরি করতে পারে না।
  • Dependency আগে চালু হয়। depends_on-এ থাকা সবকিছু আপনার command চালানোর আগে চালু হয়, আর --no-deps সেটি এড়িয়ে যায়।
  • Container-এর জন্য myproject-app-run-9f2c1a-এর মতো একটি generated name ব্যবহার করা হয়। তাই এটি কখনো service container-এর নামের সঙ্গে সংঘর্ষ তৈরি করে না।

Entrypoint-ও প্রতিস্থাপন করতে হলে একটি flag আছে:

docker compose run --rm --entrypoint /bin/sh app -c 'python manage.py migrate'

ফলাফল হিসেবে argument list হয় /bin/sh -c 'python manage.py migrate', কারণ service name-এর পরে থাকা শব্দগুলোই command হিসেবে ব্যবহৃত হয়। docker compose exec হলো অন্য tool, এবং এটি ভিন্নভাবে কাজ করে: এটি ইতিমধ্যে চালু থাকা container-এর ভেতরে একটি process চালায় এবং entrypoint: ও command: উভয়ই সম্পূর্ণ উপেক্ষা করে। নতুন container প্রয়োজন এমন task-এর জন্য run ব্যবহার করুন। ইতিমধ্যে চালু থাকা container-এর ভেতরের অবস্থা দেখার জন্য exec ব্যবহার করুন। Compose command cheat sheet-এ বাকি subcommand-গুলো পাশাপাশি দেখানো হয়েছে।

আমার container কেন সঙ্গে সঙ্গে বন্ধ হয়ে যায়?

প্রথমে exit code দেখুন। এতে কারণ দ্রুত সংকুচিত করা যায়।

docker compose ps -a
docker compose logs app

Exit code 0 এবং কোনো output নেই। কমান্ডটি চলেছে এবং শেষ হয়েছে। সবচেয়ে সাধারণ কারণ হলো একটি entrypoint: override, যা image-এর CMD-কেও সরিয়ে দিয়েছে। ফলে entrypoint খালি argument list নিয়ে চলেছে এবং hand off করার মতো কিছু পায়নি।

permission denied দিয়ে শেষ হওয়া একটি error। image-এর ভেতরে script-টির executable bit নেই। সাধারণত repository-এর file-এ এই bit কখনো সেট করা হয়নি। Build-এর সময় COPY --chmod=0755 entrypoint.sh /entrypoint.sh দিয়ে এটি সেট করুন।

image-এ file-টি স্পষ্টভাবে দেখা গেলেও no such file or directory দিয়ে শেষ হওয়া একটি error। script-এ Windows line ending আছে। ফলে এর প্রথম line হিসেবে #!/bin/sh-এর সঙ্গে একটি carriage return byte পড়ে। তাই kernel নামের মধ্যে ওই byte-সহ একটি interpreter খোঁজে এবং কিছু পায় না। dos2unix entrypoint.sh চালান। এরপর * text eol=lf-কে .gitattributes-এ যোগ করুন, যাতে সমস্যাটি আবার না আসে।

executable file not found in $PATH। command:-এ উল্লেখ করা program-টি container-এর PATH-এর কোনো directory-তে নেই। হয় image-এ এটি নেই, নয়তো PATH-এর বাইরে কোথাও install করা আছে—সে ক্ষেত্রে এর পূর্ণ path লিখুন। অথবা যেখানে কেবল প্রকৃত program ব্যবহার করা যায়, সেখানে cd-এর মতো shell built-in লিখেছেন।

যে image-এর entrypoint ব্যর্থ হয়, তাতে shell চালু করা

কিছু পরীক্ষা করার আগেই entrypoint বন্ধ হয়ে গেলে, সেটি প্রতিস্থাপন করুন:

docker compose run --rm --entrypoint /bin/sh app

এতে stat /bin/sh: no such file or directory দেখালে image-এ কোনো /bin/sh নেই। Distroless এবং scratch-ভিত্তিক image-এ প্রায়ই কোনো shell থাকে না। Entrypoint চালু না করেও বাইরে থেকে filesystem পড়তে পারবেন:

docker create --name probe myapp:1.4
docker export probe | tar -tv | head -40
docker rm probe

বারবার attach করার জন্য container-কে চালু রাখতে হলে, সেটিকে এমন একটি process-এ চালান যা কখনও exit করে না। এটি এমন একটি override file-এ রাখুন, যেটি commit করবেন না:

services:
  app:
    entrypoint: ["tail", "-f", "/dev/null"]
    command: []

command: [] কঠোরভাবে প্রয়োজনীয় নয়, কারণ entrypoint: সেট করলেই image-এর CMD ইতিমধ্যে মুছে গেছে। তবে এটি লিখলে পরেরবার file পড়া ব্যক্তি আপনার উদ্দেশ্য বুঝতে পারবেন। এটি চালু করুন এবং ভেতরে প্রবেশ করুন:

docker compose -f compose.yaml -f compose.debug.yaml up -d app
docker compose exec app /bin/sh

এখন প্রকৃত entrypoint হাতে চালান এবং কোথায় এটি থেমে যায় তা monitor করুন। এতে error message আধা সেকেন্ড আগে বন্ধ হয়ে যাওয়া container-এর মধ্যে না থেকে আপনার terminal-এ দেখা যাবে। আপনি যদি এখনও প্রথম stack তৈরি করে থাকেন, VPS-এ প্রথম Compose stack উপরের সবকিছু যে file layout ধরে নেয়, তা ব্যাখ্যা করে।

FAQ

আমার container docker compose up চালানোর পরই কেন বন্ধ হয়ে যায়?

Exit code দেখতে docker compose ps -a পরীক্ষা করুন। কোনো output ছাড়া exit 0 হলে সাধারণত service-এ entrypoint: সেট করা হয়েছে। এর ফলে image-এর CMD-ও মুছে গেছে, তাই entrypoint খালি argument list নিয়ে চালিয়ে শেষ হয়ে গেছে। command: ব্যবহার করে argument-গুলো আবার যোগ করুন। permission denied দিয়ে শেষ হওয়া error মানে entrypoint script-এ executable bit নেই। বিদ্যমান কোনো file-এর ক্ষেত্রে no such file or directory দিয়ে শেষ হওয়া error মানে script-এ Windows line ending আছে। ফলে এর shebang line এমন interpreter নির্দিষ্ট করছে, যা সেখানে নেই।

Compose-এ entrypoint সেট করলে কি image-এর CMD সরিয়ে যায়?

হ্যাঁ। entrypoint non-null হলে Compose image-এ ঘোষিত default command উপেক্ষা করে। এটি নথিভুক্ত আচরণ এবং docker run --entrypoint-এর সঙ্গে সামঞ্জস্যপূর্ণ। কারণ image-এর CMD ওই image-এর ENTRYPOINT-এর argument হিসেবে লেখা থাকে। তাই entrypoint পরিবর্তন করলে পুরনো argument-গুলো আর কোনো কিছুর সঙ্গে যুক্ত থাকে না। নতুন entrypoint-এর এখনও argument প্রয়োজন হলে একই service-এ command: সেট করুন।

Compose-এর command-এ string দিলে কি সেটি shell-এর মাধ্যমে চালানো হয়?

না। Dockerfile-এর CMD-এর বিপরীতে, Compose-এর command:-এ string argument-এ বিভক্ত করে সরাসরি চালানো হয়; কোনো /bin/sh -c wrapper থাকে না। তাই Compose container-এর ভিতরে shell চালিয়ে আপনার হয়ে $VARIABLE expand করে না। shell প্রয়োজন হলে নিজেই সেটি call করুন, যেমন command: /bin/sh -c 'echo "hello $$HOSTNAME"'-এ দেখানো হয়েছে। দ্বিগুণ $$ dollar sign escape করে। ফলে Compose সেটি host-এ expand না করে container-এ পাঠায়।

একটি container-এর জন্য docker compose down চালাতে দশ সেকেন্ড কেন লাগে?

Compose PID 1-এ stop signal পাঠায় (image বা service অন্য কিছু সেট না করলে SIGTERM), সর্বোচ্চ stop_grace_period অপেক্ষা করে (ডিফল্টভাবে 10 seconds), তারপর container চলতে থাকলে SIGKILL পাঠায়। Kernel PID 1-এর ক্ষেত্রে default signal action প্রয়োগ করে না। তাই কোনো program-এ SIGTERM handler না থাকলে সেটি signal উপেক্ষা করে এবং পুরো সময়সীমা শেষ হওয়া পর্যন্ত অপেক্ষা করে। docker compose exec -T app cat /proc/1/cmdline | tr '\0' ' ' ব্যবহার করে প্রকৃতপক্ষে PID 1 কী তা দেখুন। এটি shell হলে image-কে exec form-এ পরিবর্তন করুন অথবা shell string-এর মধ্যে exec লিখুন। process child process তৈরি করলেও সেগুলো কখনো reap না করলে service-এ init: true সেট করুন।

এই লেখাটি কি কাজে লেগেছে?