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

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

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

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

Учетная запись GitLab с доступом к проектам, которые вы хотите развернуть.

1. Создайте ключ в GitLab

В GitLab выберите свой аватар в правом верхнем углу, затем Edit profile → Access → Personal access tokens и создайте новый токен (в меню Generate token сервис GitLab может пометить его как Legacy token). Укажите имя, задайте срок действия и отметьте следующие области доступа (scopes):

• api
• write_repository

Нажмите Generate token и скопируйте его — GitLab показывает его только один раз.

2. Подключите его здесь

Откройте раздел Интеграции в вашей панели управления и выберите Подключить учетную запись. Выберите Хостинг кода в качестве группы и GitLab в качестве учетной записи, заполните поле Токен API и нажмите Подключить учетную запись.

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

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

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

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

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

Отсутствует область доступа. Области доступа токена нельзя изменить после его создания; создайте новый токен, отметив обе области доступа.

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

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

Отключение

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

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