REST Resource: projects.locations.vmwareClusters

Recurso: VmwareCluster

Recurso que representa un clúster de usuario de VMware.

##

Representación 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
}
Campos
name

string

Inmutable. Nombre de recurso del clúster de usuarios de VMware.
adminClusterMembership

string

Obligatorio. El clúster de administrador al que pertenece este clúster de usuarios de VMware. Es el nombre completo del recurso de la pertenencia a la flota del clúster de administrador. En el futuro, es posible que se permitan referencias a otros tipos de recursos si los clústeres de administrador se modelan como recursos propios.
description

string

Descripción legible por humanos de este clúster de usuario de VMware.
onPremVersion

string

Obligatorio. La versión de clústeres de Anthos en VMware de tu clúster de usuario.
uid

string

Solo de salida. Identificador único del clúster de usuarios de VMware.
state

enum (State)

Solo de salida. El estado actual del clúster de usuarios de VMware.
endpoint

string

Solo de salida. Nombre DNS del servidor de la API del clúster de usuario de VMware.
reconciling

boolean

Solo de salida. Si se define, actualmente hay cambios en curso en el clúster de usuario de VMware.
createTime

string (Timestamp format)

Solo de salida. Hora a la que se creó el clúster de usuarios de VMware.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo de salida. Hora a la que se actualizó por última vez el clúster de usuarios de VMware.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
localName

string

Solo de salida. Nombre de objeto del recurso personalizado VMware OnPremUserCluster en el clúster de administrador asociado. Este campo se usa para admitir nombres conflictivos al registrar clústeres en la API. Cuando se usa como parte del registro de clústeres, este campo será diferente del ID del nombre del recurso. En los clústeres nuevos, este campo coincidirá con el nombre del clúster proporcionado por el usuario y se mostrará en el último componente del nombre del recurso. No se puede modificar.

Todos los usuarios deben usar este nombre para acceder a su clúster mediante gkectl o kubectl y deben ver el nombre local al consultar los registros del controlador del clúster de administrador.
etag

string

El servidor calcula esta suma de comprobación en función del valor de otros campos y puede enviarse en solicitudes de actualización y eliminación para asegurarse de que el cliente tiene un valor actualizado antes de continuar. Permite a los clientes realizar lecturas, modificaciones y escrituras coherentes mediante el control de simultaneidad optimista.
annotations

map (key: string, value: string)

Anotaciones en el clúster de usuario de VMware. Este campo tiene las mismas restricciones que las anotaciones de Kubernetes. El tamaño total de todas las claves y valores combinados no puede superar los 256 k. La clave puede tener dos segmentos: un prefijo (opcional) y un nombre (obligatorio), separados por una barra (/). El prefijo debe ser un subdominio de DNS. El nombre debe tener 63 caracteres como máximo, empezar y terminar con caracteres alfanuméricos, e incluir guiones (-), guiones bajos (_), puntos (.) y caracteres alfanuméricos.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
controlPlaneNode

object (VmwareControlPlaneNodeConfig)

Los nodos del plano de control del clúster de usuario de VMware deben tener 1 o 3 réplicas.
antiAffinityGroups

object (VmwareAAGConfig)

AAGConfig especifica si se deben distribuir los nodos del clúster de usuario de VMware en al menos tres hosts físicos del centro de datos.
storage

object (VmwareStorageConfig)

Configuración del almacenamiento.
networkConfig

object (VmwareNetworkConfig)

La configuración de red del clúster de usuarios de VMware.
loadBalancer

object (VmwareLoadBalancerConfig)

Configuración del balanceador de carga.
vcenter

object (VmwareVCenterConfig)

VmwareVCenterConfig especifica la configuración de vCenter para el clúster de usuario. Si no se especifica, se hereda del clúster de administrador.
status

object (ResourceStatus)

Solo de salida. ResourceStatus que representa el estado detallado del clúster.
dataplaneV2

