Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Membuat dan mengelola kumpulan pribadi

Halaman ini menjelaskan cara membuat, memperbarui, melihat, dan menghapus pool pribadi Cloud Build. Jika Anda belum memahami pool pribadi, baca Ringkasan pool pribadi.

Sebelum memulai

Buat project Google Cloud baru atau pilih project yang sudah ada. Anda akan menggunakan project ini untuk membuat pool pribadi.
Aktifkan Cloud Build API.
Peran yang diperlukan untuk mengaktifkan API
Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), yang berisi izin serviceusage.services.enable. Pelajari cara memberikan peran.
Mengaktifkan API
Untuk menggunakan contoh command line dalam panduan ini, instal dan konfigurasi Google Cloud CLI.

Catatan: Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi terbaru yang tersedia dengan menjalankan gcloud components update.
Opsional: Agar build dapat mengakses resource pribadi dari jaringan Virtual Private Cloud, Anda harus menyiapkan koneksi peering antara jaringan Virtual Private Cloud dan jaringan Virtual Private Cloud tempat pool pribadi berada. Untuk mengetahui petunjuknya, lihat menyiapkan lingkungan untuk membuat pool pribadi.
Opsional: Pahami konfigurasi jenis mesin dan ketersediaan regional. Untuk mengetahui informasi selengkapnya, lihat workerconfig dalam dokumentasi skema file konfigurasi pool pribadi.

Membuat pool pribadi

Untuk memastikan memiliki izin yang diperlukan untuk membuat pool pribadi, minta administrator Anda untuk memberikan peran IAM Cloud Build WorkerPool Owner (roles/cloudbuild.workerPoolOwner) kepada di akun layanan Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Administrator Anda mungkin juga dapat memberikan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Anda dapat membuat hingga 10 pool pribadi per Google Cloud project per region. Untuk membuat pool pribadi, lakukan hal berikut:

Google Cloud Konsol

Buka halaman Worker Pool di Google Cloud konsol:

Buka halaman worker pool Cloud Build
Klik Create private pool.

Halaman Create private pool akan ditampilkan.

Masukkan informasi berikut untuk membuat pool pribadi Anda:
Nama: Masukkan nama untuk pool pribadi Anda. Nilai ini hanya dapat berisi karakter alfanumerik /[a-z][0-9]/ atau tanda hubung -. Nama pool pribadi Anda harus terdiri dari 1 hingga 63 karakter.
Region: Pilih region tempat Anda ingin membuat pool pribadi.
Konfigurasi mesin: Konfigurasi hal berikut:
1. Series: Pilih seri mesin.
2. Jenis mesin: Setelan ini menampilkan jenis mesin, berdasarkan seri mesin yang Anda pilih, yang dapat digunakan oleh worker pool. Jenis mesin yang tersedia bervariasi menurut region.
3. Ukuran disk: Masukkan ukuran disk untuk pool pribadi Anda. Tentukan nilai yang lebih besar dari atau sama dengan 100 dan kurang dari atau sama dengan 4000. Jika Anda tidak memberikan nilai, Cloud Build akan menggunakan ukuran disk 100.
4. Virtualisasi bertingkat: Jika Anda memilih mesin seri C3, Anda dapat mengaktifkan virtualisasi bertingkat. Fitur ini memungkinkan Anda menjalankan instance virtual machine (VM) di dalam VM lain sehingga Anda dapat membuat lingkungan virtualisasi Anda sendiri.
Di bagian Network type, pilih salah satu opsi berikut:
1. Default network: Pilih opsi ini jika instance Anda dapat diakses melalui internet publik. Jika opsi Default network dipilih, pool pribadi Anda akan menggunakan jaringan produsen layanan. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan lingkungan untuk menggunakan kumpulan pribadi di jaringan VPC.
2. Private network: Pilih opsi ini jika instance Anda dihosting di jaringan pribadi, lalu lakukan hal berikut:
  1. Project: Pilih Google Cloud project ID Anda.
  2. Network: Pilih jaringan Anda dari menu drop-down. Jika Anda belum membuat jaringan, lihat Membuat dan mengelola jaringan VPC untuk mempelajari cara membuat jaringan.
  3. Rentang IP: Masukkan rentang IP internal yang dapat digunakan oleh jaringan produsen Cloud Build untuk dialokasikan ke VM yang mempertahankan koneksi dengan repositori pribadi.
    
    Anda dapat menentukan rentang menggunakan notasi perutean Classless Inter-Domain Routing (CIDR) dalam format STARTING_IP_ADDRESS/SUBNET_PREFIX_SIZE. Misalnya, 192.0.2.0/24 memiliki panjang awalan 24. 24 bit pertama dari rentang IP digunakan sebagai subnet mask (192.0.2.0), sedangkan rentang alamat host yang mungkin adalah dari 192.0.2.0 hingga 192.0.2.255.
    
    Nilai panjang awalan tidak boleh melebihi /29. Jika tidak ada nilai yang ditentukan untuk rentang, nilai default /24 akan otomatis ditetapkan. Jika tidak ada nilai yang ditentukan untuk panjang awalan, alamat IP akan otomatis ditetapkan dalam jaringan VPC yang di-peering. Jika tidak ada nilai yang ditentukan untuk alamat IP, alamat IP akan otomatis ditetapkan rentang dalam jaringan VPC yang di-peering.
    
    Catatan: Anda hanya dapat menentukan IP range jika telah menentukan a Network. Jika Anda telah menentukan Network, IP range bersifat opsional.
