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

MilvusOperatorHelmDockerCompose

使用 Docker Compose 升级 Milvus 单机版

本主题介绍如何使用 Docker Compose 升级 Milvus。

在正常情况下，你可以通过更改映像来升级 Milvus。不过，在从 v2.1.x 升级到 v2.5.27 之前，你需要迁移元数据。

出于安全考虑，Milvus 在发布 v2.2.5 时将其 MinIO 升级为 RELEASE.2023-03-20T20-16-18Z。在使用 Docker Compose 从以前安装的 Milvus Standalone 版本升级之前，应创建一个 Single-Node Single-Drive MinIO 部署，并将现有 MinIO 设置和内容迁移到新部署。有关详细信息，请参阅本指南。

通过更改映像升级 Milvus​

在正常情况下，可以按以下方法升级 Milvus：

  1. 在docker-compose.yaml 中更改 Milvus 映像标记。

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

  2. 运行以下命令执行升级。

    docker compose down
    docker compose up -d

迁移元数据​

  1. 停止所有 Milvus 组件。

    docker stop <milvus-component-docker-container-name>

  2. 为元迁移准备配置文件migration.yaml 。

    # migration.yaml
    cmd:
      # Option: run/backup/rollback
      type: run
      runWithBackup: true
    config:
      sourceVersion: 2.1.4   # Specify your milvus version
      targetVersion: 2.5.27
      backupFilePath: /tmp/migration.bak
    metastore:
      type: etcd
    etcd:
      endpoints:
        - milvus-etcd:2379  # Use the etcd container name
      rootPath: by-dev # The root path where data is stored in etcd
      metaSubPath: meta
      kvSubPath: kv

  3. 运行迁移容器。

    # Suppose your docker-compose run with the default milvus network,
    # and you put migration.yaml in the same directory with docker-compose.yaml.
    docker run --rm -it --network milvus -v $(pwd)/migration.yaml:/milvus/configs/migration.yaml milvusdb/meta-migration:v2.2.0 /milvus/bin/meta-migration -config=/milvus/configs/migration.yaml

  4. 使用新的 Milvus 映像重新启动 Milvus 组件。

    // Run the following only after update the milvus image tag in the docker-compose.yaml
    docker compose down
    docker compose up -d

下一步​