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

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

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

Если ваши репозитории принадлежат организации, лучше используйте приложение Zinn® GitHub — см. Установка приложения Zinn® GitHub. Токен принадлежит одному человеку и перестает работать, когда этот человек уходит.

Перед началом работы

Учетная запись GitHub с доступом к репозиториям, которые вы хотите развернуть. Если они принадлежат организации, ее владелец может подтвердить для нее токены с детальной настройкой разрешений.

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 и добавьте репозиторий.

Подключение работало, а затем прекратило работу. У токенов с детальной настройкой разрешений истекает срок действия в выбранную вами дату. Сгенерируйте новый токен и подключите его; GitHub отправляет электронное письмо перед истечением срока действия токена.

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

Отключение

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

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