Jaký je rozdíl mezi ENTRYPOINT a CMD?

Question

Accepted Answer

**ENTRYPOINT** a **CMD** oba definují, co se spustí při startu kontejneru, ale slouží různým rolím a interagují určitými způsoby. Pochopení rozdílu (a dvou forem — exec vs shell) je důležité pro psaní Dockerfile, který se chová správně.

## CMD — výchozí příkaz (přepáčitelný)

```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` poskytuje **výchozí příkaz**, který je **zcela nahrazen** jakýmkoli příkazem zadaným v `docker run`.

## ENTRYPOINT — pevný spustitelný soubor

```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` nastaví **pevný spustitelný soubor**, který se vždy spustí; argumenty za běhu jsou **přidány** jako jeho argumenty, místo aby jej nahradily.

## Jejich společné použití (běžný vzor)

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

## Exec forma vs shell forma

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

## Proč na tom záleží

Pochopení rozdílu mezi ENTRYPOINT a CMD je důležité pro **psaní Dockerfile, který se chová správně**, takže to je cenná praktická znalost a běžně matoucí téma.

Rozdíl v chování je důležitý: **CMD** poskytuje výchozí příkaz, který je **zcela nahrazen** jakýmkoli příkazem předaným `docker run`, zatímco **ENTRYPOINT** nastavuje pevný spustitelný soubor, který se vždy spustí s argumenty za běhu **přidanými** k němu — různé chování, které ovlivňuje, jak kontejner reaguje na argumenty za běhu.

Pochopení **běžného vzoru jejich společného použití** (`ENTRYPOINT` jako příkaz a `CMD` jako přepáčitelné výchozí argumenty) je čistý, idiomatický přístup, který změní kontejnery v chování jako konfigurovatelné spustitelné soubory — široko používaná technika, kterou stojí znát.

Kriticky je důležité pochopit **exec formu vs shell formu**: **exec forma** (pole JSON, např. `CMD ["node", "server.js"]`) je preferována, protože spustí spustitelný soubor **přímo jako PID 1**, takže **přijímá signály jako SIGTERM** správně, umožňujíc **graceful shutdown** — zatímco **shell forma** (`CMD node server.js`) běží přes shell, který se stane PID 1, často způsobuje, že aplikace **nenachází signály vypnutí správně** (vede k nečistnému vypnutí, ztrátě probíhající práce nebo pomalému zastavení).

Tent problém se zpracováním signálů/graceful shutdownem je skutečný, jemný problém, kterému exec forma zabraňuje.

Protože definování, co se spustí při startu kontejneru, je základní pro každý Dockerfile, a protože rozdíl ENTRYPOINT/CMD (a otázka exec-vs-shell-form signal-handling) přímo ovlivňuje chování kontejneru a správnost (zpracování argumentů, graceful shutdown), pochopení ENTRYPOINT vs CMD — jejich rolí, jak se kombinují, a důležité praxe exec-form-for-signals — je cenná, prakticky relevantní znalost Dockeru, běžně nepochopené téma, kde pochopení rozdílů zabraňuje skutečným chybám chování a shutdownu.