cjdev2/matryoshka

A repository of common, opinionated Cloudformation templates, designed to be used as nested stacks.

matryoshka

A repository of common, opinionated CloudFormation templates, designed to be used as nested stacks.

To Use

First-Time Setup

If you're working from scratch, run provision/deploy-template-store.sh to spin up the template store.

Then, if you want to use the existing templates in /templates, run sync-templates-to-s2.sh, you can begin using them in your templates as nested stacks, vis a vis the docs.

Changing / Adding templates

Make changes to the templates, then run sync-templates-to-s2.sh when you're ready to make those changes available.

If you add a template, the filename should take the form what-this-template-describes_v1.yaml

Please be mindful of the versioning scheme--if you make a breaking change (i.e. changing required parameters / removing resources), or you're just not sure, increment the file version.

External Resources

Deploying Microservices with Amazon ECS, AWS CloudFormation, and an Application Load Balancer

matryoshka's Issues

Better Versioning

Right now, templates are versioned by hand. It would be nice to have something akin to semver, where minor enhancements can propagate to existing uses, but breaking changes can be made without fear of accidentally clobbering stacks--especially important for production.

Sync on git push instead of manually

When templates are pushed to git, they should automatically sync to the provisioned S3 bucket.