Подключение репозитория Bitbucket

Bitbucket connects to Orbit through OAuth: you authorise Kapsule once, Orbit lists the repositories your Bitbucket account can reach, and it registers a webhook per repository so every push triggers…

Bitbucket подключается к Orbit через OAuth: вы один раз авторизуете Kapsule, Orbit выводит список доступных вашему аккаунту Bitbucket репозиториев и регистрирует webhook для каждого репозитория, чтобы каждый push запускал сборку. В этом руководстве рассмотрены подключение, выбор репозитория, создание проекта и проверка, если репозиторий не появляется.

Перед началом

Orbit видит только то, что видит ваш аккаунт Bitbucket. Для репозитория в workspace нужен минимум доступ на запись и достаточно прав для создания webhook репозитория. Если workspace ограничивает сторонних потребителей OAuth, администратор должен разрешить Kapsule Orbit перед успешным подключением.

Шаг 1: подключение Bitbucket

В KPanel нажмите Orbit на левой боковой панели.
Нажмите New project (Новый проект).
Оставьте режим установленным на Import Git Repo (Импорт репозитория Git).
На шаге 1 нажмите Connect Bitbucket (Подключить Bitbucket).

Вас отправляют на Bitbucket для авторизации OAuth-потребителя Kapsule Orbit. Предоставьте запрашиваемые разрешения и Bitbucket вернёт вас в KPanel с загруженными репозиториями. На шаге 1 появится надпись Just connected (Только что подключено).

Если авторизация не удалась, KPanel показывает ошибку, возвращённую Bitbucket. Прочитайте её вместо слепого повтора попыток: блокировка политики workspace и отменённая авторизация выглядят похоже, но требуют разных решений.

Шаг 2: выбор репозитория

Доступные вам репозитории отображаются в виде списка. Нажмите Select (Выбрать) рядом с тем, который вы хотите развернуть. Приватные репозитории несут значок Private (Приватный); Orbit развёртывает как открытые, так и приватные репозитории.

Если репозиторий отсутствует

Проверьте ваш уровень доступа к репозиторию. Доступ только на чтение недостаточен; нужен доступ на запись, чтобы Orbit мог зарегистрировать необходимый ему webhook.
Убедитесь, что репозиторий находится в workspace, к которому вы действительно принадлежите, а не в том, на который у вас просто есть ссылка.
Нажмите Reconnect Bitbucket (Переподключить Bitbucket) на шаге 1, чтобы повторить процесс OAuth и обновить токен и список репозиториев.

Если панель показывает No repos accessible (Доступных репозиториев нет), разрешение успешно выдано, но ничего не возвращено. Переподключитесь и убедитесь, что вы одобрили области репозитория.

Шаг 3: настройка проекта

Поле	Что оно делает
Project Name (Название проекта)	Отображаемое имя в KPanel, например `my-app`
Deploy URL (URL развёртывания)	Поддомен под `kaps.run`, так что `my-app` становится `my-app.kaps.run`

Нажмите Create project (Создать проект). Orbit клонирует репозиторий, поставит в очередь первую сборку и откроет вам страницу обзора проекта с потоком логов.

Slug URL развёртывания устанавливается один раз при создании и не может быть отредактирован позже. Чтобы обслуживать под другим адресом, подключите пользовательский домен. См. Добавление пользовательского домена к проекту.

Автоматические развёртывания

Orbit регистрирует webhook на вашем репозитории Bitbucket при создании проекта. После этого:

Push в ветку production ставит в очередь развёртывание production.
Push в любую другую ветку создаёт изолированный предпросмотр на branch-<branch-name>.kaps.run, если Branch previews (Предпросмотры веток) включены в Settings (Параметры) в разделе Runtime (Среда выполнения). См. Развёртывания предпросмотра веток в Orbit.
Удаление ветки приостанавливает её среду предпросмотра, и хранилище освобождается примерно за день.

Вы никогда не создаёте и не обслуживаете webhook самостоятельно.

Параметр CI required checks (Требуемые проверки CI) в Orbit блокирует развёртывания на основе имён заданий GitHub Actions или конвейера GitLab. Он не блокирует на основе Bitbucket Pipelines. Если вам нужно, чтобы Bitbucket Pipelines решал, когда происходит развёртывание, отключите развёртывания, инициируемые push, для этой ветки и вместо этого вызовите hook развёртывания из конвейера при успехе. См. Инициирование развёртываний через хуки развёртывания.

Переподключение или отключение Bitbucket

Нажмите Orbit, затем New project (Новый проект).
На шаге 1 нажмите Reconnect (Переподключить), чтобы повторить процесс OAuth, или Disconnect (Отключить), чтобы удалить ссылку.

Переподключение, это правильный первый шаг, когда список репозиториев перестаёт работать, потому что OAuth-токены истекают, а переподключение создаёт новый.

Отключение сохраняет ваши проекты и их историю развёртывания, и живое развёртывание продолжает обслуживать трафик. Развёртывания, инициируемые push, прекращаются. Хуки развёртывания тоже прекращаются, потому что hook читает head ветки через подключение поставщика, чтобы решить, что строить.

Дополнительные материалы

Развёртывание вашего проекта для полного цикла развёртывания, блокировок развёртывания и утверждений
Настройка команды сборки и каталога выходных данных, если первая сборка не удалась или опубликовала неправильную папку
Подключение репозитория GitHub и Подключение репозитория GitLab для других поставщиков