SSD Nodes Learn Hosting plans →
الأدلة Matt Connorبقلم Matt Connor · آخر تحديث في 2026-10-21

Playbook أم Role في Ansible: متى تستخدم كلًّا منهما؟

تعرّف إلى متى يكفي Playbook مسطّح، ومتى تحتاج Role ببنيته ذات المجلدات السبعة، مع ansible-galaxy init واستدعاء الأدوار وأسبقية المتغيرات.

Verified Every command ran end-to-end on a fresh Ubuntu 24.04 server, July 30, 2026.

الـplaybook مقابل role في Ansible: ما الفرق بينهما؟

ملف Ansible playbook هو الملف الذي تشغّله باستخدام ansible-playbook. وهو يربط مجموعة من المضيفين بالمهام التي تحتاج إلى تنفيذها عليها. أما Ansible role فهو مجلد ذو بنية ثابتة يحتوي على المهام والقوالب وhandlers والمتغيرات الافتراضية، ويستدعيه playbook باسمه. صياغة المهام داخل كل منهما متطابقة، لذا لا يتعلق الأمر بما يمكنك التعبير عنه. بل يتعلق بإمكانية إعادة الاستخدام.

ابدأ بـplaybook مسطّح. يُعد ملف site.yml واحد يحتوي على قائمة tasks: الشكل المناسب لأول عملية أتمتة تنفذها، ويظل مناسباً لفترة أطول مما يتوقع معظم الأشخاص. حوّل المهام إلى role عندما تحتاج كتلة المهام نفسها إلى التنفيذ على مجموعة ثانية من المضيفين، أو عندما يتجاوز الملف نحو 100 سطر ولا تعود قادراً على العثور على مهمة بمجرد التمرير.

إذا لم تكتب واحداً بعد، ابدأ بإنشاء playbook أول مقابل VPS واحد ثم عُد عندما يبدأ حجمه بالازدياد.

عندما يكون الـplaybook المسطّح هو الخيار الصحيح

يكون الـplaybook المسطّح مناسباً عندما تُنفَّذ المهمة مرة واحدة، أو على خادم واحد، أو عندما لا يقرأه أي شخص آخر. لا يحتاج تجهيز خادم تطبيق واحد أو تثبيت التحديثات على خادم قبل نافذة صيانة إلى شجرة مجلدات. يضيف الـrole سبعة مجلدات وطبقة من الإحالة غير المباشرة. إذا كان المستدعي الوحيد هو الـplaybook الموجود بجانبه، فلن تفيدك هذه الإحالة غير المباشرة، بل ستضطرك إلى الانتقال بين الملفات في كل مرة تريد فيها قراءة ما يُنفَّذ فعلياً.

يتوقف الـplaybook المسطّح عن كونه الخيار الصحيح في لحظة محددة، ومن السهل ملاحظتها. تنسخ مجموعة من المهام إلى playbook ثانٍ. هذه النسخة هي الإشارة. منذ ذلك الحين، يجب تطبيق كل إصلاح مرتين، إلى أن يأتي يوم يُطبَّق فيه مرة واحدة فقط.

ما الذي يحتويه دليل الدور فعلياً

roles/common/
  defaults/main.yml
  vars/main.yml
  tasks/main.yml
  handlers/main.yml
  templates/99-hardening.conf.j2
  files/
  meta/main.yml
  • tasks/main.yml هو نقطة الدخول. يشغّل Ansible هذا الملف عند استدعاء الدور، وجميع الأدلة الأخرى اختيارية.
  • defaults/main.yml يحتوي على المتغيرات التي يُتوقع من المستدعي تجاوزها. وهو مصدر المتغيرات ذي الأولوية الأدنى في Ansible، لذلك تتغلب عليه تقريباً أي مصادر أخرى.
  • vars/main.yml يحتوي على المتغيرات التي لا يُتوقع من المستدعي تجاوزها. وتكون أولويته أعلى من أولوية الجرد، وهذا تصريح قوي. استخدمه نادراً.
  • handlers/main.yml يحتوي على المهام التي يفعّلها notify. يعمل المعالج في نهاية play، ومرة واحدة، بغض النظر عن عدد المهام التي أبلغته.
  • files/ يحتوي على الملفات التي تنسخها وحدة copy كما هي، بينما يحتوي templates/ على قوالب Jinja2 التي تعرضها وحدة template. داخل الدور، تشير إلى كليهما باسم الملف المجرد من دون مسار، لأن Ansible يبحث أولاً في أدلة الدور نفسه.
  • meta/main.yml يعرّف تبعيات الدور والبيانات الوصفية التي يقرأها Ansible Galaxy.

