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
Buka halaman IAM di konsol Google Cloud .
Di menu drop-down pemilih project di bagian atas halaman, pilih project yang berisi pool pribadi Anda.
Klik Grant access.
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.
Klik Save untuk menyimpan izin IAM baru Anda.
gcloud
Untuk memberikan peran
roles/cloudbuild.workerPoolUserke 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.workerPoolUserGanti nilai placeholder dalam perintah di atas dengan nilai berikut:
PRIVATEPOOL_PROJECT_IDadalah ID project dengan pool pribadi yang menjalankan build.TRIGGER_PROJECT_NUMBERadalah 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:
Di file konfigurasi Cloud Build, tambahkan opsi
pooldan 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.
Gunakan file konfigurasi build yang dibuat di atas untuk menjalankan build Anda melalui
gcloudatau 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?
- Pelajari cara membuat dan mengelola pool pribadi.
- Pelajari cara menggunakan Kontrol Layanan VPC dengan pool pribadi.
- Pelajari cara membuat dan mengelola pemicu build.
- Pelajari cara membangun repositori dari GitHub Enterprise.
- Pelajari cara membangun repositori dari Bitbucket Server.