simple_deploy 0.7.2 → 0.7.3

data/lib/simple_deploy/version.rb

@@ -1,3 +1,3 @@
 module SimpleDeploy
-  VERSION = "0.7.2"
+  VERSION = "0.7.3"
 end

data/lib/simple_deploy.rb

@@ -1,6 +1,9 @@
+require 'simple_deploy/aws'
 require 'simple_deploy/env'
+require 'simple_deploy/entry'
+require 'simple_deploy/entry_lister'
 require 'simple_deploy/exceptions'
-require 'simple_deploy/config'
+require 'simple_deploy/configuration'
 require 'simple_deploy/artifact'
 require 'simple_deploy/stack'
 require 'simple_deploy/misc'
@@ -9,3 +12,30 @@ require 'simple_deploy/notifier'
 require 'simple_deploy/logger'
 require 'simple_deploy/version'
 require 'simple_deploy/backoff'
+
+module SimpleDeploy
+  module_function
+
+  def create_config(environment, custom_config = {})
+    raise SimpleDeploy::Exceptions::IllegalStateException.new(
+      'environment is not defined') unless environment
+
+    @config = SimpleDeploy::Configuration.configure environment, custom_config
+  end
+
+  def config
+    @config
+  end
+
+  def release_config
+    @config = nil
+  end
+
+  def environments(custom_config = {})
+    SimpleDeploy::Configuration.environments custom_config
+  end
+
+  def logger(log_level = 'info')
+    @logger ||= SimpleDeployLogger.new :log_level => log_level
+  end
+end

data/simple_deploy.gemspec

@@ -20,10 +20,13 @@ Gem::Specification.new do |s|
 
   s.add_development_dependency "fakefs", "~> 0.4.2"
   s.add_development_dependency "rake"
-  s.add_development_dependency "rspec", "~> 2.11.0"
+  s.add_development_dependency "rspec", "~> 2.13.0"
+  s.add_development_dependency "simplecov", "~> 0.7.1"
+  s.add_development_dependency "timecop", "~> 0.6.1"
 
   s.add_runtime_dependency "capistrano", "= 2.13.5"
-  s.add_runtime_dependency "stackster", '= 0.4.4'
-  s.add_runtime_dependency "tinder", "= 1.8.0"
+  s.add_runtime_dependency "esbit", "~> 0.0.4"
   s.add_runtime_dependency "trollop", "= 2.0"
+  s.add_runtime_dependency "fog", "= 1.10.0"
+  s.add_runtime_dependency "xml-simple", "= 1.1.2"
 end

data/spec/aws/cloud_formation/error_spec.rb

@@ -0,0 +1,50 @@
+require 'spec_helper'
+
+describe SimpleDeploy::AWS::CloudFormation::Error do
+  include_context 'double stubbed config', :access_key => 'key',
+                                           :secret_key => 'XXX',
+                                           :region     => 'us-west-1'
+  include_context 'double stubbed logger'
+
+  before do
+    @exception_stub1 = stub 'Excon::Response'
+    @exception_stub1.stub(:response).and_return(@exception_stub1)
+    @exception_stub1.stub(:body).and_return('<opt><Error><Message>No updates are to be performed.</Message></Error></opt>')
+
+    @exception_stub2 = stub 'Excon::Response'
+    @exception_stub2.stub(:response).and_return(@exception_stub2)
+    @exception_stub2.stub(:body).and_return('<opt><Error><Message>Oops.</Message></Error></opt>')
+
+    @exception_stub3 = stub 'Excon::Response'
+    @exception_stub3.stub(:response).and_return(@exception_stub3)
+    @exception_stub3.stub(:body).and_return('<opt><Error><Message>Stack:test does not exist</Message></Error></opt>')
+  end
+
+  describe 'process' do
+    it 'should process no update messages' do
+      error = SimpleDeploy::AWS::CloudFormation::Error.new :exception => @exception_stub1
+      expect { error.process }.to_not raise_error SimpleDeploy::Exceptions::CloudFormationError
+    end
+
+    it 'should re-raise unkonwn errors as SimpleDeploy::CloudFormationError' do
+      error = SimpleDeploy::AWS::CloudFormation::Error.new :exception => @exception_stub2
+
+      lambda { error.process }.should raise_error SimpleDeploy::Exceptions::CloudFormationError
+    end
+
+    it 'should re-raise unkonwn errors as SimpleDeploy::CloudFormationError and set mesg' do
+      error = SimpleDeploy::AWS::CloudFormation::Error.new :exception => @exception_stub2
+      begin
+        error.process
+      rescue SimpleDeploy::Exceptions::CloudFormationError => e
+        e.message.should == "Oops."
+      end
+    end
+
+    it 'should reaise stck unkown messages as SimpleDeploy::UnknownStack' do
+      error = SimpleDeploy::AWS::CloudFormation::Error.new :exception => @exception_stub3
+      lambda { error.process }.should raise_error SimpleDeploy::Exceptions::UnknownStack
+    end
+
+  end
+end

