Какво ви дава свързването
Свързването на GitLab позволява на даден сайт да се внедрява от някое от вашите хранилища в GitLab и ни позволява да публикуваме в GitLab Pages във вашия профил, когато го изберете като хост на сайта.
Преди да започнете
Профил в GitLab с достъп до проектите, които искате да внедрите.
1. Създайте ключа в GitLab
В GitLab изберете вашия аватар в горния десен ъгъл, след това Edit profile → Access → Personal access tokens и генерирайте нов токен (GitLab може да го обозначи като Legacy token в менюто Generate token). Дайте му име, задайте срок на валидност и отметнете следните обхвати:
Натиснете Generate token и го копирайте — GitLab го показва само веднъж.
2. Свържете го тук
Отворете Integrations във вашето табло за управление и изберете Connect an account. Изберете Code hosting като група и GitLab като профил, попълнете API token и натиснете Connect account.
Тестваме това, което поставите, преди да бъде запазено каквото и да било. Ключ, който не работи, никога не се съхранява, а отговорът показва какъв е бил проблемът с него. Ключ, който работи, се съхранява криптиран в нашия трезор за секрети — никога в нашата база данни — и никога повече не се показва, дори и на вас.
Какво следва
- Даден сайт може да се внедрява директно от хранилище в този профил: изберете го при свързването на хранилището на сайта, посочете хранилището и клона, и всяко качване (push) ще стартира внедряване.
- Всеки друг клон може да получи свой собствен предварителен преглед, за да можете да проверите промяната, преди тя да достигне до работещия сайт.
- Хостинг платформи за статични сайтове, базирани на Git, като Render и Azure Static Web Apps, използват тази връзка като източник на кода на сайта.
Ако не се свързва
Работеше и след това спря. Токените на GitLab винаги изтичат — обикновено най-много година след като ги създадете — и GitLab ви изпраща имейл, преди това да се случи. Създайте нов и го свържете.
Липсва обхват. Обхватите на токена не могат да се променят след създаването му; създайте нов токен с отметнати и двата обхвата.
Пише, че ключът е отхвърлен. Почти винаги причината е една от три: интервал или нов ред, копиран заедно с него, ключ с изтекъл срок или ключ, който е бил отменен или регенериран, след като сте го копирали. Създайте нов и го поставете отново.
Свързва се, но по-късно нещо се проваля. Ключът се удостоверява успешно, но няма разрешение, необходимо за действието. Създайте нов ключ с изброените по-горе разрешения, след това прекъснете старата връзка и свържете новия ключ.
Прекъсване на връзката
Отворете Integrations, намерете профила и натиснете Disconnect. Това незабавно изтрива съхранения ключ. Всичко, което го е използвало, ще спре при следващото си действие, а екраните, които са зависили от него, ще съобщят за това, вместо да се провалят тихо.
Прекъсването на връзката не отменя вече извършеното — записите, внедряванията или настройките, които сме променили във вашия профил, остават непроменени. Ако смятате, че самият ключ може да е изтекъл, анулирайте го и при доставчика; прекъсването на връзката премахва нашето копие, а не тяхното.