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

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

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

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

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

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

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

Репозиторій не з'являється. Доступ токена до репозиторіїв не охоплює його. Відредагуйте токен на GitHub і додайте репозиторій.

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

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

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

Відключення

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

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