تشغيل Human Plugin يومًا بيوم.
التحديثات
شغّل صورة latest، وحدّثها عندما تعلن Unico عن إصدار جديد:
- Docker Compose:
docker compose pull && docker compose up -d. - Kubernetes:
kubectl -n human-plugin rollout restart deployment/human-plugin، معimagePullPolicy: Always.
يجهّز الإصدار الجديد الجداول التي يحتاجها عند البدء، قبل أن يقبل أي طلبات، لذلك لا حاجة إلى أي خطوة يدوية في قاعدة البيانات. خذ نسخة احتياطية من قاعدة البيانات قبل التحديث في الإنتاج، ثم تحقق من /health/ready ومن طلب إنشاء حقيقي بعد ذلك.
تدوير بيانات الاعتماد
مفتاح الوصول. تصدر Unico المفتاح الجديد مع فترة تداخل. حدّث HUMAN_API_ACCESS_KEY في ملف .env أو في Secret، ثم أعد تشغيل Human Plugin (docker compose up -d --force-recreate، أو kubectl -n human-plugin rollout restart deployment/human-plugin)، وتأكد من نجاح طلب إنشاء، ثم اطلب من Unico إلغاء المفتاح القديم.
بيانات اعتماد السجل (registry). تصدر Unico رمزًا جديدًا بينما يظل القديم صالحًا. سجّل الدخول مجددًا بالرمز الجديد (أو أعد إنشاء pull secret في Kubernetes)، ثم اسحب الصورة مرة واحدة للتأكد، ثم اطلب من Unico إلغاء الرمز القديم. الحاويات قيد التشغيل لا تتأثر.
كلمة مرور قاعدة البيانات. غيّرها في PostgreSQL وفي POSTGRES_PASSWORD، ثم أعد تشغيل Human Plugin.
الإيقاف
عند استلام SIGTERM، يتوقف Human Plugin عن قبول الاتصالات وينتظر حتى 55 ثانية لإنهاء الطلبات الجارية، لأن عملية الإنشاء قد تستغرق حتى 30 ثانية ثم تخزّن نتيجتها. اضبط مهلة الإيقاف على 60 ثانية على الأقل. عملية الإنشاء التي تنقطع تُسوّى كفاشلة عند قراءة لاحقة.
التوسّع
لا يحتفظ Human Plugin بأي حالة للطلبات في الذاكرة، لذلك يمكن لعدة حاويات مشاركة قاعدة بيانات واحدة. أضف نسخة واحدة (replica) لكل 1,500 معاملة في الدقيقة ، وارفع max_connections في PostgreSQL إلى 25 × عدد النسخ + 10. راجع متطلبات العتاد.
كتالوج السمات
ينزّل Human Plugin كتالوج السمات مرة واحدة عند البدء. يصل إصدار الكتالوج الجديد إلى الحاوية عند إعادة تشغيلها التالية. إعادة تشغيل الحاويات واحدة تلو الأخرى تُبقي الخدمة متاحة.
النسخ الاحتياطي
تحتفظ قاعدة بياناتك بالـ intelligence التي تُحسب منها data.ndocs. انسخها احتياطيًا بأدواتك الخاصة واختبر الاستعادة. فقدان قاعدة البيانات يعني فقدان الـ intelligence، ولا يمكن إعادة بنائها.