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

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

始める前に

v2.6.15の新機能

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

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

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

要件

システム要件

  • DockerおよびDocker Composeのインストール
  • Docker Compose経由でデプロイされたMilvusスタンドアロン

互換性要件

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

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

Milvusでは、セキュリティ上の問題から、v2.6.15のリリースに伴い、MinIOをRELEASE.2024-12-18T13-15-44Zにアップグレードしています。

アップグレード手順

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

スタンドアロン デプロイメントですでに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.15へのアップグレード

v2.5.16が正常に実行されたら、v2.6.15にアップグレードします:

  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.15
    
  2. 最終的なアップグレードを適用します:

    docker compose down
    docker compose up -d
    

アップグレードの確認

スタンドアロンで新しいバージョンが動作していることを確認します:

# Check container status
docker compose ps

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

次のステップ