تثبيت Roles باستخدام requirements.yml

لا يمكن توسيع نطاق تشغيل أوامر التثبيت واحدًا تلو الآخر. يسرد ملف requirements.yml كل تبعية، لذلك يُثبَّت المشروع كاملًا في خطوة واحدة.

فكّر في requirements.yml باعتباره بيان الحزم الخاص بك؛ فهو يعلن بالضبط الأدوار والمجموعات التي تحتاج إليها ملفات playbook لتعمل.

يحتوي مفتاح roles داخل الملف على قائمة. ويسمّي كل إدخال دورًا واحدًا لجلبه من Galaxy باستخدام معرّف author.name.

يسرد مفتاح collections المنفصل المجموعات باستخدام اسمها بصيغة namespace.collection، بحيث يغطي ملف واحد كلا النوعين من المحتوى.

أضف دائمًا version حتى تكون عمليات التثبيت قابلة لإعادة الإنتاج. فمن دونه قد تجلب إصدارًا أحدث يسبب أعطالًا على جهاز أحد أعضاء الفريق.

وجّه ansible-galaxy إلى الملف باستخدام -r، وسيحل كل تبعية مدرجة ويثبتها بأمر واحد.

يتولى أمر التثبيت العادي معالجة الأدوار. أما المجموعات، فاستخدم معها الأمر الفرعي collection install مع العلامة -r نفسها.

يمكن لإدخال الدور استخدام عنوان Git src بدلًا من اسم في Galaxy، مما يتيح لك تثبيت أدوار خاصة أو غير منشورة.

أضف -p لوضع الأدوار في مجلد محلي للمشروع مثل roles/ بدلًا من المسار العام، مع إبقاء كل مشروع مكتفيًا ذاتيًا.

تُحتفظ بالأدوار الموجودة افتراضيًا. مرّر --force لإعادة تنزيلها واستبدالها عند ترقية إصدار مثبت.

سجّل requirements.yml في Git، لكن تجاهل مجلدات الأدوار التي تم تنزيلها. يمكن لأي شخص إعادة بناء المجموعة نفسها تمامًا من ملف البيان.

أدرج الأدوار والمجموعات في requirements.yml، وثبّت الإصدارات، ثم ثبّتها كلها باستخدام ansible-galaxy -r. ملف واحد، وإعدادات قابلة لإعادة الإنتاج. 📦