REST Resource: projects.locations.vmwareClusters

Resource: VmwareCluster

Resource yang mewakili cluster pengguna VMware.

##

Representasi JSON 
{
  "name": string,
  "adminClusterMembership": string,
  "description": string,
  "onPremVersion": string,
  "uid": string,
  "state": enum (State),
  "endpoint": string,
  "reconciling": boolean,
  "createTime": string,
  "updateTime": string,
  "localName": string,
  "etag": string,
  "annotations": {
    string: string,
    ...
  },
  "controlPlaneNode": {
    object (VmwareControlPlaneNodeConfig)
  },
  "antiAffinityGroups": {
    object (VmwareAAGConfig)
  },
  "storage": {
    object (VmwareStorageConfig)
  },
  "networkConfig": {
    object (VmwareNetworkConfig)
  },
  "loadBalancer": {
    object (VmwareLoadBalancerConfig)
  },
  "vcenter": {
    object (VmwareVCenterConfig)
  },
  "status": {
    object (ResourceStatus)
  },
  "dataplaneV2": {
    object (VmwareDataplaneV2Config)
  },
  "vmTrackingEnabled": boolean,
  "autoRepairConfig": {
    object (VmwareAutoRepairConfig)
  },
  "fleet": {
    object (Fleet)
  },
  "authorization": {
    object (Authorization)
  },
  "deleteTime": string,
  "validationCheck": {
    object (ValidationCheck)
  },
  "adminClusterName": string,
  "enableControlPlaneV2": boolean,
  "binaryAuthorization": {
    object (BinaryAuthorization)
  },
  "upgradePolicy": {
    object (VmwareClusterUpgradePolicy)
  },
  "disableBundledIngress": boolean
}
Kolom
name

string

Tidak dapat diubah. Nama resource cluster pengguna VMware.
adminClusterMembership

string

Wajib. Cluster admin yang menjadi bagian dari cluster pengguna VMware ini. Ini adalah nama resource lengkap dari keanggotaan fleet cluster admin. Di masa mendatang, referensi ke jenis resource lain mungkin diizinkan jika cluster admin dimodelkan sebagai resource mereka sendiri.
description

string

Deskripsi cluster pengguna VMware ini yang dapat dibaca manusia.
onPremVersion

string

Wajib. Cluster Anthos di versi VMware untuk cluster pengguna Anda.
uid

string

Hanya output. ID unik cluster pengguna VMware.
state

enum (State)

Hanya output. Status cluster pengguna VMware saat ini.
endpoint

string

Hanya output. Nama DNS server API cluster pengguna VMware.
reconciling

boolean

Hanya output. Jika ditetapkan, saat ini ada perubahan yang sedang berlangsung pada cluster pengguna VMware.
createTime

string (Timestamp format)

Hanya output. Waktu saat cluster pengguna VMware dibuat.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. Offset selain "Z" juga diterima.Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Hanya output. Waktu saat cluster pengguna VMware terakhir diperbarui.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. Offset selain "Z" juga diterima.Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
localName

string

Hanya output. Nama objek resource kustom VMware OnPremUserCluster di cluster admin terkait. Kolom ini digunakan untuk mendukung nama yang bertentangan saat mendaftarkan cluster yang ada ke API. Jika digunakan sebagai bagian dari pendaftaran cluster, kolom ini akan berbeda dengan ID dalam nama resource. Untuk cluster baru, kolom ini akan cocok dengan nama cluster yang diberikan pengguna dan akan terlihat di komponen terakhir nama resource. File ini tidak dapat diubah.

Semua pengguna harus menggunakan nama ini untuk mengakses cluster mereka menggunakan gkectl atau kubectl dan akan melihat nama lokal saat melihat log pengontrol cluster admin.
etag

string

Checksum ini dihitung oleh server berdasarkan nilai kolom lain, dan dapat dikirim pada permintaan pembaruan dan penghapusan untuk memastikan klien memiliki nilai terbaru sebelum melanjutkan. Memungkinkan klien melakukan operasi baca-ubah-tulis yang konsisten melalui kontrol serentak optimis.
annotations

map (key: string, value: string)

Anotasi pada cluster pengguna VMware. Kolom ini memiliki batasan yang sama dengan anotasi Kubernetes. Ukuran total semua kunci dan nilai yang digabungkan dibatasi hingga 256 ribu. Kunci dapat memiliki 2 segmen: awalan (opsional) dan nama (wajib), yang dipisahkan dengan garis miring (/). Awalan harus berupa subdomain DNS. Nama harus terdiri dari maksimal 63 karakter, diawali dan diakhiri dengan alfanumerik, dengan tanda hubung (-), garis bawah (_), titik (.), dan alfanumerik di antaranya.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
controlPlaneNode

