Підключіть свій обліковий запис 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. Це негайно видалить збережений ключ. Усе, що його використовувало, зупиниться під час наступної спроби виконання дії, а екрани, які від нього залежали, повідомлять про це, замість того щоб тихо завершитися помилкою.

Відключення не скасовує того, що вже було зроблено — записи, розгортання або налаштування, які ми змінили у вашому обліковому записі, залишаються без змін. Якщо ви вважаєте, що сам ключ міг бути скомпрометований, також відкличте його у постачальника; відключення видаляє нашу копію, а не їхню.