प्रॉक्सोमॉक्स एपीआई परिचय

सभी को नमस्कार!
आज मैं कुख्यात वर्चुअलाइजेशन सिस्टम के एपीआई का उपयोग करने के बारे में थोड़ी बात करना चाहूंगा - प्रॉक्समॉक्स।

पृष्ठभूमि ...
मैं कुछ साल पहले एक समीप आया था, जब कुख्यात हेट्जनेर के एक डेटा सेंटर में स्थित एक अच्छी कार मेरे हाथों में गिर गई। उस समय, हमारे पास अपनी आवश्यकताओं के लिए वर्चुअलाइजेशन बढ़ाने के बारे में एक प्रश्न था। हमने कई विकल्पों पर विचार किया, जिनके नाम हैं: VMWare, OpenStack, और निश्चित रूप से Proxmox। मैं यह नहीं कहूंगा कि वह 2 अन्य उम्मीदवारों से बेहतर है, बस उसी क्षण उसने हमारी जरूरतों को पूरी तरह से संतुष्ट कर दिया। थोड़ी देर के बाद, तृतीय-पक्ष उपयोगकर्ताओं के लिए एक प्रकार का नियंत्रण कक्ष बनाने की आवश्यकता थी जो केवल अपने वर्चुअल मशीन की स्थिति की निगरानी कर सकते हैं, वीएमएस को शुरू / रोक सकते हैं, रिबूट कर सकते हैं, और कई सेटिंग्स भी प्रबंधित कर सकते हैं। बेशक, प्रॉक्समोक्स आपको उपयोगकर्ताओं, साथ ही उपयोगकर्ता समूहों को जोड़ने और उन्हें उनके अधिकार सौंपने की अनुमति देता है। लेकिन यह विकल्प हमें पसंद नहीं आया। मुझे नहीं पता कि यह अब कैसे है, लेकिन उस समय रूसी में प्रोक्समॉक्स एपीआई का कोई सामान्य दस्तावेज नहीं था। बेशक, यह मुझे रोक नहीं पाया और मैंने पूरी तरह से अंग्रेजी संस्करण का प्रबंधन किया, जिसमें वैसे सब कुछ बहुत अच्छी तरह से और स्पष्ट रूप से वर्णित है। हालांकि, हमेशा ऐसे लोग होते हैं जो अंग्रेजी के साथ बहुत अच्छी तरह से नहीं मिलते हैं। तो, यह लेख आपके लिए है।
तुरंत आरक्षण करें कि हम सभी वीएम (वर्चुअल मशीन) केवीएम पर आधारित थे। इसलिए, इस लेख में हम जिस एपीआई पर विचार करेंगे, वह पीएचपी का उपयोग करके केवीएम-आधारित मशीनों के लिए होगा।



तो चलिए शुरू करते हैं ...

उनके एपीआई के साथ काम करने के लिए, हमें एक PhP वर्ग की आवश्यकता होती है जिसे github रिपॉजिटरी से लिया जा सकता है।
एपीआई सर्वर के अनुरोधों को केवल 3 प्रकारों में विभाजित किया गया है: GET, POST और PUT। और हम JSON प्रारूप में उत्तर प्राप्त करेंगे।

हम एक index.php फ़ाइल बनाते हैं जिसमें हम एपी क्लास शामिल करते हैं जिसे हमने डाउनलोड किया है और एक ऑब्जेक्ट बनाते हैं।

require_once "proxmox.api.php"; $px = new PVE2_API("192.168.2.1", "root", "pam", "my_password"); 

जहां हम पैरामीटर के रूप में अपने सर्वर, उपयोगकर्ता नाम और पासवर्ड का आईपी दर्शाते हैं।
डिफ़ॉल्ट रूप से, पोर्ट 8006 पर प्रोक्समॉक्स स्थापित है। हालांकि, यदि आपने इसे बदल दिया है, तो आपको प्रॉक्समॉक्स एपीआई वर्ग में पोर्ट भी बदलना होगा। ऐसा करने के लिए, हमें इस तरह की लाइनें खोजने की आवश्यकता है: (उनमें से केवल 3 हैं)
curl_setopt($prox_ch, CURLOPT_URL, "https://".$this->pve_hostname.":8006/api2/json/access/ticket");

