Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Event filters

By default, Webhook To Jenkins for Bitbucket notifies Jenkins on all git on git reference changes, pull requests creations, and re-openings. If users would like to limit which of these events trigger Jenkins, they can do the following.

Go to Advanced Configuration > Limit Events and select which events you'd like to disable. Each event thats disabled will be highlighted in red.

Image Removed

Here's an explanation of each event:

reopenings. The Limit Events feature allows you to select which events can trigger Jenkins.

To limit which events trigger Jenkins:

  1. From your Bitbucket repository, click the Repository Settings icon > Hooks and select Enabled or click the Edit icon to change the previously enabled Webhook to Jenkins configuration.

  2. Click the Advanced Configuration tab and from the Limit Events options, select each event you want to enable. Each enabled event has a checkmark beside it.

...

Event

Description

Pull Request Opened

Is fired

Triggers whenever a pull request is opened.

Pull Request

ReOpened

Reopened

Is fired

Triggers whenever a declined pull request is re-opened again.

Pull Request Approved

Triggers each time when reviewer(s) approves pull request and disabled by default.

Pull Request Merged

Is fired

Triggers after a pull request is merged.

Open Pull Request Refs Changed

Is fired

Triggers when a change

happens

occurs to any git reference

which is

, a base branch of at least one active Pull Request. This includes commits, pushes, edits, branch creations, and more.

Note, we filter out all

All reference deleted events

. Doesn't fire

are filtered out. Does not trigger when refs are modified in the forked repository in the back-merge Pull Request.

Non-Pull Request Refs Changed

The same as previous

Similar to Open Pull Request Refs, but

triggered

triggers for changes in references

which

that do not participate in any active Pull Request.

You can also hover on the event name on the configuration dialog to get a quick in-place event description.

Additional filters

Filter

Description

Trigger job if the branch is deleted

Trigger build on branch deletion. Useful for cleanup with multi-branch pipeline jobs.

Trigger Pull Request only if mergeable

An additional filter that can be used together with event filters.
When enabled, all configured Merge Checks are respected (incl. 3rd-party ones) so that only mergeable PRs are triggered when updated.