YouTrack Standalone 2017.1 Help

Bitbucket Integration

You can integrate a project in YouTrack with a Bitbucket repository. A Bitbucket integration enables the following features in YouTrack:

Prerequisites

  • Your YouTrack server must be accessible from the Internet.
  • A committer's email address in YouTrack must be the same as in Bitbucket. YouTrack searches for a user account based on the email address that is registered in Bitbucket. These users must also have permission to update issues in the connected YouTrack project. If no match is found or the user does not have the required permission, the commands are not applied.
  • You are able to access the Bitbucket server with an email address and password. The YouTrack integration with Bitbucket does not support two-step verification.

Configure the Bitbucket Integration

When you enable and configure the Bitbucket integration, you define mappings between a YouTrack project and a Bitbucket repository.

As an administrator, you can enable the Bitbucket integration for any project in YouTrack.

To enable the Bitbucket integration:

  1. Open the Administration > VCS Integrations page.
  2. Click the New VCS Integration button.
    • The New VCS Integration dialog opens in the sidebar.
      /help/img/youtrack/2017.1/ytVCSGitHubAdd_thumbnail.png
  3. From the Server drop-down list, select bitbucket.org.
  4. Enter the login and password for the Bitbucket account.
  5. If you are not the repository owner, provide the repository owner name. If you are the owner of the repository, leave the field blank.
  6. Click the Connect to VCS server button.
    • The New VCS Integration dialog displays settings for mapping the VCS to your project.
      /help/img/youtrack/2017.1/ghIntegrationSettings_thumbnail.png
  7. Enter values for the following settings:
    SettingDescription
    YouTrack ProjectSelect the YouTrack project that you use to track changes to the code repository.
    RepositorySelect the repository where you store the source code that is related to the selected project.
    CommittersSelect the group that contains all of the users who can commit changes to the selected repository.
    Monitor BranchesEnter the names of the branches that you want to monitor for changes. Use the plus sign to include a branch and the minus sign to exclude a branch.
    Visible for GroupsSelect one or mor groups to restrict the visibility of comments and updates on the VCS Changes tab. Otherwise, the list of changes that are displayed on this tab is visible to any user who has permission to read issues in the project.
  8. Click the Save button.
    • The Bitbucket repository is associated with the selected YouTrack project.
      /help/img/youtrack/2017.1/NewBitbucketIntCreated_thumbnail.png
    • Commits from the Bitbucket repository that mention an issue in the project are displayed in the VCS Changes tab of the mentioned issue.

See Also

Last modified: 18 April 2017