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 @@ -115,7 +115,6 @@ When you run a pipeline, a build is created. The following diagram shows you how

<%= image "build-states.svg", size: "900x615", alt: "Build state diagram" %>


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

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

<%= image "job-states.svg", size: "1482x690", alt: "Job state diagram" %>

Job State | Description
stephanieatte marked this conversation as resolved.
Show resolved Hide resolved
----------------------| -----------------------------------------
PENDING | The job has just been created and doesn't have a state yet
pzeballos marked this conversation as resolved.
Show resolved Hide resolved
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