Membuat file pemicu

Halaman ini menjelaskan langkah-langkah untuk membuat file YAML pemicu di Secure Source Manager. File pemicu dapat digunakan untuk mengotomatiskan build berdasarkan peristiwa permintaan push dan pull di repositori Secure Source Manager.

Untuk mempelajari kolom yang dapat Anda sertakan dalam file pemicu, baca Skema file pemicu.

Sebelum memulai

  1. Buat instance Secure Source Manager.
  2. Buat repositori Secure Source Manager.
  3. Baca Skema file pemicu untuk mempelajari kolom yang dapat Anda sertakan dalam file pemicu.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk membuat file pemicu, minta administrator untuk memberi Anda peran IAM berikut:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Membuat file konfigurasi Cloud Build

File pemicu Secure Source Manager mengharuskan Anda menentukan file konfigurasi build untuk setiap pemicu.

File konfigurasi build berisi petunjuk untuk Cloud Build dalam menjalankan tugas berdasarkan spesifikasi Anda. Misalnya, file konfigurasi build dapat berisi petunjuk untuk mem-build, mengemas, dan mengirim image Docker.

Buat file konfigurasi build di cabang tempat Anda ingin melakukan build. Untuk membuat file konfigurasi build, ikuti petunjuk di Membuat file konfigurasi build.

Membuat file pemicu

\File konfigurasi pemicu harus dibuat di cabang default repositori Anda.

Untuk membuat file konfigurasi pemicu:

  1. Di repositori lokal atau antarmuka web Secure Source Manager, beralihlah ke cabang default.

  2. Buat file bernama .cloudbuild/triggers.yaml.

  3. Konfigurasi pemicu Anda di file .cloudbuild/triggers.yaml:

    triggers:
