Provisioner

अवलोकन

Provisioner एक डेवलपर-केंद्रित प्रावधानिक सहायक है, जो सिंगल-बोर्ड कंप्यूटरों (SBCs), विशेष रूप से U-Boot-आधारित प्लेटफार्मों के लिए है।

यह एक स्व-निहित वातावरण प्रदान करता है:

• बोर्डों तक दूरस्थ पहुँच
• बूट-अप वर्कफ़्लो को स्वचालित करना
• कर्नेल और रूट फ़ाइलसिस्टम का प्रावधानन
• फ्लैशिंग संचालन निष्पादित करना
• लैब हार्डवेयर को सुरक्षित रूप से साझा करना

संचालन मॉडल जानबूझकर सरल है:

एक बोर्ड => एक Provisioner इंस्टेंस

Provisioner हार्डवेयर के करीब चलता है और डेवलपर्स को एक सुरक्षित, मल्टीप्लेक्स इंटरफ़ेस के माध्यम से नियंत्रित दूरस्थ पहुँच प्रदान करता है।

सिस्टम घटक

परियोजना दो मुख्य तत्वों से बनी है:

Provisioner वर्कफ़्लो को ऑर्केस्ट्रेट करता है; goinit उन्हें बोर्ड पर स्थानीय रूप से निष्पादित करता है।

आर्किटेक्चर अवलोकन

Provisioner तीन संचालन तलों को पाटता है:

1. उपयोगकर्ता पहुँच तल: SSH मॉनिटर और टनल
2. प्रावधानिक तल: TFTP और HTTP आर्टिफ़ैक्ट वितरण
3. बोर्ड नियंत्रण तल: सीरियल कंसोल और goinit API

यह बूटलोडर से लेकर रनटाइम प्रावधानिक तक निरंतर नियंत्रण की अनुमति देता है।

मुख्य उप-प्रणालियाँ

सीरियल इंजन

भौतिक कंसोल कनेक्शन का स्वामी है और प्रदान करता है:

• कंसोल मल्टीप्लेक्सिंग
• इंटरैक्टिव मॉनिटर
• स्क्रिप्ट स्वचालन
• फ़ाइल स्थानांतरण
• लॉगिंग

सीरियल अंतिम पतन नियंत्रण पथ बना रहता है।

प्रावधानिक सेवाएँ

एम्बेडेड सेवाएँ बूट आर्टिफ़ैक्ट प्रदान करती हैं:

TFTP

• कर्नेल वितरण
• एन्कोडेड फ़ाइलनामों के माध्यम से HTTP प्रॉक्सी फ़ेच

HTTP

• रूटफ़्स इमेज
• डिवाइस ट्री
• कर्नेल आर्टिफ़ैक्ट
• सामान्य बाइनरी

SSH के माध्यम से नियंत्रण तल

Provisioner एक एकीकृत SSH एंडपॉइंट प्रदान करता है, जो पहुँच और नियंत्रण तल दोनों के रूप में कार्य करता है।

सभी दूरस्थ अंतःक्रियाएँ एकल SSH कनेक्शन पर मल्टीप्लेक्स होती हैं और सार्वजनिक कुंजी प्रमाणीकरण द्वारा शासित होती हैं।

मल्टीप्लेक्स चैनलों में शामिल हैं:

• मॉनिटर शेल
• सीरियल कंसोल टनल
• नियंत्रण CLI
• फ़ाइल स्थानांतरण

पहुँच शासन:

• सार्वजनिक कुंजी पहचान
• प्रति उपयोगकर्ता टनल सक्षम/अक्षम करना
• केंद्रीकृत अनुमति प्रवर्तन

इसलिए, SSH दोनों वहन करता है:

• प्रबंधन तल ट्रैफ़िक
• सीरियल डेटा तल स्ट्रीम

आंतरिक राउटर

Provisioner के I/O मॉडल के केंद्र में राउटर है, एक प्लगेबल सॉफ़्टवेयर आर्टिफ़ैक्ट जो उत्पादकों और उपभोक्ताओं के बीच टर्मिनल स्ट्रीम का दलाली करता है।

सभी कंसोल ट्रैफ़िक इस घटक के माध्यम से बहता है, न कि सीधे उप-प्रणालियों के बीच।

उत्पादक / उपभोक्ता मॉडल

राउटर क्लाइंट कर सकते हैं:

• टर्मिनल डेटा उत्पन्न करें
• टर्मिनल डेटा उपभोग करें
• द्विदिश रूप से संचालित हों

उदाहरण:

• SSH मॉनिटर सत्र
• सीरियल टनल
• स्वचालन स्क्रिप्ट
• लॉगिंग एजेंट
• स्थानांतरण उपयोगिताएँ

मानव बनाम मशीन क्लाइंट

राउटर दो क्लाइंट प्रकारों के बीच अंतर करता है:

यह उपयोगिता बनाम नियतत्व के लिए अनुकूलित स्ट्रीम हैंडलिंग की अनुमति देता है।

रूटिंग रणनीतियाँ

यूनिकास्ट

• एकल प्राप्तकर्ता
• विशेष नियंत्रण सत्र या स्थानांतरण के लिए उपयोग किया जाता है

मल्टीकास्ट

• प्रसारण वितरण
• निगरानी, लॉगिंग, पर्यवेक्षकों के लिए उपयोग किया जाता है

कई इंजीनियर बिना हस्तक्षेप के एक ही कंसोल देख सकते हैं।

ANSI वॉचर

एक समर्पित प्लगेबल वॉचर ANSI टर्मिनल बारीकियों को कम करता है:

• नियंत्रण अनुक्रमों का अवलोकन करता है
• रेंडरिंग कलाकृतियों को सामान्य करता है
• स्वचालन टूटने को रोकता है

