Mengotomatiskan build dengan Cloud Build

Topik ini menjelaskan cara mengotomatiskan build menggunakan Cloud Build dan Cloud Source Repositories.

Anda dapat mengonfigurasi Cloud Build untuk otomatis mem-build image baru setiap kali pengguna mengirimkan perubahan ke file yang disimpan di Cloud Source Repositories. Peristiwa yang memulai build otomatis disebut pemicu build. Pemicu ini dapat membantu memastikan bahwa image penampung Anda selalu yang terbaru. Anda juga dapat menggunakannya untuk mem-build dan menguji cabang fitur.

Pemicu build dapat melakukan build berdasarkan Dockerfile atau file konfigurasi build.

Menggunakan Dockerfile

Untuk menggunakan Dockerfile untuk konfigurasi build, Anda harus menentukan direktori Dockerfile dan memberikan nama untuk image yang dihasilkan. Untuk mengetahui detail tentang cara membuat Dockerfile, lihat dokumentasi Docker.

Setelah memberikan Dockerfile dan nama image, Anda akan melihat pratinjau perintah docker build yang dieksekusi build dan ringkasan konfigurasi pemicu.

Menggunakan file konfigurasi build

Untuk menggunakan file konfigurasi build untuk konfigurasi build, Anda harus memberikan lokasi file konfigurasi build.

Setelah menetapkan lokasi, Anda akan melihat ringkasan pemicu.

Sebelum memulai

Informasi tambahan

  • Pemicu build menggunakan clone dangkal dari repositori. Dengan clone dangkal, hanya satu commit yang memicu build otomatis yang akan di-check out di ruang kerja. Untuk informasi selengkapnya, dan mempelajari cara menyertakan lebih banyak histori repositori, lihat Menghapus clone shallow.

  • Jika Anda menggunakan penyedia Git yang dihosting lainnya, seperti di GitHub atau Bitbucket, dan masih perlu menduplikasi repositori ke Cloud Source Repositories, Anda harus memiliki izin cloudbuilds.builds.create untuk project Google Cloud yang Anda gunakan. Izin ini biasanya diberikan melalui peran cloudbuild.builds.editor.

    Saat menyiapkan pemicu build dengan repositori eksternal untuk pertama kali, Anda harus menyiapkan otorisasi dengan repositori tersebut. Untuk mengetahui informasi selengkapnya, lihat Menambahkan repositori sebagai repositori jarak jauh.

    Setelah Anda menyiapkan repositori eksternal, Cloud Source Repositories akan membuat duplikat repositori Anda.

  • Untuk mengetahui informasi tentang kuota dan batas untuk Cloud Build, lihat Kuota dan batas dalam dokumentasi Cloud Build.

Membuat pemicu build

Konsol

  1. Buka halaman Pemicu di konsol Google Cloud.

    Buka halaman Pemicu

  2. Pilih project Anda dari menu drop-down pemilih project di bagian atas halaman.

  3. Klik Buka.

  4. Klik Create trigger.

  5. Masukkan setelan pemicu berikut:

    • Nama: Masukkan nama untuk pemicu Anda.

    • Deskripsi (opsional): Masukkan deskripsi untuk pemicu Anda.

    • Peristiwa: Pilih peristiwa repositori untuk memanggil pemicu Anda.

      • Push ke cabang: Tetapkan pemicu untuk memulai build pada commit ke cabang tertentu.

      • Push tag baru: Tetapkan pemicu untuk memulai build pada commit yang berisi tag tertentu.

    • Sumber: Pilih repositori dan cabang atau tag yang sesuai untuk memantau peristiwa.

      Saat build dieksekusi, konten repositori Anda akan disalin ke /workspace, direktori kerja default yang digunakan oleh Cloud Build. Pelajari direktori kerja lebih lanjut di halaman Ringkasan konfigurasi build.

      • Cabang atau Tag: Tentukan ekspresi reguler dengan cabang atau nilai tag yang akan dicocokkan. Garis miring (/) tidak dapat digunakan dalam tag. Untuk informasi selengkapnya tentang sintaksis ekspresi reguler yang dapat diterima, lihat sintaksis RE2.

    • 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.
        • Buildpack: Gunakan buildpacks 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.
        • Variabel lingkungan buildpack (opsional): Jika Anda memilih buildpacks sebagai jenis konfigurasi, klik Tambahkan variabel lingkungan paket untuk menentukan variabel dan nilai lingkungan buildpack Anda. Untuk mempelajari lebih lanjut variabel lingkungan buildpack, lihat Variabel lingkungan.

        • Inline: Jika memilih File konfigurasi Cloud Build (yaml atau json) sebagai opsi konfigurasi, Anda dapat menentukan konfigurasi build secara langsung. Klik Buka Editor untuk menulis file konfigurasi build di konsol Google Cloud menggunakan sintaksis YAML atau JSON. Klik Done untuk menyimpan konfigurasi build Anda.

    • Akun layanan: Pilih akun layanan yang akan digunakan saat memanggil pemicu Anda. Jika Anda tidak memilih akun layanan, akun layanan Cloud Build default akan digunakan.

  6. Klik Buat untuk menyimpan pemicu build Anda.

