Milvus v2.5.xとPulsar v2の併用

Milvusでは、Milvus v2.5.xを動作させるためにPulsarをv3にアップグレードすることを推奨しています。詳細はPulsarのアップグレードをご参照ください。しかし、Milvus v2.5.xでPulsar v2を使用したい場合、この記事ではPulsar v2でMilvus v2.5.xを実行する手順をご案内します。

すでに稼働中のMilvusインスタンスがあり、v2.5.xにアップグレードしたいがPulsar v2は使い続けたいという場合は、このページの手順に従ってください。

Milvus v2.5.xをアップグレードしながらPulsar v2を使い続ける

このセクションでは、稼働中のMilvusインスタンスをMilvus v2.5.xにアップグレードしながらPulsar v2を使い続けるための手順をご紹介します。

Milvus Operatorユーザの方へ

Milvus OperatorはデフォルトでPulsar v2のアップグレードに対応しています。MilvusOperatorによるMilvusクラスタのアップグレードを参照し、Milvusインスタンスをv2.5.xにアップグレードすることができます。

アップグレードが完了したら、MilvusインスタンスでPulsar v2を使い続けることができます。

Helmユーザの場合

アップグレードの前に、以下を確認してください。

• Helmのバージョンがv3.12以上であることを確認してください。

  詳細については、Helmのインストールを参照してください。

• Kubernetesのバージョンがv1.20以上であること。

本記事の操作は以下を前提としています：

• Milvusがdefault ネームスペースにインストールされている。

• Milvusのリリース名はmy-release です。

Milvusをアップグレードする前に、values.yaml ファイルを変更し、Pulsarのバージョンをv2に指定する必要があります。手順は以下の通りです：

1. Milvusインスタンスの現在のvalues.yaml 。

   namespace=default
   release=my-release
   helm -n ${namespace} get values ${release} -o yaml > values.yaml
   cat values.yaml
   

2. values.yaml ファイルを編集し、Pulsarのバージョンをv2に指定します。

   # ... omit existing values
   pulsar:
     enabled: true
   pulsarv3:
     enabled: false
   image:
     all:
       repository: milvusdb/milvus
       tag: v2.5.0-beta 
   

   image の場合、tag を希望のMilvusバージョンに変更します（例:v2.5.0-beta ）。

3. Milvus Helmチャートを更新する。

   helm repo add milvus https://zilliztech.github.io/milvus-helm
   helm repo update milvus
   

4. Milvusインスタンスをアップグレードする。

   helm -n $namespace upgrade $releaase milvus/milvus -f values.yaml
   

Pulsar v2を使った新しいMilvusインスタンスの作成

このセクションでは、Pulsar v2で新しいMilvusインスタンスを作成する手順を説明します。

Milvus Operatorユーザの方へ

Milvus v2.5.xを展開する前に、Milvus Customer Resource Definition (CRD)ファイルをダウンロードし、編集する必要があります。Milvus Operatorを使用したMilvusのインストール方法の詳細については、Milvus Operatorを使用したMilvusクラスタのインストールを参照してください。

1. CRDファイルをダウンロードします。

   wget https://raw.githubusercontent.com/zilliztech/milvus-operator/main/config/samples/milvus_cluster_default.yaml
   

2. milvus_cluster_default.yaml ファイルを編集し、Pulsarのバージョンをv2に指定します。

   apiVersion: milvus.io/v1beta1
   kind: Milvus
   metadata:
     name: my-release
     namespace: default
     labels:
       app: milvus
   spec:
     mode: cluster
     dependencies:
       pulsar:
         inCluster:
           chartVersion: pulsar-v2
   

   dependencies の場合、pulsar.inCluster.chartVersion をpulsar-v2 に変更してください。

3. Install Milvus Cluster with Milvus Operatorの手順に進み、編集したCRDファイルを使用してMilvus v2.5.xとPulsar v2を展開します。

   kubectl apply -f milvus_cluster_default.yaml
   

Helmユーザの場合

Milvus v2.5.xをデプロイする前に、values.yaml ファイルを用意するか、インライン・パラメータを使用してPulsarのバージョンを指定してください。Helmを使用したMilvusのインストール方法については、「Helmを使用したMilvusクラスタのインストール」をご参照ください。

• インライン・パラメータを使用して、Pulsarのバージョンをv2に指定します。

  helm install my-release milvus/milvus --set pulsar.enabled=true,pulsarv3.enabled=false
  

• values.yaml 、Pulsarのバージョンをv2に指定します。

  pulsar:
    enabled: true
  pulsarv3:
    enabled: false
  

  その後、values.yaml ファイルを使用して、Milvus v2.5.xをPulsar v2と共にデプロイします。

  helm install my-release milvus/milvus -f values.yaml