Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update defining_steps.md #2221

Merged
merged 7 commits into from
Apr 23, 2024
26 changes: 25 additions & 1 deletion pages/pipelines/defining_steps.md
Original file line number Diff line number Diff line change
Expand Up @@ -114,7 +114,6 @@ When you run a pipeline, a build is created. The following diagram shows you how

<%= image "build-states.png", alt: "Build state diagram" %>


<%= render_markdown partial: 'pipelines/build_states' %>

## Job states
Expand All @@ -123,6 +122,31 @@ When you run a pipeline, a build is created. Each of the steps in the pipeline e

<%= image "job-states.png", alt: "Job state diagram" %>

Job state | Description
----------------------| -----------------------------------------
`pending` | The job has just been created and doesn't have a state yet.
`waiting` | The job is waiting on a wait step to finish.
`waiting_failed` | The job was in a `waiting` state when the build failed.
`blocked` | The job is waiting on a block step to finish.
`blocked_failed` | The job was in a `blocked` state when the build failed.
`unblocked` | This block job has been manually unblocked.
`unblocked_failed` | This block job was in an `unblocked` state when the build failed.
`limiting` | The job is waiting on a concurrency group check before becoming either `limited` or `scheduled`.
`limited` | The job is waiting for jobs with the same concurrency group to finish.
`scheduled` | The job is scheduled and waiting for an agent.
`assigned` | The job has been assigned to an agent, and it's waiting for it to accept.
`accepted` | The job was accepted by the agent, and now it's waiting to start running.
`running` | The job is running.
`finished` | The job has finished.
`canceling` | The job is currently canceling.
`canceled` | The job was canceled.
`timing_out` | The job is timing out for taking too long.
`timed_out` | The job timed out.
`skipped` | The job was skipped.
`broken` | The jobs configuration means that it can't be run.
`expired` | The job expired before it was started on an agent.
{: class="two-column"}

As well as the states shown in the diagram, the following progressions can occur:

can progress to `skipped` | can progress to `canceling` or `canceled`
Expand Down
Loading