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)
  }
}
Campos
name

string

Inmutable. Es el nombre del recurso del clúster de administrador de VMware.

description

string

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 es posible que se envíe 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. La hora en la que se creó el clúster de administrador de VMware.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Por ejemplo: "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. La hora en la que se actualizó el clúster de administrador de VMware por última vez.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Por ejemplo: "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. El estado actual del clúster de administrador de VMware.

endpoint

string

Solo salida. Es el nombre DNS del servidor de 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. Es el nombre del objeto del recurso personalizado VMware OnPremAdminCluster. Este campo se usa para admitir nombres en conflicto cuando se inscriben clústeres existentes en la API. Cuando se use 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 que proporcionó 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 vean los registros del controlador de clúster de administrador.

bootstrapClusterMembership

string

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

onPremVersion

string

Los clústeres de Anthos en la versión de VMware del clúster de administrador

fleet

object (Fleet)

Solo salida. Configuración de la flota para el clúster.

imageType

string

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

vcenter

object (VmwareAdminVCenterConfig)

La configuración de VCenter del clúster de administrador de VMware

networkConfig

object (VmwareAdminNetworkConfig)

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

loadBalancer

object (VmwareAdminLoadBalancerConfig)

Configuración del balanceador de cargas del clúster de administrador de VMware.

controlPlaneNode

object (VmwareAdminControlPlaneNodeConfig)

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

addonNode

object (VmwareAdminAddonNodeConfig)

La configuración del nodo de complemento del clúster de administrador de VMware

antiAffinityGroups

object (VmwareAAGConfig)

Configuración del grupo de antiafinidad del clúster de administrador de VMware

autoRepairConfig

object (VmwareAutoRepairConfig)

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

status

object (ResourceStatus)

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

platformConfig

object (VmwarePlatformConfig)

La configuración de la plataforma de VMware.

preparedSecrets

object (VmwareAdminPreparedSecretsConfig)

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

authorization

object (VmwareAdminAuthorizationConfig)

La configuración de autorización del clúster de administrador de VMware

validationCheck

object (ValidationCheck)

Solo salida. ValidationCheck representa el resultado de la tarea de verificación previa.

Estado

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. Permanece disponible, pero es posible que el rendimiento se vea afectado.
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 la AC 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) del 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 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 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)

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)

Configuración de una IP estática.

dhcpIpConfig

object (VmwareDhcpIpConfig)

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

VmwareAdminHAControlPlaneConfig

Especifica la configuración del plano de control del 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)

Las VIP que usa el balanceador de cargas

Campo de unión load_balancer_configuration. 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)

Configuración para balanceadores de cargas de tipo 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. Configuración para balanceadores de cargas de tipo Seesaw.

VmwareAdminVipConfig

VmwareAdminVipConfig para configuraciones de balanceador de cargas de VMware

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

string

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

VmwareAdminF5BigIpConfig

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

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

string

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

El nombre del grupo. Solo es necesario si usas SNAT.

VmwareAdminManualLbConfig

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

integer

Es el NodePort para el HTTP del servicio de entrada. 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 HTTPS del servicio 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

NodePort para el servicio de 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 de servidor de conectividad que se ejecuta como un contenedor secundario en cada pod de kube-apiserver (p. ej., 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 cargas de MetalLB. Actualmente, no se necesita ninguna configuración para los clústeres de administrador.

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 puede vincular una configuración preexistente a un clúster de usuario nuevo.

IMPORTANTE: Cuando intentes crear un clúster de usuarios con un balanceador de cargas Seesaw preexistente, deberás seguir algunos pasos de preparación antes de llamar al método de la API "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 nombres : -gke-onprem-mgmt o -gke-onprem-mgmt, según si usaste "VmwareCluster.local_name" para desambiguar las colisiones. Para obtener más información, 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 los siguientes nombres: "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

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 el elemento principal del grupo de Seesaw.

ipBlocks[]

object (VmwareIpBlock)

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

Son los nombres de las VMs creadas para este grupo de Seesaw.

stackdriverName

string

Es el 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. (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 de VMware.

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

string

Solo entrada. 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, la versión de la plataforma se actualizará a la versión de destino. Si la versión objetivo no está instalada en la plataforma (versiones del paquete), descarga el paquete de la versión objetivo.

platformVersion

string

Solo salida. La versión de la plataforma, p.ej., 1.13.2.

bundles[]

object (VmwareBundleConfig)

Solo salida. La lista de paquetes instalados en el clúster de administrador.

status

object (ResourceStatus)

Solo salida. Estado del recurso de 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. 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 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 visor de clústeres.

Métodos

create

Crea un nuevo clúster de administrador de VMware 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

Muestra una lista de 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.