vitess/vtgate Docker Image Overview

vitess/vtgate

自动构建

Vitess的查询路由组件，负责将客户端SQL请求路由至正确的MySQL分片，处理连接池与事务管理，为MySQL水平扩展提供请求转发与协调能力。

2 收藏0 次下载activevitess镜像

🚀专业版镜像服务，面向生产环境设计

中文简介版本下载

🚀专业版镜像服务，面向生产环境设计

vitess/vtgate 镜像文档

镜像概述和主要用途

vitess/vtgate 是 Vitess 数据库集群解决方案中的关键组件镜像，提供查询路由和负载均衡功能。Vitess 是一个开源的分布式 MySQL 集群管理系统，旨在解决大规模数据库部署的复杂性问题。

vtgate 作为 Vitess 架构中的查询入口点，负责接收客户端请求，解析 SQL，路由到适当的 vttablet 实例，并聚合结果返回给客户端，对应用程序隐藏数据库集群的复杂性。

核心功能和特性

查询路由：根据 SQL 语句和 Vitess 拓扑结构将查询路由到正确的数据库分片
负载均衡：在多个副本之间智能分发读请求
结果聚合：合并来自多个分片的查询结果
事务管理：支持跨分片事务协调
连接池：管理与底层数据库实例的连接
SQL 解析与重写：优化和转换 SQL 查询以适应分布式环境
故障转移：自动检测并处理数据库实例故障

使用场景和适用范围

大规模 MySQL 数据库集群的查询入口
需要水平扩展数据库容量的 Web 应用
读写分离的数据库架构
多租户数据库环境
需要跨分片事务支持的业务系统
希望简化数据库运维复杂度的企业级应用

使用方法和配置说明

基本使用方法

bash
docker run -d --name vtgate vitess/vtgate

常用配置参数

vtgate 主要通过命令行参数进行配置，常用参数包括：

--topo_implementation：拓扑服务实现类型（如 etcd, zk）
--topo_global_server_address：全局拓扑服务地址
--topo_global_root：全局拓扑服务根路径
--port：监听端口（默认 ***）
--grpc_port：gRPC 服务端口（默认 ***）
--mysql_server_port：MySQL 协议端口（默认 ***）
--cells：服务的单元格列表（逗号分隔）
--tablet_types_to_wait：启动前等待的 tablet 类型（如 "primary,replica"）
--health_check_interval：健康检查间隔（毫秒）
--queryserver-config-pool-size：连接池大小

Docker Compose 部署示例

yaml
version: '3'
services:
  vtgate:
    image: vitess/vtgate
    ports:
      - "***:***"   # HTTP 端口
      - "***:***"   # gRPC 端口
      - "***:***"   # MySQL 协议端口
    command: >
      --topo_implementation=etcd
      --topo_global_server_address=etcd:2379
      --topo_global_root=/vitess/global
      --cells=zone1
      --tablet_types_to_wait=primary,replica
      --health_check_interval=5000
    depends_on:
      - etcd
      - vtctld

  etcd:
    image: quay.io/coreos/etcd:v3.4.13
    command: etcd --listen-client-urls [***] --advertise-client-urls [***]

  vtctld:
    image: vitess/vtctld
    # vtctld 配置...