Skip to content

Split your serverless.yaml config file into smaller modules and import them.

License

Notifications You must be signed in to change notification settings

AndrewChubatiuk/serverless-import-plugin

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Serverless Import Plugin

Split your serverless.yaml config file into smaller modules and import them.

By using this plugin you can build your serverless config from smaller parts separated by functionalities. Imported config is merged, so all keys are supported and lists are concatenated (without duplicates).

Works on importing yaml files by path or node module, especially useful in multi-package repositories.

Installation

Install with npm:

npm install --save-dev serverless-import-plugin

And then add the plugin to your serverless.yml file:

plugins:
  - serverless-import-plugin

Usage

Specify config files to import in custom.import list:

custom:
  import:
    - ./path/to/serverless.yml # path to YAML file with serverless config
    - ./path/to/dir # directory where serverless.yml can be find
    - module-name # node module where serverless.yml can be find
    - '@myproject/users-api' # monorepo package with serverless.yml config file
    - module-name/custom-serverless.yml # path to custom config file of a node module

custom.import can be also a string, when only one file needs to be imported:

custom:
  import: '@myproject/users-api'

Relative paths

All function handler paths are automatically prefixed by the imported config directory.

functions:
  postOrder:
    handler: functions/postOrder.handler # relative to the imported config

For other fields you need to use ${dirname} variable manually. ${dirname} points to a directory of imported config file.

custom:
  webpack:
    webpackConfig: ${dirname}/webpack.config.js

Customizable boilerplates

In case you want to customize imported config in more dynamic way, provide it as javascript file (serverless.js).

module.exports = ({ name, schema }) => ({
  provider: {
    iamRoleStatements: [
      // ...
    ],
  },
  // ...
})

You can pass arguments to the imported file using module and inputs fields:

custom:
  import:
    - module: '@myproject/aws-dynamodb' # can be also a path to js file
      inputs:
        name: custom-table
        schema:
          # ...

About

Split your serverless.yaml config file into smaller modules and import them.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 100.0%