JSON إلى Docker Compose YAML

أنشئ ملف compose.yaml صالحًا من JSON، مع اقتباس قيم المنافذ والبيئة بأمان.

خيارات المخرجات

JSONالمدخلات

فارغ

YAMLالمخرجات

تظهر مخرجات YAML هنا

يعمل بالكامل داخل متصفحك: لا يُرفع أي شيء. تُطبَّق حدود الاستخدام العادل (5 MB لكل إدخال، وعدد محدود من عمليات التحويل) لمنع الرسائل المزعجة والبوتات.

تحميل من URL

يجلب متصفحك الملف مباشرةً، لذا يجب أن يسمح الخادم بالطلبات عبر المصادر (cross-origin).

اختصارات لوحة المفاتيح

Ctrl / ⌘ + Enter التحويل الآن
Ctrl / ⌘ + S تنزيل المخرجات
Alt + Shift + C نسخ المخرجات
Alt + Shift + F إصلاح مدخلات JSON وتنسيقها
Alt + Shift + S تبديل الاتجاه
Alt + Shift + T التبديل بين عرض الشيفرة والشجرة والخريطة
Ctrl / ⌘ + Z تراجع، بما في ذلك «تنسيق» و«إصلاح» و«مسح»
Esc الخروج من ملء الشاشة
حجم النص في المحرّر

قيم المنافذ والبيئة مقتبسة بأمان

تقرأ ملفاتِ Compose محلّلاتُ YAML 1.1، حيث 22:22 عدد بالنظام الستيني وNO تعني false. تُقتبس كل سلسلة ملتبسة لتبدأ الخدمات بالقيم التي كتبتها.

JSON
{
  "services": {
    "web": {
      "image": "nginx:1.27",
      "ports": [
        "80:80",
        "22:22"
      ],
      "environment": {
        "DEBUG": "false",
        "WORKERS": "4",
        "COUNTRY": "NO"
      }
    }
  }
}
compose.yaml
services:
  web:
    image: nginx:1.27
    ports:
      - '80:80'
      - '22:22'
    environment:
      DEBUG: 'false'
      WORKERS: '4'
      COUNTRY: 'NO'

أبقِ آمن لـ YAML 1.1 مفعّلًا لملفات Compose. أوقفه أعلاه لترى 22:22 مكتوبًا دون اقتباس، وكيف يفهمه محلّل YAML 1.1.

تحقّق من النتيجة باستخدام Docker

يتحقق docker compose config من الملف ويطبع النموذج النهائي، ويمكنه أيضًا طباعة هذا النموذج بصيغة JSON.

bash
# Validate a compose file and print the fully resolved model
docker compose config

# The same model as JSON, e.g. to inspect it with jq
docker compose config --format json | jq '.services | keys'

نصائح Compose

استخدم compose.yaml

إنه اسم الملف المفضّل. ولا يزال docker-compose.yml يعمل مع المشاريع الأقدم.

احذف مفتاح version

الحقل version في المستوى الأعلى متقادم؛ يتجاهله Docker Compose الحالي ويطبع تحذيرًا.

قوائم أو تعيينات لمتغيرات البيئة

يقبل environment تعيينًا (KEY: value) أو قائمة (- KEY=value). والتعيينات المأخوذة من كائنات JSON أسهل في القراءة.

مزيد من الأدوات

محوّلات ومدقّقات وأدلة خطوة بخطوة لكل موضع يلتقي فيه JSON وYAML.

الأسئلة الشائعة

كيف أحوّل JSON إلى ملف Docker Compose؟

الصق JSON في المحرّر وانسخ YAML من لوحة المخرجات إلى compose.yaml. احتفظ بمفاتيح المستوى الأعلى services وvolumes وnetworks، ثم شغّل docker compose config للتحقق من النتيجة.

لماذا تُقتبس تعيينات المنافذ مثل "80:80"؟

تقرأ محلّلات YAML 1.1 الأعداد غير المقتبسة المفصولة بنقطتين، مثل 22:22، على أنها أعداد صحيحة بالنظام الستيني. توصي Docker دائمًا باقتباس تعيينات المنافذ، ويتولى المحوّل ذلك عنك ما دام «آمن لـ YAML 1.1» مفعّلًا.

هل يجب أن يُسمّى الملف compose.yaml أم docker-compose.yml؟

compose.yaml هو الاسم المفضّل في مواصفة Compose الحالية؛ ولا يزال docker-compose.yml وdocker-compose.yaml يُقرآن للتوافق مع الإصدارات السابقة.

هل ما زلت أحتاج إلى مفتاح version؟

لا. مفتاح version في المستوى الأعلى متقادم في مواصفة Compose، ويتجاهله Docker Compose ويطبع تحذيرًا. يمكنك حذفه.

هل يمكنني تحويل ملف compose إلى JSON مجددًا؟

نعم. بدّل الاتجاه إلى YAML → JSON، أو شغّل docker compose config --format json، الذي يحلّ أيضًا المتغيرات وextends وprofiles.