Stack Policy#

You specify a stack policy with the stackPolicy property. It accepts a string or an object.

Examples#

Setting a stack policy as a string:

stackPolicy: |
  {
    "Statement": [
      {
        "Effect": "Allow",
        "NotAction": "Update:Delete",
        "Principal": "*",
        "Resource": "*"
      }
    ]
  }

Setting a stack policy as an object:

stackPolicy:
  Statement:
    - Effect: Allow
      NotAction: Update:Delete
      Principal: '*'
      Resource: '*'

Stack policy during update#

You specify a stack policy to use during stack update with the stackPolicyDuringUpdate property. It works the same way as the stackPolicy property.

Examples#

Setting a stack policy to use during the stack update as an object:

stackPolicyDuringUpdate:
  Statement:
    - Effect: Allow
      Action: Update:*
      Principal: '*'
      Resource: '*'

Deleting stack policy#

CloudFormation doesn't support removing of a stack policy once it has been created. As a workaround, when you remove the stack policy from the stack configuration, Takomo updates the policy with the allow all policy shown below, which is essentially equivalent to not having a stack policy attached at all.

{
  'Statement':
    [
      {
        'Effect': 'Allow',
        'Action': 'Update:*',
        'Principal': '*',
        'Resource': '*',
      },
    ],
}

Usage In Configuration#

stackPolicy and stackPolicyDuringUpdate properties can be defined in:

• stack group configuration files
• blueprint configuration files
• stack configuration files

Stack Group Config File#

When stackPolicy / stackPolicyDuringUpdate property is defined in a stack group configuration file:

• its value completely overrides the value inherited from the parent stack group
• its value is inherited by stack groups and stacks that belong under the stack group

Blueprint Config File#

When stackPolicy / stackPolicyDuringUpdate property is defined in a blueprint configuration file:

• its value completely overrides the value inherited from the parent stack group
• its value is inherited by stacks that extend the blueprint

Stack Config File#

When stackPolicy / stackPolicyDuringUpdate property is defined in a stack configuration file:

• if the stack extends a blueprint, its value completely overrides the value inherited from the blueprint
• otherwise, its value completely overrides the value inherited from the parent stack group

Requirements#

The stackPolicy and stackPolicyDuringUpdate properties must satisfy these requirements:

• Must be a valid JSON document