Menjalankan build dalam kumpulan pribadi

Dokumen ini menjelaskan cara menjalankan build di pool pribadi. Jika Anda baru mengenal pool pribadi, baca Ringkasan pool pribadi.

Sebelum memulai

  • Pastikan Anda telah membuat pool pribadi menggunakan langkah-langkah di bagian Membuat dan mengelola pool pribadi.

  • Untuk menggunakan contoh command line dalam panduan ini, instal dan konfigurasi Google Cloud CLI.

  • Anda dapat menggunakan project Google Cloud yang sama untuk membuat pool pribadi dan build Cloud Build, atau menggunakan project yang berbeda. Jika build Anda berada di project yang berbeda dengan pool pribadi, tetapkan project default di gcloud CLI ke project tempat build Anda berasal:

    gcloud config set project BUILD_ORIGIN_PROJECT_ID
    

Izin IAM

  • Untuk menjalankan build melalui gcloud CLI atau Cloud Build API, berikan peran WorkerPool User di project pool pribadi kepada pengguna atau akun layanan yang meminta build.

  • Untuk menjalankan build otomatis menggunakan pemicu:

    • Jika project tempat Anda memulai build sama dengan project tempat pool pribadi Anda berada, Anda tidak perlu memberikan izin apa pun.
    • Jika project tempat Anda memulai build berbeda dengan project tempat pool pribadi Anda berada, berikan peran Cloud Build WorkerPool User (roles/cloudbuild.workerPoolUser) di project pool pribadi ke akun layanan Cloud Build lama (TRIGGER_PROJECT_NUMBER@cloudbuild.gserviceaccount.com) dari project tempat pemicu Anda berjalan:

    Konsol

    1. Buka halaman IAM di konsol Google Cloud .

      Buka halaman IAM Permissions

    2. Di menu drop-down pemilih project di bagian atas halaman, pilih project yang berisi pool pribadi Anda.

    3. Klik Grant access.

    4. Masukkan setelan akun utama dan peran berikut:

      • Add principals: Masukkan alamat email akun layanan Cloud Build lama (TRIGGER_PROJECT_NUMBER@cloudbuild.gserviceaccount.com) dari project tempat pemicu Anda berjalan.

      • Assign roles: Pilih peran Cloud Build WorkerPool User.

    5. Klik Save untuk menyimpan izin IAM baru Anda.

    gcloud

    Untuk memberikan peran roles/cloudbuild.workerPoolUser ke akun layanan Cloud Build lama dari project pemicu:

      gcloud projects add-iam-policy-binding PRIVATEPOOL_PROJECT_ID \
          --member=serviceAccount:TRIGGER_PROJECT_NUMBER@cloudbuild.gserviceaccount.com \
          --role=roles/cloudbuild.workerPoolUser
    

    Ganti nilai placeholder dalam perintah di atas dengan nilai berikut:

    • PRIVATEPOOL_PROJECT_ID adalah ID project dengan pool pribadi yang menjalankan build.
    • TRIGGER_PROJECT_NUMBER adalah nomor project dari project tempat pemicu Anda berjalan.

Menjalankan build

Anda dapat mengirimkan build dari project Google Cloud yang sama tempat Anda membuat pool pribadi atau dari project Google Cloud yang berbeda. Anda dapat menentukan kumpulan pribadi di file konfigurasi build atau langsung di perintah gcloud:

Menentukan kumpulan pribadi dalam file konfigurasi build:

  1. Di file konfigurasi Cloud Build, tambahkan opsi pool dan tentukan nama resource lengkap pool pribadi untuk menjalankan build:

    YAML

    steps:
    - name: 'bash'
      args: ['echo', 'I am running in a private pool!']
    options:
      pool:
        name: 'projects/PRIVATEPOOL_PROJECT_ID/locations/REGION/workerPools/PRIVATEPOOL_ID'
    

    JSON

    {
      "steps": [
      {
        "name": "bash",
        "args": [
          "echo",
          "I am running in a private pool!"
        ]
      }
      ],
      "options": {
        "pool" : {
          "name" : "projects/PRIVATEPOOL_PROJECT_ID/locations/REGION/workerPools/PRIVATEPOOL_ID"
        }
      }
    }
    

    Ganti nilai placeholder dalam file konfigurasi di atas dengan nilai berikut:

    • PRIVATEPOOL_PROJECT_ID: project Google Cloud tempat private pool Anda berada.
    • REGION: region tempat Anda membuat pool pribadi.
    • PRIVATEPOOL_ID: ID pool pribadi unik yang Anda tentukan saat membuat pool pribadi.
  2. Gunakan file konfigurasi build yang dibuat di atas untuk menjalankan build Anda melalui gcloud atau API atau menggunakan pemicu. Jika instance Anda dihosting secara lokal, Cloud Build juga menyediakan dukungan fungsi pemicu untuk beberapa sistem pengelolaan kode sumber eksternal seperti GitHub Enterprise atau Bitbucket Server.

Menentukan pool pribadi dalam perintah gcloud:

Anda dapat menentukan pool pribadi dalam perintah gcloud, bukan dalam file konfigurasi build. Misalnya, Anda memiliki file konfigurasi build berikut:

YAML

  steps:
  - name: 'bash'
    args: ['echo', 'I am running in a private pool!']

JSON

  {
    "steps": [
    {
      "name": "bash",
      "args": [
        "echo",
        "I am running in a private pool!"
      ]
    }
    ],
  }

Perintah berikut membangun menggunakan file konfigurasi build dan menentukan worker pool dalam perintah:

gcloud builds submit --config=CONFIG_FILE
  --worker-pool=projects/PRIVATEPOOL_PROJECT_ID/locations/REGION/workerPools/PRIVATEPOOL_ID

Ganti nilai placeholder dalam perintah di atas dengan nilai berikut:

  • CONFIG_FILE: jalur ke file konfigurasi build Anda.
  • PRIVATEPOOL_ID: ID pool pribadi unik yang Anda tentukan saat membuat pool pribadi.
  • PRIVATEPOOL_PROJECT_ID: project Google Cloud tempat private pool Anda berada.
  • REGION: region tempat Anda membuat pool pribadi.

Apa langkah selanjutnya?