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 源码可在 GitHub 仓库 查看。

关于 Vald 项目

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

• ***网站
• GitHub 仓库

联系方式

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

• Slack 社区
• GitHub Issues

许可证

本产品基于 Apache License v2.0 许可协议，详情参见 LICENSE 文件。