पिछली एडीएसएम श्रृंखला में, हमने स्वचालन ढांचे को विकसित किया, यह पता लगाया कि वर्चुअलाइजेशन क्यों दिखाई दिया और यह कैसे काम करता है। पिछले भाग में, हमने एलएलडी (एड्रेसिंग, राउटिंग, ऑटोनॉमस सिस्टम की संख्या) पर तय किए गए नेटवर्क डिज़ाइन, उपकरणों, निर्माताओं की भूमिकाओं को चुना और उचित ठहराया।

अब हम यह सोचने के लिए तैयार हैं कि इस जानकारी के पूरे पहाड़ को कैसे स्टोर किया जाए और भविष्य में इसे आसानी से प्राप्त किया जा सके।

नहीं, निश्चित रूप से, आज ऐसी कंपनियां हैं जो एक्सेल स्प्रेडशीट में आवंटित आईपी पतों पर नज़र रखती हैं। लेकिन यह हमारा तरीका नहीं है।

यहां तक कि एक जोड़े की शाखाओं में सबसे छोटे आकार के कार्यालय के लिए, एक केंद्रीकृत आईपी-अंतरिक्ष प्रबंधन प्रणाली की उपस्थिति को चोट नहीं पहुंचेगी।

एक शब्द के बिना एक इन्वेंट्री सिस्टम की आवश्यकता स्पष्ट है।

ADSM के सभी मुद्दे:

0. ADSM। भाग शून्य। आयोजन
1. ADSM। भाग एक (जो शून्य के बाद है)। नेटवर्क वर्चुअलाइजेशन
2. एडीएसएम। भाग दो। नेटवर्क डिजाइन
3. ADSM। भाग तीन IPAM / DCIM प्रणाली

यह मुद्दा मैं नेटवर्क ऑटोमेशन में इंटीग्रल सिस्टम - एड्रेस स्पेस मैनेजमेंट सिस्टम और इन्वेंट्री सिस्टम को समर्पित करूंगा।

हम इसे चुनेंगे और इंस्टॉल करेंगे, हम आर्किटेक्चर, डेटाबेस स्कीमा, इंटरैक्शन इंटरफेस से निपटेंगे और इसे भरेंगे। और निम्नलिखित भागों में, हम सरल स्क्रिप्ट लिखना शुरू करेंगे जो दोहराए जाने वाले कार्यों को स्वचालित करते हैं, जैसे कि नए रैक जोड़ना।

इसके अलावा, मैंने पहले से ही RESTful API पर एक अलग लेख प्रकाशित किया है, जिसमें मैंने इसके सिद्धांतों और कार्यों की संक्षिप्त समीक्षा की है, हमें इसकी आवश्यकता होगी।

सामग्री

सिस्टम आर्किटेक्चर
नेटबॉक्स डेटा स्कीमा
निष्कर्ष
NetBox स्थापित करने की कुछ बारीकियों
PostgreSQL के बारे में थोड़ा
उपयोगी लिंक

आज, बाजार लगभग एक दर्जन उपकरण प्रदान करता है जो इस कार्य को कार्यान्वित करते हैं: भुगतान और ओपन सोर्स दोनों।

लेखों की इस श्रृंखला में कार्यों के लिए, मैंने निम्नलिखित कारणों से नेटबॉक्स चुना:

यह मुफ़्त है
इसमें दोनों आवश्यक भाग हैं - इन्वेंट्री और आईपी-स्पेस प्रबंधन।
इसका एक RESTful API है।
यह डिजिटल महासागर द्वारा विकसित किया गया था (और अधिक विशेष रूप से, हर किसी के लिए जेरेमी स्ट्रेच द्वारा प्रिय), अर्थात्, डेटा सेंटरों के लिए। इसलिए, आपकी ज़रूरत का लगभग सब कुछ है, और लगभग कुछ भी नहीं है।
यह सक्रिय रूप से समर्थित है (स्लैक, जीथब, Google न्यूज़लेटर्स) और अद्यतन किया जा रहा है।
यह खुला स्रोत है

ADSM की आवश्यकता के लिए, मैंने नेटबॉक्स को अपने सर्वर पर (एंटोन क्लोकोव और मिरन के लिए धन्यवाद) तैनात किया: http://netbox.linkmeup.ru:45127
इसके अलावा, मैंने भविष्य में हमारे लिए आवश्यक लगभग सभी डेटा को भर दिया।
इसलिए, आप लगभग सभी उदाहरणों को आज़मा सकते हैं और डेटा इंस्टॉलेशन को रीड मोड में पढ़ सकते हैं जब तक कि आप अपनी स्थापना को तैनात नहीं करते।

शुरू करने से पहले थोड़ा उपयोगी:

सिस्टम आर्किटेक्चर

NetBox Python3 में लिखी गई है। जो अच्छा है, क्योंकि कई अन्य समाधान php में लिखे गए हैं और यदि आवश्यक हो तो उन्हें बदलना इतना सरल नहीं है।
साइट के लिए रूपरेखा ही Django है।
PostgreSQL डेटाबेस के रूप में प्रयोग किया जाता है।
WEB-frontend (HTTP-service) - NGINX - यह Gunicron के अनुरोधों का समर्थन करता है।
डब्लूएसजीआई - गुनिकॉर्न - नेग्नेक्स और स्वयं एप्लिकेशन के बीच का इंटरफ़ेस।
एपीआई प्रलेखन रूपरेखा - स्वैगर।
NetBox - Systemd का प्रदर्शन करने के लिए।

