REST Resource: projects.locations.vmwareAdminClusters

Recurso: VmwareAdminCluster

Es un 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. Es el nombre del recurso del clúster de administrador de VMware.
description

string

Es una descripción legible por humanos de este clúster de administrador de VMware.
uid

string

Solo salida. Es el identificador único del clúster de administrador de VMware.
etag

string

El servidor calcula esta suma de comprobación según el valor de otros campos y se puede enviar en las solicitudes de actualización y eliminación para garantizar que el cliente tenga un valor actualizado antes de continuar. Permite a los clientes realizar operaciones de lectura, modificación y escritura coherentes a través del control de simultaneidad optimista.
createTime

string (Timestamp format)

Solo salida. Es la fecha y hora en que se creó el clúster de administrador de VMware.

Usa el RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean "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 salida. Fecha y hora en la que se actualizó el clúster de administrador de VMware por última vez.

Usa el RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean "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 administrador de VMware. Este campo tiene las mismas restricciones que las anotaciones de Kubernetes. El tamaño total de todas las claves y valores combinados se limita a 256,000. La clave puede tener 2 segmentos: prefijo (opcional) y nombre (obligatorio), separados por una barra diagonal (/). El prefijo debe ser un subdominio DNS. El nombre debe tener 63 caracteres o menos, comenzar y terminar con caracteres alfanuméricos, con guiones (-), guiones bajos (_), puntos (.) y caracteres alfanuméricos en el medio.

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

enum (State)

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

string

Solo salida. Es el nombre de DNS del servidor de la API del clúster de administrador de VMware.
reconciling

boolean

Solo salida. Si se configura, actualmente hay cambios en tránsito en el clúster de administrador de VMware.
localName

string

Solo salida. Nombre del objeto del recurso personalizado OnPremAdminCluster de VMware. Este campo se usa para admitir nombres en conflicto cuando se inscriben clústeres existentes en la API. Cuando se usa como parte de la inscripción del clúster, este campo diferirá del ID en el nombre del recurso. En el caso de los clústeres nuevos, este campo coincidirá con el nombre del clúster proporcionado por el usuario y será visible 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 con gkectl o kubectl, y deben esperar ver el nombre local cuando visualicen los registros del controlador del clúster de administrador.
bootstrapClusterMembership

string

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

string

Es la versión de clústeres de Anthos alojados en VMware para el clúster de administrador.
fleet

object (Fleet)

Solo salida. Es la configuración de la flota para el clúster.
imageType

string

Es el tipo de imagen de SO para el clúster de administrador de VMware.
vcenter

object (VmwareAdminVCenterConfig)

Es la configuración de vCenter del clúster de administrador de VMware.
networkConfig

object (VmwareAdminNetworkConfig)

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

object (VmwareAdminLoadBalancerConfig)

Es la configuración del balanceador de cargas del clúster de administrador de VMware.
controlPlaneNode

object (VmwareAdminControlPlaneNodeConfig)

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

object (VmwareAdminAddonNodeConfig)

Es la configuración del nodo de complemento del clúster de administrador de VMware.
antiAffinityGroups

object (VmwareAAGConfig)

Es la configuración del grupo de antiafinidad del clúster de administrador de VMware.
autoRepairConfig

object (VmwareAutoRepairConfig)

Es la configuración de reparación automática del clúster de administrador de VMware.
status

object (ResourceStatus)

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

object (VmwarePlatformConfig)

Es la configuración de la plataforma de VMware.
preparedSecrets

object (VmwareAdminPreparedSecretsConfig)

Solo salida. Es la configuración de Secrets preparados del clúster de administrador de VMware. La API central siempre debe habilitarlo, en lugar de permitir que los usuarios lo configuren.
authorization

object (VmwareAdminAuthorizationConfig)

Es la configuración de autorización del clúster de administrador de VMware.
validationCheck

object (ValidationCheck)

