ansible-doc से दस्तावेज़ पढ़ना

आउटपुट हर option को उसके विवरण, डिफ़ॉल्ट मान और विकल्पों के साथ सूचीबद्ध करता है। इससे आपको ठीक-ठीक पता चलता है कि मॉड्यूल किन कुंजियों को स्वीकार करता है।

मॉड्यूल के तर्कों का कॉपी करने के लिए तैयार अंश प्रिंट करने हेतु -s जोड़ें। यह नए कार्य के लिए एक आदर्श शुरुआती बिंदु है।

एक-पंक्ति सारांशों के साथ सभी इंस्टॉल किए गए मॉड्यूल की सूची बनाने के लिए -l के साथ चलाएँ। अपनी आवश्यकता की चीज़ खोजने के लिए इसे grep से फ़िल्टर करें।

नाम निश्चित नहीं है? मॉड्यूल की सूची बनाकर विषय के अनुसार फ़िल्टर करें। service खोजने पर संबंधित modules तुरंत मिल जाते हैं।

ansible-doc स्थानीय रूप से इंस्टॉल किए गए मॉड्यूल पढ़ता है, इसलिए दस्तावेज़ हमेशा आपके सटीक version से मेल खाते हैं। पुराने ऑनलाइन पृष्ठों का कोई जोखिम नहीं रहता।

दस्तावेज़ यह भी बताते हैं कि मॉड्यूल क्या returns करता है, जैसे changed या stdout। बाद में उपयोग करने के लिए परिणामों को register करने पर इससे सहायता मिलती है।

केवल मॉड्यूल ही नहीं, बल्कि अन्य प्लगइन प्रकारों के दस्तावेज़ पढ़ने के लिए -t का उपयोग करें। उदाहरण के लिए, lookup या filter प्लगइन को भी इसी तरह देखें।

दस्तावेज़ का शीर्षलेख मॉड्यूल का collection और संक्षिप्त उद्देश्य दिखाता है, इसलिए कार्य लिखने से पहले आपको उसका पूरा नाम पता रहता है।

किसी तर्क का अनुमान लगाने से पहले ansible-doc जाँच लें। दस सेकंड की खोज एक विफल रन और उलझन पैदा करने वाले त्रुटि संदेश से बचा सकती है।

ansible-doc आपके टर्मिनल में आपके संस्करण से मेल खाते दस्तावेज़ लाता है: मॉड्यूल देखें, अंश के लिए -s और सूची बनाने व खोजने के लिए -l का उपयोग करें। 📚