Hubungkan akun Bitbucket Anda agar situs Anda dapat dideploy dari sebuah repositori

Apa kegunaan menghubungkannya

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 dapat digunakan:

• Token akses untuk repositori, proyek, atau workspace, yang dibuat dari pengaturan repositori,

proyek, atau workspace itu sendiri di bawah Access tokens. Token ini terikat ke repositori, proyek, atau workspace tersebut dan bukan ke seseorang. Berikan akses baca (read) 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, tentukan tanggal kedaluwarsa, pilih Bitbucket** sebagai aplikasi, dan pilih akses baca ke repositori. Bitbucket menampilkan token tersebut satu kali; salin token tersebut 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 alih-alih token akses, isi juga Account username, lalu tekan Connect account.

Kami menguji apa yang Anda tempel (paste) sebelum ada yang disimpan. Kunci yang tidak berfungsi sama sekali tidak akan disimpan, dan tanggapannya akan menjelaskan letak kesalahannya. Kunci yang berfungsi disimpan secara terenkripsi di brankas rahasia kami — tidak pernah di basis data kami — dan tidak akan pernah ditampilkan lagi, bahkan kepada Anda.

Nama pengguna (username) menentukan cara kami mengirimkan token, jadi masukkan 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 langsung melakukan deployment dari repositori di akun ini: pilih di koneksi repositori

situs tersebut, pilih repositori dan branch, dan tindakan push akan melakukan deployment.

• Setiap branch lainnya dapat memiliki pratinjau (preview) 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

Repositori tidak ditemukan. Token akses hanya menjangkau repositori, proyek, atau workspace tempat token tersebut dibuat. Buat token pada level yang mencakup setiap repositori yang Anda perlukan.

Berfungsi lalu berhenti. Kedua jenis token dapat kedaluwarsa. Buat yang baru dan hubungkan.

Kunci ditolak. Hampir selalu disebabkan oleh salah satu dari tiga hal berikut: spasi atau pemisah baris yang ikut tersalin, kunci yang telah kedaluwarsa, atau kunci yang dicabut (revoked) atau dibuat ulang setelah Anda menyalinnya. Buat kunci baru dan tempel kembali.

Terhubung, namun ada proses yang gagal. Kunci berhasil diautentikasi tetapi tidak memiliki izin yang diperlukan oleh tindakan tersebut. Buat kunci baru dengan izin yang tercantum di atas, lalu putuskan koneksi (disconnect) yang lama dan hubungkan kunci yang baru.

Memutuskan koneksi

Buka Integrations, temukan akun tersebut, lalu tekan Disconnect. Tindakan ini akan menghapus kunci yang tersimpan seketika. Apa pun yang menggunakannya akan berhenti pada tindakan berikutnya, dan layar yang bergantung padanya akan menampilkan pemberitahuan alih-alih gagal secara diam-diam.

Memutuskan koneksi 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 vendor penyedia; memutuskan koneksi hanya menghapus salinan milik kami, bukan milik mereka.