YAML for DigitalOcean CLI

View as Markdown

Execute DigitalOcean CLI commands with integration-based authentication.

YAML parameters for DigitalOcean CLI

PARAMETERS

integrationrequiredstring

DigitalOcean integration (DIGITAL_OCEAN)

execute_commandsrequiredstring[]

List of shell commands to execute.

typerequiredstring

Value: DOCTL

actionrequiredstring

Unique identifier for the action within the pipeline.

shellstring enum

Shell to use for executing commands: BASH (default), SH, or ZSH.

Allowed enum:

SH,

BASH,

POWERSHELL

setup_commandsstring[]

Commands to run before the main commands (e.g., for installing dependencies).

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

DigitalOcean CDN DigitalOcean Spaces

YAML examples for DigitalOcean CLI

Execute DigitalOcean CLI commands

yaml
  - action: "DigitalOcean CLI"
    type: "DOCTL"
    integration: "digitalocean_integration"
    shell: "SH"
    execute_commands:
      - "doctl account get"
      - "doctl compute droplet list"