يتم استخدام مديري الحزم لمختلف المنصات على نطاق واسع ، ويسمحون لك بتثبيت العديد من المكونات والمكتبات الجاهزة وتكوينها بسرعة. وتستخدم أيضًا لنشر حلولها الخاصة. من المهم أن يقوم مدير الحزم بمعالجة التبعيات ، أي إذا كان تطبيقك يستخدم نوعًا من المكتبة لإصدار معين ، فإن مدير الحزم ، عند تثبيت تطبيقك ، سيقوم أيضًا بتثبيت الإصدار الضروري من هذه المكتبة.الآن بالنسبة لـ InterSystems IRIS ، مدير الحزم ، ZPM ، متاح أيضًا.يسمح لك ZPM بالعثور على وحدة نمطية وتثبيتها وتحديثها ، ويمكن استخدامه أيضًا لنشر الوحدات النمطية. يمكن أن تكون كل وحدة تطبيق منفصل أو مكتبة أو إطار عمل أو أداة مساعدة أو مثال لاستخدام تقنيات InterSystems.مدير حزمة ZPM
يتكون ZPM من مكونين:- Client (CLI)
أداة مساعدة يتم تثبيتها في IRIS وتستخدم لإدارة الوحدات النمطية (على سبيل المثال ، للتثبيت) - التسجيل
قاعدة بيانات للوحدات والمعلومات الوصفية المستخدمة لإدارة الوحدات.
بشكل افتراضي ، يتم تكوين عميل ZPM لاستخدام السجل: pm.community.intersystems.com هو سجل مجتمع المطورين. نشر هذا السجل العديد من الأمثلة والمرافق والمكتبات.يمكنك أيضًا التقاط واستخدام السجل الخاص بك (المزيد عن ذلك لاحقًا في هذه المقالة).من أين نبدأ
1. تثبيت عميل ZPM
قم بتنزيل أحدث المثبت من هذا الرابط .قم باستيراد الفئة التي تم تنزيلها إلى أي منطقة بأي طريقة تناسبك: من خلال البوابة أو من خلال الاستوديو أو من خلال الوحدة الطرفية.USER>Do $System.OBJ.Load("/path/zpm.xml", "ck")
إذا كنت تستخدم Docker ، فيمكنك استخدام الإصدارين InterSystems IRIS Community Edition و InterSystems IRIS for Health Community Edition ، والتي تحتوي بالفعل على أحدث إصدار من ZPM ( لمزيد من التفاصيل ، راجع الوثائق ).2. بدء ZPM
بعد التثبيت ، يتوفر ZPM في أي منطقة.لاستخدام ZPM ، ما عليك سوى كتابة الأمر zpm في الوحدة الطرفية وستقوم بتشغيل واجهة سطر أوامر ZPM package manager (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
…
استخدم الأمر install لتثبيت أحدث وحدة نمطية أو تحديث. سيتم تنفيذ التثبيت في المنطقة الحالية.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 أو -verbose رؤية التفاصيل ، على سبيل المثال:zpm: MYNS>install dsw -v
تحقق من القائمة الكاملة للأوامر للوسائط والعلامات الخاصة بهم في صفحة التوثيق أو باستخدام أمر المساعدة.تحضير ونشر الحزمة الخاصة بك
من أجل نشر الحزمة الخاصة بك ، يجب عليك:- جعل التعليمات البرمجية الخاصة بك تعمل في InterSystems IRIS ؛
- تحضير ملف module.xml.
يصف ملف module.xml الحزمة الخاصة بك ، والموارد المضمنة في الحزمة ، والتبعيات والمكونات اللازمة عند تثبيت الحزمة (على سبيل المثال ، إنشاء تطبيقات الويب).إذا كنت قد استخدمت InterSystems IRIS Installation Manifest (٪ Installer) من قبل ، فستجد الكثير من الأشياء المشتركة في module.xml وفي كتلة XDATA.وصف تنسيق XML في وثائقيمكنك العثور على أمثلة من module.xml لوحدات المنشورة:github.com/isc-zpm/DeepSeeWeb/blob/master/module.xmlgithub.com/isc-zpm/Samples-BI/blob/master/ module.xml منأجل نشر الحزمة الخاصة بك إلى السجل العام pm.community.intersystems.com ، ما عليك سوى نشر التطبيق في Open Exchange وتحديد المستودع العام الخاص به.قم بتعيين التسجيل الخاص بك
يعد إنشاء السجل الخاص بك أمرًا اختياريًا ، ولكن يمكنك من خلاله التحقق من كيفية تجميع وحدتك النمطية وتثبيتها.إذا كنت تخطط لنشر تطبيقك في السجل العام pm.community.intersystems.com ، فمن المستحسن أن تتحقق أولاً من جميع الخطوات في السجل المحلي الخاص بك.لتثبيت التسجيل الخاص بك ، يمكنك استخدام أمر التثبيت.انتقل إلى منطقة التسجيل (فيما يلي سنفترض أنها تسمى REGISTRY) وتنفيذهاREGISTRY>zpm
zpm: REGISTRY>install zpm-registry
تحقق من عمل السجل الخاص بك - افتح localhost : 52773 / register / _ping page في المستعرض الخاص بك (قد تحتاج إلى تحديد منفذ مختلف ، وفقًا لإعدادات IRIS الخاص بك). عند الوصول إلى الصفحة ، ستحتاج إلى تحديد تسجيل الدخول وكلمة المرور لمستخدم IRIS (على سبيل المثال: _system / SYS).إذا رأيت {"message": "ping"} - فهذا يعني أنه تم تثبيت السجل بنجاح.الآن قم بتكوين عميل ZPM للعمل مع السجل الجديد.قم بتشغيل الأمر:zpm: MYNS>repo -r -n registry -url http://localhost:52773/registry/ -user _system -pass SYS
يقول هذا الأمر أن عميل ZPM يحتاج إلى استخدام التسجيل المتاح على عنوان URL المحدد كسجل بعيد وتمرير اسم المستخدم وكلمة المرور المحددين في الوسيطات - المستخدم والتجاوز عند الوصول ، على التوالي.نشر الوحدة
تحقق من أنك قمت بإنشاء مجلد منفصل توجد فيه module.xml وفئات الوحدة النمطية الخاصة بك (عادةً ما يتم وضع الفئات في المجلد / src). في المثال أدناه ، ستسمى هذه الوحدة النمطية demo-module (الاسم محدد في module.xml).تحقق من أنك قمت بالتبديل إلى سجل الاختبار.استخدم الأمر load لتحميل التعليمات البرمجية الخاصة بك في المنطقة الحالية: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 كل شيء عن وحدتك ويمكنه نشره.للنشر ، استخدم الأمر module-action مع وسيطة النشر: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 في تثبيت IRIS جديد أو منطقة جديدة.التبديل إلى التسجيل الافتراضي
للتبديل إلى العمل مع السجل الافتراضي (pm.community.intersystems.com) ، استخدم علامة -reset-defaults:zpm: MYNS>repo -r -n registry -reset-defaults
انشر وحدة في سجل المجتمع
يمكنك نشر وحدتك في سجل المجتمع (pm.community.intersystems.com) بحيث يمكن لجميع المطورين في InterSystems تثبيتها واستخدامها في حلولهم.للقيام بذلك ، قم بنشر الحل الخاص بك في InterSystems Open Exchange - وهو سوق للتطبيقات على InterSystems ووضح أثناء التثبيت أن الحل هو وحدة إدارة الحزم:
بالإضافة إلى ذلك ، يمكنك مشاهدة هذا الفيديو حول تثبيت الحلول في Open Exchange.احتاج مساعدتك!
ZPM مدعوم من المجتمع - يرجى الإبلاغ عن أي مشاكل أو اقتراحات للتحسين - إنشاء مشاكل في مستودع المشروع .ملاحظة حول الترخيص.عميل ZPM والسجل الموجود في pm.community.intersystems.com غير مدعومين من قبل شركة InterSystems Corporation ويتم تقديمهما كما هو الحال في ترخيص MIT.