object (VmwareControlPlaneNodeConfig)

Node bidang kontrol cluster pengguna VMware harus memiliki 1 atau 3 replika.
antiAffinityGroups

object (VmwareAAGConfig)

AAGConfig menentukan apakah akan menyebarkan node cluster pengguna VMware di setidaknya tiga host fisik di pusat data.
storage

object (VmwareStorageConfig)

Konfigurasi penyimpanan.
networkConfig

object (VmwareNetworkConfig)

Konfigurasi jaringan cluster pengguna VMware.
loadBalancer

object (VmwareLoadBalancerConfig)

Konfigurasi load balancer.
vcenter

object (VmwareVCenterConfig)

VmwareVCenterConfig menentukan konfigurasi vCenter untuk cluster pengguna. Jika tidak ditentukan, cluster ini akan diwarisi dari cluster admin.
status

object (ResourceStatus)

Hanya output. ResourceStatus yang mewakili status cluster mendetail.
dataplaneV2

object (VmwareDataplaneV2Config)

VmwareDataplaneV2Config menentukan konfigurasi untuk Dataplane V2.
vmTrackingEnabled

boolean

Aktifkan pelacakan VM.
autoRepairConfig

object (VmwareAutoRepairConfig)

Konfigurasi untuk perbaikan otomatis.
fleet

object (Fleet)

Hanya output. Konfigurasi fleet untuk cluster.
authorization

object (Authorization)

Kebijakan RBAC yang akan diterapkan dan dikelola oleh Anthos On-Prem API.
deleteTime

string (Timestamp format)

Hanya output. Waktu saat cluster pengguna VMware dihapus.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. Offset selain "Z" juga diterima.Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
validationCheck

object (ValidationCheck)

Hanya output. ValidationCheck mewakili hasil tugas pemeriksaan pra-penerbangan.
adminClusterName

string

Hanya output. Nama resource cluster admin VMware yang menghosting cluster pengguna ini.
enableControlPlaneV2

boolean

Aktifkan bidang kontrol V2. Defaultnya adalah salah (false).
binaryAuthorization

object (BinaryAuthorization)

Konfigurasi terkait Otorisasi Biner.
upgradePolicy

object (VmwareClusterUpgradePolicy)

Menentukan kebijakan upgrade untuk cluster.
disableBundledIngress

boolean

Nonaktifkan ingress yang dipaketkan.

Status

Status siklus proses cluster pengguna VMware.

Enum
STATE_UNSPECIFIED Belum ditetapkan.
PROVISIONING Status PROVISIONING menunjukkan bahwa cluster sedang dibuat.
RUNNING Status RUNNING menunjukkan bahwa cluster telah dibuat dan dapat digunakan sepenuhnya.
RECONCILING Status RECONCILING menunjukkan bahwa cluster sedang diperbarui. Fitur ini tetap tersedia, tetapi berpotensi mengalami penurunan performa.
STOPPING Status STOPPING menunjukkan bahwa cluster sedang dihapus.
ERROR Status ERROR menunjukkan bahwa cluster berada dalam status rusak yang tidak dapat dipulihkan.
DEGRADED Status DEGRADED menunjukkan bahwa cluster memerlukan tindakan pengguna untuk memulihkan fungsi penuh.

VmwareControlPlaneNodeConfig

Menentukan konfigurasi node bidang kontrol untuk cluster pengguna VMware.

Representasi JSON 
{
  "cpus": string,
  "memory": string,
  "replicas": string,
  "autoResizeConfig": {
    object (VmwareAutoResizeConfig)
  },
  "vsphereConfig": {
    object (VmwareControlPlaneVsphereConfig)
  }
}
Kolom
cpus

string (int64 format)

Jumlah CPU untuk setiap node cluster admin yang berfungsi sebagai bidang kontrol untuk cluster pengguna VMware ini. (default: 4 CPU)
memory

string (int64 format)

Memori dalam megabyte untuk setiap node cluster admin yang berfungsi sebagai bidang kontrol untuk cluster pengguna VMware ini (default: memori 8192 MB).
replicas

string (int64 format)

Jumlah node bidang kontrol untuk cluster pengguna VMware ini. (default: 1 replika).
autoResizeConfig

object (VmwareAutoResizeConfig)

AutoResizeConfig menyediakan konfigurasi pengubahan ukuran otomatis.
vsphereConfig

object (VmwareControlPlaneVsphereConfig)

Konfigurasi khusus Vsphere.

