Steps

Each job has a single build plan configured as job.plan. A build plan is a recipe for what to run when a build of the job is created.

A build plan is a sequence of steps:

• Task

  ---

  Run a pure function of code

  Schema

• Get

  ---

  Fetch data from a Resource

  Schema

• Put

  ---

  Update data of a Resource

  Schema

• Set Pipeline

  ---

  Configure a pipeline using a pipeline

  Schema

• In Parallel

  ---

  Run multiple steps at a time

  Schema

• Load Var

  ---

  Create a new variable scoped to the job

  Schema

• Do

  ---

  Run multiple steps serially

  Schema

• Try

  ---

  Continue regardless of outcome

  Schema

When a new version is available for a get step with trigger: true configured, a new build of the job will be created from the build plan.

When viewing the job in the pipeline, resources that are used as get steps appear as inputs, and resources that are used in put steps appear as outputs. Jobs are rendered downstream of any jobs they reference in passed constraints, connected by the resource.

If any step in the build plan fails, the build will fail and subsequent steps will not be executed. Additional steps may be configured to run after failure by configuring on_failure or ensure (or the job equivalents, job.on_failure and job.ensure) using Hooks and Modifiers.