تشغيل Milvus باستخدام Docker Compose (لينكس)

توضح هذه الصفحة كيفية تشغيل مثيل Milvus في Docker باستخدام Docker Compose.

المتطلبات المسبقة

• قم بتثبيت Docker.
• تحقق من متطلبات الأجهزة والبرامج قبل التثبيت.

تثبيت Milvus

يوفر Milvus ملف تكوين Docker Compose في مستودع Milvus. لتثبيت Milvus باستخدام Docker Compose، ما عليك سوى تشغيل

# Download the configuration file
$ wget https://github.com/milvus-io/milvus/releases/download/v3.0.0/milvus-standalone-docker-compose.yml -O docker-compose.yml

# Start Milvus
$ sudo docker compose up -d

Creating milvus-etcd  ... done
Creating milvus-minio ... done
Creating milvus-standalone ... done

بعد بدء تشغيل Milvus،

• تكون الحاويات المسماة milvus-standalone و milvus-minio و milvus-etcd قيد التشغيل.
  • لا تكشف حاوية milvus-etcd عن أي منافذ للمضيف وتقوم بتعيين بياناتها إلى volumes/etcd في المجلد الحالي.
  • تقدم حاوية milvus-minio المنافذ 9000 و9001 محليًا باستخدام بيانات اعتماد المصادقة الافتراضية وتقوم بتعيين بياناتها إلى volumes/minio في المجلد الحالي.
  • تقدم حاوية milvus-standalone المنافذ 19530 محليًا باستخدام الإعدادات الافتراضية وتقوم بتعيين بياناتها إلى volumes/milvus في المجلد الحالي.

يمكنك التحقق مما إذا كانت الحاويات قيد التشغيل باستخدام الأمر التالي:

$ docker compose ps

NAME                IMAGE   COMMAND                  SERVICE      CREATED         STATUS                   PORTS
milvus-etcd         …       "etcd -advertise-cli…"   etcd         2 minutes ago   Up 2 minutes (healthy)   2379-2380/tcp
milvus-minio        …       "/usr/bin/docker-ent…"   minio        2 minutes ago   Up 2 minutes (healthy)   9000-9001/tcp
milvus-standalone   …       "/tini -- milvus run…"   standalone   2 minutes ago   Up 2 minutes (healthy)   0.0.0.0:9091->9091/tcp, 0.0.0.0:19530->19530/tcp

يمكنك أيضًا الوصول إلى واجهة المستخدم على الويب لـ Milvus على http://127.0.0.1:9091/webui/ لمعرفة المزيد عن مثيل Milvus الخاص بك. لمزيد من التفاصيل، راجع واجهة المستخدم على الويب ل ـ Milvus.

(اختياري) تحديث تكوينات Milvus

لتحديث إعدادات Milvus لتناسب احتياجاتك، تحتاج إلى تعديل ملف /milvus/configs/user.yaml الموجود داخل حاوية milvus-standalone.

1. قم بالوصول إلى الحاوية milvus-standalone.

   docker exec -it milvus-standalone bash
   

2. أضف إعدادات إضافية لتجاوز الإعدادات الافتراضية. يفترض ما يلي أنك بحاجة إلى تجاوز ملف proxy.healthCheckTimeout الافتراضي. للاطلاع على عناصر التكوين القابلة للتطبيق، راجع تكوين النظام.

   cat << EOF > /milvus/configs/user.yaml
   # Extra config to override default milvus.yaml
   proxy:
     healthCheckTimeout: 1000 # ms, the interval that to do component healthy check
   EOF
   

3. أعد تشغيل حاوية milvus-standalone لتطبيق التغييرات.

   docker restart milvus-standalone
   

إيقاف وحذف Milvus

يمكنك إيقاف هذا الحاوية وحذفها على النحو التالي

# Stop Milvus
$ sudo docker compose down

# Delete service data
$ sudo rm -rf volumes

الترقية من Milvus 2.5.x إلى 2.6.x

قيود قائمة انتظار الرسائل: عند الترقية إلى Milvus v3.0.0، يجب الحفاظ على اختيارك الحالي لقائمة انتظار الرسائل. لا يُدعم التبديل بين أنظمة قوائم انتظار الرسائل المختلفة أثناء الترقية. سيتوفر دعم تغيير أنظمة قوائم انتظار الرسائل في الإصدارات المستقبلية.

نظرًا لأن الإصدار 2.6.x يغير قائمة انتظار الرسائل الافتراضية إلى Woodpecker، يجب على المثيل الذي يعمل بنظام RocksMQ في الإصدار 2.5.x تثبيت RocksMQ بشكل صريح قبل الترقية — وإلا فإن عملية الترقية ستحاول تغيير قائمة انتظار الرسائل، وهو أمر غير مدعوم. بعد تنزيل ملف Docker Compose الخاص بالإصدار 2.6.x، أعد تعيين نوع قائمة انتظار الرسائل إلى « rocksmq » في ملف التجاوز الخاص بـ « user.yaml »، ثم قم بالترقية:

# user.yaml — keep RocksMQ across the 2.5.x → 2.6.x upgrade
mq:
  type: rocksmq

لتغيير قائمة انتظار الرسائل بعد الترقية، راجع «تغيير قائمة انتظار الرسائل».

التبعيات الاختيارية

يعمل هذا النشر على Woodpecker (مُدمج، خلفية MinIO WAL) للمراسلة، وetcd للبيانات الوصفية، وMinIO لتخزين الكائنات. لاستخدام قائمة انتظار رسائل مختلفة أو توصيل تخزين كائنات / بيانات وصفية خارجية، راجع:

• قائمة انتظار الرسائل: Woodpecker (افتراضي) · Pulsar · Kafka · RocksMQ
• تخزين الكائنات: MinIO (افتراضي) · AWS S3 · Azure Blob · GCP Cloud Storage · Aliyun OSS · Tencent COS · Huawei OBS · متوافق مع S3
• البيانات الوصفية: etcd

الخطوة التالية

بعد تثبيت Milvus في Docker، يمكنك:

• راجع «البدء السريع » لمعرفة ما يمكن لـ Milvus القيام به.

• تعلم العمليات الأساسية لـ Milvus:

  • إدارة قواعد البيانات
  • إدارة المجموعات
  • إدارة الأقسام
  • الإدراج والتحديث والحذف
  • البحث أحادي المتجه
  • البحث الهجين

• ترقية Milvus باستخدام Helm Chart.

• توسيع نطاق مجموعة Milvus الخاصة بك.

• نشر مجموعة Milvus الخاصة بك على السحابة:

  • Amazon EKS
  • Google Cloud
  • Microsoft Azure

• استكشف Milvus WebUI، وهي واجهة ويب سهلة الاستخدام لمراقبة وإدارة Milvus.

• اكتشف Milvus Backup، وهي أداة مفتوحة المصدر لنسخ بيانات Milvus احتياطيًا.

• اكتشف Birdwatcher، وهي أداة مفتوحة المصدر لتصحيح أخطاء Milvus وتحديثات التكوين الديناميكية.

• اكتشف Attu، وهي أداة واجهة مستخدم رسومية مفتوحة المصدر لإدارة Milvus بطريقة بديهية.

• راقب Milvus باستخدام Prometheus.