# نحوه استفاده از داکر کامپوز

- پیوند: https://negarnovin.com/docs/how-to-use-docker-compose/
- منتشرشده: 2025-09-13T12:07:50+00:00
- نویسنده: نگارنوین

# نحوه استفاده از داکر کامپوز

یاد بگیرید که چگونه برنامه های چند کانتینری را با Docker Compose با استفاده از compose.
yaml، پروفایل های سرویس و دستورات ضروری CLI مدیریت کنید.

Docker Compose ابزاری برای هماهنگ سازی چند کانتینری برای یک میزبان واحد است. این
ابزار از موتور Docker برای مدیریت و هماهنگ سازی کانتینرهای Docker استفاده می کند.
این ابزار با فراهم کردن امکان ایجاد کانتینرهای پیچیده و به هم پیوسته به صورت اعلانی،
محیط توسعه محلی شما را ساده می کند. Docker Compose همچنین با ارائه یک محیط موقت 
و ایزوله برای آزمایش، مجموعه تست را در فرآیند CI/CD خودکار می کند.

این مقاله نحوه استفاده از Docker Compose برای ایجاد و مدیریت کانتینرها را توضیح 
می دهد. اصول اولیه دستور `docker compose`و نحوه ایجاد `compose.yaml`مانیفست را پوشش
می دهد. همچنین پروفایل Docker Compose را برای اجرای کانتینرها بسته به محیط شما بررسی
می کند.

## توضیحات کوتاه

در زیر چند دستور اساسی Docker Compose که روی یک فایل `compose.yaml`or عمل می کنند،
آورده شده است.`docker-compose.yaml`

    ```
    # Create/build and start all services in the background.
    $ docker compose up -d

    # Stop and remove all service containers, networks, and volumes.
    $ docker compose down

    # Stop all services.
    $ docker compose stop

    # Start and run stopped services.
    $ docker compose start

    # View the status of running services.
    $ docker compose ps

    # Check the logs of all services.
    $ docker compose logs
    ```

## یک فایل Docker Compose ایجاد کنید

