Підключіть свій обліковий запис 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 — а якщо ви створили токен у своєму обліковому записі Atlassian, а не токен доступу, також заповніть Account username, і натисніть Connect account.

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

Ім'я користувача визначає, як ми надсилаємо токен, тому вводьте його лише для токена облікового запису. Токен доступу, введений разом з ім'ям користувача, або токен облікового запису без нього відхиляються.

Що відбувається далі

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

Якщо підключення не вдається

Бракує репозиторію. Токен доступу охоплює лише той репозиторій, проєкт чи робочу область, у якій він був створений. Створіть його на рівні, який охоплює всі необхідні вам репозиторії.

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

Повідомлення про відхилення ключа. Майже завжди це одна з трьох причин: пробіл або розрив рядка, скопійовані разом із ключем; термін дії ключа минув; ключ було відкликано або створено заново після того, як ви його скопіювали. Створіть новий ключ і вставте його знову.

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

Відключення

Відкрийте Integrations, знайдіть обліковий запис і натисніть Disconnect. Це одразу видалить збережений ключ. Будь-які процеси, що його використовували, зупиняться під час наступної дії, а відповідні екрани повідомлять про це, замість того щоб завершуватися мовчки.

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