trinodb/trino-gateway

Trino Gateway Docker镜像文档

概述

Trino Gateway Docker镜像是一个预配置的容器化解决方案，用于快速部署Trino Gateway服务。Trino Gateway是一个反向代理和负载均衡器，专门为Trino集群设计，提供请求路由、负载均衡、认证和授权等功能，帮助用户更有效地管理和扩展Trino集群。

核心功能和特性

• 负载均衡：在多个Trino集群或节点间分配查询请求，优化资源利用率
• 路由管理：基于用户、查询类型或其他条件将请求路由到特定Trino集群
• 高可用性：支持多实例部署，确保网关服务本身的高可用性
• 安全控制：集成认证和授权机制，保护Trino集群访问安全
• 监控集成：提供 metrics 接口，支持与监控系统集成
• 动态配置：支持动态更新配置，无需重启服务

使用场景和适用范围

• 管理多个Trino集群的统一访问入口
• 实现Trino集群的负载均衡和流量控制
• 为不同用户或应用程序提供隔离的Trino集群访问
• 需要对Trino集群访问进行认证和授权控制的场景
• 希望简化Trino客户端配置的环境

快速开始

基本使用

使用以下命令启动Trino Gateway容器：

bash
docker run -d -p 8080:8080 --name trino-gateway trinodb/trino-gateway

使用自定义配置

bash
docker run -d -p 8080:8080 \
  --name trino-gateway \
  -v /path/to/your/config.yml:/etc/trino-gateway/config.yml \
  trinodb/trino-gateway

Docker Compose示例

yaml
version: '3'
services:
  trino-gateway:
    image: trinodb/trino-gateway
    ports:
      - "8080:8080"
    volumes:
      - ./config.yml:/etc/trino-gateway/config.yml
    environment:
      - JAVA_OPTS=-Xmx1G
    restart: always

配置说明

配置文件

Trino Gateway使用YAML格式的配置文件，默认路径为/etc/trino-gateway/config.yml。主要配置项包括：

• http-server.http.port: HTTP服务端口
• gateway.coordinators: Trino协调器列表配置
• gateway.routing-policy: 路由策略配置
• gateway.authentication.type: 认证类型配置
• metrics.enabled: 指标收集开关

环境变量

支持以下环境变量配置：

• JAVA_OPTS: Java虚拟机选项，用于配置内存等JVM参数
• CONFIG_FILE: 配置文件路径，默认为/etc/trino-gateway/config.yml
• LOG_LEVEL: 日志级别，可选值：DEBUG, INFO, WARN, ERROR

详细使用方法

构建自定义镜像

如果需要基于官方镜像添加自定义配置，可以创建Dockerfile：

dockerfile
FROM trinodb/trino-gateway
COPY custom-config.yml /etc/trino-gateway/config.yml

然后构建并运行：

bash
docker build -t my-trino-gateway .
docker run -d -p 8080:8080 my-trino-gateway

健康检查

容器内置健康检查机制，可以通过Docker的健康检查功能监控服务状态：

bash
docker inspect --format='{{.State.Health.Status}}' trino-gateway

日志查看

查看容器日志：

bash
docker logs -f trino-gateway

持久化数据

Trino Gateway的配置和状态数据可以通过挂载卷实现持久化：

bash
docker run -d -p 8080:8080 \
  -v trino-gateway-config:/etc/trino-gateway \
  -v trino-gateway-data:/var/lib/trino-gateway \
  --name trino-gateway \
  trinodb/trino-gateway

高级配置

有关更详细的配置选项和高级用法，请参考官方文档：https://github.com/trinodb/trino-gateway/blob/main/docs/index.md