⏮️ 🔮 🍓 ZPM - InterSystems IRIS के लिए पैकेज मैनेजर 👩🏾‍🎓 🕜 🤷🏾

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

अब InterSystems IRIS के लिए, एक पैकेज मैनेजर, ZPM भी उपलब्ध है।

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

ZPM पैकेज मैनेजर

ZPM में दो घटक होते हैं:

क्लाइंट (सीएलआई) एक
उपयोगिता जो आपके आईआरआईएस में स्थापित होती है और इसका उपयोग मॉड्यूल का प्रबंधन करने के लिए किया जाता है (उदाहरण के लिए, स्थापना के लिए)
रजिस्ट्री
मॉड्यूल और मेटा-जानकारी का एक डेटाबेस मॉड्यूल का प्रबंधन करने के लिए उपयोग किया जाता है।

डिफ़ॉल्ट रूप से, ZPM क्लाइंट रजिस्ट्री का उपयोग करने के लिए कॉन्फ़िगर किया गया है: pm.community.intersystems.com डेवलपर समुदाय की रजिस्ट्री है। इस रजिस्ट्री ने कई उदाहरण, उपयोगिताओं और पुस्तकालयों को प्रकाशित किया है।

आप अपनी स्वयं की रजिस्ट्री का उपयोग कर सकते हैं (इस आलेख में बाद में उस पर अधिक)।

कहाँ से शुरू करें

1. ZPM क्लाइंट स्थापित करें

इस लिंक से नवीनतम इंस्टॉलर डाउनलोड करें ।

आपके लिए सुविधाजनक किसी भी क्षेत्र में किसी भी क्षेत्र में डाउनलोड की गई कक्षा को आयात करें: पोर्टल के माध्यम से, स्टूडियो के माध्यम से या टर्मिनल के माध्यम से।

USER>Do $System.OBJ.Load("/path/zpm.xml", "ck")

यदि आप डॉकर का उपयोग करते हैं, तो आप स्वास्थ्य समुदाय संस्करण छवियों के लिए इंटरसिस्टम आईआरआईएस सामुदायिक संस्करण और इंटरसिस्टम आईआरआईएस का उपयोग कर सकते हैं, जिसमें पहले से ही जेडपीएम का नवीनतम संस्करण है ( अधिक जानकारी के लिए, दस्तावेज देखें )।

2. ZPM शुरू करना

स्थापना के बाद, ZPM किसी भी क्षेत्र में उपलब्ध है।
ZPM का उपयोग करने के लिए, टर्मिनल में zpm कमांड टाइप करें और आप ZPM पैकेज मैनेजर कमांड लाइन इंटरफेस (CLI) चलाएंगे।

MYNS> zpm
zpm: MYNS>

हेल्प कमांड का उपयोग करके, आप सभी उपलब्ध कमांड की सूची प्राप्त कर सकते हैं।

zpm: MYNS>help

3. मॉड्यूल को स्थापित करना

सबसे पहले, खोज कमांड का उपयोग करके, रजिस्ट्री में उपलब्ध मॉड्यूल की सूची देखें:

zpm: MYNS>search
 
registry https://pm.community.intersystems.com:
analyzethis 1.1.4
blocksexplorer 2.2.1
dsw 2.1.41
…

नवीनतम मॉड्यूल या अपडेट को स्थापित करने के लिए इंस्टॉल कमांड का उपयोग करें। वर्तमान क्षेत्र में स्थापना का प्रदर्शन किया जाएगा।

zpm: MYNS>install dsw
 
[mdx2json] 	Reload START
[mdx2json] 	Reload SUCCESS
[mdx2json] 	Module object refreshed.
[mdx2json] 	Validate START
[mdx2json] 	Validate SUCCESS
[mdx2json] 	Compile START
[mdx2json] 	Compile SUCCESS
[mdx2json] 	Activate START
[mdx2json] 	Configure START
[mdx2json] 	Configure SUCCESS
[mdx2json] 	Activate SUCCESS
[dsw] 	Reload START
[dsw] 	Reload SUCCESS
[dsw] 	Module object refreshed.
[dsw] 	Validate START
[dsw] 	Validate SUCCESS
[dsw] 	Compile START
[dsw] 	Compile SUCCESS
[dsw] 	Activate START
[dsw] 	Configure START
[dsw] 	Configure SUCCESS
[dsw] 	Activate SUCCESS

जैसा कि आप देख सकते हैं, mdx2json मॉड्यूल पहले स्थापित है, जिस पर dsw मॉड्यूल निर्भर करता है, और फिर dsw।