नेटबॉक्स एक युवा और तेज़-तर्रार परियोजना है। उदाहरण के लिए, 2.7 में उन्होंने पर्यवेक्षक को छोड़ दिया और सिस्टम के पक्ष में पायथन 2.7 इसके लिए पहुंच गया। बहुत पहले नहीं, कोई कैशिंग या वेबहूक नहीं था।

इसलिए, सब कुछ जल्दी से बदल जाता है और लेख की जानकारी पढ़ने के समय तक पुरानी हो सकती है।

दूसरे शब्दों में, सभी घटक परिपक्व और परीक्षित हैं।

लेखक के अनुसार, नेटबॉक्स नेटवर्क की वास्तविक स्थिति को नहीं दर्शाता है, लेकिन लक्ष्य। इसलिए, नेटवर्क से नेटबॉक्स में कुछ भी लोड नहीं किया गया है - यह नेटवर्क नेटबॉक्स की सामग्री के अनुसार कॉन्फ़िगर किया गया है।
इस प्रकार, नेटबॉक्स सत्य के एकमात्र स्रोत के रूप में कार्य करता है (सत्य के एकल स्रोत के साथ ट्रेसिंग-पेपर)।

और नेटबॉक्स में परिवर्तन से नेटवर्क पर परिवर्तन शुरू हो जाना चाहिए।

और यह विचारधारा पर बहुत अच्छी तरह से फिट बैठता है कि मैं लेखों की इस श्रृंखला में प्रोफेसर हूं - यदि आप नेटवर्क पर परिवर्तन करना चाहते हैं - तो पहले उन्हें सिस्टम में बनाएं।

नेटबॉक्स डेटा स्कीमा

NetBox के दो मुख्य कार्य स्पेस मैनेजमेंट और इन्वेंट्री हैं।

NetBox कंपनी में एकमात्र इन्वेंट्री सिस्टम बनने की संभावना नहीं है, बल्कि, यह नेटवर्क को इन्वेंट्री करने के लिए एक विशिष्ट अतिरिक्त सिस्टम होगा, मुख्य से डेटा ले रहा है।

जाहिर है, हमारे मामले में, एडीएसएम प्रयोजनों के लिए केवल नेटबॉक्स होगा।

इस बिंदु पर, नेटबॉक्स में अधिकांश प्रारंभिक डेटा पहले से ही दर्ज किए गए हैं।
इस डेटा पर मैं एपीआई के माध्यम से काम करने के विभिन्न उदाहरण प्रदर्शित करूंगा।
आप बस चढ़ सकते हैं और देख सकते हैं: netbox.linkmeup.ru : 45127
और भविष्य में उसी डेटा की आवश्यकता होगी, जब हम स्वचालन पर आगे बढ़ते हैं।

सामान्य शब्दों में, डेटा स्कीमा को पोस्टग्रेज में डेटाबेस स्कीमा द्वारा देखा जा सकता है।

List of relations Schema | Name | Type | Owner --------+------------------------------------+-------+-------- public | auth_group | table | netbox public | auth_group_permissions | table | netbox public | auth_permission | table | netbox public | auth_user | table | netbox public | auth_user_groups | table | netbox public | auth_user_user_permissions | table | netbox public | circuits_circuit | table | netbox public | circuits_circuittermination | table | netbox public | circuits_circuittype | table | netbox public | circuits_provider | table | netbox public | dcim_cable | table | netbox public | dcim_consoleport | table | netbox public | dcim_consoleporttemplate | table | netbox public | dcim_consoleserverport | table | netbox public | dcim_consoleserverporttemplate | table | netbox public | dcim_device | table | netbox public | dcim_devicebay | table | netbox public | dcim_devicebaytemplate | table | netbox public | dcim_devicerole | table | netbox public | dcim_devicetype | table | netbox public | dcim_frontport | table | netbox public | dcim_frontporttemplate | table | netbox public | dcim_interface | table | netbox public | dcim_interface_tagged_vlans | table | netbox public | dcim_interfacetemplate | table | netbox public | dcim_inventoryitem | table | netbox public | dcim_manufacturer | table | netbox public | dcim_platform | table | netbox public | dcim_powerfeed | table | netbox public | dcim_poweroutlet | table | netbox public | dcim_poweroutlettemplate | table | netbox public | dcim_powerpanel | table | netbox public | dcim_powerport | table | netbox public | dcim_powerporttemplate | table | netbox public | dcim_rack | table | netbox public | dcim_rackgroup | table | netbox public | dcim_rackreservation | table | netbox public | dcim_rackrole | table | netbox public | dcim_rearport | table | netbox public | dcim_rearporttemplate | table | netbox public | dcim_region | table | netbox public | dcim_site | table | netbox public | dcim_virtualchassis | table | netbox public | django_admin_log | table | netbox public | django_content_type | table | netbox public | django_migrations | table | netbox public | django_session | table | netbox public | extras_configcontext | table | netbox public | extras_configcontext_platforms | table | netbox public | extras_configcontext_regions | table | netbox public | extras_configcontext_roles | table | netbox public | extras_configcontext_sites | table | netbox public | extras_configcontext_tags | table | netbox public | extras_configcontext_tenant_groups | table | netbox public | extras_configcontext_tenants | table | netbox public | extras_customfield | table | netbox public | extras_customfield_obj_type | table | netbox public | extras_customfieldchoice | table | netbox public | extras_customfieldvalue | table | netbox public | extras_customlink | table | netbox public | extras_exporttemplate | table | netbox public | extras_graph | table | netbox public | extras_imageattachment | table | netbox public | extras_objectchange | table | netbox public | extras_reportresult | table | netbox public | extras_tag | table | netbox public | extras_taggeditem | table | netbox public | extras_webhook | table | netbox public | extras_webhook_obj_type | table | netbox public | ipam_aggregate | table | netbox public | ipam_ipaddress | table | netbox public | ipam_prefix | table | netbox public | ipam_rir | table | netbox public | ipam_role | table | netbox public | ipam_service | table | netbox public | ipam_service_ipaddresses | table | netbox public | ipam_vlan | table | netbox public | ipam_vlangroup | table | netbox public | ipam_vrf | table | netbox public | secrets_secret | table | netbox public | secrets_secretrole | table | netbox public | secrets_secretrole_groups | table | netbox public | secrets_secretrole_users | table | netbox public | secrets_sessionkey | table | netbox public | secrets_userkey | table | netbox public | taggit_tag | table | netbox public | taggit_taggeditem | table | netbox public | tenancy_tenant | table | netbox public | tenancy_tenantgroup | table | netbox public | users_token | table | netbox public | virtualization_cluster | table | netbox public | virtualization_clustergroup | table | netbox public | virtualization_clustertype | table | netbox public | virtualization_virtualmachine | table | netbox

