cloudformer2 1.0.18

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 507b885f8e308609bc0790cb86f143032b5b2c8c
+  data.tar.gz: 92308039a57f4a25fb641cc39322ad8654f2a833
+SHA512:
+  metadata.gz: d7b4bce27d8b8b8a506c9147ecf683ce7b11579bc9f5cc6560e90223146c1369c4d5d22569bb012eeee1379f987887c87c7a2ba0f58b30df7e244a7158629ea8
+  data.tar.gz: 82c9575f3f6784b742e4c8fa6a7bd81697abb86f2888d4a93bb496063d73a6bb0cf8e44c6a0b76aa72fc3fdabd8199a9df64f2ccc6cf32de4b382812be143f1f

data/.gitignore

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

data/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Change Log
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](http://keepachangelog.com/)
+and this project adheres to [Semantic Versioning](http://semver.org/).
+
+## 1.0.19 (Next Release)
+
+## [1.0.18]
+  * Initial release of cloudformer fork that uses the aws-sdk-v1 gem and aws-sdk ~> 2.10.9
+

data/Dockerfile

@@ -0,0 +1,5 @@
+FROM ruby:2.1.2
+
+ADD . /usr/local/app
+WORKDIR /usr/local/app
+RUN bundle install

data/Gemfile

@@ -0,0 +1,3 @@
+source 'http://rubygems.org'
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Arvind Kunday
+
+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,222 @@
+# CloudFormer 2
+
+Cloudformer attempts to simplify AWS Cloudformation stack creation process in ruby projects by providing reusable rake tasks to perform common operations such as apply(create/update), delete, recreate on stack along with validations on templates. Task executions which enforce a stack change will wait until ROLLBACK/COMPLETE or DELETE is signalled on the stack (useful in continuous deployment environments to wait until deployment is successful). Refer [examples section](#example) for more information.
+
+### Note:
+Forked from abandoned https://github.com/kunday/cloudformer
+
+The list of rake tasks provided are:
+
+```
+
+rake apply           # Apply Stack with Cloudformation script and parameters(And wait till complete - supports updates)
+rake delete          # Delete stack from CloudFormation(And wait till stack is complete)
+rake events          # Get the recent events from the stack
+rake outputs         # Get the outputs of stack
+rake recreate        # Recreate stack(runs delete & apply)
+rake status          # Get the deployed app status
+
+```
+
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'cloudformer2'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install cloudformer2
+
+## AWS Environment configuration
+
+Cloudformer depends on the aws-sdk gem to query AWS API. You will need to export AWS configuration to environment variables to your .bashrc/.bash_profile or your build server:
+
+    export AWS_ACCESS_KEY=your access key
+    export AWS_REGION=ap-southeast-2
+    export AWS_SECRET_ACCESS_KEY=your secret access key
+
+
+## Configuration
+
+You can add cloudformer tasks to your project by adding the following to your rake file:
+
+	require 'cloudformer2'
+    Cloudformer::Tasks.new("earmark") do |t|
+      t.template = "cloudformation/cloudformation.json"
+      t.parameters = parameters
+    end
+
+where `cloudformation/cloudformation.json` is the stack json file and parameters is a hash of parameters used in the template.
+For a template which takes the following parameters:
+
+    "Parameters": {
+      "PackageUrl": {
+        "Type": "String"
+      },
+      "PackageVersion": {
+        "Type": "String"
+      }
+    }
+
+the parameter hash(Ruby Object) would look like:
+
+    {
+      "PackageUrl" => "http://localhost/app.rpm",
+      "PackageVersion" => "123"
+    }
+
+If you have a template with no parameters, pass an empty hash `{}` instead.
+
+## Example
+
+Here is a simple Cloudformation Stack(Code available in the samples directory) with a Single EC2 Server:
+
+    {
+      "AWSTemplateFormatVersion": "2010-09-09",
+      "Description": "Cloudformer - Demo App",
+      "Parameters": {
+        "AmiId": {
+          "Type": "String"
+        }
+        },
+        "Resources": {
+          "ApplicationServer": {
+            "Type": "AWS::EC2::Instance",
+            "Properties": {
+              "ImageId": {
+                "Ref": "AmiId"
+                },
+                "InstanceType": "t1.micro",
+                "Monitoring": "false"
+            }
+          }
+        },
+        "Outputs": {
+          "Server": {
+            "Value": {
+              "Fn::GetAtt": [
+                "ApplicationServer",
+                "PrivateIp"
+              ]
+            }
+          }
+        }
+    }
+
+Then, in your Rakefile add,
+
+    require 'cloudformer/tasks'
+
+    Cloudformer::Tasks.new("app") do |t|
+      t.template = "basic_template.json"
+      t.tags = [{'Key' => 'Name',  'Value' => 'BASIC-TMPLT'},
+                {'Key' => 'Owner', 'Value' => 'APPOWNER'}]
+
+      #AMI Works in Sydney region only, ensure you supply the right AMI.
+      t.parameters = {"AmiId" => "ami-8da439b7"}
+    end
+
+You should then see following commands:
+
+    rake apply     # Apply Stack with Cloudformation script and parameters
+    rake delete    # Delete stack from CloudFormation
+    rake events    # Get the recent events from the stack
+    rake outputs   # Get the outputs of stack
+    rake recreate  # Recreate stack
+    rake status    # Get the deployed app status
+
+Running `rake status` gives us:
+
+    ===============================================
+      app - Not Deployed
+    ================================================
+
+Running `rake apply` will create an environment or update existing depending on the nature of action requested in parameters:
+
+    Initializing stack creation...
+    ==================================================================================================
+    2013-10-24 07:55:24 UTC - AWS::CloudFormation::Stack - CREATE_IN_PROGRESS - User Initiated
+    2013-10-24 07:55:36 UTC - AWS::EC2::Instance - CREATE_IN_PROGRESS -
+    2013-10-24 07:55:37 UTC - AWS::EC2::Instance - CREATE_IN_PROGRESS - Resource creation Initiated
+    2013-10-24 07:56:25 UTC - AWS::EC2::Instance - CREATE_COMPLETE -
+    2013-10-24 07:56:26 UTC - AWS::CloudFormation::Stack - CREATE_COMPLETE -
+    ==================================================================================================
+
+Running `rake apply` again gives us:
+
+    No updates are to be performed.
+
+To remove the stack `rake delete` gives us:
+
+    ==============================================================================================
+    Attempting to delete stack - app
+    ==============================================================================================
+    2013-10-24 07:55:24 UTC - AWS::CloudFormation::Stack - CREATE_IN_PROGRESS - User Initiated
+    2013-10-24 07:55:36 UTC - AWS::EC2::Instance - CREATE_IN_PROGRESS -
+    2013-10-24 07:55:37 UTC - AWS::EC2::Instance - CREATE_IN_PROGRESS - Resource creation Initiated
+    2013-10-24 07:56:25 UTC - AWS::EC2::Instance - CREATE_COMPLETE -
+    2013-10-24 07:56:26 UTC - AWS::CloudFormation::Stack - CREATE_COMPLETE -
+    2013-10-24 07:58:54 UTC - AWS::CloudFormation::Stack - DELETE_IN_PROGRESS - User Initiated
+    2013-10-24 07:58:56 UTC - AWS::EC2::Instance - DELETE_IN_PROGRESS -
+
+Attempts to delete a non-existing stack will result in:
+
+    ==============================================
+    Attempting to delete stack - app
+    ==============================================
+    Stack not up.
+    ==============================================
+
+To recreate the stack use `rake recreate`:
+
+    =================================================================================================
+    Attempting to delete stack - app
+    =================================================================================================
+    2013-10-24 08:04:11 UTC - AWS::CloudFormation::Stack - CREATE_IN_PROGRESS - User Initiated
+    2013-10-24 08:04:22 UTC - AWS::EC2::Instance - CREATE_IN_PROGRESS -
+    2013-10-24 08:04:23 UTC - AWS::EC2::Instance - CREATE_IN_PROGRESS - Resource creation Initiated
+    2013-10-24 08:05:12 UTC - AWS::EC2::Instance - CREATE_COMPLETE -
+    2013-10-24 08:05:13 UTC - AWS::CloudFormation::Stack - CREATE_COMPLETE -
+    2013-10-24 08:05:52 UTC - AWS::CloudFormation::Stack - DELETE_IN_PROGRESS - User Initiated
+    2013-10-24 08:06:02 UTC - AWS::EC2::Instance - DELETE_IN_PROGRESS -
+    Stack deleted successfully.
+    Initializing stack creation...
+    =================================================================================================
+    2013-10-24 08:06:31 UTC - AWS::CloudFormation::Stack - CREATE_IN_PROGRESS - User Initiated
+    2013-10-24 08:06:52 UTC - AWS::EC2::Instance - CREATE_IN_PROGRESS -
+    2013-10-24 08:06:54 UTC - AWS::EC2::Instance - CREATE_IN_PROGRESS - Resource creation Initiated
+    2013-10-24 08:07:41 UTC - AWS::EC2::Instance - CREATE_COMPLETE -
+    =================================================================================================
+    =================================================================================================
+    Server -  - 172.31.3.52
+    =================================================================================================
+
+To see the stack outputs `rake outputs`:
+
+    ==============================
+    Server -  - 172.31.3.52
+    ==============================
+
+To see recent events on the stack `rake events`:
+
+    ==================================================================================================
+    2013-10-24 08:06:31 UTC - AWS::CloudFormation::Stack - CREATE_IN_PROGRESS - User Initiated
+    2013-10-24 08:06:52 UTC - AWS::EC2::Instance - CREATE_IN_PROGRESS -
+    2013-10-24 08:06:54 UTC - AWS::EC2::Instance - CREATE_IN_PROGRESS - Resource creation Initiated
+    2013-10-24 08:07:41 UTC - AWS::EC2::Instance - CREATE_COMPLETE -
+    2013-10-24 08:07:43 UTC - AWS::CloudFormation::Stack - CREATE_COMPLETE -
+    ==================================================================================================
+
+## 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,12 @@
+require 'bundler/gem_tasks'
+require 'rspec'
+
+begin
+  require 'rspec/core/rake_task'
+
+  RSpec::Core::RakeTask.new(:spec)
+
+  task :default => :spec
+rescue LoadError
+  # no rspec available
+end

data/cloudformer2.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'cloudformer/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "cloudformer2"
+  spec.version       = Cloudformer::VERSION
+  spec.authors       = ["Sentia MPC", "Dennis Vink"]
+  spec.email         = ["dennis.vink@sentia.com"]
+  spec.description   = %q{Cloudformation tasks for apply(create/update), delete, recreate on stack along with validations on templates}
+  spec.summary       = %q{Cloudformer attempts to simplify AWS Cloudformation stack creation process in ruby projects by providing reusable rake tasks to perform common operations such as apply(create/update), delete, recreate on stack along with validations on templates.}
+  spec.homepage      = "https://github.com/sentialabs/cloudformer2"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rspec"
+  spec.add_dependency "rake"
+  spec.add_dependency "aws-sdk-v1", '~> 1.67.0'
+  spec.add_dependency "aws-sdk", '~> 2.10.9'
+  spec.add_dependency "httparty"
+end

data/docker-compose.yml

@@ -0,0 +1,2 @@
+app:
+  build: .

data/lib/cloudformer/cloudformer.rb

@@ -0,0 +1,6 @@
+require "cloudformer/version"
+require "cloudformer/stack"
+require "cloudformer/tasks"
+
+module Cloudformer
+end

data/lib/cloudformer/stack.rb

@@ -0,0 +1,189 @@
+require "aws-sdk-v1"
+require "aws-sdk"
+require "httparty"
+
+# Class to simplify AWS CloudFormation stack creation
+class Stack
+  attr_accessor :stack, :name, :deployed
+
+  SUCESS_STATES  = %w[CREATE_COMPLETE UPDATE_COMPLETE].freeze
+  FAILURE_STATES = %w[
+    CREATE_FAILED DELETE_FAILED UPDATE_ROLLBACK_FAILED
+    ROLLBACK_FAILED ROLLBACK_COMPLETE ROLLBACK_FAILED
+    UPDATE_ROLLBACK_COMPLETE UPDATE_ROLLBACK_FAILED
+  ].freeze
+  END_STATES = SUCESS_STATES + FAILURE_STATES
+
+  # WAITING_STATES = ["CREATE_IN_PROGRESS","DELETE_IN_PROGRESS","ROLLBACK_IN_PROGRESS","UPDATE_COMPLETE_CLEANUP_IN_PROGRESS","UPDATE_IN_PROGRESS","UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS","UPDATE_ROLLBACK_IN_PROGRESS"]
+  def initialize(stack_name)
+    @name = stack_name
+    @cf = AWS::CloudFormation.new
+    @stack = @cf.stacks[name]
+    @ec2 = AWS::EC2.new
+  end
+
+  def deployed
+    stack.exists?
+  end
+
+  def apply(template_file, parameters, disable_rollback = false,
+            capabilities = [], notify = [], tags = [])
+    if template_file =~ %r{^https:\/\/s3\S+\.amazonaws\.com\/(.*)}
+      template = template_file
+    elsif template_file =~ %r{^http.*(.json)$/}
+      begin
+        response = HTTParty.get(template_file)
+        template = response.body
+      rescue => e
+        puts "Unable to retieve json file for template from #{template_file} - #{e.class}, #{e}"
+        return :Failed
+      end
+    else
+      template = File.read(template_file)
+    end
+    validation = validate(template)
+    unless validation["valid"]
+      puts "Unable to update - #{validation['response'][:code]} - #{validation['response'][:message]}"
+      return :Failed
+    end
+    pending_operations = false
+    begin
+      if deployed
+        pending_operations = update(template, parameters, capabilities)
+      else
+        pending_operations = create(template, parameters, disable_rollback, capabilities, notify, tags)
+      end
+    rescue ::AWS::CloudFormation::Errors::ValidationError => e
+      puts e.message
+      return e.message == "No updates are to be performed." ? :NoUpdates : :Failed
+    end
+    wait_until_end if pending_operations
+    deploy_succeeded? ? :Succeeded : :Failed
+  end
+
+  def deploy_succeeded?
+    return true unless FAILURE_STATES.include?(stack.status)
+    puts "Unable to deploy template. Check log for more information."
+    false
+  end
+
+  def stop_instances
+    update_instances("stop")
+  end
+
+  def start_instances
+    update_instances("start")
+  end
+
+  def delete
+    with_highlight do
+      puts "Attempting to delete stack - #{name}"
+      stack.delete
+      wait_until_end
+      return deploy_succeeded?
+    end
+  end
+
+  def status
+    with_highlight do
+      if deployed
+        puts "#{stack.name} - #{stack.status} - #{stack.status_reason}"
+      else
+        puts "#{name} - Not Deployed"
+      end
+    end
+  end
+
+  def events(options = {})
+    with_highlight do
+      if !deployed
+        puts "Stack not up."
+        return
+      end
+      stack.events.sort_by { |a| a.timestamp }.each do |event|
+        puts "#{event.timestamp} - #{event.physical_resource_id.to_s} - #{event.logical_resource_id} - #{event.resource_type} - #{event.resource_status} - #{event.resource_status_reason.to_s}"
+      end
+    end
+  end
+
+  def outputs
+    with_highlight do
+      if !deployed
+        puts "Stack not up."
+        return 1
+      end
+      stack.outputs.each do |output|
+        puts "#{output.key} - #{output.description} - #{output.value}"
+      end
+    end
+    return 0
+  end
+
+  def validate(template)
+    response = @cf.validate_template(template)
+    return {
+      "valid" => response[:code].nil?,
+      "response" => response
+    }
+  end
+
+  private
+
+  def wait_until_end
+    printed = []
+    current_time = Time.now
+    with_highlight do
+      if !deployed
+        puts "Stack not up."
+        return
+      end
+      loop do
+        printable_events = stack.events.reject { |a| (a.timestamp < current_time) }.sort_by { |a| a.timestamp }.reject { |a| a if printed.include?(a.event_id) }
+        printable_events.each { |event| puts "#{event.timestamp} - #{event.physical_resource_id.to_s} - #{event.resource_type} - #{event.resource_status} - #{event.resource_status_reason.to_s}" }
+        printed.concat(printable_events.map(&:event_id))
+        break if END_STATES.include?(stack.status)
+        sleep(30)
+      end
+    end
+  end
+
+  def with_highlight(&block)
+    cols = `tput cols`.chomp!.to_i
+    puts "=" * cols
+    yield
+    puts "=" * cols
+  end
+
+  def update(template, parameters, capabilities)
+    stack.update({
+      :template => template,
+      :parameters => parameters,
+      :capabilities => capabilities
+    })
+    return true
+  end
+
+  def create(template, parameters, disable_rollback, capabilities, notify, tags)
+    puts "Initializing stack creation..."
+    @cf.stacks.create(name, template, :parameters => parameters, :disable_rollback => disable_rollback, :capabilities => capabilities, :notify => notify, :tags => tags)
+    sleep 10
+    return true
+  end
+
+  def update_instances(action)
+    with_highlight do
+      puts "Attempting to #{action} all ec2 instances in the stack #{stack.name}"
+      return "Stack not up" if !deployed
+      stack.resources.each do |resource|
+        begin
+          next if resource.resource_type != "AWS::EC2::Instance"
+          physical_resource_id = resource.physical_resource_id
+          puts "Attempting to #{action} Instance with physical_resource_id: #{physical_resource_id}"
+          @ec2.instances[physical_resource_id].send(action)
+        rescue
+          puts "Some resources are not up."
+        end
+      end
+    end
+  end
+end

data/lib/cloudformer/tasks.rb

@@ -0,0 +1,114 @@
+require "cloudformer/version"
+require "cloudformer/stack"
+require "rake/tasklib"
+
+module Cloudformer
+  # CloudFormer Rake Tasks
+  class Tasks < Rake::TaskLib
+    def initialize(stack_name)
+      @stack_name = stack_name
+      @stack = Stack.new(stack_name)
+      if block_given?
+        yield self
+        define_tasks
+      end
+    end
+
+    attr_accessor :template, :parameters, :disable_rollback, :retry_delete, :capabilities, :notify, :tags
+
+    private
+
+    def define_tasks
+      define_create_task
+      define_validate_task
+      define_delete_task
+      define_delete_with_stop_task
+      define_events_task
+      define_status_task
+      define_outputs_task
+      define_recreate_task
+      define_stop_task
+      define_start_task
+    end
+
+    def define_create_task
+      desc "Apply Stack with Cloudformation script and parameters."
+      task :apply do
+        retry_delete && @stack.delete
+        result = @stack.apply(template, parameters, disable_rollback, capabilities, notify, tags)
+        result == :Failed && exit(1)
+        result == :NoUpdates && exit(0)
+      end
+    end
+
+    def define_delete_task
+      desc "Delete stack from CloudFormation"
+      task :delete do
+        begin
+          exit 1 unless @stack.delete
+        rescue
+          puts "Stack deleted successfully."
+        end
+      end
+    end
+
+    def define_delete_with_stop_task
+      desc "Delete stack after stopping all instances"
+      task :force_delete do
+        begin
+          @stack.stop_instances
+          exit 1 unless @stack.delete
+        rescue => e
+          puts "Stack delete message - #{e.message}"
+        end
+      end
+    end
+
+    def define_status_task
+      desc "Get the deployed app status."
+      task :status do
+        @stack.status
+      end
+    end
+
+    def define_events_task
+      desc "Get the recent events from the stack."
+      task :events do
+        @stack.events
+      end
+    end
+
+    def define_outputs_task
+      desc "Get the outputs of stack."
+      task :outputs do
+        @stack.outputs
+      end
+    end
+
+    def define_recreate_task
+      desc "Recreate stack."
+      task :recreate => %i[delete apply outputs]
+    end
+
+    def define_stop_task
+      desc "Stop EC2 instances in stack."
+      task :stop do
+        @stack.stop_instances
+      end
+    end
+
+    def define_start_task
+      desc "Start EC2 instances in stack."
+      task :start do
+        @stack.start_instances
+      end
+    end
+
+    def define_validate_task
+      desc "Validate the Stack."
+      task :validate do
+        @stack.validate(template)
+      end
+    end
+  end
+end

data/lib/cloudformer/version.rb

@@ -0,0 +1,3 @@
+module Cloudformer
+  VERSION = "1.0.18".freeze
+end

data/samples/Rakefile

@@ -0,0 +1,9 @@
+require 'cloudformer2'
+
+Cloudformer::Tasks.new("dennis-test") do |t|
+  t.template = "basic_template.json"
+  #AMI Works in Sydney region only, ensure you supply the right AMI.
+  t.parameters = {"AmiId" => "ami-8da439b7"}
+  t.disable_rollback = true
+  t.capabilities=[]
+end

data/samples/basic_template.json

@@ -0,0 +1,31 @@
+{
+  "AWSTemplateFormatVersion": "2010-09-09",
+  "Description": "Cloudformer - Demo App",
+  "Parameters": {
+    "AmiId": {
+      "Type": "String"
+    }
+    },
+    "Resources": {
+      "ApplicationServer": {
+        "Type": "AWS::EC2::Instance",
+        "Properties": {
+          "ImageId": {
+            "Ref": "AmiId"
+            },
+            "InstanceType": "t1.micro",
+            "Monitoring": "false"
+        }
+      }
+    },
+    "Outputs": {
+      "Server": {
+        "Value": {
+          "Fn::GetAtt": [
+            "ApplicationServer",
+            "PrivateIp"
+          ]
+        }
+      }
+    }
+}

data/spec/stack_spec.rb

@@ -0,0 +1,87 @@
+require 'cloudformer/stack'
+
+describe Stack do
+  before :each do
+    @cf = double(AWS::CloudFormation)
+    @cf_stack = double(AWS::CloudFormation::Stack)
+    @collection = double(AWS::CloudFormation::StackCollection)
+    AWS::CloudFormation.should_receive(:new).and_return(@cf)
+    @collection.should_receive(:[]).and_return(@cf_stack)
+    @cf.should_receive(:stacks).and_return(@collection)
+  end
+  describe "when deployed" do
+    before :each do
+      @stack = Stack.new("stack")
+    end
+
+    it "should report as the stack being deployed" do
+      @cf_stack.should_receive(:exists?).and_return(true)
+      @stack.deployed.should be
+    end
+
+## Broken spec from original repo
+#    describe "#delete" do
+#      it "should return a true if delete fails" do
+#        pending
+#        @cf_stack.should_receive(:exists?).and_return(false)
+#        @cf_stack.should_receive(:status)
+#        @stack.delete.should be
+#      end
+#    end
+  end
+
+  describe "when stack is not deployed" do
+    before :each do
+      @stack = Stack.new("stack")
+    end
+
+    it "should report as the stack not being deployed" do
+      @cf_stack.should_receive(:exists?).and_return(false)
+      @stack.deployed.should_not be
+    end
+  end
+
+  describe "when stack operation throws ValidationError" do
+    before :each do
+      @stack = Stack.new("stack")
+      @cf_stack.should_receive(:exists?).and_return(true)
+      File.should_receive(:read).and_return("template")
+      @cf.should_receive(:validate_template).and_return({"valid" => true})
+      @cf_stack.should_receive(:update).and_raise(AWS::CloudFormation::Errors::ValidationError)
+    end
+
+    it "apply should return Failed to signal the error" do
+      @stack.apply(nil, nil).should be(:Failed)
+    end
+  end
+
+  describe "when stack operation throws ValidationError because no updates are to be performed" do
+    before :each do
+      @stack = Stack.new("stack")
+      @cf_stack.should_receive(:exists?).and_return(true)
+      File.should_receive(:read).and_return("template")
+      @cf.should_receive(:validate_template).and_return({"valid" => true})
+      @cf_stack.should_receive(:update).and_raise(AWS::CloudFormation::Errors::ValidationError.new("No updates are to be performed."))
+    end
+
+    it "apply should return NoUpdate to signal the error" do
+      @stack.apply(nil, nil).should be(:NoUpdates)
+    end
+  end
+
+  describe "when stack update succeeds" do
+    before :each do
+      @stack = Stack.new("stack")
+      @cf_stack.should_receive(:exists?).at_least(:once).and_return(true)
+      File.should_receive(:read).and_return("template")
+      @cf.should_receive(:validate_template).and_return({"valid" => true})
+      @cf_stack.should_receive(:update).and_return(false)
+      @cf_stack.should_receive(:events).and_return([])
+      @cf_stack.should_receive(:status).at_least(:once).and_return("UPDATE_COMPLETE")
+    end
+
+    it "apply should return Succeeded" do
+      @stack.apply(nil, nil).should be(:Succeeded)
+    end
+  end
+end

metadata

@@ -0,0 +1,149 @@
+--- !ruby/object:Gem::Specification
+name: cloudformer2
+version: !ruby/object:Gem::Version
+  version: 1.0.18
+platform: ruby
+authors:
+- Sentia MPC
+- Dennis Vink
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-07-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: aws-sdk-v1
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.67.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.67.0
+- !ruby/object:Gem::Dependency
+  name: aws-sdk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.10.9
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.10.9
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Cloudformation tasks for apply(create/update), delete, recreate on stack
+  along with validations on templates
+email:
+- dennis.vink@sentia.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- CHANGELOG.md
+- Dockerfile
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- cloudformer2.gemspec
+- docker-compose.yml
+- lib/cloudformer/cloudformer.rb
+- lib/cloudformer/stack.rb
+- lib/cloudformer/tasks.rb
+- lib/cloudformer/version.rb
+- samples/Rakefile
+- samples/basic_template.json
+- spec/stack_spec.rb
+homepage: https://github.com/sentialabs/cloudformer2
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Cloudformer attempts to simplify AWS Cloudformation stack creation process
+  in ruby projects by providing reusable rake tasks to perform common operations such
+  as apply(create/update), delete, recreate on stack along with validations on templates.
+test_files:
+- spec/stack_spec.rb