ตัวสร้าง Docker Compose

สเปก Compose สมัยใหม่

Compose V2 (ปลั๊กอินที่มาพร้อมกับ Docker Desktop และ Docker Engine สมัยใหม่) เป็นไปตาม Compose Specification คีย์ version: เลิกใช้แล้ว เครื่องมือนี้จึงละเว้นไว้ คีย์ระดับบนสุดคือ services networks volumes configs และ secrets

โครงสร้างของ service

service ที่ใกล้เคียงระดับโปรดักชันมีหน้าตาแบบนี้:

services:
  web:
    image: nginx:1.27-alpine
    restart: unless-stopped
    ports:
      - "80:80"
    volumes:
      - ./public:/usr/share/nginx/html:ro
    depends_on:
      app:
        condition: service_healthy
    networks:
      - frontend
      - backend
    healthcheck:
      test: ["CMD", "wget", "--spider", "-q", "http://localhost/health"]
      interval: 30s
      timeout: 5s
      retries: 3

Volume: bind mount กับ named volume

• Bind mount (./app:/var/www) เชื่อมคอนเทนเนอร์กับเส้นทางบนเครื่องโฮสต์ เหมาะกับการพัฒนาในเครื่องเพราะการเปลี่ยนแปลงแสดงผลทันที
• Named volume (pgdata:/var/lib/postgresql/data) จัดการโดย Docker และคงอยู่โดยไม่ขึ้นกับเส้นทางใดๆ บนโฮสต์ เหมาะกับฐานข้อมูลและข้อมูลที่ไม่อยากลบพลาดด้วย rm -rf
• Anonymous volume - หลีกเลี่ยง แม้จะอยู่ข้ามการรีสตาร์ต แต่จะหายไปโดยไม่มีการเตือนเมื่อรัน docker compose down -v

เครือข่าย

ตามค่าเริ่มต้น Compose จะสร้างเครือข่ายตามชื่อโปรเจกต์และเชื่อมทุก service เข้าไว้ การประกาศเครือข่ายอย่างชัดเจนมีประโยชน์เมื่อ:

• ต้องการแยกฐานข้อมูลออกจาก service ที่เปิดสู่สาธารณะ
• ต้องใช้ bridge ที่มี subnet กำหนดเองเพื่อให้สอดคล้องกับโครงสร้างพื้นฐานเดิม
• ต้องการเชื่อมคอนเทนเนอร์เข้ากับเครือข่ายภายนอกที่มีอยู่แล้ว (external: true)

ข้อผิดพลาดทั่วไปที่ควรหลีกเลี่ยง

• คีย์ version ขัดแย้ง การใส่ version: "3.8" ไว้ด้านบนทำให้ฟีเจอร์ใหม่ๆ เช่น start_interval ของ healthcheck ใช้ไม่ได้กับ Compose รุ่นเก่า เครื่องมือนี้จึงละเว้นคีย์ version
• เครื่องหมายคำพูดของพอร์ต 8080:80 ในบางกรณีจะถูกอ่านเป็นเลขฐาน 60 ของ YAML ควรใส่เครื่องหมายคำพูดรอบการจับคู่พอร์ตเสมอ ซึ่งเครื่องมือนี้ทำให้แล้ว
• secret เขียนตายตัว secret ที่เขียนลงใน compose.yml โดยตรงจะถูก commit ขึ้น git ควรเก็บใน env_file หรือตัวเก็บ secret ของแพลตฟอร์ม
• depends_on ที่ไม่มีเงื่อนไข การใช้ depends_on: [db] ธรรมดาจะรอแค่คอนเทนเนอร์เริ่มทำงาน ไม่ใช่รอให้ service พร้อม ควรใช้ condition: service_healthy และเพิ่ม healthcheck ให้กับ service ที่พึ่งพา