Delete an existing AWS CloudFormation stack

Octopus supports the deletion of an existing AWS CloudFormation stack through the Delete an AWS CloudFormation stack step. This step deletes a CloudFormation stack using AWS credentials managed by Octopus.

The proceeding instructions can be followed to configure the Delete an AWS CloudFormation stack step.

Add the CloudFormation step

Add the Delete an AWS CloudFormation stack step to the project, and provide it a name.

AWS section

Select the variable that references the Amazon Web Services Account under the AWS Account section or choose to execute using a service role assigned to the EC2 instance. If you don’t have an AWS Account Variable yet, check our documentation on how to create one.

AWS Account

The supplied account can optionally be used to assume a different AWS service role. This can be used to run the AWS commands with a role that limits the services that can be affected.

AWS Role

If you select Yes to Execute using the AWS service role for an EC2 instance, you do not need an AWS account or account variable. Instead the AWS service role for the EC2 instance executing the deployment will be used. See the AWS documentation for more information on service roles.

CloudFormation section

Under the CloudFormation section, the AWS region and stack name need to be defined.

If the stack does not exist, this step will succeed and not attempt to delete it again.

You can also optionally wait for the stack to be deleted completely before finishing the step by selecting the Wait for completion check-box.

Unselecting the Wait for completion check-box will allow the step to complete once that CloudFormation deletion has been initiated. However unselecting the option means that the step will not fail if the CloudFormation stack deletion fails.

AWS Region

Help us continuously improve

Please let us know if you have any feedback about this page.

Send feedback

Page updated on Sunday, January 1, 2023