هذا التخطيط ليس تفضيلاً أسلوبياً. يبحث Ansible في هذه المسارات المحددة، لذلك لا يعثر مطلقاً على قالب تضعه في roles/common/template/ (بصيغة المفرد).

إنشاء الدور المشترك باستخدام ansible-galaxy init

mkdir -p ~/infra/roles
cd ~/infra
ansible-galaxy init --init-path roles common

يكتب ذلك الهيكل الكامل ضمن roles/common، بما في ذلك أدلة لن تستخدمها وملفات main.yml أولية لا تحتوي إلا على ---. احذف العناصر التي ستتركها فارغة. وجود vars/main.yml فارغ لا يسبب مشكلة لـAnsible، لكنه يخفي الملفات المهمة فعلياً في الدور.

املأ الآن الملفات التي تنفذ العمل. ابدأ بالقيم الافتراضية، لأنها الواجهة العامة للدور.

# roles/common/defaults/main.yml
---
common_packages:
  - ufw
  - fail2ban
  - unattended-upgrades
common_admin_group: admins
common_permit_root_login: "no"
common_password_authentication: "no"

ضع "no" و"yes" بين علامتي اقتباس. يحلل Ansible لغة YAML باستخدام PyYAML، الذي يقرأ no غير الموضوع بين علامتي اقتباس على أنه القيمة المنطقية false، ولذلك يصبح سطر الإعداد الناتج PermitRootLogin False، ويرفضه sshd. تحافظ علامات الاقتباس على القيمة كسلسلة نصية.

# roles/common/tasks/main.yml
---
- name: Install the base packages
  ansible.builtin.apt:
    name: "{{ common_packages }}"
    state: present
    update_cache: true
    cache_valid_time: 3600

- name: Create the admin group
  ansible.builtin.group:
    name: "{{ common_admin_group }}"
    state: present

- name: Install the sshd hardening drop-in
  ansible.builtin.template:
    src: 99-hardening.conf.j2
    dest: /etc/ssh/sshd_config.d/99-hardening.conf
    owner: root
    group: root
    mode: "0644"
    validate: /usr/sbin/sshd -t -f %s
  notify: Restart sshd
# roles/common/handlers/main.yml
---
- name: Restart sshd
  ansible.builtin.service:
    name: ssh
    state: restarted
# roles/common/templates/99-hardening.conf.j2
# Managed by Ansible. Local edits are overwritten on the next run.
PermitRootLogin {{ common_permit_root_login }}
PasswordAuthentication {{ common_password_authentication }}

في Debian وUbuntu، تُسمى وحدة systemd ssh، بينما تُسمى في أنظمة عائلة RHEL sshd. يفشل المعالج الذي يذكر الاسم الخطأ فقط عند حدوث تغيير فعلي في القالب، ولذلك لا تظهر المشكلة عادةً إلا بعد أسابيع.

يُعد السطر validate أهم جزء في هذه المهمة. يعرض Ansible القالب في ملف مؤقت، ويستبدل %s بمسار ذلك الملف، ثم ينفذ الأمر. لا يُستبدل الملف الهدف إلا إذا انتهى الأمر بالرمز 0. ضع توجيهاً غير صالح في القالب وشغّل المهمة مرة أخرى: تفشل المهمة مع failed to validate، ويبقى /etc/ssh/sshd_config.d/99-hardening.conf الفعلي دون تغيير، ويظل بإمكانك تسجيل الدخول إلى الخادم. انتبه إلى أن الفحص يختبر أكثر من صحة بناء الجملة. إذا تعذر على sshd -t قراءة مفاتيح المضيف، فسينتهي بالرمز sshd: no hostkeys available -- exiting.، وسيبلغ Ansible عن failed to validate نفسه. لذلك اقرأ msg الخاص بالوحدة قبل أن تلقي اللوم على القالب.

كيفية استدعاء دور من playbook

# site.yml
---
- name: Base configuration for every server
  hosts: all
  become: true
  roles:
    - common
# inventory.ini
[local]
localhost ansible_connection=local
ansible-playbook -i inventory.ini site.yml

