REST Resource: projects.locations.vmwareClusters

Risorsa: VmwareCluster

Risorsa che rappresenta un cluster utente VMware.

##

Rappresentazione 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
}
Campi
name

string

Immutabile. Il nome della risorsa del cluster utente VMware.
adminClusterMembership

string

Obbligatorio. Il cluster di amministrazione a cui appartiene questo cluster utente VMware. Si tratta del nome completo della risorsa dell'appartenenza al parco risorse del cluster di amministrazione. In futuro, i riferimenti ad altri tipi di risorse potrebbero essere consentiti se i cluster di amministratori vengono modellati come risorse proprie.
description

string

Una descrizione leggibile di questo cluster utente VMware.
onPremVersion

string

Obbligatorio. La versione di Cluster Anthos on VMware per il tuo cluster utente.
uid

string

Solo output. L'identificatore univoco del cluster utente VMware.
state

enum (State)

Solo output. Lo stato attuale del cluster utente VMware.
endpoint

string

Solo output. Il nome DNS del server API del cluster utente VMware.
reconciling

boolean

Solo output. Se impostato, al momento sono in corso modifiche al cluster utente VMware.
createTime

string (Timestamp format)

Solo output. L'ora in cui è stato creato il cluster utente VMware.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. L'ora dell'ultimo aggiornamento del cluster utente VMware.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
localName

string

Solo output. Il nome dell'oggetto della risorsa personalizzata VMware OnPremUserCluster nel cluster di amministrazione associato. Questo campo viene utilizzato per supportare i nomi in conflitto durante la registrazione di cluster esistenti nell'API. Se utilizzato nell'ambito della registrazione del cluster, questo campo sarà diverso dall'ID nel nome della risorsa. Per i nuovi cluster, questo campo corrisponderà al nome del cluster fornito dall'utente e sarà visibile nell'ultimo componente del nome della risorsa. Non è modificabile.

Tutti gli utenti devono utilizzare questo nome per accedere al cluster utilizzando gkectl o kubectl e devono aspettarsi di vedere il nome locale quando visualizzano i log del controller del cluster di amministrazione.
etag

string

Questo checksum viene calcolato dal server in base al valore di altri campi e può essere inviato per le richieste di aggiornamento ed eliminazione per garantire che il client abbia un valore aggiornato prima di procedere. Consente ai client di eseguire letture, modifiche e scritture coerenti tramite il controllo della concorrenza ottimistico.
annotations

map (key: string, value: string)

Annotazioni sul cluster utente VMware. Questo campo ha le stesse limitazioni delle annotazioni Kubernetes. La dimensione totale di tutte le chiavi e i valori combinati è limitata a 256 KB. La chiave può avere due segmenti: un prefisso (facoltativo) e un nome (obbligatorio), separati da una barra (/). Il prefisso deve essere un sottodominio DNS. Il nome deve avere una lunghezza massima di 63 caratteri, deve iniziare e terminare con caratteri alfanumerici e può comprendere trattini (-), trattini bassi (_), punti (.) e caratteri alfanumerici.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
controlPlaneNode

object (VmwareControlPlaneNodeConfig)

I nodi del control plane del cluster utente VMware devono avere 1 o 3 repliche.
antiAffinityGroups

object (VmwareAAGConfig)

AAGConfig specifica se distribuire i nodi del cluster utente VMware su almeno tre host fisici del data center.
storage

object (VmwareStorageConfig)

Configurazione dello spazio di archiviazione.
networkConfig

object (VmwareNetworkConfig)

La configurazione di rete del cluster utente VMware.
loadBalancer

object (VmwareLoadBalancerConfig)

Configurazione del bilanciatore del carico.
vcenter

object (VmwareVCenterConfig)

VmwareVCenterConfig specifica la configurazione di vCenter per il cluster utente. Se non specificato, viene ereditato dal cluster di amministrazione.
status

