wirepas/gateway_sink_service

网关接收器服务Docker镜像

镜像概述

本Docker镜像用于快速部署和启动网关接收器服务。网关接收器服务作为网关系统的数据接收端点，负责接收来自网关层的网络流量、进行基础数据处理，并将处理后的流量转发至后端服务或存储系统，实现网关与后端组件的高效数据交互。

核心功能和特性

• 数据接收能力：支持通过HTTP、TCP等多种协议接收来自网关的数据流
• 基础数据处理：提供数据格式转换、简单过滤和字段提取等基础数据处理功能
• 流量转发：可配置将处理后的流量转发至指定的后端服务（如API服务、消息队列）或存储系统（如数据库、对象存储）
• 轻量级设计：镜像体积小，运行时资源占用低，适合在容器化环境中快速部署
• 灵活配置：支持通过环境变量或挂载配置文件自定义服务参数，适配不同场景需求

使用场景和适用范围

• 微服务架构：作为微服务网关的数据接收组件，处理并转发来自API网关的请求流量
• API网关配套：与各类API网关（如Kong、Spring Cloud Gateway）配合，实现网关流量的后端分发
• 日志/监控数据处理：接收来自网关的访问日志、监控指标等数据，转发至日志分析或监控系统
• 多源网关数据整合：在需要对接多个不同类型网关的场景中，统一接收和处理多源网关数据

使用方法和配置说明

基本使用（Docker Run）

通过以下命令启动网关接收器服务容器：

bash
docker run -d --name gateway-sink -p 8080:8080 your-registry/gateway-sink:latest

• -p 8080:8080：映射容器内服务端口（默认8080）到主机端口
• --name gateway-sink：指定容器名称为gateway-sink

环境变量配置

通过环境变量自定义服务配置，常用环境变量如下：

示例（指定后端服务地址和端口）：

bash
docker run -d --name gateway-sink \
  -p 8081:8080 \
  -e PORT=8080 \
  -e BACKEND_URL="http://backend-service:9000/api/data" \
  -e LOG_LEVEL="debug" \
  your-registry/gateway-sink:latest

Docker Compose配置

在docker-compose.yml中集成网关接收器服务：

yaml
version: '3.8'
services:
  gateway-sink:
    image: your-registry/gateway-sink:latest
    container_name: gateway-sink
    ports:
      - "8080:8080"
    environment:
      - PORT=8080
      - BACKEND_URL="http://backend-service:9000/api/data"
      - PROTOCOL="http"
      - LOG_LEVEL="info"
    restart: unless-stopped
    networks:
      - backend-network

networks:
  backend-network:
    driver: bridge

持久化和配置文件挂载

如需使用自定义配置文件（如复杂数据处理规则），可通过挂载配置文件目录实现：

bash
docker run -d --name gateway-sink \
  -p 8080:8080 \
  -v /host/path/to/config:/app/config \
  -e CONFIG_PATH="/app/config/custom.conf" \
  your-registry/gateway-sink:latest

• /host/path/to/config：主机上的自定义配置文件目录
• /app/config：容器内配置文件挂载路径
• CONFIG_PATH：指定服务加载的配置文件路径

注意事项

• BACKEND_URL为必填配置，需根据实际后端服务地址进行设置
• 不同协议（如Kafka、TCP）可能需要额外配置对应协议的连接参数（如Kafka的KAFKA_BOOTSTRAP_SERVERS）
• 生产环境建议通过restart: unless-stopped或容器编排平台确保服务高可用性