Hướng dẫn sử dụng lệnh docker init: Tự động tạo Dockerfile và Compose chuẩn Best Practices

Docker tutorial - IT technology blog
Docker tutorial - IT technology blog

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:

  1. Application platform: Ngôn ngữ dự án (Node, Python, Go, Java, Rust…).
  2. Version: Phiên bản runtime (như Node 20.11 hoặc Python 3.11).
  3. Package manager: Trình quản lý gói (npm, yarn hay pnpm).
  4. Entrypoint command: Lệnh khởi động app (npm start, python manage.py runserver hay uvicorn main:app).
  5. 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ạch node_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ền root. 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 Dockerfile hay compose.yaml, tool sẽ hỏi xác nhận ghi đè. Cứ git commit hoặ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 Other hoặ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:1 cùng cờ --mount=type=cache bắ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.

Share: