YAML Schema

The buddy.yml file defines all pipelines in the project. Every pipeline consists of a list of actions to be executed. Below you’ll find schemas for both pipelines and actions.

Pipelines schema

The file consists of a list of pipelines:

- pipeline: "production"
  trigger_mode: "MANUAL"
  ref_name: "master"
  variables:
  - key: "username"
    value: "Buddy"
    settable: false
    description: "var_descrption"
- pipeline: "build"
  trigger_mode: "ON_EVERY_PUSH"
  ref_name: "*"

Properties

Name	Type	Description
pipeline `Required`	String	The ID of the pipeline.
trigger_mode `Required`	String	The trigger mode of the pipeline. Can be one of `MANUAL`, `SCHEDULED` or `ON_EVERY_PUSH`.
ref_type	String	The ref type that triggers the pipeline. Can be one of `BRANCH`, `TAG`, `WILDCARD`, `PULL_REQUEST` or `NONE`.
ref_name	String	The wildcard, branch, tag or pull request. Automatically set to NONE if not provided.
always_from_scratch	Boolean	Defines whether or not to upload everything from scratch on every execution.
auto_clear_cache	Boolean	Defines whether or not to automatically clear cache before running the pipeline .
no_skip_to_most_recent	Boolean	Defines whether or not to skip execution to the most recent execution.
trigger_condition	String	Defines when the build action should be run. Can be one of `ALWAYS`, `ON_CHANGE`, `ON_CHANGE_AT_PATH`, `VAR_IS`, `VAR_IS_NOT`, `VAR_CONTAINS`, `VAR_NOT_CONTAINS`, `DATETIME` or `SUCCESS_PIPELINE`. Can't be used in deployment actions.
trigger_condition_paths	String[]	Required when `trigger_condition` is set to `ON_CHANGE_AT_PATH`.
trigger_variable_key	String	Required when `trigger_condition` is set to `VAR_IS`, `VAR_IS_NOT` or `VAR_CONTAINS` or `VAR_NOT_CONTAINS`. Defines the name of the desired variable.
trigger_variable_value	String	Required when `trigger_condition` is set to `VAR_IS`, `VAR_IS_NOT` or `VAR_CONTAINS` or `VAR_NOT_CONTAINS`. Defines the value of the desired variable which will be compared with its current value.
do_not_create_commit_status	Boolean	Defines whether or not to omit sending commit statuses to Github or Gitlab upon execution.
start_date	iso 8601 utc date	Required if the pipeline is set to `trigger_mode` `SCHEDULED` and no `cron` is specified. Defines when the pipeline execution should start. Format: 2016-11-18T12:38:16.000Z
delay	Integer	Required if the pipeline is set to `trigger_mode` `SCHEDULED` and no `cron` is specified. Defines the intervals in which the pipeline should be executed (in minutes).
cron	String	Required if the pipeline is set to `trigger_mode` `SCHEDULED` and neither `start_date` nor `delay` is specified. The standard CRON expression defining the execution schedule.
actions_list	String[]	The list of actions executed in the pipeline.
variables	Variable[]	The list of variables you can use in the pipeline.
ignore_fail_on_project_status	Boolean	If set to `true` the status of a given pipeline will not impact the project status on the dashboard.
execution_message_template	String	The title of every execution in this pipeline. By default it is set to `$BUDDY_EXECUTION_REVISION_SUBJECT`.
trigger_hours	Integer[]	Available when `trigger_condition` is set to `DATETIME`. Defines the time – by default running from 1 to 24.
trigger_days	Integer[]	Available when `trigger_condition` is set to `DATETIME`. Defines the days running from 1 to 7 where 1 is for Monday.
zone_id	String	Available when `trigger_condition` is set to `DATETIME`. Defines the timezone (by default it is UTC) and takes values from here.
trigger_project_name	String	Required when `trigger_condition` is set to `SUCCESS_PIPELINE`. Defines the name of the project in which the `trigger_pipeline_name` is.
trigger_pipeline_name	String	Required when `trigger_condition` is set to `SUCCESS_PIPELINE`. Defines the name of the pipeline.
worker	String	The name of the worker on which the pipeline will be launched. Only for Buddy On-premises.
target_site_url	String	The URL of the target website.

Actions schema

Every pipeline contains a list of actions. The actions are executed in the order provided in the .yml file:

- pipeline: "production"
  trigger_mode: "MANUAL"
  ref_name: "master"
  ref_type: "BRANCH"
  execution_message_template: "test"
  ignore_fail_on_project_status: "true"
  actions:
  - action: "Execute: npm test"
    type: "BUILD"
    docker_image_name: "library/node"
    docker_image_tag: "6"
    execute_commands:
    - "npm install"
    - "npm test"
    setup_commands:
    - "npm install -g gulp grunt-cli"
    variables:
    - key: "username"
      value: "Buddy"
      settable: true
      description: "var_description"
    retry_delay: 1
    retry_count: 3
  - action: "Upload files to buddy.server"
    type: "FTP"
    input_type: "BUILD_ARTIFACTS"
    local_path: "/"
    login: "buddy"
    password: "password"
    host: "buddy.server"
    port: "21"
    retry_delay: 1
    retry_count: 3