object (ResourceStatus)

Solo output. ResourceStatus che rappresenta lo stato dettagliato del cluster.
dataplaneV2

object (VmwareDataplaneV2Config)

VmwareDataplaneV2Config specifica la configurazione per Dataplane V2.
vmTrackingEnabled

boolean

Attiva il monitoraggio delle VM.
autoRepairConfig

object (VmwareAutoRepairConfig)

Configurazione per la riparazione automatica.
fleet

object (Fleet)

Solo output. Configurazione del parco risorse per il cluster.
authorization

object (Authorization)

Criterio RBAC che verrà applicato e gestito dall'API Anthos On-Prem.
deleteTime

string (Timestamp format)

Solo output. La data e l'ora in cui è stato eliminato il cluster utente VMware.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
validationCheck

object (ValidationCheck)

Solo output. ValidationCheck rappresenta il risultato del job di controllo preliminare.
adminClusterName

string

Solo output. Il nome della risorsa del cluster di amministrazione VMware che ospita questo cluster utente.
enableControlPlaneV2

boolean

Abilita il control plane V2. Il valore predefinito è false.
binaryAuthorization

object (BinaryAuthorization)

Configurazioni relative all'autorizzazione binaria.
upgradePolicy

object (VmwareClusterUpgradePolicy)

Specifica il criterio di upgrade per il cluster.
disableBundledIngress

boolean

Disattiva il traffico in entrata in bundle.

Stato

Lo stato del ciclo di vita del cluster utente VMware.

Enum
STATE_UNSPECIFIED Non impostato.
PROVISIONING Lo stato PROVISIONING indica che il cluster è in fase di creazione.
RUNNING Lo stato RUNNING indica che il cluster è stato creato ed è completamente utilizzabile.
RECONCILING Lo stato RECONCILING indica che il cluster è in fase di aggiornamento. Rimane disponibile, ma con un potenziale calo delle prestazioni.
STOPPING Lo stato STOPPING indica che il cluster è in fase di eliminazione.
ERROR Lo stato ERROR indica che il cluster è in uno stato non recuperabile non funzionante.
DEGRADED Lo stato DEGRADED indica che il cluster richiede un'azione da parte dell'utente per ripristinare la funzionalità completa.

VmwareControlPlaneNodeConfig

Specifica la configurazione del nodo del piano di controllo per il cluster utente VMware.

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

string (int64 format)

Il numero di CPU per ciascun nodo del cluster di amministrazione che funge da control plane per questo cluster utente VMware. (valore predefinito: 4 CPU)
memory

string (int64 format)

La quantità di megabyte di memoria per ogni nodo del cluster di amministrazione che funge da control plane per questo cluster utente VMware (valore predefinito: 8192 MB di memoria).
replicas

string (int64 format)

Il numero di nodi del piano di controllo per questo cluster utente VMware. (valore predefinito: 1 replica).
autoResizeConfig

object (VmwareAutoResizeConfig)

AutoResizeConfig fornisce configurazioni di ridimensionamento automatico.
vsphereConfig

object (VmwareControlPlaneVsphereConfig)

Configurazione specifica per Vsphere.

VmwareControlPlaneVsphereConfig

Specifica la configurazione del nodo del piano di controllo.

Rappresentazione JSON 
{
  "datastore": string,
  "storagePolicyName": string
}
Campi
datastore

string

Il data store Vsphere utilizzato dal nodo del control plane.
storagePolicyName

string

Il criterio di archiviazione Vsphere utilizzato dal nodo del control plane.

VmwareStorageConfig

Specifica la configurazione di deployment dei componenti CSI di vSphere nel cluster utente VMware.

Rappresentazione JSON 
{
  "vsphereCsiDisabled": boolean
}
Campi
vsphereCsiDisabled

boolean

Se eseguire o meno il deployment dei componenti CSI di vSphere nel cluster utente VMware. Abilitato per impostazione predefinita.

