تبديل نوع MQ لـ Milvus Standalone
يصف هذا الموضوع كيفية تبديل نوع قائمة انتظار الرسائل (MQ) لنشر Milvus مستقل موجود. يدعم Milvus تبديل MQ عبر الإنترنت دون توقف.
هذه الميزة في انتظار الإصدار وهي عرضة للتغيير. يرجى التواصل مع دعم Milvus إذا كنت ترغب في تجربتها أو لديك أي أسئلة.
المتطلبات الأساسية
- مثيل Milvus مستقل قيد التشغيل مثبت عبر Docker أو Docker Compose.
- تمت ترقية مثيل Milvus إلى أحدث إصدار يدعم ميزة تبديل MQ هذه.
سير العمل العام
سير العمل العام لتبديل نوع MQ هو كما يلي:
- تأكد من تشغيل مثيل Milvus بشكل صحيح.
- تأكيد نوع MQ المصدر ونوع MQ الهدف.
- قم بتكوين إعدادات وصول MQ الهدف في تكوين Milvus دون تغيير القيمة
mqType. - قم بتشغيل التبديل عن طريق استدعاء واجهة برمجة التطبيقات WAL تغيير WAL.
- راقب السجلات للتحقق من اكتمال التبديل بنجاح.
قبل التبديل، تأكد قبل التبديل من أن MQ الهدف لا يحتوي على مواضيع بنفس الأسماء التي يستخدمها مثيل Milvus الحالي. هذا مهم بشكل خاص إذا كانت خدمة MQ الهدف قد تم استخدامها مسبقاً من قبل مثيل Milvus آخر، حيث يمكن أن تؤدي أسماء المواضيع المتضاربة إلى سلوك غير متوقع.
التبديل من RocksMQ إلى نقار الخشب (التخزين المحلي)
ينطبق هذا الإجراء على عمليات نشر Milvus Standalone Docker المستقلة التي تستخدم RocksMQ بشكل افتراضي.
الخطوة 1: تحقق من أن مثيل Milvus قيد التشغيل
تأكد من تشغيل مثيل Milvus Standalone Docker بشكل صحيح. يمكنك التحقق من ذلك من خلال إنشاء مجموعة اختبار وإدراج البيانات وتشغيل استعلام.
الخطوة 2: تكوين Woodpecker مع التخزين المحلي
قم بتحديث تكوين Milvus لإضافة إعدادات Woodpecker دون تغيير القيمة mqType. قم بإنشاء أو تحديث الملف user.yaml بالمحتوى التالي:
woodpecker:
storage:
type: local
ثم أعد تشغيل مثيل Milvus لتطبيق التكوين:
bash standalone_embed.sh restart
الخطوة 3: قم بتنفيذ مفتاح MQ
قم بتشغيل الأمر التالي لتشغيل التبديل إلى Woodpecker:
curl -X POST http://<mixcoord_addr>:9091/management/wal/alter \
-H "Content-Type: application/json" \
-d '{"target_wal_name": "woodpecker"}'
استبدل <mixcoord_addr> بالعنوان الفعلي لخدمة MixCoord (افتراضيًا، localhost لعمليات النشر المستقلة).
الخطوة 4: تحقق من اكتمال التبديل
تكتمل عملية التبديل تلقائياً. راقب سجلات ميلفوس للرسائل الرئيسية التالية للتأكد من اكتمال عملية التبديل:
WAL switch success: <MQ1> switch to <MQ2> finish, re-opening required
AlterWAL broadcast message acknowledged by all vchannels
successfully updated mq.type configuration in etcd
في رسائل السجل أعلاه، <MQ1> هو نوع MQ المصدر (rocksmq)، و <MQ2> هو نوع MQ الهدف (woodpecker).
- تشير الرسالة الأولى إلى أن تبديل WAL من المصدر إلى الهدف قد اكتمل.
- تشير الرسالة الثانية إلى أن جميع القنوات الفعلية قد تم تبديلها.
- تشير الرسالة الثالثة إلى أن تكوين
mq.typeقد تم تحديثه في etcd.
التبديل من RocksMQ إلى Woodpecker (تخزين MinIO)
ينطبق هذا الإجراء على عمليات نشر Milvus Standalone Docker Compose المستقلة.
بدءًا من الإصدار 2.6 من Milvus v2.6، يعلن الإعداد الافتراضي docker-compose.yaml بالفعل mqType على أنه Woodpecker. ما لم تقم بتعديل التكوين الافتراضي أو الترقية من الإصدار 2.5، قد لا يكون هذا الإجراء ضروريًا.
الخطوة 1: تحقق من تشغيل مثيل ميلفوس
تأكد من تشغيل مثيل Milvus Standalone Docker Compose بشكل صحيح.
الخطوة 2: (اختياري) التحقق من تكوين Woodpecker
يقوم تكوين Milvus الافتراضي بتعيين نوع تخزين Woodpecker إلى MinIO، لذلك لا يلزم إجراء تكوين إضافي في معظم الحالات.
ومع ذلك، إذا كنت قد قمت بتخصيص تكوين Woodpecker مسبقًا، يجب عليك التأكد من تعيين woodpecker.storage.type على minio. قم بإنشاء أو تحديث الملف user.yaml بالمحتوى التالي:
woodpecker:
storage:
type: minio
ثم أعد تشغيل مثيل ميلفوس لتطبيق التكوين:
docker compose down
docker compose up -d
الخطوة 3: قم بتشغيل مفتاح MQ
قم بتشغيل الأمر التالي لتشغيل التبديل إلى Woodpecker:
curl -X POST http://<mixcoord_addr>:9091/management/wal/alter \
-H "Content-Type: application/json" \
-d '{"target_wal_name": "woodpecker"}'
استبدل <mixcoord_addr> بالعنوان الفعلي لخدمة MixCoord (افتراضيًا، localhost لعمليات النشر المستقلة).
الخطوة 4: تحقق من اكتمال التبديل
تكتمل عملية التبديل تلقائياً. راقب سجلات ميلفوس للرسائل الرئيسية التالية للتأكد من اكتمال عملية التبديل:
WAL switch success: <MQ1> switch to <MQ2> finish, re-opening required
AlterWAL broadcast message acknowledged by all vchannels
successfully updated mq.type configuration in etcd
في رسائل السجل أعلاه، <MQ1> هو نوع MQ المصدر (rocksmq)، و <MQ2> هو نوع MQ الهدف (woodpecker).
- تشير الرسالة الأولى إلى أن تبديل WAL من المصدر إلى الهدف قد اكتمل.
- تشير الرسالة الثانية إلى أن جميع القنوات الفعلية قد تم تبديلها.
- تشير الرسالة الثالثة إلى أن التكوين
mq.typeقد تم تحديثه في etcd.