cloudster 2.3.0 → 2.4.0

data/README.md

@@ -44,10 +44,18 @@ Now you can do stuff like :
 
         stack.provision(:resources => [app_server, app_server_2, load_balancer], :stack_name => 'TestStack', :description => 'Description of the stack')
 
+- Update the stack :
+
+        stack.update(:resources => [app_server, app_server_2], :stack_name => 'TestStack', :description => 'Description of the stack')
+
 - You can get the events of a stack using :
 
         stack.events(:stack_name => 'TestStack')
 
+- You can delete the stack and it's attached resources :
+
+        stack.delete(:stack_name => 'TestStack')
+
 
 ##License
 

data/VERSION

@@ -1 +1 @@
-2.3.0
+2.4.0

data/cloudster.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "cloudster"
-  s.version = "2.3.0"
+  s.version = "2.4.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Emil Soman"]
-  s.date = "2012-10-30"
+  s.date = "2012-10-31"
   s.description = "Cloudster uses the AWS APIs to provision stacks on Amazon Cloud."
   s.email = "emil.soman@gmail.com"
   s.extra_rdoc_files = [
@@ -31,9 +31,11 @@ Gem::Specification.new do |s|
     "lib/cloudster/ec2.rb",
     "lib/cloudster/elb.rb",
     "lib/cloudster/options_manager.rb",
+    "lib/cloudster/rds.rb",
     "spec/cloud_spec.rb",
     "spec/ec2_spec.rb",
     "spec/elb_spec.rb",
+    "spec/rds_spec.rb",
     "spec/spec_helper.rb"
   ]
   s.homepage = "http://github.com/emilsoman/cloudster"

data/lib/cloudster.rb

@@ -6,4 +6,5 @@ require 'cloudster/options_manager'
 include OptionsManager
 require 'cloudster/ec2'
 require 'cloudster/elb'
+require 'cloudster/rds'
 require 'cloudster/cloud'

data/lib/cloudster/cloud.rb

@@ -143,5 +143,26 @@ module Cloudster
       return @cloud_formation.describe_stack_events(options[:stack_name])
     end
 
+    # Deletes a stack and the attached resources
+    #
+    # ==== Examples
+    #   cloud = Cloudster::Cloud.new(
+    #    :access_key_id => 'aws_access_key_id'
+    #    :secret_access_key => 'aws_secret_access_key',
+    #   )
+    #   cloud.delete(:stack_name => 'ShittyStack')
+    #
+    # ==== Parameters
+    # * options<~Hash>
+    #   * :stack_name : A string which will contain the name of the stack for which will be deleted
+    #
+    # ==== Returns
+    # * response<~Excon::Response>:
+    #   * body<~Hash>:
+    def delete(options = {})
+      require_options(options, [:stack_name])
+      return @cloud_formation.delete_stack(options[:stack_name])
+    end
+
   end
 end

data/lib/cloudster/rds.rb

