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

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

Подключение GitHub с помощью токена позволяет развертывать сайт из одного из ваших репозиториев: отправьте изменения в ветку, и сайт обновится. Это также позволяет нам публиковать материалы на 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.

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

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

• Сайт может развертываться непосредственно из репозитория в этой учетной записи: выберите ее в настройках подключения репозитория сайта, укажите репозиторий и ветку, и отправка изменений запустит развертывание.
• Любая другая ветка может получить собственный предварительный просмотр, чтобы вы могли проверить изменения до того, как они попадут на рабочий сайт.
• Статические хостинги на базе Git, такие как Render и Azure Static Web Apps, используют это подключение в качестве источника кода сайта.

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

Репозиторий не отображается. Доступ к репозиториям у токена не включает его. Отредактируйте токен на GitHub и добавьте этот репозиторий.

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

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

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

Отключение

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

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