data/spec/aws/cloud_formation_spec.rb

@@ -0,0 +1,207 @@
+require 'spec_helper'
+
+describe SimpleDeploy::AWS::CloudFormation do
+  include_context 'double stubbed config', :access_key => 'key',
+                                           :secret_key => 'XXX',
+                                           :region     => 'us-west-1'
+  include_context 'double stubbed logger'
+
+  before do
+    @error_stub = stub 'Error', :process => 'Processed Error'
+    @response_stub = stub 'Excon::Response', :body => { 
+        'Stacks' => [{'StackStatus' => 'green', 'Outputs' => [{'key' => 'value'}]}],
+        'StackResources' => [{'StackName' => 'my_stack'}],
+        'StackEvents' => ['event1', 'event2'],
+        'TemplateBody' => '{EIP: "string"}'
+    }
+
+    @cf_mock = mock 'CloudFormation'
+    Fog::AWS::CloudFormation.stub(:new).and_return(@cf_mock)
+
+    @args = {
+      :parameters => { 'parameter1' => 'my_param' },
+      :name => 'my_stack',
+      :template => 'my_template'
+    }
+
+    @exception = Exception.new('Failed')
+
+    @cf = SimpleDeploy::AWS::CloudFormation.new
+  end
+
+  after do
+    SimpleDeploy.release_config
+  end
+
+  describe "create" do
+    it "should create the stack on Cloud Formation" do
+      @cf_mock.should_receive(:create_stack).with('my_stack',
+                                                  { 'Capabilities' => ['CAPABILITY_IAM'],
+                                                    'TemplateBody' => 'my_template',
+                                                    'Parameters' => { 'parameter1' => 'my_param' }
+                                                  })
+
+      @cf.create(@args)
+    end
+
+    it "should trap and re-raise exceptions as SimpleDeploy::Exceptions::CloudFormationError" do
+      @cf_mock.should_receive(:create_stack).with('my_stack',
+                                                  { 'Capabilities' => ['CAPABILITY_IAM'],
+                                                    'TemplateBody' => 'my_template',
+                                                    'Parameters' => { 'parameter1' => 'my_param' }
+                                                  }).and_raise(@exception)
+
+      SimpleDeploy::AWS::CloudFormation::Error.should_receive(:new).
+        with(:exception => @exception).
+        and_raise SimpleDeploy::Exceptions::CloudFormationError.new('failed')
+
+      lambda { @cf.create @args }.
+        should raise_error SimpleDeploy::Exceptions::CloudFormationError
+    end
+  end
+
+  describe "update" do
+    it "should update the stack on Cloud Formation" do
+      @cf_mock.should_receive(:update_stack).with('my_stack',
+                                                  { 'Capabilities' => ['CAPABILITY_IAM'],
+                                                    'TemplateBody' => 'my_template',
+                                                    'Parameters' => { 'parameter1' => 'my_param' }
+                                                  })
+
+      @cf.update(@args)
+    end
+
+    it "should trap and re-raise exceptions as SimpleDeploy::Exceptions::CloudFormationError" do
+      @cf_mock.should_receive(:update_stack).with('my_stack',
+                                                  { 'Capabilities' => ['CAPABILITY_IAM'],
+                                                    'TemplateBody' => 'my_template',
+                                                    'Parameters' => { 'parameter1' => 'my_param' }
+                                                  }).and_raise(@exception)
+      SimpleDeploy::AWS::CloudFormation::Error.should_receive(:new).
+        with(:exception => @exception).
+        and_raise SimpleDeploy::Exceptions::CloudFormationError.new('failed')
+
+      lambda { @cf.update(@args) }.
+        should raise_error SimpleDeploy::Exceptions::CloudFormationError
+    end
+  end
+
+
+  describe 'destroy' do
+    it "should delete the stack on Cloud Formation" do
+      @cf_mock.should_receive(:delete_stack).with('my_stack')
+
+      @cf.destroy('my_stack')
+    end
+
+    it "should trap and re-raise exceptions as SimpleDeploy::Exceptions::CloudFormationError" do
+      @cf_mock.should_receive(:delete_stack).
+               with('my_stack').
+               and_raise @exception
+      SimpleDeploy::AWS::CloudFormation::Error.should_receive(:new).
+        with(:exception => @exception).
+        and_raise SimpleDeploy::Exceptions::CloudFormationError.new('failed')
+
+      lambda { @cf.destroy('my_stack') }.
+        should raise_error SimpleDeploy::Exceptions::CloudFormationError
+    end
+  end
+
+
+  describe 'describe_stack' do
+    it "should return the Cloud Formation description of the stack" do
+      @cf_mock.should_receive(:describe_stacks).with('StackName' => 'my_stack').and_return(@response_stub)
+
+      @cf.describe_stack('my_stack').should == [{'StackStatus' => 'green', 'Outputs' => [{'key' => 'value'}]}]
+    end
+
+    it "should trap and re-raise exceptions as SimpleDeploy::Exceptions::CloudFormationError" do
+      @cf_mock.should_receive(:describe_stacks).
+               with('StackName' => 'my_stack').
+               and_raise @exception
+      SimpleDeploy::AWS::CloudFormation::Error.should_receive(:new).
+        with(:exception => @exception).
+        and_raise SimpleDeploy::Exceptions::CloudFormationError.new('failed')
+
+      lambda { @cf.describe_stack('my_stack') }.
+        should raise_error SimpleDeploy::Exceptions::CloudFormationError
+    end
+  end
+
+  describe "stack_resources" do
+    it "should return the Cloud Formation description of the stack resources" do
+      @cf_mock.should_receive(:describe_stack_resources).with('StackName' => 'my_stack').and_return(@response_stub)
+
+      @cf.stack_resources('my_stack').should == [{'StackName' => 'my_stack'}]
+    end
+
+    it "should trap and re-raise exceptions as SimpleDeploy::Exceptions::CloudFormationError" do
+      @cf_mock.should_receive(:describe_stack_resources).
+               with('StackName' => 'my_stack').
+               and_raise @exception
+      SimpleDeploy::AWS::CloudFormation::Error.should_receive(:new).
+        with(:exception => @exception).
+        and_raise SimpleDeploy::Exceptions::CloudFormationError.new('failed')
+
+      lambda { @cf.stack_resources('my_stack') }.
+        should raise_error SimpleDeploy::Exceptions::CloudFormationError
+    end
+  end
+
+  describe "stack_events" do
+    it "should return the Cloud Formation description of the stack events" do
+      @cf_mock.should_receive(:describe_stack_events).with('my_stack').and_return(@response_stub)
+
+      @cf.stack_events('my_stack', 2).should == ['event1', 'event2']
+    end
+
+    it "should trap and re-raise exceptions as SimpleDeploy::Exceptions::CloudFormationError" do
+      @cf_mock.should_receive(:describe_stack_events).
+               with('my_stack').
+               and_raise @exception
+
+      SimpleDeploy::AWS::CloudFormation::Error.should_receive(:new).
+        with(:exception => @exception).
+        and_raise SimpleDeploy::Exceptions::CloudFormationError.new('failed')
+
+      lambda { @cf.stack_events('my_stack', 2) }.
+        should raise_error SimpleDeploy::Exceptions::CloudFormationError
+    end
+  end
+
+  describe "stack_status" do
+    it "should return the Cloud Formation status of the stack" do
+      @cf_mock.should_receive(:describe_stacks).with('StackName' => 'my_stack').and_return(@response_stub)
+
+      @cf.stack_status('my_stack').should == 'green'
+    end
+  end
+
+  describe "stack_outputs" do
+    it "should return the Cloud Formation outputs for the stack" do
+      @cf_mock.should_receive(:describe_stacks).with('StackName' => 'my_stack').and_return(@response_stub)
+
+      @cf.stack_outputs('my_stack').should == [{'key' => 'value'}]
+    end
+  end
+
+  describe "template" do
+    it "should return the Cloud Formation template for the stack" do
+      @cf_mock.should_receive(:get_template).with('my_stack').and_return(@response_stub)
+
+      @cf.template('my_stack').should == '{EIP: "string"}'
+    end
+
+    it "should trap and re-raise exceptions as SimpleDeploy::Exceptions::CloudFormationError" do
+      @cf_mock.should_receive(:get_template).
+               with('my_stack').
+               and_raise @exception
+      SimpleDeploy::AWS::CloudFormation::Error.should_receive(:new).
+        with(:exception => @exception).
+        and_raise SimpleDeploy::Exceptions::CloudFormationError.new('failed')
+
+      lambda { @cf.template('my_stack') }.
+        should raise_error SimpleDeploy::Exceptions::CloudFormationError
+    end
+  end
+end