@@ -0,0 +1,114 @@
+module Cloudster
+  #==Rds resource
+  class Rds
+
+    # Initialize an Rds instance
+    #
+    # ==== Notes
+    # options parameter must include values for :name, :storage_size
+    #
+    # ==== Examples
+    #   rds = Cloudster::Rds.new(
+    #    :name => 'MySqlDB',
+    #    :instance_class => 'db.t1.micro',
+    #    :storage_class => '100',
+    #    :username => 'admin',
+    #    :password => 'admin123',
+    #    :engine => 'MySQL'
+    #   )
+    #
+    # ==== Parameters
+    # * options<~Hash> - 
+    #   *Keys: 
+    #     * :name: String containing the name for the Rds resource. Mandatory option.
+    #     * :instance_class: String containing the name of the compute and memory capacity class of the DB instance. Default: 'db.t1.micro'
+    #     * :storage_size: String containing the allocated storage size specified in gigabytes. Mandatory option.
+    #     * :username: String containing the master username for the DB instance. Default: 'root'
+    #     * :password: String containing the master password for the DB instance. Default: 'root'
+    #     * :engine: String containing the name of the database engine to be used for this DB instance. Default: 'MySQL'
+    #     Valid values : MySQL | oracle-se1 | oracle-se | oracle-ee | sqlserver-ee | sqlserver-se | sqlserver-ex | sqlserver-web
+    def initialize(options = {})
+      require_options(options, [:name, :storage_size])
+      options[:username] ||= 'root'
+      options[:password] ||= 'root'
+      options[:engine] ||= 'MySQL'
+      options[:instance_class] ||= 'db.t1.micro'
+      @name = options[:name]
+      @storage_size = options[:storage_size]
+      @username = options[:username]
+      @password = options[:password]
+      @engine = options[:engine]
+      @instance_class = options[:instance_class]
+    end
+
+    # Returns a Ruby hash version of the Cloud Formation template for the resource instance
+    #
+    # ==== Examples
+    #   rds = Cloudster::Rds.new(
+    #    :name => 'MySqlDB',
+    #    :instance_class => 'db.t1.micro',
+    #    :storage_class => '100',
+    #    :username => 'admin',
+    #    :password => 'admin123',
+    #    :engine => 'MySQL'
+    #   )
+    #   rds.template
+    #
+    # ==== Returns
+    # * Ruby hash version of the Cloud Formation template for the resource instance
+    def template
+      Rds.template({:name =>@name, :instance_class => @instance_class, :storage_size => @storage_size, :username => @username, :password => @password, :engine => @engine})
+    end
+
+    # Class method that returns a Ruby hash version of the Cloud Formation template
+    #
+    # ==== Notes
+    # options parameter must include values for :name, :storage_size
+    #
+    # ==== Examples
+    #   template = Cloudster::Rds.template(
+    #    :name => 'MySqlDB',
+    #    :instance_class => 'db.t1.micro',
+    #    :storage_class => '100',
+    #    :username => 'admin',
+    #    :password => 'admin123',
+    #    :engine => 'MySQL'
+    #   )
+    #
+    # ==== Parameters
+    # * options<~Hash> - 
+    #   *Keys: 
+    #     * :name: String containing the name for the Rds resource. Mandatory option.
+    #     * :instance_class: String containing the name of the compute and memory capacity class of the DB instance. Default: 'db.t1.micro'
+    #     * :storage_size: String containing the allocated storage size specified in gigabytes. Mandatory option.
+    #     * :username: String containing the master username for the DB instance. Default: 'root'
+    #     * :password: String containing the master password for the DB instance. Default: 'root'
+    #     * :engine: String containing the name of the database engine to be used for this DB instance. Default: 'MySQL'
+    #     Valid values : MySQL | oracle-se1 | oracle-se | oracle-ee | sqlserver-ee | sqlserver-se | sqlserver-ex | sqlserver-web
+    #
+    # ==== Returns
+    # * Ruby hash version of the Cloud Formation template
+    def self.template(options = {})
+      require_options(options, [:name, :storage_size])
+      options[:username] ||= 'root'
+      options[:password] ||= 'root'
+      options[:engine] ||= 'MySQL'
+      options[:instance_class] ||= 'db.t1.micro'
+      template = {'Resources' => { 
+                    options[:name] => {
+                      "Type" => "AWS::RDS::DBInstance",
+                      "Properties" => {
+                        "Engine" => options[:engine],
+                        "MasterUsername" => options[:username],
+                        "MasterUserPassword" => options[:password],
+                        "DBInstanceClass" => options[:instance_class],
+                        "AllocatedStorage" => options[:storage_size]
+                      }
+                    }
+                  }
+      }
+      return template 
+    end
+
+  end
+end

data/spec/cloud_spec.rb

@@ -13,9 +13,10 @@ describe Cloudster::Cloud do
     it "should return a ruby hash for the stack cloudformation template" do
       ec2 = Cloudster::Ec2.new(:key_name => 'testkey', :image_id => 'image_id', name: 'name')
       ec2_1 = Cloudster::Ec2.new(:key_name => 'testkey1', :image_id => 'image_id1', name: 'name1')
+      rds = Cloudster::Rds.new(:name => 'MySqlDB', :storage_size => '10') 
       elb = Cloudster::Elb.new(:name => 'ELB', :instance_names => ['name','name1'])
       cloud = Cloudster::Cloud.new(:access_key_id => 'test', :secret_access_key => 'test')
