Ano ang naidudulot nito sa inyo
Ang pagkonekta sa GitHub gamit ang isang token ay nagbibigay-daan sa isang site na mag-deploy mula sa isa sa inyong mga repository: i-push sa branch at mag-a-update ang site. Binibigyan din nito kami ng pahintulot na mag-publish sa GitHub Pages sa inyong account kung saan iyon ang pipiliin ninyong host ng site.
Kung ang inyong mga repository ay pag-aari ng isang organisasyon, mas mabuting piliin sa halip ang ang Zinn® GitHub app — tingnan ang I-install ang Zinn® GitHub app. Ang isang token ay pag-aari ng iisang tao at tumitigil sa paggana kapag umalis sila.
Bago kayo magsimula
Isang GitHub account na may access sa mga repository na gusto ninyong i-deploy. Kung ang mga ito ay pag-aari ng isang organisasyon, maaaring kailanganin ng isang may-ari na mag-apruba ng mga fine-grained token para rito.
1. Gumawa ng key sa GitHub
Sa GitHub, i-click ang inyong larawan sa profile, pagkatapos ay i-click ang Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token. Bigyan ito ng pangalan at pumili ng expiration. Sa ilalim ng Repository access, piliin ang Only select repositories at piliin ang mga ide-deploy ninyo — ang pinakamaiikling access na gagana.
Sa ilalim ng Repository permissions, magbigay ng Read and write sa:
- Contents
- Pages
- Administration
Pindutin ang Generate token at kopyahin ito — minsan lamang ito ipinapakita ng GitHub.
2. Ikonekta ito rito
Buksan ang Integrations sa inyong dashboard at piliin ang Connect an account. Piliin ang Code hosting bilang grupo at GitHub bilang account, punan ang API token, at pindutin ang Connect account.
Sinusubukan namin ang inyong ini-paste bago i-save ang anuman. Ang key na hindi gumagana ay hindi kailanman itinatago, at sinasabi ng sagot kung ano ang mali dito. Ang key na gumagana ay pinapanatiling naka-encrypt sa aming vault ng mga secret — hindi kailanman sa aming database — at hindi na kailanman ipapakita muli, kahit sa inyo man.
Ang susunod na mangyayari
- Ang isang site ay maaaring mag-deploy nang direkta mula sa isang repository sa account na ito: piliin ito sa koneksyon ng repository ng site, piliin ang repository at branch, at ang pag-push ay magde-deploy.
- Ang bawat iba pang branch ay maaaring magkaroon ng sarili nitong preview, kaya maaari ninyong suriin ang isang pagbabago bago ito dumating sa live site.
- Ang mga static host na binuo sa Git tulad ng Render at Azure Static Web Apps ay ginagamit ang koneksyong ito bilang pinagmulan ng code ng site.
Kung hindi ito makakonekta
Hindi lumalabas ang isang repository. Hindi kasama rito ang access ng token sa repository. I-edit ang token sa GitHub at idagdag ang repository.
Gumana ito at pagkatapos ay tumigil. Ang mga fine-grained token ay nag-e-expire sa petsang pinili ninyo. Gumawa ng bago at ikonekta ito; nag-e-email sa inyo ang GitHub bago mag-expire ang isang token.
Sinasabi nitong tinanggihan ang key. Halos palaging isa sa tatlong bagay: isang puwang o paghati ng linya na nakopya kasama nito, isang key na nag-expire na, o isang key na binawi o muling ginawa pagkatapos ninyong kopyahin ito. Gumawa ng bago at i-paste itong muli.
Kumokonekta ito, pero may nabibigo sa huli. Nagpapatotoo ang key ngunit kulang sa pahintulot na kailangan ng aksyon. Gumawa ng bagong key na may mga pahintulot na nakalista sa itaas, pagkatapos ay idiskonekta ang lumang koneksyon at ikonekta ang bagong key.
Pagdidiskonekta
Buksan ang Integrations, hanapin ang account at pindutin ang Disconnect. Agad nitong tinatanggal ang nakaimbak na key. Ang anumang gumagamit nito ay titigil sa susunod na aksyon nito, at ang mga screen na nakasalalay dito ay magsasabi nito sa halip na tumahimik na mabigo.
Ang pagdidiskonekta ay hindi binabaligtad ang nagawa na — ang mga rekord, deployment o setting na binago namin sa inyong account ay mananatili kung ano ang mga ito. Kung sa palagay ninyo ay maaaring na-leak ang mismong key, bawiin din ito sa vendor; ang pagdidiskonekta ay nag-aalis ng aming kopya, hindi sa kanila.