REST Resource: projects.locations.vmwareAdminClusters

Recurso: VmwareAdminCluster

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

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

string

Inmutable. Nombre de recurso del clúster de administración de VMware.
description

string

Descripción legible por humanos de este clúster de administrador de VMware.
uid

string

Solo de salida. Identificador único del clúster de administrador de VMware.
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.
createTime

string (Timestamp format)

Solo de salida. Hora a la que se creó el clúster de administrador 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ó el clúster de administrador de VMware por última vez.

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

map (key: string, value: string)

Anotaciones en el clúster de administración 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" }.
state

enum (State)

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

string

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

boolean

Solo de salida. Si se ha definido, actualmente hay cambios en curso en el clúster de administración de VMware.
localName

string

Solo de salida. Nombre de objeto del recurso personalizado VMware OnPremAdminCluster. 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.
bootstrapClusterMembership

string

El clúster de arranque al que pertenece este clúster de administrador de VMware.
onPremVersion

string

La versión de clústeres de Anthos en VMware del clúster de administrador.
fleet

object (Fleet)

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

string

El tipo de imagen del SO del clúster de administración de VMware.
vcenter

object (VmwareAdminVCenterConfig)

La configuración de vCenter del clúster de administradores de VMware.
networkConfig

object (VmwareAdminNetworkConfig)

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

object (VmwareAdminLoadBalancerConfig)

La configuración del balanceador de carga del clúster de administrador de VMware.
controlPlaneNode

object (VmwareAdminControlPlaneNodeConfig)

La configuración del nodo de plano de control del clúster de administrador de VMware.
addonNode

object (VmwareAdminAddonNodeConfig)

Configuración del nodo del complemento del clúster de administrador de VMware.
antiAffinityGroups

object (VmwareAAGConfig)

Configuración del grupo de antiafinidad del clúster de administradores de VMware.
autoRepairConfig

object (VmwareAutoRepairConfig)

Configuración de reparación automática del clúster de administrador de VMware.
status

object (ResourceStatus)

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

object (VmwarePlatformConfig)

La configuración de la plataforma VMware.
preparedSecrets

object (VmwareAdminPreparedSecretsConfig)

Solo de salida. El clúster de administrador de VMware ha preparado la configuración de secretos. La API central siempre debe habilitarla en lugar de permitir que los usuarios la definan.
authorization

object (VmwareAdminAuthorizationConfig)

Configuración de autorización del clúster de administrador de VMware.
validationCheck

object (ValidationCheck)

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

object (VmwareAdminPrivateRegistryConfig)

Configuración del registro.
enableAdvancedCluster

boolean

Habilita el clúster avanzado.

Estado

Estado del ciclo de vida del clúster de administración 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.

VmwareAdminVCenterConfig

VmwareAdminVCenterConfig contiene la configuración de VCenter para el clúster de administrador de VMware.

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

string

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

string

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

string

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

string

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

string

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

string

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

string

La dirección IP de vCenter.
dataDisk

string

Nombre del disco de la máquina virtual (VMDK) del clúster de administrador.
storagePolicyName

string

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

VmwareAdminNetworkConfig

VmwareAdminNetworkConfig contiene la configuración de red del clúster de administrador de VMware.

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

object (VmwareHostConfig)

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

object (VmwareAdminHAControlPlaneConfig)

Configuración del plano de control del clúster de administradores de alta disponibilidad.
Campo de unión ip_configuration. El tipo de configuración de IP que usa el clúster de administración 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.

VmwareAdminHAControlPlaneConfig

Especifica la configuración del plano de control de administrador de alta disponibilidad.

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

object (VmwareIpBlock)

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

VmwareAdminLoadBalancerConfig

VmwareAdminLoadBalancerConfig contiene la configuración del balanceador de carga del clúster de administrador de VMware.

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

object (VmwareAdminVipConfig)

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 administración de VMware. load_balancer_configuration solo puede ser una de estas dos opciones:
f5Config

object (VmwareAdminF5BigIpConfig)

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

object (VmwareAdminManualLbConfig)

Balanceadores de carga configurados manualmente.
metalLbConfig

object (VmwareAdminMetalLbConfig)

Balanceadores de carga de MetalLB.
seesawConfig

object (VmwareAdminSeesawConfig)

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

VmwareAdminVipConfig

