Custom Layering
If Terraspace built-in layering does not work for your needs, you can customize the way Layering is done.
Custom layering is an advanced use-case. It is generally recommended to stick to the Terraspace conventions, which is already quite powerful and others won’t have to learn the customization.
Structure
To fully customize layering, you redefine the Terraspace::Layering module. Here’s a starter structure:
config/inits/layering.rb
Terraspace::Layering.module_eval do
# def pre_layers
# []
# end
#
# def main_layers
# super
# end
#
# def post_layers
# []
# end
end
Note: Make sure to use module_eval or require terraspace/layering first. This ensures that the existing Terraspace Layering definition is first loaded and then you can add your own customizations. You can also use the ActiveSupport.on_load(:terraspace_layering) hook instead if you prefer not use module_eval. Example:
config/inits/layering.rb
ActiveSupport.on_load(:terraspace_layering) do
module Terraspace::Layering
# ...
end
end
Interface Methods
There are 3 main interface methods designed to be overriden:
- pre_layers: Layers that get processed before the main layer. Defaults to an empty Array.
- main_layers: The main layers that get processed as described by the Terraspace docs. This includes the base and env layers as well as the layers provided by the specific cloud plugins. IE: AWS, Azure, GCP.
- post_layers: Layers that get processed after the main layer. Defaults to an empty Array.
You can chose the methods to override.
Example
Let’s override the pre_layers method as an example:
config/inits/layering.rb
Terraspace::Layering.module_eval do
def pre_layers
[
"teams/#{ENV['TEAM']}",
]
end
end
The pre_layer adds a layer using the TEAM env var. For example:
config/terraform/tfvars/teams/backend.tfvars
team = "backend"
$ ls config/terraform/tfvars/teams/backend.tfvars
config/terraform/tfvars/teams/backend.tfvars
$ TEAM=backend terraspace build demo
$ ls .terraspace-cache/us-west-2/dev/stacks/demo/*.tfvars
.terraspace-cache/us-west-2/dev/stacks/demo/1-project-teams-backend.auto.tfvars
$
