Pasang aplikasi Zinn® GitHub agar kami dapat melakukan *deployment* tanpa token berumur panjang

Apa yang dapat Anda lakukan dengan menghubungkannya

Menginstal aplikasi Zinn® GitHub memungkinkan situs melakukan deployment dari repositori Anda — dan papan proyek tetap sinkron dengan GitHub — tanpa harus menyerahkan token pribadi kepada kami. Kami hanya menyimpan nomor instalasi aplikasi, yang tidak berguna jika berdiri sendiri, dan membuat token yang berlaku selama satu jam setiap kali kami membutuhkannya. Ini adalah pilihan yang lebih baik untuk organisasi, karena tidak dimiliki oleh satu orang pun dan tidak berhenti berfungsi ketika seseorang keluar.

Sebelum Anda mulai

Akun GitHub, atau hak pemilik pada organisasi tempat Anda ingin menginstal aplikasi tersebut. Organisasi yang melarang aplikasi pihak ketiga memerlukan persetujuan dari pemilik; jika hal tersebut tidak memungkinkan, gunakan token dengan cakupan terperinci (Hubungkan akun GitHub Anda) sebagai gantinya.

1. Buat kunci di GitHub

Tidak ada kunci yang perlu dibuat. Instal aplikasi Zinn® GitHub di akun pribadi Anda atau organisasi Anda, dan pilih semua repositori atau hanya repositori yang ingin Anda gunakan untuk deployment.

Kemudian cari nomor instalasi:

• Akun pribadi — Settings → Applications → Installed GitHub Apps, lalu pilih Configure

di sebelah aplikasi Zinn®.

• Organisasi — Your organizations → Settings → GitHub Apps, lalu pilih Configure di sebelah

aplikasi Zinn®.

Nomor di bagian akhir bilah alamat pada halaman tersebut — misalnya github.com/settings/installations/12345678 — adalah nomor instalasi.

2. Hubungkan di sini

Aplikasi dipilih di tempat penggunaannya, bukan di layar Integrasi:

• Pada koneksi repositori situs, pilih GitHub (app install).
• Pada tautan GitHub papan proyek, pilih The Zinn® GitHub app.

Tempelkan Installation number dan lanjutkan. Kami memeriksa instalasi sebelum menyimpan apa pun; nomor yang tidak dapat kami jangkau tidak akan pernah disimpan.

Apa yang terjadi selanjutnya

• Repositori yang Anda berikan izinnya kepada aplikasi akan muncul agar situs dapat melakukan deployment, dan tindakan

push akan melakukan deployment.

• Setiap tindakan yang kami lakukan akan muncul di log audit instalasi pada GitHub di bawah nama aplikasi,

bukan nama Anda.

• Untuk memberi kami lebih banyak repositori, ubah akses repositori aplikasi pada halaman Configure

yang sama — tidak ada yang perlu dihubungkan ulang.

Jika gagal terhubung

Repositori tidak ditemukan. Instalasi hanya mencakup repositori yang Anda pilih. Buka Configure dan tambahkan repositori tersebut.

Nomor ditolak. Periksa apakah itu adalah nomor instalasi dari bilah alamat, bukan ID aplikasi itu sendiri, dan pastikan aplikasi tersebut masih terinstal — aplikasi yang telah dicopot instalasinya tidak memiliki nomor instalasi.

Pesan yang menyatakan kunci ditolak. Hampir selalu disebabkan oleh salah satu dari tiga hal berikut: adanya spasi atau pemisah baris yang ikut tersalin, kunci yang telah kedaluwarsa, atau kunci yang telah dicabut atau dibuat ulang setelah Anda menyalinnya. Buat kunci baru dan tempelkan kembali.

Terhubung, namun ada proses 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 koneksi yang lama dan hubungkan kunci yang baru.

Memutuskan Sambungan

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

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