wirepas/gateway_transport_service

网关传输服务Docker镜像文档

镜像概述

该Docker镜像用于运行网关传输服务，是分布式系统中的关键通信组件。设计目标是提供高效、可靠的网络中间层，实现不同服务间的数据交互、协议适配和请求分发，简化分布式架构中的网络通信管理。

核心功能和特性

核心功能

• 多协议数据转发：支持TCP、UDP、HTTP、HTTPS、gRPC等多种网络协议的数据包转发
• 协议转换能力：提供跨协议通信支持，如HTTP与gRPC、TCP与UDP之间的双向转换
• 智能服务路由：基于预定义规则（路径、请求头、IP地址等）实现请求路由，支持多种负载均衡策略
• 流量控制：提供请求限流、超时控制和重试机制，保障服务稳定性

主要特性

• 高可用性：支持集群部署模式，具备自动故障检测和故障转移能力
• 灵活配置：支持通过环境变量快速配置基础参数，或通过配置文件实现复杂规则定义
• 轻量级设计：优化的镜像体积和资源占用，适合容器化部署环境
• 可观测性：内置日志记录和指标暴露功能，支持监控系统集成

使用场景和适用范围

典型使用场景

• 微服务API网关：作为微服务架构的统一入口，处理客户端请求并路由至相应后端服务
• 跨协议通信中间层：在使用不同网络协议的服务间建立通信桥梁（如 legacy 系统与现代微服务集成）
• 服务网格数据平面：作为服务网格架构中的数据平面组件，处理服务间的所有网络通信
• 多服务统一入口：为多个独立部署的服务提供单一访问点，简化客户端配置

适用范围

• 分布式微服务系统
• 跨平台、跨协议的服务集成场景
• 需要统一流量管理的企业级应用
• 云原生环境中的服务通信层

使用方法和配置说明

基本运行命令

使用以下命令启动基础网关服务容器：

bash
docker run -d \
  -p 8080:8080 \  # 映射网关监听端口
  --name gateway-transport \
  -e GATEWAY_PORT=8080 \  # 容器内监听端口
  -e LOG_LEVEL=info \     # 日志级别
  [镜像名称]:[标签]

Docker Compose 配置示例

创建 docker-compose.yml 文件实现编排部署：

yaml
version: '3.8'
services:
  gateway-transport:
    image: [镜像名称]:[标签]
    container_name: gateway-transport
    ports:
      - "8080:8080"  # HTTP/HTTPS端口
      - "50051:50051" # gRPC端口（如启用）
    environment:
      - GATEWAY_PORT=8080
      - LOG_LEVEL=info
      - ROUTE_RULES=/etc/gateway/routes.json  # 路由规则配置文件路径
      - PROTOCOL_MAP=http:8080,grpc:50051    # 协议-端口映射
    volumes:
      - ./config:/etc/gateway  # 挂载本地配置目录
      - ./logs:/var/log/gateway # 挂载日志目录
    restart: unless-stopped

配置参数说明

环境变量配置

路由规则配置文件示例

创建 routes.json 配置文件定义路由规则：

json
{
  "routes": [
    {
      "name": "service-a-route",
      "path": "/api/service-a/*",
      "target": "http://service-a:8080",
      "methods": ["GET", "POST"],
      "priority": 10
    },
    {
      "name": "grpc-service-route",
      "protocol": "grpc",
      "service": "com.example.GrpcService",
      "target": "grpc://grpc-service:50051"
    }
  ],
  "load_balancing": {
    "strategy": "round_robin",
    "health_check": {
      "enabled": true,
      "interval": 5
    }
  }
}

集群部署说明

为实现高可用，可部署多个网关实例并配合负载均衡器：

bash
# 启动多个实例
docker run -d -p 8081:8080 --name gateway-transport-1 [镜像名称]:[标签]
docker run -d -p 8082:8080 --name gateway-transport-2 [镜像名称]:[标签]
docker run -d -p 8083:8080 --name gateway-transport-3 [镜像名称]:[标签]

通过外部负载均衡器（如Nginx、云负载均衡服务）将流量分发至各实例，实现故障转移和负载分担。

日志与监控

• 日志查看：使用 docker logs gateway-transport 命令查看实时日志
• 日志持久化：通过挂载日志目录（如示例中的 -v ./logs:/var/log/gateway）实现日志持久化
• 监控集成：默认在 /metrics 路径暴露Prometheus格式指标，可集成Grafana进行监控可视化