Connecting repositories

Restriction. Repositories can only be connected by your organization's administrator.

Connecting your repositories to Tracker lets you link commits to issues. You can link any number of repositories hosted on GitHub, GitLab, and Bitbucket.

Restriction. Git repositories hosted on your own private server can't be linked to Tracker.

GitHub

Follow these steps to link a GitHub repository to Tracker:

  1. Make sure that you are logged in as the organization administrator in Yandex.Connect.

  2. Choose  → Tracker settings on the upper panel.

  3. Open the Repositories tab and click Enable repository.

  4. Choose GitHub in the Platform field.

  5. Enter the public repository's address using the format https://github.com/<repository owner login>/<repository name>. Leave the Token field blank.

  6. Click Activate.

  7. Make sure your repository's status in Tracker says Connected.

To link a commit to an issue in Tracker, specify the issue key in the comments for the commit. You can view linked commits the following ways:

  • On the Commits tab on the issue page.
  • On the Commits tab on the queue page.

If you don't see the Commits tab, make sure it's enabled in your queue settings.

GitLab

Follow these steps to link a GitLab repository to Tracker:

  1. Make sure that you are logged in as the organization administrator in Yandex.Connect.

  2. Choose  → Tracker settings on the upper panel.

  3. Open the Repositories tab and click Enable repository.

  4. Choose GitLab in the Platform field.

  5. Enter the public repository address using the format https://gitlab.com/<repository owner login>/<repository name>. Leave the Token field blank.

  6. Click Activate.

  7. Make sure your repository's status in Tracker says Connected.

To link a commit to an issue in Tracker, specify the issue key in the comments for the commit. You can view linked commits the following ways:

  • On the Commits tab on the issue page.
  • On the Commits tab on the queue page.

If you don't see the Commits tab, make sure it's enabled in your queue settings.

Bitbucket

Follow these steps to link a Bitbucket repository to Tracker:

  1. Make sure that you are logged in as the organization administrator in Yandex.Connect.

  2. Choose  → Tracker settings on the upper panel.

  3. Open the Repositories tab and click Enable repository.

  4. Choose Bitbucket in the Platform field.

  5. Create a Tracker password in Bitbucket. Tracker will use this password to connect to your repositories.

    • Log in to Bitbucket.

    • Click your photo in the bottom left corner and choose Bitbucket settings.

    • Choose App passwords in the Access management block.

    • Click Create app password.

    • Think of a name for your password (e.g. Tracker integration password).

    • Set access rights for your password. To operate Tracker correctly, enable the read option in the Repositories block:

    • Click Create.

    • Copy the password to clipboard.
      Attention. Your password will only be displayed once. You won't be able to see it again after closing the page.
  6. Enter the repository's address using the format https://bitbucket.org/<repository owner's login/repository name and specify your Bitbucket login.

  7. Enter the password you used when linking Tracker to Bitbucket. You cannot use your personal Bitbucket password.

  8. Click Activate.

  9. Make sure your repository's status in Tracker says Connected.

To link a commit to an issue in Tracker, specify the issue key in the comments for the commit. You can view linked commits the following ways:

  • On the Commits tab on the issue page.
  • On the Commits tab on the queue page.

If you don't see the Commits tab, make sure it's enabled in your queue settings.