Prune stacks

Undeploy (remove) stacks marked as obsolete within the given command path. 
Takomo also removes obsolete stacks that depend on the obsolete stacks within the command path, even if they are outside the given command path. Takomo arranges the stacks in removal order by stack dependencies, ensuring that it removes the stacks in the correct order and in parallel when possible.
Obsolete stacks can't have dependent stacks that are not obsolete themselves.
Usage
1
tkm stacks prune [command-path] \
2
  [--ignore-dependencies] \
3
  [--interactive|-i] \
4
  [--output <format>]
Copied!
Positional arguments
command-path
Command path to select which stacks to prune.
Optional, by default, Takomo prunes all stacks.
Options
In addition to the common options, this command has the following options.
--ignore-dependencies
Ignore stack dependencies. By default, when a stack is removed, its dependants are removed first, and then the stack itself. In some exceptional cases, you might want to remove just one stack and skip its dependants.
Bear in mind that this option is supported only when exactly one stack is removed. Ignoring dependants may lead into unexpected results, so you should use this option only in exceptional circumstances.
--interactive, -i
Choose the command path using autocompleting search.
--output <format>
Print the command result using this format
Supported values: text, json, yaml
IAM permissions
These are the minimum IAM permissions required to run this command.
1
# Minimum permissions. Additional permissions are needed to actually 
2
# remove the resources defined in CloudFormation templates.
3
Statement: 
4
  - Sid: Stacks
5
    Effect: Allow
6
    Action:
7
      - cloudformation:DescribeStackEvents
8
      - cloudformation:DeleteStack
9
      - cloudformation:DescribeStacks
10
    Resource: "*"
11
​
12
  # IAM permissions needed only if command roles are used  
13
  # Specify resource to restrict access to specific roles.  
14
  - Sid: IAM
15
    Effect: Allow
16
    Action:
17
      - sts:AssumeRole
18
    Resource: "*" 
Copied!
Examples
Prune all stacks:
1
tkm stacks prune
Copied!
Prune stacks within the given command path:
1
tkm stacks prune /dev
Copied!
Prune only /dev/vpc.yml stack and its dependants:
1
tkm stacks prune /dev/vpc.yml
Copied!
The region part must be specified if the stack has more than one region and you want to prune it from only one region.
1
tkm stacks prune /dev/vpc.yml/eu-west-1
Copied!
Prune exactly one stack and skip its dependants:
1
tkm stacks prune /cloudtrail.yml --ignore-dependencies
Copied!

Command-line usage - Previous

Undeploy stacks

Next - Command-line usage

List stacks

Last modified 1mo ago

Export as PDF

Copy link

Contents