Project

murk

0.0
No commit activity in last 3 years
No release in over 3 years
Murk - Parameterization and environmental partitioning for AWS CloudFormation
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 0.10
~> 3.3
~> 0.32
~> 0.10

Runtime

~> 0.3
~> 2.1
~> 1.0
~> 1.8
 Project Readme

Murk

Configuration, parameterization, and environmental partitioning of AWS CloudFormation stacks.

What it is

Murk is a tool intended to simplify the configuration, management, and partitioning of your AWS CloudFormation environment. It offers:

  • A simple CLI for creating and destroying CloudFormation stacks by name, with some simple rules for locating templates.
  • A DSL for specifying the parameter values you wish to supply when creating stacks from templates.
  • A mechanism for specifying different 'environments' (e.g. production, dev, qa), and the stacks that should be created within them.

What it isn't

A DSL for generating CloudFormation templates themselves. Murk assumes you've already authored your CloudFormation templates by hand, or generated them using another 3rd party tool.

Requirements

  • Ruby 2.2.x
  • AWS SDK for Ruby v2
  • Configured AWS SDK credentials

Running the example

gem install murk
cd examples

# Create a VPC stack in the 'qa' environement named 'myqa'
murk create --stack vpc --env qa myqa

# Create the webapp-network stack in the 'qa' environement named 'myqa'
murk create --stack webapp-network --env qa myqa

# Create the webapp-compute stack in the 'qa' environement named 'myqa'
murk create --stack webapp-compute --env qa myqa

# Delete the 'qa' webapp-compute stack
murk delete --stack webapp-compute --env qa myqa