Một service chạy khác nhau giữa máy dev và CI dù cùng dùng Compose. Trước khi điều tra runtime, hãy xem mô hình Compose thực sự được tạo từ các file và biến đầu vào. docker compose config giúp hiển thị cấu hình sau xử lý để bạn kiểm tra image, cổng, volume và các giá trị đã nội suy.
Tạo cấu hình thử nghiệm
Lưu ví dụ thành compose.yaml trong thư mục riêng. Ví dụ nhắm Compose V2, dùng giá trị mặc định cho tag và cổng nếu môi trường chưa cung cấp. Chỉ dùng biến không chứa credential để quan sát đầu ra.
services:
web:
image: nginx:${IMAGE_TAG:-stable}
ports:
- "127.0.0.1:${WEB_PORT:-8080}:80"
docker compose config --quiet
docker compose config --services
docker compose config --images
docker compose config
Kiểm tra lệnh đầu kết thúc thành công, danh sách service có web và image nhận đúng tag. Đầu ra đầy đủ cần giữ binding loopback như cấu hình. Nếu WEB_PORT được đặt ở môi trường chạy, đối chiếu cổng đã thay vào thay vì chỉ đọc file nguồn.
Kiểm tra cùng tập file như triển khai
Khi dùng nhiều file qua -f, giữ cùng thứ tự với lệnh up của pipeline. Một lượt config trên file mặc định không cho biết kết quả của tập file override khác. Ghi lệnh thực tế vào log ở mức phù hợp để đội có thể tái hiện mô hình.
Nếu trường bắt buộc bị bỏ trống, đổi cú pháp nội suy sang dạng báo lỗi khi thiếu theo hợp đồng cấu hình của dự án. Với biến có mặc định, kiểm tra cả trường hợp chưa đặt và chuỗi rỗng vì các dạng nội suy có thể xử lý khác nhau.
Giới hạn của phép kiểm tra
Cấu hình hợp lệ chưa chứng minh image tải được, port đang rảnh hay tiến trình sẽ khởi động. Sau bước này vẫn cần test khởi động và healthcheck. Hãy coi config là cách kiểm tra mô hình đầu vào trước khi chạy service.
Đầu ra có thể chứa giá trị môi trường đã được thay vào. Khi dùng cấu hình thật, tránh đưa bản in chứa bí mật vào log chia sẻ hoặc ticket. Với ca debug, tạo bản tái hiện bằng giá trị thử nghiệm trước khi chuyển cho người khác.
Ví dụ YAML và lệnh được đối chiếu tài liệu Docker, chưa chạy container trong lượt biên tập. Khi áp dụng vào CI, chạy cùng phiên bản Compose của môi trường triển khai và kiểm tra các tùy chọn hỗ trợ bằng docker compose config –help.