object (VmwareDataplaneV2Config)

VmwareDataplaneV2Config especifica la configuración de Dataplane V2.
vmTrackingEnabled

boolean

Habilita el seguimiento de VMs.
autoRepairConfig

object (VmwareAutoRepairConfig)

Configuración de la reparación automática.
fleet

object (Fleet)

Solo de salida. Configuración de la flota del clúster.
authorization

object (Authorization)

Política de RBAC que aplicará y gestionará la API Anthos On-Prem.
deleteTime

string (Timestamp format)

Solo de salida. Hora a la que se eliminó el clúster de usuarios de VMware.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
validationCheck

object (ValidationCheck)

Solo de salida. ValidationCheck representa el resultado del trabajo de comprobación preparatoria.
adminClusterName

string

Solo de salida. Nombre de recurso del clúster de administradores de VMware que aloja este clúster de usuarios.
enableControlPlaneV2

boolean

Habilita el plano de control V2. El valor predeterminado es "false".
binaryAuthorization

object (BinaryAuthorization)

Configuraciones relacionadas con la autorización binaria.
upgradePolicy

object (VmwareClusterUpgradePolicy)

Especifica la política de actualización del clúster.
disableBundledIngress

boolean

Inhabilita la entrada agrupada.
enableAdvancedCluster

boolean

Habilita el clúster avanzado.

Estado

El estado del ciclo de vida del clúster de usuarios de VMware.

Enumeraciones
STATE_UNSPECIFIED Sin definir.
PROVISIONING El estado PROVISIONING indica que se está creando el clúster.
RUNNING El estado RUNNING indica que el clúster se ha creado y se puede usar por completo.
RECONCILING El estado RECONCILING indica que el clúster se está actualizando. Sigue estando disponible, pero es posible que su rendimiento se vea afectado.
STOPPING El estado DETENIENDO indica que se está eliminando el clúster.
ERROR El estado ERROR indica que el clúster está en un estado dañado irrecuperable.
DEGRADED El estado DEGRADED indica que el clúster requiere que el usuario realice alguna acción para restaurar todas las funciones.

VmwareControlPlaneNodeConfig

Especifica la configuración del nodo de plano de control del clúster de usuarios de VMware.

Representación JSON 
{
  "cpus": string,
  "memory": string,
  "replicas": string,
  "autoResizeConfig": {
    object (VmwareAutoResizeConfig)
  },
  "vsphereConfig": {
    object (VmwareControlPlaneVsphereConfig)
  }
}
Campos
cpus

string (int64 format)

Número de CPUs de cada nodo del clúster de administradores que actúan como planos de control de este clúster de usuarios de VMware. (valor predeterminado: 4 CPUs)
memory

string (int64 format)

La cantidad de megabytes de memoria de cada nodo del clúster de administradores que actúa como plano de control de este clúster de usuarios de VMware (valor predeterminado: 8192 MB de memoria).
replicas

string (int64 format)

Número de nodos del plano de control de este clúster de usuarios de VMware. (predeterminado: 1 réplica).
autoResizeConfig

object (VmwareAutoResizeConfig)

AutoResizeConfig proporciona configuraciones de cambio de tamaño automático.
vsphereConfig

object (VmwareControlPlaneVsphereConfig)

Configuración específica de vSphere.

VmwareControlPlaneVsphereConfig

Especifica la configuración del nodo del plano de control.

Representación JSON 
{
  "datastore": string,
  "storagePolicyName": string
}
Campos
datastore

string

El almacén de datos de vSphere que usa el nodo del plano de control.
storagePolicyName

string

La política de almacenamiento de vSphere que usa el nodo del plano de control.

VmwareStorageConfig

Especifica la configuración de implementación de los componentes de CSI de vSphere en el clúster de usuario de VMware.

Representación JSON 
{
  "vsphereCsiDisabled": boolean
}
Campos
vsphereCsiDisabled

