Install the Zinn® GitHub app so we can deploy without a long-lived token

Що це вам дає

Встановлення додатка 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.

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

Що буде далі

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

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

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

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

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

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

Відключення

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

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