You are viewing documentation for version 1 of the AWS SDK for Ruby. Version 2 documentation can be found here.

Class: AWS::CloudFormation::StackCollection

Inherits:

Object

Object
AWS::CloudFormation::StackCollection

show all

Includes:: AWS::Core::Collection::WithNextToken

Defined in:: lib/aws/cloud_formation/stack_collection.rb

Instance Method Summary collapse

#[](stack_name) ⇒ Object
#create(stack_name, template, options = {}) ⇒ Stack
Creates a new stack.
#with_status(*status_filters) ⇒ StackCollection
Limits the stacks that are enumerated.

Methods included from AWS::Core::Collection

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

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:

(Stack)

# 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_filters) ⇒ `StackCollection`

Limits the stacks that are enumerated.

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

You can provide multiple statuses:

statuses = [:create_failed, :rollback_failed] cloud_formation.stacks.with_status(statuses).each do |stack| puts stack.name end

Status names may be symbolized (snake-cased) or upper-cased strings (e.g. :create_in_progress, 'CREATE_IN_PROGRESS').