This is the AWS Lambda integration of GraphQL Server. Apollo Server is a community-maintained open-source GraphQL server that works with many Node.js HTTP server frameworks. Read the docs. Read the CHANGELOG.

1npm install apollo-server-lambda graphql

Deploying with AWS Serverless Application Model (SAM)

To deploy the AWS Lambda function we must create a Cloudformation Template and a S3 bucket to store the artifact (zip of source code) and template. We will use the AWS Command Line Interface.

1. Write the API handlers

In a file named graphql.js, place the following code:

1const { ApolloServer, gql } = require('apollo-server-lambda');
2
3// Construct a schema, using GraphQL schema language
4const typeDefs = gql`
5  type Query {
6    hello: String
7  }
8`;
9
10// Provide resolver functions for your schema fields
11const resolvers = {
12  Query: {
13    hello: () => 'Hello world!',
14  },
15};
16
17const server = new ApolloServer({
18  typeDefs,
19  resolvers,
20  
21  // By default, the GraphQL Playground interface and GraphQL introspection
22  // is disabled in "production" (i.e. when `process.env.NODE_ENV` is `production`).
23  //
24  // If you'd like to have GraphQL Playground and introspection enabled in production,
25  // the `playground` and `introspection` options must be set explicitly to `true`.
26  playground: true,
27  introspection: true,
28});
29
30exports.handler = server.createHandler();

2. Create an S3 bucket

The bucket name must be universally unique.

1aws s3 mb s3://<bucket name>

3. Create the Template

This will look for a file called graphql.js with the export graphqlHandler. It creates one API endpoints:

• /graphql (GET and POST)

In a file called template.yaml:

1AWSTemplateFormatVersion: '2010-09-09'
2Transform: AWS::Serverless-2016-10-31
3Resources:
4  GraphQL:
5    Type: AWS::Serverless::Function
6    Properties:
7      Handler: graphql.handler
8      Runtime: nodejs12.x
9      Events:
10        AnyRequest:
11          Type: Api
12          Properties:
13            Path: /graphql
14            Method: ANY

4. Package source code and dependencies

This will read and transform the template, created in previous step. Package and upload the artifact to the S3 bucket and generate another template for the deployment.

1aws cloudformation package \
2  --template-file template.yaml \
3  --output-template-file serverless-output.yaml \
4  --s3-bucket <bucket-name>

5. Deploy the API

This will create the Lambda Function and API Gateway for GraphQL. We use the stack-name prod to mean production but any stack name can be used.

aws cloudformation deploy \
  --template-file serverless-output.yaml \
  --stack-name prod \
  --capabilities CAPABILITY_IAM

Getting request info

To read information about the current request from the API Gateway event (HTTP headers, HTTP method, body, path, ...) or the current Lambda Context (Function Name, Function Version, awsRequestId, time remaining, ...) use the options function. This way they can be passed to your schema resolvers using the context option.

1const { ApolloServer, gql } = require('apollo-server-lambda');
2
3// Construct a schema, using GraphQL schema language
4const typeDefs = gql`
5  type Query {
6    hello: String
7  }
8`;
9
10// Provide resolver functions for your schema fields
11const resolvers = {
12  Query: {
13    hello: () => 'Hello world!',
14  },
15};
16
17const server = new ApolloServer({
18  typeDefs,
19  resolvers,
20  context: ({ event, context }) => ({
21    headers: event.headers,
22    functionName: context.functionName,
23    event,
24    context,
25  }),
26});
27
28exports.handler = server.createHandler();

Modifying the Lambda Response (Enable CORS)

To enable CORS the response HTTP headers need to be modified. To accomplish this use the cors option.

1const { ApolloServer, gql } = require('apollo-server-lambda');
2
3// Construct a schema, using GraphQL schema language
4const typeDefs = gql`
5  type Query {
6    hello: String
7  }
8`;
9
10// Provide resolver functions for your schema fields
11const resolvers = {
12  Query: {
13    hello: () => 'Hello world!',
14  },
15};
16
17const server = new ApolloServer({
18  typeDefs,
19  resolvers,
20});
21
22exports.handler = server.createHandler({
23  cors: {
24    origin: '*',
25    credentials: true,
26  },
27});

To enable CORS response for requests with credentials (cookies, http authentication) the allow origin header must equal the request origin and the allow credential header must be set to true.

1const { ApolloServer, gql } = require('apollo-server-lambda');
2
3// Construct a schema, using GraphQL schema language
4const typeDefs = gql`
5  type Query {
6    hello: String
7  }
8`;
9
10// Provide resolver functions for your schema fields
11const resolvers = {
12  Query: {
13    hello: () => 'Hello world!',
14  },
15};
16
17const server = new ApolloServer({
18  typeDefs,
19  resolvers,
20});
21
22exports.handler = server.createHandler({
23  cors: {
24    origin: true,
25    credentials: true,
26  },
27});

Cors Options

The options correspond to the express cors configuration with the following fields(all are optional):

• origin: boolean | string | string[]
• methods: string | string[]
• allowedHeaders: string | string[]
• exposedHeaders: string | string[]
• credentials: boolean
• maxAge: number

Principles

GraphQL Server is built with the following principles in mind:

• By the community, for the community: GraphQL Server's development is driven by the needs of developers
• Simplicity: by keeping things simple, GraphQL Server is easier to use, easier to contribute to, and more secure
• Performance: GraphQL Server is well-tested and production-ready - no modifications needed

Anyone is welcome to contribute to GraphQL Server, just read CONTRIBUTING.md, take a look at the roadmap and make your first PR!