graphql-gateway

Apollo federation gateway wrapped in Docker image or AWS Lambda package.

Docker

You can start docker container directly:

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

Or using docker-compose:

version: '2'
services:
  graphql-gateway:
    image: 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: ...

Using graph-manager

You can connect gateway to graph-manager service.

Docker compose:

version: '3.4'
services:
  graphql-gateway:
    image: 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: graphql/graph-manager

See more details about integration on graph-manager repository https://github.com/graphql-services/graph-manager

Merging GraphQL API's running in AWS Lambda

Gateway can also call AWS Lambda functions directly, just provide url in this format:

GRAPHQL_URL_0=lambda://my-function-name/graphql[?version=my-version]
// specific version
GRAPHQL_URL_0=lambda://my-function-name/graphql?version=my-version

Autoupdating the schema

In case You want the schema to be updated automatically on regular basis, You can turn on autoupdates using following envvars:

# enable feature
GRAPHQL_UPDATE_GATEWAY=true
# specify interval for updating the schema
GRAPHQL_UPDATE_GATEWAY_INTERVAL_MS=60000

Apollo engine support

If you provide environment variable:

APOLLO_ENGINE_KEY=...

The gateway automatically starts with Engine proxy.

Prometheus metrics

This gateway automatically exports prometheus metrics on /metrics endpoint using apollo-metrics. You can disable this feature by settings environment variable PROMETHEUS_METRICS_ENABLED=false