【向量数据库 Milvus】linux 源码安装 Milvus 2.5.3

news2025/1/15 5:10:38

在 Linux 系统（如 ai 5.10.134-16.2.an8.x86_64）上通过源码安装 Milvus 2.5.3 的步骤如下。该指南适用于 x86_64 架构的系统。

1. 环境准备

确保系统满足以下要求：

操作系统: Linux（x86_64 架构）
Go: 1.21 或更高版本
CMake: 3.18 或更高版本
GCC: 7.5 或更高版本
Python: 3.7 或更高版本

安装必要的工具和依赖：

sudo yum update
sudo yum install -y git make cmake gcc gcc-c++ openblas-devel openssl-devel zlib-devel

2. 安装 Go

如果系统没有安装 Go，可以手动安装：

wget https://golang.google.cn/dl/go1.23.4.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.23.4.linux-amd64.tar.gz
export PATH=$PATH:/usr/local/go/bin

验证 Go 安装：

go version

3. 克隆 Milvus 源码

从 GitHub 克隆 Milvus 的源码：

git clone https://github.com/milvus-io/milvus.git
cd milvus
git checkout v2.5.3

4. 编译 Milvus

Milvus 依赖一些 C++ 库（如 Faiss、Knowhere），这些库会在编译过程中自动下载和编译。

4.1 编译

运行以下命令编译 Milvus：

make milvus

编译完成后，生成的二进制文件位于 bin 目录下。

5. 配置 Milvus

复制并修改配置文件：

cp configs/milvus.yaml.example configs/milvus.yaml

根据需要编辑 configs/milvus.yaml，调整存储路径、端口等配置。

6. 启动 Milvus

启动 Milvus 服务：

./bin/milvus run

服务启动后，默认监听端口为 19530。

7. 验证安装

使用 curl 或 Milvus SDK 验证服务是否正常运行：

curl http://localhost:19530/version

如果返回版本信息，说明安装成功。

8. 使用 Docker 部署（可选）

如果需要通过 Docker 部署，可以使用官方提供的 Docker 镜像：

docker pull milvusdb/milvus:v2.5.3
docker run -d --name milvus -p 19530:19530 milvusdb/milvus:v2.5.3

9. 使用 Helm 部署（可选）

如果需要通过 Helm 在 Kubernetes 上部署，可以使用以下命令：

helm repo add milvus https://milvus-io.github.io/milvus-helm/
helm install my-release milvus/milvus --version 2.5.3

10. 注意事项

依赖问题：
- 如果编译过程中遇到依赖问题，可以尝试手动安装缺失的依赖项。
- 例如，如果缺少 protobuf，可以手动安装：
```
sudo yum install -y protobuf-devel
```
性能调优：
- 根据硬件配置调整 milvus.yaml 中的参数，以获得最佳性能。
日志和监控：
- 日志文件默认位于 logs 目录下，可以通过日志排查问题。