Подключите свою учетную запись Bitbucket, чтобы ваши сайты развертывались из репозитория

Что дает подключение

Подключение Bitbucket позволяет развертывать сайт из одного из ваших репозиториев Bitbucket Cloud: отправьте изменения в ветку, и сайт обновится.

Перед началом работы

Учетная запись Bitbucket Cloud с доступом к репозиториям, которые необходимо развернуть.

1. Создайте ключ в Bitbucket

Bitbucket предлагает два типа учетных данных, и любой из них подойдет:

• Токен доступа для репозитория, проекта или рабочей области, созданный в настройках соответствующего репозитория, проекта или рабочей области в разделе Access tokens. Он привязан к этому репозиторию, проекту или рабочей области, а не к конкретному человеку. Предоставьте ему права на чтение репозиториев.
• API-токен в вашей учетной записи Atlassian. Выберите свой профиль, затем Account settings → Security → Create and manage API tokens → Create API token with scopes. Задайте ему имя, укажите срок действия, выберите Bitbucket в качестве приложения и предоставьте права на чтение репозиториев. Bitbucket показывает токен только один раз; скопируйте его сразу.

2. Подключите его здесь

Откройте раздел Integrations в панели управления и выберите Connect an account. Выберите Code hosting в качестве группы и Bitbucket в качестве учетной записи, заполните поле API token — а также поле Account username, если вы создали токен в своей учетной записи Atlassian, а не токен доступа, и нажмите Connect account.

Мы проверяем то, что вы вставляете, до того, как что-либо будет сохранено. Неработающий ключ никогда не сохраняется, а в ответе указывается, что именно было не так. Работающий ключ хранится в зашифрованном виде в нашем хранилище секретов (но не в нашей базе данных) и больше никогда не показывается — даже вам.

Имя пользователя определяет способ отправки токена, поэтому вводите его только для токена учетной записи. Токен доступа, введенный с именем пользователя, или токен учетной записи без него будут отклонены.

Что происходит дальше

• Сайт может развертываться напрямую из репозитория в этой учетной записи: выберите его в настройках подключения репозитория сайта, укажите репозиторий и ветку, и отправка изменений выполнит развертывание.
• Для любой другой ветки можно настроить отдельный предварительный просмотр, чтобы проверить изменения до того, как они попадут на рабочий сайт.
• Статические хостинги с поддержкой сборки через Git, такие как Render и Azure Static Web Apps, используют это подключение в качестве источника кода сайта.

Если подключение не устанавливается

Репозиторий отсутствует. Токен доступа имеет доступ только к тому репозиторию, проекту или рабочей области, в которых он был создан. Создайте его на уровне, охватывающем все необходимые вам репозитории.

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

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

Подключение устанавливается, но последующие действия завершаются ошибкой. Ключ проходит аутентификацию, но у него отсутствуют разрешения, необходимые для выполнения действия. Создайте новый ключ с правами, указанными выше, затем отключите старое соединение и подключите новый ключ.

Отключение

Откройте Integrations, найдите учетную запись и нажмите Disconnect. Это приведет к немедленному удалению сохраненного ключа. Всё, что его использовало, прекратит работу при следующем действии, а экраны, зависевшие от него, сообщат об этом, вместо того чтобы завершаться с тихой ошибкой.

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