Pipeline file reference

The pipeline file is YAML. This page lists every field and its default.

Top level fields

• steps: the ordered list of steps. Required.

• env: variables available to every step.

• timeout: minutes before the run is stopped. Default 60.

• matrix: axes to expand a job across.

Step fields

• name: shown in the dashboard.

• run: the shell command.

• if: a condition, for example branch == main.

• retry: how many times to retry on failure. Default 0.

Matrices

matrix:
  node: [20, 22]
  os: [linux, macos]

matrix:
  node: [20, 22]
  os: [linux, macos]

matrix:
  node: [20, 22]
  os: [linux, macos]

This expands into four jobs. A run can have at most 64 combinations.