Перемещение проекта Orbit

Проект можно переместить в другой аккаунт Kapsule без повторного развертывания и перестройки конфигурации. Перемещение проверяется по электронной почте, может быть отменено только путём обратной передачи и переносит всё с собой: окружения, развертывания, переменные окружения, вебхуки и параметры.

Когда Нужна Передача Проекта

• Агентство передаёт готовый сайт клиенту, который будет владеть им с этого момента.
• Проект переходит из личного аккаунта в корпоративный.
• Команда разделяется, и проект уходит к людям, которые его поддерживают.

Передача, это не то же самое, что добавление сотрудника. Если вы хотите, чтобы кто-то работал над проектом, пока он остаётся у вас, добавьте его в команду проекта: см. Параметры Проекта Orbit.

Начало Передачи

Откройте Orbit, щёлкните на проект, выберите Settings (Параметры) и найдите Transfer project (Передать проект) в разделе Danger zone (Опасная зона). На карточке описано, что происходит: проект переходит в другой аккаунт Kapsule, получатель получает письмо с подтверждением, и все данные передаются вместе с проектом.

1. Введите адрес электронной почты владельца принимающего аккаунта.
2. Щёлкните Initiate transfer (Начать передачу).

На карточке появится подтверждение Transfer email sent (Письмо отправлено) и затем Transfer pending (Передача ожидает), с указанием того, кого ожидается и когда ссылка истечёт.

Одна Ожидающая Передача за Раз

Начало новой передачи заменяет любую передачу, уже ожидающую для этого проекта. Предыдущая ссылка перестаёт работать сразу же, это также самый быстрый способ исправить опечатку в адресе: просто начните заново с правильным адресом.

Что Видит Получатель

Получатель получит письмо со ссылкой подтверждения. При её открытии отображается страница подтверждения с заголовком Accept project transfer (Принять передачу проекта), с указанием отправляющего аккаунта, проекта и его slug, а также адреса электронной почты, на который была отправлена передача.

Ниже на странице ясно указана область: все окружения, развертывания, переменные окружения, вебхуки и параметры будут передачи, и когда истечёт срок действия ссылки.

После нажатия кнопки Accept transfer (Принять передачу) перемещение завершается. На странице появляется текст Transfer complete (Передача завершена) и осуществляется переход в проект, который теперь находится в их аккаунте.

Получатель Должен Быть Авторизован под Этим Адресом

При принятии проверяется адрес электронной почты авторизованного пользователя по сравнению с адресом, на который была отправлена передача. Если они не совпадают, запрос отклоняется с сообщением об адресе и предложением авторизоваться под этим аккаунтом.

Это свойство безопасности, которое делает всё это защищённым: знание ссылки недостаточно. Вы должны быть тем, кому она была адресована.

Если у получателя ещё нет аккаунта Kapsule, ему нужно создать его с точно таким же адресом, а затем снова открыть ссылку.

48-Часовое Окно

Ссылка передачи истекает через 48 часов после её создания. После этого на странице принятия показывается, что передача больше не действительна, и указывается причина: истекла.

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

Если передача истекла, начните новую. Способа продлить существующую ссылку нет.

Отмена Ожидающей Передачи

Пока передача ожидается, карточка предоставляет опцию Cancel (Отменить). Отмена делает ссылку неработающей сразу же, поэтому на странице принятия она будет отклонена, даже если получатель имеет письмо перед собой.

Отменяйте как только поймёте, что передача пошла на неправильный адрес. Не полагайтесь на 48-часовой срок действия.

Что Передаётся, а Что Нет

Всё, что прикреплено к проекту, передаётся вместе с ним:

• Каждое окружение, включая staging и previews.
• Полная история развертывания.
• Переменные окружения, включая секреты.
• Вебхуки, задачи cron, edge-функции и параметры.
• Пользовательские домены, прикреплённые к проекту.

Две вещи, о которых стоит подумать отдельно:

• Регистрация домена. Если проект использует пользовательский домен, зарегистрированный в вашем аккаунте Kapsule, домен не передаётся вместе с проектом. Передайте или переведите домен как отдельный шаг: см. Передача Домена.
• Подключение репозитория. Проект продолжает указывать на тот же репозиторий. Получающему аккаунту нужен свой собственный доступ к этому репозиторию, чтобы будущие развертывания работали, поэтому планируйте передачу репозитория одновременно.

После Передачи

Со стороны отправителя проект просто исчезает из списка Orbit. Нет архивной копии, и отмена означает попросить нового владельца передать его обратно.

Со стороны получателя проект появляется в его списке Orbit, всё ещё развёрнут и продолжает обслуживать трафик. Ничего не нужно повторно развёртывать.

Первое, что должен сделать новый владелец, это проверить использование проекта по сравнению со своим планом. Минуты сборки и квоты пропускной способности рассчитываются на уровне аккаунта, поэтому занятой проект меняет цифры с обеих сторон: см. Лимиты Плана Orbit.

Передача через API

Передачи также можно инициировать программно: инициирование, отмена и проверка статуса доступны как эндпоинты, задокументированные в справке API в панели. См. Токены API Orbit и REST API. Действуют те же правила, включая инициирование только владельцами и проверку по электронной почте.

Решение Проблем

Поле передачи недоступно. Вы не владелец аккаунта.

Получатель говорит, что ссылка не работает. Проверьте три вещи: истекла ли она, была ли отменена или заменена более новой передачей, и авторизован ли он под точным адресом, на который она была отправлена.

У получателя нет аккаунта Kapsule. Ему нужно зарегистрироваться с адресом, на который была отправлена передача, а затем снова открыть ссылку.

Развертывания проекта прекратились после передачи. Новый аккаунт не имеет доступа к репозиторию. Переподключите его: см. Подключение Репозитория GitHub.

Пользовательский домен перестал разрешаться. Домен всё ещё в старом аккаунте. Переведите или передайте его.

Куда Дальше

• Параметры Проекта Orbit для сотрудников, архивирования и остальной части опасной зоны.
• Переменные Окружения в Orbit для того, что нужно обновить перед передачей.
• Лимиты Плана Orbit для квот получающего аккаунта.