الوحدات المخصصة
يمكنك نشر وحدتك مع وظيفتها باستخدام واجهة برمجة التطبيقات للمطورين.
التطوير
استخدم القالب https://github.com/OneEntry/module-example واتبع التعليمات في https://github.com/OneEntry/custom-module-deployment-guide أثناء التطوير.
البناء
- أنشئ رمز مشروع جديد بصلاحيات read-registry. يُوصى بإنشاء رمز دائم.
- أنشئ علامة جديدة في git (عند كل إصدار جديد من الوحدة)
- انتظر حتى تكتمل عملية pipeline، بعد ذلك سيتم تحميل صورة docker للوحدة إلى registry وستكون متاحة للنشر
النشر
انتقل إلى الإعدادات، قسم "الوحدات" وقم بالتمرير لأسفل للانتقال إلى نموذج إضافة الوحدة.
-
حدد اسم الوحدة وعلامتها
-
في حقل Url الصورة، حدد المسار إلى صورة docker التي تم بناؤها سابقًا بتنسيق
host/user/repo:version
.حيث
host
- اسم مضيف registry docker، مثلregistry.gitlab.com
،user
- معرف المستخدم أو المنظمة، مثلoneentry
،repo
- اسم المستودع، مثلmy-module
version
- اسم العلامة (إصدار الوحدة)مثال كامل:
registry.gitlab.com/oneentry-skd-js/test-module:prod-v1.0.10
-
في حقل مضيف Docker، حدد مضيف registry docker، وهو يكرر جزء host في المسار إلى صورة docker، مثل
registry.gitlab.com
-
في حقلي معرف الرمز و الرمز، حدد اسم الرمز (المحدد عند الإنشاء) والرمز نفسه (عادة ما يبدأ بـ
glpat
) على التوالي -
حدد المتغيرات البيئية (env) اللازمة لتشغيل الوحدة (يمكن تغييرها لاحقًا)
بعد إنشاء الوحدة، ستظهر في الجدول. الآن يمكنك نشرها بالضغط على (سيستغرق ذلك بعض الوقت).
حالات الحاوية
- غير منشورة - تم إنشاء الوحدة، لكنها لم تُنشر بعد
- يتم النشر - الوحدة في عملية النشر
- مُشغلة - الوحدة تعمل
- مُعلقة - الوحدة مُنشورة، لكنها غير مُشغلة
إجراءات مع الوحدة
تعليق الوحدة. يوقف العملية، لكن البيانات تبقى
استئناف عمل الوحدة. يبدأ العملية
حذف الوحدة. سيوقف العملية، ويحذف الحاوية والبيانات المرتبطة بها
تصحيح الأخطاء
إذا لم تتمكن من نشر الوحدة أو إذا كانت العملية تنتهي بشكل منهجي، سترى .
المشاكل المحتملة
- صورة docker غير مُعدة بشكل صحيح
- رمز غير صالح أو غير صحيح
- العملية تنتهي. يجب ألا تنتهي العملية الداخلية طالما أن الوحدة نشطة
تسجيل الأخطاء
يمكنك تصحيح مشاكل أخرى مع الوحدة باستخدام السجلات المعروضة في إعدادات الوحدة