Apakah perbezaan antara ENTRYPOINT dan CMD?

Question

Accepted Answer

**ENTRYPOINT** dan **CMD** kedua-duanya mentakrifkan apa yang berjalan apabila sesuatu kontena bermula, tetapi mereka memainkan peranan berbeza dan berinteraksi dengan cara yang khusus. Memahami perbezaan ini (dan dua bentuknya — exec lwn shell) adalah penting untuk menulis Dockerfile yang berkelakuan dengan betul.

## CMD — perintah lalai (boleh ditindih)

```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` menyediakan **perintah lalai**, yang **ditindih sepenuhnya** oleh sebarang perintah yang diberikan pada `docker run`.

## ENTRYPOINT — executable tetap

```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` menetapkan **executable tetap** yang sentiasa berjalan; argumen masa-jalan **ditambahkan (appended)** sebagai argumennya dan bukannya menggantikannya.

## Menggunakan kedua-duanya bersama (corak biasa)

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

## Bentuk exec lwn bentuk 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
```

## Mengapa ia penting

Memahami perbezaan antara ENTRYPOINT dan CMD adalah penting untuk **menulis Dockerfile yang berkelakuan dengan betul**, jadi ia merupakan pengetahuan praktikal yang bernilai dan satu topik yang biasa dikelirukan.

Perbezaan dalam kelakuan adalah penting: **CMD** menyediakan perintah lalai yang **ditindih sepenuhnya** oleh sebarang perintah yang dihantar ke `docker run`, manakala **ENTRYPOINT** menetapkan executable tetap yang sentiasa berjalan dengan argumen masa-jalan **ditambahkan** kepadanya — kelakuan berbeza yang mempengaruhi cara kontena bertindak balas terhadap argumen masa-jalan.

Memahami **corak biasa menggunakan kedua-duanya bersama** (`ENTRYPOINT` sebagai perintah dan `CMD` sebagai argumen lalai yang boleh ditindih) adalah pendekatan yang bersih dan idiomatik yang menjadikan kontena berkelakuan seperti executable yang boleh dikonfigurasi — satu teknik yang digunakan secara meluas dan wajar diketahui.

Yang kritikal, memahami **bentuk exec lwn bentuk shell** adalah penting untuk ketepatan: **bentuk exec** (array JSON, contohnya `CMD ["node", "server.js"]`) lebih disukai kerana ia menjalankan executable **secara terus sebagai PID 1**, jadi ia **menerima isyarat seperti SIGTERM** dengan betul, membolehkan **graceful shutdown** — manakala **bentuk shell** (`CMD node server.js`) berjalan melalui shell yang menjadi PID 1, sering menyebabkan aplikasi **tidak menerima isyarat penutupan dengan betul** (membawa kepada penamatan yang tidak teratur, kerja dalam proses yang hilang, atau penghentian yang perlahan).

Isu pengendalian isyarat/graceful shutdown ini adalah masalah sebenar dan halus yang dielakkan oleh bentuk exec.

Memandangkan mentakrifkan apa yang berjalan apabila sesuatu kontena bermula adalah asas kepada setiap Dockerfile, dan memandangkan perbezaan ENTRYPOINT/CMD (dan kebimbangan pengendalian isyarat bentuk exec-lwn-shell) secara langsung mempengaruhi kelakuan dan ketepatan kontena (pengendalian argumen, graceful shutdown), memahami ENTRYPOINT lwn CMD — peranan mereka, cara mereka bergabung, dan amalan penting bentuk-exec-untuk-isyarat — adalah pengetahuan Docker yang bernilai dan relevan secara praktikal, satu topik yang biasa disalah faham di mana memahami perbezaannya mencegah pepijat kelakuan dan penutupan yang sebenar.