跳到主要内容
Milvus OperatorHelm

使用 Helm Chart 升级 Milvus 集群

本指南描述了如何使用 Milvus Helm charts 升级您的 Milvus 集群。

先决条件​

  • Helm 版本 >= 3.14.0
  • Kubernetes 版本 >= 1.20.0

从 Milvus-Helm chart 版本 4.2.21 开始，我们引入了 pulsar-v3.x chart 作为依赖项。为了向后兼容，请将您的 helm 升级到 v3.14 或更高版本，并确保在使用 helm upgrade 时添加 --reset-then-reuse-values 选项。

检查 Milvus Helm Chart​

运行以下命令检查新的 Milvus 版本。

$ helm repo update zilliztech
$ helm search repo zilliztech/milvus --versions

位于 https://milvus-io.github.io/milvus-helm/ 的 Milvus Helm Charts 仓库已被归档，您可以从 https://zilliztech.github.io/milvus-helm/ 获取进一步的更新，如下所示：

helm repo add zilliztech https://zilliztech.github.io/milvus-helm
helm repo update
# upgrade existing helm release
helm upgrade my-release zilliztech/milvus --reset-then-reuse-values

归档的仓库仍可用于 4.0.31 版本以下的 charts。对于后续版本，请使用新仓库。

NAME                    CHART VERSION   APP VERSION             DESCRIPTION                                       
zilliztech/milvus       4.1.34          2.4.5                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.33          2.4.4                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.32          2.4.3                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.31          2.4.1                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.30          2.4.1                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.29          2.4.0                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.24          2.3.11                  Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.23          2.3.10                  Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.22          2.3.10                  Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.21          2.3.10                  Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.20          2.3.10                  Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.18          2.3.10                  Milvus is an open-source vector database built ... 
zilliztech/milvus       4.1.18          2.3.9                   Milvus is an open-source vector database built ...                                       
zilliztech/milvus       4.1.17          2.3.8                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.16          2.3.7                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.15          2.3.5                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.14          2.3.6                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.13          2.3.5                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.12          2.3.5                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.11          2.3.4                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.10          2.3.3                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.9           2.3.3                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.8           2.3.2                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.7           2.3.2                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.6           2.3.1                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.5           2.3.1                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.4           2.3.1                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.3           2.3.1                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.2           2.3.1                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.1           2.3.0                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.0           2.3.0                   Milvus is an open-source vector database built ...

您可以为 Milvus 选择以下升级路径：

- 从 Milvus v2.2.3 及更高版本到 v2.5.10 执行滚动升级。

执行滚动升级​

从 Milvus 2.2.3 开始，您可以配置 Milvus 协调器以主备模式工作，并为它们启用滚动升级功能，这样 Milvus 可以在协调器升级期间响应传入请求。在以前的版本中，协调器在升级期间需要被删除然后重新创建，这可能会导致服务的某些停机时间。

滚动升级要求协调器以主备模式工作。您可以使用我们提供的脚本来配置协调器以主备模式工作并开始滚动升级。

基于 Kubernetes 提供的滚动更新功能，上述脚本根据依赖关系强制执行部署的有序更新。此外，Milvus 实现了一种机制，确保其组件在升级期间与依赖它们的组件保持兼容，从而显着减少潜在的服务停机时间。

该脚本仅适用于使用 Helm 安装的 Milvus 的升级。下表列出了脚本中可用的命令标志。

参数描述默认值必需
iMilvus 实例名称NoneTrue
nMilvus 安装的命名空间defaultFalse
t目标 Milvus 版本NoneTrue
w新的 Milvus 镜像标签milvusdb/milvus:v2.2.3True
o操作updateFalse

确保 Milvus 实例中的所有部署都处于正常状态后，您可以运行以下命令将 Milvus 实例升级到 2.5.10。

sh rollingUpdate.sh -n default -i my-release -o update -t 2.5.10 -w 'milvusdb/milvus:v2.5.10'
  1. 该脚本硬编码了部署的升级顺序，无法更改。
  2. 该脚本使用 kubectl patch 更新部署，使用 kubectl rollout status 监视其状态。
  3. 该脚本使用 kubectl patch 将部署的 app.kubernetes.io/version 标签更新为命令中 -t 标志后指定的标签。

使用 Helm 升级 Milvus​

要将 Milvus 从 v2.2.3 之前的次要版本升级到最新版本，请运行以下命令：

helm repo update zilliztech
helm upgrade my-release zilliztech/milvus --reset-then-reuse-values --version=4.1.24 # use the helm chart version here

在前面的命令中使用 Helm chart 版本。有关如何获取 Helm chart 版本的详细信息，请参阅检查 Milvus 版本。

迁移元数据​

从 Milvus 2.2.0 开始，元数据与以前版本中的元数据不兼容。以下示例片段假设从 Milvus 2.1.4 升级到 Milvus 2.2.0。

1. 检查 Milvus 版本​

运行 $ helm list 检查您的 Milvus 应用版本。您可以看到 APP VERSION 是 2.1.4。

NAME             	NAMESPACE	REVISION	UPDATED                                	STATUS  	CHART        	APP VERSION    
new-release      	default  	1       	2022-11-21 15:41:25.51539 +0800 CST    	deployed	milvus-3.2.18	2.1.4

2. 检查运行的 pods​

运行 $ kubectl get pods 检查运行的 pods。您可以看到以下输出。

