Bitbucket
В Трекере можно настроить интеграцию с репозиторием Bitbucket, чтобы отображать в задачах Трекера связи с коммитами в репозитории.
Чтобы добавить в задачу ссылку на коммит, укажите ключ задачи в комментарии к коммиту, например: Исправление ошибки TEST-123. Ссылка появится в задаче на вкладке Коммиты. Подробнее читайте в разделе Интеграция с репозиториями.
Для репозиториев Bitbucket доступна интеграция с Трекером только через периодический опрос репозитория.
Связи с коммитами могут отображаться в Трекере с задержкой до 10 часов.
Подключить онлайн-репозиторий
Чтобы подключить онлайн-репозиторий на платформе Bitbucket к Трекеру:
-
На платформе Bitbucket получите API-токен для доступа к вашему репозиторию:
- Авторизуйтесь на Bitbucket.
- В правом верхнем углу страницы нажмите значок шестеренки и выберите Atlassian account settings.
- На вкладке Security в разделе API tokens нажмите ссылку Create and manage API tokens.
- Нажмите кнопку Create API token with scopes.
- Введите имя токена и укажите срок действия.
- Выберите приложение Bitbucket.
- Настройте разрешения для токена. Для интеграции с Трекером обязательно включите опцию
read:repository:bitbucket. - Проверьте введенные данные и нажмите Create token.
- Скопируйте созданный токен.
Значение токена отображается только один раз, сохраните его. Если закрыть страницу, вы больше не сможете его просмотреть.
-
Убедитесь, что вы авторизованы в Трекере как администратор.
-
В Трекере на панели слева нажмите → Администрирование, затем откройте раздел Репозитории.
-
Нажмите кнопку Добавить и выберите Репозиторий.
-
В поле Платформа выберите Bitbucket.
-
Для опции Адрес сервера выберите значение bitbucket.org.
-
В поле Репозиторий укажите адрес в формате
https://bitbucket.org/<логин_владельца_репозитория>/<имя_репозитория>. -
В поле Логин введите значение
x-bitbucket-api-token-auth. -
В поле Пароль вставьте полученный токен.
-
Нажмите кнопку Добавить.
-
Убедитесь, что статус репозитория отображается в Трекере как Подключен.
Подключить репозиторий на собственном сервере
Перед подключением получите токен для доступа к репозиторию. Подробную инструкцию о том, как получить OAuth-токен, читайте в документации Bitbucket.
Чтобы подключить к Трекеру репозиторий на собственном сервере:
-
Убедитесь, что вы авторизованы в Трекере как администратор.
-
В Трекере на панели слева нажмите → Администрирование, затем откройте раздел Репозитории.
-
Нажмите кнопку Добавить и выберите Репозиторий.
-
В поле Платформа выберите тип вашего репозитория.
-
Для опции Адрес сервера выберите значение Собственный.
-
В поле Репозиторий укажите адрес репозитория на вашем сервере. Подключение к серверу должно осуществляться по технологии OAuth 2.0.
-
В поле Токен с платформы укажите токен для подключения к вашему серверу.
-
Нажмите кнопку Добавить.
-
Убедитесь, что статус репозиториев отображается в Трекере как Подключен.
Ключ задачи — это уникальный идентификатор задачи. Он состоит из ключа очереди и порядкового номера, например: TEST-123. С помощью ключа можно перейти к задаче по ссылке: https://tracker.yandex.ru/TEST-123.