Hubungkan akun GitHub Anda dengan token agar situs Anda dapat dideploy dari repositori

Apa keuntungan menghubungkan ini

Menghubungkan GitHub menggunakan token memungkinkan situs mendurokan dari salah satu repositori Anda: dorong ke cabang dan situs akan diperbarui. Ini juga memungkinkan kami menerbitkan ke GitHub Pages di akun Anda jika Anda memilihnya sebagai host situs.

Jika repositori Anda milik suatu organisasi, lebih baik gunakan aplikasi Zinn® GitHub — lihat Instal aplikasi Zinn® GitHub. Token milik satu orang dan berhenti berfungsi saat orang tersebut pergi.

Sebelum Anda mulai

Akun GitHub dengan akses ke repositori yang ingin Anda deploy. Jika repositori tersebut milik suatu organisasi, pemilik mungkin harus menyetujui token berbutir halus (fine-grained tokens) untuk organisasi tersebut.

1. Buat kunci di GitHub

Di GitHub, klik gambar profil Anda, lalu Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token. Beri nama dan pilih tanggal kedaluwarsa. Di bawah Repository access, pilih Only select repositories dan pilih repositori yang Anda deploy — akses paling terbatas yang tetap berfungsi.

Di bawah Repository permissions, berikan izin Read and write pada:

• Contents
• Pages
• Administration

Tekan Generate token dan salin — GitHub hanya menampilkannya sekali.

2. Hubungkan di sini

Buka Integrations di dasbor Anda dan pilih Connect an account. Pilih Code hosting sebagai grup dan GitHub sebagai akun, isi API token, lalu tekan Connect account.

Kami menguji apa yang Anda tempel sebelum ada yang disimpan. Kunci yang tidak berfungsi sama sekali tidak disimpan, dan pesan akan memberi tahu apa yang salah dengannya. Kunci yang berfungsi disimpan dalam keadaan terenkripsi di brankas rahasia kami — tidak pernah di basis data kami — dan tidak akan pernah ditampilkan lagi, bahkan kepada Anda sendiri.

Apa langkah selanjutnya

• Situs dapat di-deploy langsung dari repositori di akun ini: pilih di sambungan repositori situs, pilih repositori dan cabang, lalu push akan mendeploy-nya.
• Setiap cabang lainnya bisa mendapatkan pratinjau sendiri, sehingga Anda dapat memeriksa perubahan sebelum mencapai situs utama.
• Host statis berbasis Git seperti Render dan Azure Static Web Apps menggunakan sambungan ini sebagai sumber kode situs.

Jika gagal tersambung

Repositori tidak muncul. Akses repositori token tidak mencakup repositori tersebut. Edit token di GitHub dan tambahkan repositori.

Awalnya berhasil lalu berhenti. Token berbutir halus kedaluwarsa pada tanggal yang Anda pilih. Buat yang baru dan sambungkan; GitHub akan mengirim email kepada Anda sebelum token kedaluwarsa.

Pesan menyatakan kunci ditolak. Hampir selalu disebabkan oleh salah satu dari tiga hal ini: spasi atau jeda baris yang ikut tersalin, kunci yang sudah kedaluwarsa, atau kunci yang dicabut atau dibuat ulang setelah Anda menyalinnya. Buat yang baru dan tempel kembali.

Tersambung, tetapi ada tindakan yang gagal kemudian. Kunci berhasil diautentikasi tetapi tidak memiliki izin yang diperlukan oleh tindakan tersebut. Buat kunci baru dengan izin yang tercantum di atas, lalu putuskan sambungan yang lama dan sambungkan kunci yang baru.

Memutuskan sambungan

Buka Integrations, cari akun tersebut, lalu tekan Disconnect. Tindakan ini akan langsung menghapus kunci yang tersimpan. Apa pun yang menggunakannya akan berhenti pada tindakan berikutnya, dan layar yang bergantung padanya akan menampilkan pemberitahuan daripada gagal secara diam-diam.

Memutuskan sambungan tidak membatalkan hal yang sudah dilakukan — catatan, deploy, atau pengaturan yang kami ubah di akun Anda akan tetap seperti semula. Jika Anda menduga kunci tersebut bocor, cabut juga kunci di pihak vendor; memutuskan sambungan hanya menghapus salinan milik kami, bukan milik mereka.