Membangun kode secara manual di repositori sumber

generasi ke-1 generasi ke-2

Halaman ini menjelaskan cara membuat pemicu manual untuk membangun 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 berjalan secara otomatis 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 Cloud Build API, jika belum diaktifkan.

  Peran yang diperlukan untuk mengaktifkan API

  Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Admin Penggunaan Layanan (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.

  Mengaktifkan 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 lingkungan 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 pengganti yang ditentukan pada waktu pemanggilan sebelum memanggil build.

Jika ingin menjalankan build dari direktori kerja lokal, bukan dari 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:

• 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:

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:

   • Name: Nama untuk pemicu Anda.

   • Region: Pilih region untuk pemicu Anda.

     • Jika Anda memilih global sebagai region, Cloud Build akan menggunakan pool 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 pool pribadi.
     • Jika Anda memilih region non-global dan file konfigurasi build yang terkait dengan pemicu tidak menentukan kumpulan pribadi, Cloud Build menggunakan kumpulan default untuk menjalankan build Anda di region yang sama dengan pemicu Anda.

   • Deskripsi (Opsional): Deskripsi untuk pemicu Anda.

   • Peristiwa: Pilih Pemanggilan manual untuk menyiapkan pemicu agar build hanya berjalan saat pemicu dipanggil secara manual.

   • Sumber: Pilih repositori yang akan dibangun saat pemicu manual berjalan.

     Catatan: Region repositori Anda harus cocok dengan region pemicu Anda. 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 Cloud Source Repositories sebelum 17 Juni 2024 tidak terpengaruh oleh perubahan ini.

   • Pembuatan repositori: Pilih generasi ke-2.

   • Branch atau Tag: Tetapkan salah satu opsi berikut:

     • Cabang: Tetapkan pemicu untuk membangun di cabang ini. Anda harus menentukan nilai literal. Ekspresi reguler tidak didukung.
     • Tag: Tetapkan pemicu untuk membuat tag ini. Anda harus menentukan nilai literal. Ekspresi reguler tidak didukung.

   • Konfigurasi: Pilih file konfigurasi build yang ada di repositori jarak jauh Anda atau buat file konfigurasi build inline untuk digunakan dalam build Anda.

     • Jenis: 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 image 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 dijalankan build Anda.
       • Inline: Jika Anda 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 Selesai untuk menyimpan konfigurasi build Anda.
       Catatan: Dukungan konfigurasi build inline tidak tersedia untuk Dockerfile.

5. Klik Create untuk membuat pemicu manual.

gcloud

Pratinjau — Pemicu manual: Dukungan repositori Cloud Build (generasi ke-2)

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Anda dapat memproses data pribadi untuk fitur ini sebagaimana diuraikan dalam Adendum Pemrosesan Data Cloud, dengan tunduk pada kewajiban dan batasan yang dijelaskan dalam perjanjian yang menjadi dasar Anda mengakses Google Cloud. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Untuk membuat pemicu manual:

1. Buka jendela terminal.

2. Jalankan perintah gcloud berikut untuk membuat pemicu build di project Anda:

   gcloud builds triggers create manual \
     --region=REGION \
     --name=TRIGGER_NAME \
     --repository=projects/PROJECT_ID/locations/REGION/connections/CONNECTION_NAME/repositories/REPO_NAME \
     --branch=BRANCH_NAME \
     --build-config=BUILD_CONFIG_FILE \
     --service-account=SERVICE_ACCOUNT
   

Dengan:

• REGION adalah region untuk pemicu Anda.
• TRIGGER_NAME adalah nama pemicu Anda.
• PROJECT_ID adalah Google Cloud project ID Anda.
• CONNECTION_NAME adalah nama koneksi host Anda.
• REPO_NAME adalah nama repositori Anda.
• BRANCH_NAME adalah nama cabang Anda. Anda juga dapat menentukan tag menggunakan --tag atau ID commit menggunakan --sha.
• BUILD_CONFIG_FILE adalah jalur ke file konfigurasi build Anda. Anda juga dapat menentukan file konfigurasi build inline menggunakan --inline-config atau Dockerfile menggunakan --dockerfile, --dockerfile-dir, dan dockerfile-image.
• SERVICE_ACCOUNT adalah email yang terkait dengan akun layanan Anda. Jika Anda tidak menyertakan tanda ini, akun layanan default akan digunakan.

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 Google Cloud konsol.

   Buka halaman pemicu

2. Temukan pemicu Anda dalam daftar.

3. Klik Run trigger.

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

   Jika pemicu menggunakan repositori dengan lebih dari 500 cabang atau tag, beberapa di antaranya mungkin tidak ada dalam saran. Anda masih dapat memasukkan nama cabang atau tag secara manual.

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

   Jika Anda menentukan nilai variabel baru untuk penggantian, klik Jalankan pemicu 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:

• 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.
• SUBSTITUTION_VAR (Opsional) adalah nama variabel untuk nilai penggantian Anda.
• SUBSTITUTION_VALUE (Opsional) 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.