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

このトピックでは、Docker Compose を使用して Milvus をアップグレードする方法について説明します。

通常、Milvusはイメージを変更することでアップグレードできます。ただし、v2.1.x から v2.6.24 へのアップグレードを行う前には、メタデータの移行を行う必要があります。

イメージを変更してMilvusをアップグレードする

通常の場合、Milvusは次のようにアップグレードできます:

1. docker-compose.yaml 内の Milvus イメージタグを変更します。

   プロキシ、すべてのコーディネーター、およびすべてのワーカーノードのイメージタグを変更する必要がある点に注意してください。

   ...
   rootcoord:
     container_name: milvus-rootcoord
     image: milvusdb/milvus:v2.6.24
   ...
   proxy:
     container_name: milvus-proxy
     image: milvusdb/milvus:v2.6.24
   ...
   querycoord:
     container_name: milvus-querycoord
     image: milvusdb/milvus:v2.6.24  
   ...
   querynode:
     container_name: milvus-querynode
     image: milvusdb/milvus:v2.6.24
   ...
   indexcoord:
     container_name: milvus-indexcoord
     image: milvusdb/milvus:v2.6.24
   ...
   indexnode:
     container_name: milvus-indexnode
     image: milvusdb/milvus:v2.6.24 
   ...
   datacoord:
     container_name: milvus-datacoord
     image: milvusdb/milvus:v2.6.24   
   ...
   datanode:
     container_name: milvus-datanode
     image: milvusdb/milvus:v2.6.24
   

2. 以下のコマンドを実行してアップグレードを行います。

   docker compose down
   docker compose up -d
   

メタデータの移行

1. すべての Milvus コンポーネントを停止します。

   docker stop <milvus-component-docker-container-name>
   

2. メタデータの移行用に、設定ファイルmigrate.yaml を準備します。

   # migration.yaml
   cmd:
     # Option: run/backup/rollback
     type: run
     runWithBackup: true
   config:
     sourceVersion: 2.1.4   # Specify your milvus version
     targetVersion: 2.6.24
     backupFilePath: /tmp/migration.bak
   metastore:
     type: etcd
   etcd:
     endpoints:
       - milvus-etcd:2379  # Use the etcd container name
     rootPath: by-dev # The root path where data is stored in etcd
     metaSubPath: meta
     kvSubPath: kv
   

3. 移行コンテナを実行します。

   # Suppose your docker-compose run with the default milvus network,
   # and you put migration.yaml in the same directory with docker-compose.yaml.
   docker run --rm -it --network milvus -v $(pwd)/migration.yaml:/milvus/configs/migration.yaml milvus/meta-migration:v2.2.0 /milvus/bin/meta-migration -config=/milvus/configs/migration.yaml
   

4. 新しい Milvus イメージを使用して、Milvus コンポーネントを再起動します。

   Update the milvus image tag in the docker-compose.yaml
   docker compose down
   docker compose up -d
   

次の手順

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