این بخش به ایجاد یک فایل نمونه Docker Compose `compose.yaml`برای یک برنامه نمونه
flask می پردازد.

 1.  نمونه برنامه را دانلود کنید.
 2.  console
 3.      ```
         $ git clone https://github.com/ndlrfz/flask-redis-postgresql
         ```
     
 4.  به `flask-redis-postgresql`دایرکتوری پروژه بروید.
 5.  console
 6.      ```
         $ cd flask-redis-postgresql
         ```
     
 7.  این دایرکتوری حاوی فایلی `compose.yaml`با محتوای زیر است.
 8.  console
 9.      ```
         $ cat compose.yml
         ```
     
 10. مانیفست Docker Compose زیر را مشاهده خواهید کرد:
 11. yaml
 12.     ```
         name: myproject
     
         services:
          redis:
          image: "redis:alpine"
          restart: always
          ports:
          - 6379:6379
          volumes:
          - redis:/data
     
          postgresql:
          image: "postgres:16-alpine"
          ports:
          - "5432:5432"
          volumes:
          - pgdata:/var/lib/postgresql/data
          environment:
          POSTGRES_USER: ${DATABASE_USER}
          POSTGRES_PASSWORD: ${DATABASE_PASSWORD}
          POSTGRES_DB: ${DATABASE_NAME}
     
          flask:
          build: .
          restart: always
          env_file:
          - ".env"
          depends_on:
          - redis
          - postgresql
          ports:
          - "8000:5000"
          volumes:
          - ./:/code
     
         volumes:
          redis:
          driver: "local"
          pgdata:
          driver: "local"
         ```
     
 13. در این فایل،
 14.  * `name`: نام پروژه را روی تنظیم می کند `myproject`.
      * `services`: کانتینرهای منفردی را که برنامه شما را تشکیل می دهند، تعریف می کند.
      * `redis`سرویس را با این جزئیات تعریف کنید :
         - `image`: سرویس را از روی `redis:alpine`تصویر ایجاد می کند.
         - `restart: always`: سیاستی را تنظیم می کند که در صورت توقف، این کانتینر همیشه
           مجدداً راه اندازی شود.
         - `ports`پورت `6379`روی میزبان را به پورت `6379`داخل کانتینر نگاشت می کند.
         - `volumes`: برای داده های ماندگار، والیوم نامگذاری شده را `redis`به `/data`
           دایرکتوری داخل کانتینر متصل می کند.
      * `postgresql`سرویس را با موارد زیر تعریف کنید :
         - `image`: سرویس را از روی `postgres:16-alpine`تصویر ایجاد می کند.
         - `ports`پورت `5432`روی میزبان را به پورت `5432`داخل کانتینر نگاشت می کند.
         - `volumes`: برای داده های ماندگار، والیوم نامگذاری شده را `pgdata`در دایرکتوری
           نصب می کند.`/var/lib/postgresql/data`
         - `environment`متغیرهای محیطی داخل کانتینر را تنظیم می کند. مقادیر مربوط به`
           ${DATABASE_USER}`، `${DATABASE_PASSWORD}`، و `${DATABASE_NAME}`از محیط پوسته
           شما جایگزین می شوند (که اغلب از یک `.env`فایل بارگذاری می شود).
      * سرویس برنامه را `flask`با موارد زیر تعریف کنید:
         - `build: .`: یک تصویر داکر در دایرکتوری فعلی از فایل `Dockerfile`. می سازد.
         - `restart: always`: سیاستی را تنظیم می کند که در صورت توقف، این کانتینر همیشه
           مجدداً راه اندازی شود.
         - `env_file`متغیرهای محیطی سرویس را مستقیماً از یک `.env`فایل بارگذاری می 
           کند.
         - `depends_on`: ترتیب راه اندازی را کنترل می کند. `flask`سرویس فقط پس از شروع
           سرویس های `redis`و شروع می شود.`postgresql`
         - `ports`پورت `8000`روی میزبان را به پورت `5000`داخل کانتینر نگاشت می کند.
         - `volumes`: دایرکتوری پروژه فعلی روی میزبان را به `/code`دایرکتوری داخل کانتینر
           متصل می کند.
      * `volumes`: دو volume نامگذاری شده تعریف می کند، `redis`و `pgdata`، با استفاده
        از `local`درایور. اینها توسط Docker مدیریت شده و در دستگاه میزبان ذخیره می 
        شوند.
 15. یک فایل ایجاد کنید `.env`.
 16. console
 17.     ```
         $ nano .env
         ```
     
 18. متغیرهای محیطی زیر را برای اعتبارنامه های PostgreSQL اضافه کنید. می توانید جزئیات
     زیر را با اعتبارنامه های خود جایگزین کنید.
 19. ini
 20.     ```
         DATABASE_USER=app_user
         DATABASE_PASSWORD=app_password
         DATABASE_NAME=appdb
         DATABASE_HOST=postgresql
         DATABASE_PORT=5432
         ```
     
 21. فایل را ذخیره کرده و از آن خارج شوید.
 22. خدمات خود را بسازید و شروع کنید.
 23. console
 24.     ```
         $ docker compose up -d
         ```
     
 25. این گزینه `-d`به شما امکان می دهد کانتینرها را در پس زمینه اجرا کنید.
 26. دستور زیر را اجرا کنید تا کانتینرها یا سرویس های در حال اجرا را بررسی کنید.
 27. console
 28.     ```
         $ docker compose ps
         ```
     
 29. خروجی:
 30.     ```
         NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
         myproject_flask-1 myproject_flask "flask run --debug" flask About a minute ago Up About a minute 0.0.0.0:8000->5000/tcp, [::]:8000->5000/tcp
         myproject_postgresql-1 postgres:16-alpine "docker-entrypoint.s…" postgresql About a minute ago Up About a minute 0.0.0.0:5432->5432/tcp, [::]:5432->5432/tcp
         myproject_redis-1 redis:alpine "docker-entrypoint.s…" redis About a minute ago Up 32 seconds 0.0.0.0:6379->6379/tcp, [::]:6379->6379/tcp
         ```
     
 31. توضیح خروجی:
 32.  * `flask`سرویس روی پورت `8000`روی دستگاه میزبان اجرا می شود که بر اساس تصویر 
        داکر است `myproject_flask`.
      * `postgresql``5432`سرویسی که بر اساس تصویر داکر روی پورت اجرا می شود `postgres:
        16-alpine`.
      * `redis``6379`سرویس بر اساس تصویر داکر روی پورت اجرا می شود `redis:alpine`.
 33. لیست تصاویری که توسط سرویس های شما استفاده می شوند را بررسی کنید.
 34. کنسول
 35.     ```
         $ docker compose images
         ```
     
 36. خروجی:
 37.     ```
         CONTAINER REPOSITORY TAG IMAGE ID SIZE
         myproject_flask-1 myproject_flask latest 1c3d151b6276 254MB
         myproject_postgresql-1 postgres 16-alpine b56133b65cd3 275MB
         myproject_redis-1 redis alpine d470ca4bc10c 60.5MB
         ```
     
 38. یک مرورگر وب باز کنید و `http://<SERVER-IP>:8000/`برای تأیید اجرای برنامه خود،
     به این آدرس مراجعه کنید.
 39. ![نحوه استفاده از داکر کامپوز](https://negarnovin.com/wp-content/uploads/2025/
     09/79b822fb-4836-457f-ac9e-28a7e1279ec3_compressed.webp)

