A Serverless starter that adds ES7 syntax, serverless-offline, linting, environment variables, and unit test support. Part of the Serverless Stack guide.
Serverless Node.js Starter uses the serverless-bundle plugin (an extension of the serverless-webpack plugin) and the serverless-offline plugin. It supports:
- Generating optimized Lambda packages with Webpack
- Use ES7 syntax in your handler functions
- Use
import
andexport
- Use
- Run API Gateway locally
- Use
serverless offline start
- Use
- Support for unit tests
- Run
npm test
to run your tests
- Run
- Sourcemaps for proper error messages
- Error message show the correct line numbers
- Works in production with CloudWatch
- Lint your code with ESLint
- Add environment variables for your stages
- No need to manage Webpack or Babel configs
A demo version of this service is hosted on AWS - https://z6pv80ao4l.execute-api.us-east-1.amazonaws.com/dev/hello
And here is the ES7 source behind it
export const hello = async (event, context) => {
return {
statusCode: 200,
body: JSON.stringify({
message: `Go Serverless v1.0! ${(await message({ time: 1, copy: 'Your function executed successfully!'}))}`,
input: event,
}),
};
};
const message = ({ time, ...rest }) => new Promise((resolve, reject) =>
setTimeout(() => {
resolve(`${rest.copy} (with a delay)`);
}, time * 1000)
);
We have detailed instructions on how to upgrade your app to the v2.0 of the starter if you were using v1.x before. Read about it here.
To create a new Serverless project.
$ serverless install --url https://github.com/AnomalyInnovations/serverless-nodejs-starter --name my-project
Enter the new directory
$ cd my-project
Install the Node.js packages
$ npm install
To run a function on your local
$ serverless invoke local --function hello
To simulate API Gateway locally using serverless-offline
$ serverless offline start
Deploy your project
$ serverless deploy
Deploy a single function
$ serverless deploy function --function hello
Run your tests using
$ npm test
We use Jest to run our tests. You can read more about setting up your tests here.
To add environment variables to your project
- Rename
env.example
toenv.yml
. - Add environment variables for the various stages to
env.yml
. - Uncomment
environment: ${file(env.yml):${self:provider.stage}}
in theserverless.yml
. - Make sure to not commit your
env.yml
.
We use ESLint to lint your code via the serverless-bundle plugin.
You can turn this off by adding the following to your serverless.yml
.
custom:
bundle:
linting: false
To override the default config, add a .eslintrc.json
file. To ignore ESLint for specific files, add it to a .eslintignore
file.
- Open a new issue if you've found a bug or have some suggestions.
- Or submit a pull request!
This repo is maintained by Anomaly Innovations; makers of Seed and Serverless Stack.