Установите приложение GitHub для Zinn®, чтобы мы могли выполнять развертывание без долгосрочного токена

Что подключение дает вам

Установка приложения 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 (установка приложения).
• При привязке GitHub к проектной доске выберите Приложение Zinn® GitHub.

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

Что происходит дальше

• Репозитории, к которым вы предоставили доступ приложению, появляются для развертывания сайта, и отправка изменений (push) запускает развертывание.
• каждое наше действие отображается в журнале аудита установки на GitHub под именем приложения, а не под вашим;
• Чтобы предоставить нам доступ к другим репозиториям, измените параметры доступа приложения на той же странице Configure — повторное подключение не требуется.

Если подключение не удается

Репозиторий отсутствует. Установка распространяется только на выбранные вами репозитории. Откройте страницу Configure и добавьте его.

Номер отклонен. Убедитесь, что это номер установки из адресной строка, а не собственный идентификатор приложения, и что приложение все еще установлено — у удаленного приложения нет установки.

Сообщение об отклонении ключа. Почти всегда это связано с одной из трех причин: скопирован лишний пробел или разрыв строки, срок действия ключа истек или ключ был отозван или пересоздан после того, как вы его скопировали. Создайте новый ключ и вставьте его снова.

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

Отключение

Откройте Integrations, найдите учетную запись и нажмите Disconnect. Это сразу удаляет сохраненный ключ. Все, что его использовало, прекращает работу при следующем действии, и зависимые от него экраны сообщают об этом, а не завершаются с тихим сбоем.

Отключение не отменяет уже выполненные действия — записи, развертывания или настройки, которые мы изменили в вашей учетной записи, остаются прежними. Если вы считаете, что сам ключ мог бытькомпрометирован, также отзовите его у поставщика; отключение удаляет нашу копию, но не их.