---
metadata:
  - name: generator
    content: Diplodoc Platform v5.57.4
  - property: og:type
    content: article
  - property: article:section
    content: Интеграция с другими сервисами
  - property: og:title
    content: Bitbucket
  - property: article:tag
    content: Сборник инструкций
alternate:
  - https://yandex.ru/support/tracker/en/user/bitbucket.md
  - https://yandex.ru/support/tracker/ru/user/bitbucket.md
  - href: https://yandex.ru/support/tracker/ru/user/bitbucket.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.ru/support/tracker/ru/llms.txt
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/tracker/ru/llms.txt


# Bitbucket

В Трекере можно настроить интеграцию с репозиторием Bitbucket, чтобы отображать в задачах Трекера связи с коммитами в репозитории.

Чтобы добавить в задачу ссылку на коммит, укажите [ключ задачи](*issuekey) в комментарии к коммиту, например: `Исправление ошибки TEST-123`. Ссылка появится в задаче на вкладке **Коммиты**. Подробнее читайте в разделе [Интеграция с репозиториями](https://yandex.ru/support/tracker/ru/user/add-repository.md).

{% note warning "" %}

Для репозиториев Bitbucket доступна интеграция с Трекером только через периодический опрос репозитория.

Связи с коммитами могут отображаться в Трекере с задержкой до 10 часов.

{% endnote %}

## Подключить онлайн-репозиторий {#repo}

Чтобы подключить онлайн-репозиторий на платформе Bitbucket к Трекеру:

1. На платформе Bitbucket получите API-токен для доступа к вашему репозиторию:
    - Авторизуйтесь на [Bitbucket](https://bitbucket.org).
    - В правом верхнем углу страницы нажмите значок шестеренки и выберите **Atlassian account settings**.
    - На вкладке **Security** в разделе **API tokens** нажмите ссылку **Create and manage API tokens**.
    - Нажмите кнопку **Create API token with scopes**.
    - Введите имя токена и укажите срок действия.
    - Выберите приложение **Bitbucket**.
    - Настройте разрешения для токена. Для интеграции с Трекером обязательно включите опцию `read:repository:bitbucket`.
    - Проверьте введенные данные и нажмите **Create token**.
    - Скопируйте созданный токен.

    <!--- Нажмите на фото вашего профиля в левом нижнем углу и выберите **Bitbucket settings**.
    - Выберите **App passwords** в блоке **Access management**.
    - Нажмите **Create app password**.
    - Придумайте название для пароля, например `Tracker integration password`.
    - Настройте разрешения для пароля. Для правильной работы с Трекером необходимо, чтобы опция **read** в блоке **Repositories** была включена:
        ![](../_assets/bitbucket-password-settings.png)
    - Нажмите кнопку **Create**.
    - Скопируйте пароль в буфер обмена.-->

      {% note alert "" %}

      Значение токена отображается только один раз, сохраните его. Если закрыть страницу, вы больше не сможете его просмотреть.

      {% endnote %}

1. <!-- source: ru/_includes/make-sure-admin.md -->
   Убедитесь, что вы авторизованы в Трекере как [администратор](https://yandex.ru/support/tracker/ru/role-model.md).
   <!-- endsource: ru/_includes/make-sure-admin.md -->

1. <!-- source: ru/_includes/repository-path.md -->
   В Трекере на панели слева нажмите ![](../_assets/svg/actions.svg)</svg> → ![](../_assets/svg/admin.svg)</svg> **Администрирование**, затем откройте раздел ![](../_assets/svg/repositories.svg)</svg> **Репозитории**.
   <!-- endsource: ru/_includes/repository-path.md -->

1. Нажмите кнопку **Добавить** и выберите **Репозиторий**.

1. В поле **Платформа** выберите Bitbucket.

1. Для опции **Адрес сервера** выберите значение **bitbucket.org**.

1. В поле **Репозиторий** укажите адрес в формате `https://bitbucket.org/<логин_владельца_репозитория>/<имя_репозитория>`.

1. В поле **Логин** введите значение `x-bitbucket-api-token-auth`.

1. В поле **Пароль** вставьте полученный токен.

1. Нажмите кнопку **Добавить**.

1. Убедитесь, что статус репозитория отображается в Трекере как **Подключен**.

## Подключить репозиторий на собственном сервере {#on-premise}

Перед подключением получите токен для доступа к репозиторию. Подробную инструкцию о том, как получить OAuth-токен, читайте в [документации Bitbucket](https://support.atlassian.com/bitbucket-cloud/docs/use-oauth-on-bitbucket-cloud/).

<!-- source: ru/_includes/on-premise-server.md -->
Чтобы подключить к Трекеру репозиторий на собственном сервере:

1. <!-- source: ru/_includes/make-sure-admin.md -->
   Убедитесь, что вы авторизованы в Трекере как [администратор](https://yandex.ru/support/tracker/ru/role-model.md).
   <!-- endsource: ru/_includes/make-sure-admin.md -->

1. <!-- source: ru/_includes/repository-path.md -->
   В Трекере на панели слева нажмите ![](../_assets/svg/actions.svg)</svg> → ![](../_assets/svg/admin.svg)</svg> **Администрирование**, затем откройте раздел ![](../_assets/svg/repositories.svg)</svg> **Репозитории**.
   <!-- endsource: ru/_includes/repository-path.md -->

1. Нажмите кнопку **Добавить** и выберите **Репозиторий**.

1. В поле **Платформа** выберите тип вашего репозитория.

1. Для опции **Адрес сервера** выберите значение **Собственный**.

1. В поле **Репозиторий** укажите адрес репозитория на вашем сервере. Подключение к серверу должно осуществляться по технологии OAuth 2.0.

1. В поле **Токен с платформы** укажите токен для подключения к вашему серверу.

1. Нажмите кнопку **Добавить**.

1. Убедитесь, что статус репозиториев отображается в Трекере как **Подключен**.
<!-- endsource: ru/_includes/on-premise-server.md -->

<!-- source: ru/_assets/style/image.md -->

<!-- endsource: ru/_assets/style/image.md -->

[*issuekey]: Ключ задачи — это уникальный идентификатор, который содержится в ссылке на задачу. Он состоит из ключа очереди и номера, например `TEST-123`.