安装仅需 CPU 的 Milvus

安装前提

操作系统要求

操作系统 版本
CentOS 7.5 或以上
Ubuntu LTS 18.04 或以上
Windows Windows 10 64-bit:Pro,Enterprise,或 Education 版(Build 15063 或以上)
MacOS 10.13 或以上

硬件要求

组件 建议配置
CPU Intel CPU Haswell 或以上
内存 8 GB 或以上 (取决于具体向量数据规模)
硬盘 SATA 3.0 SSD 或以上

Milvus Docker 要求

  • 如果使用 Ubuntu 或 CentOS 安装 Milvus,请在您的宿主机上 安装 Docker 19.03或更高版本。
  • 如果在 Windows 上安装 Milvus,请安装 Docker Desktop,并进入 Settings -> Advanced 调整相关配置。请确保‘可用内存’大于您在 server_config.yaml 文件中设置的insert_buffer_sizecpu_cache_capacity 之和。
  • 如果在 MacOS 上安装 Milvus,请安装Docker Desktop for Mac,并进入 Preferences -> Advanced 调整相关配置。请确保‘可用内存’大于您在 server_config.yaml 文件中设置的insert_buffer_sizecpu_cache_capacity 之和。

在 Ubuntu/CentOS 上安装 Milvus

第一步 确认 Docker 状态

确认 Docker daemon 正在运行:

  1. $ docker info

如果无法正常打印 Docker 相关信息,请启动 Docker daemon.

提示:在 Linux 上,Docker 命令前面需加 sudo。若要在没有 sudo 情况下运行 Docker 命令,请创建 docker 组并添加用户。更多详情,请参阅 Linux 安装后步骤

第二步 拉取 Milvus 镜像

拉取仅需 CPU 的镜像:

  1. $ docker pull milvusdb/milvus:0.8.0-cpu-d041520-464400

注意:如果您在拉取镜像时速度过慢或一直失败,请参考操作常见问题中提供的解决办法。

第三步 下载配置文件

  1. # Create Milvus file
  2. $ mkdir -p /home/$USER/milvus/conf
  3. $ cd /home/$USER/milvus/conf
  4. $ wget https://raw.githubusercontent.com/milvus-io/milvus/v0.8.0/core/conf/demo/server_config.yaml
  5. $ wget https://raw.githubusercontent.com/milvus-io/milvus/v0.8.0/core/conf/demo/log_config.conf

注意:万一您遇到无法通过 wget 命令正常下载配置文件的情况,您也可以在 /home/$USER/milvus/conf 路径下创建 server_config.yamllog_config.conf 文件,然后复制粘贴 server config 文件log config 文件的内容。

第四步 启动 Milvus Docker 容器

  1. # Start Milvus
  2. $ docker run -d --name milvus_cpu \
  3. -p 19530:19530 \
  4. -p 19121:19121 \
  5. -p 9091:9091 \
  6. -v /home/$USER/milvus/db:/var/lib/milvus/db \
  7. -v /home/$USER/milvus/conf:/var/lib/milvus/conf \
  8. -v /home/$USER/milvus/logs:/var/lib/milvus/logs \
  9. -v /home/$USER/milvus/wal:/var/lib/milvus/wal \
  10. milvusdb/milvus:0.8.0-cpu-d041520-464400

上述命令中用到的 docker run 参数定义如下:

  • -d: 运行 container 到后台并打印 container id。
  • --name: 为 container 分配一个名字。
  • -p: 暴露 container 端口到 host。
  • -v: 将路径挂载至 container。

最后,确认 Milvus 运行状态:

  1. # Confirm Milvus status
  2. $ docker ps

如果 Milvus 服务没有正常启动,您可以执行以下命令查询错误日志。

  1. # Get id of the container running Milvus
  2. $ docker ps -a
  3. # Check docker logs
  4. $ docker logs <milvus container id>

在 Windows 上安装 Milvus

在 Windows 上安装 Milvus 的步骤和在 Ubuntu/CentOS 上几乎一样,只不过 第三步第四步 略有不同。

在第三步中,不同于使用 wget 来获取配置文件,使用 Windows 安装时,建议在 C 盘,或其它合适的位置创建 milvus 文件夹,下面包含 dbconflogswal 等文件夹,然后分别复制 server config 文件log config 文件的内容到您在 C:\milvus\conf 路径下创建的server_config.yamllog_config.conf 文件中。

第四步,启动 Docker 容器,将 Milvus 文件映射到您本地的文件路径。下面的命令是在命令提示符中运行的:

  1. # Start Milvus
  2. $ docker run -d --name milvus_cpu ^
  3. -p 19530:19530 ^
  4. -p 19121:19121 ^
  5. -p 9091:9091 ^
  6. -v C:\milvus\db:/var/lib/milvus/db ^
  7. -v C:\milvus\conf:/var/lib/milvus/conf ^
  8. -v C:\milvus\logs:/var/lib/milvus/logs ^
  9. -v C:\milvus\wal:/var/lib/milvus/wal ^
  10. milvusdb/milvus:0.8.0-cpu-d041520-464400

在 MacOS 上安装 Milvus

在 Windows 上安装 Milvus 的步骤和在 Ubuntu/CentOS 上几乎一样,只不过 第三步第四步 略有不同。

第三步,安装路径有细微差别:

  1. # Create Milvus file
  2. $ mkdir -p /Users/$USER/milvus/conf
  3. $ cd /Users/$USER/milvus/conf
  4. $ wget https://raw.githubusercontent.com/milvus-io/milvus/v0.8.0/core/conf/demo/server_config.yaml
  5. $ wget https://raw.githubusercontent.com/milvus-io/milvus/v0.8.0/core/conf/demo/log_config.conf

第四步,启动 Docker 容器,将 Milvus 文件映射到您本地的文件路径:

  1. # Start Milvus
  2. $ docker run -d --name milvus_cpu \
  3. -p 19530:19530 \
  4. -p 19121:19121 \
  5. -p 9091:9091 \
  6. -v /home/$USER/milvus/db:/var/lib/milvus/db \
  7. -v /home/$USER/milvus/conf:/var/lib/milvus/conf \
  8. -v /home/$USER/milvus/logs:/var/lib/milvus/logs \
  9. -v /home/$USER/milvus/wal:/var/lib/milvus/wal \
  10. milvusdb/milvus:0.8.0-cpu-d041520-464400

接下来您可以