defaults مقابل vars: ترتيب التجاوز

يمكن للدور تعريف المتغيرات في موضعين: defaults/main.yml وvars/main.yml. ويبدوان متشابهين، لكن سلوكهما مختلف جدًا.

تأتي القيم في defaults/main.yml في أدنى مستويات الأولوية. وهي اقتراحات مرنة يمكن لأي شيء آخر تقريبًا تجاوزها.

تتمتع القيم في vars/main.yml بأولوية عالية. وهي قرارات ثابتة يصرّ عليها الدور، ومن الصعب تجاوزها.

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

احجز vars للقيم التي يحتاجها الدور ليعمل ولا ينبغي للمستخدم تعديلها، مثل مسار داخلي أو اسم حزمة ثابت.

يمكن للمستخدم تجاوز القيمة الافتراضية من group_vars أو host_vars أو التنفيذ أو سطر الأوامر. وسيُطبَّق أبسط تجاوز فورًا.

تتغلب vars الخاصة بالدور على group_vars وhost_vars ومتغيرات التنفيذ. ولا تتفوق عليها إلا extra-vars في سطر الأوامر، لذا استخدم vars باعتدال.

تتجاوز المتغيرات الممررة باستخدام -e في سطر الأوامر كل مصدر آخر، بما في ذلك vars الخاصة بالدور. وهي التجاوز النهائي.

تذكّر السُلّم: تأتي defaults في الأسفل، ثم متغيرات inventory وplay، ثم vars الخاصة بالدور قرب الأعلى، ثم extra-vars فوق الجميع.

فضّل استخدام defaults لمعظم القيم. ولا تستخدم vars إلا عندما يجب أن تظل قيمة ما مقفلة فعلًا. فالأدوار المرنة تُرضي الفرق.

أضف تعليقًا إلى كل قيمة في defaults/main.yml. وبما أن المستخدمين سيضبطون هذه القيم، تحول الملاحظات الواضحة دورك إلى أتمتة تشرح نفسها.

فكّر في الملف الذي يمكن للمستخدم تجاوز قيمه بسهولة أكبر.

استخدم defaults للقيم القابلة للضبط التي يتجاوزها المستخدمون، واستخدم vars للثوابت الداخلية المقفلة. وتتغلب extra-vars في CLI على كل شيء. 🎚️