Docker Buildx: Cách xây dựng ảnh container đa nền tảng

Tình huống sử dụng nâng cao

Từ đầu đến giờ, tôi đã giới thiệu các lệnh và tình huống sử dụng Buildx cơ bản. Buildx còn làm được nhiều hơn thế, với một số tính năng không thể triển khai bằng builder cổ điển.

Hãy khám phá một số kỹ thuật nâng cao để đưa quy trình container hóa của bạn lên cấp độ tiếp theo.

Tối ưu build đa giai đoạn

Build đa giai đoạn là một trong những tính năng mạnh nhất của Docker để tạo ảnh hiệu quả, và Buildx còn khiến chúng tốt hơn nữa.

Để minh họa, hãy tạo một ứng dụng Python tối ưu hóa với nhiều giai đoạn:

# Dockerfile.optimized
FROM python:3.13-slim AS base
WORKDIR /app
COPY requirements.txt .

FROM base AS builder
RUN pip install --no-cache-dir --target=/install -r requirements.txt

FROM base AS linter
COPY --from=builder /install /usr/local/lib/python3.13/site-packages
COPY app.py .
RUN pip install pylint && pylint app.py || exit 0

FROM base AS tester
COPY --from=builder /install /usr/local/lib/python3.9/site-packages
COPY app.py .
RUN pip install pytest && python -m pytest app.py -v || exit 0

FROM python:3.13-alpine AS final
WORKDIR /app
COPY --from=builder /install /usr/local/lib/python3.13/site-packages
COPY app.py .
EXPOSE 5000
CMD ["python", "app.py"]Được hỗ trợ bởi

Với Buildx, bạn có thể build hiệu quả hơn:

docker buildx build --file Dockerfile.optimized -t myapp:optimized --load .Được hỗ trợ bởi

Hình 9 - Build đa giai đoạn

Vậy điều gì đặc biệt? Buildx xử lý các giai đoạn độc lập song song. Trong khi builder cũ thực thi từng giai đoạn tuần tự, Buildx nhận ra rằng các giai đoạn linter và tester không phụ thuộc nhau và build đồng thời.

Một lợi ích nữa của tối ưu hóa build là giảm kích thước tệp. Bạn có thể kiểm tra kích thước ảnh bằng cách chạy:

docker images myappĐược hỗ trợ bởi

Bạn sẽ thấy tương tự như sau:

Hình 10 - Kích thước ảnh Docker

Ảnh cuối dựa trên alpine nhỏ hơn nhiều.

Tích hợp pipeline CI/CD

Dù bạn đang làm việc cục bộ, bạn vẫn có thể thiết lập cấu hình Buildx phản chiếu môi trường CI/CD.

Đầu tiên, tạo tệp .dockerignore để giữ bản build sạch:

.git
__pycache__
*.pyc
*.pyo
*.pyd
.Python
env
venv
*.so
.coverage
htmlcovĐược hỗ trợ bởi

Sau đó tạo script build mô phỏng những gì pipeline CI có thể làm:

#!/bin/bash
# build.sh - Mô phỏng CI/CD cục bộ

echo "Starting CI/CD build process..."

# Thiết lập builder với hỗ trợ giả lập
echo "Setting up builder..."
docker buildx create --name cibuilder --use || true
docker buildx inspect --bootstrap

# Chạy lint
echo "Running lint stage..."
docker buildx build --file Dockerfile.optimized --target linter .

# Chạy test
echo "Running test stage..."
docker buildx build --file Dockerfile.optimized --target tester .

# Build cho nhiều nền tảng
echo "Building multi-platform image..."
docker buildx build --file Dockerfile.optimized \
  --platform linux/amd64,linux/arm64 \
  --tag myapp:$(date +%Y%m%d) \
  --tag myapp:latest \
  --load \
  --progress=plain \
  .

echo "Build process complete!"Được hỗ trợ bởi

Nói dễ hiểu, script này làm các việc sau:

• Tạo builder dành riêng cho CI/CD.
• Chạy giai đoạn lint.
• Chạy giai đoạn kiểm thử.
• Build ảnh đa nền tảng cuối cùng với thẻ phiên bản.