नेटबॉक्स विशेषताएं :

आईपी एड्रेस मैनेजमेंट (आईपीएएम) - आईपी उपसर्ग, पते, वीआरएफ और वीएलएएन
उपकरण रैक - साइट, समूह और भूमिका द्वारा आयोजित उपकरण रैक
उपकरण - उपकरण, उनके मॉडल, भूमिकाएं, घटक और तैनाती
कनेक्शन - उपकरणों के बीच नेटवर्क, कंसोल और पावर कनेक्शन
वर्चुअलाइजेशन - वर्चुअल मशीन और कम्प्यूटिंग क्लस्टर
डेटा सर्किट - प्रदाता कनेक्शन
गोपनीयता - एन्क्रिप्टेड उपयोगकर्ता क्रेडेंशियल संग्रहण

इस लेख में मैं निम्नलिखित बातों पर ध्यान दूंगा: DCIM - डेटा सेंटर इन्फ्रास्ट्रक्चर मैनेजमेंट, IPAM - IP एड्रेस मैनेजमेंट, वर्चुअलाइजेशन, अतिरिक्त अच्छी चीजें।

पहले चीजें पहले।

DCIM

सबसे महत्वपूर्ण हिस्सा निस्संदेह हमारे पास कौन से उपकरण हैं और यह एक दूसरे से कैसे जुड़ा है। लेकिन यह सब शुरू होता है जहां यह खड़ा है।

क्षेत्र और स्थल (क्षेत्र / साइट)

NetBox प्रतिमान में, एक डिवाइस एक साइट पर स्थापित है, एक साइट एक क्षेत्र से संबंधित है, क्षेत्रों को नेस्टेड किया जा सकता है। हालाँकि, डिवाइस को केवल क्षेत्र में स्थापित नहीं किया जा सकता है। यदि ऐसी कोई आवश्यकता है, तो एक अलग साइट स्थापित की जानी चाहिए।

हमारे मामले के लिए, यह (और होगा) इस तरह दिखेगा:

मैं आपको याद दिलाता हूं कि हमने अपना नेटवर्क कहां और कैसे बनाया: ADSM2। नेटवर्क डिजाइन

आइए देखें कि एपीआई क्या अनुमति देता है।

यहाँ सभी क्षेत्रों की एक सूची दी गई है:

 curl -X GET "http://netbox.linkmeup.ru:45127/api/dcim/regions/" -H "Accept: application/json; indent=4"

 nb.dcim.regions.all()

इसके बाद मैं परिणाम का उत्पादन किए बिना कर्ल और पायनेटबॉक्स के उदाहरण दूंगा।
URL के अंत में स्लैश को न भूलें - इसके बिना, यह काम नहीं करेगा।
मैंने Restful API के बारे में एक लेख में pynetbox का उपयोग करने के तरीके के बारे में बात की।

साइटों की सूची प्राप्त करें:

 curl -X GET "http://netbox.linkmeup.ru:45127/api/dcim/sites/" -H "Accept: application/json; indent=4"

 nb.dcim.sites.all()

किसी विशिष्ट क्षेत्र की साइटों की सूची:

 curl -X GET "http://netbox.linkmeup.ru:45127/api/dcim/sites/?region=ru" -H "Accept: application/json; indent=4"

 nb.dcim.sites.filter(region="ru")

