vdaas/vald-mirror-gateway

Vald Mirror Gateway Docker镜像文档

镜像概述和主要用途

vald-mirror-gateway镜像是Vald项目中vald-mirror-gateway组件的Docker镜像。作为Vald分布式向量搜索引擎的核心组件之一，该镜像主要用于实现向量数据的跨集群镜像、同步与管理，确保分布式环境下数据的一致性与可用性。

核心功能和特性

• 跨集群数据镜像：支持将向量数据从一个Vald集群镜像到另一个集群，实现数据冗余与备份。
• 实时数据同步：提供近实时的向量数据同步能力，保障多集群间数据一致性。
• 灵活的同步策略：可配置同步频率、数据过滤规则，适配不同业务场景需求。
• 高可用性设计：支持故障自动恢复，确保镜像服务持续稳定运行。
• 轻量级部署：基于容器化设计，可快速集成到现有Vald集群架构中。

使用场景和适用范围

• 多集群部署架构：适用于跨地域、跨数据中心的Vald集群部署，实现数据异地多活。
• 数据备份与灾备：作为向量数据的备份通道，支持故障场景下的快速数据恢复。
• 大规模向量数据管理：在需要处理海量向量数据（如图像特征、文本嵌入）的场景中，提供高效的数据分发能力。
• 混合云/多云环境：支持私有云与公有云之间的向量数据同步，满足混合云架构需求。

系统需求

支持架构

• linux/amd64

  • 建议Docker版本：20.10+
  • 内核版本：4.19+
  • 网络要求：集群间网络互通，支持TCP/UDP协议

• linux/arm64

  • 建议Docker版本：20.10+
  • 内核版本：5.4+
  • 网络要求：集群间网络互通，支持TCP/UDP协议

快速开始

基本部署（Docker Run）

bash
docker run -d \
  --name vald-mirror-gateway \
  --network vald-network \
  -p 8080:8080 \
  -e LOG_LEVEL=info \
  -e TARGET_CLUSTER_ADDR=vald-cluster-1:8081 \
  -e SOURCE_CLUSTER_ADDR=vald-cluster-2:8081 \
  vdaas/vald-mirror-gateway:latest

Docker Compose示例

yaml
version: "3.8"
services:
  vald-mirror-gateway:
    image: vdaas/vald-mirror-gateway:latest
    container_name: vald-mirror-gateway
    ports:
      - "8080:8080"
    environment:
      - LOG_LEVEL=info
      - TARGET_CLUSTER_ADDR=vald-target:8081
      - SOURCE_CLUSTER_ADDR=vald-source:8081
      - SYNC_INTERVAL=5s
      - MAX_RETRY=3
    networks:
      - vald-network

networks:
  vald-network:
    driver: bridge

配置说明

环境变量配置

版本信息

镜像版本遵循Vald项目版本号规则，标签格式如下：

• latest：最新稳定版
• vX.Y.Z：特定版本（如v1.8.0）
• vX.Y.Z-[commit-hash]：包含特定提交的开发版本

注：版本详细说明及更新日志请参考https://github.com/vdaas/vald/releases%E3%80%82

Dockerfile

[建设中] 关于镜像构建的详细信息，请参考Vald项目源码中的https://github.com/vdaas/vald/tree/main/docker/vald-mirror-gateway%E3%80%82

关于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