REST Resource: projects.locations.vmwareAdminClusters

Risorsa: VmwareAdminCluster

Risorsa che rappresenta un cluster di amministrazione VMware.

Rappresentazione JSON 
{
  "name": string,
  "description": string,
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string,
  "annotations": {
    string: string,
    ...
  },
  "state": enum (State),
  "endpoint": string,
  "reconciling": boolean,
  "localName": string,
  "bootstrapClusterMembership": string,
  "onPremVersion": string,
  "fleet": {
    object (Fleet)
  },
  "imageType": string,
  "vcenter": {
    object (VmwareAdminVCenterConfig)
  },
  "networkConfig": {
    object (VmwareAdminNetworkConfig)
  },
  "loadBalancer": {
    object (VmwareAdminLoadBalancerConfig)
  },
  "controlPlaneNode": {
    object (VmwareAdminControlPlaneNodeConfig)
  },
  "addonNode": {
    object (VmwareAdminAddonNodeConfig)
  },
  "antiAffinityGroups": {
    object (VmwareAAGConfig)
  },
  "autoRepairConfig": {
    object (VmwareAutoRepairConfig)
  },
  "status": {
    object (ResourceStatus)
  },
  "platformConfig": {
    object (VmwarePlatformConfig)
  },
  "preparedSecrets": {
    object (VmwareAdminPreparedSecretsConfig)
  },
  "authorization": {
    object (VmwareAdminAuthorizationConfig)
  },
  "validationCheck": {
    object (ValidationCheck)
  }
}
Campi
name

string

Immutabile. Il nome della risorsa del cluster di amministrazione VMware.
description

string

Una descrizione leggibile di questo cluster di amministrazione VMware.
uid

string

Solo output. L'identificatore univoco del cluster di amministrazione VMware.
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.
createTime

string (Timestamp format)

Solo output. L'ora in cui è stato creato il cluster di amministrazione 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 di amministrazione 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".
annotations

map (key: string, value: string)

Annotazioni sul cluster di amministrazione 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" }.
state

enum (State)

Solo output. Lo stato attuale del cluster di amministrazione VMware.
endpoint

string

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

boolean

Solo output. Se impostato, al momento sono in corso modifiche al cluster di amministrazione VMware.
localName

string

Solo output. Il nome dell'oggetto della risorsa personalizzata VMware OnPremAdminCluster. 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.
bootstrapClusterMembership

string

Il cluster di bootstrap a cui appartiene questo cluster di amministrazione VMware.
onPremVersion

string

La versione di Cluster Anthos on VMware per il cluster di amministrazione.
fleet

object (Fleet)

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

string

Il tipo di immagine del sistema operativo per il cluster di amministrazione VMware.
vcenter

object (VmwareAdminVCenterConfig)

La configurazione di VCenter del cluster di amministrazione VMware.
networkConfig

object (VmwareAdminNetworkConfig)

La configurazione di rete del cluster di amministrazione VMware.
loadBalancer

object (VmwareAdminLoadBalancerConfig)

La configurazione del bilanciatore del carico del cluster di amministrazione VMware.
controlPlaneNode

object (VmwareAdminControlPlaneNodeConfig)

La configurazione del nodo del control plane del cluster di amministrazione VMware.
addonNode

object (VmwareAdminAddonNodeConfig)

La configurazione del nodo del componente aggiuntivo del cluster di amministrazione VMware.
antiAffinityGroups

object (VmwareAAGConfig)

La configurazione del gruppo anti-affinità del cluster di amministrazione VMware.
autoRepairConfig

object (VmwareAutoRepairConfig)

La configurazione della riparazione automatica del cluster di amministrazione VMware.
status

object (ResourceStatus)

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

object (VmwarePlatformConfig)

La configurazione della piattaforma VMware.
preparedSecrets

object (VmwareAdminPreparedSecretsConfig)

Solo output. Il cluster di amministrazione VMware ha preparato la configurazione dei secret. Deve essere sempre attivato dall'API Central, anziché consentire agli utenti di impostarlo.
authorization

