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 digunakan 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 mengetahui informasi tentang cara menyiapkan Kontrol Layanan VPC untuk kumpulan pribadi, lihat Menggunakan Kontrol Layanan VPC.

peeredNetwork

Kolom ini wajib diisi jika file konfigurasi kumpulan pribadi Anda berisi kolom networkConfig. Setel 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 sebagai 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 ke VM dalam rentang yang dialokasikan untuk jaringan yang di-peering. Jika rentang IP yang ditentukan tidak dapat dialokasikan dalam rentang koneksi pribadi, misalnya karena keterbatasan ukuran atau IP awal yang tidak valid, 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. Nama ini 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 lebih dari 29. Angka yang lebih besar menentukan awalan subnet yang lebih besar, sehingga menghasilkan IP yang lebih sedikit 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 pada jumlah IP yang dapat digunakan dalam rentang (jumlah total yang memungkinkan IP dalam rentang dikurangi dua).

Lihat contoh kolom peeredNetworkIpRange berikut ini:

  • 192.168.0.0/24 menentukan rentang IP mulai 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 instance pool pribadi Anda dalam GB. Tentukan nilai yang lebih besar dari atau sama dengan 100 dan kurang dari atau sama dengan 2000. 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 gabungan 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-medium.

Langkah selanjutnya