Bitbucket

You can integrate your Bitbucket repository with Yandex Tracker to display links to commits in issues.

To add a commit link to an issue, specify the issue key in the commit comment, for example, Fixing error TEST-123. The link will appear in the issue's Commits tab. For more information, see Integration with repositories.

Integrating an online repository

To integrate your online repository on Bitbucket to Yandex Tracker:

1. Obtain an API token on Bitbucket to access your repository:

   • Log in to Bitbucket.
   • In the upper-right corner of the page, click the gear icon and select Atlassian account settings.
   • Open the Security tab, go to API tokens, and click Create and manage API tokens.
   • Click Create API token with scopes.
   • Specify the token name and expiry date.
   • Select Bitbucket as the app.
   • Configure permissions for the token. Enable the read:repository:bitbucket option for Yandex Tracker integration.
   • Check that you've entered everything correctly and click Create token.
   • Copy the token you just created.

   The token value is displayed only once — remember to save it. If you close the page, you will not be able to view it again.

2. Make sure you are authorized in Tracker as an administrator.

3. In Yandex Tracker, in the left-hand panel, click → Administration and then open Repositories.

4. Click Add and select Repository.

5. Choose Bitbucket in the Platform field.

6. Choose bitbucket.org for the Server address option.

7. In the Repository field, enter the address in this format: https://bitbucket.org/<repository_owner_login>/<repository_name>.

8. In the Login field, enter x-bitbucket-api-token-auth.

9. In the Password field, insert the token you obtained.

10. Click Add.

11. Make sure that the repository status in Yandex Tracker is Connected.

Integrating an on-premises repository

Before continuing, obtain a token to access the repository. For details on how to obtain an OAuth token, see the Bitbucket documentation.

To integrate an on-premises repository with Yandex Tracker:

1. Make sure you are authorized in Tracker as an administrator.

2. In Yandex Tracker, in the left-hand panel, click → Administration and then open Repositories.

3. Click Add and select Repository.

4. In the Platform field, select the type of your repository.

5. Choose Own for the Server address option.

6. In the Repository field, specify the URL of the repository on your server. Make sure that you connect to the server using the OAuth 2.0 technology.

7. In the Token from platform field, enter the token for connecting to your server.

8. Click Add.

9. Make sure that the repository status in Yandex Tracker is Connected.