data/spec/aws/instance_reader_spec.rb

@@ -0,0 +1,96 @@
+require 'spec_helper'
+
+describe SimpleDeploy::AWS::InstanceReader do
+  include_context 'double stubbed logger'
+  include_context 'double stubbed config', :access_key => 'key',
+                                           :secret_key => 'XXX',
+                                           :region     => 'us-west-1'
+
+  describe "list_stack_instances" do
+    before do
+      @cloud_formation_mock          = mock 'cloud formation'
+      @auto_scaling_groups_mock      = mock 'auto scaling'
+      @ec2_mock                      = mock 'ec2'
+
+      instances = ['first',{ 'Instances' => [{ 'InstanceId' => 'i-000001' },
+                                             { 'InstanceId' => 'i-000002' }] }]
+      body =  { 'DescribeAutoScalingGroupsResult' => { 'AutoScalingGroups' => instances } }
+      @list_response = stub 'Fog::Response', :body => body, :any? => true
+
+      empty_body =  { 'DescribeAutoScalingGroupsResult' => { 'AutoScalingGroups' => [] } }
+      @empty_response = stub 'Fog::Response', :body => empty_body
+
+      @describe_response = stub 'Excon::Response', :body => {
+        'reservationSet' => [{
+          'instanceSet' => [{'instanceState' => {'name' => 'running'}},
+                            {'ipAddress' => '54.10.10.1'},
+                            {'instanceId' => 'i-123456'},
+                            {'privateIpAddress' => '192.168.1.1'}]}]
+      }
+
+      SimpleDeploy::AWS::CloudFormation.stub(:new).
+                                        and_return @cloud_formation_mock
+    end
+
+    context "with no ASGs" do
+      before do
+        @cloud_formation_mock.should_receive(:stack_resources).
+                              with('stack').
+                              and_return []
+      end
+
+      it "should return an empty array" do
+        instance_reader = SimpleDeploy::AWS::InstanceReader.new
+        instance_reader.list_stack_instances('stack').should == []
+      end
+    end
+
+    context "with an ASG" do
+      before do
+        stack_resource_results = [{'StackName' => 'stack',
+                                   'ResourceType' => 'AWS::AutoScaling::AutoScalingGroup',
+                                   'PhysicalResourceId' => 'asg1'}]
+
+        @cloud_formation_mock.should_receive(:stack_resources).
+                              with('stack').
+                              and_return stack_resource_results
+
+        Fog::AWS::AutoScaling.stub(:new).
+                              and_return @auto_scaling_groups_mock
+      end
+
+      context "with no running instances" do
+        it "should return empty array" do
+          @auto_scaling_groups_mock.should_receive(:describe_auto_scaling_groups).
+                                    with('AutoScalingGroupNames' => ['asg1']).
+                                    and_return(@empty_response)
+
+          instance_reader = SimpleDeploy::AWS::InstanceReader.new
+          instance_reader.list_stack_instances('stack').should == []
+        end
+      end
+
+      context "with running instances" do
+        it "should return the reservation set for each running instance" do
+          @auto_scaling_groups_mock.should_receive(:describe_auto_scaling_groups).
+                                    with('AutoScalingGroupNames' => ['asg1']).
+                                    and_return(@list_response)
+
+          Fog::Compute::AWS.stub(:new).
+                            and_return @ec2_mock
+          @ec2_mock.should_receive(:describe_instances).
+                    with('instance-state-name' => 'running',
+                         'instance-id' => ['i-000001', 'i-000002']).
+                    and_return @describe_response
+
+          instance_reader = SimpleDeploy::AWS::InstanceReader.new
+          instance_reader.list_stack_instances('stack').should == [{
+            'instanceSet' => [{'instanceState' => {'name' => 'running'}},
+                              {'ipAddress' => '54.10.10.1'},
+                              {'instanceId' => 'i-123456'},
+                              {'privateIpAddress' => '192.168.1.1'}]}]
+        end
+      end
+    end
+  end
+end

