ورقة مساعدة لهيكلية وتصميم أدوار Ansible

توفر أدوار Ansible طريقة قياسية لتجميع مهام الأتمتة والمعالجات والمتغيرات والقوالب وإعادة استخدامها بنظافة وسهولة.

🔗 Related: ورقة مساعدة Ansible الأساسية · دليل البدء السريع في Ansible · أمثلة كتب تشغيل Ansible

تخطيط دليل الدور القياسي

قم بإنشاء هيكل دور جديد باستخدام ansible-galaxy init role_name:

roles/
  common/
    tasks/
      main.yml          # نقطة الدخول الأساسية للمهام المنفذة بواسطة الدور
    handlers/
      main.yml          # المعالجات المشغلة عبر notify
    templates/          # قوالب Jinja2 المشار إليها بواسطة وحدة template
    files/              # الملفات الثابتة والبرامج النصية المنقولة عبر copy
    vars/
      main.yml          # متغيرات ذات أولوية عالية خاصة بهذا الدور
    defaults/
      main.yml          # المتغيرات الافتراضية ذات الأولوية المنخفضة القابلة للتجاوز
    meta/
      main.yml          # تبعيات الدور وبيانات المؤلف الوصفية

---

استخدام الأدوار في كتب التشغيل

---
- name: Apply common and webserver roles
  hosts: webservers
  become: true
  roles:
    - role: common
    - role: nginx
      vars:
        nginx_port: 8080

---

أسبقية المتغيرات في الأدوار

تتمتع المتغيرات المحددة في defaults/main.yml بأقل أسبقية في Ansible، مما يجعلها إعدادات افتراضية آمنة يمكن للمستخدمين تجاوزها بسهولة عبر الجرد أو vars.

تتمتع المتغيرات في vars/main.yml بأسبقية عالية وهي مخصصة للمنطق الداخلي الثابت للدور.

---

المراجع

• الوثائق الرسمية لأدوار Ansible
• مستودع مجتمع Ansible Galaxy