MilvusOperator、Helm、DockerCompose

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

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

開始する前に

v3.0-betaの新機能

Milvus 2.5.x から 3.0-beta へのアップグレードには、以下の重要なアーキテクチャの変更が含まれます:

  • コーディネーターの統合:従来別々に存在していたコーディネーター(dataCoordqueryCoordindexCoord )が、単一の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 にアップグレードする前に、v2.5.16 以降にアップグレードする必要があります

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

Milvus Helmチャートバージョン4.2.21以降、依存関係としてpulsar-v3.xチャートを導入しました。下位互換性を確保するため、Helmをv3.14以降のバージョンにアップグレードし、helm upgrade を使用する際は必ず--reset-then-reuse-values オプションを追加してください。

アップグレード手順

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

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

helm repo add zilliztech https://zilliztech.github.io/milvus-helm
helm repo update zilliztech
https://milvus-io.github.io/milvus-helm/ にある Milvus Helm チャートリポジトリはアーカイブされました。バージョン 4.0.31 以降のチャートについては、新しいリポジトリhttps://zilliztech.github.io/milvus-helm/ をご利用ください。

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

helm search repo zilliztech/milvus --versions

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

ステップ 2: v2.5.16 へのアップグレード

スタンドアロン環境がすでに v2.5.16 以降を実行している場合は、この手順をスキップしてください。

Milvusスタンドアロンをv2.5.16にアップグレードします:

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 へのアップグレード

v2.5.16が正常に動作したら、v3.0-betaにアップグレードします:

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

アップグレードの確認

スタンドアロン環境が新しいバージョンで実行されていることを確認してください:

# Check pod status
kubectl get pods

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