VmwareControlPlaneVsphereConfig

Menentukan konfigurasi node bidang kontrol.

Representasi JSON 
{
  "datastore": string,
  "storagePolicyName": string
}
Kolom
datastore

string

Datastore Vsphere yang digunakan oleh Node bidang kontrol.
storagePolicyName

string

Kebijakan penyimpanan Vsphere yang digunakan oleh Node bidang kontrol.

VmwareStorageConfig

Menentukan konfigurasi deployment komponen vSphere CSI di cluster pengguna VMware.

Representasi JSON 
{
  "vsphereCsiDisabled": boolean
}
Kolom
vsphereCsiDisabled

boolean

Apakah akan men-deploy komponen vSphere CSI di cluster pengguna VMware atau tidak. Diaktifkan secara default.

VmwareNetworkConfig

Menentukan konfigurasi jaringan untuk cluster pengguna VMware.

Representasi JSON 
{
  "serviceAddressCidrBlocks": [
    string
  ],
  "podAddressCidrBlocks": [
    string
  ],
  "vcenterNetwork": string,
  "hostConfig": {
    object (VmwareHostConfig)
  },
  "controlPlaneV2Config": {
    object (VmwareControlPlaneV2Config)
  },

  // Union field ip_configuration can be only one of the following:
  "staticIpConfig": {
    object (VmwareStaticIpConfig)
  },
  "dhcpIpConfig": {
    object (VmwareDhcpIpConfig)
  }
  // End of list of possible types for union field ip_configuration.
}
Kolom
serviceAddressCidrBlocks[]

string

Wajib. Semua layanan dalam cluster diberi alamat IPv4 RFC1918 dari rentang ini. Hanya satu rentang yang didukung. Kolom ini tidak dapat diubah setelah dibuat.
podAddressCidrBlocks[]

string

Wajib. Semua pod dalam cluster akan mendapatkan alamat IPv4 RFC1918 dari rentang ini. Hanya satu rentang yang didukung. Kolom ini tidak dapat diubah setelah dibuat.
vcenterNetwork

string

vcenterNetwork menentukan nama jaringan vCenter. Diwarisi dari cluster admin.
hostConfig

object (VmwareHostConfig)

Merepresentasikan setelan jaringan umum, terlepas dari alamat IP host.
controlPlaneV2Config

object (VmwareControlPlaneV2Config)

Konfigurasi untuk mode V2 bidang kontrol.
Kolom union ip_configuration. Jenis konfigurasi IP yang digunakan oleh cluster pengguna VMware. ip_configuration hanya ada berupa salah satu diantara berikut:
staticIpConfig

object (VmwareStaticIpConfig)

Setelan konfigurasi untuk konfigurasi IP statis.
dhcpIpConfig

object (VmwareDhcpIpConfig)

Setelan konfigurasi untuk konfigurasi IP DHCP.

VmwareControlPlaneV2Config

Menentukan konfigurasi V2 bidang kontrol.

Representasi JSON 
{
  "controlPlaneIpBlock": {
    object (VmwareIpBlock)
  }
}
Kolom
controlPlaneIpBlock

object (VmwareIpBlock)

Alamat IP statis untuk node bidang kontrol.

VmwareLoadBalancerConfig

Menentukan konfigurasi load balancer lokal untuk cluster pengguna VMware.

Representasi JSON 
{
  "vipConfig": {
    object (VmwareVipConfig)
  },

  // Union field load_balancer_configuration can be only one of the following:
  "f5Config": {
    object (VmwareF5BigIpConfig)
  },
  "manualLbConfig": {
    object (VmwareManualLbConfig)
  },
  "seesawConfig": {
    object (VmwareSeesawConfig)
  },
  "metalLbConfig": {
    object (VmwareMetalLbConfig)
  }
  // End of list of possible types for union field load_balancer_configuration.
}
Kolom
vipConfig

object (VmwareVipConfig)

VIP yang digunakan oleh load balancer.
Kolom union load_balancer_configuration. Konfigurasi load balancer yang akan digunakan di cluster pengguna. load_balancer_configuration hanya ada berupa salah satu diantara berikut:
f5Config

object (VmwareF5BigIpConfig)

Konfigurasi untuk load balancer berjenis F5 Big IP.
manualLbConfig

object (VmwareManualLbConfig)

Load balancer yang dikonfigurasi secara manual.
seesawConfig

object (VmwareSeesawConfig)

Hanya output. Konfigurasi untuk load balancer berjenis Seesaw.
metalLbConfig

object (VmwareMetalLbConfig)

Konfigurasi untuk load balancer berjenis MetalLB.