Properties

Name	Type	Description
action `Required`	String	The ID of the action.
type `Required`	String	The type of the action.
trigger_time	String	Specifies when the action should be executed. Can be one of `ON_EVERY_EXECUTION`, `ON_FAILURE` or `ON_BACK_TO_SUCCESS`. The default value is `ON_EVERY_EXECUTION`.
variables	Variable[]	The list of variables you can use the action.
trigger_condition	String	Defines when the build action should be run. Can be one of `ALWAYS`, `ON_CHANGE`, `ON_CHANGE_AT_PATH`, `VAR_IS`, `VAR_IS_NOT`, `VAR_CONTAINS`, `VAR_NOT_CONTAINS`, `DATETIME` or `SUCCESS_PIPELINE`. Can't be used in deployment actions.
trigger_condition_paths	String[]	Required when `trigger_condition` is set to `ON_CHANGE_AT_PATH`.
trigger_variable_key	String	Required when `trigger_condition` is set to `VAR_IS`, `VAR_IS_NOT` or `VAR_CONTAINS` or `VAR_NOT_CONTAINS`. Defines the name of the desired variable.
trigger_variable_value	String	Required when `trigger_condition` is set to `VAR_IS`, `VAR_IS_NOT` or `VAR_CONTAINS` or `VAR_NOT_CONTAINS`. Defines the value of the desired variable which will be compared with its current value.
timeout	Integer	The timeout in seconds.
disabled	Boolean	When set to `true` the action is disabled. By default it is set to `false`.
run_next_parallel	Boolean	When set to `true`, the subsequent action defined in the pipeline will run in parallel to the current action.
run_only_on_first_failure	Boolean	Defines whether the action should be executed on each failure. Restricted to and required if the `trigger_time` is `ON_FAILURE`.
trigger_hours	Integer[]	Available when `trigger_condition` is set to `DATETIME`. Defines the time – by default running from 1 to 24.
trigger_days	Integer[]	Available when `trigger_condition` is set to `DATETIME`. Defines the days running from 1 to 7 where 1 is for Monday.
zone_id	String	Available when `trigger_condition` is set to `DATETIME`. Defines the timezone (by default it is UTC) and takes values from here.
trigger_project_name	String	Required when `trigger_condition` is set to `SUCCESS_PIPELINE`. Defines the name of the project in which the `trigger_pipeline_name` is.
trigger_pipeline_name	String	Required when `trigger_condition` is set to `SUCCESS_PIPELINE`. Defines the name of the pipeline.
ignore_errors	Boolean	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_delay	Integer	Delay time between auto retries in minutes.
retry_count	Integer	Number of retries if the action fails.

On top of these properties every action has a set properties unique to its type. You can read how to define each type of action in separate articles.

Variables schema

You can define variables in the following way:

variables:
- key: "login"
  value: "secure!GKOIn5ZIS+GOqpWRm9eQpg=="
  encrypted: true
  settable: true
  description: "login"
- key: "id_myKey"
  value: "secure!0HkLQ1YOqFlB9+Y4udxjbw=="
  encrypted: true
  description: "My custom SSH key"
  ssh_key: true

Properties

Name	Type	Description
key `Required`	String	The name of the variable.
value `Required`	String	The value of the variable.
description	String	The optional description of the variable.
encrypted	Boolean	When set to `true` the variable value will be encrypted and hidden.
settable	Boolean	When set to `true` the variable value can be shifted between subsequent actions or executions as well as pipelines.
ssh_key	Boolean	When set to `true` the given variable will be marked as an SSH key.

Using encrypted variables in YAML with Buddy Encryption Tool

To define a variable with the encrypted value:

Go to the Pipelines tab and click YAML helper in the right menu. Select Generate an encrypted value:
Provide the input value and click Encrypt. It will produce a hash that you can copy and safely use in your YAML:

The salt which is used to encrypt the values is unique for each workspace. If you change it, you will need to change all encrypted values in your YAMLs.

The value should be changed only when you move your pipelines with the export/import option – either to another workspace, or from Cloud to the on-premises version.

Multiline YAML

To apply multiline in YAML, use the | (pipe) character:

pipeline: |
    first line
    second line

Please mind that some fields are collections and should retain the collection structure. This applies to SSH and build actions:

 - action: "Execute: ls"
    type: "BUILD"
    execute_commands: 
    - npm install 
    - npm test
    - npm build

If you want to apply multine in such actions, you need to define it as an element of the execute_commands collection:

 - action: "Execute: ls"
    type: "BUILD"
    execute_commands: 
    - |
      npm install &&
      npm test
    - npm build

Questions?

Not sure how to configure a pipeline for your process? Reach out on the live-chat, contact support, or ask our community on our forum.

Sign up for Buddy Digest

Best practices on CI/CD and fresh changelogs delivered weekly to your inbox.

YAML Schema

Pipelines schema

Actions schema

Variables schema

Multiline YAML

Questions?

Sign up for Buddy Digest

Contents

Get started for free