VmwareNetworkConfig

Specifica la configurazione di rete per il cluster utente VMware.

Rappresentazione 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.
}
Campi
serviceAddressCidrBlocks[]

string

Obbligatorio. A tutti i servizi del cluster viene assegnato un indirizzo IPv4 RFC1918 da questi intervalli. È supportato un solo intervallo. Questo campo non può essere modificato dopo la creazione.
podAddressCidrBlocks[]

string

Obbligatorio. A tutti i pod del cluster viene assegnato un indirizzo IPv4 RFC1918 da questi intervalli. È supportato un solo intervallo. Questo campo non può essere modificato dopo la creazione.
vcenterNetwork

string

vcenterNetwork specifica il nome della rete vCenter. Ereditato dal cluster di amministrazione.
hostConfig

object (VmwareHostConfig)

Rappresenta le impostazioni di rete comuni, indipendentemente dall'indirizzo IP dell'host.
controlPlaneV2Config

object (VmwareControlPlaneV2Config)

Configurazione per la modalità del piano di controllo V2.
Campo unione ip_configuration. Il tipo di configurazione IP utilizzata dal cluster utente VMware. ip_configuration può essere solo uno dei seguenti:
staticIpConfig

object (VmwareStaticIpConfig)

Impostazioni di configurazione per una configurazione IP statica.
dhcpIpConfig

object (VmwareDhcpIpConfig)

Impostazioni di configurazione per una configurazione IP DHCP.

VmwareControlPlaneV2Config

Specifica la configurazione del control plane V2.

Rappresentazione JSON 
{
  "controlPlaneIpBlock": {
    object (VmwareIpBlock)
  }
}
Campi
controlPlaneIpBlock

object (VmwareIpBlock)

Indirizzi IP statici per i nodi del control plane.

VmwareLoadBalancerConfig

Specifica la configurazione del bilanciatore locale per il cluster utente VMware.

Rappresentazione 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.
}
Campi
vipConfig

object (VmwareVipConfig)

I VIP utilizzati dal bilanciatore del carico.
Campo unione load_balancer_configuration. La configurazione del bilanciatore del carico da utilizzare nel cluster utente. load_balancer_configuration può essere solo uno dei seguenti:
f5Config

object (VmwareF5BigIpConfig)

Configurazione per i bilanciatori del carico di tipo F5 Big IP.
manualLbConfig

object (VmwareManualLbConfig)

Bilanciatori del carico configurati manualmente.
seesawConfig

object (VmwareSeesawConfig)

Solo output. Configurazione per i bilanciatori del carico con tipo Seesaw.
metalLbConfig

object (VmwareMetalLbConfig)

Configurazione per i bilanciatori del carico con tipi MetalLB.

VmwareVipConfig

Specifica la configurazione VIP per il bilanciatore del carico del cluster utente VMware.

Rappresentazione JSON 
{
  "controlPlaneVip": string,
  "ingressVip": string
}
Campi
controlPlaneVip

string

L'IP virtuale che hai riservato in precedenza per l'API Kubernetes di questo cluster.
ingressVip

string

Il VIP che hai riservato in precedenza per il traffico in entrata in questo cluster.

VmwareF5BigIpConfig

Rappresenta i parametri di configurazione di un bilanciatore del carico F5 BIG-IP.

Rappresentazione JSON 
{
  "address": string,
  "partition": string,
  "snatPool": string
}
Campi
address

string

L'indirizzo IP del bilanciatore del carico.
partition

string

La partizione esistente da utilizzare dal bilanciatore del carico. In genere, questa partizione viene creata per il cluster di amministrazione, ad esempio "my-f5-admin-partition".
snatPool

string

Il nome del pool. Obbligatorio solo se utilizzi SNAT.

VmwareManualLbConfig