data/spec/aws/simpledb_spec.rb

@@ -0,0 +1,89 @@
+require 'spec_helper'
+
+describe SimpleDeploy::AWS::SimpleDB do
+  include_context 'double stubbed config', :access_key => 'key',
+                                           :secret_key => 'XXX',
+                                           :region     => 'us-west-1'
+
+  before do
+    @response_stub = stub 'Excon::Response', :body => { 
+      'RequestId' => 'rid',
+      'Domains' => ['domain1', 'domain2'],
+      'Items' => { 'item1' => { 'key' => ['value'] } },
+      'NextToken' => nil
+    }
+    @multi_response_stub = stub 'Excon::Response', :body => { 
+      'RequestId' => 'rid',
+      'Domains' => ['domain1', 'domain2'],
+      'Items' => { 'item1-2' => { 'key' => ['value'] } },
+      'NextToken' => 'Chunk2'
+    }
+
+    @db_mock = mock 'SimpleDB'
+    Fog::AWS::SimpleDB.stub(:new).and_return(@db_mock)
+    @db_mock.stub(:list_domains).and_return(@response_stub)
+
+    @db = SimpleDeploy::AWS::SimpleDB.new
+  end
+
+  describe 'domains' do
+    it 'should return a list of domains' do
+      @db.domains.should == ['domain1', 'domain2']
+    end
+  end
+
+  describe 'domain_exists?' do
+    it 'should return true for existing domains' do
+      @db.domain_exists?('domain1').should be_true
+    end
+
+    it 'should return false for non-existent domains' do
+      @db.domain_exists?('baddomain1').should_not be_true
+    end
+  end
+
+  describe 'create_domain' do
+    it 'should create a new domain' do
+      @db_mock.should_receive(:create_domain).with('newdomain').and_return(@response_stub)
+
+      @db.create_domain('newdomain').body['RequestId'].should == 'rid'
+    end
+
+    it 'should not create a duplicate domain' do
+      @db_mock.should_not_receive(:create_domain)
+
+      @db.create_domain('domain1').should be_nil
+    end
+  end
+
+  describe 'put_attributes' do
+    it 'should update the specified domain' do
+      @db_mock.should_receive(:put_attributes).with('domain1', 'item1', { 'key' => 'value' }, {}).and_return(@response_stub)
+
+      @db.put_attributes('domain1', 'item1', { 'key' => 'value' }, {}).body['RequestId'].should == 'rid'
+    end
+  end
+
+  describe 'select' do
+    it 'should return query items' do
+      @db_mock.should_receive(:select).with('item1', { "ConsistentRead" => true, "NextToken" => nil } ).and_return(@response_stub)
+
+      @db.select('item1').should == { 'item1' => { 'key' => ['value'] } }
+    end
+
+    it 'should return multiple chunks of query items' do
+      @db_mock.should_receive(:select).with('item1', { "ConsistentRead" => true, "NextToken" => nil } ).and_return(@multi_response_stub)
+      @db_mock.should_receive(:select).with('item1', { "ConsistentRead" => true, "NextToken" => 'Chunk2' } ).and_return(@response_stub)
+
+      @db.select('item1').should == { 'item1' => { 'key' => ['value'] }, 'item1-2' => { 'key' => ['value'] } }
+    end
+  end
+
+  describe 'delete' do
+    it 'should delete the attributes identified by domain and key' do
+      @db_mock.should_receive(:delete_attributes).with('domain1', 'item1').and_return(@response_stub)
+
+      @db.delete('domain1', 'item1').body['RequestId'].should == 'rid'
+    end
+  end
+end