Skip to content

Commit da9ad52

Browse files
SashaLsnkobriceicle
authored andcommitted
add not_run to upstream docs + job statuses graph
1 parent 22849ed commit da9ad52

File tree

3 files changed

+6
-2
lines changed

3 files changed

+6
-2
lines changed

docs/guides/modules/orchestrate/pages/jobs-steps.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -85,6 +85,7 @@ stateDiagram-v2
8585
state "blocked or not running" as pending
8686
blocked --> pending : Job instructed to start but not yet started
8787
blocked --> unauthorized : Trying to use a context without permission
88+
blocked --> not_run : Job's dependencies will never be satisfied
8889
8990
pending --> running
9091
@@ -102,6 +103,7 @@ stateDiagram-v2
102103
success --> [*]
103104
canceled --> [*]
104105
unauthorized --> [*]
106+
not_run --> [*]
105107
----
106108

107109
.CircleCI server job status transitions

docs/guides/modules/orchestrate/pages/workflows.adoc

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -204,10 +204,11 @@ workflows:
204204
- success
205205
- failed
206206
- canceled
207+
- not_run
207208
----
208209

209210
* The `test` job waits for the `build` job, and only runs if the `build` job is successful.
210-
* The `cleanup` job waits for the `test` job, and runs regardless of whether the `test` job succeeds, fails, or is canceled.
211+
* The `cleanup` job waits for the `test` job, and runs regardless of whether the `test` job succeeds, fails, is canceled or is not run.
211212
212213
TIP: Refer to the xref:reference:ROOT:configuration-reference.adoc#requires[Requires] section of the configuration reference.
213214

docs/reference/modules/ROOT/pages/configuration-reference.adoc

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2794,7 +2794,7 @@ Possible types of `requires` items:
27942794
* Map of job name to status (a required job that must attain the specified status for the job to start) +
27952795
* Map of job name to a list of statuses (a required job that must attain one of the specified status for the job to start)
27962796
2797-
The possible *status* values are: `success`, `failed` and `canceled`.
2797+
The possible *status* values are: `success`, `failed`, `canceled` and `not_run`.
27982798
|===
27992799
--
28002800
@@ -2819,6 +2819,7 @@ workflows:
28192819
- deploy:
28202820
- failed
28212821
- canceled
2822+
- not_run
28222823

28232824
----
28242825

0 commit comments

Comments
 (0)