Class: AWS::CloudFormation::StackCollection

Inherits:
Object
  • Object
show all
Includes:
StackOptions, AWS::Core::Collection::Simple
Defined in:
lib/aws/cloud_formation/stack_collection.rb

Instance Attribute Summary

Attributes included from AWS::Core::Model

#config

Instance Method Summary collapse

Methods included from AWS::Core::Collection::Simple

#each_batch

Methods included from AWS::Core::Collection

#each, #each_batch, #enum, #first, #in_groups_of, #page

Methods included from AWS::Core::Model

#client, #config_prefix, #inspect

Constructor Details

#initialize(options = {}) ⇒ StackCollection

Returns a new instance of StackCollection.



22
23
24
25
# File 'lib/aws/cloud_formation/stack_collection.rb', line 22

def initialize options = {}
  @status_filter = options[:status_filter]
  super
end

Instance Method Details

#[](stack_name) ⇒ Object



152
153
154
# File 'lib/aws/cloud_formation/stack_collection.rb', line 152

def [] stack_name
  Stack.new(stack_name, :config => config)
end

#create(stack_name, template, options = {}) ⇒ Stack

Creates a new stack.

Examples:

Creating a stack with a template string.


template = <<-JSON
 {
   "AWSTemplateFormatVersion" : "2010-09-09",
   "Description": "A simple template",
   "Resources": {
     "web": {
       "Type": "AWS::EC2::Instance",
       "Properties": {
         "ImageId": "ami-41814f28"
       }
     }
   }
}
JSON
stack = cfm.stacks.create('stack-name', template)

Creating a stack from an S3 object.


template = AWS::S3.new.buckets['templates'].objects['template-1']
stack = cfm.stacks.create('stack-name', template)

Creating a stack with 3 parameters.


template = <<-JSON
{
  "AWSTemplateFormatVersion" : "2010-09-09",
  "Description": "A simple template",
  "Parameters" : {
    "KeyName" : {
      "Description" : "Name of a KeyPair to use with SSH.",
      "Type" : "String"
    },
    "SecurityGroup" : {
      "Description" : "The security group to launch in.",
      "Type" : "String"
    },
    "InstanceType" : {
      "Description" : "The size of instance to launch.",
      "Type" : "String"
    }
  },
  "Resources": {
    "web": {
      "Type": "AWS::EC2::Instance",
      "Properties": {
        "InstanceType": { "Ref" : "InstanceType" },
        "SecurityGroups" : [ {"Ref" : "SecurityGroup"} ],
        "KeyName": { "Ref" : "KeyName" },
        "ImageId": "ami-41814f28"
      }
    }
  }
}
JSON

stack = cfm.stacks.create('name', template, :parameters => {
  'KeyName' => 'key-pair-name',
  'SecurityGroup' => 'security-group-name',
  'InstanceType' => 'm1.large',
})

Parameters:

  • stack_name (String)
  • template (String, URI, S3::S3Object, Object)

    The stack template. This may be provided in a number of formats including:

    • a String, containing the template as a JSON document.

    • a URL String pointing to the document in S3.

    • a URI object pointing to the document in S3.

    • an S3::S3Object which contains the template.

    • an Object which responds to #to_json and returns the template.

  • options (Hash) (defaults to: {})

Options Hash (options):

  • :capabilities (Array<String>)

    The list of capabilities that you want to allow in the stack. If your stack contains IAM resources, you must specify the CAPABILITY_IAM value for this parameter; otherwise, this action returns an InsufficientCapabilities error. IAM resources are the following:

    • AWS::IAM::AccessKey

    • AWS::IAM::Group

    • AWS::IAM::Policy

    • AWS::IAM::User

    • AWS::IAM::UserToGroupAddition

  • :disable_rollback (Boolean) — default: false

    Set to true to disable rollback on stack creation failures.

  • :notify (Object)

    One or more SNS topics ARN string or SNS::Topic objects. This param may be passed as a single value or as an array. CloudFormation will publish stack related events to these topics.

  • :parameters (Hash)

    A hash that specifies the input parameters of the new stack.

  • :timeout (Integer)

    The number of minutes that may pass before the stack creation fails. If :disable_rollback is false, the stack will be rolled back.

Returns:



134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
# File 'lib/aws/cloud_formation/stack_collection.rb', line 134

def create stack_name, template, options = {}

  client_opts = options.dup
  client_opts[:template] = template

  apply_stack_name(stack_name, client_opts)
  apply_template(client_opts)
  apply_disable_rollback(client_opts)
  apply_notification_arns(client_opts)
  apply_parameters(client_opts)
  apply_timeout(client_opts)

  resp = client.create_stack(client_opts)

  Stack.new(stack_name, :config => config, :stack_id => resp.stack_id)

end

#with_status(status_filter) ⇒ StackCollection

Limits the stacks that are enumerated.

cloud_formation.stacks.with_status(:create_complete).each do |stack|
  puts stack.name
end

Parameters:

  • status_filter (Symbol, String)

    A status to filter stacks with. Valid values include:

    • :create_in_progress

    • :create_failed

    • :create_complete

    • :rollback_in_progress

    • :rollback_failed

    • :rollback_complete

    • :delete_in_progress

    • :delete_failed

    • :delete_complete

    • :update_in_progress

    • :update_complete_cleanup_in_progress

    • :update_complete

    • :update_rollback_in_progress

    • :update_rollback_failed

    • :update_rollback_complete_cleanup_in_progress

    • :update_rollback_complete

Returns:

  • (StackCollection)

    Returns a new stack collection that filters the stacks returned by the given status.



184
185
186
# File 'lib/aws/cloud_formation/stack_collection.rb', line 184

def with_status status_filter
  StackCollection.new(:status_filter => status_filter, :config => config)
end