Pull Request Notifier for Bitbucket

The original use case was to trigger Jenkins jobs to build pull requests that are created in Bitbucket. The plugin can be configured to trigger different Jenkins jobs for different repositories. It can supply custom parameters to the jenkins job using the variables. It can authenticate with HTTP Basic.

It can, for example, trigger a build in Jenkins. Parameterized Jenkins jobs can be triggered remotely via:

http://server/job/theJob/buildWithParameters?token=TOKEN&PARAMETER=Value

The plugin can trigger any system, not only Jenkins. The plugin can notify any system that can be notified with a URL.

Here is a screenshot of the admin GUI.

Here is a blog post that includes the plugin.

Available in Atlassian Marketplace.

Features

The Pull Request Notifier for Bitbucket can:

Invoke any URL, or set of URL:s, when a pull request event happens.
With variables available to add necessary parameters.
HTTP POST, PUT, GET and DELETE. POST and PUT also supports rendered post content.
Be configured to trigger on any pull request event. Including extended events:
RESCOPED_FROM, when source branch change
RESCOPED_TO, when target branch change
BUTTON_TRIGGER, when trigger button in pull request view is pressed
Can invoke CSRF protected systems, using the ${INJECTION_URL_VALUE} variable. How to to that with Jenkins is described below.
Be configured to only trigger if the pull request mathches a filter. A filter text is constructed with any combination of the variables and then a regexp is constructed to match that text.
Add buttons to pull request view in Bitbucket. And map those buttons to URL invocations. This can be done by setting the filter string to ${BUTTON_TRIGGER_TITLE} and the filter regexp to title of button.
Authenticate with HTTP basic authentication.
Optionally allow any SSL certificate.
Use custom SSL key store, type and password.
Send custom HTTP headers
Can optionally use proxy to connect
Can let users and/or admins do configuration. Or restrict configuration to just system admins. A user will have to browse to the configuration page at http://domain/bitbucket/plugins/servlet/prnfb/admin.
Can enable trigger
If PR has, or has no, conflicts
Only if PR has conflicts
Only if PR has no conflicts
Nice configuration GUI.
Global at /bitbucket/plugins/servlet/prnfb/admin
Repo level at /bitbucket/plugins/servlet/prnfb/admin/PROJECT_1/rep_1

The plugin has its own implementation to create the RESCOPED_FROM and RESCOPED_TO events. RESCOPED is transformed to RESCOPED_TO if target branch changed, RESCOPED_FROM if source branch, or both, changed.

The filter text as well as the URL support variables. These are:

${EVERYTHING_URL} Example: PULL_REQUEST_ID=1&PULL_REQUEST_TITLE=some%20thing...
${PULL_REQUEST_ID} Example: 1
${PULL_REQUEST_TITLE} Example: Anything
${PULL_REQUEST_VERSION} Example: 1
${PULL_REQUEST_COMMENT_TEXT} Example: A comment
${PULL_REQUEST_ACTION} Example: OPENED
${BUTTON_TRIGGER_TITLE} Example: Trigger Notification
${INJECTION_URL_VALUE} Value retrieved from any URL
${PULL_REQUEST_URL} Example: http://localhost:7990/projects/PROJECT_1/repos/rep_1/pull-requests/1
${PULL_REQUEST_USER_DISPLAY_NAME} Example: Some User
${PULL_REQUEST_USER_EMAIL_ADDRESS} Example: [email protected]
${PULL_REQUEST_USER_ID} Example: 1
${PULL_REQUEST_USER_NAME} Example: user.name
${PULL_REQUEST_USER_SLUG} Example: user.name
${PULL_REQUEST_AUTHOR_DISPLAY_NAME} Example: Administrator
${PULL_REQUEST_AUTHOR_EMAIL} Example: [email protected]
${PULL_REQUEST_AUTHOR_ID} Example: 1
${PULL_REQUEST_AUTHOR_NAME} Example: admin
${PULL_REQUEST_AUTHOR_SLUG} Example: admin
${PULL_REQUEST_REVIEWERS} Example: Administrator,User
${PULL_REQUEST_REVIEWERS_ID} Example: 1,2
${PULL_REQUEST_REVIEWERS_SLUG} Example: admin,user
${PULL_REQUEST_REVIEWERS_APPROVED_COUNT} Number of reviewers that approved the PR.
${PULL_REQUEST_PARTICIPANTS_APPROVED_COUNT} Number of participants that approved the PR.
${PULL_REQUEST_MERGE_COMMIT} Hash of merged commit (only available for merged-event).
${PULL_REQUEST_FROM_SSH_CLONE_URL} Example: ssh://git@localhost:7999/project_1/rep_1
${PULL_REQUEST_FROM_HTTP_CLONE_URL} Example: http://admin@localhost:7990/bitbucket/scm/project_1/rep_1.git
${PULL_REQUEST_FROM_HASH} Example: 6053a1eaa1c009dd11092d09a72f3c41af1b59ad
${PULL_REQUEST_FROM_ID} Example: refs/heads/branchmodmerge
${PULL_REQUEST_FROM_BRANCH} Example: branchmodmerge
${PULL_REQUEST_FROM_REPO_ID} Example: 1
${PULL_REQUEST_FROM_REPO_NAME} Example: rep_1
${PULL_REQUEST_FROM_REPO_PROJECT_ID} Example: 1
${PULL_REQUEST_FROM_REPO_PROJECT_KEY} Example: PROJECT_1
${PULL_REQUEST_FROM_REPO_SLUG} Example: rep_1
${PULL_REQUEST_TO_SSH_CLONE_URL} Example: ssh://git@localhost:7999/project_1/rep_1
${PULL_REQUEST_TO_HTTP_CLONE_URL} Example: http://admin@localhost:7990/bitbucket/scm/project_1/rep_1.git
${PULL_REQUEST_TO_HASH} Example: 6053a1eaa1c009dd11092d09a72f3c41af1b59ad
${PULL_REQUEST_TO_ID} Example: refs/heads/branchmodmerge
${PULL_REQUEST_TO_BRANCH} Example: branchmodmerge
${PULL_REQUEST_TO_REPO_ID} Example: 1
${PULL_REQUEST_TO_REPO_NAME} Example: rep_1
${PULL_REQUEST_TO_REPO_PROJECT_ID} Example: 1
${PULL_REQUEST_TO_REPO_PROJECT_KEY} Example: PROJECT_1
${PULL_REQUEST_TO_REPO_SLUG} Example: rep_1