वह सब - मॉड्यूल स्थापित और कॉन्फ़िगर किया गया है!

कई आदेशों में विशेष झंडे होते हैं, उदाहरण के लिए, -v या -वरबॉस ध्वज आपको विवरण देखने की अनुमति देता है, उदाहरण के लिए:

zpm: MYNS>install dsw -v

दस्तावेज़ीकरण पृष्ठ पर या सहायता कमांड का उपयोग करके उनके तर्कों और झंडों के लिए आदेशों की पूरी सूची देखें ।

अपना पैकेज तैयार करना और प्रकाशित करना

आपको अपना स्वयं का पैकेज प्रकाशित करने के लिए, आपको यह करना होगा:

InterSystems IRIS में अपना कोड काम करें;
मॉड्यूल तैयार करें। xml फ़ाइल।

मॉड्यूल। Xml फ़ाइल आपके पैकेज का वर्णन करती है, पैकेज में स्थापित संसाधन, पैकेज स्थापित करते समय निर्भरता और घटक (उदाहरण के लिए, वेब एप्लिकेशन बनाना)।

यदि आपने पहले InterSystems IRIS इंस्टॉलेशन मैनिफेस्ट (% इंस्टालर) का उपयोग किया था , तो आपको मॉड्यूल.xml और XDATA ब्लॉक में बहुत कुछ मिलेगा।

प्रलेखन में xml प्रारूप का विवरण

आप प्रकाशित मॉड्यूल के लिए मॉड्यूल। Xml के उदाहरण पा सकते हैं:
github.com/isc-zpm/DeepSeeWeb/blob/master/module.xml
github.com/isc-zpm/Samples-BI/blob/master/ मॉड्यूल.एक्सएमएल

अपने पैकेज को सार्वजनिक रजिस्ट्री pm.community.intersystems.com पर प्रकाशित करने के लिए ओपन एक्सचेंज में आवेदन प्रकाशित करने और इसके सार्वजनिक भंडार को निर्दिष्ट करने के लिए पर्याप्त है।

अपनी खुद की रजिस्ट्री सेट करें

अपनी खुद की रजिस्ट्री बनाना वैकल्पिक है, लेकिन इसके साथ आप यह जांच सकते हैं कि आपका मॉड्यूल कैसे इकट्ठा और स्थापित है।

यदि आप सार्वजनिक रजिस्ट्री pm.community.intersystems.com में अपने आवेदन को प्रकाशित करने की योजना बनाते हैं, तो यह अनुशंसा की जाती है कि आप पहले अपने स्थानीय रजिस्ट्री में सभी चरणों की जाँच करें।

अपनी खुद की रजिस्ट्री स्थापित करने के लिए, आप इंस्टॉल कमांड का उपयोग कर सकते हैं।
रजिस्ट्री क्षेत्र पर जाएं (इसके बाद हम यह मान लेंगे कि इसे रजिस्ट्री कहा जाता है) और निष्पादित करें

REGISTRY>zpm
zpm: REGISTRY>install zpm-registry

जांचें कि आपकी रजिस्ट्री काम कर रही है - अपने ब्राउज़र में लोकलहोस्ट : 52773 / रजिस्ट्री / _पिंग पेज खोलें (आपको अपने आईआरआईएस की सेटिंग्स के आधार पर एक अलग पोर्ट निर्दिष्ट करने की आवश्यकता हो सकती है)। पृष्ठ तक पहुंचते समय, आपको आईआरआईएस उपयोगकर्ता के लॉगिन और पासवर्ड को निर्दिष्ट करना होगा (उदाहरण के लिए: _system / SYS)।

यदि आपने {"संदेश": "पिंग"} देखा - तो आपकी रजिस्ट्री सफलतापूर्वक स्थापित है।

अब नई रजिस्ट्री के साथ काम करने के लिए अपने ZPM क्लाइंट को कॉन्फ़िगर करें।

कमांड चलाएँ:

zpm: MYNS>repo -r -n registry -url http://localhost:52773/registry/ -user _system -pass SYS

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

मॉड्यूल प्रकाशित करें

जांचें कि आपने एक अलग फ़ोल्डर बनाया है जिसमें मॉड्यूल। Xml और आपके मॉड्यूल की कक्षाएं स्थित हैं (कक्षाएं आमतौर पर / src फ़ोल्डर में रखी जाती हैं)। नीचे दिए गए उदाहरण में, इस मॉड्यूल को डेमो-मॉड्यूल कहा जाएगा (नाम मॉड्यूल में निर्दिष्ट है। xml)।

सत्यापित करें कि आपने परीक्षण रजिस्ट्री पर स्विच कर लिया है।

