انتقل إلى المحتوى الرئيسي

الوحدات المخصصة

يمكنك نشر وحدتك مع الوظائف الخاصة بك باستخدام واجهة برمجة التطبيقات للمطورين.

التطوير

استخدم القالب الموجود على https://github.com/OneEntry/module-example واتبع التعليمات الموجودة على https://github.com/OneEntry/custom-module-deployment-guide أثناء التطوير.

البناء

  • أنشئ رمز مشروع جديد مع أذونات read-registry. يُوصى بإنشاء رمز دائم.
  • أنشئ علامة جديدة في git (مع كل إصدار جديد من نسخة الوحدة).
  • انتظر حتى تكتمل عملية النشر، بعد ذلك سيتم تحميل صورة docker للوحدة إلى السجل وستكون متاحة للنشر.

النشر

اذهب إلى الإعدادات، قسم "الوحدات"، وقم بالتمرير لأسفل للوصول إلى نموذج إضافة الوحدة.

  • حدد اسم الوحدة وعلامتها.

  • في حقل رابط الصورة، قدم المسار إلى صورة docker التي تم بناؤها سابقًا بالتنسيق host/user/repo:version.

    حيث host هو اسم مضيف سجل docker، على سبيل المثال، registry.gitlab.com،

    user هو معرف المستخدم أو المنظمة، على سبيل المثال، oneentry،

    repo هو اسم المستودع، على سبيل المثال، my-module،

    version هو اسم العلامة (نسخة الوحدة).

    مثال كامل: registry.gitlab.com/oneentry-skd-js/test-module:prod-v1.0.10

  • في حقل مضيف Docker، حدد مضيف سجل docker، الذي يكرر الجزء host في مسار صورة docker، على سبيل المثال، registry.gitlab.com.

  • في حقلي معرف الرمز و الرمز، قدم اسم الرمز (كما هو محدد أثناء الإنشاء) والرمز نفسه (عادةً ما يبدأ بـ glpat)، على التوالي.

  • حدد المتغيرات البيئية اللازمة (env) المطلوبة لعمل الوحدة (يمكن تغييرها لاحقًا).

بعد إنشاء الوحدة، ستظهر في الجدول. يمكنك الآن نشرها عن طريق النقر على نشر (سيستغرق ذلك بعض الوقت).

حالات الحاوية

  • لم يتم نشرها - تم إنشاء الوحدة ولكن لم يتم نشرها بعد.
  • يتم النشر - الوحدة في عملية النشر.
  • قيد التشغيل - الوحدة تعمل.
  • معلقة - تم نشر الوحدة ولكنها لا تعمل.

إجراءات الوحدة

  • تعليق تعليق الوحدة. يوقف العملية، لكن البيانات تبقى.
  • استئناف استئناف الوحدة. يبدأ العملية.
  • حذف حذف الوحدة. يوقف العملية، يحذف الحاوية، والبيانات المرتبطة.

تصحيح الأخطاء

إذا فشلت الوحدة في النشر أو كانت العملية تنتهي باستمرار، سترى تحذير.

المشكلات المحتملة

  • تم تكوين صورة docker بشكل غير صحيح.
  • الرمز غير صالح أو غير صحيح.
  • تنتهي العملية. يجب ألا تنتهي العملية الداخلية أثناء نشاط الوحدة.

السجلات

يمكنك تصحيح مشكلات أخرى مع الوحدة باستخدام السجلات المعروضة في إعدادات الوحدة.

تحديث/تعديل الوحدة

إذا كنت بحاجة إلى نشر نسخة جديدة من الوحدة أو تغيير المتغيرات البيئية، يجب عليك تحديث العلامة و/أو المتغيرات في الإعدادات. ستتم إعادة تشغيل العملية.

.