1. 准备工作
确保你的系统中已安装 Docker 和 Docker Compose。可以通过以下命令检查是否安装成功:
bash
复制
docker --version
docker-compose --version
如果尚未安装,请参考官方文档进行安装。
2. 创建 docker-compose.yml
文件
创建一个名为 docker-compose.yml
的文件,并添加以下内容:
yaml
复制
version: '3.8'
services:
qdrant:
image: qdrant/qdrant:latest
ports:
- "6333:6333" # gRPC API
- "6334:6334" # REST API
volumes:
- ./qdrant_storage:/qdrant/storage
environment:
QDRANT__CLUSTER__ENABLED: "false" # 如果不需要集群模式,可以设置为 false
-
image
指定了 Qdrant 的 Docker 镜像。 -
ports
映射了容器的端口到主机的端口,6333
用于 gRPC API,6334
用于 REST API。 -
volumes
挂载了一个本地目录到容器中,用于持久化数据。 -
environment
配置了 Qdrant 的集群模式,如果不需要集群,可以设置为false
。
3. 启动 Qdrant
在包含 docker-compose.yml
文件的目录中运行以下命令:
bash
复制
docker-compose up -d
-
-d
参数表示在后台运行容器。
4. 验证 Qdrant 是否运行
运行以下命令检查容器是否正常启动:
bash
复制
docker ps
你应该能看到一个名为 qdrant
的容器正在运行。
此外,可以通过访问 Qdrant 的 REST API 来验证其是否正常工作。例如,使用 curl
命令:
bash
复制
curl http://localhost:6333/healthz
如果返回 {"status": "ok"}
,则说明 Qdrant 已成功运行。
5. 访问 Qdrant Dashboard
Qdrant 提供了一个简单的 Web 界面,可以通过以下地址访问:
http://localhost:6333/dashboard
在这里,你可以查看集合、向量等信息。
6. 高级配置(可选)
如果你需要运行 Qdrant 集群,可以参考以下配置:
yaml
复制
version: '3.8'
services:
qdrant_node1:
image: qdrant/qdrant:v1.14.0
restart: always
volumes:
- ./qdrant_storage:/qdrant/storage
ports:
- "6333:6333"
- "6334:6334"
- "6335:6335"
environment:
QDRANT__CLUSTER__ENABLED: "true"
command: "./qdrant --uri http://10.0.0.6:6335"
qdrant_node2:
image: qdrant/qdrant:v1.14.0
ports:
- "6333:6333"
- "6334:6334"
- "6335:6335"
volumes:
- ./qdrant_storage:/qdrant/storage
environment:
QDRANT__CLUSTER__ENABLED: "true"
command: "./qdrant --bootstrap http://10.0.0.6:6335 --uri http://10.0.0.7:6335"
qdrant_node3:
image: qdrant/qdrant:v1.14.0
ports:
- "6333:6333"
- "6334:6334"
- "6335:6335"
volumes:
- ./qdrant_storage:/qdrant/storage
environment:
QDRANT__CLUSTER__ENABLED: "true"
command: "./qdrant --bootstrap http://10.0.0.6:6335 --uri http://10.0.0.9:6335"
此配置文件定义了三个 Qdrant 节点,分别运行在不同的机器上,通过 Raft 协议实现集群功能。
通过以上步骤,你可以在本地或集群环境中使用 Docker Compose 快速部署 Qdrant。
复制
重试
分享