一、准备工作
1.1 环境要求
- 操作系统:Ubuntu 20.04/Debian 11/CentOS 7+
- 硬件配置:至少8GB内存,4核CPU,50GB磁盘空间
- 网络要求:可访问互联网(用于拉取Docker镜像)
1.2 安装Docker和Docker Compose
1.2.1 安装Docker
sudo apt-get update
sudo apt-get install -y docker.io
sudo systemctl start docker
sudo systemctl enable docker
1.2.2 验证Docker安装
docker --version
sudo docker run hello-world
1.2.3 安装Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
1.2.4 验证Docker Compose安装
docker-compose --version
二、部署Milvus数据库
2.1 创建部署目录
mkdir -p /opt/milvus
cd /opt/milvus
2.2 下载官方Docker Compose配置文件
wget https://github.com/milvus-io/milvus/releases/download/v2.5.10/milvus-standalone-docker-compose.yml -O docker-compose.yml
2.3 启动Milvus服务
sudo docker-compose up -d
2.4 验证Milvus服务状态
sudo docker-compose ps
正常输出应显示三个容器(milvus-etcd、milvus-minio、milvus-standalone)均为"Up"状态
2.5 查看Milvus日志
sudo docker-compose logs -f milvus-standalone
2.6 测试Milvus端口连通性
nc -zv localhost 19530
三、部署Attu可视化管理工具
3.1 使用Docker启动Attu
docker run -d --name milvus-attu \-p 8000:3000 \-e MILVUS_URL=localhost:19530 \zilliz/attu:v2.5
3.2 验证Attu容器状态
docker ps | grep attu
四、访问与使用
4.1 访问Attu管理界面
打开浏览器访问:
http://服务器IP:8000
4.2 连接Milvus数据库
- 在登录页面输入Milvus服务地址:
http://服务器IP:19530
- 点击"连接"按钮(默认无需用户名密码)
4.3 基本操作指南
- 创建数据库:点击"创建数据库",输入名称即可
- 创建集合:设置集合名称、向量维度和索引类型
- 导入数据:支持JSON/CSV文件批量导入
- 向量搜索:输入查询向量,设置搜索参数执行相似性搜索
五、常用操作命令
5.1 停止Milvus服务
cd /opt/milvus sudo docker-compose down
5.2 启动Milvus服务
cd /opt/milvus sudo docker-compose up -d
5.3 重启Attu服务
docker restart milvus-attu
5.4 查看Milvus数据目录
ls -la /opt/milvus/volumes
六、注意事项
6.1 版本兼容性
- Attu版本需与Milvus版本匹配,例如Attu v2.5对应Milvus 2.5.x
- 查看Milvus版本:
docker images | grep milvusdb/milvus
6.2 国内镜像源配置
若拉取镜像缓慢,可配置Docker国内镜像源:
sudo tee /etc/docker/daemon.json <<-'EOF'
{"registry-mirrors": ["https://docker.mirrors.ustc.edu.cn"]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker
6.3 防火墙设置
开放必要端口:
sudo ufw allow 19530/tcp
sudo ufw allow 8000/tcp
sudo ufw reload
6.4 数据备份
定期备份Milvus数据目录:
cp -r /opt/milvus/volumes /opt/milvus/volumes_backup_$(date +%Y%m%d)
七、问题排查
7.1 Milvus启动失败
检查系统资源是否充足:
free -h df -h
7.2 Attu无法连接Milvus
检查网络连通性:
telnet 服务器IP 19530
7.3 查看详细日志
sudo docker-compose logs --tail=100 milvus-standalone
docker logs milvus-attu
八、总结
通过Docker Compose方式部署Milvus和Attu是最简单高效的方法,适合开发测试和中小型生产环境。本文详细介绍了从环境准备到服务部署的完整流程,包括常用操作命令和问题排查方法。如有进一步需求,可参考Milvus官方文档进行分布式部署或高级配置。