कृपया ध्यान दें कि खोज पूर्ण नाम से नहीं, बल्कि तथाकथित स्लग द्वारा की गई है।
स्लग एक पहचानकर्ता है जिसमें केवल सुरक्षित वर्ण होते हैं: [0-9A-Za-z-_], जिसका उपयोग URL में किया जा सकता है। यह एक ऑब्जेक्ट बनाते समय सेट किया जाता है, उदाहरण के लिए, "बार्सिलोना" के बजाय "बीसीएन"।

उपकरणों

डिवाइस की स्वयं एक भूमिका है , उदाहरण के लिए, पत्ती, रीढ़, किनारा, सीमा।

यह, स्पष्ट रूप से, कुछ विक्रेता का मॉडल है ।
उदाहरण के लिए, अरिस्टा ।

इस प्रकार, पहले एक विक्रेता बनाया जाता है, फिर मॉडल के अंदर।

मॉडल को एक नाम, सेवा इंटरफेस का एक सेट, एक रिमोट कंट्रोल इंटरफ़ेस, एक कंसोल पोर्ट और पावर मॉड्यूल का एक सेट द्वारा विशेषता है।

ईथरनेट इंटरफेस के साथ स्विच, राउटर और होस्ट के अलावा, आप कंसोल सर्वर बना सकते हैं।

सभी उपकरणों की एक सूची प्राप्त करें:

 curl -X GET "http://netbox.linkmeup.ru:45127/api/dcim/devices/" -H "Accept: application/json; indent=4"

 nb.dcim.devices.all()

किसी विशेष साइट के लिए सभी उपकरण:

 curl -X GET "http://netbox.linkmeup.ru:45127/api/dcim/devices/?site=mlg" -H "Accept: application/json; indent=4"

 nb.dcim.devices.filter(site="mlg")

एक निश्चित मॉडल के सभी उपकरण

 curl -X GET "http://netbox.linkmeup.ru:45127/api/dcim/devices/?model=veos" -H "Accept: application/json; indent=4"

 nb.dcim.devices.filter(device_type_id=2)

विशिष्ट भूमिका वाले सभी उपकरण:

 curl -X GET "http://netbox.linkmeup.ru:45127/api/dcim/devices/?role=leaf" -H "Accept: application/json; indent=4"

 nb.dcim.devices.filter(role="leaf")

डिवाइस विभिन्न स्थितियों में हो सकता है: सक्रिय, ऑफ़लाइन, योजनाबद्ध, आदि।

सभी सक्रिय उपकरण:

 curl -X GET "http://netbox.linkmeup.ru:45127/api/dcim/devices/?status=active" -H "Accept: application/json; indent=4"

 nb.dcim.devices.filter(status="active")

इंटरफेस

नेटबॉक्स कई प्रकार के भौतिक इंटरफेस और एलएजी का समर्थन करता है, हालांकि, सभी आभासी जैसे कि वलन / आईआरबी और लूपबैक को एक प्रकार - वर्चुअल के तहत संयोजित किया जाता है।
प्रत्येक इंटरफ़ेस एक डिवाइस से बंधा हुआ है।

डिवाइस इंटरफेस को एक दूसरे से जोड़ा जा सकता है। यह इंटरफ़ेस में और एपीआई प्रतिक्रियाओं (विशेषता जुड़े_प्रत्येक) दोनों में प्रदर्शित किया जाएगा।

इंटरफ़ेस विभिन्न मोड में हो सकता है: टैग या एक्सेस।

तदनुसार, इसे वीएलएएन के साथ या इसके बिना टैग में लॉन्च किया जा सकता है - यह साइट या वैश्विक।

सभी डिवाइस इंटरफेस की एक सूची प्राप्त करें:

 curl -X GET "http://netbox.linkmeup.ru:45127/api/dcim/interfaces/?device=mlg-leaf-0" -H "Accept: application/json; indent=4"

 nb.dcim.interfaces.filter(device="mlg-leaf-0")

एक विशिष्ट इंटरफ़ेस के वीएलएएन की एक सूची प्राप्त करें।

 curl -X GET "http://netbox.linkmeup.ru:45127/api/dcim/interfaces/?device=mlg-leaf-0&name=Ethernet7" -H "Accept: application/json; indent=4"

 nb.dcim.interfaces.get(device="mlg-leaf-0", name="Ethernet7").untagged_vlan.vid

ध्यान दें कि यहां मैं पहले से ही फ़िल्टर के बजाय पाने की विधि का उपयोग करता हूं। फ़िल्टर एक सूची देता है, भले ही परिणाम एक ही वस्तु हो। प्राप्त करें - यदि क्वेरी परिणाम ऑब्जेक्ट की सूची है, तो एकल ऑब्जेक्ट देता है या विफल रहता है।

इसलिए, का उपयोग केवल तभी किया जाना चाहिए जब आप पूरी तरह से सुनिश्चित हों कि परिणाम एक ही प्रति में होगा।

यहां, अनुरोध के ठीक बाद, मैं ऑब्जेक्ट की विशेषताओं की ओर मुड़ता हूं। कड़ाई से बोलना, यह गलत है: यदि अनुरोध से कुछ भी नहीं मिला, तो पिनबॉक्स कोई भी नहीं लौटाएगा, और इसमें "untagged_vlan" विशेषता नहीं है।

और यह भी ध्यान दें कि हर जगह pynetbox स्लग, कहीं और नाम की उम्मीद नहीं करता है।

