First, you will need to make sure that the Bitbucket is connected to your Jira instance via the application links. If you have not done this yet, please read the Setting up Bitbucket for git inregration article.
Next, set up the git integration by following the steps below. If you have an existing Jira project that already uses Behave Pro and you want to migrate to git integration, please read the Migrating classic Behave Pro project to git integration article instead.
Setting up for a new Jira project
To set up the git integration access the project settings of your Jira project. Then navigate to the Behave Pro configuration page by clicking on the Behave Pro button on the left navigation menu as seen in the image below.
Next, you will be shown the welcome page. Click "Get Started" at the bottom to continue.
You rill be asked to choose your desired workflow. For the purpose of this tutorial, choose the "git" by clicking on the right button.
Next, you will need to select the correct the correct Bitbucket project from the top dropdown. If your Bitbucket instance is not shown in the list, please make sure you have followed all of the necessary steps in the Setting up Bitbucket for git inregration article. If your Bitbucket project is not listed here, make sure you as the user are able to access the project in your Bitbucket instance. The Bitbucket groups repositories together on a per project basis, similarly as GitHub which groups repositories together based on an organisation.
Once you have selected your Bitbucket project, select the repository from the dropdown below.
To continue, you will need to select the preferred branching strategy. The options are the following:
- Trunk based - All of your feature files will be stored in a single branch of your choice.
- Feature branching - Each new feature or scenario added in a Jira issue will create a new branch with the Jira issue summary as the branch name. The specification page will only show the features from the branch of your choice, not from the issue branch.
Finally, select your branch and the path where you wish your feature files will be stored in. If the list of branches is empty, this means your repository is empty. Please initialize the repository with the branch you wan to select. Additionally, the path you will choose to store the feature files in must exist.
You can leave the feature file directory empty. In this case, the feature files will be stored in the root folder of your repository. Forward slash at the beginning or end of the directory path is purely optional and has no effect. Backward Windows-like slashes are not allowed.
After clicking "Finish" your settings will be saved and you will be redirected back to the Behave Pro settings page as shown below. You can now start using Behave Pro for Jira.