boolean

Indica si se deben desplegar los componentes de CSI de vSphere en el clúster de usuarios de VMware. Esta opción está habilitada de forma predeterminada.

VmwareNetworkConfig

Especifica la configuración de red del clúster de usuario de VMware.

Representación 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.
}
Campos
serviceAddressCidrBlocks[]

string

Obligatorio. A todos los servicios del clúster se les asigna una dirección IPv4 RFC1918 de estos intervalos. Solo se admite un intervalo. Este campo no se puede cambiar después de crearse.
podAddressCidrBlocks[]

string

Obligatorio. Se ha asignado una dirección IPv4 de RFC1918 de estos intervalos a todos los pods del clúster. Solo se admite un intervalo. Este campo no se puede cambiar después de crearse.
vcenterNetwork

string

vcenterNetwork especifica el nombre de la red de vCenter. Heredado del clúster de administrador.
hostConfig

object (VmwareHostConfig)

Representa la configuración de red común, independientemente de la dirección IP del host.
controlPlaneV2Config

object (VmwareControlPlaneV2Config)

Configuración del modo V2 del plano de control.
Campo de unión ip_configuration. El tipo de configuración de IP que usa el clúster de usuario de VMware. ip_configuration solo puede ser una de estas dos opciones:
staticIpConfig

object (VmwareStaticIpConfig)

Ajustes de configuración de una configuración de IP estática.
dhcpIpConfig

object (VmwareDhcpIpConfig)

Ajustes de configuración de una configuración de IP de DHCP.

VmwareControlPlaneV2Config

Especifica la configuración del plano de control V2.

Representación JSON 
{
  "controlPlaneIpBlock": {
    object (VmwareIpBlock)
  }
}
Campos
controlPlaneIpBlock

object (VmwareIpBlock)

Direcciones IP estáticas para los nodos del plano de control.

VmwareLoadBalancerConfig

Especifica la configuración del balanceador de carga del clúster de usuario de VMware.

Representación 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.
}
Campos
vipConfig

object (VmwareVipConfig)

Las IPs virtuales que usa el balanceador de carga.
Campo de unión load_balancer_configuration. La configuración del balanceador de carga que se va a usar en el clúster de usuario. load_balancer_configuration solo puede ser una de estas dos opciones:
f5Config

object (VmwareF5BigIpConfig)

Configuración de balanceadores de carga tipados de F5 Big IP.
manualLbConfig

object (VmwareManualLbConfig)

Balanceadores de carga configurados manualmente.
seesawConfig

object (VmwareSeesawConfig)

Solo de salida. Configuración de los balanceadores de carga con tipo de Seesaw.
metalLbConfig

object (VmwareMetalLbConfig)

Configuración de balanceadores de carga de tipo MetalLB.

VmwareVipConfig

Especifica la configuración de VIP del balanceador de carga del clúster de usuario de VMware.

Representación JSON 
{
  "controlPlaneVip": string,
  "ingressVip": string
}
Campos
controlPlaneVip

string

La dirección IP virtual que has reservado para la API de Kubernetes de este clúster.
ingressVip

string

La dirección IP virtual que has reservado para el tráfico de entrada en este clúster.

VmwareF5BigIpConfig

Representa los parámetros de configuración de un balanceador de carga F5 BIG-IP.

Representación JSON 
{
  "address": string,
  "partition": string,
  "snatPool": string
}
Campos
address

string

La dirección IP del balanceador de carga.
partition

string

La partición preexistente que va a usar el balanceador de carga. Esta partición se suele crear para el clúster de administrador. Por ejemplo, "my-f5-admin-partition".
snatPool

string

El nombre del grupo. Solo es necesario si se usa SNAT.

VmwareManualLbConfig

Representa los parámetros de configuración de un balanceador de carga manual que ya existe. Dada la naturaleza de los balanceadores de carga manuales, se espera que los usuarios gestionen por completo dichos balanceadores.