जानें कि किस डिवाइस से कौन सा इंटरफ़ेस एक विशेष इंटरफ़ेस से जुड़ा है:

 curl -X GET "http://netbox.linkmeup.ru:45127/api/dcim/interfaces/?device=mlg-leaf-0&name=Ethernet1" -H "Accept: application/json; indent=4"

 iface = nb.dcim.interfaces.get(device="mlg-leaf-0", name="Ethernet1") iface.connected_endpoint.device iface.connected_endpoint.name

प्रबंधन इंटरफ़ेस का नाम ज्ञात करें:

 curl -X GET "http://netbox.linkmeup.ru:45127/api/dcim/interfaces/?device=mlg-leaf-0&mgmt_only=true" -H "Accept: application/json; indent=4"

 nb.dcim.interfaces.get(device="mlg-leaf-0", mgmt_only=True)

कंसोल पोर्ट

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

पता करें कि किस पोर्ट पर कंसोल सर्वर एक विशिष्ट डिवाइस से जुड़ा है।

 curl -X GET "http://netbox.linkmeup.ru:45127/api/dcim/console-ports/?device=mlg-leaf-0" -H "Accept: application/json; indent=4"

 nb.dcim.console_ports.get(device="mlg-leaf-0").serialize()

Pynetbox में क्रमबद्ध विधि आपको एक वर्ग के उदाहरण की विशेषताओं को एक शब्दकोश में बदलने की अनुमति देती है।

IPAM

वीएलएएन और वीआरएफ

वे एक स्थान पर बंधे जा सकते हैं - वीएलएएन के लिए उपयोगी।

वीआरएफ बनाते समय, आप यह निर्दिष्ट कर सकते हैं कि पता स्थान को अन्य वीआरएफ के साथ अंतर करने की अनुमति है या नहीं।

सभी VLAN की सूची प्राप्त करें:

 curl -X GET "http://netbox.linkmeup.ru:45127/api/ipam/vlans/" -H "Accept: application/json; indent=4"

 nb.ipam.vlans.all()

सभी वीआरएफ की सूची प्राप्त करें:

 curl -X GET "http://netbox.linkmeup.ru:45127/api/ipam/vrfs/" -H "Accept: application/json; indent=4"

 nb.ipam.vrfs.all()

आईपी उपसर्ग

उनके पास एक पदानुक्रमित संरचना है। यह किसी भी वीआरएफ (यदि ऐसा नहीं है, तो ग्लोबल) से संबंधित हो सकता है।

NetBox में मुक्त उपसर्गों का एक बहुत ही सुविधाजनक दृश्य प्रतिनिधित्व है:

आप इसे ग्रीन लाइन पर क्लिक करके चुन सकते हैं।

इसे किसी स्थान से जोड़ा जा सकता है। आप आवश्यक आकार के अगले मुक्त उप-उपसर्ग या एपीआई के माध्यम से अगले मुफ्त आईपी पते का चयन कर सकते हैं।

चेक मार्क / पैरामीटर "एक पूल है" यह निर्धारित करता है कि क्या इस उपसर्ग से 0-वें पते को स्वचालित चयन के दौरान हाइलाइट किया जाएगा, या क्या यह 1 से शुरू होगा।

अंडरले रोल और 19 की लंबाई के साथ मालागा साइट के आईपी-उपसर्गों की एक सूची प्राप्त करें:

 curl -X GET "http://netbox.linkmeup.ru:45127/api/ipam/prefixes/?site=mlg&role=underlay&mask_length=19" -H "Accept: application/json; indent=4"

 prefix = nb.ipam.prefixes.get(site="mlg", role="underlay", mask_length="19")

अंडरले रोल के साथ रूस क्षेत्र में मुक्त उपसर्गों की एक सूची प्राप्त करें:

 curl -X GET "http://netbox.linkmeup.ru:45127/api/ipam/prefixes/40/available-prefixes/" -H "Accept: application/json; indent=4"

 prefix.available_prefixes.list()

निम्न मुक्त 24 उपसर्ग हाइलाइट करें:

 curl -X POST "http://netbox.linkmeup.ru:45127/api/ipam/prefixes/40/available-prefixes/" \ -H "accept: application/json" \ -H "Content-Type: application/json" \ -H "Authorization: TOKEN a9aae70d65c928a554f9a038b9d4703a1583594f" \ -d "{\"prefix_length\": 24}"

 prefix.available_prefixes.create({"prefix_length":24})

जब हमें किसी वस्तु के अंदर कुछ बच्चे का चयन करने की आवश्यकता होती है, तो POST विधि का उपयोग किया जाता है और हमें मूल वस्तु की ID निर्दिष्ट करने की आवश्यकता होती है - इस मामले में - ४० । हमें पिछले उदाहरण से कॉल करके पता चला।
पायनेटबॉक्स के मामले में, हमने पहले (पिछले उदाहरण में) परिणाम को उपसर्ग चर में सहेजा, और फिर इसकी उपलब्ध_प्रतिष्ठित विशेषता और बनाने की विधि में बदल गया।
यह उदाहरण आपके लिए काम नहीं करेगा, क्योंकि राइट राइट के साथ टोकन पहले से ही अमान्य है।

आईपी पते

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