NAME                                             READY   STATUS      RESTARTS   AGE
my-release-etcd-0                               1/1     Running     0          21m
my-release-etcd-1                               1/1     Running     0          21m
my-release-etcd-2                               1/1     Running     0          21m
my-release-milvus-datacoord-664c58798d-fl75s    1/1     Running     0          21m
my-release-milvus-datanode-5f75686c55-xfg2r     1/1     Running     0          21m
my-release-milvus-indexcoord-5f98b97589-2l48r   1/1     Running     0          21m
my-release-milvus-indexnode-857b4ddf98-vmd75    1/1     Running     0          21m
my-release-milvus-proxy-6c548f787f-scspp        1/1     Running     0          21m
my-release-milvus-querycoord-c454f44cd-dwmwq    1/1     Running     0          21m
my-release-milvus-querynode-76bb4946d-lbrz6     1/1     Running     0          21m
my-release-milvus-rootcoord-7764c5b686-62msm    1/1     Running     0          21m
my-release-minio-0                              1/1     Running     0          21m
my-release-minio-1                              1/1     Running     0          21m
my-release-minio-2                              1/1     Running     0          21m
my-release-minio-3                              1/1     Running     0          21m
my-release-pulsar-bookie-0                      1/1     Running     0          21m
my-release-pulsar-bookie-1                      1/1     Running     0          21m
my-release-pulsar-bookie-2                      1/1     Running     0          21m
my-release-pulsar-bookie-init-tjxpj             0/1     Completed   0          21m
my-release-pulsar-broker-0                      1/1     Running     0          21m
my-release-pulsar-proxy-0                       1/1     Running     0          21m
my-release-pulsar-pulsar-init-c8vvc             0/1     Completed   0          21m
my-release-pulsar-recovery-0                    1/1     Running     0          21m
my-release-pulsar-zookeeper-0                   1/1     Running     0          21m
my-release-pulsar-zookeeper-1                   1/1     Running     0          20m
my-release-pulsar-zookeeper-2                   1/1     Running     0          20m

3. 检查镜像标签​

检查 pod my-release-milvus-proxy-6c548f787f-scspp 的镜像标签。您可以看到您的 Milvus 集群的版本是 v2.1.4。

$ kubectl get pods my-release-milvus-proxy-6c548f787f-scspp -o=jsonpath='{$.spec.containers[0].image}'
# milvusdb/milvus:v2.1.4

4. 迁移元数据​

Milvus 2.2 的一个主要变化是段索引的元数据结构。因此，您需要使用 Helm 在将 Milvus 从 v2.1.x 升级到 v2.2.0 时迁移元数据。这里有一个脚本供您安全地迁移您的元数据。

此脚本仅适用于安装在 K8s 集群上的 Milvus。如果在过程中发生错误，请先使用回滚操作回滚到以前的版本。

下表列出了您可以为元数据迁移执行的操作。

参数描述默认值必需
iMilvus 实例名称。NoneTrue
nMilvus 安装的命名空间。defaultFalse
s源 Milvus 版本。NoneTrue
t目标 Milvus 版本。NoneTrue
rMilvus 元数据的根路径。by-devFalse
w新的 Milvus 镜像标签。milvusdb/milvus:v2.2.0False
m元数据迁移镜像标签。milvusdb/meta-migration:v2.2.0False
o元数据迁移操作。migrateFalse
d迁移完成后是否删除迁移 pod。falseFalse
c元数据迁移 pvc 的存储类。默认存储类False
emilvus 使用的 etcd 端点。随 milvus 安装的 etcd svcFalse

1. 迁移元数据​

  1. 下载迁移脚本。
  2. 停止 Milvus 组件。Milvus etcd 中的任何活动会话都可能导致迁移失败。
  3. 为 Milvus 元数据创建备份。
  4. 迁移 Milvus 元数据。
  5. 使用新镜像启动 Milvus 组件。

2. 将 Milvus 从 v2.1.x 升级到 2.2.0​

以下命令假设您将 Milvus 从 v2.1.4 升级到 2.2.0。请根据您的需要更改它们为适合的版本。

  1. 指定 Milvus 实例名称、源 Milvus 版本和目标 Milvus 版本。

    ./migrate.sh -i my-release -s 2.1.4 -t 2.2.0

  2. 如果您的 Milvus 未安装在默认 K8s 命名空间中，请使用 -n 指定命名空间。

    ./migrate.sh -i my-release -n milvus -s 2.1.4 -t 2.2.0

  3. 如果您的 Milvus 是使用自定义 rootpath 安装的，请使用 -r 指定根路径。

    ./migrate.sh -i my-release -n milvus -s 2.1.4 -t 2.2.0 -r by-dev

  4. 如果您的 Milvus 是使用自定义 image 安装的，请使用 -w 指定镜像标签。

    ./migrate.sh -i my-release -n milvus -s 2.1.4 -t 2.2.0 -r by-dev -w milvusdb/milvus:v2.2.0

  5. 如果您希望在迁移完成后自动删除迁移 pod，请设置 -d true。

    ./migrate.sh -i my-release -n milvus -s 2.1.4 -t 2.2.0 -w milvusdb/milvus:v2.2.0 -d true

  6. 如果迁移失败，请回滚并重新迁移。

    ./migrate.sh -i my-release -n milvus -s 2.1.4 -t 2.2.0 -r by-dev -o rollback -w milvusdb/milvus:v2.1.4
    ./migrate.sh -i my-release -n milvus -s 2.1.4 -t 2.2.0 -r by-dev -o migrate -w milvusdb/milvus:v2.2.0