Terraform

Operates on a Terraform project. Can validate, plan, and apply Terraform configurations.

Object Representation (YAML)

id: String
name: String
type: String
depends: [String]
tags: [String]
condition: Boolean
each: Array
while: String
until: String
verbosity: String
ignore_errors: Boolean
tool_version: String
tool_options: Object
properties:
  command: String
  config_file_content: String
  init: Boolean
  cwd: String
  vars: String
  args: String
  credentials: [String]
  env:
    - name: String
      value: String

Fields

Property Details
id *

String

A unique identifier for the step.

Can contain hyphens and underscores, but not spaces.
name *

String

A friendly name for the step. This name will appear in the pipeline designer and run output.
type *

String

The type of the step. Can be pipeline or a step module type.
depends[]

[String]

A list of dependencies of this step.

This step will not be executed until all steps with ids in this list are finished executing.
tags[]

[String]

Tags are used to group related steps. Steps with the same tag can be retrieved using the findStepsByTag() helper function.

Can contain hyphens and underscores, but not spaces.
condition

Boolean

An expression which is evaluated before the step executes. If it evaluates to false, the step will be skipped. The step.result.status field will be "Skipped".
each

Array

An expression which evaluates to an array. It is evaluated once before the first iteration. There will be one iteration for each element of the array. An empty array ([]) will results in no iterations being executed.
while

String

A boolean expression evaluated before each iteration. When the expression evaluates to false, iteration stops. If false before the first iteration, no iterations will be executed.
until

String

A boolean expression evaluated after each iteration. When the expression evaluates to true, iteration stops. The first iteration will always be excuted with no regard for the value of the expression.
verbosity

String

Step event verbosity. Determines how much information about step execution is sent back to the application.
ignore_errors

Boolean

If true, errors in the step module will not halt pipeline execution, and subsequent steps will still be executed. The step.result.status field will be "Failed" if the step encounters an error.
tool_version

String

The version to use for tool installation.
tool_options

Object

-

properties.command

String

The Terraform command to run. One of init, apply, plan, validate, destroy.
properties.config_file_content

String

Inline configuration content. This can be used if you don't already have a Terraform project on the agent.
properties.init *

Boolean

Whether to run init in the configuration directory. Optional if command is init.
properties.cwd

String

Working directory for the Terraform run. Defaults to the run directory.
properties.vars

String

Inline variables file. This will be written to the configuration directory as a tfvars file.
properties.args

String

Extra command line arguments to pass to Terraform.
properties.credentials[]

[String]

A list of Azure Service Principal, GCP Service Account, or AWS IAM Access Key credentials. Providing multiple types allows running multi-cloud configurations. Only one of each type is supported.
properties.env[]

[Object]

A list of environment variables that will be set for script execution.
properties.env[].name *

String

Environment variable name.
properties.env[].value *

String

Environment variable value.

Result Fields

The following are the step execution result fields available at steps.<step id>.result after a step executes.

Key Details
result.status

String

A string indicating the step execution status. Can be Succeeded, Failed, or Skipped.