Membangun kode secara manual di repositori sumber

generasi ke-1 generasi ke-2

Halaman ini menjelaskan cara membuat pemicu manual untuk mem-build kode di repositori sumber. Pemicu manual dapat digunakan untuk memanggil build secara manual, dengan kemampuan untuk mengganti nilai variabel penggantian 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

• Enable the Cloud Build API.

  Enable the API

• Siapkan kode sumber Anda.

Pemicu manual

Pemicu manual memungkinkan Anda menyiapkan build yang hanya dieksekusi saat Anda memanggil pemicu di repositori yang terhubung. Misalnya, Anda 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 penggantian yang tidak perlu diteruskan secara manual setiap kali Anda menjalankan build.
• Mengganti nilai variabel penggantian yang ditentukan pada waktu pemanggilan sebelum memanggil build.

Jika 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 guna memulai build secara manual di direktori lokal, lihat Memulai build secara manual.

Membuat pemicu manual

Konsol

Untuk membuat pemicu manual:

1. Buka halaman Pemicu:

   Buka halaman Pemicu

2. Pilih project Anda dari bagian atas halaman, lalu klik Buka.

3. Klik Create trigger.

4. Masukkan setelan pemicu berikut:

   • Nama: Nama untuk pemicu Anda.

   • Region: Pilih region untuk pemicu Anda.

     • Jika Anda memilih global sebagai region, Cloud Build akan menggunakan kumpulan default untuk menjalankan build Anda.
     • 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 di 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 di region yang sama dengan pemicu Anda.

   • Deskripsi (Opsional): Deskripsi untuk pemicu Anda.

   • Peristiwa: Pilih Pemanggilan 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. Jika sumber Anda berada di Cloud Source Repositories, repositori Anda tidak terhubung ke region tertentu, tetapi ke project Anda.

     Perhatian: Mulai 17 Juni 2024, Cloud Source Repositories tidak tersedia untuk pelanggan baru. Jika organisasi Anda belum pernah menggunakan Cloud Source Repositories, Anda tidak dapat mengaktifkan API atau menggunakan Cloud Source Repositories. Project baru yang tidak terhubung ke organisasi tidak dapat mengaktifkan Cloud Source Repositories API. Organisasi yang telah menggunakan Repositori Sumber Cloud sebelum 17 Juni 2024 tidak akan terpengaruh oleh perubahan ini.

   • Revisi: Pilih cabang atau tag yang akan di-build saat pemicu manual berjalan.

   • Cabang: Menetapkan pemicu untuk mem-build di cabang ini. Anda harus menentukan 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 Anda atau buat file konfigurasi build inline untuk digunakan dalam build Anda.

     • Type: Pilih jenis konfigurasi yang akan digunakan untuk build Anda.
       • File konfigurasi Cloud Build (yaml atau json): Gunakan file konfigurasi build untuk konfigurasi Anda.
       • Dockerfile: Gunakan Dockerfile untuk konfigurasi Anda.

     • Lokasi: Tentukan lokasi untuk konfigurasi Anda.

       • Repositori: Jika file konfigurasi Anda berada di repositori jarak jauh, berikan lokasi file konfigurasi build, direktori Dockerfile, atau direktori buildpack. Jika jenis konfigurasi build Anda adalah Dockerfile atau buildpack, Anda harus memberikan nama untuk gambar yang dihasilkan dan, secara opsional, waktu tunggu untuk build Anda. Setelah memberikan nama image Dockerfile atau buildpack, Anda akan melihat pratinjau perintah docker build atau pack yang akan dieksekusi build Anda.
       • Inline: Jika memilih File konfigurasi Cloud Build (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.

5. Klik Create untuk membuat pemicu manual.

gcloud

Untuk mengetahui daftar lengkap flag, lihat referensi gcloud tentang cara membuat pemicu manual.

Menjalankan pemicu manual

Konsol

Untuk menjalankan pemicu manual menggunakan konsol Google Cloud:

1. Buka halaman Pemicu di konsol Google Cloud.

   Buka halaman pemicu

2. Temukan pemicu Anda dalam daftar.

3. Klik Jalankan pemicu.

   Setelah mengklik Jalankan pemicu, Anda akan melihat panel jendela Jalankan pemicu di sebelah kanan. Jika menentukan kolom seperti nama cabang, nama tag, atau variabel penggantian, Anda akan 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 penggantian, 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 penggantian Anda.
• [Opsional] SUBSTITUTION_VALUE adalah nilai yang terkait dengan variabel penggantian 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.