Manfaat menghubungkannya untuk Anda
Menghubungkan Bitbucket memungkinkan situs melakukan deployment dari salah satu repositori Bitbucket Cloud Anda: lakukan push ke branch dan situs akan diperbarui.
Sebelum Anda mulai
Akun Bitbucket Cloud dengan akses ke repositori yang ingin Anda deploy.
1. Buat kunci di Bitbucket
Bitbucket menawarkan dua jenis kredensial, dan keduanya berfungsi:
- Token akses untuk repositori, proyek, atau ruang kerja, yang dibuat dari pengaturan repositori, proyek, atau ruang kerja itu sendiri di bawah Access tokens. Token ini terikat pada repositori, proyek, atau ruang kerja tersebut, bukan pada perorangan. Berikan token ini akses baca ke repositori.
- Token API di akun Atlassian Anda. Pilih profil Anda, lalu Account settings → Security → Create and manage API tokens → Create API token with scopes. Beri nama, tetapkan masa kedaluwarsa, pilih Bitbucket sebagai aplikasi, dan pilih akses baca ke repositori. Bitbucket hanya menampilkan token satu kali; salin token saat itu.
2. Hubungkan di sini
Buka Integrations di dasbor Anda dan pilih Connect an account. Pilih Code hosting sebagai grup dan Bitbucket sebagai akun, isi API token — dan, jika Anda membuat token di akun Atlassian Anda alih-alih token akses, isi juga Account username, lalu tekan Connect account.
Kami menguji apa yang Anda tempelkan sebelum apa pun disimpan. Kunci yang tidak berfungsi tidak akan pernah disimpan, dan jawabannya akan memberi tahu apa kendala pada kunci tersebut. Kunci yang berfungsi akan disimpan terenkripsi di brankas rahasia kami — tidak pernah di basis data kami — dan tidak akan pernah ditampilkan lagi, bahkan kepada Anda.
Nama pengguna menentukan cara kami mengirimkan token, jadi masukkan nama pengguna hanya untuk token akun. Token akses yang dimasukkan dengan nama pengguna, atau token akun tanpa nama pengguna, akan ditolak.
Apa yang terjadi selanjutnya
- Situs dapat melakukan deployment langsung dari repositori di akun ini: pilih repositori tersebut pada koneksi repositori situs, pilih repositori dan branch, lalu push akan memicu deployment.
- 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 ditemukan. Token akses hanya dapat menjangkau repositori, proyek, atau ruang kerja tempat token tersebut dibuat. Buat token pada tingkat yang mencakup setiap repositori yang Anda butuhkan.
Sebelumnya berfungsi lalu berhenti. Kedua jenis token dapat kedaluwarsa. Buat token baru dan hubungkan.
Muncul pesan bahwa kunci ditolak. Hampir selalu karena salah satu dari tiga hal: spasi atau jeda baris yang ikut tersalin bersamanya, kunci yang telah kedaluwarsa, atau kunci yang telah dicabut atau dibuat ulang setelah Anda menyalinnya. Buat kunci baru dan tempelkan kembali.
Terhubung, tetapi kemudian terjadi kegagalan. Kunci berhasil 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 yang baru.
Memutuskan koneksi
Buka Integrations, temukan akun tersebut, lalu tekan Disconnect. Tindakan ini akan segera 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 di akun Anda akan tetap seperti semula. Jika Anda merasa kunci itu sendiri mungkin telah bocor, cabut juga kunci tersebut di pihak vendor; memutuskan koneksi hanya menghapus salinan kami, bukan salinan mereka.