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

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

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

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

Учетная запись 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 — а если вы создали токен в учетной записи Atlassian, а не токен доступа, то также и Account username, после чего нажмите Connect account.

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

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

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

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

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

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

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

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

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

Отключение

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

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