Helm ChartによるMilvusクラスタのアップグレード

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

始める前に

v2.6.16の新機能

Milvus 2.5.xから2.6.16へのアップグレードには、アーキテクチャ上の大きな変更が含まれます:

  • コーディネーターの統合:従来の別々のコーディネータ(dataCoord,queryCoord,indexCoord)は1つに統合されました。mixCoord
  • 新しいコンポーネントデータ処理強化のためのストリーミング・ノードの導入
  • コンポーネントの削除indexNode を削除、統合

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

要件

システム要件

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

互換性の要件

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

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

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

アップグレード手順

ステップ 1: Helm チャートのアップグレード

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

helm repo add zilliztech https://zilliztech.github.io/milvus-helm
helm repo update zilliztech
Milvus Helm Chartsレポ(https://milvus-io.github.io/milvus-helm/ )はアーカイブされました。チャートバージョン4.0.31以降には新しいレポhttps://zilliztech.github.io/milvus-helm/

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

クラスタがすでにmixCoordinator を使用している場合は、イメージをアップグレードするだけです:

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

v2.5.16がmixCoordinator 、正常に動作するようになったら、v2.6.16にアップグレードします:

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

アップグレードの確認

クラスタが新しいバージョンを実行していることを確認します:

# Check pod status
kubectl get pods

# Verify Helm release
helm list

その他のサポートについては、milvusのドキュメントまたはコミュニティフォーラムを参照してください。