Skema file konfigurasi kumpulan pribadi

File konfigurasi kumpulan pribadi (file konfigurasi kumpulan pribadi) berisi petunjuk untuk Cloud Build guna membuat kumpulan pribadi berdasarkan spesifikasi Anda. File konfigurasi kumpulan pribadi berisi informasi seperti ukuran disk dan jenis komputer yang ingin Anda gunakan untuk kumpulan pribadi. 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 kumpulan pribadi menggunakan alat gcloud, tulis file konfigurasi kumpulan pribadi dalam format YAML atau JSON.

File konfigurasi kumpulan pribadi memiliki struktur berikut:

YAML 

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

JSON 

{
  "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 di bawah:

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 kumpulan pribadi dalam perimeter Kontrol Layanan VPC. Jika Anda tidak menyertakan kolom ini dalam file konfigurasi kumpulan pribadi, traffic keluar publik akan diaktifkan. Untuk informasi tentang cara menyiapkan Kontrol Layanan VPC untuk kumpulan pribadi, lihat Menggunakan Kontrol Layanan VPC.

peeredNetwork

Ini adalah kolom wajib jika file konfigurasi kumpulan pribadi Anda berisi kolom networkConfig. Tetapkan nilai kolom ini ke URL resource 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 project ID 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 untuk VM dalam rentang yang dialokasikan jaringan peer. Jika rentang IP yang ditentukan tidak dapat dialokasikan dalam rentang koneksi pribadi, misalnya karena batasan ukuran atau IP awal yang tidak valid, kumpulan IP 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. Nilai ini harus dimulai 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 mengurangi 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 (total kemungkinan jumlah IP 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 kumpulan pribadi Anda dalam GB. Tentukan nilai yang lebih besar dari atau sama dengan 100 dan kurang dari atau sama dengan 2.000. Jika Anda tidak menyertakan kolom ini dalam file konfigurasi kumpulan 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. Tentukan salah satu jenis mesin berikut:

  • e2-medium
  • e2-standard-2
  • e2-standard-4
  • e2-standard-8
  • e2-standard-16
  • e2-standard-32
  • e2-highmem-2
  • e2-highmem-4
  • e2-highmem-8
  • e2-highmem-16
  • e2-highcpu-2
  • e2-highcpu-4
  • e2-highcpu-8
  • e2-highcpu-16
  • e2-highcpu-32

Jika Anda tidak menentukan nilai, Cloud Build akan menggunakan nilai default e2-standard-2.

Langkah selanjutnya