lono-cfn 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 265bf28e4a45544babe2118667de0af5915340d5
+  data.tar.gz: b0cdecb36faa043904edb48b33f56544d40bbb1c
+SHA512:
+  metadata.gz: 8c70f4ddd7d26a3328412605aa890802ccbe24e019a1f5e1f27eaf075b8fd704ed8b286b58053aa8433d5dd8e9e42ed33653f9e9237a1f022a10a100c53c75ea
+  data.tar.gz: 4ca23f77a2d84fa824705b43239f4662b239319e6d63d58c8462182c842628d2b9c7454175eb18acec8eb0e8910d7e1cb59f9ac93da101db4bdce3184aa30370

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+/params/output

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format documentation

data/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+This project *tries* to adhere to [Semantic Versioning](http://semver.org/), even before v1.0.
+
+## [0.0.1] Initial Release
+
+- Initial release.

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in lono_cfn.gemspec
+gemspec
+
+gem "codeclimate-test-reporter", group: :test, require: nil

data/Gemfile.lock

@@ -0,0 +1,145 @@
+PATH
+  remote: .
+  specs:
+    lono-cfn (0.0.1)
+      aws-sdk
+      colorize
+      hashie
+      lono
+      lono-params
+      thor
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activemodel (4.0.13)
+      activesupport (= 4.0.13)
+      builder (~> 3.1.0)
+    activesupport (4.0.13)
+      i18n (~> 0.6, >= 0.6.9)
+      minitest (~> 4.2)
+      multi_json (~> 1.3)
+      thread_safe (~> 0.1)
+      tzinfo (~> 0.3.37)
+    aws-sdk (2.6.4)
+      aws-sdk-resources (= 2.6.4)
+    aws-sdk-core (2.6.4)
+      jmespath (~> 1.0)
+    aws-sdk-resources (2.6.4)
+      aws-sdk-core (= 2.6.4)
+    builder (3.1.4)
+    codeclimate-test-reporter (0.6.0)
+      simplecov (>= 0.7.1, < 1.0.0)
+    coderay (1.1.1)
+    colorize (0.8.1)
+    diff-lcs (1.2.5)
+    docile (1.1.5)
+    ffi (1.9.14)
+    formatador (0.2.5)
+    guard (2.14.0)
+      formatador (>= 0.2.4)
+      listen (>= 2.7, < 4.0)
+      lumberjack (~> 1.0)
+      nenv (~> 0.1)
+      notiffany (~> 0.0)
+      pry (>= 0.9.12)
+      shellany (~> 0.0)
+      thor (>= 0.18.1)
+    guard-bundler (2.1.0)
+      bundler (~> 1.0)
+      guard (~> 2.2)
+      guard-compat (~> 1.1)
+    guard-cloudformation (0.0.3)
+      colorize
+      guard
+    guard-compat (1.2.1)
+    guard-lono (0.0.2)
+      colorize
+      guard
+    guard-rspec (4.7.3)
+      guard (~> 2.1)
+      guard-compat (~> 1.1)
+      rspec (>= 2.99.0, < 4.0)
+    hashie (3.4.6)
+    i18n (0.7.0)
+    jmespath (1.3.1)
+    json (2.0.2)
+    listen (3.1.5)
+      rb-fsevent (~> 0.9, >= 0.9.4)
+      rb-inotify (~> 0.9, >= 0.9.7)
+      ruby_dep (~> 1.2)
+    lono (0.5.0)
+      colorize
+      guard
+      guard-cloudformation
+      guard-lono
+      json
+      rake
+      rb-fsevent
+      thor
+    lono-params (0.0.2)
+      colorize
+      hashie
+      plissken
+      thor
+    lumberjack (1.0.10)
+    method_source (0.8.2)
+    minitest (4.7.5)
+    multi_json (1.12.1)
+    nenv (0.3.0)
+    notiffany (0.1.1)
+      nenv (~> 0.1)
+      shellany (~> 0.0)
+    plissken (0.2.0)
+      symbolize (~> 4.2)
+    pry (0.10.4)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
+      slop (~> 3.4)
+    rake (11.3.0)
+    rb-fsevent (0.9.7)
+    rb-inotify (0.9.7)
+      ffi (>= 0.5.0)
+    rspec (3.5.0)
+      rspec-core (~> 3.5.0)
+      rspec-expectations (~> 3.5.0)
+      rspec-mocks (~> 3.5.0)
+    rspec-core (3.5.3)
+      rspec-support (~> 3.5.0)
+    rspec-expectations (3.5.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.5.0)
+    rspec-mocks (3.5.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.5.0)
+    rspec-support (3.5.0)
+    ruby_dep (1.4.0)
+    shellany (0.0.1)
+    simplecov (0.12.0)
+      docile (~> 1.1.0)
+      json (>= 1.8, < 3)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.0)
+    slop (3.6.0)
+    symbolize (4.5.2)
+      activemodel (>= 3.2, < 5)
+      activesupport (>= 3.2, < 5)
+      i18n
+    thor (0.19.1)
+    thread_safe (0.3.5)
+    tzinfo (0.3.51)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.3)
+  codeclimate-test-reporter
+  guard
+  guard-bundler
+  guard-rspec
+  lono-cfn!
+  rake
+
+BUNDLED WITH
+   1.12.5

