SSD Nodes Learn Hosting plans →
تعلیمی Matt Connorتحریر: Matt Connor · اپ ڈیٹ شدہ 2026-10-14

Docker Compose میں command اور entrypoint کا فرق

ENTRYPOINT پروگرام چلاتا ہے اور command اسے arguments دیتا ہے۔ Compose میں چاروں override صورتیں دیکھیں، اور جانیں کہ entrypoint set کرنے سے CMD کیوں صاف ہو جاتا ہے۔

Docker Compose میں command اور entrypoint کا فرق، ایک اصول میں

Docker Compose میں entrypoint: چلنے والے پروگرام کا تعین کرتا ہے، جبکہ command: اس پروگرام کو دی جانے والی arguments متعین کرتا ہے۔ Container کا process، entrypoint list اور اس کے آخر میں شامل command list پر مشتمل ہوتا ہے۔ اس صفحے کا ہر دوسرا رویہ اسی ایک جملے سے اخذ ہوتا ہے۔

یہ دونوں keys، Dockerfile کی دو instructions سے متعلق ہیں۔ entrypoint: image کے ENTRYPOINT کو replace کرتا ہے۔ command: image کے CMD کو replace کرتا ہے۔ یہ دونوں مستقل طور پر الگ نہیں ہیں، اور یہی وہ نکتہ ہے جہاں لوگ الجھتے ہیں: entrypoint: set کرنے سے image کا CMD بھی ختم ہو جاتا ہے۔ Compose specification میں یہ بات براہ راست بیان کی گئی ہے۔ اگر entrypoint non-null ہو تو Compose image کی default command کو نظر انداز کرتا ہے۔

جو کچھ image پہلے سے متعین کرتی ہے، اسے پڑھیں

کسی بھی چیز کو override کرنے سے پہلے دیکھیں کہ image کے ساتھ کیا فراہم کیا گیا ہے۔

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_* variables پڑھتی ہے، privileges کم کر کے postgres user کے طور پر چلتی ہے، اور آخر میں اسے دیے گئے arguments کو exec کرتی ہے۔ آپ کو اس setup کے کس حصے کو تبدیل کرنا ہے، اصل فیصلہ یہی ہے۔ Database کو کوئی flag دینے کے لیے command: کو replace کریں۔ اگر آپ entrypoint: کو replace کرتے ہیں تو یہ پورا setup بالکل نہیں چلتا۔

ایک مختصر image میں دکھائے گئے چار امتزاج

ایسی image بنائیں جس کا واحد کام یہ ہو کہ اسے شروع کرتے وقت دی گئی argument list پرنٹ کرے۔

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

ہر ترمیم کے بعد docker compose up چلائیں اور اس میں درج واحد سطر پڑھیں۔

  • دونوں keys set نہیں ہیں۔ process /bin/echo ep cmd ہے اور log میں ep cmd دکھتا ہے۔
  • صرف command: ["cmd2"]۔ process /bin/echo ep cmd2 ہے۔ entrypoint میں کوئی تبدیلی نہیں ہوتی، صرف arguments تبدیل ہوتے ہیں۔
  • صرف entrypoint: ["/bin/echo", "ep2"]۔ process /bin/echo ep2 ہے اور log میں ep2 دکھتا ہے۔ image سے cmd ختم ہو جاتا ہے، اور کوئی warning نہیں دی جاتی۔
  • دونوں keys set ہیں۔ process /bin/echo ep2 cmd2 ہے۔ یہی واحد صورت ہے جس میں آپ پوری argument list کو control کرتے ہیں۔

entrypoint مقرر کرنے سے image کا CMD کیوں ختم ہو جاتا ہے

کسی image کا CMD اسی image کے ENTRYPOINT کے لیے default argument list کے طور پر لکھا جاتا ہے۔ entrypoint تبدیل کرنے سے یہ arguments ایسے program سے متعلق رہتے ہیں جو اب چل نہیں رہا ہوتا۔ اس لیے Compose انہیں خارج کر دیتا ہے، بجائے اس کے کہ ایسی command line بنائے جس کا image author نے کبھی ارادہ نہیں کیا تھا۔ 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 code 0 کے ساتھ خارج ہو جاتا ہے، جبکہ کہیں بھی error message ظاہر نہیں ہوتا۔ Arguments خود دوبارہ شامل کریں:

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

اس اصول کو یاد رکھیں: جب بھی entrypoint: مقرر کریں، اسی ترمیم میں طے کریں کہ command: کیا ہونا چاہیے۔