मेरे पास यह 93 लाइन है। (कक्षा को डाउनलोड करने के समय। शायद अब कुछ बदलाव हुए हैं। मैंने जांच नहीं की है) और 8006 को आवश्यक मान से बदल दें।

यह जाँचने के लिए कि हमारे सर्वर पर प्राधिकरण सफल था, आपको निम्नलिखित विधि का उपयोग करने की आवश्यकता है:

 if($px->constructor_success()){ if($px->login()){ // do something.. } } 

अब हम अपने पहले अनुरोध को पूरा करने की कोशिश करेंगे, जिससे हमें उस वीएम के बारे में जानकारी मिलेगी जिसमें हम रुचि रखते हैं। प्रत्येक वर्चुअल मशीन की अपनी विशिष्ट पहचान संख्या होती है, जिसके द्वारा हम जानकारी प्राप्त करेंगे। प्रत्येक VM अपने स्वयं के "नोड" (नोड) में भी स्थित हो सकता है, जो अनुरोध में भी भाग लेता है।

 if($px->constructor_success()){ if($px->login()){ $status = $px->get("/nodes/node2/qemu/100/status/current"); var_dump($status); } } 

कहां: नोड 2 मैं जिस नोड का उपयोग कर रहा हूं उसका नाम है, और 100 वीएम की आईडी है।

परिणामस्वरूप, हमें निम्न जैसा कुछ मिलता है:

 array(19) { ["disk"]=> int(0) ["status"]=> string(7) "running" ["ha"]=> int(0) ["freemem"]=> int(518893568) ["qmpstatus"]=> string(7) "running" ["netout"]=> int(214648283) ["maxdisk"]=> int(21474836480) ["maxmem"]=> int(3221225472) ["pid"]=> string(6) "526695" ["uptime"]=> int(2585643) ["balloon"]=> int(3221225472) ["cpu"]=> float(0.089612785396815) ["netin"]=> int(3038528849) ["diskread"]=> int(5224400988) ["template"]=> string(0) "" ["name"]=> string(15) "vds-192.168.1.9" ["diskwrite"]=> int(100378349568) ["mem"]=> int(2638614528) ["cpus"]=> int(1) } 

अधिक हद तक, यहां सब कुछ स्पष्ट है, इसलिए मैं टिप्पणी नहीं करूंगा, और हम आगे बढ़ेंगे।
पिछले उदाहरण में, जहां हमें अपने वीएम का दर्जा मिला था, हमने जीईटी अनुरोध का उपयोग किया। एक नियम के रूप में, GETs का उपयोग सूचना प्राप्त करने के लिए किया जाता है, POST और PUT कुछ क्रियाओं को करने के लिए या सेटिंग्स को बदलने के लिए।

अब हमारी वर्चुअल मशीन को रोकने की कोशिश करें। ऐसा करने के लिए, vmid (वर्चुअल मशीन पहचानकर्ता और नोड) के साथ एक POST अनुरोध भेजें:

 if($px->constructor_success()){ if($px->login()){ $px->post("/nodes/node2/qemu/192/status/shutdown", array("forceStop" => true)); } } 

जैसा कि आप देख सकते हैं, सब कुछ काफी सरल है। POST अनुरोध का पहला पैरामीटर हमारे VM के बारे में है, और दूसरा कुछ हमेशा वैकल्पिक पैरामीटर नहीं होते हैं। इस मामले में, स्पष्टता के लिए, मैंने फ़ोर्सटॉप पैरामीटर का उपयोग किया, जो स्वयं के लिए बोलता है। कभी-कभी ऐसे समय होते हैं, जब वीएम, जो भी कारण से, अपना काम "स्वेच्छा से" पूरा नहीं कर सकता है। यह विभिन्न कारणों से हो सकता है, एक सिस्टम त्रुटि, एक लटकने की प्रक्रिया, आदि। तो ForceStop पैरामीटर proxmox'u को बताता है कि मशीन को अपना काम वैसे भी पूरा करना चाहिए। प्रलेखन में मापदंडों की एक पूरी सूची मिल सकती है।

अब हमारे VM को वापस चलाएं।

 if($px->constructor_success()){ if($px->login()){ $start = $px->post("/nodes/node2/qemu/192/status/start"); } } 

VM स्टेटस के लिए सभी उपलब्ध कमांड:

• रिसेट एक तरह का रिबूट है
• फिर से शुरू - वीएम शुरू
• शटडाउन - वीएम नीचे बन्द हो जाता है
• शुरू - वीएम शुरू होता है
• रोक - VM को रोकता है
• निलंबित - वीएम को रोक देता है

आइए सेटिंग्स पर चलते हैं ...

हम हमेशा की तरह, एक विशिष्ट VM के लिए सेटिंग्स प्राप्त करते हैं:

 if($px->constructor_success()){ if($px->login()){ $start = $px->get("/nodes/node2/qemu/166/config"); var_dump($start); } } 

यदि सब कुछ ठीक है, तो हमें निम्नलिखित परिणाम प्राप्त होंगे:

 array(10) { ["net0"]=> string(36) "e1000=9A:7B:96:C7:C4:7D,bridge=vmbr0" ["ide2"]=> string(59) "local:iso/debian-6.0.7-amd64-CD-1.iso,media=cdrom,size=645M" ["name"]=> string(15) "san-192.168.1.9" ["bootdisk"]=> string(4) "ide0" ["cores"]=> int(1) ["ide0"]=> string(50) "local:166/vm-166-disk-1.qcow2,format=qcow2,size=1G" ["ostype"]=> string(3) "l26" ["memory"]=> int(512) ["sockets"]=> int(1) ["digest"]=> string(40) "2aa7fcf6cbaff2f11d2f50f1b7b18fc97d2b04d6" } 

VM कॉन्फ़िगरेशन को स्थापित करने के लिए, आपको PUT अनुरोध का उपयोग करना होगा:

 if($px->constructor_success()){ if($px->login()){ $px->put("/nodes/node2/qemu/166/config", array( )); } } 

जहां सरणी में आपको आवश्यक पैरामीटर और उनके मूल्य निर्दिष्ट करने की आवश्यकता होती है। मैं सभी मापदंडों को नहीं दूंगा, क्योंकि उनमें से बहुत सारे हैं और वे आधिकारिक दस्तावेज में वर्णित हैं। कृपया ध्यान दें कि प्रभावी होने के लिए कुछ ऐड-इन्स के लिए, रिबूट वीएम की आवश्यकता होती है।

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

 if($px->constructor_success()){ if($px->login()){ $d = array( 'vmid' => '777', 'memory' => '300', 'cores' => '2', 'autostart' => true, 'ostype' => 'l26', 'ide0' => 'local:32,format=qcow2', 'ide2' => 'local:iso/ubuntu-12.04.2-server-amd64.iso,media=cdrom', 'net0' => 'e1000,bridge=vmbr0' ); $px->post("/nodes/node2/qemu", $d); $px->post("/nodes/node2/qemu/777/status/start"); } } 

जहां:

• vmid - VM का विशिष्ट पहचानकर्ता
• मेमोरी - प्रकार संख्या (पूर्णांक) मेगाबाइट में रैम के आकार को दर्शाता है
• कोर - वीएम कोर की संख्या
• ऑटोस्टार्ट - (बूल) ऑटोस्टार्ट वीएम आरंभ करना है या नहीं
• ostype - OS प्रकार
• ide0 - एचडीडी का आकार और प्रारूप। स्थानीय: 32 - का मतलब है 32 जीबी
• ide2 - OS छवि और बूट प्रकार का पथ
• net0 - नेटवर्क एडाप्टर

अभी के लिए बस इतना ही। अगले भाग में, मैं ऊपर बताए गए तरीकों में तल्लीन करना चाहूंगा, साथ ही कुछ सूक्ष्मताओं के बारे में बात करूँगा जो मुझे उस समय एपीआई में नहीं मिली थीं।

पुनश्च केवल एक लेख के बजाय, अपना थोड़ा सा समय लें और बताएं कि इसमें क्या गलत है, आपने क्या पसंद नहीं किया है और आप इसे और देखना चाहते हैं। यह मुझे अपनी गलतियों को समझने और भविष्य में उन्हें प्रतिबद्ध नहीं करने देगा।

आपका ध्यान देने के लिए धन्यवाद।