使用 Helm Chart 升级 Milvus Standalone

本指南介绍了如何使用 Helm 图将您的 Milvus Standalone 部署从 v2.5.x 升级到 v3.0-beta。

开始之前

v3.0-beta 的新功能

从 Milvus 2.5.x 升级到 3.0-beta 涉及重大的架构变更:

  • 协调器整合:旧版中独立的协调器(dataCoordqueryCoordindexCoord )已整合为单一mixCoord
  • 新组件:引入流式处理节点(Streaming Node)以增强数据处理能力
  • 组件移除:已移除并整合indexNode

此升级流程可确保顺利迁移至新架构。有关架构变更的更多信息,请参阅《Milvus 架构概述》。

系统要求

系统要求:

  • Helm 版本 >= 3.14.0
  • Kubernetes 版本 >= 1.20.0
  • 通过 Helm Chart 部署的 Milvus Standalone 实例

兼容性要求:

  • Milvus v2.6.0-rc1 与 v3.0-beta不兼容。不支持从候选版本直接升级。
  • 如果您当前正在运行 v2.6.0-rc1 且需要保留数据,请参考此社区指南获取迁移帮助。
  • 在升级至 v3.0-beta 之前,您必须先升级至 v2.5.16 或更高版本。

消息队列限制:升级至 Milvus v3.0-beta 时,您必须保留当前的消息队列选择。升级过程中不支持在不同的消息队列系统之间切换。未来版本将支持更改消息队列系统。

自 Milvus Helm 图表版本 4.2.21 起,我们引入了 pulsar-v3.x 图表作为依赖项。为确保向后兼容性,请将您的 Helm 升级至 v3.14 或更高版本,并且在每次使用 `helm upgrade` 时,请务必添加 `--reset-then-reuse-values ` 选项。

升级流程

步骤 1:升级 Helm Chart

首先,将您的 Milvus Helm 图表升级至 5.0.22 版本:

helm repo add zilliztech https://zilliztech.github.io/milvus-helm
helm repo update zilliztech
位于https://milvus-io.github.io/milvus-helm/ 的 Milvus Helm Charts 仓库现已归档。请使用新仓库https://zilliztech.github.io/milvus-helm/ 获取 4.0.31 及更高版本的图表。

要检查 Helm Chart 版本与 Milvus 版本的兼容性:

helm search repo zilliztech/milvus --versions

本指南假设您正在安装最新版本。如果您需要安装特定版本,请相应地指定--version 参数。

步骤 2:升级至 v2.5.16

如果您的独立部署环境已运行 v2.5.16 或更高版本,请跳过此步骤。

将您的 Milvus Standalone 升级至 v2.5.16:

helm upgrade my-release zilliztech/milvus \
  --set image.all.tag="v2.5.16" \
  --reset-then-reuse-values \
  --version=4.2.58

等待升级完成:

# Verify all pods are ready
kubectl get pods

步骤 3:升级至 v3.0-beta

待 v2.5.16 成功运行后,请升级至 v3.0-beta:

helm upgrade my-release zilliztech/milvus \
  --set image.all.tag="v3.0-beta" \
  --reset-then-reuse-values \
  --version=5.0.22

验证升级

确认您的独立部署已运行新版本:

# Check pod status
kubectl get pods

如需更多支持,请查阅Milvus 文档社区论坛

想要更快、更简单、更好用的 Milvus SaaS服务 ?

Zilliz Cloud是基于Milvus的全托管向量数据库,拥有更高性能,更易扩展,以及卓越性价比

免费试用 Zilliz Cloud
反馈

此页对您是否有帮助?