VmwareAdminVipConfig para configuraciones de balanceadores de carga de VMware.

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

string

La VIP que has reservado anteriormente para la API de Kubernetes del clúster de administración.
addonsVip

string

La IP virtual para configurar el balanceador de carga de los complementos.

VmwareAdminF5BigIpConfig

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

VmwareAdminManualLbConfig

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

integer

NodePort para el servidor de complementos en el clúster de administrador.

VmwareAdminMetalLbConfig

VmwareAdminMetalLbConfig representa los parámetros de configuración de un balanceador de carga MetalLB. En el caso de los clústeres de administrador, actualmente no es necesario realizar ninguna configuración.

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

boolean

Indica si MetalLB está habilitado.

VmwareAdminSeesawConfig

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

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

string

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

object (VmwareIpBlock)

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.

VmwareAdminControlPlaneNodeConfig

VmwareAdminControlPlaneNodeConfig contiene la configuración del nodo de plano de control del clúster de administrador de VMware.

Representación JSON 
{
  "cpus": string,
  "memory": string,
  "replicas": string
}
Campos
cpus

string (int64 format)

Número de vCPUs del nodo de plano de control del clúster de administrador.
memory

string (int64 format)

Número de mebibytes de memoria del nodo de plano de control del clúster de administrador.
replicas

string (int64 format)

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

VmwareAdminAddonNodeConfig

VmwareAdminAddonNodeConfig contiene configuraciones de nodos de complementos para el clúster de administrador de VMware.

Representación JSON 
{
  "autoResizeConfig": {
    object (VmwareAutoResizeConfig)
  }
}
Campos
autoResizeConfig

object (VmwareAutoResizeConfig)

La configuración de VmwareAutoResizeConfig especifica la configuración de cambio de tamaño automático.

VmwarePlatformConfig

VmwarePlatformConfig representa la configuración de la plataforma VMware.

Representación JSON 
{
  "requiredPlatformVersion": string,
  "platformVersion": string,
  "bundles": [
    {
      object (VmwareBundleConfig)
    }
  ],
  "status": {
    object (ResourceStatus)
  }
}
Campos
requiredPlatformVersion

string

Solo de entrada. La versión de la plataforma necesaria, por ejemplo, 1.13.1. Si la versión actual de la plataforma es anterior a la de destino, se actualizará a la versión de destino. Si la versión de destino no está instalada en la plataforma (versiones del paquete), descarga el paquete de la versión de destino.
platformVersion

string

Solo de salida. La versión de la plataforma, por ejemplo, 1.13.2.
bundles[]

object (VmwareBundleConfig)

Solo de salida. La lista de paquetes instalados en el clúster de administración.
status

object (ResourceStatus)

Solo de salida. Estado del recurso en la plataforma.

VmwareBundleConfig

VmwareBundleConfig representa la configuración del paquete.

Representación JSON 
{
  "version": string,
  "status": {
    object (ResourceStatus)
  }
}
Campos
version

string

Versión del paquete.
status

object (ResourceStatus)

Solo de salida. Estado del recurso del paquete.

VmwareAdminPreparedSecretsConfig

VmwareAdminPreparedSecretsConfig representa la configuración de los secretos preparados del clúster de administrador.

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

boolean

Indica si los secretos preparados están habilitados.

VmwareAdminAuthorizationConfig

VmwareAdminAuthorizationConfig representa la configuración de la autorización del clúster de administrador.

Representación JSON 
{
  "viewerUsers": [
    {
      object (ClusterUser)
    }
  ]
}
Campos
viewerUsers[]

object (ClusterUser)

En el caso de los clústeres de administradores de VMware, los usuarios tendrán asignado el rol cluster-viewer en el clúster.

VmwareAdminPrivateRegistryConfig

VmwareAdminPrivateRegistryConfig representa la configuración del registro del clúster de administrador.

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

string

Dirección del registro.
caCert

string

Cuando el tiempo de ejecución del contenedor extrae una imagen de un registro privado, el registro debe demostrar su identidad presentando un certificado. El certificado del registro está firmado por una autoridad de certificación (CA). El tiempo de ejecución del contenedor usa el certificado de la AC para validar el certificado del registro.

Métodos

create

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

enroll

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

get

 Obtiene los detalles de un solo clúster de administrador de VMware.

list

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

patch

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