वर्तमान क्षेत्र में अपना कोड लोड करने के लिए लोड कमांड का उपयोग करें:

zpm: MYNS>load /path/to/module/folder
[demo-module]  Reload START
[demo-module]  Reload SUCCESS
[demo-module]  Module object refreshed.
[demo-module]  Validate START
[demo-module]  Validate SUCCESS
[demo-module]  Compile START
[demo-module]  Compile SUCCESS
[demo-module]  Activate START
[demo-module]  Configure START
[demo-module]  Configure SUCCESS
[demo-module]  Activate SUCCESS

यह कमांड कई क्रियाएं करता है - आपके कोड को डाउनलोड और संकलित करता है और आपके मॉड्यूल को कॉन्फ़िगर करता है।

अब ZPM क्लाइंट आपके मॉड्यूल के बारे में सब कुछ जानता है और इसे प्रकाशित कर सकता है।

प्रकाशित करने के लिए, प्रकाशन तर्क के साथ मॉड्यूल-एक्शन कमांड का उपयोग करें:

zpm: MYNS>module-action demo-module publish

मॉड्यूल-एक्शन कमांड को छोड़ा जा सकता है, और छोटा लिखा जा सकता है:

zpm: MYNS>demo-module publish
[demo-module]  Reload START
[demo-module]  Reload SUCCESS
[demo-module]  Module object refreshed.
[demo-module]  Validate START
[demo-module]  Validate SUCCESS
[demo-module]  Compile START
[demo-module]  Compile SUCCESS
[demo-module]  Activate START
[demo-module]  Configure START
[demo-module]  Configure SUCCESS
[demo-module]  Activate SUCCESS
[demo-module]  Package START
Module exported to:
 	/var/folders/9f/r62h3fxj42b5fzb0hgnb28m40000gn/T/direyLtX5/demo-module-1.0.0/
 
Module package generated:
 	/var/folders/9f/r62h3fxj42b5fzb0hgnb28m40000gn/T/direyLtX5/demo-module-1.0.0.tgz
[demo-module]  Package SUCCESS
[demo-module]  Register START
[demo-module]  Register SUCCESS
[demo-module]  Publish START
[demo-module]  Publish SUCCESS

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

अब यदि आप सर्च कमांड चलाते हैं तो आपको सूची में अपना मॉड्यूल देखना चाहिए:

zpm: MYNS>search                          
 
registry http://localhost:52773/registry/:
demo-module 1.0.0

यह प्रमाणित करने के लिए कि इंस्टॉलेशन सफल है, अपने मॉड्यूल को परीक्षण रजिस्ट्री से एक नए आईआरआईएस इंस्टॉलेशन या एक नए क्षेत्र में ZPM का उपयोग करके स्थापित करें।

डिफ़ॉल्ट रजिस्ट्री पर स्विच करें

डिफ़ॉल्ट रजिस्ट्री के साथ काम करने के लिए स्विच करने के लिए (pm.community.intersystems.com) -reset-defaults फ्लैग का उपयोग करें:

zpm: MYNS>repo -r -n registry -reset-defaults

सामुदायिक रजिस्ट्री के लिए एक मॉड्यूल पोस्ट करें

आप अपने मॉड्यूल को सामुदायिक रजिस्ट्री (pm.community.intersystems.com) में प्रकाशित कर सकते हैं ताकि इंटरसिस्टम के सभी डेवलपर्स इसे अपने समाधान में स्थापित और उपयोग कर सकें।
ऐसा करने के लिए, में अपने समाधान प्रकाशित InterSystems ओपन एक्सचेंज - InterSystems पर अनुप्रयोगों के लिए एक बाजार और स्थापना कि समाधान एक पैकेज प्रबंधक मॉड्यूल है के दौरान संकेत मिलता है: में

इसके अलावा, आप कर सकते हैं इस वीडियो को देखने ओपन एक्सचेंज में समाधान स्थापित करने के बारे।

आपकी मदद की जरूरत है!

ZPM समुदाय समर्थित है - कृपया सुधार के लिए किसी भी मुद्दे या सुझाव की रिपोर्ट करें - परियोजना रिपॉजिटरी में मुद्दे बनाएं ।

लाइसेंस पर एक नोट।

ZPM ग्राहक और रजिस्ट्री pm.community.intersystems.com पर स्थित है, जो InterSystems Corporation द्वारा समर्थित नहीं है और इसे MIT लाइसेंस के तहत प्रस्तुत किया गया है।

ZPM - InterSystems IRIS के लिए पैकेज मैनेजर