使用 Helm 图表升级 Milvus Cluster

本指南描述了如何使用 Milvus Helm 图表升级 Milvus 集群。

检查 Milvus Helm 图表

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

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

Milvus Helm Charts 仓库 https://milvus-io.github.io/milvus-helm/ 已归档，你可以从 https://zilliztech.github.io/milvus-helm/ 获取进一步更新，操作如下：

helm repo add zilliztech https://zilliztech.github.io/milvus-helm
helm repo update
# 升级现有helm release
helm upgrade my-release zilliztech/milvus

归档的仓库仍可用于 4.0.31 版本的图表。对于更高版本，请使用新的仓库。

NAME                    CHART VERSION   APP VERSION             DESCRIPTION
zilliztech/milvus       4.1.29          2.4.0                   Milvus是一个开源的向量数据库，构建于...
zilliztech/milvus       4.1.24          2.3.11                  Milvus是一个开源的向量数据库，构建于...
zilliztech/milvus       4.1.23          2.3.10                  Milvus是一个开源的向量数据库，构建于...
zilliztech/milvus       4.1.22          2.3.10                  Milvus是一个开源的向量数据库，构建于...
zilliztech/milvus       4.1.21          2.3.10                  Milvus是一个开源的向量数据库，构建于...
zilliztech/milvus       4.1.20          2.3.10                  Milvus是一个开源的向量数据库，构建于...
zilliztech/milvus       4.1.18          2.3.10                  Milvus是一个开源的向量数据库，构建于...
zilliztech/milvus       4.1.18          2.3.9                   Milvus是一个开源的向量数据库，构建于...
zilliztech/milvus       4.1.17          2.3.8                   Milvus是一个开源的向量数据库，构建于...
zilliztech/milvus       4.1.16          2.3.7                   Milvus是一个开源的向量数据库，构建于...
zilliztech/milvus       4.1.15          2.3.5                   Milvus是一个开源的向量数据库，构建于...
zilliztech/milvus       4.1.14          2.3.6                   Milvus是一个开源的向量数据库，构建于...
zilliztech/milvus       4.1.13          2.3.5                   Milvus是一个开源的向量数据库，构建于...
zilliztech/milvus       4.1.12          2.3.5                   Milvus是一个开源的向量数据库，构建于...
zilliztech/milvus       4.1.11          2.3.4                   Milvus是一个开源的向量数据库，构建于...
zilliztech/milvus       4.1.10          2.3.3                   Milvus是一个开源的向量数据库，构建于...
zilliztech/milvus       4.1.9           2.3.3                   Milvus是一个开源的向量数据库，构建于...
zilliztech/milvus       4.1.8           2.3.2                   Milvus是一个开源的向量数据库，构建于...
zilliztech/milvus       4.1.7           2.3.2                   Milvus是一个开源的向量数据库，构建于...
zilliztech/milvus       4.1.6           2.3.1                   Milvus是一个开源的向量数据库，构建于...
zilliztech/milvus       4.1.5           2.3.1                   Milvus是一个开源的向量数据库，构建于...
zilliztech/milvus       4.1.4           2.3.1                   Milvus是一个开源的向量数据库，构建于...
zilliztech/milvus       4.1.3           2.3.1                   Milvus是一个开源的向量数据库，构建于...
zilliztech/milvus       4.1.2           2.3.1                   Milvus是一个开源的向量数据库，构建于...
zilliztech/milvus       4.1.1           2.3.0                   Milvus是一个开源的向量数据库，构建于...
zilliztech/milvus       4.1.0           2.3.0                   Milvus是一个开源的向量数据库，构建于...

你可以选择以下方式升级 Milvus：

使用 Helm 升级 Milvus，从 v2.2.3 之前的较低版本升级到 v{{var.milvus_release_version}}。
迁移元数据，在从 Milvus v2.1.x 升级到 v{{var.milvus_release_version}}之前进行。

进行滚动升级

从 Milvus 2.2.3 版本开始，你可以配置 Milvus 协调者以活动-备用模式运行，并为它们启用滚动升级功能，以便在协调者升级期间 Milvus 能够响应传入的请求。在以前的版本中，升级期间需要删除然后重新创建协调者，这可能会引入服务的某些停机时间。

滚动升级要求协调者以活动-备用模式工作。你可以使用我们提供的脚本 (opens in a new tab) 配置协调者以活动-备用模式工作并启动滚动升级。

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

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

参数	描述	默认值	是否必须
`i`	Milvus 实例名称	`None`	是
`n`	Milvus 安装的命名空间	`default`	否
`t`	目标 Milvus 版本	`None`	是
`w`	新的 Milvus 镜像标签	`milvusdb/milvus:v2.2.3`	是
`o`	操作	`update`	否