Exec form اور shell form، اور Compose میں فرق

Dockerfile دو syntaxes قبول کرتا ہے۔ 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 کو arguments میں تقسیم کرکے براہِ راست execute کیا جاتا ہے، اور /bin/sh -c wrapper شامل نہیں ہوتا۔ Compose reference اس بارے میں واضح ہے: command field image میں متعین SHELL context کے اندر نہیں چلتا۔ اس لیے shell features درکار ہوں تو آپ کو خود shell invoke کرنا ہوگا۔

اسی لیے command: echo "hello $$HOSTNAME" literal text hello $HOSTNAME print کرتا ہے۔ کسی shell نے یہ string دیکھی ہی نہیں، اس لیے اسے expand نہیں کیا گیا۔ جب shell درکار ہو تو اسے واضح طور پر طلب کریں:

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 بھیجتے ہیں۔ یہ signal SIGTERM ہوتا ہے، جب تک image کا STOPSIGNAL یا service کا stop_signal: کوئی دوسرا signal مقرر نہ کرے۔ اس کے بعد Compose زیادہ سے زیادہ stop_grace_period تک انتظار کرتا ہے اور container کے اب بھی چلنے کی صورت میں ہی SIGKILL بھیجتا ہے۔ پہلے سے مقررہ grace period 10 seconds ہے۔

Linux میں PID 1 خصوصی حیثیت رکھتا ہے۔ kernel signal کا default action PID 1 پر لاگو نہیں کرتا۔ اس لیے جو process کوئی SIGTERM handler نصب نہیں کرتا، وہ PID 1 کے طور پر چلتے وقت SIGTERM کو نظرانداز کر دیتا ہے۔ وہ پورے grace period تک چلتا رہتا ہے، پھر اسے براہ راست ختم کر دیا جاتا ہے۔ اس سے کھلا connection یا commit نہ ہونے والا transaction منقطع ہو سکتا ہے۔

آپ کے program کے سامنے shell ہونے سے یہ مسئلہ زیادہ ممکن ہو جاتا ہے، کیونکہ shell PID 1 ہوتا ہے اور زیادہ تر shells اپنے child کو signals آگے نہیں بھیجتے۔ کچھ shells -c string میں آخری command کے ساتھ خود کو replace کر لیتے ہیں، اس لیے بعض اوقات آپ کا program پھر بھی PID 1 بن جاتا ہے۔ یہ shell اور عین string پر منحصر ہے، اس لیے اندازہ نہ لگائیں۔ اسے پڑھیں:

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

اگر PID 1 آپ کے program کے بجائے /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 کو fork کرنے کے بجائے shell process کو آپ کے program سے replace کرتا ہے۔ اس طرح آپ کا program PID 1 بن جاتا ہے اور signal وصول کرتا ہے۔

کچھ programs child processes بناتے ہیں مگر انہیں کبھی reap نہیں کرتے۔ اس سے zombie processes رہ جاتے ہیں، کیونکہ PID 1 reaper بھی ہوتا ہے۔ Compose میں اس کے لیے ایک switch موجود ہے:

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

init: true ایک چھوٹا init process بطور PID 1 چلاتا ہے۔ یہ signals آپ کے process تک پہنچاتا اور child processes کو reap کرتا ہے۔ stop_grace_period واقعی سست shutdown کے لیے زیادہ وقت فراہم کرتا ہے۔ اگر آپ کا program کوئی مختلف signal چاہتا ہے تو stop_signal: SIGQUIT اس signal کو تبدیل کرتا ہے جو Compose بھیجتا ہے۔ یہ دیکھنے کے لیے کہ image پہلے سے کیا مقرر کرتی ہے، docker image inspect --format '{{.Config.StopSignal}}' nginx:1.27 پڑھیں۔

اگر کسی stack میں docker compose down ہر service کے لیے ہمیشہ ten seconds لیتا ہے تو اس کا مطلب ہے کہ کوئی بھی SIGTERM handle نہیں کر رہا۔ tooling کو مورد الزام ٹھہرانے سے پہلے اسے درست کریں، اور یہ جاننے کے لیے کہ ہر subcommand کیا remove کرتا ہے، 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 healthchecks لکھنا جو درست طور پر ناکام ہوں دیکھیں۔

سرکاری image میں ایک flag شامل کرنا

