Docker Compose を使用した Milvus スタンドアロンのアップグレード

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

開始する前に

v2.6.24の新機能

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

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

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

要件

システム要件：

• Docker および Docker Compose がインストールされていること
• Docker Compose 経由で Milvus スタンドアロンがデプロイされていること

互換性に関する要件：

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

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

アップグレード手順

ステップ 1: v2.5.16 へのアップグレード

1. 既存のdocker-compose.yaml ファイルを編集し、Milvusイメージのタグをv2.5.16に更新してください:

   ...
   standalone:
     container_name: milvus-standalone
     image: milvusdb/milvus:v2.5.16
   ...
   

2. v2.5.16へのアップグレードを適用します:

   docker compose down
   docker compose up -d
   

3. v2.5.16へのアップグレードを確認します:

   docker compose ps
   

ステップ 2: v2.6.24 へのアップグレード

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

1. 既存の `docker-compose.yaml ` ファイルを編集し、Milvus と MinIO の両方のイメージタグを更新してください:

   ...
   minio:
     container_name: milvus-minio
     image: minio/minio:RELEASE.2024-12-18T13-15-44Z
   
   ...
   standalone:
     container_name: milvus-standalone
     image: milvusdb/milvus:v2.6.24
   

2. 最終的なアップグレードを適用します:

   docker compose down
   docker compose up -d
   

アップグレードの確認

スタンドアロン展開が新しいバージョンで実行されていることを確認してください:

# Check container status
docker compose ps

# Check Milvus version
docker compose logs standalone | grep "version"

次の手順

• 以下の操作方法についても確認することをお勧めします:
  • Milvusクラスターのスケーリング
• クラウド上でクラスターをデプロイする準備ができている場合は：
  • Terraform を使用して Amazon EKS に Milvus をデプロイする方法
  • Kubernetes を使用して GCP に Milvus クラスターをデプロイする方法
  • Kubernetes を使用して Microsoft Azure に Milvus をデプロイする方法