Halaman ini menjelaskan cara untuk terhubung ke repositori Bitbucket Data Center ke Cloud Build.
Sebelum memulai
-
Aktifkan API Cloud Build, Secret Manager, and Compute Engine.
- Ikuti petunjuk untuk menghubungkan host Pusat Data Bitbucket sebelum menghubungkan repositori.
Menghubungkan ke repositori Pusat Data Bitbucket
Konsol
Untuk menghubungkan repositori Pusat Data Bitbucket ke Cloud Build menggunakan konsol Google Cloud:
Buka halaman Repositories di Konsol Google Cloud.
Di bagian atas halaman, pilih tab generasi ke-1.
Klik Connect Repository.
Pilih Bitbucket Data Center.
Anda akan melihat panel Connect Repository. Selesaikan langkah-langkah berikut untuk menghubungkan repositori Pusat Data Bitbucket Anda:
Region: Pilih region tempat koneksi Anda.
Di bagian Select source code management provider, pilih Bitbucket Data Center.
Host connection: Pilih nama koneksi host Anda dari menu drop-down.
Klik Lanjutkan.
Di bagian Select Repository, pilih repositori Bitbucket Data Center yang ingin Anda hubungkan ke Cloud Build.
Setelah memilih akun dan repositori Pusat Data Bitbucket, baca pernyataan penyangkalan izin dan pilih kotak centang di sampingnya untuk menunjukkan bahwa Anda menyetujui persyaratan yang ditampilkan.
Klik Connect untuk menghubungkan repositori Anda.
Klik Done. Secara opsional, klik Create a trigger untuk membuat pemicu.
API
Untuk menghubungkan repositori Pusat Data Bitbucket ke Cloud Build menggunakan API, selesaikan langkah-langkah berikut:
Buat file JSON dengan konten berikut:
{ "parent": "projects/PROJECT_NUMBER/locations/REGION/bitbucketServerConfigs/BITBUCKET_DATA_CENTER_CONFIG_NAME", "requests": { "parent": "projects/PROJECT_NUMBER/locations/REGION/bitbucketServerConfigs/BITBUCKET_DATA_CENTER_CONFIG_NAME", "bitbucketServerConnectedRepository": { "parent": "projects/PROJECT_NUMBER/locations/REGION/bitbucketServerConfigs/BITBUCKET_DATA_CENTER_CONFIG_NAME", "repo": { "projectKey":"PROJECT_KEY", "repoSlug": "REPO_SLUG", } } } }
Dengan keterangan:
- PROJECT_NUMBER adalah nomor project project Cloud Anda.
- REGION adalah region yang terkait dengan konfigurasi Pusat Data Bitbucket Anda.
- BITBUCKET_DATA_CENTER_CONFIG_NAME adalah nama konfigurasi Pusat Data Bitbucket Anda.
- PROJECT_KEY adalah kunci dari project Pusat Data
Bitbucket Anda. Jika Anda ingin menghubungkan repositori pribadi, kunci
project Anda harus berisi simbol tilde (
~
) sebelum nama pengguna. Contohnya,~${USERNAME}
. URL lengkap untuk repositori host mirip denganhttps://${HOST_URI}/projects/~${USER_NAME}/repos/${REPO_SLUG}
. - REPO_SLUG adalah slug dari repositori Pusat Data Bitbucket Anda.
Jalankan perintah
curl
berikut di terminal Anda dari direktori yang sama dengan file JSON:
curl -X POST -H "Authorization: Bearer "$(gcloud auth print-access-token) -H "Content-Type: application/json; charset=utf-8" -H "x-goog-user-project: PROJECT_NUMBER" https://cloudbuild.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/bitbucketServerConfigs/BITBUCKET_DATA_CENTER_CONFIG_NAME/connectedRepositories:batchCreate -d @requests.json
Dengan keterangan:
- PROJECT_NUMBER adalah nomor project Google Cloud Anda.
- PROJECT_ID adalah ID project Google Cloud Anda.
- REGION adalah region yang terkait dengan konfigurasi Pusat Data Bitbucket Anda.
- BITBUCKET_DATA_CENTER_CONFIG_NAME adalah nama konfigurasi Pusat Data Bitbucket Anda. Jika berhasil, isi respons memuat instance Operation yang baru dibuat.
Jalankan perintah
curl
berikut di terminal Anda:curl -X GET -H "Authorization: Bearer "$(gcloud auth print-access-token) -H "Content-Type: application/json; charset=utf-8" -H "x-goog-user-project: PROJECT_NUMBER" https://cloudbuild.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID
Dengan keterangan:
- PROJECT_NUMBER adalah nomor project Google Cloud Anda.
- PROJECT_ID adalah ID Google Cloud Anda.
- REGION adalah region yang terkait dengan konfigurasi Pusat Data Bitbucket Anda.
- OPERATION_ID adalah ID operasi pembuatan konfigurasi Pusat Data
Bitbucket Anda. Anda dapat menemukan ID Operasi di kolom
name
pada respons Anda. Format kolomname
dalam respons Anda akan terlihat seperti berikut:projects/project-id/locations/region/operations/operation-id
.
Anda mungkin perlu terus menjalankan perintah API
GetOperation
hingga respons berisidone: true
, yang menunjukkan operasi selesai. Jika repositori Pusat Data Bitbucket berhasil terhubung, Anda dapat melihat repositori yang terhubung di kolomresponse.bitbucketServerConnectedRepositories
. Atau, lihat kolomerror
untuk laporan error mendetail.
Saat repositori terhubung, Cloud Build akan mengonfigurasi webhook di repositori dalam instance Pusat Data Bitbucket Anda. Repositori kemudian akan mengirimkan webhook untuk memanggil pemicu Pusat Data Bitbucket yang sesuai saat Anda membuat perubahan pada repositori. Repositori juga dapat dihubungkan berkali-kali dengan beberapa koneksi {i>host<i}. Untuk mempelajari cara mengelola webhook, lihat Mengelola webhook.
Untuk menemukan webhook, Anda memerlukan ID webhook. ID webhook untuk setiap repositori yang terhubung dapat ditemukan di BitbucketServerConfig
.
Masukkan perintah berikut untuk mengambil ID webhook:
gcloud alpha builds enterprise-config bitbucketserver describe CONFIG_NAME --region=REGION
Dengan keterangan:
- CONFIG_NAME adalah nama konfigurasi Pusat Data Bitbucket
- REGION adalah region koneksi host Bitbucket Data Center
Langkah selanjutnya
- Pelajari cara membangun repositori dari Pusat Data Bitbucket.
- Pelajari cara membangun repositori dari Pusat Data Bitbucket di jaringan pribadi.
- Pelajari cara melakukan blue/green deployment di Compute Engine.