# salt.states.boto_cfn

Connection module for Amazon Cloud Formation

Added in version 2015.8.0.

depends:

  boto

configuration:

  This module accepts explicit AWS credentials but can also utilize IAM roles assigned to the instance through Instance Profiles. Dynamic credentials are then automatically obtained from AWS API and no further configuration is necessary. More Information available at http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html

  If IAM roles are not used you need to specify them either in a pillar or in the minion's config file:

      keyid: GKTADJGHEIQSXMKKRBJ08H
      key: askdjghsdfjkghWupUjasdflkdfklgjsdfjajkghs

      stack-present:
        boto_cfn.present:
          - name: mystack
          - template_body: salt://base/mytemplate.json
          - disable_rollback: true
          - region: eu-west-1
          - keyid: 'AKIAJHTMIQ2ASDFLASDF'
          - key: 'fdkjsafkljsASSADFalkfjasdf'

      stack-absent:
        boto_cfn.absent:
          - name: mystack

salt.states.boto_cfn.absent(name, region=None, key=None, keyid=None, profile=None)

  Ensure cloud formation stack is absent.

  name (string) – The name of the stack to delete.

  region (string) - Region to connect to.

  key (string) - Secret key to be used.

  keyid (string) - Access key to be used.

  profile (dict) - A dict with region, key and keyid, or a pillar key (string) that contains a dict with region, key and keyid.

salt.states.boto_cfn.present(name, template_body=None, template_url=None, parameters=None, notification_arns=None, disable_rollback=None, timeout_in_minutes=None, capabilities=None, tags=None, on_failure=None, stack_policy_body=None, stack_policy_url=None, use_previous_template=None, stack_policy_during_update_body=None, stack_policy_during_update_url=None, region=None, key=None, keyid=None, profile=None)

  Ensure cloud formation stack is present.

  name (string) - Name of the stack.

  template_body (string) – Structure containing the template body. Can also be loaded from a file by using salt://.

  template_url (string) – Location of file containing the template body. The URL must point to a template located in an S3 bucket in the same region as the stack.

  parameters (list) – A list of key/value tuples that specify input parameters for the stack. A 3-tuple (key, value, bool) may be used to specify the UsePreviousValue option.

  notification_arns (list) – The Simple Notification Service (SNS) topic ARNs to publish stack related events. You can find your SNS topic ARNs using the SNS_console or your Command Line Interface (CLI).

  disable_rollback (bool) – Indicates whether or not to rollback on failure.

  timeout_in_minutes (integer) – The amount of time that can pass before the stack status becomes CREATE_FAILED; if DisableRollback is not set or is set to False, the stack will be rolled back.

  capabilities (list) – The list of capabilities you want to allow in the stack. Currently, the only valid capability is ‘CAPABILITY_IAM’.

  tags (dict) – A set of user-defined Tags to associate with this stack, represented by key/value pairs. Tags defined for the stack are propagated to EC2 resources that are created as part of the stack. A maximum number of 10 tags can be specified.

  on_failure (string) – Determines what action will be taken if stack creation fails. This must be one of: DO_NOTHING, ROLLBACK, or DELETE. You can specify either OnFailure or DisableRollback, but not both.

  stack_policy_body (string) – Structure containing the stack policy body. Can also be loaded from a file by using salt://.

  stack_policy_url (string) – Location of a file containing the stack policy. The URL must point to a policy (max size: 16KB) located in an S3 bucket in the same region as the stack.If you pass StackPolicyBody and StackPolicyURL, only StackPolicyBody is used.

  use_previous_template (boolean) – Used only when templates are not the same. Set to True to use the previous template instead of uploading a new one via TemplateBody or TemplateURL.

  stack_policy_during_update_body (string) – Used only when templates are not the same. Structure containing the temporary overriding stack policy body. If you pass StackPolicyDuringUpdateBody and StackPolicyDuringUpdateURL, only StackPolicyDuringUpdateBody is used. Can also be loaded from a file by using salt://.

  stack_policy_during_update_url (string) – Used only when templates are not the same. Location of a file containing the temporary overriding stack policy. The URL must point to a policy (max size: 16KB) located in an S3 bucket in the same region as the stack. If you pass StackPolicyDuringUpdateBody and StackPolicyDuringUpdateURL, only StackPolicyDuringUpdateBody is used.

  region (string) - Region to connect to.

  key (string) - Secret key to be used.

  keyid (string) - Access key to be used.

  profile (dict) - A dict with region, key and keyid, or a pillar key (string) that contains a dict with region, key and keyid.