Quick start: Khởi tạo Docker config chỉ trong vài phút
Mỗi lần containerize repo mới, bạn làm gì? Lại lục project cũ, copy cái Dockerfile sang rồi ngồi sửa port với command? Cách này vừa ngốn thời gian, vừa dễ kéo theo đống config rác. Từ Docker Desktop 4.18 (Docker CLI v23.0), Docker đã tích hợp sẵn lệnh docker init để lo trọn gói bước nhàm chán này.
Vào ngay thư mục gốc của project và gõ đúng một lệnh:
cd /path/to/my-project
docker init
Giao diện interactive xuất hiện ngay trên terminal, hỏi bạn vài câu về tech stack:
? What application platform does your project use? [Use arrows to move, type to filter]
Go
> Node
Python
Rust
ASP.NET Core
Java
Other
Wizard sẽ lần lượt xác nhận 5 thông tin:
- Application platform: Ngôn ngữ dự án (Node, Python, Go, Java, Rust…).
- Version: Phiên bản runtime (như Node 20.11 hoặc Python 3.11).
- Package manager: Trình quản lý gói (npm, yarn hay pnpm).
- Entrypoint command: Lệnh khởi động app (
npm start,python manage.py runserverhayuvicorn main:app). - Port: Cổng lắng nghe của service (ví dụ: 3000, 8000).
Sau khoảng 30 giây chọn lựa, Docker tự sinh ngay 4 file vào root folder:
Dockerfile: Đã cấu hình sẵn multi-stage build, cache mount và non-root user.compose.yaml: File Compose dựng sẵn port mapping, biến môi trường và volume..dockerignore: Chặn sạchnode_modules,.git, log và file rác.README.Docker.md: Cheat-sheet hướng dẫn chi tiết cách build, run và debug service.
Thử bật cụm container lên xem sao:
docker compose up --build -d
docker compose logs -f
Ứng dụng đã nằm gọn gàng trong container. Toàn bộ quá trình chưa tới 2 phút, không cần viết tay một dòng cú pháp nào.
Bên trong các file docker init sinh ra có gì?
Tiện lợi là một chuyện. Điểm đáng giá nhất ở docker init nằm ở việc nó áp dụng cực kỳ nghiêm ngặt các Best Practices mà dân dev thường bỏ quên khi viết tay.
1. Dockerfile: Tối ưu cache và siết chặt bảo mật
Dưới đây là file Dockerfile cho dự án Node.js do tool tự sinh:
# syntax=docker/dockerfile:1
ARG NODE_VERSION=20.11.0
FROM node:${NODE_VERSION}-alpine as base
WORKDIR /usr/src/app
EXPOSE 3000
FROM base as deps
RUN --mount=type=bind,source=package.json,target=package.json \
--mount=type=bind,source=package-lock.json,target=package-lock.json \
--mount=type=cache,target=/root/.npm \
npm ci --omit=dev
FROM deps as final
USER node
COPY package.json .
COPY --from=deps /usr/src/app/node_modules ./node_modules
COPY . .
CMD npm start
Ba điểm kỹ thuật cực kỳ đắt giá cần chú ý:
- BuildKit Cache Mount (
--mount=type=cache): Lưu cache của npm/pip thẳng vào host engine. Sửa một dòng code ở file JS thì Docker không cần kéo lại từng package từ đầu. Thời gian build giảm từ 2-3 phút xuống còn vài giây. - Non-root user (
USER node): Process không chạy dưới quyềnroot. Nếu app dính lỗ hổng Remote Code Execution (RCE), hacker cũng khó lòng leo thang đặc quyền để chiếm quyền host máy chủ. - Alpine base image: Image gốc rút gọn còn khoảng 50MB thay vì kéo cục image Ubuntu/Debian nặng 800MB-1GB, vừa nhẹ đĩa vừa thu hẹp attack surface.
2. Chuẩn hóa compose.yaml thay cho docker-compose.yml
File Compose mới có tên chuẩn là compose.yaml. Đây là quy chuẩn chính thức của Docker Compose Specification.
services:
server:
build:
context: .
ports:
- 3000:3000
environment:
- NODE_ENV=production
Dòng version: '3.8' ở đầu file đã biến mất. Nếu bạn vẫn đang gõ dòng này vào năm 2024, bạn đang làm thừa—Compose v2 đã bỏ qua trường này từ lâu.
3. File .dockerignore: Dọn sạch build context
Copy nhầm node_modules nặng 400MB từ máy local lên daemon Docker là nguyên nhân số một khiến lệnh build chậm như rùa. Tệ hơn, vô tình lọt file .env chứa secret production vào image là thảm họa bảo mật. docker init xử lý sẵn việc này bằng danh sách ignore chi tiết cho từng framework.
Nâng cao: Tích hợp Database không lo Race Condition
Lúc chạy wizard, tool sẽ hỏi app của bạn có cần cơ sở dữ liệu không. Chọn PostgreSQL hay MySQL, Docker sẽ tự động chèn thêm service DB vào compose.yaml cùng cấu hình persistent volume và cơ chế secret an toàn.
Một file cấu hình stack Postgres hoàn chỉnh trông như sau:
services:
server:
build:
context: .
ports:
- 8000:8000
depends_on:
db:
condition: service_healthy
environment:
- POSTGRES_HOST=db
- POSTGRES_PASSWORD_FILE=/run/secrets/db-password
secrets:
- db-password
db:
image: postgres:16-alpine
restart: unless-stopped
user: postgres
secrets:
- db-password
environment:
- POSTGRES_PASSWORD_FILE=/run/secrets/db-password
- POSTGRES_USER=postgres
- POSTGRES_DB=app_db
volumes:
- db-data:/var/lib/postgresql/data
healthcheck:
test: ["CMD", "pg_isready"]
interval: 10s
timeout: 5s
retries: 5
volumes:
db-data:
secrets:
db-password:
file: db/password.txt
Cực kỳ tinh tế ở chỗ: Docker dùng condition: service_healthy kết hợp với healthcheck của PostgreSQL (lệnh pg_isready). Service web sẽ kiên nhẫn đợi database sẵn sàng nhận kết nối mới bắt đầu khởi động. Bạn không còn phải viết script wait-for-it.sh lằng nhằng để chặn lỗi crash do race condition nữa.
Kinh nghiệm thực chiến khi dùng docker init
Đưa lệnh này vào workflow hàng ngày của team sẽ suôn sẻ hơn nhiều nếu bạn lưu ý 4 điểm sau:
- Luôn commit code trước khi chạy: Nếu thư mục đã có sẵn
Dockerfilehaycompose.yaml, tool sẽ hỏi xác nhận ghi đè. Cứgit commithoặc tạo branch mới trước, nhỡ cần diff hay rollback cũng an tâm. - Tận dụng làm template cho stack lạ: Dự án viết bằng Elixir, PHP hay Ruby chưa có tên trong wizard? Hãy chọn
Otherhoặc mượn tạm template của Python/Node để lấy cấu trúc multi-stage và volume chuẩn. - Đừng tắt BuildKit: Cú pháp
# syntax=docker/dockerfile:1cùng cờ--mount=type=cachebắt buộc phải có BuildKit. Hãy giữ nguyên thiết lập mặc định này trên Docker CLI (mặc định bật từ v23.0 trở lên). - Bảo mật file Secret: File
db/password.txtđược sinh ra để mount password an toàn. Nhớ thêm ngay đường dẫn này vào.gitignoređể tránh push nhầm mật khẩu database lên GitHub.
Đừng lãng phí thời gian copy nhặt nhạnh các file config trôi nổi trên mạng. Gõ docker init ngay trên terminal để dự án có một bộ container chuẩn chỉnh, an toàn và tối ưu ngay từ ngày đầu tiên.
