Upgrade des Milvus-Clusters mit Helm Chart

Diese Anleitung beschreibt, wie Sie Ihren Milvus-Cluster mit Helm Chart von v2.5.x auf v2.6.14 aktualisieren.

Bevor Sie beginnen

Was ist neu in v2.6.14

Das Upgrade von Milvus 2.5.x auf 2.6.14 bringt erhebliche Änderungen an der Architektur mit sich:

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

Dieser Upgrade-Prozess gewährleistet eine ordnungsgemäße Migration auf die neue Architektur. Weitere Informationen zu den Änderungen an der Architektur finden Sie in der Milvus-Architekturübersicht.

Anforderungen

Systemanforderungen:

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

Kompatibilitätsanforderungen:

• Milvus v2.6.0-rc1 ist nicht kompatibel mit v2.6.14. Direkte Upgrades von Release Candidates werden nicht unterstützt.
• Wenn Sie derzeit v2.6.0-rc1 einsetzen und Ihre Daten erhalten müssen, finden Sie in diesem Community-Leitfaden Unterstützung bei der Migration.
• Vor dem Upgrade auf v2.6.14 müssen Sie ein Upgrade auf v2.5.16 oder höher mit aktiviertem mixCoordinator durchführen.

Einschränkungen bei der Nachrichtenwarteschlange: Wenn Sie auf Milvus v2.6.14 aktualisieren, müssen Sie Ihre aktuelle Wahl der Nachrichtenwarteschlange beibehalten. Ein Wechsel zwischen verschiedenen Message-Queue-Systemen während des Upgrades wird nicht unterstützt. Unterstützung für den Wechsel von Nachrichtenwarteschlangensystemen wird in zukünftigen Versionen verfügbar sein.

Upgrade-Prozess

Schritt 1: Helm-Diagramm aktualisieren

Aktualisieren Sie zunächst Ihr Milvus Helm-Diagramm auf Version 5.0.0:

helm repo add zilliztech https://zilliztech.github.io/milvus-helm
helm repo update zilliztech

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

helm search repo zilliztech/milvus --versions

Dieser Leitfaden geht davon aus, 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 getrennte Koordinatoren verwendet:

kubectl get pods

Wenn Sie separate Coordinator-Pods (datacoord, querycoord, indexcoord) sehen, aktualisieren Sie auf v2.5.16 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

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

Warten Sie den Abschluss des Upgrades ab:

# Verify all pods are ready
kubectl get pods

Schritt 3: Upgrade auf v2.6.14

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

helm upgrade my-release zilliztech/milvus \
  --set image.all.tag="v2.6.14" \
  --set streaming.enabled=true \
  --set indexNode.enabled=false \
  --reset-then-reuse-values \
  --version=5.0.0

Überprüfen Sie das Upgrade

Vergewissern Sie sich, 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.