Sự khác biệt giữa ENTRYPOINT và CMD là gì?

Question

Accepted Answer

**ENTRYPOINT** và **CMD** đều định nghĩa cái gì chạy khi một container khởi động, nhưng chúng phục vụ các vai trò khác nhau và tương tác theo những cách cụ thể. Hiểu sự khác biệt (và hai dạng — exec vs shell) là quan trọng để viết các Dockerfile hành xử đúng.

## CMD — lệnh mặc định (ghi đè được)

```dockerfile
CMD ["node", "server.js"]
# → lệnh MẶC ĐỊNH khi container khởi động
# → nhưng nó bị THAY THẾ nếu bạn truyền một lệnh tại thời điểm run:
#   docker run myapp echo hello   → chạy "echo hello" THAY VÌ node server.js
```

`CMD` cung cấp **lệnh mặc định**, vốn bị **ghi đè hoàn toàn** bởi bất kỳ lệnh nào được đưa ra trên `docker run`.

## ENTRYPOINT — executable cố định

```dockerfile
ENTRYPOINT ["node", "server.js"]
# → LUÔN chạy; các tham số tại thời điểm run được THÊM VÀO (không thay thế nó):
#   docker run myapp --port 8080   → chạy "node server.js --port 8080"
# → làm cho container hành xử như một executable cụ thể
```

`ENTRYPOINT` đặt một **executable cố định** luôn chạy; các tham số tại thời điểm run được **thêm vào** làm các tham số của nó thay vì thay thế nó.

## Dùng chúng cùng nhau (mẫu phổ biến)

```dockerfile
ENTRYPOINT ["node", "server.js"]   # lệnh cố định
CMD ["--port", "3000"]              # các tham số MẶC ĐỊNH (ghi đè được)
# docker run myapp                  → node server.js --port 3000 (mặc định)
# docker run myapp --port 8080      → node server.js --port 8080 (CMD bị ghi đè)
→ ENTRYPOINT = lệnh; CMD = các tham số mặc định bạn có thể ghi đè. Một mẫu sạch sẽ.
```

## Dạng exec vs dạng shell

```text
Dạng EXEC  → CMD ["node", "server.js"]  (mảng JSON) — ĐƯỢC ƯU TIÊN:
  chạy executable TRỰC TIẾP (PID 1) → nhận các tín hiệu (SIGTERM) → tắt duyên dáng
Dạng SHELL → CMD node server.js  → chạy qua /bin/sh -c → shell là PID 1,
  app có thể KHÔNG nhận các tín hiệu đúng cách (vấn đề tắt) → tránh cho process chính
```

## Tại sao điều này quan trọng

Hiểu sự khác biệt giữa ENTRYPOINT và CMD là quan trọng để **viết các Dockerfile hành xử đúng**, vì vậy đó là kiến thức thực tế có giá trị và một chủ đề thường bị nhầm lẫn.

Sự khác biệt trong hành vi quan trọng: **CMD** cung cấp một lệnh mặc định bị **ghi đè hoàn toàn** bởi bất kỳ lệnh nào được truyền tới `docker run`, trong khi **ENTRYPOINT** đặt một executable cố định luôn chạy với các tham số tại thời điểm run được **thêm vào** nó — các hành vi khác nhau ảnh hưởng đến cách container phản hồi với các tham số tại thời điểm run.

Hiểu **mẫu phổ biến dùng chúng cùng nhau** (`ENTRYPOINT` là lệnh và `CMD` là các tham số mặc định ghi đè được) là một cách tiếp cận sạch sẽ, đặc trưng làm cho các container hành xử như các executable có thể cấu hình — một kỹ thuật được dùng rộng rãi đáng để biết.

Quan trọng là, hiểu **dạng exec vs dạng shell** là quan trọng cho tính đúng đắn: **dạng exec** (mảng JSON, ví dụ `CMD ["node", "server.js"]`) được ưu tiên vì nó chạy executable **trực tiếp như PID 1**, nên nó **nhận các tín hiệu như SIGTERM** đúng cách, cho phép **tắt duyên dáng** — trong khi **dạng shell** (`CMD node server.js`) chạy qua một shell trở thành PID 1, thường gây ra ứng dụng **không nhận các tín hiệu tắt đúng cách** (dẫn đến chấm dứt không duyên dáng, mất công việc đang xử lý, hoặc dừng chậm).

Vấn đề xử lý tín hiệu/tắt duyên dáng này là một vấn đề thực sự, tinh tế mà dạng exec tránh được.

Vì định nghĩa cái gì chạy khi một container khởi động là nền tảng cho mọi Dockerfile, và vì sự phân biệt ENTRYPOINT/CMD (và mối quan tâm xử lý tín hiệu dạng-exec-vs-shell) trực tiếp ảnh hưởng đến hành vi và tính đúng đắn của container (xử lý tham số, tắt duyên dáng), hiểu ENTRYPOINT vs CMD — các vai trò của chúng, cách chúng kết hợp, và thực hành dạng-exec-cho-tín-hiệu quan trọng — là kiến thức Docker có giá trị, liên quan thực tế, một chủ đề thường bị hiểu sai nơi hiểu các khác biệt ngăn ngừa các lỗi hành vi và tắt thực sự.