YAML for Linux

Execute commands on a native Linux virtual machine.

YAML parameters for Linux

PARAMETERS
distributionrequiredstring enum
Defines the image used to create the VM
Allowed enum:
UBUNTU_20_04,
AMI,
WINDOWS_SERVER_2019,
PREVIOUS_ACTION
typerequiredstring

Value: NATIVE_BUILD_LINUX

actionrequiredstring
Unique identifier for the action within the pipeline.
amiAmiYaml
Set if distribution is set to AMI.
shellstring enum
Shell to use for executing commands: BASH (default), SH, or ZSH.
Allowed enum:
SH,
BASH,
POWERSHELL
sync_pathsSyncPathYaml[]
Define file paths that should be copied before (PIPELINE_TO_VM) and after the execution (VM_TO_PIPELINE).
working_directorystring
Directory where commands are executed.
execute_every_commandboolean
When true, execute all commands even if earlier ones fail.
commandsstring[]
The commands to execute in the native build environment
vm_from_prev_actionboolean
If set to true, the VM from the previous action will be used
vm_action_namestring
The name of the action from which the VM will be used
trigger_timestring enum
Specifies when the action should be executed.
Allowed enum:
ON_EVERY_EXECUTION,
ON_SUCCESS,
ON_FAILURE,
ON_BACK_TO_SUCCESS,
ON_WARNING,
ON_WAIT_FOR_APPROVE,
ON_TERMINATE
loopstring[]
The list of variables for dynamic action execution. The action runs once for each value.
run_only_on_first_failureboolean
Defines whether the action should be executed on each failure. Restricted to and required if the trigger_time is ON_FAILURE.
disabledboolean
When set to true the action is disabled. By default it is set to false.
timeoutinteger
The timeout in seconds.
ignore_errorsboolean
If set to true the execution will proceed, mark action as a warning and jump to the next action. Doesn't apply to deployment actions.
retry_intervalinteger
Delay time between auto retries in seconds.
retry_countinteger
Number of retries if the action fails.
run_nextstring enum
Defines whether the action should run in parallel with the next one.
Allowed enum:
WAIT_ON_SUCCESS,
IN_SOFT_PARALLEL,
IN_HARD_PARALLEL
trigger_conditionsTriggerConditionYaml[]
The list of trigger conditions to meet so that the action can be triggered.
variablesVariableYaml[]
The list of variables you can use in the action.

Last modified on Jul 31, 2025

YAML examples for Linux

Run commands on Linux VM

yaml
- action: "Run commands on Linux VM" type: "NATIVE_BUILD_LINUX" trigger_time: "ON_EVERY_EXECUTION" working_directory: "/buddy/my-project" shell: "SH" distribution: "UBUNTU_20_04" ami: id: "ami-linux-123" port: "22" user: "ubuntu" commands: - "apt-get update" - "make build"