使用 Helm Chart 升级 Milvus 单机版
本指南介绍如何使用 Helm Chart 将 Milvus 单机版从 v2.5.x 升级到 v2.6.15。
开始之前
版本 2.6.15 的新功能
从 Milvus 2.5.x 升级到 2.6.15 涉及重大的架构变化:
- 协调器合并:传统的独立协调器 (
dataCoord,queryCoord,indexCoord) 已合并为单一的协调器。mixCoord - 新组件:引入流节点,增强数据处理能力
- 删除组件:删除并合并
indexNode
此升级过程可确保向新架构的正常迁移。有关架构变化的更多信息,请参阅Milvus 架构概述。
系统要求
系统要求
- Helm 版本 >= 3.14.0
- Kubernetes 版本 >= 1.20.0
- 通过 Helm 图表部署 Milvus Standalone
兼容性要求:
- Milvus v2.6.0-rc1 与 v2.6.15不兼容。不支持从候选版本直接升级。
- 如果您当前正在运行 v2.6.0-rc1,并需要保留数据,请参考本社区指南以获得迁移帮助。
- 在升级到 v2.6.15 之前,您必须升级到 v2.5.16 或更高版本。
消息队列限制:升级到 Milvus v2.6.15 时,您必须保持当前的消息队列选择。不支持在升级过程中在不同的消息队列系统之间切换。未来版本将支持更换消息队列系统。
自 Milvus Helm 图表 4.2.21 版起,我们引入了 pulsar-v3.x 图表作为依赖。为了向后兼容,请将 Helm 升级到 v3.14 或更高版本,并确保在使用
helm upgrade 时添加--reset-then-reuse-values 选项。升级过程
步骤 1:升级 Helm 图表
首先,将您的 Milvus Helm 图表升级到 5.0.0 版本:
helm repo add zilliztech https://zilliztech.github.io/milvus-helm
helm repo update zilliztech
位于
https://milvus-io.github.io/milvus-helm/ 的 Milvus Helm 图表 repo 已归档。对于 4.0.31 及更高版本的图表,请使用新版本库https://zilliztech.github.io/milvus-helm/ 。要检查 Helm 图表版本与 Milvus 版本的兼容性:
helm search repo zilliztech/milvus --versions
本指南假定您安装的是最新版本。如果需要安装特定版本,请相应指定--version 参数。
第 2 步:升级到版本 2.5.16
如果你的单机部署已经运行 v2.5.16 或更高版本,请跳过此步骤。
将 Milvus 单机版升级到 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:升级到 v2.6.15
v2.5.16 成功运行后,升级到 v2.6.15:
helm upgrade my-release zilliztech/milvus \
--set image.all.tag="v2.6.15" \
--reset-then-reuse-values \
--version=5.0.0
验证升级
确认您的独立部署正在运行新版本:
# Check pod status
kubectl get pods