Conditional Queueing

Description

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 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.

Actions Supported

  • queueBuild
  • queueBuildFromList

Fields


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.