Tfvars: Debugging Layering

Terraspace’s Layering abilities are so powerful that they can be difficult to debug when overly used. It is recommend you chose only a few layers that make sense for your goals and stick to them. Essentially, limit the rope length. Here are also some debugging tips.

Enable Logging

You can debug layers by turning a config to show the found layers.

config/app.rb

Terraspace.configure do |config|
  config.layering.show = true
end

This will show the found layers.

$ terraspace build demo
    app/stacks/demo/tfvars/base.tfvars
    app/stacks/demo/tfvars/dev.tfvars

All Considered Layers

If you want to also see all the considered layers use TS_SHOW_ALL_LAYERS=1.

$ export TS_SHOW_ALL_LAYERS=1
$ terraspace build demo
Building .terraspace-cache/us-west-2/dev/stacks/demo
    config/terraform/tfvars/base.tfvars
    config/terraform/tfvars/dev.tfvars
    config/terraform/tfvars/us-west-2.tfvars
    config/terraform/tfvars/us-west-2/base.tfvars
    config/terraform/tfvars/us-west-2/dev.tfvars
    app/stacks/demo/tfvars/base.tfvars
    app/stacks/demo/tfvars/dev.tfvars
    app/stacks/demo/tfvars/us-west-2.tfvars
    app/stacks/demo/tfvars/us-west-2/base.tfvars
    app/stacks/demo/tfvars/us-west-2/dev.tfvars

Layering Modes: simple, namespace, provider

In Terraspace v2, the namespace and provider level layering is off by default. There are 3 Layering Modes:

If you need v1 behavior, you can use “provider” mode.

config/app.rb

Terraspace.configure do |config|
  config.layering.mode = "provider" # simple, namespace, or provider
end

Here’s a concrete example:

$ export TS_SHOW_ALL_LAYERS=1
$ terraspace build demo
Building .terraspace-cache/us-west-2/dev/stacks/demo
    app/stacks/demo/tfvars/base.tfvars (found)
    app/stacks/demo/tfvars/dev.tfvars (found)
    app/stacks/demo/tfvars/us-west-2.tfvars
    app/stacks/demo/tfvars/us-west-2/base.tfvars
    app/stacks/demo/tfvars/us-west-2/dev.tfvars
    app/stacks/demo/tfvars/111111111111.tfvars
    app/stacks/demo/tfvars/111111111111/base.tfvars
    app/stacks/demo/tfvars/111111111111/dev.tfvars
    app/stacks/demo/tfvars/111111111111/us-west-2.tfvars
    app/stacks/demo/tfvars/111111111111/us-west-2/base.tfvars
    app/stacks/demo/tfvars/111111111111/us-west-2/dev.tfvars
    app/stacks/demo/tfvars/aws.tfvars
    app/stacks/demo/tfvars/aws/base.tfvars
    app/stacks/demo/tfvars/aws/dev.tfvars
    app/stacks/demo/tfvars/aws/us-west-2.tfvars
    app/stacks/demo/tfvars/aws/us-west-2/base.tfvars
    app/stacks/demo/tfvars/aws/us-west-2/dev.tfvars
    app/stacks/demo/tfvars/aws/111111111111.tfvars
    app/stacks/demo/tfvars/aws/111111111111/base.tfvars
    app/stacks/demo/tfvars/aws/111111111111/dev.tfvars
    app/stacks/demo/tfvars/aws/111111111111/us-west-2.tfvars
    app/stacks/demo/tfvars/aws/111111111111/us-west-2/base.tfvars
    app/stacks/demo/tfvars/aws/111111111111/us-west-2/dev.tfvars

Notes:

Useful With

Debugging layers with these flags can be particularly useful when using:

More tools: