graphql/gateway

graphql-gateway

这是一个基于Apollo Federation的网关镜像，也可作为AWS Lambda包使用，用于统一管理多个GraphQL API。

镜像概述

该镜像提供了轻量且可扩展的GraphQL网关能力，帮助用户聚合分散的GraphQL服务，简化客户端调用流程，同时支持多种扩展功能如自动更新Schema、监控指标导出等。

核心功能

• 支持Docker直接运行与docker-compose配置
• 可连接Graph Manager服务实现集中管理
• 直接调用AWS Lambda函数作为GraphQL数据源
• 自动更新Schema功能（可配置间隔）
• 集成Apollo Engine提升服务性能
• 默认导出Prometheus监控指标（可禁用）

使用场景

• 微服务架构下聚合多个GraphQL API，降低客户端复杂度
• 需要自动同步Schema变化的GraphQL服务场景
• 无服务器架构中集成AWS Lambda的GraphQL服务
• 需监控GraphQL服务性能指标的场景

配置说明

Docker直接运行示例

docker run --rm -p 8080:80 -e GRAPHQL_URL_0=https://api.graphloc.com/graphql docker.xuanyuan.run/graphql/gateway

Docker Compose配置示例

version: '2'
services:
  graphql-gateway:
    image: docker.xuanyuan.run/graphql/gateway
    links:
      - my-custom-service
    ports:
      - 8080:80
    environment:
      - GRAPHQL_URL_0=https://graphql-demo.azurewebsites.net/
      - GRAPHQL_URL_1=https://api.graphloc.com/graphql
      - GRAPHQL_URL_2=http://my-custom-service/graphql
      - GRAPHQL_UPDATE_GATEWAY=true
      - GRAPHQL_UPDATE_GATEWAY_INTERVAL_MS=60000
  my-custom-service:
    image: docker.xuanyuan.run/...

连接Graph Manager服务

version: '3.4'
services:
  graphql-gateway:
    image: docker.xuanyuan.run/graphql/gateway
    links:
      - graph-manager
    ports:
      - 8080:80
    environment:
      - GRAPH_MANAGER_URL=http://graph-manager/graphql
      - GRAPH_MANAGER_GATEWAY_ID=my-gateway-id
  graph-manager:
    image: docker.xuanyuan.run/graphql/graph-manager

更多集成细节请参考Graph Manager仓库：https://github.com/graphql-services/graph-manager

调用AWS Lambda函数

使用以下格式指定Lambda函数作为数据源：

GRAPHQL_URL_0=lambda://my-function-name/graphql[?version=my-version]
// 指定版本示例
GRAPHQL_URL_0=lambda://my-function-name/graphql?version=my-version

Schema自动更新配置

# 启用自动更新
GRAPHQL_UPDATE_GATEWAY=true
# 设置更新间隔（单位：毫秒）
GRAPHQL_UPDATE_GATEWAY_INTERVAL_MS=60000

Apollo Engine支持

APOLLO_ENGINE_KEY=你的Apollo Engine密钥

Prometheus指标控制

# 禁用Prometheus指标导出
PROMETHEUS_METRICS_ENABLED=false