README.md

NAME

cfn-tool — a cloudformation template processing and stack deployment tool.

INSTALL

sudo npm install -g 'daggerml/cfn-tool#5.7.9'

# Add the following to your `~/.bashrc` to enable bash completion:
complete -o default -C $(which cfn-tool-completer) cfn-tool

USAGE

Expand macros in template.yml and print resulting YAML to stdout:

cfn-tool transform template.yml

Expand macros in my-template.yml and nested templates, lint and validate templates, upload packages and templates to S3, and deploy my-template.yml to my-stack:

cfn-tool deploy template.yml my-stack

Update a parameter of an existing stack, preserving previous values of all existing parameters not specified for update:

cfn-tool update --parameters "Foo=bar Baz=baf" my-stack

Simple macro example:

cat <<EOT |cfn-tool transform /dev/stdin
Foo: !Shell uuidgen -t
EOT

Foo: 53480aea-8c46-11eb-a4b0-61c2b0470324

Note: There are many macro usage examples in the unit tests YAML file.

MANUALS

See the manual pages for complete usage and options info:

• cfn-tool(1)
• cfn-tool-deploy(1)
• cfn-tool-transform(1)
• cfn-tool-update(1)

And the built-in macros reference manual page:

• cfn-tool-macros(1)