stackup 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 198c45027f791cb13d1ba1de4643fda60a97a18d
+  data.tar.gz: 7aab71076441135004a10109bda7a452ec15d75d
+SHA512:
+  metadata.gz: ff9a5468160fd18e6b4f80697457e76c653e5d5a755b776cd2873ee230e91148c9cd02dc9d402457e6c7ce468d8e016e6f0377b9512399c74394cf0e1d24cae2
+  data.tar.gz: 4d13507cc1022c2073b6feb0c13eea683b8983e2468489d470b5b5c40f9fea394340fe733d592283c9d852ebce45d6d8e1c87469b64c710aa321bca607ba7b4f

data/Gemfile

@@ -0,0 +1,11 @@
+source "https://rubygems.org" do
+  gemspec
+
+  gem "rake", "~> 10.0"
+
+  group :test do
+    gem "rspec", "~> 3.3"
+    gem "byebug"
+  end
+
+end

data/Gemfile.lock

@@ -0,0 +1,48 @@
+PATH
+  remote: .
+  specs:
+    stackup (0.0.1)
+      aws-sdk (~> 2.0)
+      clamp (~> 1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    aws-sdk (2.1.20)
+      aws-sdk-resources (= 2.1.20)
+    aws-sdk-core (2.1.20)
+      jmespath (~> 1.0)
+    aws-sdk-resources (2.1.20)
+      aws-sdk-core (= 2.1.20)
+    byebug (6.0.2)
+    clamp (1.0.0)
+    diff-lcs (1.2.5)
+    jmespath (1.0.2)
+      multi_json (~> 1.0)
+    multi_json (1.11.2)
+    rake (10.4.2)
+    rspec (3.3.0)
+      rspec-core (~> 3.3.0)
+      rspec-expectations (~> 3.3.0)
+      rspec-mocks (~> 3.3.0)
+    rspec-core (3.3.2)
+      rspec-support (~> 3.3.0)
+    rspec-expectations (3.3.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.3.0)
+    rspec-mocks (3.3.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.3.0)
+    rspec-support (3.3.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  byebug
+  rake (~> 10.0)
+  rspec (~> 3.3)
+  stackup!
+
+BUNDLED WITH
+   1.10.6

data/README.md

@@ -0,0 +1,40 @@
+# stackup
+
+Stackup attempts to simplify AWS Cloudformation stack creation process in
+ruby projects by providing executable 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).
+
+## Installation
+
+    $ gem install stackup
+
+## Usage
+
+The entry-point is the "stackup" command.
+
+The "stack" subcommand lists stacks:
+
+    $ stackup stacks
+
+Most other commands operate in the context of a named stack:
+
+    $ stackup stack STACK-NAME ...
+
+To create or update a stack, based on a template, use "apply":
+
+    $ stackup stack myapp-test apply
+
+This will:
+
+  * update (or create) the named CloudFormation stack, using the specified template
+  * monitor events until the stack update is complete
+  * print any stack "outputs"
+
+Other stack subcommands include:
+
+    $ stackup stack myapp-test outputs
+    $ stackup stack myapp-test resources
+    $ stackup stack myapp-test delete

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new do |t|
+  t.pattern = 'spec/**/*_spec.rb'
+  t.rspec_opts = ["--colour", "--format", "documentation"]
+end
+
+task "default" => "spec"

data/lib/stackup.rb

@@ -0,0 +1,3 @@
+require 'aws-sdk'
+require_relative 'stackup/monitor'
+require_relative 'stackup/stack'

data/lib/stackup/monitor.rb

@@ -0,0 +1,29 @@
+module Stackup
+  class Monitor
+    attr_accessor :stack, :events
+    def initialize(stack)
+      @stack = stack
+      @events = Set.new
+    end
+
+    def new_events
+      stack.events.take_while do |event|
+        !seen?(event)
+      end.reverse
+    rescue ::Aws::CloudFormation::Errors::ValidationError => e
+      []
+    end
+
+    private
+    def seen?(event)
+      event_id = event.event_id
+      if events.include?(event_id)
+        true
+      else
+        events.add(event_id)
+        false
+      end
+    end
+
+  end
+end

data/lib/stackup/stack.rb

@@ -0,0 +1,48 @@
+require 'set'
+
+module Stackup
+  class Stack
+    attr_reader :stack, :name, :cf, :template, :monitor
+    SUCESS_STATES = ["CREATE_COMPLETE", "UPDATE_COMPLETE"]
+    FAILURE_STATES = ["CREATE_FAILED", "DELETE_FAILED", "UPDATE_ROLLBACK_FAILED", "ROLLBACK_FAILED", "ROLLBACK_COMPLETE","ROLLBACK_FAILED","UPDATE_ROLLBACK_COMPLETE","UPDATE_ROLLBACK_FAILED"]
+    END_STATES = SUCESS_STATES + FAILURE_STATES
+
+    def initialize(name, template)
+      @cf = Aws::CloudFormation::Client.new
+      @stack = Aws::CloudFormation::Stack.new(name: name, client: cf)
+      @monitor = Stackup::Monitor.new(@stack)
+      @template = template
+      @name = name
+    end
+
+    def create
+      response = cf.create_stack({
+        stack_name: name,
+        template_body: template,
+        disable_rollback: true
+        })
+      !response[:stack_id].nil?
+      stack.wait_until(max_attempts: 1000, delay: 10) { |resource| display_events ; END_STATES.include?(resource.stack_status) }
+    end
+
+    def display_events
+      monitor.new_events.each do |e|
+        ts = e.timestamp.localtime.strftime("%H:%M:%S")
+        fields = [e.logical_resource_id, e.resource_status, e.resource_status_reason]
+        puts("[#{ts}] #{fields.compact.join(' - ')}")
+      end
+    end
+
+    def deployed?
+      !stack.stack_status.nil?
+    rescue Aws::CloudFormation::Errors::ValidationError => e
+      false
+    end
+
+    def valid?
+      response = cf.validate_template(template)
+      response[:code].nil?
+    end
+
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,5 @@
+require File.expand_path('../../lib/stackup', __FILE__)
+
+RSpec.configure do |c|
+  c.mock_with :rspec
+end

data/spec/stackup/monitor_spec.rb

@@ -0,0 +1,21 @@
+require 'spec_helper'
+
+describe Stackup::Monitor do
+  let(:stack) { Stackup::Stack.new('name', 'template') }
+  let(:monitor) { Stackup::Monitor.new(stack) }
+  let(:event) { double(Aws::CloudFormation::Event.new(id: '1')) }
+  let(:events) { [ event ]  }
+
+  it 'should add the event if it is non-existent' do
+    allow(event).to receive(:event_id).and_return('1')
+    allow(stack).to receive(:events).and_return(events)
+    expect(monitor.new_events.size).to eq(1)
+  end
+
+  it 'should skip the event if it has been shown' do
+    allow(event).to receive(:event_id).and_return('1')
+    allow(stack).to receive(:events).and_return(events)
+    expect(monitor.new_events.size).to eq(1)
+    expect(monitor.new_events.size).to eq(0)
+  end
+end

data/spec/stackup/stack_spec.rb

@@ -0,0 +1,54 @@
+require 'spec_helper'
+
+describe Stackup::Stack do
+  let(:stack) { Stackup::Stack.new('stack_name', double(String)) }
+  let(:cf_stack) { double(Aws::CloudFormation::Stack) }
+  let(:cf) {double(Aws::CloudFormation::Client)}
+
+  before do
+    allow(Aws::CloudFormation::Client).to receive(:new).and_return(cf)
+    allow(Aws::CloudFormation::Stack).to receive(:new).and_return(cf_stack)
+  end
+
+  context 'create' do
+    let(:response) {Seahorse::Client::Http::Response.new}
+    it 'should create stack if all is well' do
+      allow(response).to receive(:[]).with(:stack_id).and_return('1')
+      allow(cf).to receive(:create_stack).and_return(response)
+      allow(cf_stack).to receive(:wait_until).and_return(true)
+      expect(stack.create).to be true
+    end
+
+    it 'should return nil if stack was not created' do
+      allow(response).to receive(:[]).with(:stack_id).and_return(nil)
+      allow(cf).to receive(:create_stack).and_return(response)
+      allow(cf_stack).to receive(:wait_until).and_return(false)
+      expect(stack.create).to be false
+    end
+  end
+
+  context 'validate' do
+    it 'should be valid if cf validate say so' do
+      allow(cf).to receive(:validate_template).and_return({})
+      expect(stack.valid?).to be true
+    end
+
+    it 'should be invalid if cf validate say so' do
+      allow(cf).to receive(:validate_template).and_return({code: '404'})
+      expect(stack.valid?).to be false
+    end
+
+  end
+
+  context 'deployed' do
+    it 'should be true if it is already deployed' do
+      allow(cf_stack).to receive(:stack_status).and_return('CREATE_COMPLETE')
+      expect(stack.deployed?).to be true
+    end
+
+    it 'should be false if it is not deployed' do
+      allow(cf_stack).to receive(:stack_status).and_raise(Aws::CloudFormation::Errors::ValidationError.new('1', '2'))
+      expect(stack.deployed?).to be false
+    end
+  end
+end

data/stackup.gemspec

@@ -0,0 +1,22 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+Gem::Specification.new do |spec|
+
+  spec.name          = "stackup"
+  spec.version       = '0.0.1'
+  spec.authors       = ["Arvind Kunday", "Mike Williams"]
+  spec.email         = ["arvind.kunday@rea-group.com", "mike.williams@rea-group.com"]
+  spec.summary       = "Tools for deployment to AWS"
+  spec.homepage      = "https://github.com/realestate-com-au/stackup"
+  spec.license       = "MIT"
+
+  spec.files         = Dir["**/*"].reject { |f| File.directory?(f) }
+  spec.executables   = spec.files.grep(/^bin/) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "aws-sdk", "~> 2.0"
+  spec.add_dependency "clamp", "~> 1.0"
+
+end

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification
+name: stackup
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Arvind Kunday
+- Mike Williams
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-09-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: aws-sdk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: clamp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+description: 
+email:
+- arvind.kunday@rea-group.com
+- mike.williams@rea-group.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- lib/stackup.rb
+- lib/stackup/monitor.rb
+- lib/stackup/stack.rb
+- pkg/stackup-0.0.1.gem
+- spec/spec_helper.rb
+- spec/stackup/monitor_spec.rb
+- spec/stackup/stack_spec.rb
+- stackup.gemspec
+homepage: https://github.com/realestate-com-au/stackup
+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.4.5.1
+signing_key: 
+specification_version: 4
+summary: Tools for deployment to AWS
+test_files: []