Hướng dẫn Docker Buildx Bake: Tự động hóa và build song song nhiều Image

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

Nỗi đau khi build hàng loạt Docker Image

Khi dự án tách nhỏ từ monolith thành microservices, số lượng Dockerfile tăng lên nhanh chóng. Lúc này, khâu đóng gói bắt đầu lộ rõ nút thắt cổ chai. Các lệnh docker build chạy nối đuôi nhau khiến CI/CD runner nghẽn hàng chục phút. Chưa kể, việc quản lý hàng loạt build-args, gắn tag phiên bản hay thiết lập ma trận multi-arch bằng tay rất dễ sai sót.

Thực tế tại các đội ngũ kỹ thuật, chúng ta thường thấy 3 hướng xử lý phổ biến:

  • Cách 1: Dùng Bash script hoặc background job (&) — Viết vòng lặp qua từng thư mục rồi gọi lệnh build.
  • Cách 2: Tận dụng docker compose build — Đặt toàn bộ cấu hình build vào file docker-compose.yml.
  • Cách 3: Triển khai Docker Buildx Bake — Dùng công cụ chính thức từ BuildKit để khai báo target qua file HCL, xử lý song song và tái sử dụng layer cache triệt để.

So sánh thực tế ba phương án

1. Bash script / Makefile

Viết script là phản xạ đầu tiên của nhiều lập trình viên vì quen tay, không cần học cú pháp mới.

  • Ưu điểm: Chạy được ngay trên mọi server có sẵn Docker CLI cơ bản.
  • Nhược điểm: Không thể chia sẻ cache giữa các stage độc lập. Nếu chạy tuần tự thì tốn thời gian. Nếu bạn ép chạy ngầm bằng & và wait, hệ thống sẽ ngốn sạch CPU/RAM. Lúc đó, việc gom log lỗi tập trung cũng rất phức tạp.

2. Docker Compose Build

Nhiều team tận dụng luôn Compose vì môi trường local dev đã có sẵn file này.

  • Ưu điểm: Tiện lợi, không cần tạo thêm file cấu hình mới. Các bản Compose gần đây cũng đã hỗ trợ cờ parallel.
  • Nhược điểm: Compose vốn được thiết kế để điều phối container lúc runtime (mạng, volume, restart policy). Khi cần các tính năng nâng cao như build multi-platform (amd64 kết hợp arm64), kế thừa target hay đẩy remote cache lên AWS ECR/GitHub Registry, Compose lộ rõ giới hạn.

3. Docker Buildx Bake

Buildx Bake giải quyết bài toán đóng gói theo mô hình đồ thị phụ thuộc (DAG – Directed Acyclic Graph).

  • Ưu điểm: Engine BuildKit tự động tính toán những phần độc lập để build song song, khai thác tối đa số core CPU. Cú pháp HCL trực quan, cho phép gom nhóm target, kế thừa cấu hình chung và push đồng loạt lên registry chỉ với một lệnh.
  • Nhược điểm: Team cần dành thời gian làm quen cú pháp HCL hoặc JSON của Bake.

Hiệu quả thực tế khi áp dụng Bake

Nếu repo chỉ có một service, docker build thông thường là đủ. Tuy nhiên, khi hệ thống chạm mốc 3-4 service trở lên, Bake sẽ tạo ra khác biệt rõ rệt.

Trong một dự án gồm 8 microservices (Golang backend, Next.js frontend và các worker), thời gian chạy GitHub Actions ban đầu tốn hơn 16 phút. Sau khi chuyển toàn bộ sang docker-bake.hcl kết hợp driver docker-container, thời gian đóng gói giảm xuống còn 4 phút 30 giây. Việc này tiết kiệm hơn 60% chi phí runner mỗi tháng.

Từng bước thiết lập Docker Buildx Bake

Bước 1: Chuẩn bị builder instance

Docker Desktop hiện đã đi kèm Buildx. Dù vậy, builder mặc định thường dùng driver docker với nhiều hạn chế. Hãy tạo builder mới dùng driver docker-container để kích hoạt toàn bộ tính năng song song và remote cache:

# Kiểm tra phiên bản buildx hiện tại
docker buildx version

# Khởi tạo builder instance mới và đặt làm mặc định
docker buildx create --name bake-builder --driver docker-container --use

# Khởi động và kiểm tra builder
docker buildx inspect --bootstrap

Bước 2: Chuẩn bị cấu trúc thư mục

Xét một dự án tiêu chuẩn gồm Backend (Golang) và Frontend (Node.js):

my-project/
├── backend/
│   └── Dockerfile
├── frontend/
│   └── Dockerfile
└── docker-bake.hcl

Bước 3: Viết file cấu hình docker-bake.hcl

Tạo file docker-bake.hcl ở thư mục gốc của repository:

# Định nghĩa biến toàn cục kèm giá trị fallback
variable "TAG" {
  default = "latest"
}

variable "REGISTRY" {
  default = "myregistry.local/app"
}

# Target cơ sở chứa cấu hình dùng chung
target "common" {
  platforms = ["linux/amd64"]
  args = {
    BUILD_ENV = "production"
  }
}

# Target backend kế thừa toàn bộ cấu hình từ common
target "api" {
  inherits   = ["common"]
  context    = "./backend"
  dockerfile = "Dockerfile"
  tags       = ["${REGISTRY}-api:${TAG}"]
}

# Target frontend kế thừa từ common
target "web" {
  inherits   = ["common"]
  context    = "./frontend"
  dockerfile = "Dockerfile"
  tags       = ["${REGISTRY}-web:${TAG}"]
}

# Nhóm mặc định gom cả hai service
group "default" {
  targets = ["api", "web"]
}

Bước 4: Thực thi build bằng một lệnh duy nhất

Đứng tại thư mục gốc, bạn chỉ cần chạy:

docker buildx bake

BuildKit lập tức phân tích cấu trúc phụ thuộc. Base layer và source code của cả hai service được kéo và biên dịch song song. Màn hình CLI hiển thị thanh tiến trình riêng biệt cho từng target, không hề bị nuốt log.

Bước 5: Linh hoạt ghi đè tham số

Bạn hoàn toàn có thể truyền biến môi trường hoặc chỉ định một target cụ thể khi cần debug:

# Chỉ build riêng service API với phiên bản v1.2.0
TAG=v1.2.0 docker buildx bake api

# Build đồng thời đẩy thẳng image lên container registry
docker buildx bake --push

Bước 6: Tăng tốc CI/CD bằng Remote Cache

Điểm giá trị nhất của Bake trên CI/CD nằm ở khả năng lưu cache tập trung. Bạn chỉ cần khai báo thêm vào target common:

target "common" {
  platforms  = ["linux/amd64"]
  cache-from = ["type=registry,ref=${REGISTRY}-cache:common"]
  cache-to   = ["type=registry,ref=${REGISTRY}-cache:common,mode=max"]
}

Nhờ cấu hình trên, những layer không đổi như npm install hay go mod download sẽ được lấy thẳng từ registry. Ở các commit tiếp theo, runner chỉ mất 20-30 giây để hoàn thành quá trình đóng gói.

Tóm lại

Docker Buildx Bake không chỉ thay thế các file shell script cồng kềnh. Nó mang lại sự chuẩn hóa và tốc độ vượt trội cho quy trình CI/CD. Với dự án microservices hoặc monorepo, đầu tư cấu hình file docker-bake.hcl ngay từ đầu sẽ giúp bạn tiết kiệm đáng kể thời gian chờ đợi mỗi ngày.

Share: