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

MilvusOperator、Helm、DockerCompose

使用 Docker Compose 升级 Milvus Standalone

本指南介绍了如何使用 Docker Compose 将您的 Milvus Standalone 部署从 v2.5.x 升级到 v2.6.19。

开始之前​

v2.6.19 的新功能​

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

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

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

系统要求​

系统要求：

  • 已安装 Docker 和 Docker Compose
  • 通过 Docker Compose 部署的 Milvus Standalone 实例

兼容性要求：

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

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

出于安全考虑，Milvus 将在 v2.6.19 版本发布时将其 MinIO 升级至 RELEASE.2024-12-18T13-15-44Z。

升级流程​

步骤 1：升级至 v2.5.16​

说明

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

  1. 编辑现有的docker-compose.yaml 文件，并将 Milvus 镜像标签更新为 v2.5.16：

    ...
    standalone:
      container_name: milvus-standalone
      image: milvusdb/milvus:v2.5.16
    ...

  2. 应用升级至 v2.5.16：

    docker compose down
    docker compose up -d

  3. 验证 v2.5.16 升级：

    docker compose ps

步骤 2：升级至 v2.6.19​

一旦 v2.5.16 成功运行，请升级至 v2.6.19：

  1. 编辑现有的docker-compose.yaml 文件，并将 Milvus 和 MinIO 的镜像标签均更新为 v2.6.19：

    ...
    minio:
      container_name: milvus-minio
      image: minio/minio:RELEASE.2024-12-18T13-15-44Z

    ...
    standalone:
      container_name: milvus-standalone
      image: milvusdb/milvus:v2.6.19

  2. 应用最终升级：

    docker compose down
    docker compose up -d

验证升级​

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

# Check container status
docker compose ps

# Check Milvus version
docker compose logs standalone | grep "version"

下一步​