argoproj/gateway-http-transformer

镜像概述

主要用途

该镜像为一款网关转换器，核心功能是基于HTTP协议实现事件数据的接收、转换与分发。通过标准化的HTTP接口接收事件请求，对事件数据进行格式转换后，分发至指定的目标服务或系统，适用于事件驱动架构中的数据流转场景。

核心功能与特性

核心功能

• HTTP事件分发：采用HTTP协议作为事件传输标准，支持GET/POST等HTTP方法接收事件请求
• 事件数据转换：内置数据转换引擎，支持常见数据格式（如JSON、XML）的相互转换及字段映射
• 多目标分发：支持将转换后的事件数据同时分发至多个目标端点，满足复杂架构需求

特性

• 轻量级设计：基于精简运行时构建，镜像体积小，资源占用低
• 灵活配置：通过配置文件自定义转换规则与分发目标，无需修改代码
• 高兼容性：兼容标准HTTP协议，可与各类支持HTTP的服务或系统集成

使用场景与适用范围

典型使用场景

• 微服务事件通信：作为微服务架构中的事件枢纽，实现服务间事件的标准化转换与传递
• API网关数据处理：部署于API网关层，对接收到的外部请求数据进行格式转换后转发至内部服务
• 跨系统事件集成：在不同架构的系统间（如 legacy 系统与云服务）建立事件桥梁，解决数据格式差异问题

适用范围

• 事件驱动架构（EDA）系统
• 微服务架构中的事件总线
• 需要数据格式转换的API集成场景
• 第三方系统事件接入需求

使用方法与配置说明

基本运行命令

通过Docker命令直接启动镜像，默认监听8080端口：

bash
docker run -d -p 8080:8080 --name gateway-transformer [镜像名称]:[版本标签]

环境变量配置

支持通过环境变量自定义服务行为，常用配置项如下：

Docker Compose配置示例

通过docker-compose.yml实现持久化配置与服务编排：

yaml
version: '3.8'
services:
  gateway-transformer:
    image: docker.xuanyuan.run/[镜像名称]:[版本标签]
    container_name: gateway-transformer
    restart: always
    ports:
      - "8080:8080"
    environment:
      - PORT=8080
      - TRANSFORM_CONFIG=/app/config/transform.json
      - LOG_LEVEL=INFO
    volumes:
      - ./transform-config:/app/config  # 挂载本地转换规则配置目录
    networks:
      - event-bus-network

networks:
  event-bus-network:
    driver: bridge

转换规则配置示例

转换规则通过JSON配置文件定义，示例（transform.json）：

json
{
  "transformRules": [
    {
      "name": "order-event-transform",
      "inputType": "application/json",
      "outputType": "application/xml",
      "fieldMapping": {
        "orderId": "Order.ID",
        "amount": "Order.Amount",
        "timestamp": "Order.CreateTime"
      },
      "targetEndpoints": [
        "http://service-a:8080/events",
        "http://service-b:8080/webhook"
      ]
    }
  ]
}

验证服务可用性

服务启动后，可通过HTTP请求验证基本功能：

bash
# 发送测试事件
curl -X POST http://localhost:8080/events \
  -H "Content-Type: application/json" \
  -d '{"orderId": "ORD123", "amount": 99.99, "timestamp": "2024-01-01T00:00:00Z"}'

若配置正确，服务将返回200 OK并将转换后的事件分发至目标端点。