This plugin listens for comments on pull requests and will trigger a GitHub multibranch job if a comment body matches the configured value, such as "rerun the build". This is implemented as a branch property on multibranch jobs.
To enable this behavior, simply add one or more of the branch properties from this plugin to the multibranch job and configure the regular expression to match against the comment body.
Please ensure that you have a GitHub server properly connected via the Jenkins configuration, or else the plugin will not operate correctly.
The regex is not surrounded with any markers and uses the
Pattern.CASE_INSENSITIVE
and Pattern.DOTALL
Java flags.
For example, ^rerun the build$
only matches comments that contain no other
text besides "rerun the build" (case insensitive), while rebuild
would match
comments such as
Please
rebuild this
and
Commence the rebuilding
If no pattern is provided, ^REBUILD$
is used.
When using the GitHub organization folders approach to creating multibranch pipeline jobs, the branch properties may not be edited according to design. Instead, use the functionality built into the GitHub Plugin with using the issueCommentTrigger in your pipeline script. This works in a similar way to this plugin. The main advantage of this plugin is that it may be used from the Job DSL plugin to create jobs with this branch property already added (in the case when you don't trust pipeline scripts, etc).
Use the instructions found in this wiki page.