跳到主要内容

使用 Milvus Operator 升级 Milvus 集群

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

升级您的 Milvus Operator​

运行以下命令将您的 Milvus Operator 版本升级至 v2.4.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 Operator 到最新版本后，您有以下选择：

执行滚动升级​

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

基于 Kubernetes 提供的滚动更新功能，Milvus Operator 强制按照依赖关系对部署进行有序更新。此外，Milvus 实现了一种机制，确保其组件在升级期间与依赖于它们的组件保持兼容，大大减少潜在的服务停机时间。

滚动升级功能默认情况下是禁用的。您需要通过配置文件显式启用它。

apiVersion: milvus.io/v1beta1
kind: Milvus
metadata:
  name: my-release
spec:
  components:
    enableRollingUpdate: true
    imageUpdateMode: rollingUpgrade # 默认值，可以省略
    image: milvusdb/milvus:v2.4.1

在上述配置文件中，将 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.1

您可以将 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 apply -f milvusupgrade.yml

通过更改镜像升级 Milvus​

在正常情况下，您可以通过更改镜像将 Milvus 简单升级到最新版本。但是，请注意，以这种方式升级 Milvus 时会有一定的停机时间。

按以下方式组合配置文件并将其保存为 milvusupgrade.yaml：

apiVersion: milvus.io/v1beta1
kind: Milvus
metadata:
  name: my-release
spec:
  # 省略其他字段 ...
  components:
   image: milvusdb/milvus:v2.4.1

然后运行以下命令执行升级：

kubectl apply -f milvusupgrade.yaml

迁移元数据​

自 Milvus 2.2.0 版本开始，元数据与之前版本不兼容。以下示例代码片段假定从 Milvus 2.1.4 升级到 Milvus最新版本。

1. 创建用于元数据迁移的 .yaml 文件​

创建一个元数据迁移文件。以下是一个示例。您需要在配置文件中指定 name、sourceVersion 和 targetVersion。以下示例将 name 设置为 my-release-upgrade，sourceVersion 设置为 v2.1.4，targetVersion 设置为 v{{var.milvus_release_version}}。这意味着您的 Milvus 集群将从 v2.1.4 升级到 v2.4.1。

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.1"
  # 以下是一些省略的默认值:
  # targetImage: "milvusdb/milvus:v2.4.1"
  # toolImage: "milvusdb/meta-migration:v2.2.0"
  # operation: upgrade
  # rollbackIfFailed: true
  # backupPVC: ""
  # maxRetry: 3

2. 应用新配置​

运行以下命令应用新配置。

$ kubectl apply -f https://github.com/zilliztech/milvus-operator/blob/main/config/samples/beta/milvusupgrade.yaml

3. 检查元数据迁移状态​

运行以下命令检查元数据迁移的状态。

kubectl describe milvus release-name

输出中的 ready 状态表示元数据迁移成功。

或者，您也可以运行 kubectl get pod 来检查所有 pod。如果所有 pod 都是 ready，则元数据迁移成功。

4. 删除 my-release-upgrade​

升级成功后，在 YAML 文件中删除 my-release-upgrade。