vdaas/vald-agent-ngt

vald-agent-ngt Docker镜像文档

镜像概述与主要用途

vald-agent-ngt 是 Vald 项目中 vald-agent-ngt 组件的 Docker 镜像。该镜像作为 Vald 向量搜索引擎的核心组件，主要负责以下功能：

• 存储与用户请求相关的索引数据
• 对请求向量执行最近邻搜索并返回结果

核心功能与特性

索引数据存储

• 支持多种存储目的地：
  • 内存（In-Memory）
  • 卷挂载（Volume Mounts）
  • 持久卷（Persistent Volume）
  • 外部存储（需配合 vald-agent-sidecar 组件，仅在 Kubernetes 集群中支持）

向量搜索能力

• 基于 NGT（Neighborhood Graph and Tree）算法实现高效的近似最近邻（ANN）搜索
• 支持对输入向量执行快速检索并返回匹配结果

系统需求

架构支持

使用场景与适用范围

vald-agent-ngt 适用于以下场景：

1. Vald 集群组件：作为 Vald 分布式向量搜索引擎集群的核心工作节点，参与大规模向量数据的分布式存储与搜索
2. Kubernetes 独立部署：在 Kubernetes 集群中独立运行，提供单节点向量搜索服务
3. Docker 独立部署：通过 Docker 直接运行，适用于开发、测试或小规模向量搜索场景

使用方法

1. 作为 Vald 集群组件

需配合 Vald 集群其他组件（如协调器、网关等）使用，具体部署流程参考 Vald 官方快速开始文档。

2. Kubernetes 独立部署

通过 Kubernetes 部署独立的 vald-agent-ngt 实例，参考 Kubernetes 独立部署教程。

3. Docker 独立部署

基本运行命令

bash
docker run -d \
  --name vald-agent-ngt \
  -p 8080:8080 \  # HTTP 端口
  -p 50051:50051 \  # gRPC 端口
  -v /path/to/local/data:/var/vald/data \  # 挂载数据存储目录
  -v /path/to/config.yaml:/etc/vald/agent.yaml \  # 挂载配置文件
  vdaas/vald-agent-ngt:latest

关键配置说明

• 数据存储：通过 -v 挂载宿主机目录至容器内 /var/vald/data，确保索引数据持久化
• 配置文件：需通过配置文件定义向量维度、索引参数（如构建参数、搜索参数）等核心配置，详细配置项参考 组件文档
• 端口映射：默认需暴露 HTTP（8080）和 gRPC（50051）端口，用于健康检查和服务调用

版本标签说明

配置参数说明

vald-agent-ngt 的核心配置通过配置文件（如 agent.yaml）定义，主要配置项包括：

• 向量维度：index.dimension，定义向量的维度大小（如 512、1024）
• 索引类型：index.type，指定 NGT 索引类型（如 hnsw、rand）
• 存储配置：storage.type，指定存储类型（memory、disk、external 等）
• 搜索参数：search.epsilon（搜索精度参数）、search.probe（探测点数量）等

详细配置参数及默认值参考 Vald 组件文档。

Dockerfile 参考

该镜像的 Dockerfile 源码可在 https://github.com/vdaas/vald/blob/main/dockers/agent/core/ngt/Dockerfile 查看。

关于 Vald 项目

Vald 是一个分布式高性能向量搜索引擎，专为大规模向量数据的高效存储和检索设计。更多信息请参考：

• 官方网站
• https://github.com/vdaas/vald

联系方式

如有问题或需求，可通过以下渠道获取支持：

• Slack 社区
• https://github.com/vdaas/vald/issues

许可证

本产品基于 Apache License v2.0 许可协议，详情参见 https://github.com/vdaas/vald/blob/main/LICENSE%E3%80%82