Dockerfile là gì và bạn viết nó như thế nào?

Question

Accepted Answer

Một **Dockerfile** là một tệp văn bản chứa các lệnh để **build một Docker image** — nó mô tả base image, các phụ thuộc, các tệp cần sao chép, và cách chạy ứng dụng. Nó làm cho việc build image có thể tái tạo và quản lý phiên bản được.

## Một Dockerfile cơ bản

```dockerfile
# FROM — base image để build lên
FROM node:20-alpine

# WORKDIR — đặt thư mục làm việc bên trong image
WORKDIR /app

# COPY các tệp phụ thuộc trước (để cache layer tốt hơn)
COPY package*.json ./
# RUN — thực thi một lệnh trong quá trình BUILD (cài đặt phụ thuộc)
RUN npm install

# COPY phần còn lại của mã ứng dụng
COPY . .

# EXPOSE — ghi chú cổng mà ứng dụng lắng nghe
EXPOSE 3000

# CMD — lệnh chạy khi một CONTAINER khởi động
CMD ["node", "server.js"]
```

## Các lệnh chính

```text
FROM     → base image (điểm bắt đầu) — BẮT BUỘC, thường ở đầu
WORKDIR  → đặt thư mục làm việc cho các lệnh tiếp theo
COPY/ADD → sao chép tệp từ host vào image
RUN      → thực thi một lệnh tại thời điểm BUILD (cài gói, biên dịch) → tạo một layer
ENV      → đặt biến môi trường
EXPOSE   → ghi chú cổng nào container lắng nghe
CMD      → lệnh mặc định chạy khi container KHỞI ĐỘNG (một cái mỗi Dockerfile)
ENTRYPOINT → executable chạy (CMD cung cấp các tham số mặc định cho nó)
ARG      → biến tại thời điểm build
```

## RUN vs CMD vs ENTRYPOINT (thường bị nhầm lẫn)

```text
RUN        → chạy tại thời điểm BUILD (build image — ví dụ cài đặt phụ thuộc)
CMD        → chạy tại thời điểm CONTAINER KHỞI ĐỘNG (lệnh mặc định; ghi đè được khi run)
ENTRYPOINT → executable chính khi khởi động (CMD trở thành các tham số mặc định của nó)
→ RUN build image; CMD/ENTRYPOINT định nghĩa cái gì chạy khi nó khởi động.
```

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

Hiểu Dockerfile là thiết yếu vì đó là cách các Docker image được build, vì vậy viết một cái là một kỹ năng Docker nền tảng, hàng ngày.

Một Dockerfile cung cấp **việc build image có thể tái tạo, quản lý phiên bản được** — mô tả bằng code chính xác cách xây dựng một image (base image, phụ thuộc, tệp, cấu hình và lệnh chạy), để bất kỳ ai cũng có thể build cùng một image một cách nhất quán, điều này là trung tâm cho giá trị tái tạo của Docker.

Hiểu các **lệnh chính** — `FROM` (base image), `WORKDIR`, `COPY` (đưa tệp vào), `RUN` (thực thi các lệnh tại thời điểm build như cài đặt phụ thuộc), `ENV`, `EXPOSE`, và `CMD`/`ENTRYPOINT` (định nghĩa cái gì chạy khi container khởi động) — là cần thiết để viết các Dockerfile hiệu quả cho các ứng dụng thực tế.

Một sự phân biệt đặc biệt quan trọng và thường bị nhầm lẫn là **`RUN` vs `CMD` vs `ENTRYPOINT`**: `RUN` thực thi tại **thời điểm build** (xây dựng image, ví dụ cài đặt gói), trong khi `CMD`/`ENTRYPOINT` định nghĩa cái gì chạy tại **thời điểm container khởi động** (lệnh ứng dụng) — hiểu điều này ngăn ngừa các lỗi phổ biến.

Biết các mẫu thực tế (như sao chép các tệp phụ thuộc trước mã để cache layer tốt hơn) phản ánh việc viết các Dockerfile hiệu quả.

Vì build image là nền tảng để sử dụng Docker (mọi quy trình Docker đều liên quan đến image, và Dockerfile là cách các image tùy chỉnh được build), và vì hiểu các lệnh và sự phân biệt build-time-vs-runtime là cần thiết để tạo các image đúng, hiệu quả, hiểu Dockerfile là kiến thức Docker thiết yếu, thường được áp dụng — một kỹ năng cốt lõi cho bất kỳ ai sử dụng Docker, cơ chế biến lời hứa tái tạo của Docker thành thực tế và là một yêu cầu gần như phổ quát để container hóa các ứng dụng.