cloudster 2.6.1 → 2.7.0

data/README.md

@@ -22,7 +22,6 @@ Create AWS resources :
      :validation_key => 'asd3e33880889098asdnmnnasd8900890a8sdmasdjna9s880808asdnmnasd90-a',
      :server_url => 'http://10.50.60.70:4000',
      :node_name => 'project.environment.appserver_1',
-     :environment => 'production',
      :interval => 1800
     )
 

data/VERSION

@@ -1 +1 @@
-2.6.1
+2.7.0

data/cloudster.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "cloudster"
-  s.version = "2.6.1"
+  s.version = "2.7.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Emil Soman"]
-  s.date = "2012-11-16"
+  s.date = "2012-11-18"
   s.description = "Cloudster is a Ruby gem that was born to cut the learning curve involved \n    in writing your own CloudFormation templates. If you don't know what a CloudFormation template is, \n    but know about the AWS Cloud offerings, you can still use cloudster to provision your stack. \n    Still in infancy , cloudster can create a very basic stack like a breeze. All kinds of contribution welcome !"
   s.email = "emil.soman@gmail.com"
   s.extra_rdoc_files = [

data/lib/cloudster/cloud.rb

@@ -20,9 +20,9 @@ module Cloudster
     #   )
     def initialize(options = {})
       require_options(options, [:access_key_id, :secret_access_key])
-      access_key_id = options[:access_key_id]
-      secret_access_key = options[:secret_access_key]
-      @cloud_formation = Fog::AWS::CloudFormation.new(:aws_access_key_id => access_key_id, :aws_secret_access_key => secret_access_key)
+      @access_key_id = options[:access_key_id]
+      @secret_access_key = options[:secret_access_key]
+      @cloud_formation = Fog::AWS::CloudFormation.new(:aws_access_key_id => @access_key_id, :aws_secret_access_key => @secret_access_key)
     end
 
     # Generates CloudFormation Template for the stack
@@ -164,5 +164,111 @@ module Cloudster
       return @cloud_formation.delete_stack(options[:stack_name])
     end
 
+    # Returns all RDS(database) endpoints in a stack
+    #
+    # ==== Examples
+    #   cloud = Cloudster::Cloud.new(
+    #    :access_key_id => 'aws_access_key_id'
+    #    :secret_access_key => 'aws_secret_access_key',
+    #   )
+    #   cloud.get_database_endpoints(:stack_name => 'ShittyStack')
+    #
+    # ==== Parameters
+    # * options<~Hash>
+    #   * :stack_name : A string which will contain the name of the stack
+    #
+    # ==== Returns
+    # * Array of hashes, example: [{:address => 'simcoprod01.cu7u2t4uz396.us-east-1.rds.amazonaws.com', :port => '3306'}]
+    def get_database_endpoints(options = {})
+      rds_physical_ids = get_rds_resource_ids(resources(options))
+      return [] if rds_physical_ids.empty?
+      rds = Fog::AWS::RDS.new(:aws_access_key_id => @access_key_id, :aws_secret_access_key => @secret_access_key)
+      endpoints = []
+      rds_physical_ids.each do |rds_physical_id|
+        endpoint = rds.describe_db_instances(rds_physical_id).body["DescribeDBInstancesResult"]["DBInstances"][0]["Endpoint"] rescue nil
+        endpoints << {:address => endpoint["Address"], :port => endpoint["Port"]} unless endpoint.nil?
+      end
+      return endpoints
+    end
+
+    # Returns an array containing a list of Resources in a stack
+    #
+    # ==== Examples
+    #   cloud = Cloudster::Cloud.new(
+    #    :access_key_id => 'aws_access_key_id'
+    #    :secret_access_key => 'aws_secret_access_key',
+    #   )
+    #   cloud.resources(:stack_name => 'RDSStack')
+    #
+    # ==== Parameters
+    # * options<~Hash>
+    #   * :stack_name : A string which will contain the name of the stack
+    #
+    # ==== Returns
+    # * Array of hashes, example: [{"Timestamp"=>2012-11-16 14:31:55 UTC, "ResourceStatus"=>"CREATE_COMPLETE", "StackId"=>"arn:aws::asd", "LogicalResourceId"=>"TestDB", "StackName"=>"RDSStack", "PhysicalResourceId"=>"rtad", "ResourceType"=>"AWS::RDS::DBInstance"}]
+    def resources(options = {})
+      require_options(options, [:stack_name])
+      return @cloud_formation.describe_stack_resources('StackName' => options[:stack_name]).body["StackResources"] rescue []
+    end
+
+    # Describes the attributes of a Stack
+    #
+    # ==== Examples
+    #   cloud = Cloudster::Cloud.new(
+    #    :access_key_id => 'aws_access_key_id'
+    #    :secret_access_key => 'aws_secret_access_key',
+    #   )
+    #   cloud.describe(:stack_name => 'RDSStack')
+    #
+    # ==== Parameters
+    # * options<~Hash>
+    #   * :stack_name : A string which will contain the name of the stack
+    #
+    # ==== Returns
+    # * Hash containing description of the stack
+    def describe(options = {})
+      require_options(options, [:stack_name])
+      return @cloud_formation.describe_stacks('StackName' => options[:stack_name]).body["Stacks"][0] rescue nil
+    end
+
+    # Returns the status of the stack
+    #
+    # ==== Examples
+    #   cloud = Cloudster::Cloud.new(
+    #    :access_key_id => 'aws_access_key_id'
+    #    :secret_access_key => 'aws_secret_access_key',
+    #   )
+    #   cloud.status(:stack_name => 'RDSStack')
+    #
+    # ==== Parameters
+    # * options<~Hash>
+    #   * :stack_name : A string which will contain the name of the stack
+    #
+    # ==== Returns
+    # * One of these strings :
+    #   * CREATE_IN_PROGRESS
+    #   * CREATE_FAILED
+    #   * CREATE_COMPLETE
+    #   * ROLLBACK_IN_PROGRESS
+    #   * ROLLBACK_FAILED
+    #   * ROLLBACK_COMPLETE
+    #   * DELETE_IN_PROGRESS
+    #   * DELETE_FAILED
+    def status(options = {})
+      require_options(options, [:stack_name])
+      description = describe(options)
+      return description["StackStatus"] rescue nil
+    end
+
+    private
+      #Returns an array containing the Physical Resource Id's of RDS resources
+      def get_rds_resource_ids(resources)
+        rds_physical_ids = []
+        resources.each do |resource|
+          rds_physical_ids << resource["PhysicalResourceId"] if resource["ResourceType"] == "AWS::RDS::DBInstance"
+        end
+        return rds_physical_ids
+      end
+
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cloudster
 version: !ruby/object:Gem::Version
-  version: 2.6.1
+  version: 2.7.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-11-16 00:00:00.000000000 Z
+date: 2012-11-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fog
@@ -158,7 +158,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -610566703
+      hash: 991965789
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: