ما هو Docker Compose ولماذا نستخدمه؟

Question

Accepted Answer

**Docker Compose** هي أداة لتعريف وتشغيل **تطبيقات متعددة الحاويات** باستخدام ملف YAML واحد. بدلاً من تشغيل عدة أوامر `docker run` يدويًا، تصف جميع خدماتك (التطبيق، قاعدة البيانات، الذاكرة المؤقتة) في `docker-compose.yml` وتشغيلها معًا بأمر واحد.

## المشكلة التي يحلها Compose

```text
A real app often has MULTIPLE containers: a web app + a database + a cache + ...
  → manually running each with docker run (ports, networks, volumes, env, dependencies)
    is tedious, error-prone, and hard to reproduce/share
→ Compose defines the WHOLE stack in one file → start it all with one command.
```

## ملف docker-compose.yml

```yaml
services:
  web:
    build: .                    # build from the local Dockerfile
    ports:
      - "3000:3000"             # map ports
    environment:
      - DATABASE_URL=postgres://db:5432/myapp
    depends_on:
      - db                       # start db before web
  db:
    image: postgres:16           # use a prebuilt image
    environment:
      - POSTGRES_PASSWORD=secret
    volumes:
      - dbdata:/var/lib/postgresql/data   # persist the database
volumes:
  dbdata:
```

ملف واحد يعرّف جميع الخدمات وصورها/البناء والمنافذ والبيئة والمجلدات والتبعيات — وهي تشترك في شبكة (تصل إلى بعضها البعض حسب اسم الخدمة، مثل `db`).

## تشغيل المكدس

```bash
docker compose up -d        # build and start ALL services (in the background)
docker compose ps           # list the running services
docker compose logs -f      # view logs from all services
docker compose down         # stop and remove everything
docker compose down -v      # also remove volumes
```

## لماذا يهم

فهم Docker Compose قيّم لأن التطبيقات الحقيقية تتضمن دائمًا تقريبًا **حاويات متعددة**، و Compose هي الأداة القياسية لإدارتها، لذا فهي معرفة عملية مهمة.

المشكلة التي يحلها حقيقية جدًا: التطبيق النموذجي يحتوي على عدة خدمات (تطبيق ويب وقاعدة بيانات وذاكرة مؤقتة وربما قائمة انتظار رسائل)، وتشغيل كل منها يدويًا بأوامر `docker run` منفصلة — حيث تقوم بتكوين المنافذ والشبكات والمجلدات ومتغيرات البيئة وترتيب البدء — أمر مرهق وعرضة للأخطاء وصعب الاستنساخ والمشاركة. يحل **Compose** هذه المشكلة بتعريف **مكدس الحاويات المتعددة بالكامل في ملف YAML إعلاني واحد** وتشغيل الجميع بأمر واحد (`docker compose up`)، مما يجعل تطبيقات متعددة الحاويات سهلة التشغيل والاستنساخ والمشاركة.

فهم بنية `docker-compose.yml` (تعريف الخدمات مع صورها/البناء والمنافذ والبيئة والمجلدات والتبعيات، مع توصيل الخدمات تلقائيًا في الشبكة وإمكانية الوصول إليها بالاسم) والأوامر الأساسية (`up`، `down`، `ps`، `logs`) هو معرفة عملية يومية للتطوير وتشغيل التطبيقات متعددة الخدمات.

Compose قيّمة بشكل خاص لـ **بيئات التطوير المحلية** (تشغيل تطبيق مع قاعدة بيانته وتبعياته بأمر واحد) ولتعريف مكدسات التطبيقات بطريقة قابلة للاستنساخ.

بما أن التطبيقات الحقيقية عادة ما تكون متعددة الحاويات، وبما أن Docker Compose هي الأداة القياسية والمستخدمة على نطاق واسع لتعريفها وتشغيلها بسهولة (بدلاً من الأتمتة اليدوية المرهقة بملف إعلاني واحد وأمر واحد)، فإن فهم Docker Compose — ما تحله، بنية ملف التشكيل والأوامر — هو معرفة قيمة وتُطبق بشكل متكرر للعمل مع التطبيقات متعددة الحاويات، وهي أداة شبه أساسية مصاحبة لـ Docker لأي تطبيق معبأ غير تافه وأداة في كل مكان في سير العمل الإنمائي.