@dotcom-tool-kit/serverless

Tool Kit plugin to manage Lambdas with AWS serverless.

This plugin will be installed as a dependency of the backend-serverless-app plugin, which we recommend using instead of installing this plugin directly. That plugin will install additional plugins that will be useful or most Customer Products projects at the FT.

Installation & usage

With Tool Kit already set up, install this plugin as a dev dependency:

``sh
npm install --save-dev @dotcom-tool-kit/serverless
`

And add it to your repo's .toolkitrc.yml:

`yml
plugins:
- '@dotcom-tool-kit/serverless'
`

Tasks

$3

Run serverless functions locally
#### Task options

| Property | Description | Type | Default |
| :----------- | :---------------------------------------------------------- | :-------------- | :----------------- |
| ports | ports to try to bind to for this application | Array | [3001,3002,3003] |
| useDoppler | run the application with environment variables from Doppler | boolean | true |

_All properties are optional._

$3

Deploy a serverless function

$3

Provision a review serverless function

$3

Tear down existing serverless functions

Plugin-wide options

$3

| Property | Description | Type | Default |
| :---------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------- | :-------------- |
| awsAccountId (\*) | the ID of the AWS account you wish to deploy to (account IDs can be found at the FT login page) | string | |
| systemCode (\*) | the system code for your app | string | |
| regions | an array of AWS regions you want to deploy to | Array | ["eu-west-1"] |
| configPath | path to your serverless config file. If this is not provided, Serverless defaults to ./serverless.yml but other config fomats are accepted | string` | |

_(\*) Required._