Giờ đến phần thú vị — cấp quyền thực thi và chạy script:

chmod +x build.sh
./build.shĐược hỗ trợ bởi

Chỉnh sửa cục bộ

Một điểm đau thường gặp khi làm việc với Docker là mỗi lần bạn thay đổi mã nguồn, bạn phải rebuild ảnh và chạy lại container. Rất tốn thời gian.

Tin vui là: cho phát triển cục bộ với vòng lặp nhanh hơn, bạn có thể tạo phiên bản dành cho dev:

# Dockerfile.dev
FROM python:3.13-slim
WORKDIR /app

RUN pip install flask psutil python-dotenv

# Cài công cụ phát triển
RUN pip install pytest pylint watchdog

# Gắn mã nguồn lúc chạy thay vì copy
CMD ["python", "app.py"]Được hỗ trợ bởi

Chạy với volume mount để tự động nạp lại mã:

docker buildx build -f Dockerfile.dev -t myapp:dev --load .
docker run -it --rm -p 5000:5000 -v $(pwd):/app myapp:devĐược hỗ trợ bởi

Giờ bạn có thể chỉnh sửa tệp app.py cục bộ, và thay đổi sẽ lập tức phản ánh trong container đang chạy!

Tiếp theo, hãy nói về hiệu năng.

Cân nhắc về hiệu năng

Không ai thích quy trình phát triển chậm chạp, và sức mạnh song song hóa của Docker Buildx có thể giúp ích.

Hãy khám phá cách tối ưu build và tận dụng các tính năng hiệu năng của Buildx để tạo ảnh nhanh hơn.

Kỹ thuật song song hóa build

Một trong những lợi thế lớn nhất của Buildx là khả năng build các giai đoạn song song. Builder truyền thống thực thi từng bước tuần tự, còn Buildx phân tích Dockerfile và xác định các bước có thể chạy đồng thời.

Để minh họa, tôi sẽ dùng hai tệp — Dockerfile.standard và Dockerfile.parallel. Nội dung như sau:

Dockerfile.standard

FROM python:3.13-slim
WORKDIR /app

