Свържете своя GitLab акаунт, така че сайтовете ви да се деплойват от хранилище

Какво ви дава свързването

Свързването на GitLab позволява на даден сайт да се деплойва от някой от вашите GitLab репозиторита и ни дава възможност да публикуваме в GitLab Pages във вашия акаунт, където изберете това за хост на сайта.

Преди да започнете

Акаунт в GitLab с достъп до проектите, които искате да деплойвате.

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

В GitLab изберете своя аватар горе вдясно, след това Edit profile → Access → Personal access tokens и генерирайте нов токен (GitLab може да го обозначи като Legacy token в менюто Generate 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. Това незабавно изтрива съхранения ключ. Всичко, което го е използвало, спира при следващото си действие, а екраните, които са зависели от него, съобщават за това, вместо да се провалят тихо.

Прекъсването на връзката не отменя вече направеното — записите, деплойванията или настройките, които сме променили във вашия акаунт, остават такива, каквито са. Ако смятате, че самият ключ може да е бил изтекъл, отзъвете го и при доставчика; прекъсването на връзката премахва нашето копие, а не тяхното.