- Recurso: BareMetalAdminCluster
- Estado
- BareMetalAdminNetworkConfig
- BareMetalAdminIslandModeCidrConfig
- BareMetalAdminMultipleNetworkInterfacesConfig
- BareMetalAdminControlPlaneConfig
- BareMetalAdminControlPlaneNodePoolConfig
- BareMetalAdminApiServerArgument
- BareMetalAdminLoadBalancerConfig
- BareMetalAdminVipConfig
- BareMetalAdminPortConfig
- BareMetalAdminManualLbConfig
- BareMetalAdminBgpLbConfig
- BareMetalAdminBgpPeerConfig
- BareMetalAdminLoadBalancerAddressPool
- BareMetalAdminLoadBalancerNodePoolConfig
- BareMetalAdminStorageConfig
- BareMetalAdminClusterOperationsConfig
- BareMetalAdminMaintenanceConfig
- BareMetalAdminMaintenanceStatus
- BareMetalAdminMachineDrainStatus
- BareMetalAdminDrainingMachine
- BareMetalAdminDrainedMachine
- BareMetalAdminWorkloadNodeConfig
- BareMetalAdminProxyConfig
- BareMetalAdminSecurityConfig
- BareMetalAdminNodeAccessConfig
- BareMetalAdminOsEnvironmentConfig
- Métodos
Recurso: BareMetalAdminCluster
Recurso que representa un clúster de administrador de Bare Metal.
| Representación JSON |
|---|
{ "name": string, "description": string, "uid": string, "bareMetalVersion": string, "state": enum ( |
| Campos | |
|---|---|
name |
Inmutable. Nombre de recurso del clúster de administrador de metal desnudo. |
description |
Descripción legible por humanos de este clúster de administrador de metal desnudo. |
uid |
Solo de salida. Identificador único del clúster de administrador de metal desnudo. |
bareMetalVersion |
Versión de los clústeres de Anthos en Bare Metal del clúster de administrador de Bare Metal. |
state |
Solo de salida. El estado actual del clúster de administrador de bare metal. |
endpoint |
Solo de salida. Nombre de la dirección IP del servidor de la API del clúster de administrador de metal desnudo. |
reconciling |
Solo de salida. Si se define, actualmente hay cambios en curso en el clúster de administración de hardware. |
createTime |
Solo de salida. Hora a la que se creó este clúster de administrador de metal desnudo. 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: |
updateTime |
Solo de salida. Hora a la que se actualizó este clúster de administrador de metal desnudo 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: |
deleteTime |
Solo de salida. Hora a la que se eliminó este clúster de administrador de metal desnudo. Si el recurso no se elimina, este campo debe estar vacío. 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: |
localName |
Solo de salida. Nombre del objeto del recurso personalizado del clúster de metal desnudo. 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 |
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 |
Anotaciones en el clúster de administrador de bare metal. 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 |
networkConfig |
Configuración de red. |
controlPlane |
Configuración del plano de control. |
loadBalancer |
Configuración del balanceador de carga. |
storage |
Configuración del almacenamiento. |
fleet |
Solo de salida. Configuración de la flota del clúster. |
clusterOperations |
Configuración de las operaciones del clúster. |
status |
Solo de salida. ResourceStatus que representa el estado detallado del clúster. |
maintenanceConfig |
Configuración de mantenimiento. |
maintenanceStatus |
Solo de salida. MaintenanceStatus que representa el estado del mantenimiento. |
validationCheck |
Solo de salida. ValidationCheck que representa el resultado de la comprobación preparatoria. |
nodeConfig |
Configuración de nodos de carga de trabajo. |
proxy |
Configuración de proxy. |
securityConfig |
Configuración relacionada con la seguridad. |
nodeAccessConfig |
Configuraciones relacionadas con el acceso a los nodos. |
osEnvironmentConfig |
Configuraciones relacionadas con el entorno del SO. |
binaryAuthorization |
Configuraciones relacionadas con la autorización binaria. |
Estado
El estado del ciclo de vida del clúster de administrador de Bare Metal.
| 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. |
BareMetalAdminNetworkConfig
BareMetalAdminNetworkConfig especifica la configuración de la red del clúster.
| Representación JSON |
|---|
{ "advancedNetworking": boolean, "multipleNetworkInterfacesConfig": { object ( |
| Campos | |
|---|---|
advancedNetworking |
Permite usar funciones de red avanzadas de Anthos, como el balanceo de carga agrupado con BGP o la pasarela NAT de salida. Si configuras los ajustes de las funciones de redes avanzadas, esta marca se definirá automáticamente. |
multipleNetworkInterfacesConfig |
Configuración de varias interfaces de red. |
Campo de unión cluster_cidr_configuration. La configuración de CIDR que se va a usar en el clúster de administrador. cluster_cidr_configuration solo puede ser una de estas dos opciones: |
|
islandModeCidr |
Configuración de CIDR del modo Island. |
BareMetalAdminIslandModeCidrConfig
BareMetalAdminIslandModeCidrConfig especifica la configuración de CIDR del clúster cuando se ejecuta en modo aislado.
| Representación JSON |
|---|
{ "serviceAddressCidrBlocks": [ string ], "podAddressCidrBlocks": [ string ] } |
| Campos | |
|---|---|
serviceAddressCidrBlocks[] |
Obligatorio. A todos los servicios del clúster se les asigna una dirección IPv4 RFC1918 de estos intervalos. Este campo no se puede cambiar después de crearse. |
podAddressCidrBlocks[] |
Obligatorio. Se ha asignado una dirección IPv4 de RFC1918 de estos intervalos a todos los pods del clúster. Este campo no se puede cambiar después de crearse. |
BareMetalAdminMultipleNetworkInterfacesConfig
Especifica la configuración de clúster de varias interfaces de red.
| Representación JSON |
|---|
{ "enabled": boolean } |
| Campos | |
|---|---|
enabled |
Indica si se deben habilitar varias interfaces de red para los pods. Cuando se establece, networkConfig.advanced_networking se asigna automáticamente al valor true. |
BareMetalAdminControlPlaneConfig
BareMetalAdminControlPlaneConfig especifica la configuración del plano de control.
| Representación JSON |
|---|
{ "controlPlaneNodePoolConfig": { object ( |
| Campos | |
|---|---|
controlPlaneNodePoolConfig |
Obligatorio. Configura el grupo de nodos que ejecuta el plano de control. Si se especifica, se creará el NodePool correspondiente para el plano de control del clúster. El NodePool tendrá el mismo nombre y espacio de nombres que el clúster. |
apiServerArgs[] |
Personaliza los argumentos predeterminados del servidor de la API. Solo se admite un subconjunto de las marcas personalizadas. Consulta la documentación del servidor de la API que aparece más abajo para conocer el formato exacto: https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/. |
BareMetalAdminControlPlaneNodePoolConfig
BareMetalAdminControlPlaneNodePoolConfig especifica la configuración del grupo de nodos del plano de control. Tenemos una configuración de grupo de nodos específica del plano de control para poder ofrecer flexibilidad a la hora de admitir campos específicos del plano de control en el futuro.
| Representación JSON |
|---|
{
"nodePoolConfig": {
object ( |
| Campos | |
|---|---|
nodePoolConfig |
Obligatorio. Configuración genérica de un grupo de nodos que ejecuta el plano de control. |
BareMetalAdminApiServerArgument
BareMetalAdminApiServerArgument representa un par nombre->valor de arg. Solo se admite un subconjunto de las marcas personalizadas. Consulta la documentación del servidor de la API que aparece más abajo para conocer el formato exacto: https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/.
| Representación JSON |
|---|
{ "argument": string, "value": string } |
| Campos | |
|---|---|
argument |
Obligatorio. El nombre del argumento tal como aparece en la línea de comandos del servidor de la API. Asegúrate de quitar los guiones iniciales. |
value |
Obligatorio. El valor del argumento tal como se enviará a la línea de comandos del servidor de la API. |
BareMetalAdminLoadBalancerConfig
BareMetalAdminLoadBalancerConfig especifica la configuración del balanceador de carga.
| Representación JSON |
|---|
{ "vipConfig": { object ( |
| Campos | |
|---|---|
vipConfig |
Las IPs virtuales que usa el balanceador de carga. |
portConfig |
Configura los puertos en los que escuchará 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 administrador. load_balancer_configuration solo puede ser una de estas dos opciones: |
|
manualLbConfig |
Balanceadores de carga configurados manualmente. |
bgpLbConfig |
Configuración de balanceadores de carga con tipo BGP. |
BareMetalAdminVipConfig
BareMetalAdminVipConfig para configuraciones de balanceadores de carga de Bare Metal.
| Representación JSON |
|---|
{ "controlPlaneVip": string } |
| Campos | |
|---|---|
controlPlaneVip |
La dirección IP virtual que has reservado para la API de Kubernetes de este clúster de administrador de hardware desnudo. |
BareMetalAdminPortConfig
BareMetalAdminPortConfig es la especificación de los puertos del balanceador de carga.
| Representación JSON |
|---|
{ "controlPlaneLoadBalancerPort": integer } |
| Campos | |
|---|---|
controlPlaneLoadBalancerPort |
Puerto en el que escucharán los balanceadores de carga alojados en el plano de control. |
BareMetalAdminManualLbConfig
BareMetalAdminManualLbConfig representa los parámetros de configuración de un balanceador de carga manual.
| Representación JSON |
|---|
{ "enabled": boolean } |
| Campos | |
|---|---|
enabled |
Indica si el balanceo de carga manual está habilitado. |
BareMetalAdminBgpLbConfig
BareMetalAdminBgpLbConfig representa los parámetros de configuración de un balanceador de carga de protocolo de pasarela fronteriza (BGP).
| Representación JSON |
|---|
{ "asn": string, "bgpPeerConfigs": [ { object ( |
| Campos | |
|---|---|
asn |
Obligatorio. Número de sistema autónomo (ASN) de BGP del clúster. Este campo se puede actualizar después de crear el clúster. |
bgpPeerConfigs[] |
Obligatorio. Lista de pares de BGP a los que se conectará el clúster. Se debe configurar al menos un peer para cada nodo del plano de control. Los nodos del plano de control se conectarán a estos peers para anunciar la IP virtual del plano de control. El balanceador de carga de Servicios también usa estos peers de forma predeterminada. Este campo se puede actualizar después de crear el clúster. |
addressPools[] |
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. |
loadBalancerNodePoolConfig |
Especifica el grupo de nodos que ejecuta el balanceo de carga del plano de datos. Es necesario que los nodos de este grupo tengan conectividad de nivel 2. Si falta, se usa el grupo de nodos del plano de control para el balanceo de carga del plano de datos. |
BareMetalAdminBgpPeerConfig
BareMetalAdminBgpPeerConfig representa los parámetros de configuración de un peer de protocolo de pasarela fronteriza (BGP).
| Representación JSON |
|---|
{ "asn": string, "ipAddress": string, "controlPlaneNodes": [ string ] } |
| Campos | |
|---|---|
asn |
Obligatorio. Número de sistema autónomo (ASN) de BGP de la red que contiene el dispositivo peer externo. |
ipAddress |
Obligatorio. La dirección IP del dispositivo de par externo. |
controlPlaneNodes[] |
Dirección IP del nodo del plano de control que se conecta al peer externo. Si no especificas ningún nodo de plano de control, todos los nodos de plano de control podrán conectarse al peer externo. Si especifica una o varias direcciones IP, solo los nodos especificados participarán en las sesiones de emparejamiento. |
BareMetalAdminLoadBalancerAddressPool
Representa un grupo de IPs que usa el balanceador de carga.
| Representación JSON |
|---|
{ "pool": string, "addresses": [ string ], "avoidBuggyIps": boolean, "manualAssign": boolean } |
| Campos | |
|---|---|
pool |
Obligatorio. Nombre del grupo de direcciones. |
addresses[] |
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 |
Si el valor es "true", no utilices IPs que terminen en .0 o .255. De esta forma, se evita que los dispositivos de consumo con errores eliminen por error el tráfico IPv4 de esas direcciones IP especiales. |
manualAssign |
Si es true, evita que se asignen direcciones IP automáticamente. |
BareMetalAdminLoadBalancerNodePoolConfig
Especifica la configuración del grupo de nodos del balanceador de carga.
| Representación JSON |
|---|
{
"nodePoolConfig": {
object ( |
| Campos | |
|---|---|
nodePoolConfig |
Configuración genérica de un grupo de nodos que ejecuta un balanceador de carga. |
BareMetalAdminStorageConfig
BareMetalAdminStorageConfig especifica la configuración del almacenamiento del clúster.
| Representación JSON |
|---|
{ "lvpShareConfig": { object ( |
| Campos | |
|---|---|
lvpShareConfig |
Obligatorio. Especifica la configuración de los PersistentVolumes locales respaldados por subdirectorios de un sistema de archivos compartido. Estos subdirectorios se crean automáticamente durante la creación del clúster. |
lvpNodeMountsConfig |
Obligatorio. Especifica la configuración de los PersistentVolumes locales respaldados por discos de nodos montados. El usuario debe formatear y montar estos discos, lo que puede hacer antes o después de crear el clúster. |
BareMetalAdminClusterOperationsConfig
BareMetalAdminClusterOperationsConfig especifica la infraestructura de observabilidad del clúster de administrador.
| Representación JSON |
|---|
{ "enableApplicationLogs": boolean } |
| Campos | |
|---|---|
enableApplicationLogs |
Indica si se debe habilitar la recogida de registros o métricas de aplicaciones (además de los registros o métricas del sistema). |
BareMetalAdminMaintenanceConfig
BareMetalAdminMaintenanceConfig especifica las configuraciones para poner los nodos de CR del clúster de administrador de Bare Metal en mantenimiento y fuera de él.
| Representación JSON |
|---|
{ "maintenanceAddressCidrBlocks": [ string ] } |
| Campos | |
|---|---|
maintenanceAddressCidrBlocks[] |
Obligatorio. Todas las direcciones IPv4 de estos intervalos se pondrán en modo de mantenimiento. Los nodos en modo de mantenimiento se acordonarán y se drenarán. Cuando se cumplan ambas condiciones, se definirá la anotación "baremetal.cluster.gke.io/maintenance" en el recurso de nodo. |
BareMetalAdminMaintenanceStatus
BareMetalAdminMaintenanceStatus representa el estado de mantenimiento de los nodos de CR del clúster de administrador de Bare Metal.
| Representación JSON |
|---|
{
"machineDrainStatus": {
object ( |
| Campos | |
|---|---|
machineDrainStatus |
Representa el estado de los nodos de la máquina que se están drenando y los que ya se han drenado. Se usa para mostrar el progreso de la actualización del clúster. |
BareMetalAdminMachineDrainStatus
BareMetalAdminMachineDrainStatus representa el estado de las máquinas de nodos de metal desnudo que están sometidas a operaciones de drenaje.
| Representación JSON |
|---|
{ "drainingMachines": [ { object ( |
| Campos | |
|---|---|
drainingMachines[] |
Lista de máquinas en proceso de drenaje. |
drainedMachines[] |
Lista de máquinas agotadas. |
BareMetalAdminDrainingMachine
BareMetalAdminDrainingMachine representa las máquinas que se están drenando.
| Representación JSON |
|---|
{ "nodeIp": string, "podCount": integer } |
| Campos | |
|---|---|
nodeIp |
Dirección IP de la máquina de drenaje. |
podCount |
Número de pods que aún no se han drenado. |
BareMetalAdminDrainedMachine
BareMetalAdminDrainedMachine representa las máquinas que se han drenado.
| Representación JSON |
|---|
{ "nodeIp": string } |
| Campos | |
|---|---|
nodeIp |
Dirección IP de la máquina agotada. |
BareMetalAdminWorkloadNodeConfig
BareMetalAdminWorkloadNodeConfig especifica las configuraciones de los nodos de carga de trabajo.
| Representación JSON |
|---|
{ "maxPodsPerNode": string } |
| Campos | |
|---|---|
maxPodsPerNode |
Número máximo de pods que puede ejecutar un nodo. El tamaño del intervalo CIDR asignado al nodo se derivará de este parámetro. De forma predeterminada, se crean 110 pods por nodo. El límite superior es de 250 tanto para los clústeres de administrador de alta disponibilidad como para los que no lo son. El límite inferior es 64 para los clústeres de administradores que no son de alta disponibilidad y 32 para los que sí lo son. |
BareMetalAdminProxyConfig
BareMetalAdminProxyConfig especifica la configuración del proxy del clúster.
| Representación JSON |
|---|
{ "uri": string, "noProxy": [ string ] } |
| Campos | |
|---|---|
uri |
Obligatorio. Especifica la dirección de tu servidor proxy. Ejemplos: ADVERTENCIA: No proporciones credenciales en el formato |
noProxy[] |
Lista de IPs, nombres de host y dominios que deben omitir el proxy. Ejemplos: ["127.0.0.1", "example.com", ".corp", "localhost"]. |
BareMetalAdminSecurityConfig
Especifica los ajustes relacionados con la seguridad del clúster de administrador de metal desnudo.
| Representación JSON |
|---|
{
"authorization": {
object ( |
| Campos | |
|---|---|
authorization |
Configura el acceso de los usuarios al clúster de administrador. |
BareMetalAdminNodeAccessConfig
Especifica los ajustes relacionados con el acceso a nodos del clúster de administrador de metal desnudo.
| Representación JSON |
|---|
{ "loginUser": string } |
| Campos | |
|---|---|
loginUser |
Obligatorio. LoginUser es el nombre de usuario que se usa para acceder a las máquinas de nodos. Si no se define ninguno, el valor predeterminado será "root". |
BareMetalAdminOsEnvironmentConfig
Especifica la configuración de funcionamiento del sistema operativo para el aprovisionamiento de clústeres.
| Representación JSON |
|---|
{ "packageRepoExcluded": boolean } |
| Campos | |
|---|---|
packageRepoExcluded |
Indica si se debe añadir el repositorio de paquetes al inicializar máquinas Bare Metal. |
Métodos |
|
|---|---|
|
Crea un clúster de administrador de metal desnudo en un proyecto y una ubicación determinados. |
|
Registra un clúster de administrador de metal desnudo en la API Anthos On-Prem en un proyecto y una ubicación determinados. |
|
Obtiene los detalles de un solo clúster de administrador de bare metal. |
|
Muestra los clústeres de administrador de metal desnudo de un proyecto y una ubicación determinados. |
|
Actualiza los parámetros de un solo clúster de administrador de bare metal. |
|
Consulta la configuración de la versión del clúster de administradores de Bare Metal. |