Sambungkan akaun GitHub anda dengan token supaya tapak anda boleh di-deploy daripada repositori

Perkara yang dilakukan oleh sambungan ini untuk anda

Menghubungkan GitHub menggunakan token membolehkan sesebuah laman web di-deploy dari salah satu repositori anda: push ke cawangan tersebut dan laman web akan dikemas kini. Ia juga membolehkan kami menerbitkan ke GitHub Pages pada akaun anda apabila anda memilihnya sebagaihos laman web.

Jika repositori anda tergolong dalam sebuah organisasi, utamakan aplikasi Zinn® GitHub — lihat Pasang aplikasi Zinn® GitHub. Token adalah milik seorang individu sahaja dan akan berhenti berfungsi apabila individu tersebut meninggalkan organisasi.

Sebelum anda bermula

Sebuah akaun GitHub yang mempunyai akses kepada repositori yang anda mahu deploy. Jika repositori tersebut tergolong dalam sebuah organisasi, pemilik mungkin perlu meluluskan token berbutiran halus untuk organisasi tersebut.

1. Cipta kunci di GitHub

Pada GitHub, klik gambar profil anda, kemudian Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token. Namakan token tersebut dan pilih tarikh luput. Di bawah Repository access, pilih Only select repositories dan pilih repositori yang anda deploy — akses paling minimum yang boleh berfungsi.

Di bawah Repository permissions, berikan kebenaran Read and write untuk:

• Contents
• Pages
• Administration

Tekan Generate token dan salin kunci tersebut — GitHub hanya memaparkannya sekali sahaja.

2. Sambungkan di sini

Buka Integrations dalam papan pemuka anda dan pilih Connect an account. Pilih Code hosting sebagai kumpulan dan GitHub sebagai akaun, masukkan API token, dan tekan Connect account.

Kami menguji apa yang anda tampal sebelum sebarang maklumat disimpan. Kunci yang tidak berfungsi tidak akan disimpan sama sekali, dan jawapan akan menyatakan apa yang tidak kena dengannya. Kunci yang berfungsi disimpan dalam keadaan disulitkan di dalam bilik kebal rahsia kami — bukan dalam pangkalan data kami — dan tidak akan dipaparkan lagi, malah kepada anda sekalipun.

Apa yang berlaku seterusnya

• Laman web boleh di-deploy terus daripada repositori pada akaun ini: pilihnya pada sambungan repositori laman web tersebut, pilih repositori dan cawangan, dan tindakan push akan melakukan deployment.
• Setiap cawangan lain boleh mendapatkan pratonton sendiri, jadi anda boleh menyemak sesuatu perubahan sebelum ia sampai ke laman web langsung (live).
• Host statik binaan Git seperti Render dan Azure Static Web Apps menggunakan sambungan ini sebagai sumber kod laman web.

Jika sambungan gagal

Repositori tidak dipaparkan. Akses repositori token tidak merangkumi repositori tersebut. Edit token pada GitHub dan tambahkan repositori itu.

Ia berfungsi dan kemudian berhenti. Token berbutiran halus akan tamat tempoh pada tarikh yang anda pilih. Jana token baharu dan sambungkan semula; GitHub akan menghantar e-mel kepada anda sebelum token tamat tempoh.

Ia menyatakan kunci ditolak. Hampir selalu disebabkan oleh salah satu daripada tiga perkara ini: ruang kosong atau tanda baris baharu tersalin bersama, kunci yang telah tamat tempoh, atau kunci yang telah dibatalkan atau dijana semula selepas anda menyalinnya. Cipta kunci baharu dan tampal semula.

Ia bersambung, tetapi sesuatu kemudiannya gagal. Kunci tersebut disahkan tetapi kekurangan kebenaran yang diperlukan oleh tindakan itu. Cipta kunci baharu dengan kebenaran yang disenaraikan di atas, kemudian putuskan sambungan lama dan sambungkan kunci baharu.

Memutuskan sambungan

Buka Integrations, cari akaun tersebut dan tekan Disconnect. Tindakan itu akan memadamkan kunci yang disimpan serta-merta. Apa-apa sahaja yang menggunakannya akan berhenti pada tindakan seterusnya, dan skrin yang bergantung padanya akan memaparkan mesej ralat dan bukannya gagal secara senyap.

Memutuskan sambungan tidak membatalkan perkara yang telah dilakukan — rekod, deployment atau tetapan yang telah kami ubah pada akaun anda akan kekal seperti sediakala. Jika anda berpendapat kunci itu sendiri mungkin telah bocor, batalkan juga kunci tersebut pada pihak vendor; memutuskan sambungan hanya membuang salinan kami, bukan salinan mereka.