YAML for MacOS VM

Execute commands on a native macOS virtual machine with advanced VM controls.

YAML parameters for MacOS VM

PARAMETERS
typerequiredstring

Value: NATIVE_BUILD_MAC_VM

actionrequiredstring
Unique identifier for the action within the pipeline.
sync_pathsSyncPathYaml[]
File paths that should be copied before and after the execution.
shellstring enum
Shell to use for executing commands.
Allowed enum:
SH,
BASH,
POWERSHELL
xcode_versionstring
The version of Xcode to use
pre_start_simulatorsstring[]
The list of simulators to start before the build
node_versionstring
The version of Node.js to use
flutter_versionstring
The version of Flutter to use
archive_locationstring
The path to the archive location
certificatesstring[]
The list of certificates to use for signing
provision_profilesstring[]
The list of provisioning profiles to use
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_idinteger
The ID of the action from which the VM will be used
vm_action_namestring
The name of the action from which the VM will be used
instance_typestring enum
The type of instance to use for the native build
Allowed enum:
GENERAL_MEDIUM,
GENERAL_LARGE,
GENERAL_XLARGE,
GENERAL_2XLARGE,
COMPUTE_MEDIUM,
COMPUTE_LARGE,
COMPUTE_XLARGE,
COMPUTE_2XLARGE,
ARM_GENERAL_MEDIUM,
ARM_GENERAL_LARGE,
ARM_GENERAL_XLARGE,
ARM_GENERAL_2XLARGE,
ARM_COMPUTE_MEDIUM,
ARM_COMPUTE_LARGE,
ARM_COMPUTE_XLARGE,
ARM_COMPUTE_2XLARGE
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 MacOS VM

Run commands on macOS VM

yaml
- action: "Run on macOS VM" type: "NATIVE_BUILD_MAC_VM" trigger_time: "ON_EVERY_EXECUTION" working_directory: "/Users/buddy/project" shell: "SH" xcode_version: "15.0" commands: - "xcodebuild -project MyApp.xcodeproj -scheme MyApp build" certificates: - "my_distribution_cert" provision_profiles: - "my_provision_profile"