Extension Block

The extension block adds functionalities to terrabuild. An extension defined in a PROJECT file is local to this project and can override globally defined extension.

An extension can run in a container to provide isolation and repeatability. See Docker for more technical information.

Example Usage

extension @dotnet {
  container = "mcr.microsoft.com/dotnet/sdk:8.0"
  platform = "linux/arm64"
  variables = [ "SECRET_VAR" ]
  batch = true
  defaults = {
    configuration: var.configuration
  }
}

Argument Reference

The following arguments are supported:

• identifier- (Mandatory) Identifier of the extension.
• container - (Optional) Docker image in which an action will be executed.
• platform - (Optional) Platform for image.
• variables - (Optional) A list of environment variable names to pass from host to container.
• batch - (Optional) Enable batch support for extension. Default is false.
• defaults - (Optional) Defaults values used as action arguments. defaults is initialized with a mapping of expressions.
• script - (Optional) F# script used to implement the extension. Argument is of type string and is a relative path to the file.