Solo salida. ValidationCheck representa el resultado del trabajo de verificación previa.
privateRegistryConfig

object (VmwareAdminPrivateRegistryConfig)

Es la configuración del registro.
enableAdvancedCluster

boolean

Habilita el clúster avanzado.

Estado

Es el estado del ciclo de vida del clúster de administrador de VMware.

Enums
STATE_UNSPECIFIED Sin establecer.
PROVISIONING El estado PROVISIONING indica que se está creando el clúster.
RUNNING El estado RUNNING indica que el clúster se creó y se puede usar por completo.
RECONCILING El estado RECONCILING indica que el clúster se está actualizando. Sigue disponible, pero es posible que disminuya el rendimiento.
STOPPING El estado STOPPING indica que se está borrando el clúster.
ERROR El estado ERROR indica que el clúster se encuentra en un estado con daño irrecuperable.
DEGRADED El estado DEGRADED indica que el clúster requiere una acción del usuario para restablecer la funcionalidad completa.

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

Es el nombre del grupo de recursos de vCenter para el clúster de administrador.
datastore

string

Es el nombre del almacén de datos de vCenter para el clúster de administrador.
datacenter

string

Es el nombre del centro de datos de vCenter para el clúster de administrador.
cluster

string

Es el nombre del clúster de vCenter para el clúster de administrador.
folder

string

Es el nombre de la carpeta de vCenter para el clúster de administrador.
caCertData

string

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

string

La dirección IP de vCenter
dataDisk

string

Es el nombre del disco de máquina virtual (VMDK) para el clúster de administrador.
storagePolicyName

string

Es el nombre de la política de almacenamiento de vCenter para el clúster de usuario.

VmwareAdminNetworkConfig

VmwareAdminNetworkConfig contiene la configuración de red para el 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 rangos. Solo se admite un rango. No se puede cambiar este campo después de crearlo.
podAddressCidrBlocks[]

string

Obligatorio. A todos los pods del clúster se les asigna una dirección IPv4 RFC1918 de estos rangos. Solo se admite un rango. No se puede cambiar este campo después de crearlo.
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)

Es la configuración del plano de control del clúster de administrador de alta disponibilidad.
Campo de unión ip_configuration. Es el tipo de configuración de IP que usa el clúster de administrador de VMware. ip_configuration puede ser solo uno de los siguientes:
staticIpConfig

object (VmwareStaticIpConfig)

Es la configuración de una dirección IP estática.
dhcpIpConfig

object (VmwareDhcpIpConfig)

Es la configuración de una IP de DHCP.

VmwareAdminHAControlPlaneConfig

Especifica la configuración del plano de control de administrador de HA.

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

object (VmwareIpBlock)

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

VmwareAdminLoadBalancerConfig

VmwareAdminLoadBalancerConfig contiene la configuración del balanceador de cargas para el 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)

Son las VIP que usa el balanceador de cargas.
Campo de unión load_balancer_configuration. Es la configuración del balanceador de cargas que se usará en el clúster de administrador de VMware. load_balancer_configuration puede ser solo uno de los siguientes:
f5Config

object (VmwareAdminF5BigIpConfig)

Es la configuración para los balanceadores de cargas con tipo de F5 Big IP.
manualLbConfig

object (VmwareAdminManualLbConfig)

Balanceadores de cargas configurados de forma manual
metalLbConfig

object (VmwareAdminMetalLbConfig)

Balanceadores de cargas de MetalLB
seesawConfig

object (VmwareAdminSeesawConfig)

Solo salida. Es la configuración para los balanceadores de cargas con escritura de Seesaw.

VmwareAdminVipConfig

Es la configuración de VmwareAdminVipConfig para las configuraciones del balanceador de cargas de VMware.

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

string

Es la VIP que reservaste anteriormente para la API de Kubernetes del clúster de administrador.
addonsVip

string

Es la VIP para configurar el balanceador de cargas para complementos.

