...
Some use cases have a need to only queue a build if certain conditions are met. This describes the support provided in this area. It is based on querying previous build results to see if there already exists a build that satisfies the conditions. If so, a new build is not required and so will not be queued. This uses the same filtering criterial criteria used in getBuildList. . If getBuildLIst returns at least 1 build matching the filtering conditions, then the build will not be queued as there is an existing build matching the criteria.
The support has been implemented to be expanded in the future as more use cases are identified. Open an issue if you have a new use case.
...
- queueBuild
- queueBuildFromList
Fields
Table plus |
---|
Field | From | Description | Examples |
---|
state | build result | Compare the state of a build result to the requested value. | -- |
|
...
field state=SUCCESSFUL | notState | build result | Compare the state of a build result not being the requested value. | -- |
|
...
field notState=UNKNOWN | started | build result | Compare the started date of a build result to the requested value. | --field "started = 2016-04-30" --dateFormat yyyy-MM-dd" -- |
|
...
...
${bamboo.planKey}" | endedBefore | build result | Compare the ended date of a build result to the requested value. | --field "endedBefore = 2016-04-30" --dateFormat yyyy-MM-dd |
|
Special Values
If you provide a plan or build key for the value of the started or endedBefore field, we will automatically convert that into start or completion (respectively) date of the referenced build (defaulted to latest if not explicitly stated). A good use case is using ${bamboo.planKey} to compare to latest build for a plan where you are running the queueBuild action from.