cfnpp - cloudformation plus plus
A tool for making it easier to write, re-use, and template CloudFormation stacks.
Why?
Writing and maintaining CloudFormation stacks is a large part of my job and is also tedious.
Why not use existing tools (e.g., Terraform)? Abstracting away the CloudFormation stuff too much introduces more opportunities for bugs to creep in and leaves you operating several months behind on updates to AWS services and CloudFormation itself while you wait for upstream to implement the changes.
But mainly I had a long weekend and needed something to do while the baby was napping.
What?
Fair warning: This project is under heavy development and while I try and keep all the documentation mostly up-to-date, some of this stuff will be wrong.
At its core, it's a superset of YAML implemented in a way that's compatible with existing YAML parsers. You can put in a valid YAML document, and get the same document back out. Everything added is additional functionality on top of that. You don't need to rewrite your existing templates in a new language, but can start to use the additional functionality right away wherever it provides value.
It adds the ability to join multiple files together and control how they are merged and use variables and parameters, expressions and conditional statements and other functions.
How do I run it?
Pre-requisites
This tool requires the following packages:
- php 8.0+ (may work on lower versions, but untested)
- php-fileinfo
- php-json
- php-zlib
- composer (if not running a pre-built phar)
All of these are likely available in your distro's package manager. As long as you have PHP installed, it will notify you of any additional missing dependencies when you run the phar.
Running Phar
- Download phar
- Run
./cfnpp stack:compile <input_file> <output_file>
Running Source
- Clone repository
- Install dependencies:
composer install - Run
./cfnpp stack:compile <input_file> <output_file>
Building Phar
- Clone repository
- Install dependencies:
composer install - Run
./cfnpp app:buildand answer the prompts - Built phar is at
./builds/