Установіть додаток Zinn® для GitHub, щоб ми могли розгортати без довготривалого токена

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

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

Перш ніж почати

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

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

Ключ створювати не потрібно. Встановіть застосунок Zinn® GitHub у своєму особистому обліковому записі або організації та виберіть або всі репозиторії, або лише ті, які ви хочете, щоб ми розгортали.

Потім знайдіть номер установлення:

• Особистий обліковий запис — Settings → Applications → Installed GitHub Apps і Configure поруч із застосунком Zinn®.
• Організація — Your organizations → Settings → GitHub Apps і Configure поруч із застосунком Zinn®.

Число в кінці адресного рядка на цій сторінці — наприклад github.com/settings/installations/12345678 — це і є номер установлення.

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

Застосунок вибирається там, де він використовується, а не на екрані «Інтеграції»:

• У підключенні репозиторію сайту виберіть GitHub (app install).
• У посиланні на GitHub для дошки проєкту виберіть The Zinn® GitHub app.

Вставте Номер установлення та продовжуйте. Ми перевіряємо встановлення перед збереженням будь-чого; номер, до якого ми не можемо отримати доступ, ніколи не зберігається.

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

• Репозиторії, до яких ви надали доступ застосунку, з'являються для розгортання сайту, і пуш запускає його розгортання.
• Кожна дія, яку ми виконуємо, з'являється в журналі аудиту встановлення на GitHub під назвою застосунка, а не вашим іменем.
• Щоб надати нам більше репозиторіїв, змініть доступ застосунка до репозиторіїв на тій самій сторінці Configure — нічого повторно підключати не потрібно.

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

Репозиторій відсутній. Встановлення охоплює лише вибрані вами репозиторії. Відкрийте Configure і додайте його.

Номер відхилено. Переконайтеся, що це номер установлення з адресного рядка, а не власний ID застосунка, і що застосунок усе ще встановлено — видалений застосунок не має встановлення.

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

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

Відключення

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

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