زیادہ تر قارئین اسی مقصد کے لیے آئے ہیں۔ آپ postgres کے لیے ایک اضافی flag چاہتے ہیں، لیکن initialization 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 چلائیں اور تصدیق کریں کہ آپ کی توقع کے مطابق command merged output میں موجود ہے۔ Compose override files کو merge کرتے وقت command کو مکمل طور پر replace کرتا ہے، اس میں اضافہ نہیں کرتا۔ اس لیے دوسری file میں command: مقرر ہو تو وہ خاموشی سے غالب آ جاتی ہے۔

اوپر موجود ${POSTGRES_PASSWORD} کو Compose، container کے وجود میں آنے سے پہلے، host پر آپ کی .env file سے expand کرتا ہے۔ Compose میں environment files اور secrets میں بتایا گیا ہے کہ یہ value محفوظ طور پر کہاں رکھی جا سکتی ہے۔

docker compose run کے ساتھ ایک بار کی migration چلانا

docker compose run اسی service definition سے نیا container بناتا ہے اور service name کے بعد آپ جو command لکھتے ہیں، اس سے اصل command کو replace کر دیتا ہے۔ Image کا entrypoint پھر بھی چلتا ہے، اس لیے container اسی طرح تیار ہوتا ہے جیسے طویل مدت تک چلنے والا container تیار ہوتا ہے۔

docker compose run --rm app python manage.py migrate
  • --rm command ختم ہوتے ہی container حذف کر دیتا ہے۔ اس کے بغیر ہر run ایک stopped container چھوڑ دیتا ہے، جو docker compose ps -a میں دکھائی دیتا ہے۔
  • Ports publish نہیں کیے جاتے۔ run container service کے ports: کو نظرانداز کرتا ہے، جب تک آپ --service-ports شامل نہ کریں۔ اس لیے یہ پہلے سے چل رہی service کے ساتھ port collision نہیں کر سکتا۔
  • Dependencies پہلے start ہوتی ہیں۔ depends_on میں شامل ہر چیز آپ کی command سے پہلے start ہو جاتی ہے، جبکہ --no-deps اسے نظرانداز کرتا ہے۔
  • Container کو myproject-app-run-9f2c1a جیسا generated name دیا جاتا ہے، اس لیے یہ service container کے name سے کبھی متصادم نہیں ہوتا۔

Entrypoint کو بھی replace کرنے کے لیے ایک 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: دونوں کو مکمل طور پر نظرانداز کرتا ہے۔ ایسے task کے لیے run استعمال کریں جسے نئے container کی ضرورت ہو، اور چلتے ہوئے container کے اندر دیکھنے کے لیے exec استعمال کریں۔ Compose command کی مختصر رہنما میں باقی subcommands کا تقابلی جائزہ موجود ہے۔

میرا container فوراً کیوں exit ہو جاتا ہے؟

Exit code سے آغاز کریں، کیونکہ اس سے وجہ تیزی سے محدود ہو جاتی ہے۔

docker compose ps -a
docker compose logs app

Exit code 0 اور کوئی output نہیں۔ Command چلی اور مکمل ہو گئی۔ سب سے عام وجہ ایک entrypoint: override ہے، جس نے image کا CMD بھی ختم کر دیا۔ اس کے نتیجے میں entrypoint کو خالی argument list کے ساتھ چلایا گیا اور اس کے حوالے کرنے کے لیے کچھ نہیں تھا۔

ایسی error جو permission denied پر ختم ہو۔ Image کے اندر script پر executable bit موجود نہیں ہے۔ عموماً repository میں file پر یہ bit کبھی set نہیں کی گئی ہوتی۔ Build کے وقت اسے COPY --chmod=0755 entrypoint.sh /entrypoint.sh کے ذریعے set کریں۔

کسی ایسی file کے لیے no such file or directory پر ختم ہونے والی error جو image میں واضح طور پر موجود ہو۔ Script میں Windows line endings ہیں۔ اس کی پہلی line پھر #!/bin/sh کے ساتھ carriage return byte بھی پڑھتی ہے۔ اس لیے kernel ایسے interpreter کو تلاش کرتا ہے جس کے نام میں یہ byte شامل ہو، اور اسے نہیں پاتا۔ dos2unix entrypoint.sh چلائیں، پھر * text eol=lf کو .gitattributes میں شامل کریں تاکہ یہ مسئلہ دوبارہ پیدا نہ ہو۔

