Serverless Configuration

homepage icon https://github.com/jlopez/serverless-configuration
Follow @jlopez

Tracked

NPM Downloads Last Month
284
Issues
0
Stars
0
Forks
0
Watchers
0
Watch Star Fork Issue Download License NPM Build Status Coverage Status Contributors

Repo README Contents:

Serverless Configuration

This Serverless plugin allows modifying the service file according to the stage or whether the system is running under serverless offline. This plugin is similar to serverless-plugin-ifelse, but with a simplified configuration method.

Installation

First, add the plugin to your project:

npm install --save-dev serverless-configuration

Then, inside your project’s serverless.yml file add serverless-configuration to the top-level plugins section. If there is no plugin section you will need to add it to the file.

plugins:
  - serverless-configuration

Configuration

In the custom.serverless-configuration section of your serverless.yml file specify one or more qualifiers. If your current environment matches the qualifier, the provided configuration changes will be applied to the file.

Qualifiers

A qualifier may be one of:

Optionally, the qualifier may be prefixed with a minus sign (-) to apply the changes whenever the qualifier doesn’t match.

Changes

Changes can be one of four types (set, add, del and merge). del should provide a list of keypaths to delete from the serverless.yml file. The other change types should provide an object whose keys denote keypaths and their values contain the data to set, add or merge at the given keypath.

E.g.:

custom:
  serverless-configuration:
    -prod:                               # will apply to all stages except prod
      add:
        provider.env:                    # update the environment with these values
          DEBUG: lambda auth
          cacheMaxAge: 15
      del:                               # delete these keys
        - resources.Resources.CDN
        - resources.Resources.DomainName
    offline:                             # apply these changes when running 'sls offline'
      set:
        provider.environment.streamEndpoint: ${self:custom.vars.localKinesisEndpoint}
      del:
        - provider.environment.redisHost
        - provider.environment.redisPort

Troubleshooting

The plugin will log all the applied changes if the environment variable SLS_DEBUG is set. By convention, this variable is set to the value *, e.g.:

SLS_DEBUG=* sls offline