ऐसा करने के लिए, बस हरी रेखा पर क्लिक करें।

एक विशिष्ट इंटरफ़ेस के लिए IP पतों की सूची प्राप्त करें:

 curl -X GET "http://netbox.linkmeup.ru:45127/api/ipam/ip-addresses/?interface_id=8" -H "Accept: application/json; indent=4"

 nb.ipam.ip_addresses.filter(interface_id=8)

या:

 curl -X GET "http://netbox.linkmeup.ru:45127/api/ipam/ip-addresses/?device=mlg-leaf-0&interface=Ethernet1" -H "Accept: application/json; indent=4"

 nb.ipam.ip_addresses.filter(device="mlg-leaf-0", interface="Ethernet1")

सभी डिवाइस IP पते की एक सूची प्राप्त करें:

 curl -X GET "http://netbox.linkmeup.ru:45127/api/ipam/ip-addresses/?device=mlg-leaf-0" -H "Accept: application/json; indent=4"

 nb.ipam.ip_addresses.filter(device="mlg-leaf-0")

उपलब्ध उपसर्ग आईपी पते की एक सूची प्राप्त करें:

 curl -X GET "http://netbox.linkmeup.ru:45127/api/ipam/prefixes/28/available-ips/" -H "Accept: application/json; indent=4"

 prefix = nb.ipam.prefixes.get(site="mlg", role="leaf-loopbacks") prefix.available_ips.list()

यहां फिर से, आपको उस URL में उपसर्ग की आईडी निर्दिष्ट करने की आवश्यकता है जिसमें से हम पते का चयन करते हैं - इस बार यह 28 है।

उपसर्ग में निम्नलिखित नि: शुल्क आईपी पते को हाइलाइट करें:

 curl -X POST "http://netbox.linkmeup.ru:45127/api/ipam/prefixes/28/available-ips/" \ -H "accept: application/json" \ -H "Content-Type: application/json" \ -H "Authorization: TOKEN a9aae70d65c928a554f9a038b9d4703a1583594f"

 prefix.available_ips.create()

वर्चुअलाइजेशन

हम अभी भी आधुनिक डीसी के खिताब के लिए लड़ रहे हैं। जहां बिना वर्चुअलाइजेशन के।

नेटबॉक्स नहीं दिखता है और यह एक ऐसी जगह नहीं है जहां यह आभासी मशीनों के बारे में जानकारी संग्रहीत करने के लायक है (आप इसमें भौतिक मशीनों को संग्रहीत करने की आवश्यकता के बारे में भी अनुमान लगा सकते हैं)। हालाँकि, यह हमारे लिए उपयोगी हो सकता है, उदाहरण के लिए, आप मार्ग परावर्तक, सेवा मशीनों, जैसे कि NTP, Syslog, S-Flow सर्वर और नियंत्रण मशीनों के बारे में जानकारी दर्ज कर सकते हैं।

VM के पास इंटरफेस की अपनी सूची है - वे भौतिक उपकरणों के इंटरफेस से अलग हैं और उनका अपना अलग समापन बिंदु है।

तो आप सभी आभासी मशीनों को सूचीबद्ध कर सकते हैं:

 curl -X GET "http://netbox.linkmeup.ru:45127/api/virtualization/virtual-machines/" -H "Accept: application/json; indent=4"

 nb.virtualization.virtual_machines.all()

इसलिए - सभी वीएम के सभी इंटरफेस:

 curl -X GET "http://netbox.linkmeup.ru:45127/api/virtualization/interfaces/" -H "Accept: application/json; indent=4"

 nb.virtualization.interfaces.all()

VM के लिए, आप विशिष्ट हाइपरविजर / भौतिक मशीन को निर्दिष्ट नहीं कर सकते हैं जिस पर वह चल रहा है, लेकिन आप एक क्लस्टर निर्दिष्ट कर सकते हैं। हालांकि सब कुछ इतना निराशाजनक नहीं है। पर पढ़ें।

अतिरिक्त अच्छा सामान

नेटबॉक्स की बुनियादी कार्यक्षमता कई उपयोगकर्ताओं के अधिकांश कार्यों को शामिल करती है, लेकिन सभी को नहीं। फिर भी, उत्पाद मूल रूप से किसी विशेष कंपनी की समस्याओं को हल करने के लिए लिखा गया था। हालांकि, यह सक्रिय रूप से विकसित हो रहा है और नए रिलीज काफी बार सामने आते हैं। तदनुसार, नए कार्य दिखाई देते हैं।

इसलिए, उदाहरण के लिए, कुछ साल पहले NetBox की मेरी पहली स्थापना से, इसमें टैग दिखाई दिए, कॉन्फिग कॉन्टेक्ट्स, वेबहूक, कैचिंग, सुपरवाइडर्ड बदलकर सिस्टमड, एक्सटर्नल फाइल स्टोरेज हो गए।

बाहर देखो।

कस्टम फ़ील्ड्स

कभी-कभी आप किसी भी इकाई में एक फ़ील्ड जोड़ना चाहते हैं जिसमें आप मनमाना डेटा रख सकते हैं।

उदाहरण के लिए, आपूर्ति समझौते की संख्या इंगित करें जिसके द्वारा स्विच खरीदा गया था या भौतिक मशीन का नाम जिस पर VM चल रहा है।

