Свържете своя GitHub акаунт с токен, за да могат сайтовете ви да се внедряват от хранилище

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

Свързването на GitHub с токен позволява внедряване на сайт от някое от вашите хранилища: изпращате към клона (push) и сайтът се актуализира. То също така ни позволява да публикуваме в 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.

Тестваме въведеното от вас, преди да бъде запазено каквото и да било. Ключ, който не работи, никога не се съхранява, а отговорът показва какъв е бил проблемът с него. Ключ, който работи, се съхранява криптиран в нашето защитено хранилище за тайни — никога в нашата база данни — и никога повече не се показва, дори и на вас.

Какво следва

• Даден сайт може да се внедрява директно от хранилище в този акаунт: изберете го във връзката за хранилище на сайта, посочете хранилището и клона, и внедряването се задейства с push.
• Всеки друг клон може да получи собствен предварителен преглед, за да можете да проверите дадена промяна, преди тя да стигне до работещия сайт.
• Статични хостинги, базирани на Git, като Render и Azure Static Web Apps, използват тази връзка като източник на кода на сайта.

Ако не се свързва

Дадено хранилище не се появява. Достъпът до хранилища на токена не го включва. Редактирайте токена в GitHub и добавете хранилището.

Работеше, а след това спря. Токените с детайлно зададени права изтичат на избраната от вас дата. Генерирайте нов и го свържете; GitHub ви изпраща имейл, преди токенът да изтече.

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

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

Прекъсване на връзката

Отворете Integrations, намерете акаунта и натиснете Disconnect. Това незабавно изтрива съхранения ключ. Всичко, което го е използвало, спира при следващото си действие, а екраните, които са зависили от него, съобщават за това, вместо да се провалят мълчаливо.

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