kombustion.yaml

kombustion.yaml

You can generate this with kombustion init.

Name: Test
Region: ap-southeast-2
Plugins:
  github.com/KablamoOSS/kombustion-plugin-serverless@0.1.0:
    Name: github.com/KablamoOSS/kombustion-plugin-serverless
    Version: 0.1.0
    Alias: ""
Environments:
  Production:
    AccountIDs:
      - "13521354"
    Parameters:
      ENVIRONMENT: production

Name

The name of your project.

If --stack-name is not provided this is used along with --environment and the file name, to make the CloudFormation Stack name.

Region

Default region to use.

Can be overidden by passing --region us-east-1 with your desired region.

Plugins

A list of all plugins

A plugin has a key formed of it’s Name and Version, under which contains the Name, Version, and optional Alias.

Name

URL of the plugin.

Currently only Github is supported.

Version

Version constraint.

Using SemVer to describe which version of the plugin you need. This is pinned in kombustion.lock.

Alias Optional

Add an alias to the plugin.

If two plugins use the same namespace for their resource, you can add an Alias to one of them to use both.

Environments

Allows you to provide Parameters to your Stacks based on the target environment

AccountIDs Optional

An allowlist of Account ID’s this environment can be deployed to.

If the Account ID the stack is going to be deployed into does not match from this list, the operation will fail. This is a safety to prevent accidentally deploying into the wrong account.

Parameters

A map of Key: Value parameters that will be supplied to the CloudFormation Stack.

Only the Paramters the stack needs are supplied, so multiple stacks can all use a subset of all the Parameters.