Helmチャートを使用したMilvusスタンドアロンのアップグレード
このガイドでは、Helm を使用して Milvus 2.6.x スタンドアロン環境を v3.0.5 にアップグレードする方法について説明します。
この手順は、Milvus 2.6.20 から Milvus v3.0.5 へのアップグレードについて、Milvus Helm チャート 5.0.22 を使用して検証済みです。他の Milvus 2.6.x パッチリリースや Helm チャートのバージョンを使用する場合は、まず本番環境以外でアップグレードを検証してください。
前提条件
- Helm 3.14.0 以降
- Helm によって管理されている既存の Milvus 2.6.x デプロイメント
- 既存のデプロイメントで使用されている Helm 値
- Milvus メタデータおよび永続データの最新のバックアップ
メッセージキューの制限事項:Milvus v3.0.5 へのアップグレード時には、現在のメッセージキューの設定を維持する必要があります。アップグレード中に異なるメッセージキューシステムへ切り替えることはサポートされていません。メッセージキューシステムの変更機能は、将来のバージョンで提供される予定です。
この手順の一環として、Helm Chartを変更またはダウングレードしないでください。Helmリリース用にすでにインストールされているChartバージョンを維持してください。テスト済みのベースラインでは、Helm Chart 5.0.22を維持し、Milvusイメージタグのみをv3.0.5 に変更しました。
この手順では、Milvus イメージを 2.6.x に戻すことによるダウングレードやロールバックの妥当性は検証されていません。 v3.0.5 がデータを書き込んだ後、イメージのみのロールバックでは、更新後の状態を読み取れない場合があります。アップグレードに失敗した場合は、書き込みを停止し、アップグレード前のメタデータと永続データのバックアップを復元する復旧計画を実行してください。復旧計画は、まず本番環境以外で検証してください。
アップグレード手順
ステップ 1: Helm リポジトリを更新する
Milvus Helm リポジトリを追加または更新します:
helm repo add zilliztech https://zilliztech.github.io/milvus-helm --force-update
helm repo update zilliztech
https://milvus-io.github.io/milvus-helm/ にある Milvus Helm Charts リポジトリはアーカイブされました。チャートバージョン 4.0.31 以降については、新しいリポジトリhttps://zilliztech.github.io/milvus-helm/ を使用してください。
ステップ 2: Milvus のアップグレード
Helm リリースにインストールされているチャートバージョンを確認します:
helm list --namespace <namespace>
「CHART 」列の値から「milvus- 」というプレフィックスを削除し、残りのバージョンを「<current-chart-version> 」として使用します。その後、アップグレードコマンドを実行します:
helm upgrade <release-name> zilliztech/milvus \
--namespace <namespace> \
--version <current-chart-version> \
--set image.all.tag="v3.0.5" \
--reset-then-reuse-values \
--wait \
--timeout 20m
--reset-then-reuse-values オプションは、以前のリリースからの値を保持しつつ、選択されたChartのデフォルト設定に対して明示的なイメージのオーバーライドを適用します。
アップグレードの確認
Helmのリビジョン、Podのステータス、およびコンテナイメージを確認します:
helm history <release-name> --namespace <namespace>
kubectl get pods --namespace <namespace>
kubectl get pods --namespace <namespace> \
-o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{range .spec.containers[*]}{.image}{" "}{end}{"\n"}{end}'
必要なすべてのワークロードが利用可能であること、Milvusがv3.0.5 を使用していること、および既存のコレクションが引き続きクエリおよび検索可能であることを確認してください。v3.0.5固有の機能を有効にする前に、これらの確認を完了してください。
Milvus 3.0 へのアップグレードを行っても、Storage V3 は有効になりません。アップグレードを確認した後、Storage V3に依存する機能を有効にする前に、Storage V3について確認してください。Milvus が Storage V3 データを書き込んだ後は、Storage V3 を読み取れない古いバージョンの Milvus へのダウングレードはサポートされません。