- name: TRIGGER_NAME
  project: PROJECT_ID
  configFilePath: CLOUD_BUILD_CONFIG_PATH
  eventType: EVENT_TYPE
  ignoredGitRefs: IGNORED_GIT_REFS
  includedGitRefs: INCLUDED_GIT_REFS
  serviceAccount: SERVICE_ACCOUNT
  includedFiles: INCLUDED_FILES
  ignoredFiles: IGNORED_FILES
  disabled: DISABLED_BOOL
  substitutions:
    _VARIABLE_NAME: VARIABLE_VALUE
    OVERRIDE_VARIABLE_NAME: OVERRIDE_VARIABLE_VALUE

    Ganti kode berikut:

    • TRIGGER_NAME dengan nama untuk pemicu Anda. Nama pemicu hanya boleh berisi karakter alfanumerik dan tanda pisah, serta tidak boleh diawali atau diakhiri dengan tanda pisah. Nama pemicu harus kurang dari 64 karakter.
    • PROJECT_ID dengan Google Cloud project ID tempat Anda mengaktifkan Cloud Build. Kolom ini bersifat opsional. Defaultnya adalah project Secure Source Manager.
    • CLOUD_BUILD_CONFIG_PATH dengan jalur ke file konfigurasi Cloud Build yang ingin Anda gunakan untuk pemicu ini. Kolom ini bersifat opsional. Nilai defaultnya adalah .cloudbuild/cloudbuild.yaml

    • EVENT_TYPE dengan jenis peristiwa yang ingin Anda gunakan untuk memicu build. Opsi yang tersedia adalah sebagai berikut:

      • push untuk memicu push ke cabang yang ditentukan
      • pull_request untuk memicu permintaan pull ke cabang yang ditentukan

      Kolom ini bersifat opsional. Nilai defaultnya adalah push.

    • INCLUDED_GIT_REFS dengan format ekspresi reguler RE2 opsional yang cocok dengan referensi Git yang ingin Anda gunakan untuk memicu build. Nilai defaultnya kosong. Nilai kosong menunjukkan tidak ada batasan.

    • IGNORED_GIT_REFS dengan ekspresi reguler opsional menggunakan format ekspresi reguler RE2 yang cocok dengan referensi Git yang tidak ingin Anda gunakan untuk memicu build. Nilai defaultnya kosong. Nilai kosong menunjukkan tidak ada batasan. Kolom ignoredGitRefs diperiksa sebelum kolom includedGitRefs. Untuk mengetahui informasi selengkapnya tentang kolom ini, lihat Skema file pemicu.

    • SERVICE_ACCOUNT dengan akun layanan Cloud Build yang akan digunakan untuk build dalam format projects/PROJECT_ID/serviceAccounts/ACCOUNT. Ganti ACCOUNT dengan alamat email atau ID unik akun layanan. Sebagai praktik terbaik, konfigurasikan akun layanan yang ditentukan pengguna. Akun layanan Cloud Build lama tidak dapat digunakan karena keterbatasannya .

    • INCLUDED_FILES dengan ekspresi reguler format RE2 opsional yang cocok dengan file yang ingin Anda gunakan untuk memicu build.

      Jika salah satu file yang diubah tidak cocok dengan kolom filter ignoredFiles, dan file yang diubah cocok dengan kolom filter includedFiles, build akan dipicu. Nilai defaultnya kosong. Nilai kosong menunjukkan tidak ada batasan.

    • IGNORED_FILES dengan ekspresi reguler format RE2 opsional yang cocok dengan file yang tidak ingin Anda gunakan untuk memicu build.

      Jika semua file yang diubah dalam commit cocok dengan kolom filter ini, build tidak akan dipicu. Nilai defaultnya kosong. Nilai kosong menunjukkan tidak ada batasan.

    • DISABLED_BOOL dengan true untuk menonaktifkan pemicu, atau false untuk mengaktifkan pemicu. Kolom ini bersifat opsional. Nilai defaultnya adalah false.

    • VARIABLE_NAME dengan nama variabel yang ingin Anda perkenalkan dalam file pemicu.

    • VARIABLE_VALUE dengan nilai variabel.

    • OVERRIDE_VARIABLE_NAME dengan nama variabel penggantian default Secure Source Manager. Untuk mengetahui informasi tentang variabel penggantian default yang tersedia, lihat bagian penggantian di Skema file pemicu.

    • OVERRIDE_VARIABLE_VALUE dengan nilai yang ingin Anda gunakan untuk mengganti nilai default untuk variabel penggantian default.

  4. Commit file konfigurasi pemicu ke cabang default Anda.

    Setelah file pemicu di-commit, Secure Source Manager akan memicu build berdasarkan konfigurasi dalam file pemicu Anda.

    Secure Source Manager membaca file konfigurasi dan SHA commit atau referensi Git terkait dari jenis peristiwa berikut:

    • Untuk peristiwa push, Secure Source Manager akan membaca SHA commit atau referensi Git saat push selesai.
    • Untuk peristiwa pull_request, Secure Source Manager akan membaca SHA commit atau referensi Git saat perubahan permintaan pull ditarik.

Melihat status build

Saat build dipicu oleh peristiwa permintaan push atau pull, status commit dan build akan ditampilkan di antarmuka web Secure Source Manager.

Nilai yang mungkin untuk status build adalah sebagai berikut:

  • berhasilSUCCESS: build berhasil diselesaikan.
  • peringatanWARNING: terjadi masalah saat mencoba melakukan build.
  • gagalFAILURE: build gagal selama eksekusi.

Anda dapat mencegah commit dengan build yang gagal digabungkan ke cabang penting jika mengonfigurasi aturan perlindungan cabang untuk mewajibkan pemeriksaan status berhasil dari pemicu yang dikonfigurasi dalam file pemicu. Untuk mempelajari lebih lanjut tentang perlindungan cabang, baca Ringkasan perlindungan cabang.

Untuk melihat status build untuk peristiwa push:

  1. Di antarmuka web Secure Source Manager, buka repositori Anda.

    Jika peristiwa push terbaru memicu build, status akan ditampilkan di samping SHA commit. Untuk melihat detail status tersebut, klik status.

  2. Untuk melihat status build untuk commit sebelumnya, pilih Commits untuk melihat histori commit, lalu klik status yang detailnya ingin Anda lihat.

Untuk melihat status build untuk peristiwa permintaan pull:

  1. Di antarmuka web Secure Source Manager, klik Pull requests.

  2. Klik permintaan pull yang ingin Anda lihat.

    Jika build dipicu oleh permintaan pull, Anda akan melihat bagian yang berjudul baik Semua pemeriksaan berhasil, atau Beberapa pemeriksaan melaporkan peringatan.

Langkah berikutnya