Vald Agent Sidecar 镜像文档

镜像概述和主要用途

vald-agent-sidecar 是 Vald 集群中 vald-agent-sidecar 组件的 Docker 镜像。该镜像的核心用途是将索引元数据文件持久化存储到外部存储服务（如 Amazon S3 或 Google Cloud Storage），确保集群重启或故障后的数据可恢复性。

核心功能和特性

1. 备份功能

当 vald-agent 组件完成索引元数据文件创建后，sidecar 会自动将这些文件存储到配置的外部存储（Amazon S3 或 Google Cloud Storage）中，实现数据持久化。

2. 恢复功能

当 Vald Agent Pod 重启时，sidecar 会从外部存储的备份文件中恢复 vald-agent 的索引结构，确保服务重启后索引数据不丢失，保障集群连续性。

使用场景和适用范围

• 部署环境：作为 Vald 集群的核心组件，仅在 Kubernetes 集群中使用，不支持本地 Docker 环境。
• 依赖组件：需配合 vald-agent-ngt 镜像运行，并依赖外部存储服务（Amazon S3 或 Google Cloud Storage）。
• 核心价值：解决 Vald 集群中索引元数据的持久化问题，防止因 Pod 生命周期结束导致的数据丢失，适用于对数据可靠性要求高的向量检索场景。

环境要求

支持架构与依赖

快速开始

vald-agent-sidecar 需作为 Vald 集群的一部分部署，具体步骤如下：

1. 部署 Vald 集群

参考 Vald ***快速开始文档 部署完整的 Vald 集群环境。

2. 配置外部存储备份

通过 备份配置文档 启用外部存储集成，需配置以下关键信息：

• 外部存储类型（S3 或 GCS）
• 存储桶名称、访问凭证（如 S3 的 AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY，GCS 的服务账号密钥）
• 备份路径与频率（按需配置）

镜像版本说明

Dockerfile 源码

镜像构建文件参见 GitHub 仓库。

关于 Vald 项目

Vald 是一个分布式向量搜索引擎，专注于大规模向量数据的高效存储与检索。更多信息：

• ***网站
• GitHub 仓库

联系方式

• 社区支持：Vald Slack 频道
• 问题反馈：GitHub Issues

许可证

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