Підключіть свій обліковий запис GitHub за допомогою токена, щоб ваші сайти розгорталися з репозиторію

Що дає вам підключення

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

Якщо ваші репозиторії належать організації, натомість краще скористайтеся додатком Zinn® GitHub — див. Встановлення додатка Zinn® GitHub. Токен належить одній людині й припиняє працювати, коли вона йде.

Перед початком

Акаунт GitHub із доступом до репозиторіїв, які ви хочете розгорнути. Якщо вони належать організації, можливо, власнику доведеться схвалити для неї токени з детальним налаштуванням доступу (fine-grained tokens).

1. Створіть ключ на GitHub

На GitHub натисніть на зображення свого профілю, а потім Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token. Дайте йому назву та виберіть термін дії. У розділі Repository access виберіть Only select repositories і вкажіть ті, які ви розгортаєте — забезпечте найвужчий із можливих доступів.

У розділі Repository permissions надайте право Read and write для:

• Contents
• Pages
• Administration

Натисніть Generate token і скопіюйте його — GitHub показує його лише один раз.

2. Підключіть його тут

Відкрийте Integrations у своїй панелі керування та виберіть Connect an account. Виберіть Code hosting як групу та GitHub як акаунт, заповніть поле API token і натисніть Connect account.

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

Що буде далі

• Сайт може розгортатися безпосередньо з репозиторію в цьому акаунті: виберіть його в налаштуваннях

підключення репозиторію сайту, вкажіть репозиторій і гілку — і пуш запустить розгортання.

• Кожна інша гілка може отримати власний попередній перегляд, тож ви можете перевірити зміни до того, як вони потраплять на

живий сайт.

• Статичні хостинги, що збираються за допомогою Git, такі як Render і Azure Static Web Apps, використовують це підключення як

джерело коду сайту.

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

Репозиторій не відображається. Доступ токена до репозиторіїв не містить його. Відредагуйте токен на GitHub і додайте репозиторій.

Все працювало, а потім зупинилося. Токени з детальним налаштуванням доступу (fine-grained tokens) мають термін дії, який ви вибрали. Згенеруйте новий токен і підключіть його; GitHub надсилає сповіщення електронною поштою до закінчення терміну дії токена.

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

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

Відключення

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

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