data/Guardfile

@@ -0,0 +1,12 @@
+guard 'rspec' do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})      { "spec/lono_cfn_spec.rb" }
+  watch(%r{^lib/lono_cfn/(.+)\.rb$})  { "spec/lono_cfn_spec.rb" }
+  watch('spec/spec_helper.rb')   { "spec/lono_cfn_spec.rb" }
+  watch(%r{^lib/lono_cfn/(.+)\.rb$})   { |m| "spec/lib/#{m[1]}_spec.rb" }
+end
+
+guard 'bundler' do
+  watch('Gemfile')
+  watch(/^.+\.gemspec/)
+end

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Tung Nguyen
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,73 @@
+# Lono Cfn
+
+Wrapper cfn tool to quickly create CloudFormation stacks from lono templates and params files.  
+
+```bash
+$ bundle exec lono-cfn create my-stack-$(date +%s) --template my-template --params my-params
+```
+
+The above command:
+
+1. Generates the lono templates defined in the lono config files.
+2. Generate a parameters file from the params/my-params.txt.
+3. Launch the CloudFormation stack with those parameters.
+
+This tool is meant to be used in conjuction with [lono](https://github.com/tongueroo/lono) but can also be used separately with the `--no-lono` flag, which skips the `lono generate` call.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'lono-cfn'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install lono-cfn
+
+## Usage
+
+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 and use the template in output/my-stack.json and parameters in params/my-stack.txt.  The template defaults by convention to the name of the stack.  The params defaults by convention to the name of the template in turn.  The conventions allows the command to be a very nice short command that can be easily remembered.  Both conventions can be overridden.
+
+## More About Conventions
+
+* stack - This is a required parameter and is the passed in from the CLI as the first parameter.
+* template - By convention matches the stack name but can be overriden with `--template`.
+* params = By convention matches the template name but can be overriden with `--params`.
+
+Here are examples of overriding the template and params name conventions.
+
+```
+$ lono-cfn create my-stack --template different-name1
+```
+
+The template that will be use is output/different-name1.json and the parameters will use params/different-name1.json.
+
+```
+$ lono-cfn create my-stack --params different-name2
+```
+
+The template that will be use is output/different-name2.json and the parameters will use params/different-name2.json.
+
+```
+$ lono-cfn create my-stack --template different-name3 --params different-name4
+```
+
+The template that will be use is output/different-name3.json and the parameters will use params/different-name4.json.
+
+## 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

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+task :default => :spec
+
+RSpec::Core::RakeTask.new

data/bin/lono-cfn

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.expand_path('../../lib', __FILE__))
+require 'lono-cfn'
+require 'lono_cfn/cli'
+
+LonoCfn::CLI.start(ARGV)

data/lib/lono-cfn.rb

@@ -0,0 +1,8 @@
+$:.unshift(File.expand_path("../", __FILE__))
+require "lono_cfn/version"
+require "pp"
+
+module LonoCfn
+  autoload :CLI, 'lono_cfn/cli'
+  autoload :Create, 'lono_cfn/create'
+end

data/lib/lono_cfn/cli.rb

@@ -0,0 +1,20 @@
+require 'thor'
+require 'lono_cfn/cli/help'
+
+module LonoCfn
+
+  class CLI < Thor
+    class_option :verbose, type: :boolean
+    class_option :noop, type: :boolean
+    class_option :project_root, desc: "Project folder.  Defaults to current directory", default: '.'
+
+    desc "create STACK", "create a CloudFormation stack"
+    long_desc Help.create
+    option :template, desc: 'override convention and specify the template file to use'
+    option :params, desc: 'override convention and specify the params file to use'
+    option :lono, type: :boolean, desc: 'invoke lono to generate CloudFormation templates', default: true
+    def create(name)
+      Create.new(name, options).run
+    end
+  end
+end

