CloudFormation: من JSON إلى YAML

حوّل قوالب AWS CloudFormation إلى 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 الخروج من ملء الشاشة
حجم النص في المحرّر

الدوال الجوهرية تبقى صالحة

تُكتب Ref وFn::Sub وFn::GetAtt بصيغتها الكاملة، التي تقرؤها CloudFormation في YAML تمامًا كما في JSON.

مخرجات المحوّل (الصيغة الكاملة)
BucketName:
  Fn::Sub: assets-${Environment}
Tags:
  - Key: env
    Value:
      Ref: Environment
Resource:
  Fn::GetAtt:
    - AssetsBucket
    - Arn
الصيغة المختصرة المكافئة
BucketName: !Sub 'assets-${Environment}'
Tags:
  - Key: env
    Value: !Ref Environment
Resource: !GetAtt AssetsBucket.Arn

تُنشر النسختان بالطريقة نفسها. الوسوم المختصرة امتداد خاص بـ CloudFormation، لذا يحتفظ المحوّل بالصيغة الكاملة التي تستطيع أي أداة YAML قراءتها.

قوالب أصغر وأسهل في المراجعة

القالب النموذجي أصغر بنسبة 36% بصيغة YAML منه بصيغة JSON المنسّق، دون أقواس معقوفة أو علامات اقتباس تتخطاها أثناء المراجعة.

bash
# Validate the converted template with the AWS CLI
aws cloudformation validate-template --template-body file://template.yaml

تفاصيل CloudFormation التي يتولاها المحوّل عنك

قارن مخرجات المحوّل بقيم القالب نفسها مكتوبة يدويًا دون علامات اقتباس.

تواريخ الإصدارات

تبقى '2010-09-09' و'2012-10-17' سلسلتين نصيتين بدلًا من أن تصبحا تاريخين في YAML 1.1.

سلاسل الاستبدال

تُحفظ العناصر النائبة ${AWS::AccountId} داخل Fn::Sub حرفًا بحرف.

مستندات السياسات

تُحوَّل سياسات IAM المضمّنة مثل بقية القالب، فتظهر الإجراءات والموارد كقوائم نظيفة.

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

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

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

كيف أحوّل قالب CloudFormation من JSON إلى YAML؟

الصق JSON الخاص بالقالب أو ارفع template.json. انسخ YAML أو نزّل template.yaml، ثم انشره مثل أي قالب آخر. تبقى الموارد والمعاملات والمخرجات كما هي تمامًا.

هل يستخدم YAML الدوال المختصرة مثل !Ref و!Sub؟

لا. يكتب المحوّل الصيغة الكاملة (Ref: وFn::Sub: وFn::GetAtt:)، التي تقبلها CloudFormation في قوالب YAML ويستطيع كل محلّل YAML قراءتها. الوسوم المختصرة مجرد اختصار اختياري.

لماذا تُقتبس قيمة AWSTemplateFormatVersion؟

القيمة 2010-09-09 دون اقتباس تاريخٌ في YAML 1.1. تتوقع CloudFormation سلسلة نصية، لذا يكتب المحوّل '2010-09-09'. وتُقتبس إصدارات سياسات IAM مثل '2012-10-17' للسبب نفسه.

هل يمكنني تحويل قالب YAML إلى JSON مجددًا؟

نعم، للقوالب المكتوبة بالصيغة الكاملة: بدّل الاتجاه إلى YAML → JSON. أما القوالب المكتوبة بوسوم مختصرة مثل !Ref فتحتاج إلى أداة تفهم CloudFormation، لأن هذه الوسوم ليست أنواع YAML قياسية.

هل لصق قوالب تتضمن تفاصيل الحساب آمن؟

نعم. يتم التحويل داخل متصفحك ولا يُرفع أي شيء ولا يُسجَّل، لذا تبقى معرّفات الحسابات وأسماء ARN والقيم الافتراضية للمعاملات على جهازك.