serverless-plugin-nested-stacks




Nested stacks for the Serverless Framework!
Installation
Run
npm install in your Serverless project.
$ npm install serverless-aws-nested-stacks --save-dev
Intro
Write your nested stacks as regular cloudformation and easily integrate them with the Serverless Framework!
This plugin handles:
* Adding the appropriate
AWS::Cloudformation::Stack type resources to the generated sls cloudformation template.
* Uploading your nested stacks to your designated S3 deployment bucket.
Configuration Reference
``
plugins:
- serverless-aws-nested-stacks
custom:
nested-stacks:
location: nested-stacks # Where do you keep your nested stacks?
stacks:
- id: MyGroovyNestedStack # Logical ID (Required)
template: nested-template.yml # Template file name (Required)
enabled: true # optional flag for enabled/disabling substack
timeout: 60 # Minutes before stack creation times out.
parameters: # Stack parameters as key value pairs
- InstanceType: t1.micro
- BlahBlah: abc123
tags: # Stack tags
- ${file(nested-stacks/core-tags.yml)} # Load tags from a file?
- CustomTag: Yolo
notifications: # Notification ARN's for SNS
- arn:aws:sns:region:account-id:topicname
``
*
custom.nested-stacks.location - (Required) Organisation is important. Keep all your nested stacks in one place and use this attribute to define where that place is.
*
custom.nested-stacks.stacks - (Required) Your very own list of nested stack definitions!
*
custom.nested-stacks.stacks.id - (Required) The logical ID of the nested stack resource.
*
custom.nested-stacks.stacks.template - (Required) The file name of the nested stack. Remember, this file must exist in the directory defined by _custom.nested-stacks.location_.
*
custom.nested-stacks.stacks.timeout - Time in minutes before the stack creation times out.
*
custom.nested-stacks.stacks.parameters - A list of key value pairs to be passed into the nested stack as parameters.
*
custom.nested-stacks.stacks.tags - A list of key value pairs to be passed into the nested stack as its tags.
*
custom.nested-stacks.stacks.notifications - A list of existing Amazon SNS topics where notifications about stack events are sent.
*
custom.nested-stacks.stacks.dependson - The ID of another CloudFormation resource. Specify another stack ID to order the application of nested stacks.
Want to know more?
Read the AWS Cloudformation documentation for
AWS::Cloudformation::Stack resources!