README.md

CloudFormation Template Format Converters

Purpose

A simply Ruby script to convert CloudFormation Template from JSON to YAML format or YAML to JSON. It will automatically convert to the opposite format based on the file extension passed to the script.

Usage

Run the Ruby script with a single argument being the JSON or YAML full path and filename. A converted file with the same name will be created in the same location of the original file.

It is set to not overwrite by default. It will bail out if the same output filename is found.

First rename .template to .json or .yml depending on the file contents format.

Symlink (Optional)

Create a symlink to the ruby script to a path location so it can be called from any working directory.

1. Symlink the ruby script to a place in the path

    if [ ! -h "/usr/local/bin/cfnc" ]; then
      ln -s "/path/to/clone/cfn_converter/cfn-converter.rb" /usr/local/bin/cfnc
    fi

Convert Single Template Example

cfnc -f json_file.json
cfnc -f yaml_file.yml

Convert Multiple Recursively Example

Here's a way in BASH to convert all JSONs to YAMLs. I used this to convert the whole cloudformation_templates repo

Basically find all JSON files from current working directory on down. Exclude any with parameters or snippets in the name.

find . -name '*.json' ! -name '*parameters*' ! -name 'snippets' -exec cfnc -f {} \;