MilvusOperator、Helm、DockerCompose

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

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

開始する前に

v2.6.24の新機能

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

  • コーディネーターの統合:従来の個別のコーディネーター(dataCoord 、queryCoord 、indexCoord )が単一のmixCoord
  • 新コンポーネント:データ処理機能を強化するためのストリーミングノードの導入
  • コンポーネントの削除:indexNode が削除され、統合されました

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

要件

システム要件:

  • Helmのバージョン:3.14.0以上
  • Kubernetes バージョン >= 1.20.0
  • Helm Chart 経由でデプロイされた Milvus スタンドアロン

互換性に関する要件:

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

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

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

v2.5.16が正常に動作していることを確認したら、v2.6.24にアップグレードします:

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

アップグレードの確認

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

# Check pod status
kubectl get pods

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