مولّد Docker Compose

مواصفات Compose الحديثة

يتبع Compose V2 (الملحق المرفق مع Docker Desktop ومحرك Docker الحديث) مواصفات Compose. مفتاح version: مهمَل؛ يحذفه المولّد. مفاتيح المستوى الأعلى هي services وnetworks وvolumes وconfigs وsecrets.

بنية الخدمة

تبدو الخدمة القريبة من الإنتاج هكذا:

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

أحجام التخزين: الربط المباشر مقابل الحجم المسمّى

• الربط المباشر (./app:/var/www) يربط الحاوية بمسار على المضيف؛ ممتاز للتطوير المحلي لأن التغييرات تظهر فورًا.
• الحجم المسمّى (pgdata:/var/lib/postgresql/data) يديره Docker ويبقى مستقلًا عن أي مسار على المضيف؛ الخيار الصحيح لقواعد البيانات وأي شيء لا تريد حذفه بالخطأ باستخدام rm -rf.
• الحجم المجهول - تجنّبه. يبقى بعد إعادة التشغيل لكنه يختفي دون تحذير عند docker compose down -v.

الشبكات

افتراضيًا ينشئ Compose شبكة باسم المشروع ويصل كل خدمة بها. يكون التصريح بشبكات صريحة مفيدًا عندما:

• تريد عزل قاعدة بيانات عن خدمة مواجهة للجمهور.
• تحتاج إلى جسر بشبكة فرعية مخصصة لتتوافق مع البنية التحتية القائمة.
• تريد ربط الحاويات بشبكة خارجية موجودة مسبقًا (external: true).

أخطاء شائعة يجدر تجنبها

• تضارب مفتاح الإصدار. version: "3.8" في الأعلى يمنع الميزات الأحدث مثل start_interval في healthcheck من العمل على Compose القديم؛ يحذف المولّد مفتاح الإصدار.
• اقتباس المنافذ. يُفسَّر 8080:80 على أنه YAML بنظام العدّ الستيني في بعض الحالات النادرة؛ يضع المولّد دائمًا تعيينات المنافذ بين علامتي اقتباس.
• أسرار مكتوبة مباشرة. الأسرار المكتوبة مباشرة في compose.yml تُدرج في git. احتفظ بها في env_file أو في مخزن الأسرار الخاص بالمنصة.
• depends_on بدون شرط. depends_on: [db] البسيط ينتظر بدء الحاوية لا جاهزية الخدمة. استخدم condition: service_healthy وأضف فحص صحة إلى الخدمة التابعة.