You can use hooks to run scripts at specific steps of the Terraspace lifecycle. These lifecycle points occur at a higher-level than the
|build||When Terraspace builds or compiles the Terraspace project to the
To help you get started quickly, you can generate starter hook code. Check out the examples in the Hooks Generator Docs.
before("build", execute: "echo hi", ) after("build", execute: "echo bye" )
exit on fail
By default, if the hook commands fail, then terraspace will exit with the original hook error code. You can change this behavior with the
before("build", execute: "/command/will/fail/but/will/continue", exit_on_fail: false, )
In this case, regardless of the hook command succeeding or failing, Terraspace will continue right along.
The command name corresponds to the
|label||A human-friendly label so you can see what hooks is being run.|
|execute||The script or command to run. IE: path/to/some/script.sh|
|exit_on_fail||Whether or not to continue process if the script returns an failed exit code.|
Instead of using a script for the hook
execute option, you can also use a Ruby object. This provides some more control over the current process. See: Ruby Hooks
If you need to hook into the Terraspace boot process super-early on, check out Boot Hook.