Helmチャートを使用したMilvusクラスタのアップグレード

このガイドでは、Helmチャートを使用してMilvusクラスターをv2.5.xからv3.0-betaにアップグレードする方法について説明します。

開始する前に

v3.0-betaの新機能

Milvus 2.5.x から 3.0-beta へのアップグレードには、アーキテクチャ上の大幅な変更が伴います：

• コーディネーターの統合：従来別々に存在していたコーディネーター（dataCoord 、queryCoord 、indexCoord ）が、単一のmixCoord
• 新コンポーネント：データ処理機能を強化するためのストリーミングノードの導入
• コンポーネントの削除：indexNode が削除され、統合されました

このアップグレードプロセスにより、新しいアーキテクチャへの適切な移行が保証されます。アーキテクチャの変更に関する詳細については、『Milvus アーキテクチャ概要』を参照してください。

要件

システム要件：

• Helm バージョン >= 3.14.0
• Kubernetes バージョン >= 1.20.0
• Helmチャート経由でデプロイされたMilvusクラスター

互換性に関する要件：

• Milvus v2.6.0-rc1 は v3.0-betaと互換性がありません。リリース候補版からの直接アップグレードはサポートされていません。
• 現在 v2.6.0-rc1 を実行しており、データを保持する必要がある場合は、移行の参考としてこちらのコミュニティガイドを参照してください。
• v3.0-beta にアップグレードする前に、mixCoordinator を有効にした状態で v2.5.16 以降にアップグレードする必要があります。

メッセージキューの制限事項：Milvus v3.0-beta へアップグレードする際は、現在のメッセージキューの設定を維持する必要があります。アップグレード中に異なるメッセージキューシステムへ切り替えることはサポートされていません。メッセージキューシステムの変更機能は、将来のバージョンで提供される予定です。

アップグレード手順

手順 1: Helm チャートのアップグレード

まず、Milvus Helmチャートをバージョン5.0.22にアップグレードしてください：

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

HelmチャートのバージョンとMilvusのバージョンの互換性を確認するには：

helm search repo zilliztech/milvus --versions

このガイドでは、最新バージョンをインストールすることを前提としています。特定のバージョンをインストールする必要がある場合は、--version パラメータを適宜指定してください。

ステップ 2: mixCoordinator を使用して v2.5.16 にアップグレードする

クラスタが現在、個別のコーディネーターを使用しているかどうかを確認します:

kubectl get pods

個別のコーディネーターポッド（datacoord 、querycoord 、indexcoord ）が存在する場合は、v2.5.16 にアップグレードし、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

アップグレードが完了するまでお待ちください:

# Verify all pods are ready
kubectl get pods

ステップ 3: v3.0-beta へのアップグレード

mixCoordinator を使用して v2.5.16 が正常に動作していることを確認したら、v3.0-beta にアップグレードします:

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

アップグレードの確認

クラスターが新しいバージョンで実行されていることを確認してください:

# Check pod status
kubectl get pods

# Verify Helm release
helm list

さらにサポートが必要な場合は、Milvusのドキュメントまたはコミュニティフォーラムをご参照ください。