data/lib/lono_cfn/cli/help.rb

@@ -0,0 +1,34 @@
+module LonoCfn
+  class CLI < Thor
+    class Help
+      class << self
+        def create
+<<-EOL
+Examples:
+
+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 and use the template in output/my-stack.json and parameters in params/my-stack.txt.  The template defaults by convention to the name of the stack.  The params defaults by convention to the name of the template in turn.  The convention allows the command to be a very nice short command that can be easily remembered.  Both conventions can be overridden.
+
+Here are examples of overriding the template and params name conventions.
+
+$ lono-cfn create my-stack --template different-name1
+
+The template that will be use is output/different-name1.json and the parameters will use params/different-name1.json.
+
+$ lono-cfn create my-stack --params different-name2
+
+The template that will be use is output/different-name2.json and the parameters will use params/different-name2.json.
+
+$ lono-cfn create my-stack --template different-name3 --params different-name4
+
+The template that will be use is output/different-name3.json and the parameters will use params/different-name4.json.
+
+EOL
+        end
+      end
+    end
+  end
+end

data/lib/lono_cfn/create.rb

@@ -0,0 +1,112 @@
+require "lono"
+require "lono-params"
+require "aws-sdk"
+
+module LonoCfn
+  class Create
+    def initialize(stack_name, options={})
+      @stack_name = stack_name
+      @options = options
+      @project_root = options[:project_root] || '.'
+
+      template_name = options[:template] || @stack_name
+      params_name = options[:params] || template_name
+      @template_path = get_source_path(template_name, :template)
+      @params_path = get_source_path(params_name, :params)
+      puts "Using template: #{@template_path}"
+      puts "Using parameters: #{@params_path}"
+
+      @region = options[:region] || 'us-east-1'
+    end
+
+    def run
+      generate_templates if @options[:lono]
+      check_for_errors
+      params = generate_params
+      create_stack(params)
+    end
+
+    def generate_templates
+      Lono::DSL.new(
+          project_root: @project_root,
+          pretty: true
+        ).run
+    end
+
+    def generate_params
+      generator = LonoParams::Generator.new(@stack_name,
+        project_root: @project_root,
+        path: @params_path,
+        allow_blank: true)
+      generator.generate  # Writes the json file in CamelCase keys format
+      generator.params    # Returns Array in underscore keys format
+    end
+
+    # aws cloudformation create-stack --stack-name cluster-hi \
+    #   --template-body file://output/cluster-hi.json \
+    #   --parameters file://parameters/output/cluster-hi.json
+    def create_stack(params)
+      template_body = IO.read(@template_path)
+      message = "#{@stack_name} stack created."
+      if @options[:noop]
+        message = "NOOP #{message}"
+      else
+        cfn.create_stack(
+          stack_name: @stack_name,
+          template_body: template_body,
+          parameters: params#,
+          # capabilities: ["CAPABILITY_IAM"]
+        )
+      end
+      puts message unless @options[:mute]
+    end
+
+    def cfn
+      @cfn ||= Aws::CloudFormation::Client.new(region: @region)
+    end
+
+    def check_for_errors
+      errors = check_files
+      unless errors.empty?
+        puts "Please double check the command you ran.  There were some errors."
+        puts "#{errors.join("\n")}" 
+        exit
+      end
+    end
+
+    def check_files
+      errors = []
+      unless File.exist?(@template_path)
+        errors << "Template file missing: could not find #{@template_path}"
+      end
+      if @options[:params] && !File.exist?(@params_path)
+        errors << "Parameters file missing: could not find #{@params_path}"
+      end
+      errors
+    end
+
+    # if existing in params path then use that
+    # if it doesnt assume it is a full path and check that
+    # else fall back to convention, which also eventually gets checked in check_for_errors
+    # 
+    # Type - :params or :template
+    def get_source_path(path, type)
+      default_convention_path = convention_path(@stack_name, type)
+
+      return default_convention_path if path.nil?
+      # convention path based on the input from the user
+      convention_path(path, type)
+    end
+
+    def convention_path(name, type)
+      case type
+      when :template
+        "#{@project_root}/output/#{name}.json"
+      when :params
+        "#{@project_root}/params/#{name}.txt"
+      else
+        raise "hell: dont come here"
+      end
+    end
+  end
+end