跳到主要内容

使用 Docker Compose 升级 Milvus 独立部署版

本主题描述了如何使用 Docker Compose 升级您的 Milvus。

通常情况下，您可以通过更改其镜像来升级 Milvus。但是，在从 v2.1.x 升级到 最新版 之前，您需要迁移元数据。

由于安全原因，Milvus 在 v2.2.5 版本中将其 MinIO 升级到 RELEASE.2023-03-20T20-16-18Z。在从之前使用 Docker Compose 安装的 Milvus 独立部署版进行任何升级之前，您应创建一个单节点单驱动器的 MinIO 部署，并将现有的 MinIO 设置和内容迁移到新部署中。详情请参考此指南。

通过更改其镜像升级 Milvus​

通常情况下，您可以按以下步骤升级 Milvus：

  1. 在 docker-compose.yaml 中更改 Milvus 镜像标签。

    ...
    standalone:
      container_name: milvus-standalone
      image: milvusdb/milvus:v{{var.milvus_release_version}}

  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   # 指定您的 Milvus 版本
      targetVersion: {{var.milvus_release_version}}
      backupFilePath: /tmp/migration.bak
    metastore:
      type: etcd
    etcd:
      endpoints:
        - milvus-etcd:2379  # 使用 etcd 容器名称
      rootPath: by-dev # 数据存储在 etcd 中的根路径
      metaSubPath: meta
      kvSubPath: kv

  3. 运行迁移容器。

    # 假设您的 docker-compose 与默认的 milvus 网络一起运行，
    # 并且您将 migration.yaml 放在与 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 组件。

    // 仅在更新 docker-compose.yaml 中的 milvus 镜像标签后运行以下命令
    docker compose down
    docker compose up -d

下一步操作​