GraphQL Lambda Server using apollo-server-lambda from Apollo.
graphql-tools and merge-graphql-schemas are used to generate the schema.
serverless-webpack is used to transform ES6 with Babel and build the lambda.
-
Run
npm install -g serverless
to installserverless
globally if you haven't already and follow the instructions here to configure the CLI. -
Initialize a new project from this template:
serverless install --url https://github.com/hustlelikeaboss/serverless-graphql-api
cd serverless-graphql-api
npm ci
Run serverless package
to preview the stacks to be created.
- First time deployment:
# deploy to dev by default
npm run deploy
# deploy to production
npm run deploy --stage production
This will create the Lambda Function and API Gateway for GraphQL, together with two DynamoDB tables named artists
and songs
.Note the API endpoint down for use with the GrapiQL app below, which should be something like this: https://[YOUR_LAMBDA_ID].execute-api.us-east-1.amazonaws.com/dev/graphql
. You can always find
- Run the same command above after infrastructure changes made to
serverless.yml
. - Run the script below to quickly upload code changes:
serverless deploy function -f graphql
# invoke lambda function locally
serverless invoke local --function graphql --path lib/event.json
# invoke deployed lambda function directly
serverless invoke --function graphql --path lib/event.json
# remove deployed stack
serverless remove
Query the GraphQL server using the GraphiQL.app. If you have Homebrew installed on OSX run
brew cask install graphiql