object (VmwareAdminAuthorizationConfig)

La configurazione dell'autorizzazione del cluster di amministrazione VMware.
validationCheck

object (ValidationCheck)

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

Stato

Lo stato del ciclo di vita del cluster di amministrazione 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.

VmwareAdminVCenterConfig

VmwareAdminVCenterConfig contiene la configurazione di vCenter per il cluster di amministrazione VMware.

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

string

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

string

Il nome del datastore vCenter per il cluster di amministrazione.
datacenter

string

Il nome del data center vCenter per il cluster di amministrazione.
cluster

string

Il nome del cluster vCenter per il cluster di amministrazione.
folder

string

Il nome della cartella vCenter per il cluster di amministrazione.
caCertData

string

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

string

L'indirizzo IP di vCenter.
dataDisk

string

Il nome del disco della macchina virtuale (VMDK) per il cluster di amministrazione.
storagePolicyName

string

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

VmwareAdminNetworkConfig

VmwareAdminNetworkConfig contiene la configurazione di rete per il cluster di amministrazione VMware.

Rappresentazione JSON 
{
  "serviceAddressCidrBlocks": [
    string
  ],
  "podAddressCidrBlocks": [
    string
  ],
  "vcenterNetwork": string,
  "hostConfig": {
    object (VmwareHostConfig)
  },
  "haControlPlaneConfig": {
    object (VmwareAdminHAControlPlaneConfig)
  },

  // 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.
hostConfig

object (VmwareHostConfig)

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

object (VmwareAdminHAControlPlaneConfig)

Configurazione per il control plane del cluster di amministrazione ad alta disponibilità.
Campo unione ip_configuration. Il tipo di configurazione IP utilizzata dal cluster di amministrazione 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.

VmwareAdminHAControlPlaneConfig

Specifica la configurazione del piano di controllo amministrativo ad alta disponibilità.

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

object (VmwareIpBlock)

Indirizzi IP statici per i nodi del control plane di amministrazione.

VmwareAdminLoadBalancerConfig

VmwareAdminLoadBalancerConfig contiene la configurazione del bilanciatore del carico per il cluster di amministrazione VMware.

Rappresentazione JSON 
{
  "vipConfig": {
    object (VmwareAdminVipConfig)
  },

  // Union field load_balancer_configuration can be only one of the following:
  "f5Config": {
    object (VmwareAdminF5BigIpConfig)
  },
  "manualLbConfig": {
    object (VmwareAdminManualLbConfig)
  },
  "metalLbConfig": {
    object (VmwareAdminMetalLbConfig)
  },
  "seesawConfig": {
    object (VmwareAdminSeesawConfig)
  }
  // End of list of possible types for union field load_balancer_configuration.
}
Campi
vipConfig

object (VmwareAdminVipConfig)

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

object (VmwareAdminF5BigIpConfig)

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

object (VmwareAdminManualLbConfig)

Bilanciatori del carico configurati manualmente.
metalLbConfig

object (VmwareAdminMetalLbConfig)

Bilanciatori del carico MetalLB.
seesawConfig

object (VmwareAdminSeesawConfig)

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

VmwareAdminVipConfig

VmwareAdminVipConfig per le configurazioni del bilanciatore del carico VMware.

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

string

L'IP virtuale che hai riservato in precedenza per l'API Kubernetes del cluster di amministrazione.
addonsVip

string

Il VIP per configurare il bilanciatore del carico per i componenti aggiuntivi.

VmwareAdminF5BigIpConfig

VmwareAdminF5BigIpConfig 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 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.

VmwareAdminManualLbConfig

Rappresentazione JSON 
{
  "ingressHttpNodePort": integer,
  "ingressHttpsNodePort": integer,
  "controlPlaneNodePort": integer,
  "konnectivityServerNodePort": integer,
  "addonsNodePort": 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).
addonsNodePort

integer

NodePort per il server dei componenti aggiuntivi nel cluster di amministrazione.

VmwareAdminMetalLbConfig

VmwareAdminMetalLbConfig rappresenta i parametri di configurazione per un bilanciatore del carico MetalLB. Per i cluster di amministrazione, al momento non sono necessarie configurazioni.

Rappresentazione JSON 
{
  "enabled": boolean
}
Campi
enabled

boolean

Indica se MetalLB è attivo.

VmwareAdminSeesawConfig

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

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

string

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

object (VmwareIpBlock)

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.

VmwareAdminControlPlaneNodeConfig

VmwareAdminControlPlaneNodeConfig contiene la configurazione del nodo del control plane per il cluster di amministrazione VMware.

Rappresentazione JSON 
{
  "cpus": string,
  "memory": string,
  "replicas": string
}
Campi
cpus

string (int64 format)

Il numero di vCPU per il nodo del control plane del cluster di amministrazione.
memory

string (int64 format)

Il numero di mebibyte di memoria per il nodo del control plane del cluster di amministrazione.
replicas

string (int64 format)

Il numero di nodi del control plane per questo cluster di amministrazione VMware. (valore predefinito: 1 replica).

VmwareAdminAddonNodeConfig

VmwareAdminAddonNodeConfig contiene le configurazioni dei nodi del componente aggiuntivo per il cluster di amministrazione VMware.

Rappresentazione JSON 
{
  "autoResizeConfig": {
    object (VmwareAutoResizeConfig)
  }
}
Campi
autoResizeConfig

object (VmwareAutoResizeConfig)

La configurazione VmwareAutoResizeConfig specifica la configurazione del ridimensionamento automatico.

VmwarePlatformConfig

VmwarePlatformConfig rappresenta la configurazione per la piattaforma VMware.

Rappresentazione JSON 
{
  "requiredPlatformVersion": string,
  "platformVersion": string,
  "bundles": [
    {
      object (VmwareBundleConfig)
    }
  ],
  "status": {
    object (ResourceStatus)
  }
}
Campi
requiredPlatformVersion

string

Solo input. La versione della piattaforma richiesta, ad esempio 1.13.1. Se la versione della piattaforma corrente è precedente alla versione target, la versione della piattaforma verrà aggiornata alla versione target. Se la versione di destinazione non è installata nella piattaforma (versioni bundle), scarica il bundle della versione di destinazione.
platformVersion

string

Solo output. La versione della piattaforma, ad esempio 1.13.2.
bundles[]

object (VmwareBundleConfig)

Solo output. L'elenco dei bundle installati nel cluster di amministrazione.
status

object (ResourceStatus)

Solo output. Stato della risorsa per la piattaforma.

VmwareBundleConfig

VmwareBundleConfig rappresenta la configurazione del bundle.

Rappresentazione JSON 
{
  "version": string,
  "status": {
    object (ResourceStatus)
  }
}
Campi
version

string

La versione del bundle.
status

object (ResourceStatus)

Solo output. Stato della risorsa per il set.

VmwareAdminPreparedSecretsConfig

VmwareAdminPreparedSecretsConfig rappresenta la configurazione dei secret preparati per il cluster di amministrazione.

Rappresentazione JSON 
{
  "enabled": boolean
}
Campi
enabled

boolean

Indica se i secret preparati sono abilitati.

VmwareAdminAuthorizationConfig

VmwareAdminAuthorizationConfig rappresenta la configurazione per l'autorizzazione del cluster di amministrazione.

Rappresentazione JSON 
{
  "viewerUsers": [
    {
      object (ClusterUser)
    }
  ]
}
Campi
viewerUsers[]

object (ClusterUser)

Per i cluster di amministrazione VMware, agli utenti verrà concesso il ruolo cluster-viewer sul cluster.

Metodi

create

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

enroll

 Registra un cluster di amministrazione VMware esistente all'API Anthos On-Prem in un determinato progetto e posizione.

get

 Recupera i dettagli di un singolo cluster di amministrazione VMware.

list

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

patch

 Aggiorna i parametri di un singolo cluster di amministrazione VMware.