Docker Compose - أداة ترتيب الصور

version: "3"
services:
  web:
    image: beginor/geoserver:2.11.1
    container_name: geoserver-web
    hostname: geoserver-web
    ports:
      - 8080:8080
    volumes:
      - ./web/data_dir:/geoserver/data_dir
      - ./web/logs:/geoserver/logs
    restart: unless-stopped
    links:
      - database:database
  database:
    image: beginor/postgis:9.3
    container_name: postgis
    hostname: postgis
    ports:
      - 5432:5432
    volumes:
      - ./database/data:/var/lib/postgresql/data
    environment:
      POSTGRES_PASSWORD: 1q2w3e4R
    restart: unless-stopped

sudo apt-get update
sudo apt-get install docker-compose

sudo yum update
sudo yum install docker-compose

ترجمة إلى العربية:

```shell
docker compose version
```

version: "3"

services:
  service1:
    build:
      context: .
      dockerfile: Dockerfile
    image: صورتك1
    command: ["python", "app.py"]
    ports:
      - "8000:8000"
    volumes:
      - ./data:/app/data
    networks:
      - شبكتك
    environment:
      - ENV_VARIABLE=القيمة
    depends_on:
      - db

  db:
    image: mysql:5.7
    environment:
      - MYSQL_ROOT_PASSWORD=كلمة المرور الخاصة بك
    volumes:
      - db-data:/var/lib/mysql

networks:
  شبكتك:

volumes:
  حجمك:
  db-data:

يرجى العلم بأنه يمكن أن تختلف تفاصيل الملف الخاص بـ Docker Compose حسب متطلبات التطبيق الفعلية.

