Pipeline: Milestone Step1.3.1Minimum Jenkins requirement: 1.642.3ID: pipeline-milestone-step
Provides the milestone step in Pipeline scripts.
By default, Pipeline builds can run concurrently. The milestone step ensures an older build will not override a newer build, so the older build will never be allowed to pass a
milestone (it is aborted) if a newer build already passed it.
This step is specially useful in Continuous Delivery pipelines, where builds ordering is very important as the order defines what is going to be delivered, so it provides a control point that aborts any build trying to deliver an old commit when a newer one is already being delivered.
In general this step grants:
- Builds pass milestones in order (taking the build number as sorter field).
- Older builds will not proceed (they are aborted) if a newer one already passed the milestone.
- When a build passes a milestone, any older build that passed the previous milestone but not this one is aborted (see TIP 2 below).
There are two optional parameters:
ordinal: sequential number which makes milestones comparable. For any given two consecutive milestones, ordinal for the second milestone must be a greater integer than the ordinal for the first one. If not specified an auto-incremented ordinal is internally generated.
label: just for displaying purposes in Pipeline visual representations (provided by other plugins).
This examples are both valid:
TIP 1: A combination of this step and the
lock step can be used to configure a reliable Continuous Delivery pipeline as both delivering latest code status and unique deployments are granted. There is an example of this pattern in the Pipeline CD demo Jenkinsfile.
TIP 2: retroactive builds abort, which is older builds being cancelled once a newer one passes a milestone that the older builds has not passed yet. For example, given this script:
If three builds (#1, #2 and #3) start concurrently they are all going to stop on
input step waiting for user interaction. If the user allows build #3 to proceed (so it passes milestone 2) then builds #2 and #1 will be automatically cancelled.
1.3.1 (Mar 28, 2017)
- NPE in CleanupJobsOnDelete (JENKINS-41311)
1.3 (Dec 28, 2016)
- Clean up milestone build counter on job delete (JENKINS-38641)
1.2 (Nov 17, 2016)
- Fix a small logging quirk (logging the wrong ordinal)
1.1 (Oct 5, 2016)
- Fix milestone step being incorrectly detected as inside a parallel (JENKINS-38464)
1.0 (Sep 20, 2016)
- First release