यह वह जगह है जहां कस्टम फ़ील्ड्स बचाव में आते हैं - बस एक ऐसा फ़ील्ड जिसमें टेक्स्ट वैल्यू होती है जिसे नेटबॉक्स में लगभग किसी भी इकाई में जोड़ा जा सकता है।

व्यवस्थापक पैनल में कस्टम फ़ील्ड बनाएँ

यह उसी तरह दिखता है जैसे डिवाइस को संपादित करते समय जिसके लिए कस्टम फ़ील्ड बनाया गया था:

मूल्य custom_field द्वारा उपकरणों की एक सूची का अनुरोध करें

 curl -X GET "http://netbox.linkmeup.ru:45127/api/dcim/devices/?cf_contract_number=0123456789" -H "Accept: application/json; indent=4"

 nb.dcim.devices.filter(cf_contract_number="0123456789")

कॉन्‍टेक्‍ट कॉन्‍टेक्‍ट

कभी-कभी आप असंरचित पाठ से अधिक कुछ चाहते हैं। फिर विन्यास संदर्भ बचाव के लिए आता है।

यह JSON प्रारूप में संरचित डेटा के एक सेट को पेश करने का एक अवसर है, जिसमें कहीं और नहीं है।

यह हो सकता है, उदाहरण के लिए, BGP समुदायों का एक समूह या Syslog सर्वरों की सूची।

कॉन्फ़िगरेशन संदर्भ स्थानीय हो सकता है - किसी विशेष ऑब्जेक्ट के लिए कॉन्फ़िगर किया गया - या वैश्विक, जब इसे एक बार कॉन्फ़िगर किया जाता है, और फिर उन सभी वस्तुओं पर लागू होता है जो कुछ शर्तों को पूरा करते हैं (उदाहरण के लिए, एक ही साइट पर स्थित है, या एक ही मंच पर चल रहे हैं)।

कॉन्फ़िगरेशन संदर्भ स्वचालित रूप से क्वेरी परिणामों में जोड़ा जाता है। इसी समय, स्थानीय और वैश्विक संदर्भ एक में विलीन हो जाते हैं।

उदाहरण के लिए, एक डिवाइस के लिए बस एक साधारण रूसी लड़की, जिसके लिए एक स्थानीय संदर्भ है, आउटपुट में कुंजी "config_context" होगी:

 curl -X GET "http://netbox.linkmeup.ru:45127/api/dcim/devices/?q=russian" -H "Accept: application/json; indent=4"

टैग के बारे में कुछ नया कहना मुश्किल है। वे हैं। वे किसी भी सुविधा को जोड़ने के लिए सुविधाजनक हैं। उदाहरण के लिए, आप उस बैच से "बायडा" स्विच टैग कर सकते हैं जिसमें मेमोरी विफल हो जाती है।

Webhooks

जब आप NetBox में परिवर्तन के बारे में जानने के लिए अन्य सेवाओं की आवश्यकता होती है, तो एक अपूरणीय वस्तु।
उदाहरण के लिए, एक नया स्विच शुरू करते समय, एक हुक स्वचालन प्रणाली को भेजा जाता है, जो डिवाइस को स्थापित करने और इसे ऑपरेशन में डालने की प्रक्रिया शुरू करता है।

निष्कर्ष

इस लेख में, मैं NetBox की सभी विशेषताओं पर विचार करने का लक्ष्य नहीं रखता, इसलिए मैं आपको बाकी सब कुछ दे दूंगा। समझो, कोशिश करो।

इसके अलावा, स्वचालन प्रणाली के निर्माण के हिस्से के रूप में, मैं केवल उन हिस्सों पर स्पर्श करूंगा जिनकी हमें वास्तव में आवश्यकता है।

तो, ऊपर, मैंने संक्षेप में बात की है कि NetBox क्या है और इसमें डेटा कैसे संग्रहीत किया जाता है।

मैं दोहराता हूं कि मैंने पहले से ही लगभग सभी आवश्यक डेटा वहां दर्ज किए हैं, और आप अपने लिए एक डेटाबेस डंप खींच सकते हैं।

स्वचालन के अगले चरण के लिए सब कुछ तैयार है: डिवाइस को इनिशियलाइज़ करने और कॉन्फ़िगरेशन को प्रबंधित करने के लिए एक सिस्टम (अहा, सिर्फ स्क्रिप्ट) लिखना।

लेकिन, लेख समाप्त करने से पहले, मैं NetBox घटकों की स्थापना और संचालन के बारे में कुछ शब्द कहूंगा।

NetBox स्थापित करने की कुछ बारीकियों

मैं स्थापना प्रक्रिया का विस्तार से वर्णन नहीं करूंगा - यह आधिकारिक दस्तावेज में वर्णित प्रसिद्ध से अधिक है।

आप नेटबॉक्स डॉकटर छवि को लॉन्च करने और जीयूआई में डीमा फिगोल ( एक बार और दो बार ) और एमिल गारिपोव के वीडियो में काम करने की प्रक्रिया को देख सकते हैं।

सामान्य तौर पर, यदि आप स्थापना का पालन करते हैं / सख्ती से कदम उठाते हैं, तो सब कुछ काम करेगा।
लेकिन यहां ऐसी बारीकियां हैं जिनके बारे में आप गलती से भूल सकते हैं।

