Deploy AppSync API's in minutes using this Serverless plugin.
npm install serverless-appsync-plugin
service: my-app
plugins:
- serverless-appsync-plugin
provider:
name: aws
appSync:
name: my-api
authentication:
type: API_KEY
resolvers:
Query.user:
dataSource: my-table
dataSources:
my-table:
type: AMAZON_DYNAMODB
config:
tableName: ${sls:stage}-data
- General config
- DataSources
- Resolvers
- Pipeline Functions
- Authentication
- API keys
- Custom Domain
- Variable Substitutions
- Caching
- Web Application Firewall (WAF)
This plugin adds some useful CLI commands. See CLI commands documentation
This plugin exports some handy variables that you can use in your yml files to reference some values generated by CloudFormation:
-
${appsync:id}
: The id of the AppSync API -
${appsync:url}
: The URL of the AppSync API -
${appsync:arn}
: The ARN of the AppSync API -
${appsync:apiKey.[NAME]}
: An API key
Example:
provider:
environment:
APPSYNC_ID: ${appsync:id}
APPSYNC_ARN: ${appsync:arn}
APPSYNC_URL: ${appsync:url}
APPSYNC_API_KEY: ${appsync:apiKey.myKey}
appSync:
name: my-api
authentication:
type: API_KEY
apiKeys:
- name: myKey
To upgrade form v1 of this plugin, follow this guide
If you have any questions, issue, feature request, please feel free to open an issue.
You are also very welcome to open a PR and we will gladly review it.
- Mapping Tool: Quickly Build and Debug AppSync & API Gateway Mapping Templates
- GraphBolt: A professional desktop app solution for building, testing, and debugging AppSync APIs.
- AppSync Resolver Autocomplete: VSCode extension. Autocomplete support for VTL template files.
Thanks goes to these wonderful people 👏
This project follows the all-contributors specification. Contributions of any kind welcome!