- **version**: تُستخدم فقط لعرض معلومات إصدار ملف الـ compose. يرتبط بإصدار Docker Engine وقد يحتوي على ميزات أو تركيب جديد. يرجى الرجوع إلى [**Compose file versions and upgrading**](https://docs.docker.com/compose/compose-file/compose-versioning/) في الوثائق الرسمية.

- **services**: يعرف جميع الخدمات (الحاويات) المدرجة في ملف الـ compose هذا. كل خدمة هي حاوية مستقلة يمكن تعريف صورتها، وتعيين تطوير البيئة وغيرها.

- **container_name**: اسم الحاوية. اختياري، ولكن لا يجوز تكرار الأسماء.

- **networks**: يعرف تكوين الشبكة بين الخدمات. يمكن إنشاء شبكات مخصصة وربط الخدمات بهذه الشبكات لتحقيق التواصل بين الحاويات.

- **volumes**: يعرف تكوين توصيل الأقراص للحاوية. يمكن توصيل مجلدات أو ملفات الحاوية بمجلدات أو ملفات المضيف لتحقيق الاستدامة والمشاركة. يعادل معامل `-v` في Docker CLI.

- **environment** (أو `env_file`): يحدد اسم ملف ومسار متغيرات البيئة للحاوية. يتم تحميل المتغيرات من هذا الملف. إذا لم يتم تكوين المتغيرات، يمكن تجاهله. إذا كان ملف المتغيرات موجودًا في الدليل الحالي ويسمى `.env`، يمكن تجاهله أيضًا. يعادل معامل `-e` في Docker CLI.

- **build**: يبدأ باستخدام الصورة المُبنية. يُحدد مسار ملف Dockerfile.

- **image**: يُحدد الصورة التي سيستخدمها الحاوية. يمكن استخدام صور من مستودع الصور العام أو تحديد ملف Dockerfile محلي.

- **ports**: يُحدد علاقة التعيين بين الحاوية والمضيف ويمكن تحديد بروتوكول التعيين (TCP أو UDP). يعادل معامل `-p` في Docker CLI.

- **depends_on**: يُحدد العلاقات بين الخدمات. يمكن تحديد اسم أو أسماء الخدمات التي تعتمد عليها الخدمة الحالية في تشغيلها.

- **restart**: يُحدد استراتيجية إعادة تشغيل الحاوية. يمكن تعيينها إلى `no` (بدون إعادة تشغيل تلقائي) أو `always` (إعادة تشغيل دائمًا) أو `unless-stopped` (إعادة تشغيل ما لم يتم إيقاف الحاوية يدويًا) أو `on-failure` (إعادة تشغيل فقط في حالة الفشل). يعادل معامل `--restart` في Docker CLI.

- **command**: يُحدد الأمر الذي سيتم تنفيذه عند بدء تشغيل الحاوية، ويُستخدم لتجاوز الأمر الافتراضي في صورة الحاوية.

- **volumes_from**: يُحدد مصدر الأقراص التي سيتم توصيلها إلى الحاوية.

## بعض الأوامر الشائعة لإدارة وتشغيل الخدمات المحددة في ملف `compose.yaml`:


```markdown
- `docker compose up`: يقوم ببناء الصور المحددة في compose ويشغل الحاويات. إذا كان ذلك ضروريًا، سيقوم ببناء الصور تلقائيًا (إذا تغير Dockerfile) ثم يشغل جميع الخدمات المحددة. إذا كنت بحاجة إلى تشغيله في الخلفية، فضع الخيار `-d`.

- `docker compose down`: يوقف ويزيل جميع الحاويات والشبكات والأقراص المحددة في compose. سيتوقف عن تشغيل الخدمات الجارية وينظف جميع الموارد ذات الصلة.

- `docker compose pull`: يجلب جميع الصور المحددة في compose أو يستخدم لتحديث الصور.

- `docker compose start`: يقوم بتشغيل الحاويات الموجودة بالفعل في compose، ولن يقوم بإعادة إنشاء الحاويات أو إعادة بناء الصور.

- `docker compose stop`: يقوم بإيقاف تشغيل الحاويات الموجودة بالفعل في compose، ولكنه لن يقم بإزالتها.

- `docker compose restart`: يقوم بإعادة تشغيل الحاويات الموجودة بالفعل في compose.

- `docker compose pause`: يقوم بإيقاف مؤقت للحاويات الموجودة بالفعل في compose، مما يجعلها تتوقف مؤقتًا عن العمل.

- `docker compose unpause`: يقوم بإعادة تشغيل الحاويات التي تم إيقافها مؤقتًا في compose لاستئناف تشغيلها.

- `docker compose ps`: يعرض حالة **جميع** الحاويات الجارية في compose.

- `docker compose logs`: يعرض سجلات الإخراج للحاويات الموجودة في compose.

- `docker compose exec`: يُستخدم لتنفيذ الأوامر في الحاويات الجارية في compose. على سبيل المثال: `docker exec -it [اسم الـ compose] /bin/bash`.

هذه بعض الأوامر الشائعة، يمكنك أيضًا تنفيذ `docker compose --help` لعرض المزيد من الأوامر المتاحة.

## المتغيرات البيئية

في Docker Compose، على الرغم من أن المتغيرات البيئية ليست إلزامية، إلا أنه من المستحسن استخدامها بشكل مكثف لأسباب عدة:

1. **المرونة وقابلية التكوين**: يمكنك بسهولة تعديل معلومات تكوين التطبيق دون الحاجة إلى تعديل صور Docker أو إعادة بناء الحاويات.
2. **الأمان والعزل**: من خلال تخزين المعلومات الحساسة في المتغيرات البيئية بدلاً من كتابتها مباشرة في الشيفرة أو ملف التكوين، يمكنك زيادة أمان التطبيق.
3. **التوافق عبر المنصات**: يمكن نقل معلومات التكوين المختلفة إلى الحاويات دون الحاجة إلى تعديل ملفات التكوين أو شيفرة الصور.
4. **تبسيط النشر والإدارة**: من خلال استخدام المتغيرات البيئية بشكل موحد لتكوين معلمات مختلفة للحاويات، يمكنك تقليل التكرار في ملفات التكوين وجعل العملية أكثر وضوحًا وسهولة للصيانة.
5. **التكامل والتلقائية**: بالتنسيق مع أدوات CI/CD والأتمتة، يمكن نقل معلمات تكوين التطبيق إلى حاويات Docker تلقائيًا، مما يتيح النشر والتكامل التلقائي.

المتغيرات البيئية عادةً ما تتمثل في ملف بامتداد `.env`، وعادةً ما يتم إنشاؤه مباشرة في نفس الدليل الرئيسي الذي يحتوي على ملف `compose.yaml`. فيما يلي مثال:

```dotenv title=".env"
TAG=v1.5

services:
  web:
    image: "webapp:${TAG}"