使用 Docker Compose 升级 Milvus Standalone

本指南介绍了如何使用 Docker Compose 将您的 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 架构概述》。

系统要求

系统要求：

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

兼容性要求：

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

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

升级流程

步骤 1：升级至 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.22

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

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

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

2. 应用最终升级：

   docker compose down
   docker compose up -d
   

验证升级

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

# Check container status
docker compose ps

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

下一步

• 您可能还想了解如何：
  • 扩展 Milvus 集群
• 如果您已准备好在云端部署集群：
  • 了解如何使用 Terraform 在 Amazon EKS 上部署 Milvus
  • 了解如何使用 Kubernetes 在 GCP 上部署 Milvus 集群
  • 了解如何使用 Kubernetes 在 Microsoft Azure 上部署 Milvus