• Über Milvus
  • Los geht's
  • Konzepte
  • Benutzerhandbuch
  • Datenimport
  • AI-Tools
  • Leitfaden für die Verwaltung
  • Werkzeuge
  • Integrationen
  • Anleitungen
  • FAQs
  • API Reference

Milvus-Cluster mit Helm-Chart aktualisieren

In dieser Anleitung wird beschrieben, wie Sie Ihren Milvus-Cluster mithilfe eines Helm-Charts von Version 2.5.x auf Version 3.0-beta aktualisieren können.

Bevor Sie beginnen

Neuerungen in v3.0-beta

Das Upgrade von Milvus 2.5.x auf 3.0-beta bringt erhebliche architektonische Änderungen mit sich:

  • Konsolidierung der Koordinatoren: Die bisher separaten Koordinatoren (dataCoord, queryCoord, indexCoord) wurden zu einem einzigen zusammengefasst mixCoord
  • Neue Komponenten: Einführung des Streaming-Knotens für eine verbesserte Datenverarbeitung
  • Entfernung von Komponenten: „ indexNode “ wurde entfernt und konsolidiert

Dieser Upgrade-Prozess gewährleistet eine ordnungsgemäße Migration zur neuen Architektur. Weitere Informationen zu den Architekturänderungen finden Sie in der Milvus-Architekturübersicht.

Anforderungen

Systemanforderungen:

  • Helm-Version >= 3.14.0
  • Kubernetes-Version >= 1.20.0
  • Milvus-Cluster, bereitgestellt über Helm Chart

Kompatibilitätsanforderungen:

  • Milvus v2.6.0-rc1 ist nicht mit v3.0-beta kompatibel. Direkte Upgrades von Release-Kandidaten werden nicht unterstützt.
  • Wenn Sie derzeit v2.6.0-rc1 verwenden und Ihre Daten beibehalten möchten, finden Sie in diesem Community-Leitfaden Hilfe zur Migration.
  • Sie müssen vor dem Upgrade auf v3.0-beta ein Upgrade auf v2.5.16 oder höher durchführen, wobei „ mixCoordinator “ aktiviert sein muss.

Einschränkungen bei den Nachrichtenwarteschlangen: Beim Upgrade auf Milvus v3.0-beta müssen Sie Ihre derzeitige Auswahl der Nachrichtenwarteschlange beibehalten. Ein Wechsel zwischen verschiedenen Nachrichtenwarteschlangensystemen während des Upgrades wird nicht unterstützt. Die Unterstützung für den Wechsel des Nachrichtenwarteschlangensystems wird in zukünftigen Versionen verfügbar sein.

Seit der Milvus-Helm-Chart-Version 4.2.21 haben wir das Chart „pulsar-v3.x“ als Abhängigkeit eingeführt. Aus Gründen der Abwärtskompatibilität aktualisieren Sie bitte Ihr Helm auf Version 3.14 oder höher und stellen Sie sicher, dass Sie die Option „ --reset-then-reuse-values “ hinzufügen, wann immer Sie „ helm upgrade “ verwenden.

Upgrade-Vorgang

Schritt 1: Helm-Chart aktualisieren

Aktualisieren Sie zunächst Ihr Milvus-Helm-Chart auf Version 5.0.22:

helm repo add zilliztech https://zilliztech.github.io/milvus-helm
helm repo update zilliztech
Das Milvus-Helm-Charts-Repo unter https://milvus-io.github.io/milvus-helm/ wurde archiviert. Verwenden Sie für Chart-Versionen ab 4.0.31 das neue Repo https://zilliztech.github.io/milvus-helm/.

So überprüfen Sie die Kompatibilität der Helm-Chart-Version mit den Milvus-Versionen:

helm search repo zilliztech/milvus --versions

In dieser Anleitung wird davon ausgegangen, dass Sie die neueste Version installieren. Wenn Sie eine bestimmte Version installieren müssen, geben Sie den Parameter „ --version “ entsprechend an.

Schritt 2: Upgrade auf v2.5.16 mit mixCoordinator

Überprüfen Sie, ob Ihr Cluster derzeit separate Koordinatoren verwendet:

kubectl get pods

Wenn Sie separate Koordinator-Pods sehen (datacoord, querycoord, indexcoord), führen Sie ein Upgrade auf v2.5.16 durch und aktivieren Sie „ mixCoordinator “:

helm upgrade my-release zilliztech/milvus \
  --set image.all.tag="v2.5.16" \
  --set mixCoordinator.enabled=true \
  --set rootCoordinator.enabled=false \
  --set indexCoordinator.enabled=false \
  --set queryCoordinator.enabled=false \
  --set dataCoordinator.enabled=false \
  --reset-then-reuse-values \
  --version=4.2.58

Wenn Ihr Cluster bereits mixCoordinator verwendet, aktualisieren Sie einfach das Image:

helm upgrade my-release zilliztech/milvus \
  --set image.all.tag="v2.5.16" \
  --reset-then-reuse-values \
  --version=4.2.58

Warten Sie, bis das Upgrade abgeschlossen ist:

# Verify all pods are ready
kubectl get pods

Schritt 3: Aktualisieren Sie auf v3.0-beta

Sobald v2.5.16 erfolgreich mit mixCoordinator läuft, führen Sie ein Upgrade auf v3.0-beta durch:

helm upgrade my-release zilliztech/milvus \
  --set image.all.tag="v3.0-beta" \
  --set streaming.enabled=true \
  --set indexNode.enabled=false \
  --reset-then-reuse-values \
  --version=5.0.22

Überprüfen Sie das Upgrade

Stellen Sie sicher, dass Ihr Cluster die neue Version ausführt:

# Check pod status
kubectl get pods

# Verify Helm release
helm list

Weitere Unterstützung finden Sie in der Milvus-Dokumentation oder im Community-Forum.