پرش به محتوای اصلی

راهنمای تبدیل docker run به compose

زمان مطالعه: ۲ دقیقه

این ابزار چیست؟

دستور docker run برای امتحان سریع یک کانتینر خوب است، اما وقتی چند کانتینر، پورت، متغیر و volume دارید، یک فایل compose خواناتر و قابل نگه‌داری‌تر است و با یک docker compose up همه را بالا می‌آورد. این ابزار یک یا چند دستور docker run را به فایل compose با YAML مرتب تبدیل می‌کند.

پورت‌ها، متغیرهای محیطی، volumeها، نام کانتینر، سیاست راه‌اندازی دوباره و دیگر گزینه‌های رایج شناخته می‌شوند. تبدیل در مرورگر شما انجام می‌شود.

گام‌به‌گام

  1. دستورها را بچسبانید

    هر دستور docker run را در یک خط بنویسید، یا با \ در پایان خط به خط بعد ادامه دهید؛ تا ۲۰ دستور پذیرفته می‌شود.

  2. نسخه را انتخاب کنید

    به‌طور پیش‌فرض قالب امروزی Compose بدون کلید version ساخته می‌شود؛ اگر ابزار قدیمی دارید، «نسخه‌ی ۳» یا «نسخه‌ی ۲» را بردارید.

  3. خروجی را بازبینی کنید

    «خروجی compose» را بخوانید، نام پروژه را جایگزین کنید و فایل را با نام compose.yaml کنار پروژه ذخیره کنید.

نمونه‌های کاربردی

  • یک وب‌سرور nginx

    پورت، متغیر منطقه‌ی زمانی، volume فقط‌خواندنی و سیاست راه‌اندازی دوباره به کلیدهای compose تبدیل می‌شوند و خروجی همان لحظه ساخته می‌شود.

    docker run -d --name web -p 8080:80 -e TZ=Asia/Tehran -v ./html:/usr/share/nginx/html:ro --restart unless-stopped nginx:1.27

    نتیجه: name: <your project name> services: nginx: container_name: web ports: - 8080:80 environment: - TZ=Asia/Tehran volumes: - ./html:/usr/share/nginx/html:ro restart: unless-stopped image: nginx:1.27

اشتباه‌های رایج

  • رها کردن name پیش‌فرض: <your project name> را با نام پروژه عوض کنید، وگرنه docker compose فایل را نمی‌پذیرد.
  • نوشتن گذرواژه‌ها مستقیم در environment: فایل compose معمولاً در مخزن می‌رود. رازها را در فایل ‎.env جدا بگذارید و با ${NAME} صدا بزنید.
  • volume با مسیر نسبی در جای اشتباه: ./html نسبت به پوشه‌ی فایل compose خوانده می‌شود، نه پوشه‌ای که دستور را از آن اجرا می‌کنید.
  • باز کردن پورت پایگاه داده روی همه‌ی رابط‌ها: اگر فقط کانتینرهای دیگر به آن نیاز دارند، ports را حذف کنید؛ سرویس‌ها در شبکه‌ی compose با نام هم را پیدا می‌کنند.

چرا compose؟

فایل compose پیکربندی همه‌ی کانتینرها را در یک جا و به شکل خوانا نگه می‌دارد. سرویس‌ها به‌طور خودکار در یک شبکه‌ی مشترک قرار می‌گیرند و با نام سرویس به هم وصل می‌شوند؛ مثلاً برنامه با نشانی db به پایگاه داده می‌رسد.

کلید version در قالب امروزی Compose دیگر لازم نیست و نادیده گرفته می‌شود؛ فقط ابزارهای قدیمی‌تر آن را می‌خواهند.

پرسش‌های متداول

چند فرمان را همزمان تبدیل می‌کند؟
بله؛ هر خط یک فرمان است و همه‌ی سرویس‌ها در یک فایل compose ادغام می‌شوند.
کدام گزینه‌ها پشتیبانی می‌شوند؟
گزینه‌های رایج مانند پورت، ولوم، متغیر محیطی، نام، شبکه، سیاست restart و env-file پشتیبانی می‌شوند؛ گزینه‌هایی که معادل مستقیم ندارند در خروجی نمی‌آیند.
فرمان من به جایی فرستاده می‌شود؟
خیر. تبدیل در مرورگر شما انجام می‌شود؛ با این حال رمزهای واقعی را در نمونه‌ها وارد نکنید.

ابزارهای مرتبط