صياغة YAML التي تحتاج إليها في Ansible

يُكتب كل playbook في Ansible باستخدام YAML، وهو تنسيق نصي عادي صُمّم ليكون سهل القراءة والكتابة للبشر.

يبدأ ملف YAML عادةً بثلاث شرطات. تحدد --- بداية المستند، ويتوقع Ansible وجودها.

يستخدم YAML المسافات البادئة لإظهار البنية. فالمسافات تعني التداخل، ولذلك ينتمي كل ما يُزاح أسفل سطر إلى ذلك السطر.

استخدموا المسافات دائمًا للمحاذاة في YAML. فعلامة التبويب الحرفية غير صالحة، وسيرفض Ansible تحليل الملف.

جوهر YAML هو التعيين: مفتاح، ثم نقطتان، ثم مسافة، ثم القيمة. بهذه الطريقة تضبطون كل خيار.

تلك المسافة الوحيدة بعد النقطتين مطلوبة. تؤدي كتابة name:value من دون مسافة إلى إرباك المحلل، لذا احرصوا على وجودها.

تتكون القائمة من مجموعة عناصر، يُكتب كل منها في سطر مستقل يبدأ بشرطة ومسافة. وملفات playbook هي في الأساس قوائم من plays.

تجمع مهام Ansible بين الفكرتين: قائمة من التعيينات. تبدأ كل شرطة مهمة، وتصف المفاتيح ذات المسافة البادئة تفاصيلها.

لا تحتاج قيم النص العادي عادةً إلى علامات اقتباس. أضيفوا علامات الاقتباس فقط عندما تحتوي القيمة على نقطتين أو أقواس معقوفة أو تبدأ بحرف خاص.

يقرأ YAML القيم true و false والأرقام غير المحاطة بعلامات اقتباس باعتبارها قيمًا منطقية وأرقامًا، لا نصًا. لذلك فإن yes و22 قيم ذات أنواع محددة وليستا سلسلتين نصيتين.

كل ما يأتي بعد # في السطر يُعد تعليقًا. يتجاهله Ansible، لذا استخدموا التعليقات لشرح ما تنفذه كل مهمة.

تحتاجون إلى إزاحة سطر متداخل في playbook. ماذا تستخدمون؟

هذه هي الأدوات كاملةً: التعيينات والقوائم والمسافات البادئة باستخدام المسافات. أتقنوا هذه القواعد القليلة، وسيصبح كل playbook واضح القراءة. 🎉