Skema file konfigurasi kumpulan pribadi

File konfigurasi kumpulan pribadi (file konfigurasi kumpulan pribadi) berisi petunjuk bagi Cloud Build untuk membuat kumpulan pribadi berdasarkan spesifikasi Anda. File konfigurasi kumpulan pribadi berisi informasi seperti ukuran disk dan jenis mesin yang ingin Anda gunakan untuk kumpulan pribadi Anda. File konfigurasi kumpulan pribadi diperlukan saat Anda membuat dan mengelola kumpulan pribadi menggunakan alat gcloud atau Cloud Build API.

Struktur file konfigurasi kumpulan pribadi

Anda dapat menulis file konfigurasi kumpulan pribadi menggunakan sintaksis YAML atau JSON. Untuk membuat dan mengelola kumpulan pribadi menggunakan curl, tulis file konfigurasi kumpulan pribadi dalam format JSON. Untuk membuat dan mengelola pool pribadi menggunakan alat gcloud, tulis file konfigurasi pool pribadi dalam format YAML atau JSON.

File konfigurasi pool pribadi memiliki struktur berikut:

privatePoolV1Config:
  networkConfig:
    egressOption: NO_PUBLIC_EGRESS
    peeredNetwork: 'PEERED_NETWORK'
    peeredNetworkIpRange: 'PEERED_NETWORK_IP_RANGE'
  workerConfig:
    diskSizeGb: 'PRIVATE_POOL_DISK_SIZE'
    machineType: PRIVATE_POOL_MACHINE_TYPE

{
  "privatePoolV1Config": {
    "networkConfig": {
      "egressOption": "NO_PUBLIC_EGRESS",
      "peeredNetwork": "PEERED_NETWORK",
      "peeredNetworkIpRange": "PEERED_NETWORK_IP_RANGE"
    },
    "workerConfig": {
      "diskSizeGb": "PRIVATE_POOL_DISK_SIZE",
      "machineType": "PRIVATE_POOL_MACHINE_TYPE"
    }
  }
}

Kolom dalam file konfigurasi kumpulan pribadi dijelaskan sebagai berikut:

networkConfig

Kolom ini bersifat opsional. Tentukan networkConfig hanya jika Anda melakukan peering jaringan VPC dengan jaringan produsen layanan.

egressOption

Kolom ini bersifat opsional. Tetapkan nilai kolom ini ke NO_PUBLIC_EGRESS jika Anda membuat pool pribadi dalam perimeter Kontrol Layanan VPC. Jika Anda tidak menyertakan kolom ini dalam file konfigurasi kumpulan pribadi, egress publik akan diaktifkan. Untuk mengetahui informasi tentang cara menyiapkan Kontrol Layanan VPC untuk kumpulan pribadi, lihat Menggunakan Kontrol Layanan VPC.

peeredNetwork

Kolom ini wajib diisi jika file konfigurasi pool pribadi Anda berisi kolom networkConfig. Tetapkan nilai kolom ini ke URL resource jaringan dari jaringan VPC yang di-peering ke jaringan produsen layanan. URL resource jaringan harus dalam format projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME, dengan NETWORK_PROJECT_ID adalah ID project dari project Google Cloud yang menyimpan jaringan VPC Anda dan NETWORK_NAME adalah nama jaringan VPC Anda. Jika Anda tidak menentukan nilai, Cloud Build akan menggunakan jaringan produsen layanan secara default.

peeredNetworkIpRange

Kolom ini bersifat opsional. Tetapkan nilai kolom ini untuk menentukan rentang IP internal yang dapat ditetapkan ke VM dalam rentang yang dialokasikan jaringan yang di-peering. Jika rentang IP yang ditentukan tidak dapat dialokasikan dalam rentang koneksi pribadi, misalnya karena batasan ukuran atau IP awal yang tidak valid, maka kumpulan pribadi tidak dapat dibuat.

peeredNetworkIpRange ditentukan menggunakan notasi Classless Inter-Domain Routing (CIDR) dalam format 'STARTING_IP/SUBNET_PREFIX_SIZE'. Jika kolom ini digunakan, SUBNET_PREFIX_SIZE harus ditentukan. SUBNET_PREFIX_SIZE menentukan ukuran rentang IP. Harus diawali dengan garis miring (/) dan memiliki nilai kurang dari atau sama dengan 29.Bagian STARTING_IP bersifat opsional, dan menentukan alamat awal rentang. Jika STARTING_IP tidak ditentukan, alamat awal akan otomatis ditetapkan dari dalam rentang koneksi pribadi. Jika tidak ada nilai yang ditentukan untuk peeredNetworkIpRange, nilai default /24 akan digunakan yang secara otomatis menetapkan IP awal dengan rentang 256 IP.

Nilai SUBNET_PREFIX_SIZE tidak boleh melebihi 29. Angka yang lebih besar menentukan awalan subnet yang lebih besar, yang akan menyisakan lebih sedikit kemungkinan IP dan menghasilkan rentang IP yang lebih kecil. Karena alamat IP adalah 32 bit, ukuran awalan /24 memungkinkan 256 kemungkinan IP dalam rentang (delapan bit), sedangkan ukuran awalan /29 menyisakan delapan kemungkinan IP (tiga bit). Jumlah maksimum VM builder dibatasi hingga jumlah IP yang dapat digunakan dalam rentang (jumlah total IP yang mungkin dalam rentang dikurangi dua).

Lihat contoh kolom peeredNetworkIpRange berikut:

• 192.168.0.0/24 menentukan rentang IP yang dimulai dari 192.168.0.0 dengan ukuran awalan subnet 24 (256 IP, dengan 254 IP yang dapat digunakan).
• /29 menentukan rentang dengan IP awal yang ditentukan secara otomatis dan ukuran awalan subnet 29 (delapan IP, dengan enam IP yang dapat digunakan).

workerConfig

Kolom ini wajib diisi. File ini berisi opsi konfigurasi untuk kumpulan pribadi Anda.

diskSizeGb

Kolom ini bersifat opsional. Gunakan kolom ini untuk menentukan ukuran disk untuk instance pool pribadi Anda dalam GB. Tentukan nilai yang lebih besar dari atau sama dengan 100 dan kurang dari atau sama dengan 4000. Jika Anda tidak menyertakan kolom ini dalam file konfigurasi pool pribadi, atau jika Anda menentukan 0 sebagai nilai kolom ini, Cloud Build akan menggunakan nilai default 100.

machineType

Kolom ini bersifat opsional. Gunakan kolom ini untuk menentukan jenis mesin Compute Engine untuk instance kumpulan pribadi Anda. Jika Anda tidak menentukan nilai, Cloud Build akan menggunakan nilai default e2-medium. Jika tidak, tentukan salah satu jenis mesin berikut:

Tabel berikut menunjukkan ketersediaan jenis mesin menurut region:

enableNestedVirtualization

Kolom ini bersifat opsional. Jika kumpulan pribadi Anda menggunakan VM dengan jenis mesin C3, Anda dapat mengaktifkan virtualisasi bertingkat untuk menjalankan instance VM lain di dalam VM kumpulan pribadi Anda. Untuk mengetahui informasi selengkapnya, lihat Tentang virtualisasi bertingkat.

Langkah berikutnya

• Pelajari cara menjalankan build di pool pribadi.
• Pelajari cara membuat dan mengelola pool pribadi.