VmwareVipConfig

Menentukan konfigurasi VIP untuk load balancer cluster pengguna VMware.

Representasi JSON 
{
  "controlPlaneVip": string,
  "ingressVip": string
}
Kolom
controlPlaneVip

string

VIP yang sebelumnya Anda sisihkan untuk Kubernetes API cluster ini.
ingressVip

string

VIP yang sebelumnya Anda sisihkan untuk traffic masuk ke cluster ini.

VmwareF5BigIpConfig

Merepresentasikan parameter konfigurasi untuk load balancer F5 BIG-IP.

Representasi JSON 
{
  "address": string,
  "partition": string,
  "snatPool": string
}
Kolom
address

string

Alamat IP load balancer.
partition

string

Partisi yang sudah ada yang akan digunakan oleh load balancer. Partisi ini biasanya dibuat untuk cluster admin, misalnya: 'my-f5-admin-partition'.
snatPool

string

Nama kumpulan. Hanya diperlukan, jika menggunakan SNAT.

VmwareManualLbConfig

Merepresentasikan parameter konfigurasi untuk load balancer manual yang sudah ada. Mengingat sifat load balancer manual, load balancer tersebut diharapkan akan dikelola sepenuhnya oleh pengguna.

PENTING: Perhatikan bahwa Anthos On-Prem API tidak akan membuat atau memperbarui konfigurasi ManualLB. API ini hanya dapat mengikat konfigurasi yang sudah ada ke cluster pengguna VMware baru.

Representasi JSON 
{
  "ingressHttpNodePort": integer,
  "ingressHttpsNodePort": integer,
  "controlPlaneNodePort": integer,
  "konnectivityServerNodePort": integer
}
Kolom
ingressHttpNodePort

integer

NodePort untuk http layanan ingress. Layanan ingress di cluster admin diterapkan sebagai Layanan jenis NodePort (mis. 32527).
ingressHttpsNodePort

integer

NodePort untuk https layanan ingress. Layanan ingress di cluster admin diterapkan sebagai Layanan jenis NodePort (mis. 30139).
controlPlaneNodePort

integer

NodePort untuk layanan bidang kontrol. Server Kubernetes API di cluster admin diterapkan sebagai Layanan jenis NodePort (mis. 30968).
konnectivityServerNodePort

integer

NodePort untuk layanan server konektivitas yang berjalan sebagai sidecar di setiap pod kube-apiserver (mis. 30564).

VmwareSeesawConfig

VmwareSeesawConfig mewakili parameter konfigurasi untuk load balancer Seesaw yang sudah ada.

PENTING: Perhatikan bahwa Anthos On-Prem API tidak akan membuat atau memperbarui konfigurasi Seesaw. API ini hanya dapat mengikat konfigurasi yang sudah ada ke cluster pengguna baru.

PENTING: Saat mencoba membuat cluster pengguna dengan load balancer Seesaw yang sudah ada, Anda harus mengikuti beberapa langkah persiapan sebelum memanggil metode API 'vmwareClusters.create'. Pertama, Anda harus membuat namespace cluster pengguna melalui kubectl. Namespace harus menggunakan konvensi penamaan berikut : -gke-onprem-mgmt atau -gke-onprem-mgmt, bergantung pada apakah Anda menggunakan 'VmwareCluster.local_name' untuk membedakan tabrakan; untuk konteks selengkapnya, lihat dokumentasi 'VmwareCluster.local_name'. Setelah namespace dibuat, Anda harus membuat resource secret melalui kubectl. Secret ini akan berisi salinan kredensial Seesaw Anda. Secret harus diberi nama 'user-cluster-creds' dan berisi kredensial SSH dan Sertifikat Seesaw. Kredensial harus diberi kunci dengan nama berikut: 'seesaw-ssh-private-key', 'seesaw-ssh-public-key', 'seesaw-ssh-ca-key', 'seesaw-ssh-ca-cert'.

Representasi JSON 
{
  "group": string,
  "masterIp": string,
  "ipBlocks": [
    {
      object (VmwareIpBlock)
    }
  ],
  "enableHa": boolean,
  "vms": [
    string
  ],
  "stackdriverName": string
}
Kolom
group

string

Wajib. Secara umum, format berikut harus digunakan untuk nama grup Seesaw: seesaw-for-[clusterName].
masterIp

string

Wajib. MasterIP adalah IP yang diumumkan oleh master grup Seesaw.
ipBlocks[]

object (VmwareIpBlock)

Wajib. Blok IP yang akan digunakan oleh load balancer Seesaw
enableHa

boolean

