Što vam donosi povezivanje
Povezivanje servisa GitHub pomoću tokena omogućuje implementaciju web-lokacije iz jednog od vaših repozitorija: gurajte promjene na granu (push) i web-lokacija se ažurira. Također nam omogućuje objavljivanje na GitHub Pages na vašem računu gdje to odaberete kao poslužitelja web-lokacije.
Ako vaši repozitoriji pripadaju organizaciji, radije odaberite aplikaciju Zinn® GitHub — pogledajte Instaliranje aplikacije Zinn® GitHub. Token pripada jednoj osobi i prestaje raditi kada ona ode.
Prije nego što započnete
GitHub račun s pristupom repozitorijima koje želite implementirati. Ako oni pripadaju organizaciji, vlasnik će možda morati odobriti precizno definirane tokene (fine-grained tokens) za nju.
1. Stvorite ključ na servisu GitHub
Na servisu GitHub kliknite svoju profilnu sliku, a zatim Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token. Dodijelite mu naziv i odaberite istek. Pod Repository access odaberite Only select repositories i odaberite one koje implementirate — najuži pristup koji funkcionira.
Pod Repository permissions dodijelite Read and write za:
- Contents
- Pages
- Administration
Pritisnite Generate token i kopirajte ga — GitHub ga prikazuje samo jednom.
2. Povežite ga ovdje
Otvorite Integrations na svojoj upravljačkoj ploči i odaberite Connect an account. Odaberite Code hosting kao grupu i GitHub kao račun, unesite API token i pritisnite Connect account.
Testiramo ono što zalijepite prije nego što se išta spremi. Ključ koji ne radi nikada se ne pohranjuje, a odgovor navodi što s njim nije u redu. Ključ koji radi čuva se šifriran u našem trezoru tajni — nikada u našoj bazi podataka — i nikada se više ne prikazuje, čak ni vama.
Što se događa sljedeće
- Web-lokacija se može implementirati izravno iz repozitorija na ovom računu: odaberite ga na
vezi repozitorija web-lokacije, odaberite repozitorij i granu, a push pokreće implementaciju.
- Svaka druga grana može dobiti vlastiti pretpregled, tako da možete provjeriti promjenu prije nego što stigne na
stvarnu web-lokaciju.
- Statički poslužitelji temeljeni na Git-u, kao što su Render i Azure Static Web Apps, koriste ovu vezu kao
izvor koda web-lokacije.
Ako se ne poveže
Repozitorij se ne pojavljuje. Pristup repozitoriju unutar tokena ne uključuje ga. Uredite token na servisu GitHub i dodajte repozitorij.
Radilo je, a zatim je prestalo. Precizno definirani tokeni istječu na datum koji ste odabrali. Generirajte novi i povežite ga; GitHub vam šalje e-poruku prije isteka tokena.
Piše da je ključ odbijen. Gotovo uvijek jedna od tri stvari: razmak ili prijelom retka kopiran s njim, ključ koji je istekao ili ključ koji je opozvan ili ponovno generiran nakon što ste ga kopirali. Stvorite novi i ponovno ga zalijepite.
Povezuje se, ali nešto kasnije ne uspije. Ključ se autentificira, ali mu nedostaje dopuštenje koje radnja zahtijeva. Stvorite novi ključ s gore navedenim dopuštenjima, zatim prekinite staru vezu i povežite novi ključ.
Prekidanje veze
Otvorite Integrations, pronađite račun i pritisnite Disconnect. To odmah briše pohranjeni ključ. Sve što ga je koristilo zaustavlja se pri sljedećoj radnji, a zasloni koji su ovisili o njemu to jasno navode umjesto da tiho zakažu.
Prekidanje veze ne poništava ono što je već učinjeno — zapisi, implementacije ili postavke koje smo promijenili na vašem računu ostaju kakvi jesu. Ako smatrate da je sam ključ možda procurio, također ga opozovite kod pružatelja usluge; prekidanje veze uklanja našu kopiju, a ne njihovu.