Docker Compose を使用した Milvus スタンドアロンのアップグレード
このガイドでは、Docker Compose を使用して Milvus 2.6.x スタンドアロン環境を v3.0.1 にアップグレードする方法について説明します。
この手順は、公式の Milvus 2.6.20 スタンドアロン Docker Compose 構成で検証済みです。このアップグレードでは、etcd、MinIO、Woodpecker、および既存のデータディレクトリは維持され、Milvus イメージのみがmilvusdb/milvus:v3.0.1 に変更されました。
前提条件
- Docker Engine および Docker Compose V2
- Docker Compose によって管理されている既存の Milvus 2.6.x スタンドアロン環境
- 既存のデプロイメントで使用されている Docker Compose ファイルおよび設定
- Milvusのメタデータおよび永続データの最新のバックアップ
メッセージキューの制限事項：Milvus v3.0.1 へのアップグレード時には、現在のメッセージキューの選択を維持する必要があります。アップグレード中に異なるメッセージキューシステムへ切り替えることはサポートされていません。メッセージキューシステムの変更に関するサポートは、将来のバージョンで提供される予定です。
この手順の一環として、現在の Compose ファイルを置き換えたり、依存関係のバージョンを変更したりしないでください。既存の etcd、オブジェクトストレージ、メッセージキュー、ボリューム、および設定はそのまま維持してください。Milvus イメージタグのみを更新してください。
この手順では、Milvus イメージを 2.6.x に戻すことによるダウングレードやロールバックは検証されていません。 v3.0.1 でデータが書き込まれた後、イメージのみのロールバックでは、更新後の状態を読み取れない場合があります。アップグレードに失敗した場合は、書き込みを停止し、アップグレード前のメタデータと永続データのバックアップを復元するリカバリ計画を実行してください。リカバリ計画は、まず本番環境以外で検証してください。
アップグレード手順
ステップ 1: 現在の構成をバックアップする
現在の Compose ファイルおよびマウントされている Milvus 設定ファイルのコピーを保存します:
cp docker-compose.yml docker-compose-before-upgrade.yml
アップグレードを開始する前に、現在のコンテナが正常に動作していることを確認してください：
docker compose ps
ステップ 2: Milvus イメージを更新する
既存の Compose ファイル内で、standalone サービスのイメージのみを更新します:
services:
standalone:
image: milvusdb/milvus:v3.0.1
対象イメージを取得し、Milvusコンテナのみを再作成します：
docker compose pull standalone
docker compose up --detach standalone
Docker Compose は、既存の etcd および object-storage コンテナを稼働させたままにし、設定済みのデータディレクトリを再利用します。
アップグレードの確認
コンテナのステータスと、Milvusコンテナが使用しているイメージを確認します:
docker compose ps
docker compose images standalone
docker compose logs --tail 100 standalone
standalone サービスが正常に動作しており、そのイメージがmilvusdb/milvus:v3.0.1 であること、および既存のコレクションに対して引き続きクエリや検索が可能であることを確認してください。v3.0.1 固有の機能を有効にする前に、これらの確認を完了してください。
