Chọn Mẫu Cấu Hình
Mã Nguồn Docker Compose YAML
0 lines

Giới thiệu về Docker Compose Validator

Docker Compose Validator là công cụ hỗ trợ nhà phát triển chạy trực tiếp trên trình duyệt, giúp kiểm tra toàn diện cả cú pháp YAML lẫn tiêu chuẩn cấu trúc của các file docker-compose.

Công cụ quét qua từng định nghĩa service, phát hiện lỗi gõ nhầm thuộc tính, kiểm tra tính hợp lệ của liên kết network và volume, xác thực định dạng port mapping và hiển thị kiến trúc trực quan cho cụm container của bạn.

Tính năng chính

  • Kiểm tra cú pháp & thụt lề YAML Bắt chính xác các lỗi thụt dòng YAML, ký tự tab và lỗi định dạng chuỗi kèm số dòng và số cột chi tiết.
  • Xác thực cấu trúc Compose chuẩn Kiểm tra các phần gốc (services, networks, volumes, configs, secrets) và phát hiện các trường khai báo sai quy cách.
  • Phát hiện lỗi chính tả & định dạng cổng Tự động gợi ý khi gõ nhầm từ khóa (như images thay vì image, depend_on thay vì depends_on) và kiểm tra chuẩn định dạng port 8080:80.
  • Đối chiếu quan hệ & phụ thuộc Bảo đảm các named network, named volume và mục tiêu depends_on được khai báo trong service thực sự tồn tại trong file.

Cách kiểm tra file docker-compose

Thực hiện các bước sau để xác thực và sửa lỗi cấu hình Docker Compose của bạn.

  1. Nhập nội dung Compose YAML Dán nội dung file docker-compose.yml vào khung soạn thảo hoặc chọn một mẫu ứng dụng có sẵn.
  2. Xem kết quả kiểm tra Quan sát thanh trạng thái trực quan cho biết file hợp lệ hoàn toàn, có cảnh báo hay gặp lỗi cú pháp nghiêm trọng.
  3. Nhảy đến dòng lỗi để chỉnh sửa Nhấp vào từng mục lỗi hoặc cảnh báo trong danh sách để con trỏ soạn thảo tự động chuyển đến đúng dòng cần sửa.
  4. Xem kiến trúc cụm container & xuất file Kiểm tra các thẻ service để đối chiếu cổng mở, volume gắn ngoài, sau đó định dạng và sao chép YAML chuẩn.

Lưu ý khi sử dụng

  • Luôn đặt ánh xạ cổng trong dấu ngoặc kép như "8080:80" vì YAML có thể diễn giải giá trị số có dấu hai chấm thành cơ số 60.
  • YAML tuyệt đối không cho phép dùng ký tự tab để thụt lề; hãy đảm bảo dùng 2 khoảng trắng.
  • Trong tiêu chuẩn Docker Compose Specification hiện đại, từ khóa version ở cấp cao nhất đã không còn bắt buộc.
  • Đảm bảo mọi named volume được dùng trong service đều đã được khai báo ở phần volumes: gốc.

Câu hỏi thường gặp

Công cụ hỗ trợ đầy đủ tiêu chuẩn hiện đại Compose Specification cũng như các định dạng phiên bản truyền thống v2 và v3.
Không. Toàn bộ quá trình kiểm tra chạy cục bộ trên trình duyệt, phân tích cú pháp YAML và quy tắc cấu trúc Compose mà không cần cài đặt hay kết nối Docker daemon.
Có. Công cụ sẽ quét toàn bộ danh sách cổng host được ánh xạ và cảnh báo nếu phát hiện hai container cùng cố gắng chiếm dụng một cổng host.
Công cụ kiểm tra từng tên network hoặc named volume được khai báo trong mỗi service và đối chiếu với phần networks: và volumes: ở cấp cao nhất.