कॉन्फ़िगरेशन फ़ाइल में, ALLOWED_HOSTS पैरामीटर भरा जाना चाहिए:
```
 ALLOWED_HOSTS = ['netbox.linkmeup.ru', 'localhost'] 
```
यहां आपको उन सभी संभावित नेटबॉक्स नामों को निर्दिष्ट करने की आवश्यकता है जिन्हें आप एक्सेस कर रहे हैं, उदाहरण के लिए, एक बाहरी आईपी पता या 127.0.0.1 या DNS-alias हो सकता है।
यदि ऐसा नहीं किया जाता है, तो नेटबॉक्स वेबसाइट नहीं खुलेगी और 400 दिखाएगी।
उसी फ़ाइल में, SECRET_KEY को निर्दिष्ट किया जाना चाहिए, जिसे आप स्वयं खोज सकते हैं या स्क्रिप्ट तैयार कर सकते हैं।
मुख्य पृष्ठ 502 खराब गेटवे दिखाएगा यदि पोस्टग्रेसीक्यूएल डेटाबेस सेट करने में कुछ गड़बड़ है: होस्ट (यदि किसी अन्य मशीन पर स्थापित है), पोर्ट, डेटाबेस का नाम, उपयोगकर्ता नाम, पासवर्ड की जांच करें।
अब कुछ समय के लिए , नेटबॉक्स डिफ़ॉल्ट रूप से प्राधिकरण के बिना किसी भी पढ़ा अधिकार प्रदान नहीं करता है।

यह सब एक ही कॉन्फ़िगरेशन में बदलता है:
```
 EXEMPT_VIEW_PERMISSIONS = ['*'] 
```
और एपीआई अनुरोध 200 वापस आएंगे और अंत में एपीआई यूआरएल में कोई स्लैश नहीं होने पर काम नहीं करेगा।
```
 curl -X GET -H "Accept: application/json; indent=4" "http://netbox.linkmeup.ru:45127/api/dcim/devices" 
```

PostgreSQL के बारे में थोड़ा

सर्वर से कनेक्ट करने के लिए:

 psql -U <i>username</i> -h <i>hostname</i> <i>db_name</i>

उदाहरण के लिए:

 psql -U netbox -h localhost netbox

सभी तालिकाओं को प्रदर्शित करने के लिए:

/dt

बाहर निकलने के लिए:

/q

डेटाबेस डंप के लिए:

 pg_dump -U <i>username</i> -h <i>hostname</i> <i>db_name</i> > netbox.sql

यदि आप हर बार पासवर्ड नहीं डालना चाहते हैं:

 echo *:*:*:<i>username</i>:<i>password</i> > ~/.pgpass chmod 600 ~/.pgpass

यदि आपकी अपनी स्थापना है और आप हाथ से सब कुछ नहीं बनाना चाहते हैं, तो आप बस वर्तमान नेटवर्क्स डेटाबेस का एक डंप ले कर ऐसा कर सकते हैं :

 psql -U <i>username</i> -h <i>hostname</i> <i>db_name</i> < netbox_initial_db.sql

यदि आपको पहले सभी तालिकाओं को छोड़ने की आवश्यकता है (और आपको ऐसा करना होगा), तो आप पहले से फाइल तैयार कर सकते हैं:

 psql -U <i>username</i> -h <i>hostname</i> <i>db_name</i> \o drop_all_tables.sql select 'drop table ' || tablename || ' cascade;' from pg_tables; \q psql -U <i>username</i> -h <i>hostname</i> <i>db_name</i> -f drop_all_tables.sql

ADSM3। IPAM / DCIM सिस्टम

सामग्री

सिस्टम आर्किटेक्चर

नेटबॉक्स डेटा स्कीमा

DCIM

क्षेत्र और स्थल (क्षेत्र / साइट)

उपकरणों

इंटरफेस

कंसोल पोर्ट

IPAM

वीएलएएन और वीआरएफ

आईपी उपसर्ग

आईपी पते

वर्चुअलाइजेशन

अतिरिक्त अच्छा सामान

कस्टम फ़ील्ड्स

कॉन्‍टेक्‍ट कॉन्‍टेक्‍ट

टैग

Webhooks

निष्कर्ष

NetBox स्थापित करने की कुछ बारीकियों

PostgreSQL के बारे में थोड़ा

उपयोगी लिंक

More articles:

ADSM3। IPAM / DCIM सिस्टम

सामग्री

सिस्टम आर्किटेक्चर

नेटबॉक्स डेटा स्कीमा

DCIM

क्षेत्र और स्थल (क्षेत्र / साइट)

उपकरणों

इंटरफेस

कंसोल पोर्ट

IPAM

वीएलएएन और वीआरएफ

आईपी ​​उपसर्ग

आईपी ​​पते

वर्चुअलाइजेशन

अतिरिक्त अच्छा सामान

कस्टम फ़ील्ड्स

कॉन्‍टेक्‍ट कॉन्‍टेक्‍ट

टैग

Webhooks

निष्कर्ष

NetBox स्थापित करने की कुछ बारीकियों

PostgreSQL के बारे में थोड़ा

उपयोगी लिंक

More articles:

आईपी उपसर्ग

आईपी पते