Membangun repositori dari Cloud Bitbucket

Dengan Cloud Build, Anda dapat membuat pemicu untuk mem-build dari repositori yang dihosting di Bitbucket Cloud sehingga Anda dapat menjalankan build sebagai respons terhadap peristiwa seperti push commit atau permintaan penggabungan yang terkait dengan repositori Cloud Bitbucket Anda.

Halaman ini menjelaskan cara mengaktifkan fungsi pemicu pada instance Bitbucket Cloud. Pelajari pemicu Cloud Build dan repositori Cloud Build lebih lanjut.

Sebelum memulai

  • Enable the Cloud Build and Secret Manager APIs.

    Enable the APIs

Membuat pemicu Bitbucket Cloud

Buat pemicu Bitbucket Cloud menggunakan langkah-langkah berikut:

Konsol

  1. Buka halaman Pemicu:

    Buka halaman Pemicu

  2. Pilih project Google Cloud Anda, lalu klik Open.

  3. Klik Create trigger.

  4. Masukkan setelan pemicu berikut:

    • Nama: Nama untuk pemicu Anda.

    • Region: Pilih wilayah untuk pemicu Anda.

      • Jika file konfigurasi build yang terkait dengan pemicu menentukan kumpulan pribadi, Cloud Build akan menggunakan kumpulan pribadi untuk menjalankan build Anda. Dalam hal ini, region yang Anda tentukan dalam pemicu harus cocok dengan region tempat Anda membuat kumpulan pribadi.
      • Jika file konfigurasi build yang terkait dengan pemicu tidak menentukan kumpulan pribadi, Cloud Build akan menggunakan kumpulan default untuk menjalankan build di region yang sama dengan pemicu.

    • Deskripsi (Opsional): Deskripsi untuk pemicu Anda.

    • Peristiwa: Pilih peristiwa repositori untuk memanggil pemicu Anda.

      • Push ke cabang: Tetapkan pemicu untuk memulai build pada commit ke cabang tertentu.

      • Push tag baru: Tetapkan pemicu untuk memulai build pada commit yang berisi tag tertentu.

      • Permintaan pull: Tetapkan pemicu untuk memulai build pada commit untuk permintaan pull.

    • Sumber: Pilih generasi ke-2 sebagai sumber Anda.

      • Repository: Dari daftar repositori yang tersedia, pilih repositori. Untuk menghubungkan repositori baru, lihat Menghubungkan ke repositori Cloud Bitbucket.

      • Branch atau Tag: Tentukan ekspresi reguler dengan nilai cabang atau tag yang akan dicocokkan. Untuk mengetahui informasi mengenai sintaksis ekspresi reguler yang dapat diterima, lihat sintaksis RE2.

      • Kontrol komentar: Jika Anda memilih Permintaan pull sebagai Peristiwa, pilih salah satu opsi berikut untuk mengontrol apakah build otomatis dijalankan oleh pemicu:

        • Wajib kecuali untuk pemilik dan kolaborator: Saat permintaan pull dibuat atau diupdate oleh pemilik repositori atau kolaborator, build akan otomatis dijalankan oleh pemicu. Jika kontributor eksternal memulai tindakan, build hanya akan dijalankan setelah pemilik atau kolaborator mengomentari /gcbrun pada permintaan pull.

        • Wajib: Saat permintaan pull dibuat atau diperbarui oleh kontributor, build hanya akan dijalankan setelah pemilik atau kolaborator memberi komentar /gcbrun pada permintaan pull. Build dijalankan setiap kali perubahan pada permintaan pull dibuat.

        • Tidak diperlukan: Saat permintaan pull dibuat atau diupdate oleh kontributor, build akan otomatis dijalankan oleh pemicu.

    • Konfigurasi: Pilih file konfigurasi build yang berada di repositori atau konfigurasi build Anda secara inline pada pemicu.

    • Type: Pilih jenis konfigurasi yang akan digunakan untuk build Anda.

      • File konfigurasi Cloud Build (yaml atau json): Menggunakan file konfigurasi build untuk konfigurasi Anda.
      • Dockerfile: Gunakan Dockerfile untuk konfigurasi Anda.

    • Lokasi: Menentukan lokasi untuk konfigurasi Anda.

      • Repositori: Jika file konfigurasi Anda berada di repositori Anda, berikan lokasi file konfigurasi build atau direktori Dockerfile dan nama untuk image yang dihasilkan. Jika konfigurasi Anda adalah Dockerfile, Anda juga dapat menyediakan waktu tunggu untuk build. Setelah memberikan nama Dockerfile dan image, Anda akan melihat pratinjau perintah docker build untuk build Anda.

      • Inline: Jika memilih Cloud Build configuration file (yaml atau json) sebagai opsi konfigurasi, Anda dapat menentukan konfigurasi build secara inline. Klik Open Editor untuk menulis file konfigurasi build di Google Cloud Console menggunakan sintaksis YAML atau JSON. Klik Done untuk menyimpan konfigurasi build Anda.

  5. Klik Create untuk membuat pemicu Bitbucket Cloud Anda.

gcloud

Buat pemicu peristiwa push repositori menggunakan perintah berikut:

gcloud builds triggers create bitbucket-cloud \
    --name=TRIGGER_NAME \
    --repository=\
    projects/PROJECT_ID/locations/REGION/connections/CONNECTION_NAME/repositories/REPO_NAME \
    --branch-pattern=".*" --build-config="CONFIG_NAME" \
    --region=REGION

Dengan keterangan:

  • TRIGGER-NAME adalah nama yang ingin Anda berikan ke pemicu build.
  • PROJECT_ID adalah ID project Google Cloud Anda.
  • REGION adalah region untuk pemicu Anda.
  • CONNECTION_NAME adalah nama koneksi host Anda.
  • REPO_NAME adalah nama repositori Anda yang terhubung di Bitbucket Cloud.
  • CONFIG_NAME adalah nama file skema konfigurasi Anda.

Setelah pemicu dibuat, Cloud Build akan memproses semua peristiwa push di semua cabang. Saat Anda mengirim commit apa pun ke repositori, pemicu akan dipanggil. Anda dapat melihat hasil build di halaman Build history.

Berbagi data

Data yang dikirim ke Bitbucket Cloud dari Cloud Build membantu Anda mengidentifikasi pemicu berdasarkan nama dan melihat hasil build di repositori Bitbucket Cloud Anda.

Data berikut dibagikan antara Cloud Build dan host Bitbucket Cloud Anda:

  • ID project Google Cloud
  • Trigger name

Langkah selanjutnya