Подключите свою учетную запись 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. Подключение здесь

Откройте раздел Integrations в своей панели управления и выберите Connect an account. Выберите Code hosting в качестве группы и GitLab в качестве учетной записи, заполните поле API token и нажмите Connect account.

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

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

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

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

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

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

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

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

Отключение

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

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