يجب أن تنتهي الـplay بـfailed=0 في الملخص. مرّر المعلمات في موضع الاستدعاء باستخدام الصيغة الموسعة. بهذه الطريقة يخدم الدور نفسه مجموعتين من المضيفين:

  roles:
    - role: common
      common_admin_group: ops
      common_permit_root_login: prohibit-password

هناك قاعدة ترتيب تفاجئ معظم المستخدمين. يمكن أن تحتوي الـplay على pre_tasks وroles وtasks وpost_tasks، ويشغّلها Ansible بهذا الترتيب مهما كان ترتيب كتابتها في الملف. ضع tasks: فوق roles:، وستظل الأدوار تعمل أولاً. لذلك، إذا كان يجب تنفيذ شيء قبل أحد الأدوار، فضعه في pre_tasks:، وليس في بداية tasks:.

- name: Ordering demonstration
  hosts: local
  gather_facts: false
  pre_tasks:
    - name: Runs first
      ansible.builtin.debug:
        msg: pre
  roles:
    - common
  tasks:
    - name: Runs after the role
      ansible.builtin.debug:
        msg: task
  post_tasks:
    - name: Runs last
      ansible.builtin.debug:
        msg: post

لاستدعاء دور من داخل قائمة مهام بدلاً من المفتاح roles:، استخدم import_role أو include_role.

  tasks:
    - name: Static, read when the playbook is parsed
      ansible.builtin.import_role:
        name: common

    - name: Dynamic, resolved when the task runs
      ansible.builtin.include_role:
        name: postgres
      when: "'db' in group_names"

إنّ import_role ثابت. يقرأ Ansible الدور في وقت التحليل، وتصبح مهامه جزءاً من الـplay، لذلك يعرض ansible-playbook --list-tasks site.yml هذه المهام، وتطبَّق العلامة الموجودة على الاستيراد على كل مهمة داخله. أمّا include_role فهو ديناميكي. لا يقرأ Ansible شيئاً حتى تُنفَّذ المهمة، وهذا ما يتيح لك تحديد اسم الدور من متغير أو من حلقة. لكن هذه المهام لا تظهر في --list-tasks ولا في --start-at-task.

توجد هنا نقطة شائعة تسبب الأخطاء. يُقيَّم when: في مهمة include_role قبل أن يصبح defaults/main.yml الخاص بالدور المُضمَّن ضمن النطاق. إذا كتبت when: common_packages | length > 0 في عملية التضمين، يتوقف التنفيذ مع 'common_packages' is undefined، رغم أن هذا المتغير معرّف داخل الدور الذي تُضمّنه نفسه. الحل هو نقل مفتاح التفعيل خارج الدور: ضعه في group_vars/all.yml، حيث يكون متاحاً ضمن النطاق في كل المواضع، واترك القيم الافتراضية للدور للقيم التي يستخدمها الدور نفسه.

أي متغيّر تكون له الأولوية: الإعدادات الافتراضية، أم roles/<name>/defaults/main.yml، أم group_vars/، أم host_vars/؟

تُوثّق Ansible أكثر من عشرين مستوى لأولوية المتغيّرات. أربعة منها تحسم معظم الحالات العملية، وهي مرتبة هنا من الأضعف إلى الأقوى.

  • يوجد roles/<name>/defaults/main.yml بالقرب من أسفل الترتيب. تتغلب عليه تقريباً أي قيمة تضبطها في موضع آخر، ولذلك فهو المكان المناسب لإعدادات الدور القابلة للضبط.
  • يقع group_vars/ وhost_vars/ في الوسط. هنا تضع القيم الخاصة بموقعك، وهما يتغلبان بوضوح على الإعدادات الافتراضية للدور.
  • يأتي roles/<name>/vars/main.yml فوق host_vars. لا يمكن تجاوز قيمة تضعها هنا من خلال الجرد. احجزها للقيم التي يجب أن يحافظ الدور على اتساقها الداخلي، مثل اسم حزمة يجب أن يطابق اسم خدمة.
  • تتغلب معلمة الدور التي تمررها عند استدعائه على vars/main.yml، كما تتغلب -e في سطر الأوامر على كل شيء، بما في ذلك معلمات الدور.

يمكنك رؤية كيفية حسم هذه الأولويات خلال نحو دقيقة. امنح دوراً صغيراً قيمة افتراضية واحدة ومتغيّر دور واحداً، ثم اضبط الاسمين نفسيهما في host_vars.

