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

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

Свързването на GitHub с токен позволява на даден сайт да се разгръща от едно от вашите хранилища: направете push към клона и сайтът се актуализира. То също така ни позволява да публикуваме в GitHub Pages във вашия акаунт, когато изберете това за хост на сайта.

Ако вашите хранилища принадлежат на организация, предпочетете приложението Zinn® за GitHub — вижте Инсталиране на приложението Zinn® за GitHub. Токенът принадлежи на едно лице и спира да работи, когато то напусне.

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

Акаунт в GitHub с достъп до хранилищата, които искате да разгърнете. Ако те принадлежат към организация, собственик може да се наложи да одобри фино дефинирани токени за нея.

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. Това изтрива съхранения ключ незабавно. Всичко, което го е използвало, спира при следващото си действие, а екраните, които са зависели от него, съобщават за това, вместо да се провалят тихо.

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