Documentation

What is this site?

This site contains our documentation and our project bug tracker.

What does the plugin do?

The plugin helps merging related (by Jira issue) cross repository pull requests at the same time. It requires Jira integration in order to detect cross repository development.

The merge check blocks the merge until all related pull requests are ready to be merged.

Once one of the pull requests is merged, the post hook will automatically merge the rest of the related pull requests.

How do I set it up?

Make sure that Jira is integrated with your 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 merge check and post hook must be both enabled at project level for all needed projects. These 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 Checks that all related (cross repository) pull requests are mergeable at the same time

 

To enable the post hook, 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 Post receive hook to merge all related (cross repository) pull requests

Simple test scenario

  1. Enable both the merge check and post hook 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

Support?

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