ความแตกต่างระหว่าง ENTRYPOINT กับ CMD คืออะไร?

Question

Accepted Answer

**ENTRYPOINT** และ **CMD** ต่างก็กำหนดสิ่งที่จะรันเมื่อ container เริ่มต้น แต่ทั้งสองมีบทบาทต่างกันและทำงานร่วมกันในรูปแบบเฉพาะ การเข้าใจความแตกต่าง (และรูปแบบสองแบบ — exec กับ shell) เป็นเรื่องสำคัญต่อการเขียน Dockerfile ที่ทำงานได้ถูกต้อง

## CMD — คำสั่งเริ่มต้น (override ได้)

```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` ให้ **คำสั่งเริ่มต้น** ซึ่งจะถูก **แทนที่ทั้งหมด** ด้วยคำสั่งใด ๆ ที่ระบุตอน `docker run`

## ENTRYPOINT — executable ที่ตายตัว

```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` กำหนด **executable ที่ตายตัว** ซึ่งจะรันเสมอ; argument ตอน runtime จะถูก **ต่อท้าย** เป็น argument ของมันแทนที่จะแทนที่มัน

## การใช้ทั้งสองร่วมกัน (รูปแบบที่พบบ่อย)

```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 กับรูปแบบ 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
```

## ทำไมจึงสำคัญ

การเข้าใจความแตกต่างระหว่าง ENTRYPOINT กับ CMD เป็นเรื่องสำคัญต่อ **การเขียน Dockerfile ที่ทำงานได้ถูกต้อง** ดังนั้นจึงเป็นความรู้เชิงปฏิบัติที่มีคุณค่าและเป็นหัวข้อที่สับสนกันบ่อย

ความแตกต่างในพฤติกรรมเป็นเรื่องสำคัญ: **CMD** ให้คำสั่งเริ่มต้นที่ถูก **แทนที่ทั้งหมด** ด้วยคำสั่งใด ๆ ที่ส่งให้ `docker run` ในขณะที่ **ENTRYPOINT** กำหนด executable ที่ตายตัวซึ่งจะรันเสมอโดยมี argument ตอน runtime **ต่อท้าย** เข้าไป — พฤติกรรมที่ต่างกันซึ่งส่งผลต่อวิธีที่ container ตอบสนองต่อ argument ตอน runtime

การเข้าใจ **รูปแบบที่พบบ่อยของการใช้ทั้งสองร่วมกัน** (`ENTRYPOINT` เป็นคำสั่งและ `CMD` เป็น argument เริ่มต้นที่ override ได้) เป็นแนวทางที่สะอาดและเป็นสำนวนซึ่งทำให้ container ทำงานเหมือน executable ที่กำหนดค่าได้ — เป็นเทคนิคที่ใช้กันอย่างแพร่หลายและควรรู้

ที่สำคัญยิ่งคือ การเข้าใจ **รูปแบบ exec กับรูปแบบ shell** สำคัญต่อความถูกต้อง: **รูปแบบ exec** (JSON array เช่น `CMD ["node", "server.js"]`) เป็นที่นิยมเพราะมันรัน executable **โดยตรงในฐานะ PID 1** ดังนั้นมันจึง **รับ signal อย่าง SIGTERM** ได้อย่างถูกต้อง ทำให้เกิด **graceful shutdown** — ในขณะที่ **รูปแบบ shell** (`CMD node server.js`) รันผ่าน shell ที่กลายเป็น PID 1 ซึ่งมักทำให้แอปพลิเคชัน **ไม่ได้รับ signal สำหรับ shutdown อย่างถูกต้อง** (นำไปสู่การ terminate ที่ไม่ราบรื่น งานที่กำลังดำเนินอยู่สูญหาย หรือการหยุดที่ช้า)

ปัญหาเรื่องการจัดการ signal/graceful shutdown นี้เป็นปัญหาจริงและละเอียดอ่อนที่รูปแบบ exec ช่วยหลีกเลี่ยง

เนื่องจากการกำหนดสิ่งที่จะรันเมื่อ container เริ่มต้นเป็นพื้นฐานของ Dockerfile ทุกตัว และเนื่องจากความแตกต่างระหว่าง ENTRYPOINT/CMD (และเรื่องการจัดการ signal ของรูปแบบ exec กับ shell) ส่งผลโดยตรงต่อพฤติกรรมและความถูกต้องของ container (การจัดการ argument, graceful shutdown) การเข้าใจ ENTRYPOINT กับ CMD — บทบาทของพวกมัน วิธีที่พวกมันรวมกัน และแนวปฏิบัติสำคัญในการใช้รูปแบบ exec เพื่อ signal — จึงเป็นความรู้ Docker ที่มีคุณค่าและเกี่ยวข้องในทางปฏิบัติ เป็นหัวข้อที่มักถูกเข้าใจผิดซึ่งการเข้าใจความแตกต่างช่วยป้องกันบั๊กด้านพฤติกรรมและ shutdown ที่เกิดขึ้นจริง