Apa perbedaan antara ENTRYPOINT dan CMD?

Question

Accepted Answer

**ENTRYPOINT** dan **CMD** keduanya mendefinisikan apa yang berjalan saat container dimulai, tetapi mereka memiliki peran berbeda dan berinteraksi dengan cara tertentu. Memahami perbedaannya (dan kedua bentuk — exec vs shell) penting untuk menulis Dockerfile yang berperilaku dengan benar.

## CMD — perintah default (dapat diganti)

```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 default**, yang **sepenuhnya ditimpa** oleh perintah apa pun 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 selalu berjalan; argumen run-time **ditambahkan** sebagai argumennya daripada menggantinya.

## Menggunakannya bersama-sama (pola umum)

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

Memahami perbedaan antara ENTRYPOINT dan CMD penting untuk **menulis Dockerfile yang berperilaku dengan benar**, sehingga ini adalah pengetahuan praktis yang berharga dan topik yang sering membingungkan.

Perbedaan dalam perilaku penting: **CMD** menyediakan perintah default yang **sepenuhnya ditimpa** oleh perintah apa pun yang dilewatkan ke `docker run`, sedangkan **ENTRYPOINT** menetapkan executable tetap yang selalu berjalan dengan argumen run-time **ditambahkan** ke dalamnya — perilaku berbeda yang mempengaruhi cara container merespons argumen run-time.

Memahami **pola umum penggunaannya bersama-sama** (`ENTRYPOINT` sebagai perintah dan `CMD` sebagai argumen default yang dapat diganti) adalah pendekatan idiomatic yang bersih yang membuat container berperilaku seperti executable yang dapat dikonfigurasi — teknik yang banyak digunakan dan patut diketahui.

Secara kritis, memahami **bentuk exec vs bentuk shell** penting untuk kebenaran: **bentuk exec** (array JSON, misalnya `CMD ["node", "server.js"]`) lebih disukai karena menjalankan executable **langsung sebagai PID 1**, sehingga **menerima sinyal seperti SIGTERM** dengan benar, memungkinkan **shutdown yang elegan** — sedangkan **bentuk shell** (`CMD node server.js`) berjalan melalui shell yang menjadi PID 1, sering kali menyebabkan aplikasi **tidak menerima sinyal shutdown dengan benar** (menghasilkan terminasi yang tidak elegan, pekerjaan yang hilang dalam perjalanan, atau stop yang lambat).

Masalah penanganan sinyal/graceful shutdown ini adalah masalah nyata yang halus yang dihindari oleh bentuk exec.

Karena mendefinisikan apa yang berjalan saat container dimulai adalah fundamental untuk setiap Dockerfile, dan karena perbedaan ENTRYPOINT/CMD (dan masalah penanganan sinyal bentuk exec-vs-shell) secara langsung mempengaruhi perilaku dan kebenaran container (penanganan argumen, shutdown yang elegan), memahami ENTRYPOINT vs CMD — peran mereka, bagaimana mereka digabungkan, dan praktik bentuk exec-for-signals yang penting — adalah pengetahuan Docker yang berharga dan relevan secara praktis, topik yang sering disalahpahami di mana pemahaman perbedaannya mencegah bug perilaku dan shutdown nyata.