استخدام FQCN: namespace.collection.module
أشِر إلى المحتوى بالطريقة الحديثة
استخدام FQCN: namespace.collection.module درس مجاني في Ansible Academy على CoddyKit. هذا هو الدرس 3 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Ansible Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Ansible Academy 4 دروس في المجموع.
الأسماء المختصرة ملتبسة
يعمل استدعاء وحدة باسم copy، لكن قد توفّر مجموعتان مختلفتان وحدة باسم copy. يزيل FQCN أي التباس بشأن الوحدة المقصودة.
كتابة FQCN بالكامل
يعني FQCN اسم المجموعة المؤهل بالكامل (Fully Qualified Collection Name): العنوان الكامل للوحدة، ويُكتب على النحو namespace.collection.module.
ثلاثة أجزاء، ومسار واحد منقوط
اقرأه من اليسار إلى اليمين: namespace (المالك)، ثم المجموعة (الحزمة)، ثم الوحدة. يحدّد كل جزء بدقة ما سيتم تشغيله.
ansible.builtin.copy
# namespace.collection.moduleتوجد الوحدات الأساسية في ansible.builtin
توجد الوحدات التقليدية التي تستخدمها بالفعل في مجموعة ansible.builtin. لذلك فإن copy هي في الحقيقة ansible.builtin.copy من وراء الكواليس.
- ansible.builtin.copy:
src: app.conf
dest: /etc/app.confلماذا أصبح هو الافتراضي
بما أن الوحدات أصبحت موجودة في مجموعات عديدة، فإن FQCN هو الاسم الوحيد المضمون لإحالتك إلى الوحدة المحددة نفسها في كل مرة.
تبدو وحدات المجتمع بالطريقة نفسها
يتبع المحتوى القادم من حزم أخرى النمط نفسه، مثل community.general.ufw لوحدة جدار الحماية في تلك المجموعة.
- community.general.ufw:
rule: allow
port: "22"لا تزال الأسماء المختصرة تعمل
تبقى الأسماء العادية مثل copy صالحة للوحدات المضمنة، لكن أدوات الفحص تُصدر تحذيرات بشأنها الآن. استخدام FQCN الكامل هو الأسلوب الموصى به.
يضمن توافق ملفات التشغيل مع المستقبل
يستمر FQCN في العمل حتى إذا أعادت نسخة مستقبلية من Ansible ترتيب الوجهات التي تشير إليها الأسماء المختصرة، لذلك تظل ملفات التشغيل مستقرة عبر الترقيات.
ينطبق FQCN على الأدوار أيضًا
توفّر المجموعات أدوارًا أيضًا. ويمكنك الإشارة إليها باستخدام العنوان المنقوط نفسه، مثل community.general.role_name في ملف التشغيل.
roles:
- role: geerlingguy.nginxقلّل الكتابة باستخدام collections
أدرج مجموعة ضمن المفتاح collections في ملف التشغيل، وبعدها يمكنك استخدام أسماء الوحدات المختصرة منها من دون البادئة الكاملة.
collections:
- community.generalاجعل FQCN عادة
تجعل كتابة FQCN الكامل منذ البداية ملفات التشغيل واضحة وغير ملتبسة، وخالية من تحذيرات أدوات الفحص، وسهلة التتبع إلى مصدرها من جانب زملائك.
اختبار سريع
حدّد أجزاء اسم الوحدة المؤهل بالكامل.
خلاصة
إن FQCN هو namespace.collection.module، مثل ansible.builtin.copy. وهو يشير بوضوح إلى وحدة واحدة، ويحافظ على أمان ملفات التشغيل أثناء الترقيات. 🎯
تعلم YAML مع معلم ذكاء اصطناعي — مجانًا
اكتب وقم بتشغيل أكوادك الفعلية في المتصفح، واحصل على مساعدة فورية من معلم ذكاء اصطناعي متاح 24/7، واستمر من حيث توقفت على الويب أو في التطبيق.
- الدورات
- 30
- الدروس
- 120
الأسئلة الشائعة
هل درس «استخدام FQCN: namespace.collection.module» مجاني؟
نعم — نص درس «استخدام FQCN: namespace.collection.module» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Ansible Academy، انتقل إلى CoddyKit PRO. تتضمن دورة Ansible Academy 4 دروس في المجموع.
ماذا ستتعلم في «استخدام FQCN: namespace.collection.module»؟
أشِر إلى المحتوى بالطريقة الحديثة تتمرن على Ansible Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ Ansible Academy؟
لا تُشترط خبرة سابقة. Ansible Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 4.
كم من الوقت يستغرق درس «استخدام FQCN: namespace.collection.module»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس Ansible Academy هذا؟
نعم. كل درس في Ansible Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- Roles مقابل Collections في Galaxy
- تثبيت Roles باستخدام requirements.yml
- استخدام FQCN: namespace.collection.module
- نشر Role الخاص بك إلى Galaxy