Rappresenta i parametri di configurazione di un bilanciatore del carico manuale già esistente. Data la natura dei bilanciatori del carico manuali, è previsto che questi ultimi vengano gestiti completamente dagli utenti.

IMPORTANTE: tieni presente che l'API Anthos On-Prem non genera né aggiorna le configurazioni di bilanciamento del carico manuale, ma può solo associare una configurazione preesistente a un nuovo cluster utente VMware.

Rappresentazione JSON 
{
  "ingressHttpNodePort": integer,
  "ingressHttpsNodePort": integer,
  "controlPlaneNodePort": integer,
  "konnectivityServerNodePort": integer
}
Campi
ingressHttpNodePort

integer

Porta Node per il servizio in entrata HTTP. Il servizio in entrata nel cluster di amministrazione è implementato come servizio di tipo NodePort (ad es. 32527).
ingressHttpsNodePort

integer

Porta Node per il protocollo HTTPS del servizio di ingresso. Il servizio in entrata nel cluster di amministrazione è implementato come servizio di tipo NodePort (ad es. 30139).
controlPlaneNodePort

integer

NodePort per il servizio del control plane. Il server API Kubernetes nel cluster di amministrazione è implementato come servizio di tipo NodePort (ad es. 30968).
konnectivityServerNodePort

integer

NodePort per il servizio del server di connettività in esecuzione come sidecar in ogni pod kube-apiserver (ad es. 30564).

VmwareSeesawConfig

VmwareSeesawConfig rappresenta i parametri di configurazione per un bilanciatore del carico Seesaw già esistente.

IMPORTANTE: tieni presente che l'API Anthos On-Prem non genera né aggiorna le configurazioni di Seesaw, ma può solo associare una configurazione preesistente a un nuovo cluster di utenti.

IMPORTANTE: quando cerchi di creare un cluster utente con un bilanciatore del carico Seesaw preesistente, devi seguire alcuni passaggi di preparazione prima di chiamare il metodo dell'API "vmwareClusters.create". Innanzitutto, devi creare lo spazio dei nomi del cluster utente tramite kubectl. Lo spazio dei nomi dovrà utilizzare la seguente convenzione di denominazione : -gke-onprem-mgmt o -gke-onprem-mgmt a seconda che tu abbia utilizzato "VmwareCluster.local_name" per distinguere le collisioni. Per ulteriori informazioni, consulta la documentazione di "VmwareCluster.local_name". Una volta creato lo spazio dei nomi, dovrai creare una risorsa secret tramite kubectl. Questo segreto conterrà copie delle tue credenziali di Seesaw. Il secret deve chiamarsi "user-cluster-creds" e contenere le credenziali SSH e del certificato di Seesaw. Le credenziali devono essere contrassegnate con i seguenti nomi: "seesaw-ssh-private-key", "seesaw-ssh-public-key", "seesaw-ssh-ca-key", "seesaw-ssh-ca-cert".

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

string

Obbligatorio. In genere, per il nome del gruppo Seesaw deve essere utilizzato il seguente formato: seesaw-for-[clusterName].
masterIp

string

Obbligatorio. MasterIP è l'IP annunciato dal master del gruppo Seesaw.
ipBlocks[]

object (VmwareIpBlock)

Obbligatorio. I blocchi IP da utilizzare dal bilanciatore del carico Seesaw
enableHa

boolean

Attiva due VM bilanciatore del carico per ottenere un bilanciatore del carico Seesaw ad alta disponibilità.
vms[]

string

Nomi delle VM create per questo gruppo Seesaw.
stackdriverName

string

Nome da utilizzare da parte di Stackdriver.

VmwareMetalLbConfig

Rappresenta i parametri di configurazione per il bilanciatore del carico MetalLB.

Rappresentazione JSON 
{
  "addressPools": [
    {
      object (VmwareAddressPool)
    }
  ]
}
Campi
addressPools[]

object (VmwareAddressPool)