# roles/prec/defaults/main.yml
---
prec_tunable: from-defaults
prec_internal: from-defaults
# roles/prec/vars/main.yml
---
prec_internal: from-rolevars
# host_vars/localhost.yml
---
prec_tunable: from-hostvars
prec_internal: from-hostvars
# roles/prec/tasks/main.yml
---
- name: Show which value survived
  ansible.builtin.debug:
    msg: "tunable={{ prec_tunable }} internal={{ prec_internal }}"
ansible-playbook -i inventory.ini prec.yml
ansible-playbook -i inventory.ini prec.yml -e prec_internal=from-cli

تطبع عملية التشغيل الأولى tunable=from-hostvars internal=from-rolevars. فقد تغلب الجرد على الإعداد الافتراضي للدور، لكنه خسر أمام متغيّر الدور. وتطبع عملية التشغيل الثانية internal=from-cli، لأن المتغيّرات الإضافية تقع في أعلى الترتيب، ولا يمكن لأي مستوى أدنى تجاوزها. ولهذا السبب يكون -e مناسباً لعملية تشغيل لمرة واحدة، لكنه غير مناسب في script تحتفظ به: إذ يتغلب بصمت على كل قرار ذي صلة في مستودعك.

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

إثبات أنّ الدور قابل للتكرار (Idempotent): شغّله مرتين

يُنتج تشغيل Ansible الموثوق النتيجة نفسها في المرة الثانية ويُبلغ عن عدم حدوث أي تغيير. شغّل الـplaybook مرتين واقرأ ملخص النتائج.

ansible-playbook -i inventory.ini site.yml
ansible-playbook -i inventory.ini site.yml

يجب أن يبدو الملخص الثاني هكذا:

PLAY RECAP *********************************************************************
localhost   : ok=4  changed=0  unreachable=0  failed=0  skipped=0  rescued=0  ignored=0

تعني changed=0 أنّه لم تُبلغ أي مهمة عن حدوث تغيير. بالنسبة لوحدات مثل apt وtemplate وgroup، يُعد هذا فحصاً حقيقياً للحالة الراهنة، لكن الرقم يكون دقيقاً بقدر دقة تقارير التغيير الخاصة بكل مهمة: تُحتسب المهمة التي تحتوي على changed_when: false كأنّها لم تتغير بغض النظر عما فعلته فعلياً. تعني changed=2 في التشغيل الثاني أنّ مهمتين أبلغتا عن تغيير مجدداً. قد يكون هذا عملاً متكرراً حقيقياً، أو إعادة كتابة ملف، أو إعادة تشغيل خدمة في كل مرة، أو قد يكون أمراً للقراءة فقط لا يملك وسيلة للإبلاغ عن عدم حدوث تغيير. في كلتا الحالتين، توقف الملخص عن إخبارك ما إذا كان الخادم قد انحرف عن الحالة المطلوبة. السبب المعتاد هو command أو shell، لأنّ Ansible لا يملك وسيلة لمعرفة ما فعله أمر عشوائي.

# traps.yml
---
- name: Command modules do not know what they changed
  hosts: local
  gather_facts: false
  tasks:
    - name: This appends a line on every run
      ansible.builtin.shell: "echo run >> /tmp/grow.txt"

    - name: This appends a line only once
      ansible.builtin.shell: "echo run >> /tmp/guarded.txt"
      args:
        creates: /tmp/guarded.txt

شغّل ذلك الـplaybook مرتين، ثم احسب الأسطر التي تحتوي على wc -l /tmp/grow.txt /tmp/guarded.txt. تحتوي /tmp/grow.txt على سطرين وتحتوي /tmp/guarded.txt على سطر واحد. في التشغيل الثاني، لم تُنفَّذ المهمة المحمية على الإطلاق: فهي تُبلغ عن ok مع الرسالة Did not run command since '/tmp/guarded.txt' exists، لأنّ creates توفر للوحدة منتجاً مرئياً للبحث عنه أولاً. عندما لا يترك أمر ما مثل هذا المنتج، سجّل مخرجاته وقرّر بنفسك باستخدام changed_when.

تتنبأ ansible-playbook --check --diff site.yml بالتغييرات دون إجرائها، وتطبع --diff الأسطر الدقيقة التي سيعيد القالب كتابتها. اقرأ المخرجات مع وضع تحذير واحد في الاعتبار: يتم تخطي مهمة shell أو command البسيطة في وضع الفحص (مع creates أو removes، فهي تبلغ فقط عما إذا كانت ستعمل)، بينما تعمل المهمة المحددة بـcheck_mode: false فعلياً حتى تحت --check. لذا، فإنّ الخطة التي تبدو نظيفة قد تخفي عملاً ما، والتشغيل التجريبي ليس جافاً دائماً.

