hansehe/graphql-gateway

GraphQL Gateway

![Artifact HUB]([***]

• https://github.com/hansehe/graphql-gateway

镜像概述和主要用途

GraphQL Gateway是一个基于GraphQL联邦规范实现的网关服务，用于整合多个后端GraphQL服务，提供统一的API访问入口。它遵循Apollo GraphQL联邦规范，可将多个独立的GraphQL服务组合为一个统一的GraphQL API。

相关GraphQL联邦演示项目：

• https://github.com/apollographql/federation-demo

核心功能和特性

• 支持整合多个后端GraphQL服务
• 遵循Apollo GraphQL联邦规范
• 提供GraphQL Playground界面，便于API调试
• 轻量级部署，支持Docker和Kubernetes环境

使用场景和适用范围

• 微服务架构中需要统一GraphQL接口的场景
• 多团队协作开发独立GraphQL服务时的整合需求
• 需要为前端提供单一GraphQL API入口的应用

使用方法和配置说明

Docker运行

通过Docker快速启动GraphQL Gateway，需指定后端GraphQL服务的URL：

bash
docker run --rm -p 8181:80 -e GRAPHQL_URL_0=http://first-graphql-service/graphql -e GRAPHQL_URL_1=http://second-graphql-service/graphql hansehe/graphql-gateway

启动后可通过以下地址访问GraphQL Playground：

• http://localhost:8181/graphql/

环境变量说明：

• GRAPHQL_URL_0：第一个后端GraphQL服务的URL
• GRAPHQL_URL_1：第二个后端GraphQL服务的URL（可根据需要添加更多，如GRAPHQL_URL_2、GRAPHQL_URL_3等）

Helm仓库安装

在Kubernetes环境中通过Helm部署：

1. 添加Helm仓库：

bash
helm repo add graphql-gateway https://raw.githubusercontent.com/hansehe/graphql-gateway/master/helm/charts
helm repo update

2. 安装Chart：

bash
helm install graphql-gateway \
--set environmentVariables.GRAPHQL_URL_0=http://service_1/graphql \
--set environmentVariables.GRAPHQL_URL_1=http://service_2/graphql \
graphql-gateway/graphql-gateway

开发环境搭建

bash
# 前置依赖：docker/docker-compose/node/python
# 安装DockerBuildManagement工具：[***]
pip install --upgrade DockerBuildManagement

# 启动开发环境
dbm -swarm -start

# 构建、测试并运行服务
dbm -build -test -run service

# 访问以下地址：
# GraphQL网关（整合后端0和1的联邦模式）：http://localhost:8181/graphql/
# 后端GraphQL服务0：http://localhost:5001/graphql/
# 后端GraphQL服务1：http://localhost:5002/graphql/

# 停止开发环境
dbm -swarm -stop