Membangun kode secara manual di repositori sumber

Halaman ini menjelaskan cara membuat pemicu manual untuk membuat kode di repositori sumber. Pemicu manual dapat digunakan untuk memanggil build secara manual, dengan kemampuan untuk mengganti nilai variabel substitusi yang ditentukan pada waktu pemanggilan sebelum menjalankan build. Anda juga dapat menjadwalkan pemicu manual agar otomatis berjalan pada waktu tertentu.

Untuk mempelajari cara memulai build secara manual menggunakan gcloud CLI atau Cloud Build API, lihat Memulai build secara manual.

Sebelum memulai

Aktifkan API Cloud Build.
Mengaktifkan API

Siapkan kode sumber Anda.

Pemicu manual

Dengan pemicu manual, Anda dapat menyiapkan build yang hanya dijalankan saat Anda memanggil pemicu pada repositori yang terhubung. Katakanlah Anda sedang membuat pipeline untuk men-deploy kode sumber ke lingkungan staging atau produksi. Anda mungkin ingin mengotomatiskan alur kerja, tetapi hanya ingin menjalankan build secara manual. Anda dapat menentukan pemicu manual untuk melakukannya.

Pemicu manual memungkinkan Anda memanggil build secara manual dengan:

Mengambil kode sumber dari repositori yang dihosting dengan cabang atau tag yang ditentukan.
Membuat parameter build dengan substitusi yang tidak perlu diteruskan secara manual setiap kali Anda menjalankan build.
Mengganti nilai variabel substitusi yang ditentukan pada waktu pemanggilan sebelum memanggil build.

Jika Anda ingin menjalankan build dari direktori kerja lokal, bukan repositori yang dihosting, atau ingin mengirimkan build tanpa membuat pemicu, Anda dapat menjalankan perintah gcloud berikut di direktori kerja:

gcloud builds submit --config BUILD_CONFIG SOURCE_CODE

Dengan keterangan:

BUILD_CONFIG adalah jalur ke file konfigurasi build.
SOURCE_CODE adalah kode sumber jalur atau URL.

Untuk mempelajari lebih lanjut cara menggunakan perintah gcloud untuk memulai build secara manual di direktori lokal, lihat Memulai build secara manual.

Membuat pemicu manual

Konsol

Untuk membuat pemicu manual:

Buka halaman Pemicu:

Buka halaman Pemicu
Pilih project Anda dari bagian atas halaman, lalu klik Open.
Klik Create trigger.
Masukkan setelan pemicu berikut:
- Nama: Nama pemicu Anda.
- Region: Pilih wilayah untuk pemicu Anda.
  - Jika Anda memilih global sebagai region, Cloud Build akan menggunakan kumpulan default untuk menjalankan build.
  - Jika Anda memilih region non-global dan 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 Anda memilih region non-global dan file konfigurasi build yang terkait dengan pemicu tidak menentukan kumpulan pribadi, Cloud Build akan menggunakan kumpulan default untuk menjalankan build Anda di region yang sama dengan pemicu Anda.
- Deskripsi (Opsional): Deskripsi untuk pemicu Anda.
- Peristiwa: Pilih Panggilan manual untuk menyiapkan pemicu sehingga build hanya berjalan saat pemicu dipanggil secara manual.
- Sumber: Pilih repositori yang akan di-build saat pemicu manual berjalan. Anda dapat menentukan generasi ke-1 atau generasi ke-2 sebagai sumber.
  
  Catatan: Region repositori Anda harus cocok dengan region pemicu Anda. Jika sumber Anda adalah Cloud Source Repository, repositori Anda tidak terhubung ke region tertentu, tetapi ke project Anda.
- Revisi: Pilih cabang atau tag yang akan di-build saat pemicu manual berjalan.
- Branch: Menetapkan pemicu untuk mem-build di cabang ini. Anda harus menetapkan nilai literal. Ekspresi reguler saat ini tidak didukung.
- Tag: Tetapkan pemicu untuk membuat tag ini. Anda harus menentukan nilai literal. Ekspresi reguler saat ini tidak didukung.
- Konfigurasi: Pilih file konfigurasi build yang berada di repositori jarak jauh atau buat file konfigurasi build inline untuk digunakan pada build Anda.
  - Type: Pilih jenis konfigurasi yang akan digunakan untuk build Anda.
    - Cloud Build configuration file (yaml atau json): Menggunakan file konfigurasi build untuk konfigurasi Anda.
    - Dockerfile: Gunakan Dockerfile untuk konfigurasi Anda.
  - Location: Menentukan lokasi untuk konfigurasi Anda.
    - Repositori: Jika file konfigurasi Anda berada di repositori jarak jauh, berikan lokasi file konfigurasi build, direktori Dockerfile, atau direktori buildpacks. Jika jenis konfigurasi build adalah Dockerfile atau buildpack, Anda harus memberi nama untuk image yang dihasilkan dan, jika perlu, waktu tunggu untuk build. Setelah memberikan nama image Dockerfile atau buildpack, Anda akan melihat pratinjau perintah docker build atau pack yang akan dijalankan 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 konsol Google Cloud menggunakan sintaksis YAML atau JSON. Klik Done untuk menyimpan konfigurasi build Anda.
    Catatan: Dukungan konfigurasi build inline tidak tersedia untuk Dockerfile.
Klik Buat untuk membuat pemicu manual.

gcloud

Untuk mengetahui daftar lengkap tanda, lihat referensi gcloud untuk mengetahui cara membuat pemicu manual.

Menjalankan pemicu manual

Konsol

Untuk menjalankan pemicu manual menggunakan Konsol Google Cloud:

Buka halaman Pemicu di Konsol Google Cloud.

Buka halaman pemicu
Temukan pemicu Anda dalam daftar.
Klik Run trigger.

Setelah mengklik Run trigger, Anda akan melihat panel jendela Run trigger di sisi kanan. Jika menentukan kolom seperti nama cabang, nama tag, atau variabel substitusi, Anda dapat mengganti kolom ini pada waktu pemanggilan.

Catatan: Anda tidak dapat menentukan kolom atau variabel baru di panel jendela ini. Untuk melakukannya, lihat petunjuk di tab gcloud di bagian ini.

Jika Anda menentukan nilai variabel baru untuk substitusi, klik Run trigger untuk menjalankan build.

Untuk menjalankan pemicu manual sesuai jadwal, lihat Menjadwalkan build.

gcloud

Untuk menjalankan pemicu manual menggunakan alat command line gcloud, jalankan perintah berikut:

      gcloud builds triggers run TRIGGER_NAME \
         --region=REGION \
         --branch=BRANCH_NAME \
         --substitutions=SUBSTITUTION_VAR=SUBSTITUTION_VALUE

Dengan keterangan:

TRIGGER_NAME adalah nama pemicu Anda.
REGION adalah region untuk pemicu Anda.
BRANCH_NAME adalah nama cabang Anda. Anda juga dapat menentukan tag menggunakan --tag atau ID commit menggunakan --sha.
[Opsional]SUBSTITUTION_VAR adalah nama variabel untuk nilai substitusi Anda.
[Opsional] SUBSTITUTION_VALUE adalah nilai yang terkait dengan variabel substitusi Anda.

Untuk menjalankan pemicu manual sesuai jadwal, lihat Menjadwalkan build.

Langkah berikutnya

Pelajari cara memulai build secara manual menggunakan perintah gcloud atau Cloud Build API.
Pelajari cara menjadwalkan build.
Pelajari cara membuat dan mengelola pemicu.
Pelajari cara melihat hasil build.
Pelajari cara memecahkan masalah error build.