Aktifkan dua VM load balancer untuk mendapatkan load balancer Seesaw yang sangat tersedia.
vms[]

string

Nama VM yang dibuat untuk grup Seesaw ini.
stackdriverName

string

Nama yang akan digunakan oleh Stackdriver.

VmwareMetalLbConfig

Merepresentasikan parameter konfigurasi untuk load balancer MetalLB.

Representasi JSON 
{
  "addressPools": [
    {
      object (VmwareAddressPool)
    }
  ]
}
Kolom
addressPools[]

object (VmwareAddressPool)

Wajib. AddressPools adalah daftar kumpulan IP yang tidak tumpang-tindih yang digunakan oleh layanan berjenis load balancer. Semua alamat harus dapat dirutekan ke node load balancer. IngressVIP harus disertakan dalam kumpulan.

VmwareAddressPool

Merepresentasikan kumpulan IP yang digunakan oleh load balancer.

Representasi JSON 
{
  "pool": string,
  "addresses": [
    string
  ],
  "avoidBuggyIps": boolean,
  "manualAssign": boolean
}
Kolom
pool

string

Wajib. Nama kumpulan alamat.
addresses[]

string

Wajib. Alamat yang merupakan bagian dari kumpulan ini. Setiap alamat harus dalam bentuk CIDR (1.2.3.0/24) atau bentuk rentang (1.2.3.1-1.2.3.5).
avoidBuggyIps

boolean

Jika benar, hindari penggunaan IP yang diakhiri dengan .0 atau .255. Hal ini menghindari perangkat konsumen yang bermasalah yang keliru menghapus traffic IPv4 untuk alamat IP khusus tersebut.
manualAssign

boolean

Jika benar, cegah alamat IP ditetapkan secara otomatis.

VmwareVCenterConfig

Merepresentasikan konfigurasi untuk VMware VCenter untuk cluster pengguna.

Representasi JSON 
{
  "resourcePool": string,
  "datastore": string,
  "datacenter": string,
  "cluster": string,
  "folder": string,
  "caCertData": string,
  "address": string,
  "storagePolicyName": string
}
Kolom
resourcePool

string

Nama kumpulan resource vCenter untuk cluster pengguna.
datastore

string

Nama datastore vCenter untuk cluster pengguna.
datacenter

string

Nama datacenter vCenter untuk cluster pengguna.
cluster

string

Nama cluster vCenter untuk cluster pengguna.
folder

string

Nama folder vCenter untuk cluster pengguna.
caCertData

string

Berisi kunci publik sertifikat CA vCenter untuk verifikasi SSL.
address

string

Hanya output. Alamat IP vCenter.
storagePolicyName

string

Nama kebijakan penyimpanan vCenter untuk cluster pengguna.

VmwareDataplaneV2Config

Berisi konfigurasi untuk Dataplane V2, yang merupakan dataplane yang dioptimalkan untuk jaringan Kubernetes. Untuk informasi selengkapnya, lihat: https://cloud.google.com/kubernetes-engine/docs/concepts/dataplane-v2

Representasi JSON 
{
  "dataplaneV2Enabled": boolean,
  "windowsDataplaneV2Enabled": boolean,
  "advancedNetworking": boolean,
  "forwardMode": string
}
Kolom
dataplaneV2Enabled

boolean

Mengaktifkan Dataplane V2.
windowsDataplaneV2Enabled

boolean

Mengaktifkan Dataplane V2 untuk cluster dengan node Windows.
advancedNetworking

boolean

Mengaktifkan jaringan lanjutan yang mengharuskan dataplaneV2Enabled ditetapkan ke benar.
forwardMode

string

Mengonfigurasi ForwardMode untuk Dataplane v2.

VmwareClusterUpgradePolicy

VmwareClusterUpgradePolicy menentukan kebijakan upgrade cluster.

Representasi JSON 
{
  "controlPlaneOnly": boolean
}
Kolom
controlPlaneOnly

boolean

Mengontrol apakah upgrade hanya berlaku untuk bidang kontrol.

Metode

create

 Membuat cluster pengguna VMware baru di project dan lokasi tertentu.

delete

 Menghapus satu Cluster VMware.

enroll

 Mendaftarkan cluster pengguna VMware yang ada dan node pool-nya ke Anthos On-Prem API dalam project dan lokasi tertentu.

get

 Mendapatkan detail satu Cluster VMware.

list

 Mencantumkan Cluster VMware di project dan lokasi tertentu.

patch

 Memperbarui parameter satu cluster VMware.

queryVersionConfig

 Membuat kueri konfigurasi versi cluster pengguna VMware.