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

Manfaat menghubungkannya untuk Anda

Menghubungkan GitHub dengan token memungkinkan situs di-deploy dari salah satu repositori Anda: lakukan push ke branch dan situs akan diperbarui. Ini juga memungkinkan kami memublikasikan ke GitHub Pages di akun Anda jika Anda memilihnya sebagai host situs.

Jika repositori Anda milik organisasi, sebaiknya gunakan aplikasi Zinn® GitHub — lihat Instal aplikasi Zinn® GitHub. Token dimiliki oleh satu orang dan berhenti berfungsi saat mereka keluar.

Sebelum Anda mulai

Akun GitHub dengan akses ke repositori yang ingin Anda deploy. Jika repositori tersebut milik organisasi, pemilik mungkin harus menyetujui fine-grained token untuknya.

1. Buat kunci di GitHub

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

Di bawah Repository permissions, berikan Read and write pada:

• Contents
• Pages
• Administration

Tekan Generate token dan salin — GitHub hanya menampilkannya sekali.

2. Hubungkan di sini

Buka Integrations di dashboard 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 apa pun disimpan. Kunci yang tidak berfungsi tidak akan pernah disimpan, dan respons akan memberitahukan masalahnya. Kunci yang berfungsi disimpan terenkripsi di brankas rahasia kami — tidak pernah di basis data kami — dan tidak akan pernah ditampilkan lagi, bahkan kepada Anda.

Apa yang terjadi selanjutnya

• Situs dapat di-deploy langsung dari repositori di akun ini: pilih di koneksi repositori situs, pilih repositori serta branch, dan tindakan push akan men-deploy.
• Setiap branch lainnya dapat memiliki pratinjaunya sendiri, sehingga Anda dapat memeriksa perubahan sebelum diterapkan ke situs langsung.
• Host statis berbasis Git seperti Render dan Azure Static Web Apps menggunakan koneksi ini sebagai sumber kode situs.

Jika tidak terhubung

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

Sempat berfungsi lalu berhenti. Fine-grained token kedaluwarsa pada tanggal yang Anda pilih. Buat token baru dan hubungkan; GitHub mengirimkan email kepada Anda sebelum token kedaluwarsa.

Tertulis bahwa kunci ditolak. Hampir selalu karena salah satu dari tiga hal: spasi atau jeda baris yang ikut tersalin, kunci yang telah kedaluwarsa, atau kunci yang dicabut atau dibuat ulang setelah Anda menyalinnya. Buat kunci baru dan tempelkan kembali.

Terhubung, tetapi ada yang gagal kemudian. Kunci terautentikasi tetapi tidak memiliki izin yang diperlukan untuk tindakan tersebut. Buat kunci baru dengan izin yang tercantum di atas, lalu putuskan koneksi lama dan hubungkan kunci baru.

Memutuskan koneksi

Buka Integrations, temukan akun, lalu tekan Disconnect. Tindakan tersebut akan langsung menghapus kunci yang disimpan. Apa pun yang menggunakannya akan berhenti pada tindakan berikutnya, dan layar yang bergantung padanya akan memberitahukan hal tersebut alih-alih gagal tanpa peringatan.

Memutuskan koneksi tidak membatalkan apa yang telah dilakukan — data, deployment, atau pengaturan yang kami ubah di akun Anda tetap seperti semula. Jika Anda merasa kunci itu sendiri mungkin telah bocor, cabut juga di vendor terkait; memutuskan koneksi hanya menghapus salinan kami, bukan milik mereka.