Menggunakan builder yang dikontribusikan oleh komunitas dan builder kustom

Halaman ini menjelaskan cara menggunakan builder yang dikontribusikan oleh komunitas dan builder kustom di Cloud Build. Komunitas developer Cloud Build menyediakan builder open source yang dapat Anda gunakan untuk menjalankan tugas. Jika tugas yang ingin Anda lakukan memerlukan kemampuan yang tidak disediakan oleh image yang ada, Anda dapat membuat image kustom sendiri dan menggunakannya dalam langkah build. Untuk mempelajari berbagai jenis builder, lihat Cloud Builder.

Jika Anda baru menggunakan Cloud Build, baca panduan memulai dan Ringkasan konfigurasi build terlebih dahulu.

Menggunakan builder yang dikontribusikan oleh komunitas

Image bawaan tidak tersedia untuk builder yang dikontribusikan oleh komunitas. Untuk menggunakan builder ini dalam file konfigurasi Cloud Build, Anda harus mem-build image terlebih dahulu dan mengirimkannya ke Artifact Registry di project Anda.

Untuk menggunakan builder yang dikontribusikan oleh komunitas:

  1. Build dan kirim builder:

    1. Buka direktori root project Anda.

    2. Clone repositori cloud-builders-community:

      git clone https://github.com/GoogleCloudPlatform/cloud-builders-community.git

    3. Buka image builder yang ingin Anda gunakan, dengan builder-name adalah direktori yang berisi builder:

      cd cloud-builders-community/builder-name

    4. Kirim builder ke project Anda:

      gcloud builds submit .

    5. Kembali ke direktori root project Anda:

      cd ../..

    6. Hapus repositori dari direktori root Anda:

      rm -rf cloud-builders-community/

  2. Di file konfigurasi Cloud Build, gunakan builder dalam langkah build:

    YAML 

    steps:
- name: 'gcr.io/project-id/builder-name'
  args: ['arg1', 'arg2', ...]
...

    JSON 

    {
  "steps": [
  {
    "name": "gcr.io/project-id/builder-name",
    "args": [
      "arg1",
      "arg2",
      ...
    ]
    ...
  }
  ]
}

  3. Gunakan file konfigurasi build untuk memulai build secara manual atau membangun menggunakan pemicu.

Untuk contoh penggunaan builder yang dikontribusikan oleh komunitas, lihat Men-deploy ke Firebase dan Mem-build image VM menggunakan Packer.

Membuat builder kustom

Jika tugas yang ingin Anda lakukan memerlukan kemampuan yang tidak disediakan oleh image publik, builder yang didukung, atau builder yang dikontribusikan oleh komunitas, Anda dapat mem-build image sendiri dan menggunakannya dalam langkah build.

Beberapa contoh kapan Anda mungkin ingin menggunakan image builder kustom adalah:

  • Mendownload kode sumber atau paket dari lokasi eksternal.
  • Menggunakan rantai alat eksternal.
  • Meng-cache library yang diperlukan.
  • Mem-build sumber terlebih dahulu (dengan Cloud Build hanya bertanggung jawab untuk berpotensi mengemas build ke dalam image).

Seperti builder lainnya, builder kustom berjalan dengan sumber yang dipasang di bawah /workspace, dan dijalankan dengan direktori kerja di /workspace. File apa pun yang tersisa di /workspace oleh langkah build tertentu tersedia untuk langkah build lainnya.

Builder kustom Anda dapat mengirim ke atau mengambil dari repositori di Artifact Registry (dihosting di gcr.io/$PROJECT-NAME/) yang dapat diakses oleh akun layanan build Anda.

Langkah-langkah berikut menunjukkan cara membuat dan menggunakan builder kustom dengan contoh Dockerfile:

  1. Buat image builder kustom:

    1. Buat Dockerfile untuk builder kustom. Kode berikut menunjukkan contoh Dockerfile:

        FROM alpine
  RUN apk add curl
  CMD curl https://httpbin.org/ip -s > myip.txt; echo "*** My IP is: $(cat myip.txt)"

    2. Build dan kirim builder kustom ke Artifact Registry di project Anda, dengan mengganti nilai untuk project-id dan image-name:

        gcloud builds submit --tag gcr.io/project-id/image-name

  2. Gunakan image builder kustom di Cloud Build dengan menentukan builder di kolom name langkah build:

    YAML 

        steps:
    - name: 'gcr.io/project-id/image-name'
      id: Determine IP of this build worker

    JSON 

        {
      "steps": [
      {
        "name": "gcr.io/project-id/image-name",
        "id": "Determine IP of this build worker"
      }
      ]
    }

  3. Gunakan file konfigurasi build untuk memulai build secara manual atau membangun menggunakan pemicu.

Langkah berikutnya