gcloud

Jalankan perintah berikut:

    gcloud beta builds triggers create cloud-source-repositories \
    --repo=REPO_NAME \
    --branch-pattern=BRANCH_PATTERN \ # or --tag-pattern=TAG_PATTERN
    --build-config=BUILD_CONFIG_FILE \
    --service-account=SERVICE_ACCOUNT \
    --require-approval

Dengan keterangan:

  • REPO_NAME adalah nama repositori Anda.
  • BRANCH_PATTERN adalah nama cabang di repositori Anda untuk memanggil build.
  • TAG_PATTERN adalah nama tag di repositori Anda untuk memanggil build.
  • BUILD_CONFIG_FILE adalah jalur ke file konfigurasi build Anda.
  • SERVICE_ACCOUNT (pratinjau) adalah email yang terkait dengan akun layanan Anda. Jika Anda tidak menyertakan flag ini, akun layanan Cloud Build default akan digunakan.
  • [Opsional] --require-approval adalah flag yang akan disertakan untuk mengonfigurasi pemicu agar memerlukan persetujuan.

Untuk mengetahui daftar lengkap flag, lihat referensi gcloud tentang cara membuat pemicu untuk Cloud Source Repositories.

Setelah menjalankan perintah gcloud untuk membuat pemicu menggunakan Cloud Source Repositories, Anda akan melihat output yang mirip dengan berikut ini:

  NAME         CREATE_TIME                STATUS
  trigger-001  2019-10-30T20:45:03+00:00

Melihat pemicu build

Untuk melihat pemicu di konsol Google Cloud, buka halaman Pemicu Cloud Build.

Untuk melihat pemicu untuk project tertentu di Repositori Sumber Cloud, klik Setelan di kanan atas, lalu klik Pemicu Cloud Build.

Melewati pemicu build

Dalam beberapa kasus, Anda mungkin ingin mengubah kode sumber, tetapi tidak ingin memicu build, misalnya, saat Anda mengupdate dokumentasi atau file konfigurasi.

Dalam kasus tersebut, Anda dapat menyertakan [skip ci] atau [ci skip] dalam pesan commit, dan build tidak akan dipicu.

Contoh:

Author: A User <auser@example.com>
Date:   Tue Apr 3 12:03:35 2018 -0700

Fixed customer affecting issue. [skip ci]

Jika Anda ingin menjalankan build pada commit tersebut nanti, gunakan tombol Run trigger.

Menghapus clone yang dangkal

Untuk mem-build sumber di repositori Git, Cloud Source Repositories melakukan clone dangkal repositori. Saat Cloud Source Repositories melakukan clone dangkal, Cloud Source Repositories hanya memeriksa satu commit dari workspace yang memicu build, lalu mem-build dari sumber tersebut. Cloud Source Repositories tidak memeriksa cabang atau histori lainnya. Hal ini dilakukan untuk efisiensi. Build tidak tertunda saat Cloud Source Repositories mengambil seluruh repositori dan histori hanya untuk mem-build dari satu commit.

Untuk menyertakan lebih banyak histori repo dalam build, tambahkan langkah build dalam file konfigurasi build untuk "memperdalam" clone. Contoh:

steps:
- name: gcr.io/cloud-builders/git
  args: ['fetch', '--unshallow']
...

Untuk mengetahui informasi selengkapnya tentang git fetch, lihat referensi git. Untuk petunjuk cara menulis file konfigurasi build, lihat Ringkasan konfigurasi build.

Langkah selanjutnya