يستحق عمود آخر في ذلك الملخص نفس القدر من العناية: يُحتسب المضيف الذي لم يتمكن Ansible من الاتصال به تحت unreachable بدلاً من failed، ولم تُنفَّذ أي من مهامه على الإطلاق، لذا قرّر مسبقاً ما إذا كان يجب على مضيف واحد لا يمكن الوصول إليه إيقاف التشغيل بالكامل قبل توجيه هذا الدور إلى أكثر من بضعة أجهزة.

لماذا يذكر Ansible أن الدور (role) غير موجود

يبحث Ansible عن دليل roles/ بجوار ملف الـ playbook، ثم في roles_path. يتبع البحث مسار الـ playbook، وليس مسار الـ shell الخاص بك.

[ERROR]: The role 'common' was not found in: /home/deploy/lonely/roles:/home/deploy/.ansible/roles:/usr/share/ansible/roles:/etc/ansible/roles:/home/deploy/lonely

تعني هذه الرسالة أن site.yml و roles/ قد أصبحا غير متوافقين، ويقوم البرنامج بطباعة المسارات التي حاول البحث فيها بشكل مفيد. هذه هي صياغة ansible-core 2.21؛ الإصدارات الأقدم تطبع the role 'common' was not found in بحرف صغير في البداية وبدون نقطتين، لذا ابحث عن was not found in. احتفظ بالاثنين في نفس الدليل. التشغيل من دليل أب (parent directory) أمر سليم، لأن مسار الـ playbook هو ما يهم:

ansible-playbook -i infra/inventory.ini infra/site.yml

توجد نسخة أكثر هدوءاً من نفس المشكلة. يتجاهل Ansible ملف ansible.cfg في الدليل الحالي عندما يكون هذا الدليل قابلاً للكتابة من قبل الجميع (world writable)، لأن أي مستخدم على الخادم يمكنه وضع إعدادات هناك وتغيير سلوك عملية التشغيل الخاصة بك.

[WARNING]: Ansible is being run in a world writable directory (/tmp/infra), ignoring it as an ansible.cfg source. For more information see https://docs.ansible.com/ansible/devel/reference_appendices/config.html#cfg-in-world-writable-dir

تصبح إعدادات roles_path و inventory غائبة بصمت، ويفشل البحث عن الدور لسبب لا علاقة له بالأدوار. يطبع ansible --version ملف config file الذي تم تحميله فعلياً، ويطبع ansible-config dump --only-changed كل إعداد يختلف عن الإعدادات الافتراضية المدمجة. تحقق من كليهما كلما تصرف التشغيل وكأن إعداداتك غير موجودة.

مشاركة الأدوار: requirements.yml وإصدار مثبت

يُثبَّت الدور الذي كتبه شخص آخر، ولا يُنسخ. صرّح عنه مرة واحدة:

# requirements.yml
---
roles:
  - name: postgres
    src: https://github.com/example/ansible-role-postgres
    scm: git
    version: v1.4.0
ansible-galaxy install -r requirements.yml -p galaxy_roles

اضبط version دائماً. من دونه، ستحصل على محتوى الفرع الافتراضي في يوم تنفيذ الأمر. لذلك قد يفشل نشر نجح الشهر الماضي من دون أي تغيير في مستودعك نفسه. وجّه roles_path إلى دليل التنزيل، وأبقِ هذا الدليل خارج git:

# ansible.cfg
[defaults]
inventory = inventory.ini
roles_path = ./galaxy_roles

تظل الأدوار الموجودة في roles/ بجانب ملف playbook قابلة للعثور عليها، لأن هذا المسار يُبحث فيه دائماً بالإضافة إلى roles_path. لذلك تبقى أدوارك الخاصة محفوظة في المستودع وخاضعة للمراجعة، بينما تكون أدوار الجهات الخارجية تنزيلات قابلة لإعادة الإنتاج ومثبتة على tag.

متى لا يعود الدور هو الحل