VmwareAdminF5BigIpConfig

VmwareAdminF5BigIpConfig representa los parámetros de configuración de un balanceador de cargas de BIG-IP de F5.

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

string

Es la dirección IP del balanceador de cargas.
partition

string

Es la partición preexistente que usará el balanceador de cargas. Por lo general, esta partición se crea para el clúster de administrador, por ejemplo, "my-f5-admin-partition".
snatPool

string

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

Es el NodePort para el servicio de entrada http. El servicio de entrada en el clúster de administrador se implementa como un Service de tipo NodePort (p. ej., 32527).
ingressHttpsNodePort

integer

Es el NodePort para el servicio HTTPS de entrada. El servicio de entrada en el clúster de administrador se implementa como un Service de tipo NodePort (p. ej., 30139).
controlPlaneNodePort

integer

Es el NodePort para el servicio del plano de control. El servidor de la API de Kubernetes en el clúster de administrador se implementa como un Service de tipo NodePort (p. ej., 30968).
konnectivityServerNodePort

integer

NodePort para el servicio del servidor de konnectivity que se ejecuta como un sidecar en cada Pod de kube-apiserver (p. ej., 30564).
addonsNodePort

integer

Es el valor de 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 cargas de MetalLB. En el caso de los clústeres de administrador, actualmente no se necesita 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 cargas de Seesaw ya existente.

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

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

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

string

En general, se debe usar el siguiente formato para el nombre del grupo de Seesaw: seesaw-for-[clusterName].
masterIp

string

MasterIP es la IP que anuncia la instancia principal del grupo de Seesaw.
ipBlocks[]

object (VmwareIpBlock)

Son los bloques de IP que usará el balanceador de cargas de Seesaw.
enableHa

boolean

Habilita dos VMs de balanceador de cargas para lograr un balanceador de cargas de Seesaw con 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 del plano de control para el clúster de administrador de VMware.

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

string (int64 format)

La cantidad de CPU virtuales para el nodo del plano de control del clúster de administrador.
memory

string (int64 format)

Es la cantidad de mebibytes de memoria para el nodo del plano de control del clúster de administrador.
replicas

string (int64 format)

Es la cantidad de nodos del plano de control para este clúster de administrador de VMware. (valor predeterminado: 1 réplica).

VmwareAdminAddonNodeConfig

VmwareAdminAddonNodeConfig contiene la configuración 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 de VMware.

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

string

Solo entrada. Es la versión de la plataforma requerida, p.ej., 1.13.1. Si la versión actual de la plataforma es inferior a la versión de destino, se actualizará a la versión de destino. Si la versión de destino no está instalada en la plataforma (versiones de paquete), descarga el paquete de la versión de destino.
platformVersion

string

Solo salida. Es la versión de la plataforma, p.ej., 1.13.2.
bundles[]

object (VmwareBundleConfig)

Solo salida. Es la lista de paquetes instalados en el clúster de administrador.
status

object (ResourceStatus)

Solo salida. Es el estado del recurso para la plataforma.

VmwareBundleConfig

VmwareBundleConfig representa la configuración del paquete.

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

string

Es la versión del paquete.
status

object (ResourceStatus)

Solo salida. Es el estado del recurso del paquete.

VmwareAdminPreparedSecretsConfig

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

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

boolean

Indica si los Secrets preparados están habilitados.

VmwareAdminAuthorizationConfig

VmwareAdminAuthorizationConfig representa la configuración para 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 administrador de VMware, a los usuarios se les otorgará el rol de visualizador de clústeres.

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 entorno de ejecución del contenedor extrae una imagen del registro privado, el registro debe demostrar su identidad con la presentación de un certificado. El certificado del registro está firmado por una autoridad certificadora (AC). El entorno de ejecución del contenedor usa el certificado de la CA para validar el certificado del registro.

Métodos

create

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

enroll

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

get

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

list

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

patch

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