IMPORTANTE: Ten en cuenta que la API Anthos On-Prem no generará ni actualizará configuraciones de ManualLB, sino que solo podrá vincular una configuración preexistente a un nuevo clúster de usuarios de VMware.

Representación JSON 
{
  "ingressHttpNodePort": integer,
  "ingressHttpsNodePort": integer,
  "controlPlaneNodePort": integer,
  "konnectivityServerNodePort": integer
}
Campos
ingressHttpNodePort

integer

NodePort para el servicio http de Ingress. El servicio de entrada del clúster de administración se implementa como un servicio de tipo NodePort (por ejemplo, 32527).
ingressHttpsNodePort

integer

NodePort para el servicio de entrada HTTPS. El servicio de entrada del clúster de administración se implementa como un servicio de tipo NodePort (por ejemplo, 30139).
controlPlaneNodePort

integer

NodePort del servicio del plano de control. El servidor de la API de Kubernetes del clúster de administrador se implementa como un servicio de tipo NodePort (por ejemplo, 30968).
konnectivityServerNodePort

integer

NodePort para el servicio del servidor de conectividad que se ejecuta como un sidecar en cada pod de kube-apiserver (por ejemplo, 30564).

VmwareSeesawConfig

VmwareSeesawConfig representa los parámetros de configuración de un balanceador de carga de Seesaw que ya existe.

IMPORTANTE: Ten en cuenta que la API Anthos On-Prem no generará ni actualizará configuraciones de Seesaw, sino que solo podrá vincular una configuración preexistente a un nuevo clúster de usuarios.

IMPORTANTE: Cuando intentes crear un clúster de usuario con un balanceador de carga de Seesaw preexistente, deberás seguir algunos pasos de preparación antes de llamar al método de la API "vmwareClusters.create". Primero, tendrás que crear el espacio de nombres del clúster de usuarios mediante kubectl. El espacio de nombres debe usar la siguiente convención de nomenclatura : -gke-onprem-mgmt o -gke-onprem-mgmt, en función de si has usado "VmwareCluster.local_name" para evitar colisiones. Para obtener más información, consulta la documentación de "VmwareCluster.local_name". Una vez creado el espacio de nombres, tendrás que crear un recurso secreto mediante kubectl. Este secreto contendrá copias de tus credenciales de Seesaw. El secreto debe llamarse "user-cluster-creds" y contener las credenciales SSH y Cert de Seesaw. Las credenciales deben tener las siguientes claves: "seesaw-ssh-private-key", "seesaw-ssh-public-key", "seesaw-ssh-ca-key" y "seesaw-ssh-ca-cert".

Representación JSON 
{
  "group": string,
  "masterIp": string,
  "ipBlocks": [
    {
      object (VmwareIpBlock)
    }
  ],
  "enableHa": boolean,
  "vms": [
    string
  ],
  "stackdriverName": string
}
Campos
group

string

Obligatorio. Por lo general, el nombre del grupo de Seesaw debe seguir el formato seesaw-for-[clusterName].
masterIp

string

Obligatorio. MasterIP es la IP anunciada por el elemento principal del grupo Seesaw.
ipBlocks[]

object (VmwareIpBlock)

Obligatorio. Los bloques de IPs que usará el balanceador de carga de Seesaw
enableHa

boolean

Habilita dos VMs de balanceador de carga para conseguir un balanceador de carga de Seesaw de alta disponibilidad.
vms[]

string

Nombres de las VMs creadas para este grupo de Seesaw.
stackdriverName

string

Nombre que usará Stackdriver.

VmwareMetalLbConfig

Representa los parámetros de configuración del balanceador de carga MetalLB.

Representación JSON 
{
  "addressPools": [
    {
      object (VmwareAddressPool)
    }
  ]
}
Campos
addressPools[]

