跳到主要内容
版本：v2.6.x

使用 Helm Chart 升级 Milvus Standalone

本指南介绍如何使用 Helm Chart 将你的 Milvus Standalone 部署从 v2.5.x 升级至 v2.6.22。

开始之前​

v2.6.22 的新功能​

从 Milvus 2.5.x 升级到 2.6.22 涉及重大的架构变更：

  • 协调器整合：旧版中独立的协调器（dataCoord、queryCoord、indexCoord）已整合为单一 mixCoord
  • 新组件：引入流式处理节点（Streaming Node）以增强数据处理能力
  • 组件移除：已移除并整合 indexNode

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

系统要求​

系统要求：

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

兼容性要求：

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

消息队列限制：升级至 Milvus v2.6.22 时，你必须保留当前的消息队列选择。升级过程中不支持在不同的消息队列系统之间切换。未来版本将支持更改消息队列系统。

说明

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

升级流程​

步骤 1：升级 Helm Chart​

首先，将您的 Milvus Helm Chart 升级至 5.0.22 版本：

Shell
helm repo add zilliztech https://zilliztech.github.io/milvus-helm
helm repo update zilliztech
说明

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

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

Shell
helm search repo zilliztech/milvus --versions

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

步骤 2：升级至 v2.5.16​

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

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

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

等待升级完成：

Shell
# Verify all pods are ready
kubectl get pods

步骤 3：升级至 v2.6.22​

待 v2.5.16 成功运行后，请升级至 v2.6.22：

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

验证升级​

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

Shell
# Check pod status
kubectl get pods

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