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

使用 Docker Compose 运行 Milvus（Linux）

本页面介绍了如何使用 Docker Compose 在 Docker 中启动 Milvus 实例。

先决条件​

安装 Milvus​

Milvus 在其代码库中提供了一个 Docker Compose 配置文件。要使用 Docker Compose 安装 Milvus，只需运行

Shell
# Download the configuration file
wget https://github.com/milvus-io/milvus/releases/download/v2.6.22/milvus-standalone-docker-compose.yml -O docker-compose.yml

# Start Milvus
sudo docker compose up -d

Creating milvus-etcd  ... done
Creating milvus-minio ... done
Creating milvus-standalone ... done
说明

v2.6.22 版本更新内容：

  • 架构增强：新增 Streaming Node 并优化了各项组件
  • 依赖项更新：包含最新版本的 MinIO 和 etcd
  • 配置改进：优化了配置以提升性能

请始终下载最新的 Docker Compose 配置文件，以确保与 v2.6.22 功能兼容。

  • 如果上述命令执行失败，请检查你的系统是否安装了 Docker Compose V1。如果是，鉴于 本页 的说明，建议你迁移至 Docker Compose V2。

  • 如果在拉取镜像时遇到问题，请通过 community@zilliz.com 联系我们并提供问题详情，我们将为你提供支持。

启动 Milvus 后，

  • 名为 milvus-standalone、milvus-minio 和 milvus-etcd 的容器已启动。
  • milvus-etcd 容器不会向主机暴露任何端口，并将其数据映射到当前文件夹中的 volumes/etcd。
  • milvus-minio 容器使用默认身份验证凭据在本地提供 9090 和 9091 端口服务，并将其数据映射到当前文件夹中的 volumes/minio。
  • milvus-standalone 容器使用默认设置在本地提供 19530 端口服务，并将其数据映射到当前文件夹中的 volumes/milvus。

你可以使用以下命令检查容器是否已启动并正在运行：

Text
$ sudo docker-compose ps

      Name                     Command                  State                            Ports
--------------------------------------------------------------------------------------------------------------------
milvus-etcd         etcd -advertise-client-url ...   Up             2379/tcp, 2380/tcp
milvus-minio        /usr/bin/docker-entrypoint ...   Up (healthy)   9000/tcp
milvus-standalone   /tini -- milvus run standalone   Up             0.0.0.0:19530->19530/tcp, 0.0.0.0:9091->9091/tcp

你还可以访问 http://127.0.0.1:9091/webui/ 上的 Milvus WebUI，以了解有关你的 Milvus 实例的更多信息。有关详细信息，请参阅 Milvus WebUI。

（可选）更新 Milvus 配置​

若要根据您的需求更新 Milvus 配置，您需要修改 milvus-standalone 容器中的 /milvus/configs/user.yaml 文件。

  1. 访问 milvus-standalone 容器。

    Shell
    docker exec -it milvus-standalone bash

  2. 添加额外配置以覆盖默认设置。 下文假设您需要覆盖默认的 proxy.healthCheckTimeout。有关适用的配置项，请参阅 系统配置。

    Shell
    cat << EOF > /milvus/configs/user.yaml
    # Extra config to override default milvus.yaml
    proxy:
      healthCheckTimeout: 1000 # ms, the interval that to do component healthy check
    EOF

  3. 重启 milvus-standalone 容器以应用更改。

    Shell
    docker restart milvus-standalone

停止并删除 Milvus​

您可以按以下步骤停止并删除此容器

Shell
# Stop Milvus
sudo docker compose down

# Delete service data
sudo rm -rf volumes

下一步​

在 Docker 中安装 Milvus 后，您可以：