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 へのアップグレード時には、現在のメッセージキューの選択を維持する必要があります。アップグレード中に異なるメッセージキューシステムへ切り替えることはサポートされていません。メッセージキューシステムの変更に対するサポートは、将来のバージョンで提供される予定です。
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のドキュメントまたはコミュニティフォーラムをご参照ください。