Description

The rule will stop being processed after a certain number of matched builds. Once this condition is met, only the other rules will continue to be processed.

Internally and in the documentation, this value is called matchAtMost.

There are some special values:

Use cases

This feature provides the option to control the number of builds the rule can process. If used with specific actions it can save a significant amount of time when the build history is long.

This feature also provides the option to skip a number of builds while processing builds. To skip 5 builds, you should create a rule with the "Match every build" condition and no action, then set matchAtMost = 5. This will effectively skip 5 builds in each build history manager process. It’s equivalent to saying buildToCheck = lastBuildNo - 5.

Warning!

If the matchAtMost value is set to zero, the rule is effectively disabled. This is useful if the user wants to disable a rule while keeping its other configuration values.