صيغة YAML — الصياغة والاستخدامات والأمثلة

YAML

صيغة إعداد ودودة للبشر تمثّل البنية عبر المسافة البادئة

مقدّمة

YAML (YAML Ain't Markup Language) صيغة بيانات سهلة القراءة والكتابة على البشر، تمثّل التسلسل الهرمي عبر المسافة البادئة. وهي مجموعة عليا (superset) من JSON، وتستوعب البيانات نفسها بصورة أوجز، لذا تُستخدَم على نطاق واسع في ملفات الإعداد.

وقد ترسّخت معيارًا لإعداد أدوات DevOps مثل Docker Compose وKubernetes وخطوط أنابيب CI.

خصائص الصياغة

يمثّل التسلسل الهرمي عبر المسافة البادئة (فراغات)، ولا يمكن استخدام علامة الجدولة.
تُكتَب عناصر القائمة بشرطة (-)، والتعيينات (mapping) بنقطتين رأسيتين (:).
تُكتَب التعليقات برمز #.
يمكن كتابة السلاسل النصية دون علامات اقتباس، لكنها تلزم عند وجود محارف خاصة.

المزايا

سهلة القراءة والكتابة على البشر
تدعم التعليقات
مناسبة لملفات الإعداد

العيوب

حسّاسة لأخطاء المسافة البادئة
مواصفاتها معقّدة وكثيرة الاستثناءات
كثرة الخلط بين علامة الجدولة والفراغ

الاستخدامات الرئيسية

ملفات Docker Compose وKubernetes التوصيفية (manifest)
إعداد خطوط أنابيب CI/CD
ملفات إعداد التطبيقات

مثال

- id: 1
  name: Ada
  role: admin
- id: 2
  name: Linus
  role: editor