Lono generates CloudFormation templates from ERB ruby templates
Ruby Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
docs
lib
spec
vendor
.coveralls.yml
.gitignore
.gitmodules
.rspec
.ruby-version
.travis.yml
CHANGELOG.md
CONTRIBUTING.md
Gemfile
Guardfile
LICENSE
README.md
Rakefile
circle.yml
lono.gemspec

README.md

Lono

Gem Version CircleCI Code Climate Dependency Status Coverage Status ReadmeCI Join the chat at https://gitter.im/tongueroo/lono Support

Lono is a tool to help you easily manage your CloudFormation templates. Lono handles the entire CloudFormation lifecyle. It starts with helping you craft of the templates and helps you all the way to end when you provision of the infrastructure.

  • Lono generates CloudFormation templates based on ERB ruby templates in either yaml or json format.
  • Lono takes simple env-like files to and generates the CloudFormation parameter files.
  • Lono wraps the CloudFormation api calls in a simple interface using the generated files to launch the CloudFormation stacks.

See lono.cloud for full lono documentation.

These blog posts also cover lono:

Quick Usage

It only takes a couple of commands to start using lono.

brew cask install boltopslabs/software/bolts
lono new infra
cd infra
lono generate # not needed but showing for explanation
lono cfn create example

This sets up a starter lono project called infra with example templates. You cd into the folder and call lono cfn create which automatically generates the CloudFormation template and parameter files to output and output/params and launches the stack.

Lono flowchart

lono cfn summary

Lono also provides a lono cfn management command that allows you to launch stacks from the lono templates. The lono cfn tool automatically runs lono generate internally and then launches the CloudFormation stack all in one command. Provided that you are in a lono project and have a my-stack lono template definition. To create a stack you can simply run:

$ lono cfn create my-stack

The above command will generate files to output/my-stack.json and output/params/my-stack.txt and use them to create a CloudFormation stack. Here are some more examples of cfn commands:

$ lono cfn create mystack-$(date +%Y%m%d%H%M%S) --template mystack --params mystack
$ lono cfn create mystack-$(date +%Y%m%d%H%M%S) # shorthand if template and params file matches.
$ lono cfn diff mystack-1493859659
$ lono cfn preview mystack-1493859659
$ lono cfn update mystack-1493859659
$ lono cfn delete mystack-1493859659
$ lono cfn create -h # getting help

See lono.cloud for full lono documentation.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

Developing

There is a submodule in this project, so when you check out remember to sync the submodule.

$ git clone git@github.com:yourfork/lono.git
$ git submodule sync
$ git submodule update --init