Apa manfaat menghubungkannya
Menghubungkan GitLab memungkinkan situs dideploy dari salah satu repositori GitLab Anda, dan memungkinkan kami mempublikasikan ke GitLab Pages di akun Anda jika Anda memilihnya sebagai host situs.
Sebelum Anda mulai
Akun GitLab dengan akses ke project yang ingin Anda deploy.
1. Buat kunci di GitLab
Di GitLab, pilih avatar Anda di pojok kanan atas, lalu Edit profile → Access → Personal access tokens, dan buat token baru (GitLab mungkin memberi label Legacy token di menu Generate token). Beri nama, tetapkan tanggal kedaluwarsa, dan centang cakupan ini:
Tekan Generate token dan salin — GitLab hanya menampilkannya sekali.
2. Hubungkan di sini
Buka Integrations di dasbor Anda dan pilih Connect an account. Pilih Code hosting sebagai grup dan GitLab 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 balasan akan menunjukkan letak kesalahannya. Kunci yang berfungsi disimpan secara terenkripsi di brankas rahasia kami — tidak pernah di database kami — dan tidak akan pernah ditampilkan lagi, bahkan kepada Anda sendiri.
Apa yang terjadi selanjutnya
- Situs dapat langsung dideploy dari repositori di akun ini: pilih pada koneksi repositori situs, pilih repositori dan cabang, lalu push akan mendeploy.
- 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 koneksi ini sebagai sumber kode situs.
Jika koneksi gagal
Berhasil lalu berhenti. Token GitLab selalu kedaluwarsa — biasanya paling lama setahun setelah Anda membuatnya — dan GitLab mengirimkan email kepada Anda sebelum itu terjadi. Buat yang baru dan hubungkan.
Cakupan tidak lengkap. Cakupan token tidak dapat diubah setelah dibuat; buat token baru dengan kedua cakupan dicentang.
Pesan menyatakan kunci ditolak. Hampir selalu disebabkan oleh salah satu dari tiga hal berikut: spasi atau jeda baris yang ikut disalin, kunci yang telah kedaluwarsa, atau kunci yang telah dicabut atau dibuat ulang setelah Anda menyalinnya. Buat yang baru dan tempel kembali.
Terhubung, tetapi proses selanjutnya gagal. Kunci terautentikasi tetapi tidak memiliki izin yang diperlukan tindakan tersebut. Buat kunci baru dengan izin yang tercantum di atas, lalu putuskan koneksi yang lama dan hubungkan kunci yang baru.
Memutuskan koneksi
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, and layar yang bergantung padanya akan menampilkan pemberitahuan alih-alih gagal secara diam-diam.
Memutuskan koneksi tidak membatalkan apa yang telah dilakukan — catatan, deployment, atau pengaturan yang telah kami ubah di akun Anda akan tetap seperti semula. Jika Anda menduga kunci tersebut mungkin telah bocor, cabut juga kunci di pihak vendor; memutuskan koneksi hanya menghapus salinan milik kami, bukan milik mereka.