We use Serverless Framework to do production ready deployments and local development using serverless-offline.

To install this example to bootstrap your project, run the following command:

npx serverless install -u https://github.com/nanlabs/devops-reference/tree/main/examples/serverless-appsync-python -n my-project

You’ll need to have Node 16.13.2 or later on your local development machine (but it’s not required on the server). You can use fnm to easily switch Node versions between different projects.

fnm use
npm install

You'll also need to have Python 3.9 installed on your local development machine. You can use pyenv to easily switch Python versions between different projects.

pyenv install
pyenv local

In order to develop locally, you'll need to install the dependencies and run the application using Serverless Offline.

npm run sls requirements install

This repo has a local development set up that uses the file .env.local to configure the local environment. Run the following command to start the local development server:

npm run sls:offline

It will start the following services:

• App Sync server at http://localhost:20002/graphql
• GraphQL playground at http://localhost:20002

To deploy the app to AWS, you'll first need to configure your AWS credentials. There are many ways to set your credentials, for more information refer to the AWS documentation.

Once set you can deploy your app using the serverless framework with:

npm run sls:deploy

We recommend the following resources to add local development tools to your project:

• LocalStack