YAML إلى JSON: تحويل التكوينات دون أن تفقد عقلك

ما الذي يفعله تحويل YAML إلى JSON بالفعل

يصف YAML وJSON نفس الأشكال - الخرائط، والقوائم، والسلاسل، والأرقام، والقيم المنطقية، والقيمة الخالية - وبالتالي فإن التحويل في الغالب يتعلق بإعادة تسلسل بناء جملة واحد مثل الآخر. ما يتغير هو السطح: تصبح المسافة البادئة أقواسًا، وتختفي التعليقات، وتصبح نقاط الارتساء نسخًا، وتنهار السلاسل متعددة الأسطر في هروب `\n`. كل واحدة من هذه التحويلات تكون فاسدة بطريقة مهمة، ولهذا السبب فإن خطوة التحويل تستحق القيام بها بشكل متعمد بدلاً من التعامل معها كفكرة لاحقة للتنسيق.

السبب العملي للتحويل هو أن JSON هو ما تريده الأداة التالية. يقبل Kubernetes YAML، لكن خطوط أنابيب `kubectl` وjq واستدعاءات API وJavaScript جميعها تتحدث لغة JSON بشكل أكثر راحة. التحويل مرة واحدة، بشكل صحيح، يتفوق على التحرير اليدوي لتنسيقين بالتوازي.

مستند متعدد YAML: مشكلة المستند الأول الصامتة

يمكن أن يحتوي الملف YAML على عدة مستندات مفصولة بـ `---`. تقوم معظم المحولات بإرجاع الأول بهدوء وتتخلص من الباقي - لذلك تصبح حزمة البيان مع النشر والخدمة وConfigMap كائنًا واحدًا بدون تحذير. يؤدي التحويل الصحيح إما إلى إصدار مجموعة من المستندات أو يسألك صراحةً عن الوثيقة التي تريدها. إذا لم يقدم المحول مثل هذا التحكم، فهو يفقد البيانات.

يجب أن تشير الأخطاء إلى السطر والعمود

إن تسامح YAML مع المسافات البيضاء هو بالضبط سبب صعوبة اكتشاف الأخطاء الصغيرة. علامات التبويب غير قانونية للمسافات البادئة، والنقطتان المفقودتان تحولان التعيين إلى سلسلة، ويتم قبول المفاتيح المكررة من قبل بعض المحللين ورفضها من قبل الآخرين. عند فشل التحويل، تقوم الرسالة المفيدة الوحيدة بتسمية السطر والعمود وإظهار المقتطف المخالف:

                spec:
  containers:
	- name: web      # tab used for indentation
error: line 3, column 0 — tabs cannot be used for indentation
              

تعتبر المفاتيح المكررة حالة خطيرة: عادةً ما يحتفظ موزعو YAML بالقيمة الأخيرة ولا يقولون شيئًا. إذا ظهرت `النسخ المتماثلة: 3` مرتين، فإن JSON الذي تحصل عليه يبدو صالحًا تمامًا - والرقم خاطئ.

نقلا عن القواعد التي تنجو من الرحلة

JSON أكثر صرامة فيما يتعلق بالسلاسل من YAML، لذلك تضيف التحويلات علامات اقتباس حول القيم التي كانت مجردة. هذا أمر طبيعي، ولكن اثنين من مراوغات YAML تسبب أخطاء حقيقية: `yes` و`no` و`on` و`off` هي قيم منطقية في YAML 1.1 ولكن السلاسل في دلالات JSON والقيم ذات الصفر البادئ مثل الرموز البريدية وأرقام الهواتف تفقد الصفر عند معاملتها كأرقام. إذا كان يجب أن يظل الحقل عبارة عن سلسلة عبر التحويل، فاقتبسه في المصدر.

قم بتشغيله محليًا، خاصة لتكوينات المجموعة

تحمل بيانات Kubernetes بشكل روتيني بيانات الاعتماد`Secret`الكائنات وسلاسل الاتصال في ConfigMaps والرموز المميزة في ملفات CI. يؤدي لصقها في خدمة ويب إلى تسليمها إلى خادم لا تتحكم فيه.يقوم المحول القائم على المتصفح بإجراء التحليل والتسلسل في نفس علامة التبويب التي تقرأها، لذلك لا يتم نقل أي شيء - والصفحة التي تستمر في العمل مع قطع الشبكة هي دليل على ذلك وليس وعدًا.

سير عمل معقول

1. تحقق من صحة YAML أولاً وقم بإصلاح أي سطر وعمود ومقتطف تم الإبلاغ عنه.
2. اختر كيفية التعامل مع ملفات المستندات المتعددة - مصفوفة، أو مستند محدد.
3. قم بالتحويل باستخدام المسافة البادئة التي تطابق نمط قاعدة التعليمات البرمجية لديك (2 أو 4 مسافات)، وقم بفرز المفاتيح إذا كنت تقوم باختلاف الإخراج.
4. احتفظ بـ YAML كمصدر للحقيقة في git وتعامل مع JSON على أنه قطعة أثرية تم إنشاؤها؛ التعليقات تعيش فقط في YAML.