milvusdb/milvus-dev

Milvus 开发镜像概述

Milvus开发镜像是专为Milvus向量数据库开发与测试设计的环境镜像，集成完整开发工具链、依赖库及调试组件，旨在简化本地开发流程，降低环境配置复杂度。该镜像聚焦开发效率，包含源码编译、功能测试、文档生成等全流程工具，与生产镜像相比，额外提供代码调试与贡献支持。

核心功能与特性

• 完整开发工具链：预装Git、GCC、CMake、Go、Python等编译工具，支持Milvus源码全流程构建。
• 依赖预配置：集成Protobuf、etcd客户端、MinIO SDK等核心依赖库，无需手动安装。
• 调试与测试支持：包含GDB、Valgrind调试工具及单元测试框架，支持一键运行测试用例。
• 多版本兼容：通过标签（如latest、v2.4）对应不同Milvus开发分支，适配版本化开发需求。
• 贡献工具集成：内置代码格式化（clang-format）、文档生成（MkDocs）工具，符合社区贡献规范。

使用场景

• Milvus源码开发：本地开发者构建编译环境，实时修改并测试代码。
• 新功能验证：隔离环境中测试实验性功能，避免影响本地系统。
• 社区代码贡献：标准化开发环境，确保代码风格与官方一致，简化PR流程。
• 二次开发支持：基于Milvus源码定制功能时，提供稳定构建与测试环境。

使用方法与配置说明

前提条件

• Docker Engine 20.10+及Docker Compose（可选）
• 网络可访问Docker Hub或Milvus官方镜像仓库

镜像拉取

从官方仓库拉取镜像，标签对应开发分支：

bash
# 拉取最新开发镜像
docker pull docker.xuanyuan.run/milvusdb/milvus-dev:latest

# 拉取特定版本分支（如v2.4开发版）
docker pull docker.xuanyuan.run/milvusdb/milvus-dev:v2.4

启动开发容器

运行容器时建议挂载本地源码目录，实现代码同步：

bash
docker run -it --name milvus-dev-env \
  -v /本地/milvus源码路径:/milvus \
  -p 8080:8080 \  # 可选：映射服务端口（如需本地测试）
  -e DEV_MODE=1 \  # 启用开发模式（调试日志+工具）
  milvusdb/milvus-dev:latest

参数说明：

• -v /本地/milvus源码路径:/milvus：挂载本地源码至容器内开发目录
• -p 8080:8080：映射Milvus服务端口（仅测试运行服务时使用）
• -e DEV_MODE=1：开启开发模式，启用调试工具与详细日志

容器内开发流程

进入容器后执行标准开发操作：

bash
# 进入运行中的容器
docker exec -it milvus-dev-env bash

# 编译源码
cd /milvus && make build

# 运行单元测试
make test-unit

# 生成技术文档
make docs

环境变量配置

支持通过环境变量定制开发环境，常用变量如下：

数据卷持久化

为加速开发流程，建议持久化编译缓存：

bash
docker run -it --name milvus-dev-env \
  -v /本地/milvus源码:/milvus \
  -v milvus-build-cache:/milvus/cmake-build \  # 持久化编译缓存
  milvusdb/milvus-dev:latest

注意事项

• 开发镜像体积较大（约20GB+），需预留足够磁盘空间
• 仅用于开发测试，生产环境请使用Milvus官方生产镜像（milvusdb/milvus）
• 贡献代码前需通过make lint验证代码风格