@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:

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

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

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

Tasks

ServerlessRun

Run serverless functions locally

Task options

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

All properties are optional.

ServerlessDeploy

Deploy a serverless function

ServerlessProvision

Provision a review serverless function

ServerlessTeardown

Tear down existing serverless functions

Plugin-wide options

@dotcom-tool-kit/serverless

| 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<string> | ["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.