## مدیریت Docker Compose

جدول زیر `docker compose`دستورات رایج برای مدیریت پشته برنامه شما را شرح می دهد.

  |  فرمان |  توضیحات |  مثال |  
   |  `build` |  ساخت یا بازسازی کانتینرها |  `docker compose build` |  
 |  `up` |  ایجاد و شروع کانتینرها |  `docker compose up -d` |  
 |  `down` |  ظروف را متوقف کرده و بردارید |  `docker compose down` |  
 |  `start` |  شروع کانتینرهای موجود |  `docker compose start app` |  
 |  `stop` |  ظروف را متوقف کنید |  `docker compose stop app` |  
 |  `kill` |  ظروف توقف اجباری |  `docker compose kill app` |  
 |  `ps` |  بررسی کانتینرهای در حال اجرا |  `docker compose ps` |  
 |  `logs` |  لاگ ها را برای کانتینرها بررسی کنید |  `docker compose logs app` |  
 |  `exec` |  اجرای دستور در کانتینر |  `docker compose exec app bash` |  
 |  `images` |  فهرست کردن تصاویر استفاده شده توسط کانتینرها |  `docker compose images` |  
 |  `rm` |  ظروف متوقف شده را بردارید |  `docker compose rm` |

## استفاده از پروفایل های Docker Compose

