YAML وJSON: كيف تحوّل ملفات الإعداد دون إفسادها

يصف YAML وJSON غالباً النوع نفسه من البيانات، لكنهما ليسا مجرد شكلين يمكن التحويل بينهما باستبدال علامات الترقيم. يعتمد JSON على الأقواس والمفاتيح الواضحة، بينما يعتمد YAML على المسافات ويوفر التعليقات والمراجع وطرقاً متعددة لكتابة النصوص الطويلة. لذلك يجب تحليل المصدر إلى بيانات حقيقية ثم إعادة كتابتها بالصيغة المطلوبة.

متى يفيد تحويل YAML إلى JSON؟

يكون التحويل مفيداً عندما تقبل واجهة API أو أداة بناء أو أداة تصحيح JSON فقط، بينما يفضّل الفريق كتابة إعدادات Kubernetes أو CI أو التطبيق بصيغة YAML. كما يساعد JSON على رؤية الفرق بوضوح بين النص والرقم والقيمة المنطقية والمصفوفة والكائن.

يمكن أيضاً استعمال التحويل أثناء اكتشاف الأخطاء. إذا نجح محلل مستقل في قراءة YAML فهذا يعني أن الصياغة مفهومة، لكنه لا يعني أن التطبيق المستهدف يقبل كل خاصية. التحقق من الصياغة يختلف عن التحقق من مخطط التطبيق.

معلومات قد لا تبقى بعد التحويل

لا يملك JSON صيغة قياسية للتعليقات، لذلك تختفي تعليقات YAML. تتحول المراجع والـ aliases إلى بيانات عادية، ولا تبقى اختيارات التنسيق مثل علامات الاقتباس والأسطر الفارغة. إذا كانت التعليقات مهمة فاحتفظ بالملف الأصلي داخل نظام التحكم في الإصدارات.

انتبه للقيم التي يمكن فهمها بنوع مختلف. القيمة "0012" نص، بينما قد تتحول القيمة غير المحاطة بعلامات إلى الرقم 12. ضع المعرّفات بين علامتي اقتباس عندما تكون الأصفار الأولى أو الكتابة الدقيقة مهمة، ثم راجع البيانات الناتجة لا شكل الملف فقط.

خطوات تحويل آمنة

1. احفظ نسخة من الملف الأصلي أو أضفه إلى Git.
2. استعمل محلل YAML حقيقياً للمستند كاملاً.
3. راجع رسائل السطر والعمود، فقد يبدأ خطأ المسافات قبل السطر المشار إليه.
4. تحقق من الأرقام والقيم المنطقية والفارغة والمعرّفات في JSON.
5. تحقق من النتيجة باستعمال مخطط التطبيق المستهدف.
6. اختبر في بيئة غير إنتاجية قبل النشر.

التحويل من JSON إلى YAML

يكون هذا الاتجاه أسهل عادة لأن بيانات JSON القياسية تدخل ضمن نموذج YAML. لكن المحول لا يستطيع اختراع تعليقات مفيدة أو معرفة أسلوب التنسيق الذي يفضله فريقك. أضف الشرح بعد التأكد من صحة البنية.

يرفض JSON القياسي الفواصل النهائية والمفاتيح غير المحاطة بعلامات والتعليقات. صحح الخطأ بدلاً من السماح للأداة بالتخمين، لأن رسالة خطأ واضحة أفضل من تغيير صامت في البيانات. تتم المعالجة في ToolBlur داخل المتصفح، ومع ذلك يُفضّل استبدال الأسرار بقيم تجريبية قبل مشاركة النتيجة.

مثال إعداد صغير

service: api
replicas: 3
features:
  cache: true
  regions:
    - eu-west
    - us-east

يجب أن يبقى عدد النسخ رقماً، والتخزين المؤقت قيمة منطقية، والمناطق مصفوفة نصوص. إذا تحول الرقم إلى نص أو المصفوفة إلى سطر واحد فهناك خطأ في المصدر أو المعالجة.

التحقق غير التحويل

قد يكون الملف صالح الصياغة لكنه يحتوي إصداراً غير مدعوم أو خاصية مجهولة. ارجع إلى مخطط التطبيق ووثائقه. تشرح مواصفة YAML 1.2.2 اللغة، بينما يعرّف RFC 8259 صيغة JSON، لكن قواعد منصة التشغيل تحتاج تحققاً منفصلاً.

الخلاصة

استعمل التحويل لنقل البيانات المنظمة بين الأنظمة، وليس كهجرة عمياء إلى الإنتاج. احتفظ بالأصل، وراجع أنواع القيم، وتحقق من مخطط التطبيق، واختبر النتيجة. هذه الخطوات تمنع أغلب أخطاء الإعداد المكلفة.