تسمية المهام لإخراج مقروء

يمنح المفتاح name كل مهمة تسمية واضحة للبشر. ويطبعها Ansible أثناء تنفيذ المهمة، فتبدو المخرجات كأنها قصة متسلسلة. 📖

ينفّذ Ansible المهام التي بلا أسماء بشكل طبيعي، لكن السجل يعرض استدعاء module الخام بدلًا من ذلك. ويظل وجود name واضح أفضل خيار لسهولة القراءة.

ضعوا name أولًا في المهمة، ثم ضعوا module تحته. ويمكن أن يكون النص أي جملة قصيرة ووصفية.

أثناء التشغيل، يطبع Ansible ترويسة TASK التي تتضمن الاسم الذي اخترتموه، ثم يعرض ok أو changed أو failed لكل مضيف.

تصف الأسماء الجيدة النتيجة المطلوبة، مثل «التأكد من تشغيل جدار الحماية». وتجنّبوا التسميات المبهمة مثل الخطوة الأولى.

يأخذ play نفسه name أيضًا. ويظهر كعنوان PLAY، جامعًا كل المهام الموجودة تحته.

عند فشل التشغيل، يخبركم name الفاشل بالخطوة التي تعطّلت تحديدًا. ولن تضطروا بعد الآن إلى التخمين من مخرجات module الغامضة.

يمكنكم تضمين متغير في الاسم لكي تعرض المخرجات القيمة الفعلية، مثل الحزمة التي يجري تثبيتها.

يتيح لكم name المطابق استئناف playbook طويل من منتصفه باستخدام ansible-playbook مع العلم --start-at-task.

تجعل الأسماء المختلفة السجلات وعمليات البحث باستخدام start-at واضحة بلا التباس. فمن الصعب التمييز بين مهمتين تسميان نسخ ملف.

اعتبروا تسمية كل مهمة قاعدة أساسية، لا أمرًا اختياريًا لطيفًا. ستشكركم أنفسكم مستقبلًا عند قراءة المخرجات في الثانية صباحًا. 🙏

دعونا نختبر الوظيفة الفعلية للمفتاح name.

سمّوا كل مهمة وكل play. تجعل الأسماء الواضحة بصيغة الأفعال المخرجات شارحة لنفسها، وتتيح لكم استئناف عمليات التشغيل بدقة. ✅