-      cloud.template(:resources => [ec2, ec2_1, elb], :description => 'test template').should == {"AWSTemplateFormatVersion"=>"2010-09-09", 
+      cloud.template(:resources => [ec2, ec2_1, rds, elb], :description => 'test template').should == {"AWSTemplateFormatVersion"=>"2010-09-09", 
         "Description"=>"test template",
         "Resources"=>{
           "name"=>{
@@ -31,6 +32,16 @@ describe Cloudster::Cloud do
                 "ImageId"=>"image_id1"
                  }
             },
+            'MySqlDB' => {
+              "Type" => "AWS::RDS::DBInstance",
+              "Properties" => {
+                "Engine" => 'MySQL',
+                "MasterUsername" => 'root',
+                "MasterUserPassword" => 'root',
+                "DBInstanceClass" => 'db.t1.micro',
+                "AllocatedStorage" => '10'
+              }
+            },
            "ELB" => {
               "Type" => "AWS::ElasticLoadBalancing::LoadBalancer",
               "Properties" => {
@@ -68,9 +79,10 @@ describe Cloudster::Cloud do
       Fog::AWS::CloudFormation.should_receive(:new).with(:aws_access_key_id => 'test', :aws_secret_access_key => 'test').and_return cloud_formation
       ec2 = Cloudster::Ec2.new(:key_name => 'testkey', :image_id => 'image_id', name: 'name')
       elb = Cloudster::Elb.new(:name => 'ELB', :instance_names => ['name','name1'])
+      rds = Cloudster::Rds.new(:name => 'MySqlDB', :storage_size => '10') 
       cloud = Cloudster::Cloud.new(:access_key_id => 'test', :secret_access_key => 'test')
-      cloud_formation.should_receive('create_stack').with('stack_name', 'TemplateBody' => cloud.template(:resources => [ec2, elb], :description => 'testDescription'))
-      cloud.provision(:resources => [ec2, elb], :stack_name => 'stack_name', :description => 'testDescription')
+      cloud_formation.should_receive('create_stack').with('stack_name', 'TemplateBody' => cloud.template(:resources => [ec2, elb, rds], :description => 'testDescription'))
+      cloud.provision(:resources => [ec2, elb, rds], :stack_name => 'stack_name', :description => 'testDescription')
     end
   end
 
@@ -80,7 +92,7 @@ describe Cloudster::Cloud do
       cloud = Cloudster::Cloud.new(:access_key_id => 'test', :secret_access_key => 'test')
       expect { cloud.update(:description => 'test') }.to raise_error(ArgumentError, 'Missing required argument: resources,stack_name' )
     end
-    it "should trigger stack creation" do
+    it "should trigger stack update" do
       cloud_formation = double('CloudFormation')
       Fog::AWS::CloudFormation.should_receive(:new).with(:aws_access_key_id => 'test', :aws_secret_access_key => 'test').and_return cloud_formation
       ec2 = Cloudster::Ec2.new(:key_name => 'testkey', :image_id => 'image_id', name: 'name')
@@ -99,4 +111,18 @@ describe Cloudster::Cloud do
       cloud.events(:stack_name => 'stack_name')
     end
   end
+
+  describe '#delete' do
+    it "should raise argument error if resources not provided" do
+      cloud = Cloudster::Cloud.new(:access_key_id => 'test', :secret_access_key => 'test')
+      expect { cloud.delete() }.to raise_error(ArgumentError, 'Missing required argument: stack_name')
+    end
+    it "should trigger 'delete stack' request" do
+      cloud_formation = double('CloudFormation')
+      Fog::AWS::CloudFormation.should_receive(:new).with(:aws_access_key_id => 'test', :aws_secret_access_key => 'test').and_return cloud_formation
+      cloud = Cloudster::Cloud.new(:access_key_id => 'test', :secret_access_key => 'test')
+      cloud_formation.should_receive('delete_stack').with('stack_name')
+      cloud.delete(:stack_name => 'stack_name')
+    end
+  end
 end

data/spec/rds_spec.rb

@@ -0,0 +1,53 @@
+require 'spec_helper'
+
+describe Cloudster::Rds do
+  describe 'initialize' do
+    it "should raise argument error if no argument is not provided" do
+      expect { Cloudster::Rds.new() }.to raise_error(ArgumentError, 'Missing required argument: name,storage_size')
+    end
+    it "should not raise argument error if all arguments are provided" do
+      expect { Cloudster::Rds.new(:name => 'MySqlDB', :storage_size => '10') }.to_not raise_error
+    end
+  end
+  describe '#template' do
+    it "should return a ruby hash for the resource cloudformation template" do
+      rds = Cloudster::Rds.new(:name => 'MySqlDB', :storage_size => '10') 
+      template = {'Resources' => { 
+                    'MySqlDB' => {
+                      "Type" => "AWS::RDS::DBInstance",
+                      "Properties" => {
+                        "Engine" => 'MySQL',
+                        "MasterUsername" => 'root',
+                        "MasterUserPassword" => 'root',
+                        "DBInstanceClass" => 'db.t1.micro',
+                        "AllocatedStorage" => '10'
+                      }
+                    }
+                  }
+      }
+      rds.template.should == template 
+    end
+  end
+  describe '.template' do
+    it "should raise argument error if no argument is not provided" do
+      expect { Cloudster::Rds.template() }.to raise_error(ArgumentError, 'Missing required argument: name,storage_size')
+    end
+    it "should return a ruby hash for the resource cloudformation template" do
+      hash = Cloudster::Rds.template(:name => 'MySqlDB', :storage_size => '10')
+      template = {'Resources' => { 
+                    'MySqlDB' => {
+                      "Type" => "AWS::RDS::DBInstance",
+                      "Properties" => {
+                        "Engine" => 'MySQL',
+                        "MasterUsername" => 'root',
+                        "MasterUserPassword" => 'root',
+                        "DBInstanceClass" => 'db.t1.micro',
+                        "AllocatedStorage" => '10'
+                      }
+                    }
+                  }
+      }
+      hash.should == template 
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cloudster
 version: !ruby/object:Gem::Version
-  version: 2.3.0
+  version: 2.4.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-10-30 00:00:00.000000000 Z
+date: 2012-10-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fog
@@ -145,9 +145,11 @@ files:
 - lib/cloudster/ec2.rb
 - lib/cloudster/elb.rb
 - lib/cloudster/options_manager.rb
+- lib/cloudster/rds.rb
 - spec/cloud_spec.rb
 - spec/ec2_spec.rb
 - spec/elb_spec.rb
+- spec/rds_spec.rb
 - spec/spec_helper.rb
 homepage: http://github.com/emilsoman/cloudster
 licenses:
@@ -164,7 +166,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -954846317
+      hash: -380344941
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: