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,
  "enableAdvancedCluster": 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. Questo è il 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 amministrazione 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, sono attualmente 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 è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. 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 in cui è stato aggiornato per l'ultima volta il cluster utente VMware.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. 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 nomi in conflitto durante la registrazione di cluster esistenti all'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 visualizzare 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 nelle richieste di aggiornamento ed eliminazione per garantire che il client disponga di un valore aggiornato prima di procedere. Consente ai client di eseguire operazioni di lettura-modifica-scrittura coerenti tramite controllo della contemporaneità 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: prefisso (facoltativo) e 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 una o tre repliche.
antiAffinityGroups

object (VmwareAAGConfig)

AAGConfig specifica se distribuire i nodi del cluster utente VMware in 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. L'ora in cui è stato eliminato il cluster utente VMware.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. 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 control plane V2. Il valore predefinito è false.
binaryAuthorization

object (BinaryAuthorization)

Configurazioni correlate all'autorizzazione binaria.
upgradePolicy

object (VmwareClusterUpgradePolicy)

Specifica le norme di upgrade per il cluster.
disableBundledIngress

boolean

Disattiva l'ingresso in bundle.
enableAdvancedCluster

boolean

Abilita il cluster avanzato.

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 potenzialmente con prestazioni ridotte.
STOPPING Lo stato STOPPING indica che il cluster è in fase di eliminazione.
ERROR Lo stato ERROR indica che il cluster è in uno stato non funzionante e non recuperabile.
DEGRADED Lo stato DEGRADED indica che il cluster richiede un'azione da parte dell'utente per ripristinare la funzionalità completa.

VmwareControlPlaneNodeConfig

Specifica la configurazione dei nodi del control plane 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 control plane per questo cluster utente VMware. (valore predefinito: 1 replica).
autoResizeConfig

object (VmwareAutoResizeConfig)

AutoResizeConfig fornisce configurazioni di ridimensionamento automatico.
vsphereConfig

object (VmwareControlPlaneVsphereConfig)

Configurazione specifica di vSphere.

VmwareControlPlaneVsphereConfig

Specifica la configurazione del nodo del control plane.

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

string

Il datastore vSphere utilizzato dal nodo del control plane.
storagePolicyName

string

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

VmwareStorageConfig

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

Rappresentazione JSON 
{
  "vsphereCsiDisabled": boolean
}
Campi
vsphereCsiDisabled

boolean

Se eseguire o meno il deployment dei componenti vSphere CSI 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 in 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 in 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à control plane 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 statico.
dhcpIpConfig

object (VmwareDhcpIpConfig)

Impostazioni di configurazione per una configurazione IP DHCP.

VmwareControlPlaneV2Config

Specifica la configurazione di 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 del carico 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)

Gli IP virtuali 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 digitati F5 Big IP.
manualLbConfig

object (VmwareManualLbConfig)

Bilanciatori del carico configurati manualmente.
seesawConfig

object (VmwareSeesawConfig)

Solo output. Configurazione per i bilanciatori del carico tipizzati Seesaw.
metalLbConfig

object (VmwareMetalLbConfig)

Configurazione per i bilanciatori del carico di tipo MetalLB.

VmwareVipConfig

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

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

string

Il VIP che hai riservato in precedenza per l'API Kubernetes di questo cluster.
ingressVip

string

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

VmwareF5BigIpConfig

Rappresenta i parametri di configurazione per 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 preesistente da utilizzare per il bilanciatore del carico. Questa partizione viene in genere creata per il cluster di amministrazione, ad esempio "my-f5-admin-partition".
snatPool

string

Il nome del pool. Necessario solo se utilizzi SNAT.

VmwareManualLbConfig

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

IMPORTANTE: tieni presente che l'API Anthos On-Prem non genera né aggiorna le configurazioni ManualLB, 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

NodePort per http del servizio in entrata. Il servizio in entrata nel cluster di amministrazione è implementato come servizio di tipo NodePort (ad es. 32527).
ingressHttpsNodePort

integer

NodePort per l'https del servizio in entrata. 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 konnectivity in esecuzione come sidecar in ogni pod kube-apiserver (ad es. 30564).

VmwareSeesawConfig

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

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

IMPORTANTE: quando tenti di creare un cluster utente con un bilanciamento del carico Seesaw preesistente, devi seguire alcuni passaggi di preparazione prima di chiamare il metodo 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 eliminare le ambiguità; per maggiori informazioni, consulta la documentazione di "VmwareCluster.local_name". Una volta creato lo spazio dei nomi, devi creare una risorsa secret tramite kubectl. Questo secret conterrà copie delle tue credenziali di Seesaw. Il secret deve essere denominato "user-cluster-creds" e contenere le credenziali SSH e del certificato di Seesaw. Le credenziali devono essere associate alle seguenti chiavi: "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 generale, 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

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

string

Nomi delle VM create per questo gruppo Seesaw.
stackdriverName

string

Nome da utilizzare in 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 IP che non si sovrappongono utilizzati dai servizi con tipo di 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 in formato CIDR (1.2.3.0/24) o intervallo (1.2.3.1-1.2.3.5).
avoidBuggyIps

boolean

Se il valore è true, evita di utilizzare IP che terminano con .0 o .255. In questo modo si evita che i dispositivi di consumo con bug abbandonino erroneamente 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 vCenter.
storagePolicyName

string

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

VmwareDataplaneV2Config

Contiene le configurazioni per Dataplane V2, che è un piano dati ottimizzato per il networking Kubernetes. Per ulteriori informazioni, visita: 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

Abilita il networking avanzato, che richiede che dataplaneV2Enabled sia impostato su true.
forwardMode

string

Configura ForwardMode per Dataplane v2.

VmwareClusterUpgradePolicy

VmwareClusterUpgradePolicy definisce le norme 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 utente VMware in un progetto e una località specifici.

delete

 Elimina un singolo cluster VMware.

enroll

 Registra un cluster utente VMware esistente e i relativi node pool nell'API Anthos On-Prem all'interno di un progetto e di una località specifici.

get

 Recupera i dettagli di un singolo cluster VMware.

list

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

patch

 Aggiorna i parametri di un singolo cluster VMware.

queryVersionConfig

 Esegue query sulla configurazione della versione del cluster utente VMware.