الدور هو وحدة لإعادة الاستخدام ضمن تنفيذ واحد لـAnsible. لا ينشئ خوادم أو سجلات DNS لدى مزود الخدمة، ومحاولة استخدامه لهذا الغرض هي ما يحوّل ملفات playbook إلى شيء لا يرغب أحد في صيانته. من المفيد قراءة تقسيم العمل بين Ansible وTerraform قبل أن تبدأ. لا يحل الدور أيضاً محل تصميم inventory: بعد تجاوز عدد محدود من الأجهزة، تصبح طريقة تجميع تلك الخوادم والوصول إليها أهم من طريقة توزيع المهام على الملفات.

تستحق إجراءات التقوية التي يثبّتها هذا الدور common قرارات مستقلة أيضاً. يضبط ملف drop-in أعلاه توجيهين فقط ولا يزيد عليهما، لذلك اقرأ إعدادات SSH التي تستحق التغيير فعلاً وكيفية جعل Ubuntu يطبّق تحديثات الأمان تلقائياً قبل أن تقرر ما يجب أن يندرج في الدور لكل مضيف تملكه.

FAQ

متى يجب تحويل ملف Ansible playbook إلى role؟

عندما تحتاج إلى تشغيل نفس مجموعة المهام في play ثانٍ، أو على مجموعة ثانية من المضيفين. نسخ المهام بين ملفات الـplaybook هو مؤشر على ذلك، لأنك منذ تلك اللحظة ستضطر لتطبيق أي إصلاح مرتين، وفي يوم ما ستطبقه مرة واحدة فقط. ملف playbook واحد يقل طوله عن 100 سطر تقريباً ويستهدف مجموعة واحدة فقط لا يستفيد شيئاً من تحويله إلى role، كما أن المجلدات الإضافية تجعل قراءته أصعب.

هل تعمل الـroles قبل المهام الموجودة في نفس الـplay؟

نعم. يقوم Ansible بتشغيل pre_tasks، ثم كل ما هو مدرج تحت roles:، ثم tasks:، ثم post_tasks:، وهو يتجاهل الترتيب الذي تظهر به هذه المفاتيح في ملفك. كتابة tasks: فوق roles: لا تجعل تلك المهام تعمل أولاً. إذا كان يجب أن يحدث شيء ما قبل الـrole، ضعه في pre_tasks:.

لماذا لا تتجاوز قيمة group_vars الخاصة بي الـrole؟

تحقق مما إذا كان المتغير مضبوطاً في vars/main.yml الخاص بالـrole بدلاً من defaults/main.yml. يأتي vars/ في مرتبة أعلى من group_vars وhost_vars في ترتيب أولوية Ansible، لذا لا يمكن لملف الـinventory تجاوزه. انقل المتغير إلى defaults/main.yml، الذي يقع بالقرب من أسفل الترتيب وهو المكان الصحيح لأي شيء يجب أن يكون قابلاً للتغيير من قبل المستدعي. للتأكد من أن السبب هو الأولوية وليس خطأ مطبعي، قم بالتشغيل مرة واحدة باستخدام -e name=value، الذي يتفوق على أي مصدر آخر.

لماذا يقول Ansible أن الـrole غير موجود؟

يبدأ البحث بجوار ملف الـplaybook، لذا يجب أن يتواجد site.yml وroles/ في نفس المجلد. يطبع الخطأ المسارات التي حاول البحث فيها، بدءاً من The role 'common' was not found in: /home/deploy/lonely/roles. تشغيل الـplaybook من مجلد أب لا يمثل مشكلة، لأن البحث يتبع مسار الـplaybook وليس مجلد العمل الحالي في الـshell. إذا كنت تعتمد على roles_path من ansible.cfg، تأكد من تحميل ذلك الملف باستخدام ansible --version، حيث أن مجلد العمل القابل للكتابة من قبل الجميع يجعل Ansible يتجاهله.

هل أحتاج إلى ansible-galaxy init لإنشاء role؟

لا. الـrole هو مجرد مجلدات بأسماء متوقعة، لذا فإن mkdir -p roles/common/tasks بالإضافة إلى tasks/main.yml يشكلان بالفعل role يعمل. يوفر ansible-galaxy init --init-path roles common عناء الكتابة ويمنحك الهيكل الكامل، بما في ذلك meta/main.yml ومسودة README. احذف المجلدات التي تتركها فارغة، لأن vars/main.yml الفارغ يخفي الملفات التي تقوم فعلياً بتنفيذ مهام داخل الـrole.

هل كان هذا المقال مفيدًا؟

#ansible#roles#playbook#structure#automation