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)
  },
  "privateRegistryConfig": {
    object (VmwareAdminPrivateRegistryConfig)
  },
  "enableAdvancedCluster": boolean
}
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 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.
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 è 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 dell'ultimo aggiornamento del cluster di amministrazione 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".
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: 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" }.
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, sono attualmente 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 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.
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)

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 abilitato dall'API centrale, 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.
privateRegistryConfig

object (VmwareAdminPrivateRegistryConfig)

Configurazione per il registro.
enableAdvancedCluster

boolean

Abilita il cluster avanzato.

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

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 datacenter 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 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 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.
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 utilizzato dal cluster di amministrazione 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.

VmwareAdminHAControlPlaneConfig

Specifica la configurazione del control plane di amministrazione 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)

Gli IP virtuali 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 digitati 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 tipizzati Seesaw.

VmwareAdminVipConfig

VmwareAdminVipConfig per le configurazioni del bilanciatore del carico VMware.

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

string

Il VIP 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 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.

VmwareAdminManualLbConfig

Rappresentazione JSON 
{
  "ingressHttpNodePort": integer,
  "ingressHttpsNodePort": integer,
  "controlPlaneNodePort": integer,
  "konnectivityServerNodePort": integer,
  "addonsNodePort": 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).
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 amministratore, al momento non è necessaria alcuna configurazione.

Rappresentazione JSON 
{
  "enabled": boolean
}
Campi
enabled

boolean

Indica se MetalLB è abilitato.

VmwareAdminSeesawConfig

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

In generale, 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

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.

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 dei componenti aggiuntivi 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 attuale è inferiore a quella di destinazione, la versione della piattaforma verrà aggiornata a quella di destinazione. Se la versione di destinazione non è installata nella piattaforma (versioni del bundle), scarica il bundle della versione di destinazione.
platformVersion

string

Solo output. La versione della piattaforma, ad es. 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 bundle.

VmwareAdminPreparedSecretsConfig

VmwareAdminPreparedSecretsConfig rappresenta la configurazione dei secret preparati del cluster di amministrazione.

Rappresentazione JSON 
{
  "enabled": boolean
}
Campi
enabled

boolean

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.

VmwareAdminPrivateRegistryConfig

VmwareAdminPrivateRegistryConfig rappresenta la configurazione per il registro del cluster di amministrazione.

Rappresentazione JSON 
{
  "address": string,
  "caCert": string
}
Campi
address

string

L'indirizzo del registro.
caCert

string

Quando il runtime del container estrae un'immagine dal registro privato, il registro deve dimostrare la propria identità presentando un certificato. Il certificato del registro è firmato da un'autorità di certificazione (CA). Il runtime del container utilizza il certificato della CA per convalidare il certificato del registro.

Metodi

create

 Crea un nuovo cluster di amministrazione VMware in un determinato progetto e una determinata località.

enroll

 Registra un cluster di amministrazione VMware esistente nell'API Anthos On-Prem all'interno di un determinato progetto e una determinata località.

get

 Recupera i dettagli di un singolo cluster di amministrazione VMware.

list

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

patch

 Aggiorna i parametri di un singolo cluster di amministrazione VMware.