使用 Milvus Operator 升级 Milvus 群集
本指南介绍如何使用 Milvus Operator 升级 Milvus 群集。
升级您的 Milvus 操作符
运行以下命令将您的 Milvus 操作符版本升级到 v1.0.1。
helm repo add zilliztech-milvus-operator https://zilliztech.github.io/milvus-operator/
helm repo update zilliztech-milvus-operator
helm -n milvus-operator upgrade milvus-operator zilliztech-milvus-operator/milvus-operator
将您的 Milvus 操作符升级到最新版本后,您有以下选择:
- 要将 Milvus 从 v2.2.3 或更高版本升级到 2.4.17,您可以进行滚动升级。
- 要将 Milvus 从 v2.2.3 之前的次版本升级到 2.4.17,建议你通过更改映像版本来升级 Milvus。
- 要将 Milvus 从 v2.1.x 升级到 2.4.17,需要在实际升级前迁移元数据。
进行滚动升级
自 Milvus 2.2.3 版起,你可以将 Milvus 协调器配置为主动待机模式,并为它们启用滚动升级功能,这样 Milvus 就能在协调器升级期间响应传入的请求。在以前的版本中,升级时需要移除协调器,然后再创建协调器,这可能会导致服务出现一定的停机时间。
基于 Kubernetes 提供的滚动更新功能,Milvus 操作符会根据部署的依赖关系强制执行有序更新。此外,Milvus 还实施了一种机制,确保其组件在升级期间与依赖于它们的组件保持兼容,从而大大减少了潜在的服务停机时间。
滚动升级功能默认为禁用。你需要通过配置文件明确启用它。
apiVersion: milvus.io/v1beta1
kind: Milvus
metadata:
name: my-release
spec:
components:
enableRollingUpdate: true
imageUpdateMode: rollingUpgrade # Default value, can be omitted
image: milvusdb/milvus:v2.4.17
在上述配置文件中,将spec.components.enableRollingUpdate
设置为true
,将spec.components.image
设置为所需的 Milvus 版本。
默认情况下,Milvus 会以有序方式对协调器执行滚动升级,即逐个替换协调器 pod 映像。要缩短升级时间,可以考虑将spec.components.imageUpdateMode
设置为all
,这样 Milvus 就会同时替换所有 pod 映像。
apiVersion: milvus.io/v1beta1
kind: Milvus
metadata:
name: my-release
spec:
components:
enableRollingUpdate: true
imageUpdateMode: all
image: milvusdb/milvus:v2.4.17
可以将spec.components.imageUpdateMode
设置为rollingDowngrade
,让 Milvus 用较低的版本替换协调器 pod 映像。
apiVersion: milvus.io/v1beta1
kind: Milvus
metadata:
name: my-release
spec:
components:
enableRollingUpdate: true
imageUpdateMode: rollingDowngrade
image: milvusdb/milvus:<some-old-version>
然后将配置保存为 YAML 文件(例如milvusupgrade.yml
),并将此配置文件修补到 Milvus 实例中,如下所示:
kubectl patch -f milvusupgrade.yml
通过更改映像升级 Milvus
在正常情况下,你可以通过更改映像将你的 Milvus 升级到最新版本。但要注意的是,用这种方法升级 Milvus 时会有一定的停机时间。
编写如下配置文件,并将其保存为milvusupgrade.yaml:
apiVersion: milvus.io/v1beta1
kind: Milvus
metadata:
name: my-release
spec:
# Omit other fields ...
components:
image: milvusdb/milvus:v2.4.17
然后运行以下命令执行升级:
kubectl patch -f milvusupgrade.yaml
迁移元数据
自 Milvus 2.2.0 起,元数据与以前版本的元数据不兼容。以下示例片段假定从 Milvus 2.1.4 升级到 Milvus 2.4.17。
1.创建用于元数据迁移的.yaml
文件
创建元数据迁移文件。下面是一个示例。需要在配置文件中指定name
、sourceVersion
和targetVersion
。下面的示例将name
设置为my-release-upgrade
,将sourceVersion
设置为v2.1.4
,将targetVersion
设置为v2.4.17
。这意味着您的 Milvus 群集将从 v2.1.4 升级到 v2.4.17。
apiVersion: milvus.io/v1beta1
kind: MilvusUpgrade
metadata:
name: my-release-upgrade
spec:
milvus:
namespace: default
name: my-release
sourceVersion: "v2.1.4"
targetVersion: "v2.4.17"
# below are some omit default values:
# targetImage: "milvusdb/milvus:v2.4.17"
# toolImage: "milvusdb/meta-migration:v2.2.0"
# operation: upgrade
# rollbackIfFailed: true
# backupPVC: ""
# maxRetry: 3
2.2. 应用新配置
运行以下命令创建新配置。
$ kubectl create -f https://github.com/zilliztech/milvus-operator/blob/main/config/samples/beta/milvusupgrade.yaml
3.3. 检查元数据迁移状态
运行以下命令检查元数据迁移的状态。
kubectl describe milvus release-name
输出中的状态为ready
意味着元数据迁移成功。
或者,也可以运行kubectl get pod
检查所有 pod。如果所有 pod 都是ready
,则元数据迁移成功。
4.删除my-release-upgrade
升级成功后,删除 YAML 文件中的my-release-upgrade
。