跳到主要内容
版本：v3.0.x

在 Docker 中运行 Milvus（Linux）

本页说明如何在 Docker 中启动 Milvus 实例。

前提条件​

在 Docker 中安装 Milvus​

Milvus 提供了一个安装脚本，可将其安装为 Docker 容器。该脚本可在 Milvus repository 中获取。要在 Docker 中安装 Milvus，只需运行：

Shell
# Download the installation script
curl -sfL https://raw.githubusercontent.com/milvus-io/milvus/master/scripts/standalone_embed.sh -o standalone_embed.sh

# Start the Docker container
bash standalone_embed.sh start
说明

v3.0.0 中的新功能：

  • Streaming Node：增强的数据处理能力
  • Woodpecker MQ（默认）：此 Docker 部署使用 Woodpecker 作为消息队列，并使用 本地文件系统 作为其 WAL 后端，因此不需要外部消息队列服务。请参见 Woodpecker。
  • 优化架构：整合组件以提升性能

请始终下载最新脚本，以确保获得最新配置和架构改进。

如果你要在 standalone 部署模式下使用 Backup，建议使用 Docker Compose 部署方法。

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

运行安装脚本后：

  • 一个名为 milvus-standalone 的 Docker 容器已在 19530 端口启动。
  • 嵌入式 etcd 与 Milvus 安装在同一个容器中，服务端口为 2379。其配置文件映射到当前文件夹中的 embedEtcd.yaml。
  • 要更改 Milvus 的默认配置，请将你的设置添加到当前文件夹中的 user.yaml 文件，然后重启服务。
  • Milvus 数据卷映射到当前文件夹中的 volumes/milvus。

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

（可选）更新 Milvus 配置​

您可以修改当前文件夹下 user.yaml 文件中的 Milvus 配置。例如，要将 proxy.healthCheckTimeout 更改为 1000 ms，可按如下方式修改文件：

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

然后按如下步骤重启服务：

Shell
bash standalone_embed.sh restart

有关适用的配置项目，请参阅 系统配置。

升级 Milvus​

您可以使用内置的升级命令升级到最新版本的 Milvus。它会自动下载最新配置和 Milvus 镜像：

Shell
# Upgrade Milvus to the latest version
bash standalone_embed.sh upgrade
说明

升级命令会自动

  • 下载带有更新配置的最新安装脚本
  • 调用最新的 Milvus Docker 镜像
  • 使用新版本重启容器
  • 保留现有数据和配置

这是升级 Milvus Standalone 部署的推荐方法。

停止和删除 Milvus​

你可以按以下方式停止和删除该容器

Shell
# Stop Milvus
bash standalone_embed.sh stop

# Delete Milvus data
bash standalone_embed.sh delete

Optional dependencies​

默认情况下，此部署使用 Woodpecker （本地文件系统 WAL）作为消息队列，并使用 embedded etcd 存储 metadata，无需安装其他依赖。如需使用其他消息队列，或连接外部 Object Storage / metadata，请参阅：

Storage V3 默认处于禁用状态。使用依赖 Storage V3 的功能前，请先启用它。有关要求和兼容性注意事项，请参阅 Storage V3。

下一步​

在 Docker 中安装 Milvus 后，你可以