Care este diferența dintre ENTRYPOINT și CMD?

Question

Care este diferența dintre ENTRYPOINT și CMD?

Accepted Answer

**ENTRYPOINT** și **CMD** definesc ambele ce se execută atunci când un container se pornește, dar au roluri diferite și interacționează în moduri specifice. Înțelegerea diferenței (și a celor două forme — exec vs shell) este importantă pentru a scrie Dockerfile-uri care se comportă corect.

## CMD — comanda implicită (suprascrieibilă)

```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` oferă **comanda implicită**, care este **complet suprascrisă** de orice comandă dată la `docker run`.

## ENTRYPOINT — executabilul fix

```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` stabilește un **executabil fix** care se execută întotdeauna; argumentele din timp de rulare sunt **adăugate** ca argumente ale acestuia, mai degrabă decât să-l înlocuiască.

## Folosindu-le împreună (modelul obișnuit)

```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 vs 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
```

## De ce conteaza

Înțelegerea diferenței dintre ENTRYPOINT și CMD este importantă pentru **a scrie Dockerfile-uri care se comportă corect**, deci este cunoștințe practice valoroase și un subiect frecvent confuz.

Distincția în comportament conteaza: **CMD** oferă o comandă implicită care este **complet suprascrisă** de orice comandă transmisă la `docker run`, în timp ce **ENTRYPOINT** stabilește un executabil fix care se execută întotdeauna cu argumente din timp de rulare **adăugate** la acesta — comportamente diferite care afectează modul în care containerul răspunde la argumentele din timp de rulare.

Înțelegerea **modelului obișnuit de a le folosi împreună** (`ENTRYPOINT` ca comandă și `CMD` ca argumente implicite suprascrieibile) este o abordare curată și idiomatică care face ca containerele să se comporte ca executabile configurabile — o tehnică larg utilizată care merită să o cunoașteți.

Critic, înțelegerea **formei exec vs forma shell** este importantă pentru corectitudinea: **forma exec** (tablou JSON, de exemplu `CMD ["node", "server.js"]`) este preferată deoarece execută executabilul **direct ca PID 1**, deci **primește semnale ca SIGTERM** corect, permițând **oprirea gracioasă** — în timp ce **forma shell** (`CMD node server.js`) se execută printr-un shell care devine PID 1, adesea determinând aplicația să **nu primească semnalele de oprire corect** (dând la închidere negracios, lucru pierdut în zbor sau opriri lente).

Aceast problem de gestionare a semnalelor/oprire gracios este o problemă reală și subtilă pe care forma exec o evită.

Deoarece definirea a ceea ce se execută atunci când se pornește un container este fundamental pentru fiecare Dockerfile, și deoarece distincția ENTRYPOINT/CMD (și problema exec-vs-shell-form de gestionare a semnalelor) afectează direct comportamentul și corectitudinea containerului (gestionarea argumentelor, oprire gracios), înțelegerea ENTRYPOINT vs CMD — rolurile lor, cum se combină și practica importantă exec-form-for-signals — este cunoștințe Docker valoroase, practic relevante, un subiect frecvent neînțeles unde înțelegerea diferențelor previne probleme reale de comportament și oprire.