object (VmwareAddressPool)

Obligatorio. AddressPools es una lista de grupos de IPs que no se solapan y que utilizan los servicios de tipo balanceador de carga. Todas las direcciones deben poder enrutarse a los nodos del balanceador de carga. IngressVIP debe incluirse en los pools.

VmwareAddressPool

Representa un grupo de IPs que usa el balanceador de carga.

Representación JSON 
{
  "pool": string,
  "addresses": [
    string
  ],
  "avoidBuggyIps": boolean,
  "manualAssign": boolean
}
Campos
pool

string

Obligatorio. Nombre del grupo de direcciones.
addresses[]

string

Obligatorio. Las direcciones que forman parte de este grupo. Cada dirección debe estar en formato CIDR (1.2.3.0/24) o en formato de intervalo (1.2.3.1-1.2.3.5).
avoidBuggyIps

boolean

Si el valor es "true", no utilice IPs que terminen en .0 o .255. De esta forma, se evita que los dispositivos de consumo con errores descarten por error el tráfico IPv4 de esas direcciones IP especiales.
manualAssign

boolean

Si es true, evita que se asignen direcciones IP automáticamente.

VmwareVCenterConfig

Representa la configuración de VMware vCenter para el clúster de usuario.

Representación JSON 
{
  "resourcePool": string,
  "datastore": string,
  "datacenter": string,
  "cluster": string,
  "folder": string,
  "caCertData": string,
  "address": string,
  "storagePolicyName": string
}
Campos
resourcePool

string

Nombre del grupo de recursos de vCenter del clúster de usuario.
datastore

string

Nombre del almacén de datos de vCenter del clúster de usuarios.
datacenter

string

Nombre del centro de datos de vCenter del clúster de usuarios.
cluster

string

Nombre del clúster de vCenter del clúster de usuario.
folder

string

Nombre de la carpeta de vCenter del clúster de usuarios.
caCertData

string

Contiene la clave pública del certificado de la AC de vCenter para la verificación SSL.
address

string

Solo de salida. La dirección IP de vCenter.
storagePolicyName

string

Nombre de la política de almacenamiento de vCenter del clúster de usuarios.

VmwareDataplaneV2Config

Contiene configuraciones de Dataplane V2, que es un plano de datos optimizado para la red de Kubernetes. Para obtener más información, consulta https://cloud.google.com/kubernetes-engine/docs/concepts/dataplane-v2.

Representación JSON 
{
  "dataplaneV2Enabled": boolean,
  "windowsDataplaneV2Enabled": boolean,
  "advancedNetworking": boolean,
  "forwardMode": string
}
Campos
dataplaneV2Enabled

boolean

Habilita Dataplane V2.
windowsDataplaneV2Enabled

boolean

Habilita Dataplane V2 en los clústeres con nodos de Windows.
advancedNetworking

boolean

Habilita las redes avanzadas, lo que requiere que dataplaneV2Enabled tenga el valor true.
forwardMode

string

Configura ForwardMode para Dataplane v2.

VmwareClusterUpgradePolicy

VmwareClusterUpgradePolicy define la política de actualización del clúster.

Representación JSON 
{
  "controlPlaneOnly": boolean
}
Campos
controlPlaneOnly

boolean

Controla si la actualización se aplica solo al plano de control.

Métodos

create

 Crea un clúster de usuarios de VMware en un proyecto y una ubicación determinados.

delete

 Elimina un clúster de VMware.

enroll

 Registra un clúster de usuario de VMware y sus grupos de nodos en la API Anthos On-Prem de un proyecto y una ubicación determinados.

get

 Obtiene los detalles de un clúster de VMware.

list

 Muestra los clústeres de VMware de un proyecto y una ubicación determinados.

patch

 Actualiza los parámetros de un solo clúster de VMware.

queryVersionConfig

 Consulta la configuración de la versión del clúster de usuarios de VMware.