Cloud Build menggunakan pemicu build untuk mengaktifkan otomatisasi CI/CD. Anda dapat mengonfigurasi pemicu untuk memproses peristiwa yang masuk, seperti saat commit baru dikirim ke repositori atau saat permintaan pull dimulai, lalu otomatis menjalankan build saat peristiwa baru masuk. Anda juga dapat mengonfigurasi pemicu untuk mem-build kode berdasarkan setiap perubahan pada repositori sumber atau hanya pada perubahan yang cocok dengan kriteria tertentu.
Halaman ini memberikan ringkasan setiap jenis pemicu dan kemampuan yang terkait dengan pemicu.
Pemicu peristiwa repositori
Cloud Build memungkinkan Anda menjalankan build secara otomatis pada peristiwa repositori seperti push atau permintaan pull. Anda dapat menghubungkan repositori eksternal, seperti repositori di GitHub atau Bitbucket, ke Cloud Build atau menggunakan kode di Cloud Source Repositories untuk build Anda. Meskipun Anda dapat menghubungkan repositori sumber apa pun ke Cloud Build, Cloud Build menyediakan pemicu peristiwa repositori tertentu yang dapat Anda gunakan untuk mengintegrasikan sistem pengelolaan kode sumber (SCM) tertentu. Bagian ini membahas pemicu peristiwa repositori yang tersedia.
Pemicu GitHub
Anda dapat membuat pemicu GitHub untuk otomatis menjalankan build sebagai respons terhadap peristiwa repositori, seperti push atau permintaan pull. Anda dapat melihat status build pemicu di GitHub dan konsol Google Cloud . Anda juga dapat menggunakan aplikasi GitHub Cloud Build untuk menghubungkan dan membangun kode di GitHub. Untuk mempelajari lebih lanjut, lihat Membangun repositori dari GitHub.
Pemicu GitHub Enterprise
Anda dapat membuat pemicu untuk repositori yang dihosting di instance GitHub Enterprise, termasuk instance yang dihosting di lingkungan lokal dan tidak dapat dijangkau melalui koneksi internet publik. Pemicu GitHub Enterprise dapat digunakan untuk menjalankan build sebagai respons terhadap push atau permintaan pull dari instance GitHub Enterprise. Untuk mempelajari lebih lanjut, lihat Membangun repositori dari GitHub Enterprise.
Pemicu GitLab Enterprise Edition
Anda dapat membuat pemicu untuk repositori yang dihosting di instance GitLab Enterprise Edition, termasuk instance yang dihosting di jaringan pribadi. Pemicu GitLab Enterprise Edition dapat digunakan untuk menjalankan build sebagai respons terhadap push commit atau permintaan pull yang terkait dengan repositori GitLab Enterprise Edition Anda. Untuk mempelajari lebih lanjut, lihat Membangun repositori dari GitLab Enterprise Edition.
Pemicu Bitbucket Server
Anda dapat membuat pemicu untuk repositori yang dihosting di instance Bitbucket Server, termasuk instance yang dihosting di lingkungan lokal. Anda dapat menghubungkan repositori Bitbucket Server ke Cloud Build beberapa kali dengan beberapa koneksi host. Untuk mempelajari lebih lanjut cara membuat pemicu untuk menjalankan build sebagai respons terhadap peristiwa, lihat Membangun repositori dari Bitbucket Server.
Pemicu Bitbucket Data Center
Anda dapat membuat pemicu untuk repositori yang dihosting di instance Bitbucket Data Center, termasuk instance yang dihosting di lingkungan lokal. Pemicu Bitbucket Data Center dapat digunakan untuk menjalankan build sebagai respons terhadap peristiwa seperti push commit atau permintaan pull. Untuk mempelajari lebih lanjut, lihat Membangun repositori dari Pusat Data Bitbucket.
Pemicu Bitbucket Cloud
Anda dapat membuat pemicu untuk repositori yang dihosting di Bitbucket Cloud. Pemicu Bitbucket Cloud dapat digunakan untuk menjalankan build sebagai respons terhadap peristiwa seperti push commit atau permintaan pull. Untuk mempelajari lebih lanjut, lihat Membangun repositori dari Bitbucket Cloud.
Pemicu Secure Source Manager
Anda dapat membuat pemicu untuk repositori yang dihosting di Secure Source Manager. Pemicu Secure Source Manager dapat digunakan untuk menjalankan build sebagai respons terhadap peristiwa seperti push commit atau permintaan pull. Untuk mempelajari lebih lanjut, lihat Membuat file pemicu di Secure Source Manager.
Pemicu manual
Anda dapat membuat pemicu manual untuk mengeksekusi build secara manual dan mengganti nilai variabel substitusi yang ditentukan pada waktu pemanggilan sebelum mengeksekusi build. Anda juga dapat mengonfigurasi pemicu manual untuk berjalan sesuai jadwal. Untuk mempelajari lebih lanjut, lihat Membangun kode secara manual di repositori sumber.
Pemicu Pub/Sub
Anda dapat membuat pemicu Pub/Sub untuk menjalankan build sebagai respons terhadap pesan apa pun yang dipublikasikan melalui Pub/Sub. Misalnya, Anda dapat menggunakan pemicu Pub/Sub untuk membangun sebagai respons terhadap pengiriman image ke Artifact Registry. Dalam hal ini, Anda dapat mengonfigurasi pemicu untuk menggunakan filter guna
menjalankan build hanya jika image yang dikirim cocok dengan tag tertentu, seperti prod.
Selain itu, pemicu Pub/Sub dapat dikonfigurasi untuk berlangganan ke topik Pub/Sub apa pun. Untuk mempelajari lebih lanjut, lihat
Mengotomatiskan build sebagai respons terhadap peristiwa Pub/Sub.
Pemicu webhook
Anda dapat membuat pemicu webhook untuk menjalankan build sebagai respons terhadap webhook. Peristiwa webhook yang dikirim ke URL kustom memungkinkan Anda menghubungkan sistem eksternal dan sistem pengelolaan kode sumber (SCM) eksternal, seperti Bitbucket.com, Bitbucket Server, atau GitLab, langsung ke Cloud Build. Saat membuat pemicu webhook, Anda juga dapat menentukan konfigurasi build secara inline pada pemicu untuk mengontrol repositori mana yang di-clone pemicu selama waktu build, bukan menentukan sumber secara eksplisit. Untuk mempelajari lebih lanjut, lihat Mengotomatiskan build sebagai respons terhadap peristiwa webhook. Selain itu, untuk mempelajari cara menggunakan pemicu webhook untuk membangun repositori dari SCM tertentu, lihat Membangun repositori dari Bitbucket Server, Membangun repositori dari Bitbucket Cloud, dan Membangun repositori dari GitLab.
Pemicu untuk repositori yang ditautkan ke Developer Connect
Developer Connect memungkinkan Anda menghubungkan produk eksternal atau alat developer non-Google ke Google Cloud menggunakan langkah-langkah dan aplikasi standar. Anda dapat mengonfigurasi pemicu yang di-build dari repositori yang terhubung melalui Developer Connect untuk SCM berikut:
- Bitbucket Cloud
- Bitbucket Data Center
- Bitbucket Server
- GitHub
- GitHub Enterprise
- GitLab
- Gitlab Enterprise Edition
Kemampuan pemicu
Pemicu Cloud Build menyediakan kemampuan yang memberi Anda kontrol terperinci atas cara build dijalankan. Bagian ini membahas berbagai kemampuan yang terkait dengan pemicu.
Pemicu manual terjadwal
Anda dapat menjadwalkan pemicu manual untuk otomatis menjalankan build sesuai jadwal yang telah ditentukan. Misalnya, Anda mungkin ingin mengonfigurasi pemicu terjadwal untuk menjalankan build setiap hari Sabtu pukul 06.00. Untuk menjadwalkan build, Anda dapat membuat pemicu manual dan memanggil pemicu menggunakan Cloud Scheduler. Untuk mempelajari lebih lanjut, lihat Menjadwalkan build.
Memfilter peristiwa
Cloud Build menggunakan
Common Expression Language (CEL) dengan
variabel, build, pada kolom yang tercantum dalam
resource Build untuk mengakses
kolom yang terkait dengan peristiwa build Anda, seperti ID pemicu, daftar image, atau
nilai pengganti. Anda dapat menggunakan string filter untuk memfilter peristiwa build dalam file konfigurasi build menggunakan kolom apa pun yang tercantum dalam resource Build. Untuk mempelajari lebih lanjut, lihat Menggunakan CEL untuk memfilter peristiwa build
Variabel substitusi
Anda dapat menentukan variabel substitusi dalam file konfigurasi build untuk mengganti nilai tertentu pada waktu build. Misalnya, Anda mungkin ingin menggunakan variabel substitusi jika nilai tidak diketahui hingga waktu build atau jika Anda ingin menggunakan kembali permintaan build yang ada dengan variabel yang berbeda. Cloud Build menyediakan substitusi default yang dapat Anda gunakan untuk build yang dipanggil oleh pemicu, seperti variabel yang dipetakan ke nama pemicu atau nama repositori Anda. Anda juga dapat menentukan variabel substitusi Anda sendiri. Untuk mempelajari lebih lanjut, lihat Mengganti nilai variabel.
Ekspansi parameter Bash
Anda dapat menerapkan ekspansi parameter bash ke nilai variabel substitusi. Perluasan parameter Bash memungkinkan Anda memanipulasi string yang terkait dengan variabel yang ada. Misalnya, Anda dapat menggunakan ekspansi parameter bash untuk menggunakan huruf kapital atau mengganti substring. Untuk mempelajari lebih lanjut, lihat Perluasan parameter Bash.
Binding payload
Anda dapat menyimpan bagian dari payload peristiwa pemicu sebagai variabel substitusi menggunakan binding payload. Variabel yang terkait dengan payload disebut sebagai binding dan tersedia untuk build yang dipanggil oleh peristiwa push dan pull. Anda dapat menggunakan binding untuk mengakses data tambahan yang terkait dengan build Anda, seperti penulis permintaan pull. Untuk mempelajari lebih lanjut, lihat Binding payload.
Persetujuan
Anda dapat mengonfigurasi pemicu agar tidak langsung menjalankan build, tetapi menandai build sebagai tertunda hingga disetujui. Jika pengguna yang memiliki izin menyetujui build yang tertunda, build akan dimulai. Jika persetujuan ditolak, build tidak akan dimulai. Untuk mempelajari cara mengonfigurasi pemicu yang memerlukan persetujuan, lihat Mengatur build berdasarkan persetujuan.
Notifikasi status build
Anda dapat mengonfigurasi notifikasi Cloud Build untuk memproses update peristiwa build dari Pub/Sub pada topik cloud-builds default atau topik yang ditentukan pengguna.
Notifikasi juga dapat memfilter pesan yang diterima oleh topik dan mengirim pesan ke layanan yang terhubung. Cloud Build menyediakan dan mengelola image notifier yang dapat di-deploy di repositori cloud-build-notifiers.
Anda dapat mengonfigurasi notifikasi menggunakan notifier Cloud Build,
seperti BigQuery,
HTTP,
Slack, atau
SMTP atau
membuat notifier Anda sendiri.
Akun layanan untuk pemicu build
Saat pemicu memanggil build, Cloud Build menjalankan langkah-langkah build menggunakan akun layanan. Bergantung pada konfigurasi pemicu dan setelan kebijakan organisasi project Anda, build yang dipanggil oleh pemicu dapat menggunakan salah satu akun layanan berikut:
- Akun layanan yang ditentukan pengguna
(
ACCOUNT_NAME@PROJECT_ID.): Direkomendasikan. Anda membuat dan mengelola akun layanan ini dan hanya memberikan izin Identity and Access Management (IAM) yang diperlukan untuk build pemicu. - Akun layanan default Compute Engine
(
PROJECT_NUMBER-compute@): Akun layanan build default untuk project yang menjalankan build pertamanya setelah perubahan akun layanan default, kecuali jika dibatasi oleh kebijakan organisasi. Dalam project ini, Anda harus secara eksplisit memilih akun layanan (baik akun layanan yang ditentukan pengguna atau akun layanan default Compute Engine) saat membuat atau mengupdate pemicu. - Akun layanan Cloud Build lama
(
PROJECT_NUMBER@cloudbuild.): Digunakan sebagai akun layanan build default dalam project yang menjalankan build sebelum perubahan akun layanan default atau dalam organisasi yang memilih tidak ikut perubahan. Dalam project ini, jika kolomserviceAccountpemicu tidak ditentukan, pemicu akan ditetapkan secara default untuk menggunakan akun layanan Cloud Build lama.
Sebelum memberikan peran IAM untuk langkah-langkah build pemicu, verifikasi akun layanan mana yang dikonfigurasi pada pemicu. Untuk mengetahui petunjuknya, lihat Mengidentifikasi akun layanan yang akan dikonfigurasi.
Langkah berikutnya
- Pelajari cara membuat dan mengelola pemicu build.
- Pelajari cara mengonfigurasi akun layanan yang ditentukan pengguna.