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

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

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

Milvusのイメージ変更によるアップグレード

通常の場合、以下の手順でMilvusをアップグレードすることができます：

1. Milvus のイメージタグをdocker-compose.yaml で変更する。

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

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

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.4.17
     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をデプロイする方法を学ぶ