Manfaat menghubungkannya untuk Anda
Memasang aplikasi GitHub Zinn® memungkinkan situs melakukan deploy dari repositori Anda — dan papan proyek tetap sinkron dengan GitHub — tanpa memberi kami token pribadi. Kami hanya menyimpan nomor instalasi aplikasi tersebut, yang tidak dapat digunakan sendiri, dan mencetak token yang berlaku selama satu jam setiap kali kami membutuhkannya. Ini adalah pilihan yang lebih baik untuk organisasi, karena tidak dimiliki oleh satu orang saja dan tidak berhenti berfungsi saat seseorang keluar.
Sebelum Anda mulai
Akun GitHub, atau hak pemilik pada organisasi tempat Anda ingin memasang aplikasi tersebut. Organisasi yang melarang aplikasi pihak ketiga memerlukan izin pemilik; jika hal tersebut tidak memungkinkan, gunakan token mendetail (fine-grained token) sebagai gantinya (Hubungkan akun GitHub Anda).
1. Buat kunci di GitHub
Tidak ada kunci yang perlu dibuat. Pasang aplikasi GitHub Zinn® di akun pribadi atau organisasi Anda, lalu pilih semua repositori atau hanya repositori yang Anda inginkan untuk kami deploy.
Kemudian temukan nomor instalasinya:
- Akun pribadi — Settings → Applications → Installed GitHub Apps, dan Configure di samping aplikasi Zinn®.
- Organisasi — Your organizations → Settings → GitHub Apps, dan Configure di samping aplikasi Zinn®.
Nomor di akhir bilah alamat pada halaman tersebut — misalnya github.com/settings/installations/12345678 — adalah nomor instalasinya.
2. Hubungkan di sini
Aplikasi dipilih di tempat aplikasi tersebut digunakan, bukan di layar Integrasi:
- Pada koneksi repositori situs, pilih GitHub (app install).
- Pada tautan GitHub papan proyek, pilih The Zinn® GitHub app.
Tempel Nomor instalasi 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 izin kepada aplikasi akan muncul untuk di-deploy oleh situs, dan sebuah push akan men-deploy-nya.
- Setiap tindakan yang kami ambil akan muncul di log audit instalasi pada GitHub di bawah nama aplikasi tersebut, 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 tidak terhubung
Repositori tidak ditemukan. Instalasi hanya mencakup repositori yang Anda pilih. Buka Configure dan tambahkan repositori tersebut.
Nomor ditolak. Pastikan nomor tersebut adalah nomor instalasi dari bilah alamat, bukan ID aplikasi itu sendiri, dan pastikan aplikasi tersebut masih terpasang — aplikasi yang dicopot tidak memiliki instalasi.
Keterangan menyatakan kunci ditolak. Hampir selalu karena salah satu dari tiga hal berikut: spasi atau jeda baris yang ikut tersalin, kunci yang telah kedaluwarsa, atau kunci yang dicabut maupun dibuat ulang setelah Anda menyalinnya. Buat kunci baru dan tempel kembali.
Terhubung, tetapi kemudian terjadi kegagalan. Kunci terautentikasi tetapi tidak memiliki izin yang diperlukan oleh 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 tersebut, lalu tekan Disconnect. Tindakan tersebut akan langsung menghapus kunci yang tersimpan. Apa pun yang menggunakannya akan berhenti pada tindakan berikutnya, dan layar yang bergantung padanya akan memberitahukannya, bukan gagal secara diam-diam.
Memutuskan koneksi tidak membatalkan apa yang telah dilakukan — catatan, deployment, atau pengaturan yang kami ubah pada akun Anda akan tetap seperti semula. Jika Anda merasa kunci itu sendiri mungkin telah bocor, cabut juga kunci tersebut di penyedia; memutuskan koneksi hanya menghapus salinan kami, bukan salinan mereka.