一旦你确保了 Milvus 实例中的所有部署都处于正常状态，你可以运行以下命令将 Milvus 实例升级到{{var.milvus_release_version}}。

sh rollingUpdate.sh -n default -i my-release -o update -t {{var.milvus_release_version}} -w 'milvusdb/milvus:v{{var.milvus_release_tag}}'

脚本硬编码了部署的升级顺序，不能更改。
脚本使用 kubectl patch 更新部署，并使用 kubectl rollout status 监视它们的状态。
脚本使用 kubectl patch 更新部署的 app.kubernetes.io/version 标签为命令中 -t 标志后指定的一个。

使用 Helm 升级 Milvus

要从 2.2.3 之前的次要版本升级到最新版本，请运行以下命令：

helm repo update
helm upgrade my-release zilliztech/milvus --reuse-values --version={{var.milvus_helm_chart_version}} # 这里使用Helm图表版本

在上述命令中使用 Helm 图表版本。有关如何获取 Helm 图表版本的详细信息，请参阅检查 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. 检查运行中的 pod

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

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 中的主要变化是段索引的元数据结构。因此，在将 Milvus 从 v2.1.x 升级到 v2.2.0 时，你需要使用 Helm 迁移元数据。这里有一个脚本 (opens in a new tab)，你可以使用它安全地迁移你的元数据。

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

下表列出了你可以用来进行元数据迁移的操作。

参数	描述	默认值	是否必须
`i`	Milvus 实例名称	`None`	是
`n`	Milvus 安装的命名空间	`default`	否
`s`	源 Milvus 版本	`None`	是
`t`	目标 Milvus 版本	`None`	是
`r`	Milvus 元数据的根路径	`by-dev`	否
`w`	新的 Milvus 镜像标签	`milvusdb/milvus:v2.2.0`	否
`m`	元数据迁移镜像标签	`milvusdb/meta-migration:v2.2.0`	否
`o`	元数据迁移操作	`migrate`	否
`d`	迁移完成后是否删除迁移 pod	`false`	否
`c`	元数据迁移 pvc 使用的存储类	`默认存储类`	否
`e`	Milvus 使用的 etcd 端点	`与Milvus一起安装的etcd svc`	否

1. 迁移元数据

下载迁移脚本 (opens in a new tab)。
停止 Milvus 组件。Milvus etcd 中的任何活动会话都可能导致迁移失败。
为 Milvus 元数据创建备份。
迁移 Milvus 元数据。
使用新镜像启动 Milvus 组件。

2. 将 Milvus 从 v2.1.x 升级到{{var.milvus_release_version}}

以下命令假设你将 Milvus 从 v2.1.4 版本升级至{{var.milvus_release_version}}版本。根据你的需求修改版本号。

指定 Milvus 实例名称、源 Milvus 版本和目标 Milvus 版本。
```
./migrate.sh -i my-release -s 2.1.4 -t {{var.milvus_release_version}}
```
如果你的 Milvus 没有安装在默认的 K8s 命名空间中，请使用 -n 指定命名空间。
```
./migrate.sh -i my-release -n milvus -s 2.1.4 -t {{var.milvus_release_version}}
```
如果你的 Milvus 是使用自定义的 rootpath 安装的，请使用 -r 指定根路径。
```
./migrate.sh -i my-release -n milvus -s 2.1.4 -t {{var.milvus_release_version}} -r by-dev
```

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

./migrate.sh -i my-release -n milvus -s 2.1.4 -t {{var.milvus_release_version}} -r by-dev -w milvusdb/milvus:v{{var.milvus_release_tag}}

如果想在迁移完成后自动删除迁移 Pod，请设置 -d true。

./migrate.sh -i my-release -n milvus -s 2.1.4 -t {{var.milvus_release_version}} -w milvusdb/milvus:v{{var.milvus_release_tag}} -d true

如果迁移失败，可以回滚后再次迁移。

./migrate.sh -i my-release -n milvus -s 2.1.4 -t {{var.milvus_release_version}} -r by-dev -o rollback -w milvusdb/milvus:v2.1.1
./migrate.sh -i my-release -n milvus -s 2.1.4 -t {{var.milvus_release_version}} -r by-dev -o migrate -w milvusdb/milvus:v{{var.milvus_release_tag}}

升级 Milvus 集群 Docker(Upgrade_milvus_cluster-docker)升级 Milvus 集群操作员(Upgrade_milvus_cluster-operator)