AnsibleModule और Argument Spec

str, int, bool, list या dict जैसा type सेट कीजिए। आपका कोड चलने से पहले ही Ansible गलत इनपुट को सही प्रकार में बदल देता है या अस्वीकार कर देता है।

required=True जोड़िए और यदि उपयोगकर्ता वह आर्ग्युमेंट भूल जाता है, तो Ansible स्पष्ट त्रुटि के साथ विफल हो जाएगा। अलग से जाँच करने की आवश्यकता नहीं है।

default का उपयोग कीजिए, ताकि वैकल्पिक आर्ग्युमेंट को अपने-आप कोई मान मिल जाए। उपयोगकर्ता केवल वही सेट करते हैं जिसे वे बदलना चाहते हैं।

choices सूची किसी आर्ग्युमेंट को अनुमत मानों तक सीमित करती है। अन्य सभी मान शुरुआत में ही उपयोगी संदेश के साथ अस्वीकार कर दिए जाते हैं।

ऑब्जेक्ट बनाने के लिए अपना विनिर्देश AnsibleModule में पास कीजिए। इसके बाद आपका सारा इनपुट module.params में सुरक्षित रूप से रहता है।

अपने आर्ग्युमेंट module.params नाम की साधारण डिक्शनरी से प्राप्त कीजिए। मान पहले ही सही प्रकार में बदले और मान्य किए जा चुके हैं, इसलिए उनका सीधे उपयोग कीजिए।

क्या दो आर्ग्युमेंट हमेशा साथ चाहिए, या दोनों कभी साथ नहीं होने चाहिए? required_together या mutually_exclusive जैसे नियम AnsibleModule को पास कीजिए और वह उन्हें लागू कर देगा।

संवेदनशील इनपुट को no_log=True से चिह्नित कीजिए, ताकि पासवर्ड Ansible लॉग या विस्तृत आउटपुट में कभी दिखाई न दें।

एक अच्छा argument_spec हाथ से किए जाने वाले ढेरों सत्यापन की जगह ले लेता है। इनपुट का वर्णन एक बार कीजिए और Ansible प्रकारों, त्रुटियों और दस्तावेज़ों को बिना किसी अतिरिक्त प्रयास के संभाल लेता है।

argument_spec में प्रकारों, डिफ़ॉल्ट मानों, required और choices के साथ इनपुट परिभाषित कीजिए, AnsibleModule बनाइए, फिर module.params से साफ़ मान पढ़िए। ✅