ANSIBLE.CLOUDFORMATION(3)       ANSIBLE MODULES      ANSIBLE.CLOUDFORMATION(3)



NAME
       cloudformation - create a AWS CloudFormation stack

DESCRIPTION
       Launches an AWS CloudFormation stack and waits for it complete.

OPTIONS
       disable_rollback
              If a stacks fails to form, rollback will remove the stack
              Choices: yes,no. (default: no)

       region The AWS region to use. If not specified then the value of the
              EC2_REGION environment variable, if any, is used.(required)

       stack_name
              name of the cloudformation stack(required)

       state  If state is "present", stack will be created.  If state is
              "present" and if stack exists and template has changed, it will
              be updated. If state is absent, stack will be removed.(required)

       tags   Dictionary of tags to associate with stack and it's resources
              during stack creation. Cannot be updated later. Requires at
              least Boto version 2.6.0.(Added in Ansible version 1.4.)


       template
              the path of the cloudformation template(required)

       template_parameters
              a list of hashes of all the template variables for the stack.

EXAMPLES
       # Basic task example
       tasks:
       - name: launch ansible cloudformation example
         action: cloudformation >
           stack_name="ansible-cloudformation" state=present
           region=us-east-1 disable_rollback=yes
           template=files/cloudformation-example.json
         args:
           template_parameters:
             KeyName: jmartin
             DiskType: ephemeral
             InstanceType: m1.small
             ClusterSize: 3
           tags:
             Stack: ansible-cloudformation



AUTHOR
       James S. Martin

SEE ALSO
       ansible(1), http://ansible.github.com/modules.html#cloudformation



1.4.5                             2014-02-12         ANSIBLE.CLOUDFORMATION(3)