हार्डकोडेड तर्क के बजाय एक प्लगइन के रूप में कार्यान्वित।

मॉनिटर CLI

मॉनिटर शेल इंटरैक्टिव बोर्ड नियंत्रण प्रदान करता है।

> ?
 ? : यह टेक्स्ट
 board_stat : अंतिम goinit बोर्ड स्थिति रिपोर्ट करें; बोर्ड ने PROVISIONER_MGMT_* प्रिंट किया होना चाहिए
 echo : तर्क को प्रतिध्वनित करता है
 enuser : टनल के लिए उपयोगकर्ता सक्षम करें
 exec_assm : निर्दिष्ट assm स्क्रिप्ट लोड और निष्पादित करता है
 exec_scr : निर्दिष्ट स्क्रिप्ट लोड और निष्पादित करता है
 exec_state : निर्दिष्ट स्क्रिप्ट की स्थिति लौटाता है
 exit : इस शेल से बाहर निकलें
 filter : फ़िल्टर कमांड: अधिक जानकारी के लिए 'filter help' टाइप करें
 help : यह टेक्स्ट
 log_serial : सीरियल पर भेजे और प्राप्त किए गए सभी डेटा को ser.log फ़ाइल में कॉपी करता है। नोट: पिछला ओवरराइट करता है।
 log_serial_stop : सीरियल लॉग उपप्रणाली को रोकने की आवश्यकता है।
 send_serial : सीरियल पर फ़ाइल भेजें: send_serial <file> <plain|gzip|xmodem_unix|xmodem_uboot> [dest_path]
 send_serial_deps : plain/gzip के लिए दूरस्थ निर्भरता जाँचें: stty, dd, base64, gzip, rm (या busybox)।
 toff : PDU को SNMP का उपयोग करके बोर्ड बंद करने का आदेश
 ton : PDU को SNMP का उपयोग करके बोर्ड चालू करने का आदेश
 tterm : सीरियल टनल कनेक्शन समाप्त करें
 ulist : टनल के लिए उपयोगकर्ता स्थिति सूचीबद्ध करें
>

फ़िल्टर उपप्रणाली

filter help
उपलब्ध: enable, disable, default, show, add, remove, help

ASCII या HEX में नियम परिभाषित किए जा सकते हैं:

filter add ascii Hello Hello World
filter add hex 48656c6c6f 48656c6c6f 576f726c64

फ़िल्टर कर सकते हैं:

• प्राप्त डेटा को रोकें
• स्ट्रीम को अग्रेषित या दबाएँ
• प्रतिक्रियाएँ इंजेक्ट करें

यह बूट स्वचालन और कंसोल सामान्यीकरण के लिए उपयोगी है।

सीरियल फ़ाइल स्थानांतरण

Provisioner प्रत्यक्ष सीरियल फ़ाइल स्थानांतरण का समर्थन करता है:

send_serial <file> <mode> [dest_path]

मोड:

निर्भरताएँ इसके माध्यम से जाँची जाती हैं:

send_serial_deps

आवश्यक उपयोगिताएँ:

• stty
• dd
• base64
• gzip
• rm / busybox

send_console-ng के साथ एकीकरण

स्थानांतरण इंजन स्टैंडअलोन उपयोगिता send_console-ng से लिया गया है, जिसे Provisioner में अनुकूलित किया गया है। यह फ़ाइल स्थानांतरण को सक्षम करता है जब:

• कोई नेटवर्क मौजूद नहीं है
• केवल एक शेल प्रॉम्प्ट उपलब्ध है
• रिकवरी टूलिंग को मैन्युअल रूप से धकेलना होगा

क्षमताएँ:

• दूरस्थ टर्मिनल कॉन्फ़िगरेशन
• संपीड़न और एन्कोडिंग
• बफ़र्ड स्ट्रीमिंग
• निर्भरता जाँच

मूल उपयोगिता की तुलना में:

• stdbuf और cat निर्भरताएँ हटा दी गईं
• पोर्टेबिलिटी के लिए dd जोड़ा गया
• जहाँ रिसीवर मौजूद हैं, वहाँ XMODEM समर्थन जोड़ा गया

यह Provisioner को गंभीर रूप से क्षतिग्रस्त बोर्ड स्थितियों में भी संचालित करने की अनुमति देता है।

स्वचालन और स्क्रिप्टिंग

assm: मूल स्क्रिप्ट

असेंबली-जैसी Expect इंजन:

• प्रॉम्प्ट मिलान
• नियतिवादी प्रतिक्रियाएँ
• बाइट-उन्मुख निष्पादन

लॉगिन और बूट प्रवाह के लिए सबसे उपयुक्त।

exec_scr: बाहरी स्क्रिप्ट

सीरियल स्ट्रीम से बंधे बाहरी प्रोग्राम निष्पादित करता है।

मोड:

वैकल्पिक एकीकरण

Google Calendar (वैकल्पिक)

हल्का आरक्षण एकीकरण मौजूद है, लेकिन यह परियोजना का प्राथमिक फोकस नहीं है। केवल इसके लिए उपयोग किया जाता है:

• समय-आधारित पहुँच
• साझा लैब बुकिंग

Provisioner का उद्देश्य पूर्ण लैब शेड्यूलर बनना नहीं है।

निर्माण और पोर्टेबिलिटी

Provisioner Go में लिखा गया है और आसानी से क्रॉस-कंपाइल होता है।

मूल निर्माण

make

क्रॉस-कंपाइल उदाहरण

GOARCH=arm64 make

कोई बाहरी टूलचेन आवश्यक नहीं है।

परिनियोजन योग्य:

• सर्वर
• एज होस्ट
• रास्पबेरी पाई श्रेणी के सिस्टम
• लैब गेटवे