Obbligatorio. AddressPools è un elenco di pool di IP che non si sovrappongono utilizzati dai servizi di tipo bilanciatore del carico. Tutti gli indirizzi devono essere instradabili ai nodi del bilanciatore del carico. IngressVIP deve essere incluso nei pool.

VmwareAddressPool

Rappresenta un pool di IP utilizzato dal bilanciatore del carico.

Rappresentazione JSON 
{
  "pool": string,
  "addresses": [
    string
  ],
  "avoidBuggyIps": boolean,
  "manualAssign": boolean
}
Campi
pool

string

Obbligatorio. Il nome del pool di indirizzi.
addresses[]

string

Obbligatorio. Gli indirizzi che fanno parte di questo pool. Ogni indirizzo deve essere nel formato CIDR (1.2.3.0/24) o nell'intervallo (1.2.3.1-1.2.3.5).
avoidBuggyIps

boolean

Se il valore è true, evita di utilizzare indirizzi IP che terminano con .0 o .255. In questo modo, i dispositivi consumer con bug non interrompono per errore il traffico IPv4 per questi indirizzi IP speciali.
manualAssign

boolean

Se true, impedisce l'assegnazione automatica degli indirizzi IP.

VmwareVCenterConfig

Rappresenta la configurazione di VMware vCenter per il cluster utente.

Rappresentazione JSON 
{
  "resourcePool": string,
  "datastore": string,
  "datacenter": string,
  "cluster": string,
  "folder": string,
  "caCertData": string,
  "address": string,
  "storagePolicyName": string
}
Campi
resourcePool

string

Il nome del pool di risorse vCenter per il cluster utente.
datastore

string

Il nome del datastore vCenter per il cluster utente.
datacenter

string

Il nome del data center vCenter per il cluster utente.
cluster

string

Il nome del cluster vCenter per il cluster utente.
folder

string

Il nome della cartella vCenter per il cluster utente.
caCertData

string

Contiene la chiave pubblica del certificato CA vCenter per la verifica SSL.
address

string

Solo output. L'indirizzo IP di vCenter.
storagePolicyName

string

Il nome del criterio di archiviazione vCenter per il cluster utente.

VmwareDataplaneV2Config

Contiene le configurazioni per Dataplane V2, il dataplane ottimizzato per la rete Kubernetes. Per ulteriori informazioni, visita la pagina https://cloud.google.com/kubernetes-engine/docs/concepts/dataplane-v2

Rappresentazione JSON 
{
  "dataplaneV2Enabled": boolean,
  "windowsDataplaneV2Enabled": boolean,
  "advancedNetworking": boolean,
  "forwardMode": string
}
Campi
dataplaneV2Enabled

boolean

Abilita Dataplane V2.
windowsDataplaneV2Enabled

boolean

Abilita Dataplane V2 per i cluster con nodi Windows.
advancedNetworking

boolean

Attiva il networking avanzato che richiede l'impostazione di dataplaneV2Enabled su true.
forwardMode

string

Configura ForwardMode per Dataplane v2.

VmwareClusterUpgradePolicy

VmwareClusterUpgradePolicy definisce il criterio di upgrade del cluster.

Rappresentazione JSON 
{
  "controlPlaneOnly": boolean
}
Campi
controlPlaneOnly

boolean

Controlla se l'upgrade si applica solo al control plane.

Metodi

create

 Crea un nuovo cluster di utenti VMware in un determinato progetto e posizione.

delete

 Consente di eliminare un singolo cluster VMware.

enroll

 Registra un cluster utente VMware esistente e i relativi pool di nodi nell'API Anthos On-Prem in un determinato progetto e in una determinata località.

get

 Recupera i dettagli di un singolo cluster VMware.

list

 Elenca i cluster VMware in un determinato progetto e località.

patch

 Aggiorna i parametri di un singolo cluster VMware.

queryVersionConfig

 Esegue query sulla configurazione della versione del cluster utente VMware.