Documentation

Owned by Daniel Puiu
Last updated: Jan 08, 2023
2 min read

Promotion

75% discount up until June 1st, 2023 https://promo.atlassian.com/JFCHRA

What is this site?

This site contains the documentation for Merge cross pull requests plugin.

What does the plugin do?

It helps merging in one click all cross repository pull requests that related by Jira issue.

How does the plugin work?

It requires Jira integration in order to detect cross repository development.

It contains 1 merge check and 2 post hooks:

  • when a pull request is created, a post hook will detect the rest of the related work and create pull requests for each of them.

  • a merge check blocks the merge of the pull requests until all of them are ready to be merged.

  • once one of the cross pull request is merged, a post hook will automatically merge the rest of the related pull requests.

How to set up the plugin?

Make sure that Jira is integrated with the Bitbucket Server instance. If not, please take all the necessary steps to integrate it. Here is how to do it. This step requires (global) system admin permission.

 

The following steps require project admin permission.

To enable the merge check, please follow the steps below for all desired Bitbucket Server's projects:

  1. Go to project's settings

  2. Select Merge checks

  3. Enable the merge check named All cross repository pull requests can be merged

To enable the post hooks, please follow the steps below for all desired Bitbucket Server's projects:

  1. Go to project's settings

  2. Select Hooks

  3. Enable the hook named Create cross repository pull requests

    1. Optional: a http access token can be passed to the hook in order for the plugin to be able to add the default reviewers for each created pull requests (HTTP access tokens Documentation).

  4. Enable the hook named Merge cross repository pull requests

Simple test scenario

  1. Set up the plugin for a Bitbucket Server project as described above

  2. Create at least 2 pull requests using the same Jira id (here is how to link work to Jira issues)

  3. Make sure one of pull requests cannot be merged in order to check that none of the pull requests can be merged

  4. Observe that none of the pull requests can be merged

  5. Resolve all issues and have all pull requests ready to be merged

  6. Merge any of the pull requests

  7. Observe that the rest of the pull requests have been merged by the post hook

Evaluation license

Evaluation license cannot be renewed.

Evaluation license can be requested by users that are registered on the Bitbucket server.

Support?

For technical support and general questions about the plugin, please send email directly to: daanipuui@gmail.com.