پروفایل ها به برنامه ها یا سرویس های انتخابی اجازه می دهند تا بر اساس محیط یا موارد
استفاده، مانند توسعه و تولید، اجرا شوند.

 1.  فایل را ویرایش کنید `compose.yml`.
 2.  console
 3.      ```
         $ nano compose.yml
         ```
     
 4.  پیکربندی زیر را در زیر `flask`سرویس اضافه کنید.
 5.  yaml
 6.      ```
         adminer:
          image: adminer
          restart: always
          depends_on: [postgresql]
          profiles: [dev]
          ports:
          - 8080:8080
          redis-insight:
          image: redis/redisinsight:latest
          restart: always
          profiles: [dev]
          depends_on: [redis]
          ports:
          - "8001:8001"
         ```
     
 7.  فایل را ذخیره کنید و ببندید.
 8.  در این پیکربندی:
 9.   * `adminer`: سرویسی با نام را تعریف می کند `adminer`که از `adminer`تصویر داکر
        استفاده می کند.
         - `restart: always`: سیاستی را تنظیم می کند که در صورت توقف، کانتینر همیشه
           مجدداً راه اندازی شود.
         - `depends_on`: تضمین می کند که `adminer`سرویس فقط پس از `postgresql`شروع 
           سرویس، شروع به کار کند.
         - `profiles`: `dev`نمایه را به سرویس اختصاص می دهد.
         - `ports`پورت `8080`روی میزبان را به پورت `8080`داخل کانتینر نگاشت می کند.
      * `redis-insight`: سرویسی با نام را تعریف می کند `redis-insight`که از `redis/
        redisinsight:latest`تصویر داکر استفاده می کند.
         - `restart: always`: سیاستی را تنظیم می کند که در صورت توقف، کانتینر همیشه
           مجدداً راه اندازی شود.
         - `depends_on`: تضمین می کند که `redis-insight`سرویس فقط پس از `redis`شروع
           سرویس، شروع به کار کند.
         - `profiles`: `dev`نمایه را به سرویس اختصاص می دهد.
         - `ports`پورت `8001`روی میزبان را به پورت `8001`داخل کانتینر نگاشت می کند.
 10. سرویس را شروع کنید `adminer`.
 11. console
 12.     ```
         $ docker compose --profile dev up -d
         ```
     
 13. از این `--profile dev`گزینه برای فعال سازی و شروع سرویس های اختصاص داده شده به`
     dev`پروفایل استفاده کنید. این به Docker Compose می گوید که `adminer`سرویس را که
     به طور پیش فرض نادیده گرفته می شود، لحاظ کند.
 14. با دستور زیر کانتینر در حال اجرا را بررسی کنید.
 15. console
 16.     ```
         $ docker compose ps
         ```
     
 17. خواهید دید که `adminer`سرویس در حال اجرا است.
 18.     ```
         NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
         myproject-adminer-1 adminer "entrypoint.sh docke…" adminer 2 seconds ago Up 1 second 0.0.0.0:8080->8080/tcp, [::]:8080->8080/tcp
         myproject-flask-1 myproject-flask "flask run --debug" flask 2 seconds ago Up 1 second 0.0.0.0:8000->5000/tcp, [::]:8000->5000/tcp
         myproject-postgresql-1 postgres:16-alpine "docker-entrypoint.s…" postgresql 3 seconds ago Up 2 seconds 0.0.0.0:5432->5432/tcp, [::]:5432->5432/tcp
         myproject-redis-1 redis:alpine "docker-entrypoint.s…" redis 3 seconds ago Up 2 seconds 0.0.0.0:6379->6379/tcp, [::]:6379->6379/tcp
         myproject-redis-insight-1 redis/redisinsight:latest "./docker-entry.sh n…" redis-insight 3 seconds ago Up 1 second 5540/tcp, 0.0.0.0:8001->8001/tcp, [::]:8001->8001/tcp
         ```
     
 19. برای متوقف کردن یک سرویس، به عنوان مثال `adminer`، از
 20. کنسول
 21.     ```
         $ docker compose stop adminer
         ```
     
 22. سرویس متوقف شده را حذف کنید `adminer`.
 23. console
 24.     ```
         $ docker compose rm adminer
         ```
     
 25. تمام سرویس ها (از جمله `dev`پروفایل) را از بین ببرید.
 26. console
 27.     ```
         $ docker compose --profile dev down
         ```
     

## نتیجه گیری

در این مقاله، نحوه استفاده از Docker Compose برای مدیریت پشته های کانتینر را بررسی
کردید. یاد گرفتید که چگونه کانتینرها را با استفاده از `docker compose`دستور شروع،
متوقف، راه اندازی مجدد و از بین ببرید، چگونه فایل را برای پشته برنامه خود ایجاد 
کنید `compose.yaml`و کاربرد اولیه پروفایل های Docker Compose را برای اجرای انتخابی
کانتینرها بسته به محیط خود بررسی کردید. برای اطلاعات بیشتر، [مستندات Docker Compose را](https://docs.docker.com/compose/)
بررسی کنید .