3. Assign external IPs: Opsi ini dipilih secara default untuk memungkinkan pool pribadi mengakses internet publik. Hapus centang pada kotak ini untuk membatasi akses ke jaringan pribadi Anda.
Klik Create untuk membuat pool pribadi Anda.

gcloud

Anda memiliki dua opsi untuk membuat pool pribadi baru menggunakan gcloud: Anda dapat meneruskan file konfigurasi pool pribadi ke perintah gcloud, atau meneruskan opsi konfigurasi langsung ke perintah gcloud.

Meneruskan file konfigurasi pool pribadi ke perintah gcloud

Buat file konfigurasi pool pribadi dalam format YAML atau JSON.

Jalankan perintah gcloud berikut, dengan PRIVATEPOOL_ID adalah ID unik untuk pool pribadi Anda, PRIVATEPOOL_CONFIG_FILE adalah nama file konfigurasi pool pribadi Anda, dan REGION adalah region tempat Anda ingin membuat pool pribadi Anda:

gcloud builds worker-pools create PRIVATEPOOL_ID --config-from-file PRIVATEPOOL_CONFIG_FILE --region REGION

Anda akan melihat output yang mirip dengan berikut ini:

Created [https://cloudbuild.googleapis.com/v1/projects/gcb-docs-project/locations/us-central1/workerPools/private-pool].
NAME                 CREATE_TIME                STATUS
private-pool  2018-11-19T16:08:24+00:00  RUNNING

Meneruskan opsi konfigurasi langsung ke perintah gcloud

Jalankan perintah gcloud berikut:

    gcloud builds worker-pools create PRIVATEPOOL_ID \
        --project=PRIVATEPOOL_PROJECT_ID \
        --region=REGION \
        --peered-network=PEERED_NETWORK \
        --worker-machine-type=PRIVATEPOOL_MACHINE_TYPE \
        --worker-disk-size=PRIVATEPOOL_DISK_SIZE_GB \
        --no-public-egress

Dengan:

PRIVATEPOOL_ID: ID unik untuk pool pribadi Anda. Nilai ini harus terdiri dari 1-63 karakter, dan karakter yang valid adalah [a-zA-Z0-9_-]+.
PRIVATEPOOL_PROJECT_ID: ID projecttempat Anda ingin membuat pool pribadi Anda. Google Cloud
REGION: salah satu region yang didukung.
PEERED_NETWORK: URL resource jaringan dari jaringan yang di-peering ke jaringan produsen layanan. PEERED_NETWORK harus dalam format projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME, dengan NETWORK_PROJECT_ID adalah ID project dari project yang menyimpan jaringan VPC Anda dan NETWORK_NAME adalah nama jaringan VPC Anda. Google Cloud Jika Anda tidak menentukan nilai, Cloud Build akan menggunakan jaringan penyedia layanan.
PRIVATEPOOL_DISK_SIZE_GB: ukuran disk yang terpasang ke pool pribadi. Tentukan nilai yang lebih besar dari atau sama dengan 100 dan kurang dari atau sama dengan 4000. Jika tidak diberikan, Cloud Build akan menggunakan ukuran disk 100. --worker-disk-size akan diganti jika Anda menentukan ukuran disk yang berbeda menggunakan --disk-size selama gcloud builds submit.
PRIVATEPOOL_MACHINE_TYPE: jenis mesin worker. Jika dibiarkan kosong, Cloud Build akan menggunakan nilai default e2-standard-2. Untuk mengetahui daftar jenis mesin yang didukung, lihat Skema file konfigurasi pool pribadi. --worker-machine-type akan diganti jika Anda menentukan jenis mesin yang berbeda menggunakan --machine-type selama gcloud builds submit.
--no-public-egress: Jika tanda ini ditetapkan, pool pribadi akan dibuat tanpa alamat IP eksternal. Tetapkan tanda ini jika Anda membuat pool pribadi dalam perimeter Kontrol Layanan VPC.

API

Buat file konfigurasi pool pribadi Anda yang bernama workerpool.json.
Gunakan cURL untuk memanggil Cloud Build API:
```
    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)"
        -H "Content-Type: application/json" \
        https://cloudbuild.googleapis.com/v1/projects/PRIVATEPOOL_PROJECT_ID/locations/REGION/workerPools/?workerPoolId=PRIVATEPOOL_ID -d @workerpool.json
```
Dengan:
- PRIVATEPOOL_PROJECT_ID: ID projecttempat Anda ingin membuat pool pribadi Anda. Google Cloud
- PRIVATEPOOL_ID: ID untuk pool pribadi Anda. Nilai ini harus terdiri dari 1-63 karakter, dan karakter yang valid adalah [a-zA-Z0-9_-]+.
- REGION: salah satu region yang didukung untuk membuat pool pribadi Anda.

Membuat pool pribadi dalam perimeter Kontrol Layanan VPC

Untuk membuat pool pribadi dengan perimeter Kontrol Layanan VPC, lihat Menggunakan Kontrol Layanan VPC.

Memperbarui pool pribadi

Untuk memastikan memiliki izin yang diperlukan untuk membuat pool pribadi, minta administrator Anda untuk memberikan peran IAM Cloud Build WorkerPool Editor (roles/cloudbuild.workerPoolEditor) kepada di akun layanan Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Administrator Anda mungkin juga dapat memberikan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Untuk memperbarui konfigurasi pool pribadi, lakukan hal berikut:

Konsol

Buka halaman Worker pool di Google Cloud konsol:

Buka halaman worker pool Cloud Build
Pilih project tempat Anda membuat pool pribadi.
Klik nama pool pribadi.
Di halaman Edit private pool, perbarui jenis mesin dan ukuran disk sesuai kebutuhan.
Klik Save.

gcloud

Dengan memperbarui file konfigurasi pool pribadi:

Perbarui kolom yang ingin Anda ubah di file konfigurasi pool pribadi Anda.
Jalankan perintah berikut, dengan PRIVATEPOOL_ID adalah ID unik untuk pool pribadi Anda, REGION adalah region tempat pool pribadi Anda berada, dan PRIVATEPOOL_CONFIG_FILE adalah nama file konfigurasi pool pribadi Anda:
```
gcloud builds worker-pools update PRIVATEPOOL_ID \
    --region=REGION \
    --config-from-file=PRIVATEPOOL_CONFIG_FILE
```

Dengan meneruskan nilai untuk diperbarui langsung ke perintah gcloud builds worker-pools update

   gcloud builds worker-pools update PRIVATEPOOL_ID \
       --region=REGION \
       --worker-disk-size=PRIVATEPOOL_DISK_SIZE \
       --worker-machine-type=PRIVATEPOOL_MACHINE_TYPE

Dengan:

PRIVATEPOOL_ID: ID pool pribadi Anda yang ada. Anda tidak dapat memperbarui nilai ini; Anda harus menentukan ID pool pribadi yang ada.
REGION: region tempat Anda membuat pool pribadi Anda.
PRIVATEPOOL_DISK_SIZE: ukuran disk yang diperbarui.
PRIVATEPOOL_MACHINE_TYPE adalah jenis mesin yang diperbarui.

API

Di file konfigurasi pool pribadi Anda, perbarui ukuran disk dan jenis mesin sesuai kebutuhan.

Gunakan cURL untuk memanggil Cloud Build API, dengan mengganti variabel dengan nilai yang sesuai:

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    https://cloudbuild.googleapis.com/v1/projects/PRIVATEPOOL_PROJECT_ID/locations/REGION/workerPools/PRIVATEPOOL_ID \
    -d @workerpool.json

Dengan:

PRIVATEPOOL_ID: ID pool pribadi Anda.
PRIVATEPOOL_PROJECT_ID: ID projectyang berisi pool pribadi Anda. Google Cloud
REGION: region tempat Anda membuat pool pribadi Anda.

Melihat detail pool pribadi Anda

Untuk memastikan memiliki izin yang diperlukan untuk membuat pool pribadi, minta administrator Anda untuk memberikan peran IAM Cloud Build WorkerPool Viewer (roles/cloudbuild.workerPoolViewer) kepada di akun layanan Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Administrator Anda mungkin juga dapat memberikan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Untuk melihat detail pool pribadi:

Konsol

Buka halaman Worker pool di Google Cloud konsol:

Buka halaman worker pool Cloud Build
Pilih project tempat Anda membuat pool pribadi
Klik nama pool pribadi.

Halaman Edit private pool akan ditampilkan.

gcloud

Jika Anda tidak mengetahui ID pool pribadi Anda, jalankan perintah berikut untuk mencantumkan detail pool pribadi Anda:

gcloud builds worker-pools list --region=REGION --project=PRIVATEPOOL_PROJECT_ID

Dengan:

PRIVATEPOOL_PROJECT_ID adalah ID Google Cloud project yang berisi pool pribadi.
REGION adalah region pool pribadi.

Anda akan melihat output yang mirip dengan berikut ini:

NAME                                                                  CREATE_TIME                STATUS
projects/[PRIVATEPOOL_PROJECT_ID]/locations/us-central1/workerPools/[PRIVATEPOOL_ID]      2018-11-19T16:08:24+00:00  RUNNING

Jika Anda mengetahui ID pool pribadi Anda, jalankan perintah berikut untuk mendapatkan informasi selengkapnya tentang pool pribadi:

gcloud builds worker-pools describe PRIVATEPOOL_ID \
    --region=REGION \
    --project=PRIVATEPOOL_PROJECT_ID

Di mana

PRIVATEPOOL_ID: ID pool pribadi Anda.
REGION: region tempat Anda membuat pool pribadi Anda.
PRIVATEPOOL_PROJECT_ID: ID projectyang berisi pool pribadi Anda. Google Cloud

API

Jika Anda tidak mengetahui ID pool pribadi Anda, jalankan perintah cURL berikut untuk mencantumkan detail pool pribadi Anda, dengan PRIVATEPOOL_PROJECT_ID adalah ID Google Cloud project yang berisi pool pribadi:

    curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        https://cloudbuild.googleapis.com/v1/projects/PRIVATEPOOL_PROJECT_ID/locations/REGION/workerPools

Jika Anda mengetahui ID pool pribadi Anda, jalankan perintah curl berikut untuk mendapatkan detail pool pribadi Anda:

    curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        https://cloudbuild.googleapis.com/v1/projects/PRIVATEPOOL_PROJECT_ID/locations/REGION/workerPools/PRIVATEPOOL_ID

Di mana

PRIVATEPOOL_ID: ID pool pribadi Anda.
PRIVATEPOOL_PROJECT_ID: ID projectyang berisi pool pribadi Anda. Google Cloud
REGION: region tempat Anda membuat pool pribadi Anda.

Melihat perkiraan harga pool pribadi

Saat Anda membuat atau memperbarui pool pribadi, sidebar Monthly estimate di halaman Create private pool dan Edit private pool akan menampilkan perkiraan biaya yang akan dikenakan untuk menjalankan pool Anda per bulan. Perhitungan ini didasarkan pada faktor-faktor berikut:

Jumlah CPU virtual
Jenis mesin
Memori
Menit build
Region, hanya untuk mesin N2D dan C3

Perkiraan harga tidak mencakup biaya untuk ukuran disk tambahan di luar 100 GB yang disertakan secara default. Perkiraan harga mungkin berbeda dengan harga akhir, bergantung pada konfigurasi build akhir, menit build aktual yang digunakan, dan faktor lainnya. Untuk mengetahui informasi selengkapnya, lihat Harga Cloud Build.

Menghapus pool pribadi

Administrator Anda mungkin juga dapat memberikan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Untuk menghapus pool pribadi, lakukan hal berikut:

Konsol

Buka halaman Worker pool di Google Cloud konsol:

Buka halaman worker pool Cloud Build
Di baris dengan pool pribadi Anda, klik ikon tempat sampah.

gcloud

Untuk menghapus pool pribadi, jalankan perintah gcloud builds worker-pools delete:

 gcloud builds worker-pools delete PRIVATEPOOL_ID \
     --region=REGION \
     --project=PRIVATEPOOL_PROJECT_ID

Dengan:

PRIVATEPOOL_ID: ID pool pribadi Anda.
PRIVATEPOOL_PROJECT_ID: ID projectyang berisi pool pribadi Anda. Google Cloud
REGION: region tempat Anda membuat pool pribadi Anda.

Setelah pool pribadi dihapus, Anda akan melihat output yang mirip dengan berikut ini:

 Deleted [https://cloudbuild.googleapis.com/v1/projects/gcb-docs-project/locations/us-central1/workerPools/[PRIVATEPOOL_ID].

API

Gunakan cURL untuk memanggil Cloud Build API:

  curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      https://cloudbuild.googleapis.com/v1/projects/PRIVATEPOOL_PROJECT_ID/locations/REGION/workerPools/PRIVATEPOOL_ID

Dengan:

PRIVATEPOOL_ID: ID pool pribadi Anda.
PRIVATEPOOL_PROJECT_ID: ID projectyang berisi pool pribadi Anda. Google Cloud
REGION: region tempat Anda membuat pool pribadi Anda.

Langkah berikutnya

Pelajari cara menjalankan build di pool pribadi.
Pelajari cara menggunakan Kontrol Layanan VPC dengan pool pribadi.

Membuat dan mengelola kumpulan pribadi Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Sebelum memulai

Membuat pool pribadi

Google Cloud Konsol

gcloud

API

Membuat pool pribadi dalam perimeter Kontrol Layanan VPC

Memperbarui pool pribadi

Konsol

gcloud

API

Melihat detail pool pribadi Anda

Konsol

gcloud

API

Melihat perkiraan harga pool pribadi

Menghapus pool pribadi

Konsol

gcloud

API

Langkah berikutnya

Membuat dan mengelola kumpulan pribadi