Conditional BuildStep

ID: conditional-buildstep
Warning IconThis plugin is up for adoption! We are looking for new maintainers. Visit our Adopt a Plugin initiative for more information.

conditional buildstep conditional buildstep plugin conditional buildstep

A buildstep wrapping any number of other buildsteps, controlling their execution based on a defined condition.

Info

This plugin requires the TokenMacro Plugin and the  Run Condition Plugin to be installed!

  • Ever wanted to have more control whether a step should be executed or not?

  • Want to reduce the number of jobs doing nearly the same thing?

Add a conditional buildstep which acts as a container. It will allow you to define a condition controling the execution of the step(s).

Conditions

There are multiple conditions one can choose of, these are all defined by the Run Condition Plugin

Missing builder

If you’re not able to add the builder of your choice within a conditional build step (because it’s not available within the dropdown), then this is likely because the builder does not provide a @DataBoundConstructor constructor and/or the Descriptor does not extend hudson.tasks.BuildStepDescriptor. For non programmers: the plugin you would like to use does not yet follow the newest Jenkins coding guidelines. Without this, the conditional buildstep plugin is not able to work with it.

Conditional step (single)

This build step allows you to select any build step and define a condition to control whether the step should be executed. For reasons why you might want to use this step, see Why use Conditional step (single)?

image

Conditional steps (multiple)

A Conditional steps (multiple) container is able to contain any number of any other buildsteps (e.g. Shell, Ant, Maven,…​) and you can have any number of 'Conditional Steps' containers, each configured with a different condition.

image

Examples

Please check out the examples at the Run Condition Plugin

Changelog

  • For recent versions, see GitHub Releases

  • For versions 1.3.6 and older, see CHANGELOG.adoc

Getting Help

For Help please use the Jenkins Users mailing list or the Issue tracker (Jira).

License

Licensed under the MIT Licence.