X'inhi d-differenza bejn ENTRYPOINT u CMD?

Question

Accepted Answer

**ENTRYPOINT** u **CMD** it-tnejn jiddefinixxu x'inġarr meta tibda kontejner, iżda jservu rwoli differenti u jinteraġixxu b'modi speċifiċi. Li tifhem id-differenza (u ż-żewġ formoli — exec versus shell) huwa importanti biex tikteb Dockerfiles li jkompportaw ruħhom b'mod korrett.

## CMD — il-kmand default (overridable)

```dockerfile
CMD ["node", "server.js"]
# → the DEFAULT command when the container starts
# → but it's REPLACED if you pass a command at run time:
#   docker run myapp echo hello   → runs "echo hello" INSTEAD of node server.js
```

`CMD` jipprovdi l-**kmand default**, li huwa **kompletament moverridat** minn kwalunkwe kmand mogħti fuq `docker run`.

## ENTRYPOINT — l-executable fisso

```dockerfile
ENTRYPOINT ["node", "server.js"]
# → ALWAYS runs; run-time arguments are APPENDED (not replacing it):
#   docker run myapp --port 8080   → runs "node server.js --port 8080"
# → makes the container behave like a specific executable
```

`ENTRYPOINT` jisset **executable fisso** li dejjem jinħarreġ; l-argumenti tal-ħin tal-exe huma **miżjuda** bħala argumenti tiegħu minflok li jirreplaċċahu.

## L-użu tagħhom flimkien (il-pattern komuni)

```dockerfile
ENTRYPOINT ["node", "server.js"]   # the fixed command
CMD ["--port", "3000"]              # DEFAULT arguments (overridable)
# docker run myapp                  → node server.js --port 3000 (defaults)
# docker run myapp --port 8080      → node server.js --port 8080 (CMD overridden)
→ ENTRYPOINT = the command; CMD = default arguments you can override. A clean pattern.
```

## Forma exec kontra forma shell

```text
EXEC form  → CMD ["node", "server.js"]  (JSON array) — PREFERRED:
  runs the executable DIRECTLY (PID 1) → receives signals (SIGTERM) → graceful shutdown
SHELL form → CMD node server.js  → runs via /bin/sh -c → the shell is PID 1,
  the app may NOT receive signals properly (shutdown issues) → avoid for the main process
```

## Għaliex hija importanti

Li tifhem id-differenza bejn ENTRYPOINT u CMD huwa importanti biex **tikteb Dockerfiles li jkompportaw ruħhom b'mod korrett**, iżda hija għarfien pratiku validu u t-tòpik ħafna konfuż.

Id-distinzjoni fil-komportament hija importanti: **CMD** jipprovdi kmand default li huwa **kompletament moverridat** minn kwalunkwe kmand mogħti lil `docker run`, filwaqt li **ENTRYPOINT** jisset executable fisso li dejjem jinħarreġ b'argumenti tal-ħin tal-exe **miżjuda** tiegħu — komportamenti differenti li jaffettwaw kif il-kontejner jirrispondi għall-argumenti tal-ħin tal-exe.

Li tifhem il-**pattern komuni ta' l-użu tagħhom flimkien** (`ENTRYPOINT` bħala l-kmand u `CMD` bħala argumenti default overridable) huwa approċċ nidif u idijomatiku li jagħmel il-kontejners jkompportaw ruħhom bħal esekutibbli konfigurabli — teknika użata ħafna li għaddej ta' jkun ta' konjizzjoni.

Critikament, li tifhem l-**forma exec kontra l-forma shell** huwa importanti għas-senilità: il-**forma exec** (array JSON, eż. `CMD ["node", "server.js"]`) hija preferita għax tinħarreġ l-executable **direttament bħala PID 1**, iżda hija **tirċievi sinjali bħal SIGTERM** b'mod korrett, li tippermetti **shutdown graċjuż** — filwaqt li l-**forma shell** (`CMD node server.js`) tinħarreġ permezz ta' shell li ssir PID 1, spiss il-każ li l-applikazzjoni **ma tirċievix sinjali ta' shutdown b'mod korrett** (li jwassalha għal terminazzjoni li mhix graċjuża, telf ta' xogħol mid-drift, jew waqqfiet bil-mod).

Had il-kwistjoni tal-handling tas-sinjali/graceful-shutdown hija problema reali u sottili li l-forma exec tipprevjenix.

Billi d-definizzjoni ta' x'inġarr meta tibda kontejner huwa fundamentali għal kull Dockerfile, u billi d-distinzjoni ta' ENTRYPOINT/CMD (u l-kwistjoni tal-exec-versus-shell-form signal-handling) affettwaw direttament il-komportament tal-kontejner u s-senilità (handling ta' argumenti, graceful shutdown), li tifhem ENTRYPOINT kontra CMD — ir-rwoli tagħhom, kif jikkombinaw, u l-prattika importanti tal-forma-exec-għall-isinjali — huwa għarfien Docker validu u pratiku, tòpik ħafna mifhum ħażin fejn li tifhem id-differenzi jipprevjeni bugs reali ta' komportament u ta' shutdown.