Variables

Variables used in expressions have a scope and an identifier. The scope defines the source of the variable, and the identifier is the name of the variable within that scope.

Terrabuild supports the following variable scopes:

• terrabuild - Predefined variables provided by Terrabuild (build context, system info, etc.)
• var - Workspace variables defined in the WORKSPACE file
• local - Local values defined in WORKSPACE or PROJECT files
• project - Project properties from the project block

Here are some variable reference examples:

• terrabuild.branch_or_tag - Access the current Git branch or tag
• var.config - Access a workspace variable named config
• local.config - Access a local value named config
• project.api.version - Access the version hash of the project identified as api