إنشاء هيكل Role باستخدام ansible-galaxy init

يمكنك إنشاء كل مجلدات الدور يدويًا، لكن Ansible يوفر لك أمرًا ينشئ الهيكل كاملًا في خطوة واحدة.

ينشئ الأمر ansible-galaxy init هيكلًا كاملًا وجاهزًا لملء الدور، مع جميع المجلدات القياسية.

تصبح الوسيطة التي تمررها اسم المجلد الخاص بالدور. اختر اسمًا وصفيًا مثل webserver أو postgres حتى يكون الغرض منه واضحًا.

ينشئ الأمر مجلدات tasks وhandlers وtemplates وfiles وvars وdefaults وmeta وtests، ويضع في كل منها ملف main.yml ابتدائيًا جاهزًا للتحرير.

شغّل الأمر من مجلد roles في مشروعك حتى يوضع الدور الجديد في المكان الذي تتوقع ملفات playbook العثور عليه.

يأتي كل ملف main.yml مُنشأً شبه فارغ، ولا يحتوي إلا على ترويسة تعليق. وعليك ملؤه بالمهام والمتغيّرات الفعلية بنفسك.

يحتوي القالب meta/main.yml على مواضع مخصصة للمؤلف والترخيص والمنصات. حدّث هذه البيانات قبل مشاركة الدور.

ينشئ الهيكل أيضًا قالب README.md، ليشجّعك على توثيق ما يفعله الدور والمتغيّرات التي يقبلها.

مرّر --init-path لإنشاء الدور في مكان آخر غير المجلد الحالي، وهو أمر مفيد عندما توجد أدوارك في مجلد مخصص.

بما أن الجميع ينشئون الهياكل باستخدام الأمر نفسه، فإن كل دور في مشروعك يشترك في تخطيط متطابق ويمكن التنبؤ به.

بعد أن يصبح الهيكل جاهزًا، تتمثل خطوتك التالية في تحرير tasks/main.yml لتحديد ما يثبّته الدور أو يضبطه فعليًا.

شغّل ansible-galaxy init لإنشاء هيكل دور كامل فورًا، ثم املأ الملفات الأولية بمهامك ومتغيّراتك الفعلية. 🛠️