Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Expanded how-to filter.

You can use the AWS CloudFormation Stack task to create, update or delete an AWS CloudFormation stack defined by a template provided via URL or inline and specify template parameters and advanced options (see Provisioning with AWS CloudFormation for an overview of the CloudFormation resource lifecycle and provisioning workflow).


Panel
borderColor#bbb
bgColor#eeeeee

On this page:

Table of Contents
excludePopular.*


Panel
borderColor#bbb
bgColor#eeeeee

Related Pages:


Configuration

Tip

To ease common scenarios, the Create action allows to Update [the] stack, if it already exists, similarly the Update action allows to Create [the] stack, if it does not already exist.

To configure an AWS CloudFormation task:

  1. Navigate to the Tasks configuration tab for the job (this will be the default job if creating a new plan).
  2. Click the name of an existing AWS CloudFormation task, or click Add Task and then AWS CloudFormation Task to create a new task.
  3. Complete the following settings:

    1. Common to all tasks

      Include Page
      _CommonTaskParametersTable
      _CommonTaskParametersTable

    2. Actions supported by this task:

      Create Stack

       

      Update stack, if it already existsCheck to apply the Update action, if the stack already exists. Clear to trigger a build failure otherwise.
      Stack Name

      Specify

      a

      the stack name.

      Template Source

      Specify the stack template source as an S3 URL or inline in JSON or YAML format. Insert fragments from the inline Examples dialog to get started.

      Parameters(Optional) Specify parameters in JSON format. Insert fragments from the inline Examples dialog to get started.
        Generated Variables Code Block
        languagetext
        linenumberstrue
        collapsetrue
        Creating common variables for 1 resources affected by task: ... custom.aws.cfn.stack.resources: SampleStack-TAWS-IT230-CFN2-24 Creating resource variables for stack 'SampleStack-TAWS-IT230-CFN2-24': ... custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.StackId: arn:aws:cloudformation:us-east-1:309600995652:stack/SampleStack-TAWS-IT230-CFN2-24/d6620400-2ffc-11e5-b660-50e2415b5e18 ... custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.StackStatus: CREATE_COMPLETE ... custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24
        • (info) Reserved JSON characters in Bamboo variable content need to be escaped at runtime!
        Advanced Options
        Tags(Optional) Tag the stack.
        Role ARN(Optional) Specify the service role ARN.
        Notification ARNs(Optional) Specify the Amazon SNS topic ARN(s) for publishing stack related events (either a single ARN, or a JSON array with up to five ARNs).
        Creation Timeout (minutes)Specify how much time can pass before the stack creation is considered failed.
        On failure action

        Select the action that will be taken if stack creation fails.

        Info
        titleStack Rollback

        Stack rollback is currently handled as follows, hopefully covering the majority of use cases (please let us know otherwise):

        • A stack rolled back successfully by CloudFormation is treated as a failed build by Bamboo.
        • A stack not rolled back due to rollback being disabled explicitly is still treated as a failed build by Bamboo.


        Enable IAM

        (Optional) Check if the stack should be allowed to access IAM resources.

        • (info) Enabling IAM requires the AWS Security Credentials source to be either 'Inline', or 'IAM Role for EC2 (Agent)', or a shared 'Identity Federation for AWS' connector with principal type 'Assume Role'.
        Stack Policy Source(Optional) Specify which update actions users can do and which resources they can take action on. See the Stack Policy Reference and Sample Stack Policies for details.

        Update Stack


        Create stack, if it does not already exist

        Check to apply the Create action, if the stack does not already exists. Clear to trigger a build failure otherwise.

        Don't fail for no-op updateCheck to not fail the build, if the update does not have affect any resource. Clear to trigger a build failure otherwise.
        Stack Name or ID
        Specify the stack name or ID.
        Template Sourcesee Create Stack above
        Parameterssee Create Stack above
        Advanced Options
        Tagssee Create Stack above
        Role ARNsee Create Stack above
        Notification ARNs
        see Create Stack above
        Enable IAM
        see Create Stack above
        Stack Policy Sourcesee Update Stack above
        Stack Policy During Update Source

        (Optional) Override which update actions users can do and which resources they can take action on. See the Stack Policy Reference and Sample Stack Policies for details.

        Delete Stack


        Stack Name or ID

        see Update Stack above

        Don't fail for non existing stackCheck to not fail the build, if the stack does not exist (anymore). Clear to trigger a build failure otherwise.

        Validate Template(s)


        Info

        The Validate action operates on a template rather than a stack. It has been included in this task for ease of use.


        Stack Template Source

        see Create Stack above

        Tip
        titleMultiple Templates Validation

        As of Tasks for AWS 2.10.1, you can validate multiple templates at once by specifying a S3 virtual directory prefix, i.e. an S3 URL that ends in a '/' (e.g. https://downloads-example-com.s3.amazonaws.com/aws-cloudformation/templates/). This will validate all S3 objects with this prefix, no matter their file name, extension or virtual directory nesting level, excluding the legacy S3 virtual directory marker file *_$folder$ that has been used by e.g. Apache Hadoop's NativeS3FileSystem and other third party tools.


        Create Change Set


        Stack Name or ID

        see Update Stack above

        Change Set Name

        Specify the name of the change set. The name must be unique among all change sets that are associated with the specified stack.

        Change Set Description

        Specify a description to help you identify this change set.

        Template Sourcesee Create Stack above
        Parameterssee Create Stack above
        Change Set TypeSelect the change set type: Create new stack, update existing stack, or decide at runtime based on stack existence.
        Advanced Options
        Tagssee Create Stack above
        Role ARNsee Create Stack above
        Notification ARNs
        see Create Stack above
        Enable IAM
        see Create Stack above

        Execute Change Set


        Change Set Name or ARN

        Specify the name or Amazon Resource Name (ARN) of the change set.

        Stack Name or ID

        (Conditional) Specify the stack name or ID (required if you provided a change set name instead of a change set ARN)

        Delete Change Set


        Change Set Name or ARN

        see Execute Change Set above

        Stack Name or ID

        see Execute Change Set above




    Variables

    Include Page
    _VariablesNote
    _VariablesNote

    Create Stack

    Code Block
    languagetext
    linenumberstrue
    Creating common variables for 1 resources affected by task:
    ... bamboo.custom.aws.cfn.stack.resources: SampleStack-TAWS-IT230-CFN2-24
    Creating resource variables for stack 'SampleStack-TAWS-IT230-CFN2-24':
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.StackId: arn:aws:cloudformation:us-east-1:309600995652:stack/SampleStack-TAWS-IT230-CFN2-24/d6620400-2ffc-11e5-b660-50e2415b5e18
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.StackStatus: CREATE_COMPLETE
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.StackName: SampleStack-TAWS-IT230-CFN2-24
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.CreationTime: 20150721T230428Z
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.LastUpdatedTime: 20150721T230500Z
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.tags: Environment;Cost-Centre
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.tags.Environment: Test
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.tags.Cost-Centre: Development
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.parameters: QueueName
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.parameters.QueueName: Bamboo-24
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.resources.MyQueue: ResourceStatus;LogicalResourceId;PhysicalResourceId;Timestamp
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.resources.MyQueue.ResourceStatus: CREATE_COMPLETE
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.resources.MyQueue.LogicalResourceId: MyQueue
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.resources.MyQueue.PhysicalResourceId: https://sqs.us-east-1.amazonaws.com/309600995652/Bamboo-24
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.resources.MyQueue.Timestamp: 20150721T230442Z
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.resources: MyQueue
    Stack 'SampleStack-TAWS-IT230-CFN2-24' generated 2 outputs:
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.outputs: QueueURL;QueueARN
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.outputs.QueueURL: https://sqs.us-east-1.amazonaws.com/309600995652/Bamboo-24
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.outputs.QueueARN: arn:aws:sqs:us-east-1:309600995652:Bamboo-24
    Creating common variables for first resource affected by task:
    Creating resource variables for stack 'SampleStack-TAWS-IT230-CFN2-24':
    ... bamboo.custom.aws.cfn.stack.first.StackId: arn:aws:cloudformation:us-east-1:309600995652:stack/SampleStack-TAWS-IT230-CFN2-24/d6620400-2ffc-11e5-b660-50e2415b5e18
    ... bamboo.custom.aws.cfn.stack.first.StackStatus: CREATE_COMPLETE
    ... bamboo.custom.aws.cfn.stack.first.StackName: SampleStack-TAWS-IT230-CFN2-24
    ... bamboo.custom.aws.cfn.stack.first.CreationTime: 20150721T230428Z
    ... bamboo.custom.aws.cfn.stack.first.LastUpdatedTime: 20150721T230500Z
    ... bamboo.custom.aws.cfn.stack.first.tags: Environment;Cost-Centre
    ... bamboo.custom.aws.cfn.stack.first.tags.Environment: Test
    ... bamboo.custom.aws.cfn.stack.first.tags.Cost-Centre: Development
    ... bamboo.custom.aws.cfn.stack.first.parameters: QueueName
    ... bamboo.custom.aws.cfn.stack.first.parameters.QueueName: Bamboo-24
    ... bamboo.custom.aws.cfn.stack.first.resources.MyQueue: ResourceStatus;LogicalResourceId;PhysicalResourceId;Timestamp
    ... bamboo.custom.aws.cfn.stack.first.resources.MyQueue.ResourceStatus: CREATE_COMPLETE
    ... bamboo.custom.aws.cfn.stack.first.resources.MyQueue.LogicalResourceId: MyQueue
    ... bamboo.custom.aws.cfn.stack.first.resources.MyQueue.PhysicalResourceId: https://sqs.us-east-1.amazonaws.com/309600995652/Bamboo-24
    ... bamboo.custom.aws.cfn.stack.first.resources.MyQueue.Timestamp: 20150721T230442Z
    ... bamboo.custom.aws.cfn.stack.first.resources: MyQueue
    Stack 'SampleStack-TAWS-IT230-CFN2-24' generated 2 outputs:
    ... bamboo.custom.aws.cfn.stack.first.outputs: QueueURL;QueueARN
    ... bamboo.custom.aws.cfn.stack.first.outputs.QueueURL: https://sqs.us-east-1.amazonaws.com/309600995652/Bamboo-24
    ... bamboo.custom.aws.cfn.stack.first.outputs.QueueARN: arn:aws:sqs:us-east-1:309600995652:Bamboo-24
    

    Update Stack

    Code Block
    languagetext
    linenumberstrue
    collapsetrue
    Creating common variables for 1 resources affected by task:
    ... bamboo.custom.aws.cfn.stack.resources: SampleStack-TAWS-IT230-CFN2-24
    Creating resource variables for stack 'SampleStack-TAWS-IT230-CFN2-24':
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.StackId: arn:aws:cloudformation:us-east-1:309600995652:stack/SampleStack-TAWS-IT230-CFN2-24/d6620400-2ffc-11e5-b660-50e2415b5e18
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.StackStatus: UPDATE_COMPLETE
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.StackName: SampleStack-TAWS-IT230-CFN2-24
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.CreationTime: 20150721T230428Z
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.LastUpdatedTime: 20150721T230501Z
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.tags: Environment;Cost-Centre
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.tags.Environment: Test
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.tags.Cost-Centre: Development
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.parameters: QueueName
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.parameters.QueueName: Bamboo-24-updated
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.resources.MyQueue: ResourceStatus;LogicalResourceId;PhysicalResourceId;Timestamp
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.resources.MyQueue.ResourceStatus: UPDATE_COMPLETE
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.resources.MyQueue.LogicalResourceId: MyQueue
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.resources.MyQueue.PhysicalResourceId: https://sqs.us-east-1.amazonaws.com/309600995652/Bamboo-24-updated
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.resources.MyQueue.Timestamp: 20150721T230511Z
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.resources: MyQueue
    Stack 'SampleStack-TAWS-IT230-CFN2-24' generated 2 outputs:
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.outputs: QueueURL;QueueARN
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.outputs.QueueURL: https://sqs.us-east-1.amazonaws.com/309600995652/Bamboo-24-updated
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.outputs.QueueARN: arn:aws:sqs:us-east-1:309600995652:Bamboo-24-updated
    Creating common variables for first resource affected by task:
    Creating resource variables for stack 'SampleStack-TAWS-IT230-CFN2-24':
    ... bamboo.custom.aws.cfn.stack.first.StackId: arn:aws:cloudformation:us-east-1:309600995652:stack/SampleStack-TAWS-IT230-CFN2-24/d6620400-2ffc-11e5-b660-50e2415b5e18
    ... bamboo.custom.aws.cfn.stack.first.StackStatus: UPDATE_COMPLETE
    ... bamboo.custom.aws.cfn.stack.first.StackName: SampleStack-TAWS-IT230-CFN2-24
    ... bamboo.custom.aws.cfn.stack.
    resources.SampleStack-TAWS-IT230-CFN2-24
    first.CreationTime: 20150721T230428Z
    ... bamboo.custom.aws.cfn.stack
    .resources.SampleStack-TAWS-IT230-CFN2-24
    .first.LastUpdatedTime: 
    20150721T230500Z
    20150721T230501Z
    ... bamboo.custom.aws.cfn.stack.
    resources.SampleStack-TAWS-IT230-CFN2-24.
    first.tags: Environment;Cost-Centre
    ... bamboo.custom.aws.cfn.stack.
    resources.SampleStack-TAWS-IT230-CFN2-24
    first.tags.Environment: Test
    ... bamboo.custom.aws.cfn.stack.
    resources.SampleStack-TAWS-IT230-CFN2-24
    first.tags.Cost-Centre: Development
    ... bamboo.custom.aws.cfn.stack.
    resources.SampleStack-TAWS-IT230-CFN2-24
    first.parameters: QueueName
    ... bamboo.custom.aws.cfn
    .stack.resources.SampleStack-TAWS-IT230-CFN2-24
    .stack.first.parameters.QueueName: Bamboo-24-updated
    ... bamboo.custom.aws.cfn.stack.
    resources.SampleStack-TAWS-IT230-CFN2-24.
    first.resources.MyQueue: ResourceStatus;LogicalResourceId;PhysicalResourceId;Timestamp
    ... bamboo.custom.aws.cfn.stack.
    resources.SampleStack-TAWS-IT230-CFN2-24
    first.resources.MyQueue.ResourceStatus: 
    CREATE
    UPDATE_COMPLETE
    ... bamboo.custom.aws.cfn.stack.
    resources.SampleStack-TAWS-IT230-CFN2-24
    first.resources.MyQueue.LogicalResourceId: MyQueue
    ... bamboo.custom.aws.cfn.stack.
    resources.SampleStack-TAWS-IT230-CFN2-24
    first.resources.MyQueue.PhysicalResourceId: https://sqs.us-east-1.amazonaws.com/309600995652/Bamboo-24-updated
    ... bamboo.custom.aws.cfn.stack.
    resources.SampleStack-TAWS-IT230-CFN2-24
    first.resources.MyQueue.Timestamp: 
    20150721T230442Z
    20150721T230511Z
    ... bamboo.custom.aws.cfn.stack.
    resources.SampleStack-TAWS-IT230-CFN2-24.
    first.resources: MyQueue
    Stack 'SampleStack-TAWS-IT230-CFN2-24' generated 2 outputs:
    ... bamboo.custom.aws.cfn.stack.
    resources.SampleStack-TAWS-IT230-CFN2-24.
    first.outputs: QueueURL;QueueARN
    ... bamboo.custom.aws.cfn.stack.
    resources.SampleStack-TAWS-IT230-CFN2-24.
    first.outputs.QueueURL: https://sqs.us-east-1.amazonaws.com/309600995652/Bamboo-24-updated
    ... bamboo.custom.aws.cfn.stack.
    resources.SampleStack-TAWS-IT230-CFN2-24
    first.outputs.QueueARN: arn:aws:sqs:us-east-1
    :309600995652:Bamboo-24
    :309600995652:Bamboo-24-updated

    Delete Stack

    Code Block
    languagetext
    linenumberstrue
    collapsetrue
    Creating common variables for 
    first
    1 
    resource
    resources affected by task:
    ... bamboo.custom.aws.cfn.stack.resources: SampleStack-TAWS-IT230-CFN2-24
    Creating resource variables for stack 'SampleStack-TAWS-IT230-CFN2-24':
    ... bamboo.custom.aws.cfn.stack
    .first
    .resources.SampleStack-TAWS-IT230-CFN2-24.StackId: arn:aws:cloudformation:us-east-1:309600995652:stack/SampleStack-TAWS-IT230-CFN2-24/d6620400-2ffc
    -11e5-b660-50e2415b5e18 ... custom.aws.cfn.stack.first.StackStatus: CREATE_COMPLETE
    -11e5-b660-50e2415b5e18
    ... bamboo.custom.aws.cfn.stack.
    first
    resources.
    StackName:
    SampleStack-TAWS-IT230-CFN2-24
    ... custom.aws.cfn.stack.first.CreationTime: 20150721T230428Z
    .StackStatus: DELETE_COMPLETE
    ... 
    custom.aws.cfn.stack.first.LastUpdatedTime: 20150721T230500Z ...
    bamboo.custom.aws.cfn.stack.
    first.tags: Environment;Cost-Centre ... custom.aws.cfn.stack.first.tags.Environment: Test
    resources.SampleStack-TAWS-IT230-CFN2-24.StackName: SampleStack-TAWS-IT230-CFN2-24
    ... bamboo.custom.aws.cfn.stack.
    first.tags.Cost-Centre: Development
    resources.SampleStack-TAWS-IT230-CFN2-24.CreationTime: 20150721T230428Z
    ... bamboo.custom.aws.cfn.stack.
    first.parameters
    resources.SampleStack-TAWS-IT230-CFN2-24.LastUpdatedTime: 
    QueueName
    20150721T230501Z
    ... bamboo.custom.aws.cfn.stack.
    first.parameters.QueueName: Bamboo-24
    resources.SampleStack-TAWS-IT230-CFN2-24.tags: Environment;Cost-Centre
    ... bamboo.
    custom.aws.cfn.stack
    .first.resources.MyQueue: ResourceStatus;LogicalResourceId;PhysicalResourceId;Timestamp
    .resources.SampleStack-TAWS-IT230-CFN2-24.tags.Environment: Test
    ... bamboo.custom.aws.cfn.stack.
    first.resources.MyQueue.ResourceStatus: CREATE_COMPLETE
    resources.SampleStack-TAWS-IT230-CFN2-24.tags.Cost-Centre: Development
    ... bamboo.custom.aws.cfn.stack
    .first
    .resources.
    MyQueue.LogicalResourceId
    SampleStack-TAWS-IT230-CFN2-24.parameters: 
    MyQueue
    QueueName
    ... bamboo.custom.aws.cfn.stack
    .first.resources.MyQueue.PhysicalResourceId: https://sqs.us-east-1.amazonaws.com/309600995652/Bamboo-24
    .resources.SampleStack-TAWS-IT230-CFN2-24.parameters.QueueName: Bamboo-24-updated
    ... bamboo.custom.aws.cfn.stack
    .first
    .resources.SampleStack-TAWS-IT230-CFN2-24.resources.MyQueue
    .Timestamp: 20150721T230442Z
    :ResourceStatus;LogicalResourceId;PhysicalResourceId;Timestamp
    ... bamboo.custom.aws.cfn.stack.
    first.resources: MyQueue Stack '
    resources.SampleStack-TAWS-IT230-CFN2-24
    ' generated 2 outputs: ...
    .resources.MyQueue.ResourceStatus: DELETE_COMPLETE
    ... bamboo.custom.aws.cfn.stack
    .first.outputs: QueueURL;QueueARN
    .resources.SampleStack-TAWS-IT230-CFN2-24.resources.MyQueue.LogicalResourceId: MyQueue
    ... bamboo.custom.aws.cfn.stack
    .first.outputs.QueueURL
    .resources.SampleStack-TAWS-IT230-CFN2-24.resources.MyQueue.PhysicalResourceId: https://sqs.us-east-1.amazonaws.com/309600995652/
    Bamboo-24
    Bamboo-24-updated
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-24.resources.MyQueue.Timestamp: 20150721T230557Z
    ... bamboo.custom.aws.cfn.stack.
    first.outputs.QueueARN: arn:aws:sqs:us-east-1:309600995652:Bamboo-24 Advanced Options Tags(Optional) Tag the stack.Notification ARN(Optional) Specify the Amazon SNS topic ARN stack related events should be published to.Creation Timeout (minutes)Specify how much time can pass before the stack creation is considered failed.On failure action

    Select the action that will be taken if stack creation fails.

    Info
    titleStack Rollback

    Stack rollback is currently handled as follows, hopefully covering the majority of use cases (please let us know otherwise):

    • A stack rolled back successfully by CloudFormation is treated as a failed build by Bamboo.
    • A stack not rolled back due to rollback being disabled explicitly is still treated as a failed build by Bamboo.
    Enable IAM

    (Optional) Check if the stack should be allowed to access IAM resources.

    • (info) Enabling IAM requires the AWS Security Credentials source to be either 'Inline', or 'IAM Role for EC2 (Agent)', or a shared 'Identity Federation for AWS' connector with principal type 'Assume Role'.
    Stack Policy Source(Optional) Specify which update actions users can do and which resources they can take action on. See the Stack Policy Reference and Sample Stack Policies for details.

    Update

     Create stack, if it does not already exist

    Check to apply the Create action, if the stack does not already exists. Clear to trigger a build failure otherwise.

    Don't fail for no-op updateCheck to not fail the build, if the update does not have affect any resource. Clear to trigger a build failure otherwise.Stack Name or ID
    Specify the target stack. You can use its name or ID.Stack Template Sourcesee Create aboveParameterssee Create aboveGenerated Variables Code Block
    languagetext
    linenumberstrue
    collapsetrue
    Creating common variables for 1 resources affected by task: ... custom.aws.cfn.stack.resources: SampleStack-TAWS-IT230-CFN2-24 Creating resource variables for stack 'SampleStack-TAWS-IT230-CFN2-24': ...
    resources.SampleStack-TAWS-IT230-CFN2-24.resources: MyQueue
    Creating common variables for first resource affected by task:
    Creating resource variables for stack 'SampleStack-TAWS-IT230-CFN2-24':
    ... bamboo.custom.aws.cfn.stack.first.StackId: arn:aws:cloudformation:us-east-1:309600995652:stack/SampleStack-TAWS-IT230-CFN2-24/d6620400-2ffc-11e5-b660-50e2415b5e18
    ... bamboo.custom.aws.cfn.stack.first.StackStatus: DELETE_COMPLETE
    ... bamboo.custom.aws.cfn.stack.first.StackName: SampleStack-TAWS-IT230-CFN2-24
    ... bamboo.custom.aws.cfn.stack.first.CreationTime: 20150721T230428Z
    ... bamboo.custom.aws.cfn.stack.first.LastUpdatedTime: 20150721T230501Z
    ... bamboo.custom.aws.cfn.stack.first.tags: Environment;Cost-Centre
    ... bamboo.custom.aws.cfn.stack.first.tags.Environment: Test
    ... bamboo.custom.aws.cfn.stack.first.tags.Cost-Centre: Development
    ... bamboo.custom.aws.cfn.stack.first.parameters: QueueName
    ... bamboo.custom.aws.cfn.stack.first.parameters.QueueName: Bamboo-24-updated
    ... bamboo.custom.aws.cfn.stack.first.resources.
    SampleStack-TAWS-IT230-CFN2-24.StackId: arn:aws:cloudformation:us-east-1:309600995652:stack/SampleStack-TAWS-IT230-CFN2-24/d6620400-2ffc-11e5-b660-50e2415b5e18
    MyQueue: ResourceStatus;LogicalResourceId;PhysicalResourceId;Timestamp
    ... bamboo.custom.aws.cfn.stack.first.resources.
    SampleStack-TAWS-IT230-CFN2-24.StackStatus
    MyQueue.ResourceStatus: 
    UPDATE
    DELETE_COMPLETE
    ... bamboo.custom.aws.cfn.stack.first.resources.
    SampleStack-TAWS-IT230-CFN2-24.StackName: SampleStack-TAWS-IT230-CFN2-24
    MyQueue.LogicalResourceId: MyQueue
    ... bamboo.custom.aws.cfn.stack.first.resources
    .SampleStack-TAWS-IT230-CFN2-24.CreationTime: 20150721T230428Z
    .MyQueue.PhysicalResourceId: https://sqs.us-east-1.amazonaws.com/309600995652/Bamboo-24-updated
    ... bamboo.custom.aws.cfn.stack.first.resources.
    SampleStack-TAWS-IT230-CFN2-24.LastUpdatedTime
    MyQueue.Timestamp: 
    20150721T230501Z
    20150721T230557Z
    ... bamboo.custom.aws.cfn.stack
    .resources.SampleStack-TAWS-IT230-CFN2-24.tags: Environment;Cost-Centre
    .first.resources: MyQueue
    

    Validate Template(s)

    N/A

    Create Change Set

    Code Block
    languagetext
    linenumberstrue
    Creating common variables for 1 resources affected by task:
    ... bamboo.custom.aws.cfn.stack
    .resources.SampleStack
    .changeset.resources: arn:aws:cloudformation:us-east-1:309600995652:changeSet/SampleCS-TAWS-IT230-CFN2-
    24.tags.Environment: Test ... custom.aws.cfn.stack.resources.SampleStack
    36/8c0b732e-728f-494a-a5a8-b89df75954b4
    Creating resource variables for change set 'arn:aws:cloudformation:us-east-1:309600995652:changeSet/SampleCS-TAWS-IT230-CFN2-
    24.tags.Cost-Centre: Development
    36/8c0b732e-728f-494a-a5a8-b89df75954b4':
    ... bamboo.custom.aws.cfn.stack.changeset.resources.
    SampleStack
    arn:aws:cloudformation:us-east-1:309600995652:changeSet/SampleCS-TAWS-IT230-CFN2
    -24.parameters: QueueName ... custom.aws.cfn.stack.resources.SampleStack
    -36/8c0b732e-728f-494a-a5a8-b89df75954b4.ChangeSetId: s-east-1:309600995652:changeSet/SampleCS-TAWS-IT230-CFN2
    -24.parameters.QueueName: Bamboo-24-updated
    -36/8c0b732e-728f-494a-a5a8-b89df75954b4
    ... bamboo.custom.aws.cfn.stack.changeset.resources.
    SampleStack
    arn:aws:cloudformation:us-east-1:309600995652:changeSet/SampleCS-TAWS-IT230-CFN2
    -24.resources.MyQueue: ResourceStatus;LogicalResourceId;PhysicalResourceId;Timestamp
    -36/8c0b732e-728f-494a-a5a8-b89df75954b4.ChangeSetName: SampleCS-TAWS-IT230-CFN2-36
    ... bamboo.custom.aws.cfn.stack.changeset.resources.
    SampleStack
    arn:aws:cloudformation:us-east-1:309600995652:changeSet/SampleCS-TAWS-IT230-CFN2-
    24.resources.MyQueue.ResourceStatus: UPDATE_COMPLETE
    36/8c0b732e-728f-494a-a5a8-b89df75954b4.Description: adsf 2
    ... bamboo.custom.aws
    .cfn.stack.resources.SampleStack
    .cfn.stack.changeset.resources.arn:aws:cloudformation:us-east-1:309600995652:changeSet/SampleCS-TAWS-IT230-CFN2
    -24.resources.MyQueue.LogicalResourceId: MyQueue
    -36/8c0b732e-728f-494a-a5a8-b89df75954b4.ExecutionStatus: AVAILABLE
    ... bamboo.custom.aws.cfn.stack.changeset.resources.
    SampleStack
    arn:aws:cloudformation:us-east-1:309600995652:changeSet/SampleCS-TAWS-IT230-CFN2
    -24.resources.MyQueue.PhysicalResourceId: https://sqs.us
    -36/8c0b732e-728f-494a-a5a8-b89df75954b4.StackId: s-east-1
    .amazonaws.com/309600995652/Bamboo-24-updated ... custom.aws.cfn.stack.resources.
    :309600995652:stack/SampleStack-TAWS-IT230-CFN2
    -24.resources.MyQueue.Timestamp: 20150721T230511Z ...
    -36/eba30c60-54f9-11e6-844f-50d5ca632682
    ... bamboo.custom.aws.cfn.stack.changeset.resources.
    SampleStack
    arn:aws:cloudformation:us-east-1:309600995652:changeSet/SampleCS-TAWS-IT230-CFN2
    -24.resources: MyQueue Stack '
    -36/8c0b732e-728f-494a-a5a8-b89df75954b4.StackName: SampleStack-TAWS-IT230-CFN2-
    24' generated 2 outputs:
    36
    ... bamboo.custom.aws.cfn.stack.changeset.resources.
    SampleStack
    arn:aws:cloudformation:us-east-1:309600995652:changeSet/SampleCS-TAWS-IT230-CFN2-
    24.outputs: QueueURL;QueueARN
    36/8c0b732e-728f-494a-a5a8-b89df75954b4.Status: CREATE_COMPLETE
    ... bamboo.custom.aws.cfn.stack
    .resources.SampleStack
    .changeset.resources.arn:aws:cloudformation:us-east-1:309600995652:changeSet/SampleCS-TAWS-IT230-CFN2-
    24.outputs.QueueURL: https://sqs.us-east-1.amazonaws.com/309600995652/Bamboo-24-updated
    36/8c0b732e-728f-494a-a5a8-b89df75954b4.StatusReason: null
    ... bamboo.custom.aws.cfn.stack.changeset.resources
    .SampleStack-TAWS-IT230-CFN2-24
    .
    outputs.QueueARN:
    arn:aws:
    sqs
    cloudformation:us-east-1:309600995652:
    Bamboo-24-updated
    changeSet/SampleCS-TAWS-IT230-CFN2-36/8c0b732e-728f-494a-a5a8-b89df75954b4.CreationTime: 20160728T193340Z
    Creating common variables for first resource affected by task:
    Creating resource variables for 
    stack 'SampleStack-TAWS-IT230-CFN2-24': ... custom.aws.cfn.stack.first.StackId:
    change set 'arn:aws:cloudformation:us-east-1:309600995652:
    stack
    changeSet/
    SampleStack
    SampleCS-TAWS-IT230-CFN2-
    24
    36/
    d6620400
    8c0b732e-
    2ffc
    728f-
    11e5
    494a-
    b660-50e2415b5e18 ... custom.aws.cfn.stack.first.StackStatus: UPDATE_COMPLETE
    a5a8-b89df75954b4':
    ... bamboo.custom.aws.cfn.stack.changeset.first.
    StackName
    ChangeSetId: 
    SampleStack
    arn:aws:cloudformation:us-east-1:309600995652:changeSet/SampleCS-TAWS-IT230-CFN2
    -24
    -36/8c0b732e-728f-494a-a5a8-b89df75954b4
    ... bamboo.custom.aws.cfn.stack.changeset.first.
    CreationTime
    ChangeSetName: 
    20150721T230428Z
    SampleCS-TAWS-IT230-CFN2-36
    ... bamboo.custom.aws.cfn.stack.changeset.first.
    LastUpdatedTime
    Description: 
    20150721T230501Z ... custom.aws.cfn.stack.first.tags: Environment;Cost-Centre
    adsf 2
    ... bamboo.custom.aws.cfn.stack.changeset.first.
    tags.Environment
    ExecutionStatus: 
    Test
    AVAILABLE
    ... bamboo.custom.aws.cfn.stack.changeset.first.
    tags.Cost-Centre: Development
    StackId: arn:aws:cloudformation:us-east-1:309600995652:stack/SampleStack-TAWS-IT230-CFN2-36/eba30c60-54f9-11e6-844f-50d5ca632682
    ... bamboo.custom.aws.cfn.stack.changeset.first.
    parameters
    StackName: 
    QueueName
    SampleStack-TAWS-IT230-CFN2-36
    ... bamboo.custom.aws.cfn.stack.changeset.first.
    parameters.QueueName
    Status: 
    Bamboo-24-updated
    CREATE_COMPLETE
    ... bamboo.custom.aws.cfn.stack.changeset.first.
    resources.MyQueue
    StatusReason: 
    ResourceStatus;LogicalResourceId;PhysicalResourceId;Timestamp
    null
    ... bamboo.custom.aws.cfn.stack.changeset.first.
    resources.MyQueue.ResourceStatus: UPDATE_COMPLETE ... custom.aws.cfn.stack.first.resources.MyQueue.LogicalResourceId: MyQueue ... custom.aws.cfn.stack.first.resources.MyQueue.PhysicalResourceId:
    CreationTime: 20160728T193340Z
    ChangeSet 'SampleCS-TAWS-IT230-CFN2-36' will result in 2 changes (add 1, modify 1, remove 0):
    ... Add - MyQueue (AWS::SQS::Queue) null
    ... Modify - MyQueue (AWS::SQS::Queue) https://sqs.us-east-1.amazonaws.com/309600995652/Bamboo-
    24
    1-
    updated ... custom.aws.cfn.stack.first.resources.MyQueue.Timestamp: 20150721T230511Z ... custom.aws.cfn.stack.first.resources: MyQueue Stack 'SampleStack-TAWS-IT230-CFN2-24' generated 2 outputs: ... custom.aws.cfn.stack.first.outputs: QueueURL;QueueARN ...
    first (Replacement: True)
    Task finished with expected result 'CREATE_COMPLETE'

    Execute Change Set

    Code Block
    languagetext
    linenumberstrue
    collapsetrue
    Creating common variables for 1 resources affected by task:
    ... bamboo.custom.aws.cfn.stack.
    first.outputs.QueueURL: https://sqs.us-east-1.amazonaws.com/309600995652/Bamboo-24-updated
    resources: SampleStack-TAWS-IT230-CFN2-38
    Creating resource variables for stack 'SampleStack-TAWS-IT230-CFN2-38':
    ... bamboo.custom.aws.cfn.stack.
    first.outputs.QueueARN
    resources.SampleStack-TAWS-IT230-CFN2-38.StackId: arn:aws:
    sqs
    cloudformation:us-east-1:309600995652:
    Bamboo-24-updatedAdvanced Options Notification ARN
    see Create aboveEnable IAM
    see Create above Stack Policy Sourcesee Update aboveStack Policy During Update Source

    (Optional) Override which update actions users can do and which resources they can take action on. See the Stack Policy Reference and Sample Stack Policies for details.

    Delete

     Stack Name or ID

    see Update above

    Don't fail for non existing stackCheck to not fail the build, if the stack does not exist (anymore). Clear to trigger a build failure otherwise.Generated Variables Code Block
    languagetext
    linenumberstrue
    collapsetrue
    Creating common variables for 1 resources affected by task: ...
    stack/SampleStack-TAWS-IT230-CFN2-38/e893db20-54fa-11e6-a1d2-500c5242948e
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-38.StackStatus: UPDATE_COMPLETE
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-38.StackName: SampleStack-TAWS-IT230-CFN2-38
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-38.CreationTime: 20160728T193850Z
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-38.LastUpdatedTime: 20160728T193925Z
    ... bamboo.custom.aws.cfn.stack.resources
    :
    .SampleStack-TAWS-IT230-CFN2-
    24 Creating resource variables for stack '
    38.tags: Cost-Centre;Environment
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2
    -24':
    -38.tags.Cost-Centre: Development
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-
    24
    38.tags.
    StackId: arn:aws:cloudformation:us-east-1:309600995652:stack/SampleStack-TAWS-IT230-CFN2-24/d6620400-2ffc-11e5-b660-50e2415b5e18
    Environment: Test
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-
    24
    38.
    StackStatus
    parameters: 
    DELETE_COMPLETE
    QueueName
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-
    24
    38.parameters.
    StackName
    QueueName: 
    SampleStack
    Bamboo-
    TAWS-IT230-CFN2-24
    38-scheduled
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-
    24
    38.resources.
    CreationTime
    MyQueue: 
    20150721T230428Z
    LogicalResourceId;PhysicalResourceId;ResourceStatus;Timestamp
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-
    24.LastUpdatedTime
    38.resources.MyQueue.LogicalResourceId: 
    20150721T230501Z
    MyQueue
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-
    24.tags: Environment;Cost-Centre
    38.resources.MyQueue.PhysicalResourceId: https://sqs.us-east-1.amazonaws.com/309600995652/Bamboo-38-scheduled
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-
    24
    38.resources.
    tags
    MyQueue.
    Environment
    ResourceStatus: 
    Test
    UPDATE_COMPLETE
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-
    24
    38.resources.
    tags
    MyQueue.
    Cost-Centre
    Timestamp: 
    Development
    20160728T193938Z
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-
    24
    38.
    parameters
    resources:
    QueueName
     MyQueue
    Stack 'SampleStack-TAWS-IT230-CFN2-38' generated 2 outputs:
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-
    24
    38.
    parameters.QueueName
    outputs: 
    Bamboo-24-updated
    QueueARN;QueueURL
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-
    24
    38.
    resources.MyQueue:ResourceStatus;LogicalResourceId;PhysicalResourceId;Timestamp
    outputs.QueueARN: arn:aws:sqs:us-east-1:309600995652:Bamboo-38-scheduled
    ... bamboo.custom.aws.cfn.stack.resources.SampleStack-TAWS-IT230-CFN2-
    24
    38.
    resources
    outputs.
    MyQueue.ResourceStatus
    QueueURL: 
    DELETE_COMPLETE ... custom.aws.cfn.stack.resources.
    https://sqs.us-east-1.amazonaws.com/309600995652/Bamboo-38-scheduled
    Creating common variables for first resource affected by task:
    Creating resource variables for stack 'SampleStack-TAWS-IT230-CFN2-
    24.resources.MyQueue.LogicalResourceId
    38':
    
    MyQueue
    ... bamboo.custom.aws.cfn.stack.
    resources.
    first.StackId: arn:aws:cloudformation:us-east-1:309600995652:stack/SampleStack-TAWS-IT230-CFN2
    -24.resources.MyQueue.PhysicalResourceId: https://sqs.us-east-1.amazonaws.com/309600995652/Bamboo-24-updated
    -38/e893db20-54fa-11e6-a1d2-500c5242948e
    ... bamboo.custom.aws.cfn.stack.first.StackStatus: UPDATE_COMPLETE
    ... bamboo.custom.aws.cfn.stack.
    resources
    first.StackName: SampleStack-TAWS-IT230-CFN2-
    24
    38
    .
    resources
    .
    MyQueue
    .
    Timestamp:
     
    20150721T230557Z
    bamboo.
    ..
    custom.aws.cfn.stack.
    resources.SampleStack-TAWS-IT230-CFN2-24.resources
    first.CreationTime: 
    MyQueue
    20160728T193850Z
    
    Creating common variables for first resource affected by task: Creating resource variables for stack 'SampleStack-TAWS-IT230-CFN2-24':
    ... bamboo.custom.aws.cfn.stack.first.LastUpdatedTime: 20160728T193925Z
    ... bamboo.custom.aws.cfn.stack.first.
    StackId
    tags: 
    arn:aws:cloudformation:us-east-1:309600995652:stack/SampleStack-TAWS-IT230-CFN2-24/d6620400-2ffc-11e5-b660-50e2415b5e18
    Cost-Centre;Environment
    ... bamboo.custom.aws.cfn.stack.first.
    StackStatus
    tags.Cost-Centre: 
    DELETE_COMPLETE
    Development
    ... bamboo.custom.aws.cfn.stack.first.tags.
    StackName
    Environment: 
    SampleStack-TAWS-IT230-CFN2-24
    Test
    ... bamboo.custom.aws.cfn.stack.first.
    CreationTime
    parameters: 
    20150721T230428Z
    QueueName
    ... bamboo.custom.aws.cfn.stack.first.
    LastUpdatedTime
    parameters.QueueName: 
    20150721T230501Z
    Bamboo-38-scheduled
    ... bamboo.custom.aws.cfn.stack.first.
    tags
    resources.MyQueue: 
    Environment;Cost-Centre
    LogicalResourceId;PhysicalResourceId;ResourceStatus;Timestamp
    ... bamboo.custom.aws.cfn.stack.first.
    tags
    resources.MyQueue.
    Environment
    LogicalResourceId: 
    Test
    MyQueue
    ... bamboo.custom.aws.cfn.stack.first.
    tags.Cost-Centre: Development ... custom.aws.cfn.stack.first.parameters: QueueName
    resources.MyQueue.PhysicalResourceId: https://sqs.us-east-1.amazonaws.com/309600995652/Bamboo-38-scheduled
    ... bamboo.custom.aws.cfn.stack.first.resources.
    parameters
    MyQueue.
    QueueName
    ResourceStatus: 
    Bamboo-24-updated
    UPDATE_COMPLETE
    ... bamboo.custom.aws.cfn.stack.first.resources.MyQueue.Timestamp: 
    ResourceStatus;LogicalResourceId;PhysicalResourceId;Timestamp
    20160728T193938Z
    ... bamboo.custom.aws.cfn.stack.first.resources
    .MyQueue.ResourceStatus: DELETE_COMPLETE
    : MyQueue
    Stack 'SampleStack-TAWS-IT230-CFN2-38' generated 2 outputs:
    ... bamboo.custom.aws.cfn.stack.first.
    resources.MyQueue.LogicalResourceId
    outputs: 
    MyQueue
    QueueARN;QueueURL
    ... bamboo.custom.aws.cfn.stack.first.
    resources
    outputs.
    MyQueue.PhysicalResourceId
    QueueARN: 
    https
    arn:aws:
    //
    sqs
    .
    :us-east-1
    .amazonaws.com/309600995652/
    :309600995652:Bamboo-
    24
    38-
    updated
    scheduled
    ... bamboo.custom.aws.cfn.stack.first.
    resources
    outputs.
    MyQueue.Timestamp
    QueueURL: 
    20150721T230557Z ... custom.aws.cfn.stack.first.resources: MyQueue

    Validate

    Info

    The Validate action operates on a template rather than a stack. It has been included in this task for ease of use.

    Stack Template Source

    see Create above

    Generated Variables
    https://sqs.us-east-1.amazonaws.com/309600995652/Bamboo-38-scheduled

    Delete Change Set

    N/A

    Variables

    Include Page_VariablesNote_VariablesNote

    Legacy Variable Naming

    (warning) (warning) CloudFormation Variables had been named inconsistently in previous versions of this add-on - the following names are deprecated, but remain available for compatibility reasons for the time being:

    • the collection of affected stack resources, e.g. bamboo.custom.aws.cfn.stack.resources=i-3280997f;vol-e1debbcd;test-stack-SecurityGroup-KZWPADIUPCL6
    • the status of each affected stack resource, e.g. bamboo.custom.aws.cfn.stack.i-3280997f=CREATE_COMPLETE
    • the collection of generated stack outputs, e.g. bamboo.custom.aws.cfn.stack.outputs=sampleStackOutputKey;StringWithRegex;...
    • the value of each generated stack output, e.g. bamboo.custom.aws.cfn.stack.StringWithRegex=Hello
      • (info) (info) variables with legacy naming without prefix remain available for compatibility (e.g. bamboo.StringWithRegex=Hello)

    How-to Articles

    Filter by label (Content by label)
    max8
    showSpacefalse
    sorttitle
    excerptTypesimple
    cqllabel in ("aws-cli","aws-cloudformation","input") and label in ("kb-how-to-article","kb-troubleshooting-article")

    Frequently Asked Questions (FAQ)

    Questionslist macro
    filterpopular
    asktrue
    limit8
    topicaws-cloudformation

    Change Set Description