المتطلبات الأساسية
- خذ نسخة احتياطية من بياناتك قبل الترقية (MongoDB, ClickHouse PVCs)
- راجع تجاوزات
values.yamlالحالية — فقد نُقلت معظم المفاتيح أو أُعيدت تسميتها
التثبيت على مرحلتين
استدامة البيانات
helm uninstall عناصر PersistentVolumeClaims التي يُنشئها مشغّلا MongoDB وClickHouse. وهذا مقصود لتجنّب فقدان البيانات عن طريق الخطأ. لتنظيف PVCs بعد إلغاء التثبيت، راجع:
فئة التخزين
global.storageClassName وglobal.keepPVC. تُضبط فئة التخزين الآن مباشرةً ضمن CR spec الخاص بكل مشغّل:
ما الذي تغيّر
إعادة تنظيم قيم HyperDX
hyperdx: منظَّمة الآن وفقًا لنوع مورد Kubernetes:
أهم التغييرات
ConfigMap وSecret الموحَّدان
envFrom:
clickstack-configConfigMap — يُعبَّأ منhyperdx.configclickstack-secretSecret — يُعبَّأ منhyperdx.secrets
ترحيل MongoDB
القيم التي أُزيلت
mongodb.* التالية متوفّرة:
القيم الجديدة
MongoDBCommunity. ويُولَّد قسم المواصفات في المورد المخصص كما هو من mongodb.spec:
hyperdx.secrets.MONGODB_PASSWORD (وليس mongodb.password). ويُشار إليها تلقائيًا في Secret كلمة المرور وقالب mongoUri.
لإضافة تخزين دائم، أضِف كتلة statefulSet داخل mongodb.spec:
mongodb-operator: (وليس mongodb-kubernetes:). راجع وثائق MCK للاطلاع على جميع حقول CRD المتاحة.
الترحيل إلى ClickHouse
القيم المُزالة
clickhouse.* التالية موجودة:
القيم الجديدة
ClickHouseCluster وKeeperCluster. ويُعرَض قسم spec في كلٍّ منهما حرفيًا انطلاقًا من values:
hyperdx.secrets (وليس من clickhouse.config.users). ويشير تعريف العنقود إليها باستخدام تعبيرات القوالب.
تتم تهيئة المخطط الفرعي ClickHouse Operator ضمن clickhouse-operator:. تكون webhooks وcert-manager معطّلتين افتراضيًا. راجع دليل تهيئة المشغّل للاطلاع على جميع حقول CRD المتاحة.
ترحيل OTel collector
القيم المُزالة
otel: بأكملها موجودة:
القيم الجديدة
otel-collector:. ولا توجد طبقة otel: التفافية للمخطط الأب — اضبط المخطط الفرعي مباشرةً.
تُشارَك متغيرات البيئة (نقطة نهاية ClickHouse، وعنوان URL لـ OpAMP، وما إلى ذلك) عبر clickstack-config ConfigMap الموحّد وclickstack-secret Secret. ويكون extraEnvsFrom الخاص بالمخطط الفرعي مُوصّلًا مسبقًا:
otel.resources):
otel.replicas):
otel.nodeSelector/otel.tolerations):
القيم التي لم تتغير
global.*(imageRegistry, imagePullSecrets)
تثبيت جديد مقابل الترقية الموضعية
- سيُثبَّت المشغّلان (MCK وClickHouse Operator) كعمليتَي نشر جديدتين في مساحة الاسم الخاصة بك
- سيحذف Helm موردَي Deployment الحاليَّين لـ MongoDB وClickHouse (لأنهما لم يعودا موجودين ضمن قوالب مخطط)
- سينشئ المشغّلان موارد StatefulSet جديدة لإدارة MongoDB وClickHouse
- لن يُعاد استخدام PVCs من المخطط القديم تلقائيًا بواسطة موارد StatefulSet التي يديرها المشغّلان
الخطوات التالية
- دليل Helm الرئيسي - التثبيت الأساسي مع v2.x
- دليل الإعداد - مفاتيح واجهة برمجة التطبيقات، والأسرار، وموارد Ingress
- ملفات البيان الإضافية - كائنات Kubernetes مخصّصة
- مستودع مخططات Helm الخاصة بـ ClickStack - الشيفرة المصدرية للمخطط ومرجع values