executable file not found in $PATH۔ command: میں نامزد program container کے PATH کی کسی directory میں موجود نہیں ہے۔ یا تو image میں وہ program شامل نہیں، یا اسے PATH کے باہر کسی جگہ install کیا گیا ہے؛ ایسی صورت میں اس کا مکمل path لکھیں۔ یا پھر آپ نے cd جیسا shell built-in لکھا ہے، جہاں صرف کوئی حقیقی program قابلِ استعمال ہو سکتا ہے۔

ایسی image میں shell حاصل کرنا جس کا entrypoint شروع ہوتے ہی fail ہو جائے

جب entrypoint کسی چیز کا معائنہ کرنے سے پہلے ہی بند ہو جائے تو اسے تبدیل کریں:

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

اگر یہ stat /bin/sh: no such file or directory کے ساتھ fail ہو تو image میں /bin/sh موجود نہیں ہے۔ Distroless اور scratch پر مبنی images میں اکثر 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 کو ہاتھ سے چلائیں اور دیکھیں کہ یہ کہاں رک جاتا ہے۔ اس طرح error message آپ کے terminal پر ظاہر ہوگا، نہ کہ ایسے container میں جو نصف سیکنڈ پہلے بند ہو چکا ہو۔ اگر آپ اب بھی اپنی پہلی stack تیار کر رہے ہیں تو VPS پر پہلی Compose stack میں file layout کی وضاحت موجود ہے جسے اوپر کی تمام ہدایات فرض کرتی ہیں۔

FAQ

میرے container کے docker compose up کے فوراً بعد بند ہونے کی وجہ کیا ہے؟

Exit code دیکھنے کے لیے docker compose ps -a چیک کریں۔ اگر کوئی output نہ ہو اور exit 0 آئے تو عموماً service پر entrypoint: set کیا گیا ہوتا ہے۔ اس سے image کا CMD بھی صاف ہو جاتا ہے۔ نتیجتاً entrypoint خالی argument list کے ساتھ چلتا ہے اور ختم ہو جاتا ہے۔ command: کے ذریعے arguments دوبارہ شامل کریں۔ permission denied پر ختم ہونے والی error کا مطلب ہے کہ entrypoint script پر executable bit موجود نہیں۔ اگر موجود file کے لیے no such file or directory پر ختم ہونے والی error آئے تو script میں Windows line endings ہیں۔ اس صورت میں اس کی shebang line ایسے interpreter کا نام دیتی ہے جو موجود نہیں۔

کیا Compose میں entrypoint set کرنے سے image کا CMD ختم ہو جاتا ہے؟

ہاں۔ اگر entrypoint non-null ہو تو Compose image میں declare کی گئی default command کو نظرانداز کرتا ہے۔ یہ documented behaviour ہے اور docker run --entrypoint سے مطابقت رکھتا ہے۔ وجہ یہ ہے کہ image کا CMD اس image کے ENTRYPOINT کے لیے arguments کے طور پر لکھا جاتا ہے۔ اس لیے entrypoint تبدیل کرنے کے بعد پرانے arguments کسی چیز سے متعلق نہیں رہتے۔ اگر نئے entrypoint کو اب بھی arguments درکار ہوں تو اسی service میں command: set کریں۔

کیا Compose میں موجود string command shell کے ذریعے چلتی ہے؟

نہیں۔ Dockerfile کے CMD کے برعکس، Compose میں موجود string command: کو arguments میں تقسیم کر کے براہ راست execute کیا جاتا ہے۔ اس کے لیے کوئی /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 کو دس seconds کیوں لگتے ہیں؟

Compose PID 1 کو stop signal بھیجتا ہے، جو image یا service کی طرف سے کوئی اور signal set نہ ہونے کی صورت میں SIGTERM ہوتا ہے۔ پھر یہ stop_grace_period تک انتظار کرتا ہے، جو default طور پر 10 seconds ہے۔ اگر container اس وقت تک چل رہا ہو تو Compose SIGKILL بھیجتا ہے۔ kernel PID 1 پر default signal actions لاگو نہیں کرتا۔ اس لیے SIGTERM handler کے بغیر کوئی program signal نظرانداز کر دیتا ہے اور مکمل مدت تک انتظار کرتا ہے۔ docker compose exec -T app cat /proc/1/cmdline | tr '\0' ' ' کے ذریعے معلوم کریں کہ PID 1 حقیقت میں کیا ہے۔ اگر یہ shell ہو تو image کو exec form پر منتقل کریں یا shell string کے اندر exec لکھیں۔ اگر process ایسے child processes بناتا ہے جنہیں وہ کبھی reap نہیں کرتا تو service پر init: true set کریں۔

کیا یہ مضمون مفید تھا؟