كيف تحوّل أوامر docker run إلى Docker Compose

بقلم Sayaib Sarkarآخر تحديث قراءة في 3 دقيقة

في هذه الصفحة 5 قسم

الإجابة المختصرة: لكل خيار في docker run مفتاح مطابق في compose.yaml: يصبح -p ‏ports، و-e ‏environment، و-v ‏volumes، و--restart ‏restart، وتصبح الصورة وأي وسائط بعدها image وcommand. حوّل خيارًا خيارًا، وعرّف وحدات التخزين المسماة في الأسفل، ثم افحص الملف بـ docker compose config. تتولى أداة docker run → Compose في DevSnip Pro التحويل داخل VS Code، لأمر واحد أو عدة أوامر معًا.

تعرض ملفات README عادةً كيفية تشغيل خدمة بأمر docker run طويل واحد. لا بأس بذلك مرة واحدة. لكن حين يحتاج المشروع إلى قاعدة بيانات وذاكرة تخزين مؤقت كل يوم، يكون ملف Compose أسهل قراءةً وحفظًا في المستودع ومشاركةً: يشغّل docker compose up -d كل شيء، ويوقفه docker compose down.

مطابقة الخيارات بالمفاتيح

`docker run``compose.yaml`ملاحظات
IMAGE (آخر وسيط قبل الأمر)image:
الوسائط بعد الصورةcommand:
--name dbcontainer_name: dbمفتاح الخدمة هو ما تستخدمه الخدمات الأخرى كاسم مضيف
-p 5432:5432ports:ضعه بين علامتي اقتباس: "5432:5432"
-e KEY=valueenvironment:أو env_file: لملف .env
-v pgdata:/var/lib/...volumes:تُعرَّف وحدات التخزين المسماة أيضًا في المستوى الأعلى
-v ./data:/datavolumes:ربط مجلد؛ نسبةً إلى ملف Compose
--restart unless-stoppedrestart: unless-stopped
--network mynetnetworks:عرّف الشبكة في المستوى الأعلى أيضًا
--health-cmd, --health-intervalhealthcheck:test وinterval وtimeout وretries
-d(لا شيء)استخدم docker compose up -d
--rm, -it(لا شيء)خيارات تفاعلية للتشغيل لمرة واحدة

مثال تطبيقي

إليك أمرين قد تجدهما في ملاحظات إعداد مشروع: PostgreSQL مع وحدة تخزين مسماة وفحص صحة، وRedis مع تفعيل الحفظ الدائم.

Terminal
docker run -d --name db -p 5432:5432 \
  -e POSTGRES_PASSWORD=secret -e POSTGRES_DB=app \
  -v pgdata:/var/lib/postgresql/data \
  --restart unless-stopped \
  --health-cmd "pg_isready -U postgres" --health-interval 10s \
  postgres:16-alpine

docker run -d --name cache -p 6379:6379 redis:7-alpine redis-server --appendonly yes

بعد التحويل، يصبحان ملفًا واحدًا فيه خدمتان:

YAML
services:
  db:
    image: postgres:16-alpine
    container_name: db
    ports:
      - "5432:5432"
    environment:
      - POSTGRES_PASSWORD=secret
      - POSTGRES_DB=app
    volumes:
      - pgdata:/var/lib/postgresql/data
    restart: unless-stopped
    healthcheck:
      test:
        - CMD-SHELL
        - pg_isready -U postgres
      interval: 10s
  cache:
    image: redis:7-alpine
    container_name: cache
    ports:
      - "6379:6379"
    command:
      - redis-server
      - --appendonly
      - yes
volumes:
  pgdata:

ثلاث تفاصيل يسهل الخطأ فيها يدويًا:

  • تُوضع مطابقات المنافذ بين علامتي اقتباس. قد يقرأ YAML بعض قيم xx:yy غير المقتبسة كأعداد بالنظام الستيني. ووضع كل مطابقة منفذ بين علامتي اقتباس يتجنب المشكلة.
  • تحتاج وحدات التخزين المسماة إلى إدخال volumes: في المستوى الأعلى. ومن دونه يرفض Compose البدء. أما ربط المجلد (مسار مثل ./data) فلا يحتاج إليه.
  • فحص الصحة المكتوب بالصيغة --health-cmd "…" يعمل داخل shell، لذا يصبح CMD-SHELL في Compose.

أخرج الأسرار من الملف

يُبقي المثال POSTGRES_PASSWORD=secret مكتوبًا مباشرة، وهذا مقبول لقاعدة بيانات محلية مؤقتة، لكنه غير مقبول لملف تحفظه في المستودع. ضع القيم في ملف .env بجوار compose.yaml، وأضف .env إلى .gitignore، وأشر إليها:

YAML
    environment:
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
      - POSTGRES_DB=app

يقرأ Compose ملف .env من مجلد المشروع تلقائيًا عندما يستبدل قيم ${…}. احفظ في المستودع ملف .env.example بقيم نائبة ليعرف الآخرون ما يجب ضبطه. ويقارن .env Checker & Generator في DevSnip Pro بين الملفين ويولّد .env.example لك.

افحصه ثم شغّله

Terminal
docker compose config
docker compose up -d
docker compose ps

يتحقق docker compose config من الملف ويطبعه محلولًا بالكامل مع استبدال المتغيرات، فتظهر الأخطاء قبل أن يبدأ أي شيء. وداخل شبكة Compose، تصل الخدمات إلى بعضها باسم الخدمة: تتصل حاوية التطبيق بـ postgres://db:5432، لا بـ localhost:5432. ومن جهازك أنت، تبقى المنافذ المنشورة تعمل على localhost.

افعل ذلك في VS Code

  1. انسخ أوامر docker run من ملف README. يمكنك تحويل عدة أوامر معًا، واحدًا تلو الآخر.
  2. شغّل DevSnip Pro: docker run → Compose، أو ابحث عن "compose" في الشريط الجانبي لأدوات DevSnip Pro بـ Ctrl/Cmd+K.
  3. الصق الأوامر، أو خذها من المحرر النشط. يتحدّث compose.yaml أثناء الكتابة، مع عدد الخدمات والتحذيرات، مثل الأسرار المكتوبة مباشرة.
  4. احفظه باسم compose.yaml في مشروعك، ثم شغّل docker compose config.

تتعامل الأداة مع المنافذ ومتغيرات البيئة ووحدات التخزين والشبكات وسياسات إعادة التشغيل وفحوصات الصحة وحدود الموارد وGPU. ولخدمة جديدة بدلًا من أمر موجود، ينطلق Docker Compose Generator & Validator وDockerfile Generator & Linter في القسم نفسه من تقنياتك أنت.

جرّبه في محررك

مجاني، دون حساب، ويعمل محليًا. لـ VS Code 1.93 أو أحدث وبيئات JetBrains على Windows أو macOS أو Linux.

code --install-extension sayaib.hue-console