# Phụ thuộc hệ thống
RUN apt-get update && apt-get install -y --no-install-recommends \
    gcc \
    g++ \
    && rm -rf /var/lib/apt/lists/*

# Phụ thuộc Python
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# Mã ứng dụng
COPY app.py .

# Linting
RUN pip install pylint && pylint app.py || true

EXPOSE 5000
CMD ["python", "app.py"]Được hỗ trợ bởi

Dockerfile.parallel

FROM python:3.13-slim AS python-base
WORKDIR /app

# Giai đoạn độc lập cài phụ thuộc hệ thống
FROM python-base AS system-deps
RUN apt-get update && apt-get install -y --no-install-recommends \
    gcc \
    g++ \
    && rm -rf /var/lib/apt/lists/*

# Giai đoạn độc lập cài phụ thuộc Python
FROM python-base AS python-deps
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# Giai đoạn độc lập phân tích mã tĩnh
FROM python-deps AS linting
COPY app.py .
RUN pip install pylint && pylint app.py || true

# Giai đoạn cuối kết hợp phụ thuộc
FROM python-base AS final
# Sao chép từ giai đoạn phụ thuộc hệ thống
COPY --from=system-deps /usr/bin/gcc /usr/bin/gcc
# Sao chép từ giai đoạn phụ thuộc Python
COPY --from=python-deps /usr/local/lib/python3.13/site-packages /usr/local/lib/python3.13/site-packages
COPY app.py .
EXPOSE 5000
CMD ["python", "app.py"]Được hỗ trợ bởi

Hãy đo mức cải thiện thời gian build nhờ cấu trúc song song này:

# Đo thời gian build tuần tự chuẩn
time docker build -t myapp:standard -f Dockerfile.standard .

# Đo thời gian build tối ưu song song với Buildx
time docker buildx build --load -t myapp:parallel -f Dockerfile.parallel .Được hỗ trợ bởi

Tham khảo: build chuẩn mất 18,48 giây trong khi build song song chỉ mất 1,17 giây!

Để hiệu năng tốt hơn nữa, bạn có thể dùng các cờ --cache-from và --cache-to để tận dụng cache đĩa cục bộ:

# Lần build đầu - tạo cache
docker buildx build --load -t myapp:latest --cache-to type=local,dest=./buildcache .

# Các lần build sau - dùng cache
docker buildx build --load -t myapp:latest --cache-from type=local,src=./buildcache .Được hỗ trợ bởi

Bạn cũng có thể giới hạn kích thước context với tệp .dockerignore kỹ lưỡng:

# Tạo .dockerignore đầy đủ
cat > .dockerignore << 'EOF'
.git
.github
.dockerignore
.pytest_cache
__pycache__
*.pyc
*.pyo
*.pyd
.Python
venv
env
node_modules
.coverage
htmlcov
.DS_Store
EOFĐược hỗ trợ bởi

Nói ngắn gọn, bằng cách cấu trúc Dockerfile với tư duy song song và tận dụng cache nâng cao của Buildx, bạn sẽ dành ít thời gian chờ build hơn và nhiều thời gian phát triển tính năng hơn.

Tích hợp hệ sinh thái

Docker Buildx không tồn tại độc lập. Nó được xây dựng để tích hợp liền mạch với các công cụ khác trong môi trường phát triển của bạn.

Hãy xem Buildx phối hợp với các công cụ dev cục bộ thế nào và khiến quy trình container của bạn hiệu quả hơn.

Cụm build Kubernetes

Kubernetes cung cấp khả năng mạnh mẽ để chạy các tác vụ Docker Buildx phân tán trên cả cụm. Khi tích hợp Buildx với Kubernetes, bạn có thể đạt build nhanh hơn và ổn định hơn, mở rộng theo nhu cầu dự án.

> Bạn mới làm quen Kubernetes? Bài viết Kubernetes vs Docker: Những khác biệt mọi lập trình viên nên biết là điểm dừng tiếp theo.

Dùng Kubernetes cho hạ tầng build mang lại vài lợi thế:

1. Tự động mở rộng: Kubernetes có thể mở rộng các nút builder theo nhu cầu, phân bổ tài nguyên hiệu quả trên cụm. Bạn còn có thể đặt quy tắc autoscaling theo mức sử dụng CPU.
2. Tối ưu tài nguyên: Lập lịch của Kubernetes đảm bảo build của bạn nhận tài nguyên cần thiết mà không quá tải từng nút. Bạn có thể đặt giới hạn và yêu cầu tài nguyên để đảm bảo hiệu năng ổn định.
3. Khả dụng cao: Bằng cách phân tán BuildKit qua nhiều nút, hạ tầng build của bạn vẫn sẵn sàng ngay cả khi một số nút gặp sự cố.
4. Môi trường nhất quán: Mọi thành viên kết nối tới cùng hạ tầng build, loại bỏ vấn đề “chạy được trên máy tôi”.
5. Thực thi song song: Các build phức tạp với nhiều giai đoạn có thể chạy song song trên nhiều nút, giảm đáng kể thời gian build. Một dự án có thể mất 15 phút build cục bộ có thể hoàn thành trong 3-4 phút khi phân tán.

Hãy coi đây là phần “lý thuyết” hơn, vì đi sâu vào Kubernetes tự nó đã là một chủ đề nâng cao.

Để bắt đầu, tạo tệp buildkit-deployment.yaml với nội dung sau:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: buildkit
  namespace: buildkit
spec:
  replicas: 3
  selector:
    matchLabels:
      app: buildkit
  template:
    metadata:
      labels:
        app: buildkit
    spec:
      containers:
      - name: buildkit
        image: moby/buildkit:latest
        args:
        - --addr
        - tcp://0.0.0.0:1234
        ports:
        - containerPort: 1234
        securityContext:
          privileged: true
---
apiVersion: v1
kind: Service
metadata:
  name: buildkit
  namespace: buildkit
spec:
  type: ClusterIP
  ports:
  - port: 1234
    targetPort: 1234
  selector:
    app: buildkitĐược hỗ trợ bởi

Bước tiếp theo là áp dụng tệp này lên cụm Kubernetes của bạn:

kubectl create namespace buildkit
kubectl apply -f buildkit-deployment.yamlĐược hỗ trợ bởi

Cuối cùng, kết nối từ máy cục bộ đến triển khai này:

docker buildx create --name k8s-builder \
  --driver remote \
  --driver-opt endpoint=tcp://<cluster-ip>:1234 \
  --useĐược hỗ trợ bởi

Vậy là xong, bạn đã sẵn sàng!

Hỗ trợ plugin IDE

Các IDE như Visual Studio Code cung cấp tích hợp tuyệt vời với Docker Buildx thông qua tiện ích mở rộng Docker. Sự tích hợp này giúp bạn quản lý quy trình Buildx trực tiếp từ môi trường phát triển.

Để bắt đầu với Docker Buildx trong VS Code, hãy cài tiện ích "Docker" từ marketplace của VS Code.

Sau khi cài, bạn sẽ có một số tính năng riêng cho Buildx:

• Bấm chuột phải vào bất kỳ Dockerfile để thấy menu ngữ cảnh với tùy chọn "Build Image..." hỗ trợ Buildx.
• Truy cập build args, mục tiêu nền tảng, và tùy chọn đầu ra qua giao diện.
• Khả năng quản lý và chuyển đổi giữa các thể hiện builder khác nhau.
• Tích hợp với terminal của VS Code để chạy các lệnh Buildx phức tạp.

Hình 11 - Tiện ích Docker cho VSCode

Dưới đây là ví dụ tùy chỉnh tác vụ VS Code để dùng Buildx bằng cách tạo tệp .vscode/tasks.json:

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Docker: Buildx Build",
      "type": "shell",
      "command": "docker buildx build --load -t ${input:imageName} .",
      "group": {
        "kind": "build",
        "isDefault": true
      }
    },
    {
      "label": "Docker: Buildx Multi-Platform",
      "type": "shell",
      "command": "docker buildx build --platform linux/amd64,linux/arm64 -t ${input:imageName} ."
    }
  ],
  "inputs": [
    {
      "id": "imageName",
      "description": "Image name (with tag):",
      "default": "myapp:latest",
      "type": "promptString"
    }
  ]
}Được hỗ trợ bởi

Với cấu hình này, bạn có thể truy cập nhanh các lệnh Buildx phổ biến từ menu Tasks của VS Code (Terminal > Run Task). Tiện ích cũng cung cấp tô sáng cú pháp cho Dockerfile và tự động hoàn thành cho các lệnh Docker thường dùng, giúp quy trình Buildx năng suất hơn.

Khắc phục sự cố và gỡ lỗi

Mọi công cụ phát triển đôi khi (quá thường xuyên) đều cần khắc phục sự cố, và Docker Buildx không ngoại lệ. Phần này, tôi sẽ hướng dẫn bạn qua một vài vấn đề phổ biến để bạn tự chẩn đoán nhanh và quay lại công việc.

Vấn đề thường gặp và cách giải quyết

Khi làm việc với Buildx, bạn có thể gặp một số thách thức phổ biến. Dưới đây là những vấn đề thường gặp và cách xử lý:

• Tạo builder thất bại. Nếu gặp lỗi khi tạo builder với docker buildx create, hãy kiểm tra phiên bản Docker:

docker versionĐược hỗ trợ bởi

Buildx yêu cầu Docker 19.03 trở lên. Nếu bạn dùng phiên bản cũ hơn, hãy nâng cấp Docker để truy cập các tính năng Buildx.

Với lỗi "no such plugin", hãy đảm bảo Buildx được cài đúng bằng cách chạy:

docker buildx versionĐược hỗ trợ bởi

• Lỗi build đa nền tảng. Khi build cho nhiều nền tảng gặp lỗi như "exec format error" hoặc "no matching manifest", hãy kiểm tra QEMU đã cài chưa:

docker buildx inspect --bootstrapĐược hỗ trợ bởi

Nếu cần, cài các trình giả lập nền tảng:

docker run --privileged --rm tonistiigi/binfmt --install allĐược hỗ trợ bởi

• Vấn đề liên quan đến cache. Với các vấn đề cache, hãy thử dọn cache build cục bộ:

# Xóa cache của builder cụ thể
docker buildx prune -b mybuilder

# Xóa toàn bộ cache build
docker buildx prune --allĐược hỗ trợ bởi

> Chính xác lệnh Docker prune là gì? Tìm hiểu với hàng loạt ví dụ thực hành.

• Sự cố kết nối BuildKit daemon. Nếu thấy "failed to solve" hoặc lỗi kết nối, hãy khởi động lại builder:

docker buildx rm mybuilder
docker buildx create --name mybuilder --use
docker buildx inspect --bootstrapĐược hỗ trợ bởi

• Vấn đề hiệu năng. Với build chậm, hãy bật đầu ra debug để xác định nút thắt:

docker buildx build --progress=plain --no-cache .Được hỗ trợ bởi

Đầu ra chi tiết này giúp xác định giai đoạn build nào tốn thời gian nhất, cho phép bạn tối ưu Dockerfile tương ứng.

• Lỗi với lệnh "Load". Nếu gặp lỗi "error: docker exporter does not currently support exporting manifest lists" khi dùng --load với build đa nền tảng, hãy nhớ rằng việc nạp đồng thời nhiều nền tảng vào Docker daemon chưa được hỗ trợ. Thay vào đó:

# Build cho nền tảng hiện tại và nạp vào
docker buildx build --platform linux/amd64 --load -t myapp:latest .Được hỗ trợ bởi

• Thực hành gỡ lỗi. Với các vấn đề phức tạp hơn, những cách sau sẽ giúp bạn:

# Bật log debug của BuildKit
BUILDKIT_DEBUG=1 docker buildx build .

# Kiểm tra trạng thái nội bộ của builder
docker buildx inspect

# Kiểm tra yêu cầu hệ thống
docker info

# Với lỗi ở giai đoạn cụ thể, chỉ build đến giai đoạn đó
docker buildx build --target problem-stage .

# Xác minh Docker context của bạn
docker context lsĐược hỗ trợ bởi

Bằng cách làm việc có hệ thống qua các bước khắc phục này, bạn có thể giải quyết hầu hết vấn đề của Buildx và duy trì quy trình build container hiệu quả.

Tổng kết hướng dẫn Docker Buildx

Chúng ta đã bao quát rất nhiều nội dung trong bài viết Docker Buildx này! Bạn đã thấy công cụ mạnh mẽ này có thể khiến quá trình build container nhanh hơn và linh hoạt hơn thế nào.

Hãy nhớ những lợi ích chính: Bạn có thể build ảnh cho nhiều nền tảng chỉ với một lệnh, tăng tốc build với cache nâng cao, và giữ ảnh an toàn nhờ quản lý secrets đúng cách. Cải thiện hiệu năng là có thật, đặc biệt khi bạn cấu trúc Dockerfile để tận dụng build song song.

Tôi dùng nó liên tục trên Macbook chip M vì không phải mọi ảnh đều có sẵn cho ARM.

Dù bạn là nhà phát triển độc lập hay thành viên của một đội ngũ lớn, Buildx mang đến các công cụ phù hợp với quy trình làm việc của bạn. Bạn có thể chạy build cục bộ, phân tán qua các container, hoặc thậm chí mở rộng lên cụm Kubernetes khi nhu cầu tăng.

Để tìm hiểu thêm về Docker và Docker Buildx, tôi khuyến nghị đăng ký các khóa học sau trên DataCamp:

• Khái niệm Container hóa và Ảo hóa
• Nhập môn Docker
• Docker Trung cấp
• Container hóa và Ảo hóa với Docker và Kubernetes
• CI/CD cho Machine Learning