The ${PULL_REQUEST_USER...} contains information about the user who issued the event. Who commented it, who rejected it, who approved it...

You may want to use Violation Comments to Stash plugin and/or StashNotifier plugin to report results back to Bitbucket.

Rest

Some rest resources are available. You can figure out the JSON structure by looking at the DTO:s.

/bitbucket/rest/prnfb-admin/1.0/settings
GET Get all global settings.
POST Store all global settings.
/bitbucket/rest/prnfb-admin/1.0/settings/notifications
DELETE /{uuid} Deletes notification with uuid.
GET Get all notifications.
GET /{uuid} Get notification with uuid.
GET /projectKey/{projectKey} Get all notifications for the project.
GET /projectKey/{projectKey}/repositorySlug/{repositorySlug} Get all notifications for the project and repository.
POST Save a notification.
/bitbucket/rest/prnfb-admin/1.0/settings/buttons
DELETE /{uuid} Deletes button with uuid.
GET Get all buttons that the current user is allowed to use.
GET /{uuid} Get button with uuid.
GET /repository/{repositoryId}/pullrequest/{pullRequestId} Get all buttons for repository that the current user is allowed to use.
GET /projectKey/{projectKey} Get all buttons for the project.
GET /projectKey/{projectKey}/repositorySlug/{repositorySlug} Get all buttons for the project and repository.
POST Save a button.
POST {uuid}/press/repository/{repositoryId}/pullrequest/{pullRequestId} Press the button.

Jenkins

Parameterized Jenkins jobs can be triggered remotely via:

http://server/job/theJob/buildWithParameters?token=TOKEN&PARAMETER=Value

If you are using a CSRF protection in Jenkins, you can use the Injection URL feature.

Set Injection URL field to http://JENKINS/crumbIssuer/api/xml?xpath=//crumb/text(). You may get an error like primitive XPath result sets forbidden; implement jenkins.security.SecureRequester. If so, you can set Injection URL to http://JENKINS/crumbIssuer/api/xml?xpath=//crumb in combination with regular expression <crumb>([^<]*)</crumb>. Or a third option is to checkout this Jenkins plugin.
In the headers section, set header .crumb with value ${INJECTION_URL_VALUE}.

Developer instructions

Prerequisites:

Atlas SDK (installation instructions).
JDK 1.8 or newer

Generate Eclipse project:

atlas-compile eclipse:eclipse

Package the plugin:

atlas-package

Run Bitbucket, with the plugin, on localhost:

export MAVEN_OPTS=-Dplugin.resource.directories=`pwd`/src/main/resources
mvn bitbucket:run

You can also remote debug on port 5005 with:

atlas-debug

Make a release (detailed instructions):

mvn release:prepare
mvn release:perform

sanzinger / pull-request-notifier-for-bitbucket Goto Github PK