- Recurso: BareMetalCluster
- Estado
- BareMetalNetworkConfig
- BareMetalIslandModeCidrConfig
- BareMetalMultipleNetworkInterfacesConfig
- BareMetalSrIovConfig
- BareMetalControlPlaneConfig
- BareMetalControlPlaneNodePoolConfig
- BareMetalApiServerArgument
- BareMetalLoadBalancerConfig
- BareMetalVipConfig
- BareMetalPortConfig
- BareMetalMetalLbConfig
- BareMetalLoadBalancerAddressPool
- BareMetalLoadBalancerNodePoolConfig
- BareMetalManualLbConfig
- BareMetalBgpLbConfig
- BareMetalBgpPeerConfig
- BareMetalStorageConfig
- BareMetalProxyConfig
- BareMetalClusterOperationsConfig
- BareMetalMaintenanceConfig
- BareMetalWorkloadNodeConfig
- ContainerRuntime
- BareMetalSecurityConfig
- BareMetalMaintenanceStatus
- BareMetalMachineDrainStatus
- BareMetalDrainingMachine
- BareMetalDrainedMachine
- BareMetalNodeAccessConfig
- BareMetalOsEnvironmentConfig
- BareMetalClusterUpgradePolicy
- NodePoolPolicy
- Métodos
Recurso: BareMetalCluster
Recurso que representa un clúster de usuarios de bare metal.
Representación JSON |
---|
{ "name": string, "adminClusterMembership": string, "description": string, "bareMetalVersion": string, "uid": string, "state": enum ( |
Campos | |
---|---|
name |
Inmutable. Nombre del recurso del clúster de usuarios de Bare Metal. |
adminClusterMembership |
Obligatorio. El clúster de administradores al que pertenece este clúster de usuarios de metal desnudo. Es el nombre completo del recurso de la pertenencia a la flota del clúster de administrador. |
description |
Descripción legible por humanos de este clúster de usuario de metal desnudo. |
bareMetalVersion |
Obligatorio. La versión de clústeres de Anthos en Bare Metal de tu clúster de usuario. |
uid |
Solo de salida. Identificador único del clúster de usuario de metal desnudo. |
state |
Solo de salida. El estado actual del clúster de usuarios de metal desnudo. |
endpoint |
Solo de salida. La dirección IP del servidor de la API del clúster de usuario de metal desnudo. |
reconciling |
Solo de salida. Si se define, actualmente hay cambios en curso en el clúster de usuario de bare metal. |
createTime |
Solo de salida. Hora en la que se creó el clúster de usuarios 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ó el clúster de usuario 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 en la que se eliminó el clúster de usuarios 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 de objeto del recurso personalizado del clúster de usuario de metal desnudo 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 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. Cuando el nombre local y el nombre del clúster son diferentes, el nombre local se usa en los registros del controlador del clúster de administrador. Usas el nombre del clúster cuando accedes a él con bmctl y kubectl. |
etag |
Solo de salida. 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 usuario 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 |
Obligatorio. Configuración de red. |
controlPlane |
Obligatorio. Configuración del plano de control. |
loadBalancer |
Obligatorio. Configuración del balanceador de carga. |
storage |
Obligatorio. Configuración del almacenamiento. |
proxy |
Configuración de proxy. |
clusterOperations |
Configuración de las operaciones del clúster. |
maintenanceConfig |
Configuración de mantenimiento. |
nodeConfig |
Configuración de nodos de carga de trabajo. |
fleet |
Solo de salida. Configuración de la flota del clúster. |
status |
Solo de salida. Estado detallado del clúster. |
validationCheck |
Solo de salida. El resultado de la comprobación preparatoria. |
securityConfig |
Configuración de ajustes relacionados con la seguridad. |
maintenanceStatus |
Solo de salida. Estado de las tareas de mantenimiento en curso. |
adminClusterName |
Solo de salida. Nombre de recurso del clúster de administrador de metal desnudo que gestiona este clúster de usuario. |
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. |
upgradePolicy |
Política de actualización del clúster. |
localNamespace |
Solo de salida. Espacio de nombres del clúster. |
Estado
El estado del ciclo de vida del clúster de usuarios de metal desnudo.
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. |
BareMetalNetworkConfig
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. |
srIovConfig |
Configuración de SR-IOV. |
Campo de unión cluster_cidr_configuration . La configuración de CIDR que se va a usar en el clúster de usuario de Bare Metal. cluster_cidr_configuration solo puede ser una de estas dos opciones: |
|
islandModeCidr |
Configuración de CIDR en modo isla. En una red en modo aislado, los nodos tienen direcciones IP únicas, pero los pods no tienen direcciones únicas en los clústeres. Esto no causa problemas porque los pods de un clúster nunca se comunican directamente con los pods de otro clúster. En su lugar, hay pasarelas que median entre un pod de un clúster y un pod de otro clúster. |
BareMetalIslandModeCidrConfig
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 se puede modificar después de la creación a partir de la versión 1.15. |
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. |
BareMetalMultipleNetworkInterfacesConfig
Especifica la configuración de varios clústeres de 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. |
BareMetalSrIovConfig
Especifica la configuración del operador de redes SR-IOV.
Representación JSON |
---|
{ "enabled": boolean } |
Campos | |
---|---|
enabled |
Indica si se debe instalar el operador SR-IOV. |
BareMetalControlPlaneConfig
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. |
apiServerArgs[] |
Personaliza los argumentos predeterminados del servidor de la API. Solo se admite un subconjunto de las marcas personalizadas. Para conocer el formato exacto, consulta la documentación del servidor de la API. |
BareMetalControlPlaneNodePoolConfig
Especifica la configuración del grupo de nodos del plano de control.
Representación JSON |
---|
{
"nodePoolConfig": {
object ( |
Campos | |
---|---|
nodePoolConfig |
Obligatorio. La configuración genérica de un grupo de nodos que ejecuta el plano de control. |
BareMetalApiServerArgument
Representa un par nombre->valor de un argumento. Solo se admite un subconjunto de las marcas personalizadas. Para conocer el formato exacto, consulta la documentación del servidor de la API.
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. |
BareMetalLoadBalancerConfig
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 del clúster de usuarios de metal desnudo. load_balancer_configuration solo puede ser una de estas dos opciones: |
|
metalLbConfig |
Configuración de los balanceadores de carga de MetalLB. |
manualLbConfig |
Balanceadores de carga configurados manualmente. |
bgpLbConfig |
Configuración de balanceadores de carga de tipo BGP. Cuando se establece, networkConfig.advanced_networking se asigna automáticamente al valor true. |
BareMetalVipConfig
Especifica la configuración de la IP virtual del balanceador de carga de metal desnudo.
Representación JSON |
---|
{ "controlPlaneVip": string, "ingressVip": string } |
Campos | |
---|---|
controlPlaneVip |
La IP virtual que has reservado para la API de Kubernetes de este clúster de usuario de hardware desnudo. |
ingressVip |
El VIP que habías reservado para el tráfico de entrada en este clúster de usuario de hardware desnudo. |
BareMetalPortConfig
Especifica los puertos del balanceador de carga del clúster de usuario de metal desnudo.
Representación JSON |
---|
{ "controlPlaneLoadBalancerPort": integer } |
Campos | |
---|---|
controlPlaneLoadBalancerPort |
Puerto en el que escucharán los balanceadores de carga alojados en el plano de control. |
BareMetalMetalLbConfig
Representa los parámetros de configuración de un balanceador de carga de MetalLB.
Representación JSON |
---|
{ "addressPools": [ { object ( |
Campos | |
---|---|
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 balanceador de carga. Es necesario que los nodos de este grupo tengan conectividad de capa 2. Si falta, se usa el grupo de nodos del plano de control como grupo del balanceador de carga. |
BareMetalLoadBalancerAddressPool
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 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 |
Si es true, evita que se asignen direcciones IP automáticamente. |
BareMetalLoadBalancerNodePoolConfig
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. |
BareMetalManualLbConfig
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. |
BareMetalBgpLbConfig
BareMetalBgpLbConfig 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 capa 2. Si falta, se usa el grupo de nodos del plano de control para el balanceo de carga del plano de datos. |
BareMetalBgpPeerConfig
BareMetalBgpPeerConfig representa los parámetros de configuración de un par 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 peer 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. |
BareMetalStorageConfig
BareMetalStorageConfig 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. |
BareMetalProxyConfig
Especifica la configuración de proxy del clúster.
Representación JSON |
---|
{ "uri": string, "noProxy": [ string ] } |
Campos | |
---|---|
uri |
Obligatorio. Especifica la dirección de tu servidor proxy. Ejemplos: 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"]. |
BareMetalClusterOperationsConfig
Especifica la infraestructura de observabilidad del clúster de usuario de bare metal.
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). |
BareMetalMaintenanceConfig
Especifica las configuraciones para poner y quitar nodos de metal desnudo en mantenimiento.
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 cumplen ambas condiciones, se define la anotación "baremetal.cluster.gke.io/maintenance" en el recurso de nodo. |
BareMetalWorkloadNodeConfig
Especifica las configuraciones de los nodos de carga de trabajo.
Representación JSON |
---|
{
"maxPodsPerNode": string,
"containerRuntime": enum ( |
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. |
containerRuntime |
Especifica qué entorno de ejecución de contenedores se usará. |
ContainerRuntime
El tiempo de ejecución que se usa para ejecutar contenedores en este clúster de usuario.
Enumeraciones | |
---|---|
CONTAINER_RUNTIME_UNSPECIFIED |
No se ha seleccionado ningún tiempo de ejecución de contenedor. |
CONTAINERD |
Entorno de ejecución de containerd. |
BareMetalSecurityConfig
Especifica la configuración relacionada con la seguridad del clúster de usuario de metal desnudo.
Representación JSON |
---|
{
"authorization": {
object ( |
Campos | |
---|---|
authorization |
Configura el acceso de los usuarios al clúster de usuario. |
BareMetalMaintenanceStatus
Representa el estado de mantenimiento del clúster de usuarios de metal desnudo.
Representación JSON |
---|
{
"machineDrainStatus": {
object ( |
Campos | |
---|---|
machineDrainStatus |
El estado de mantenimiento de las máquinas de los nodos. |
BareMetalMachineDrainStatus
Representa el estado de las máquinas de nodo que están sometidas a operaciones de drenaje.
Representación JSON |
---|
{ "drainingMachines": [ { object ( |
Campos | |
---|---|
drainingMachines[] |
Lista de máquinas de drenaje. |
drainedMachines[] |
Lista de máquinas agotadas. |
BareMetalDrainingMachine
Representa una máquina que se está 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. |
BareMetalDrainedMachine
Representa una máquina que se está drenando.
Representación JSON |
---|
{ "nodeIp": string } |
Campos | |
---|---|
nodeIp |
Dirección IP de la máquina drenada. |
BareMetalNodeAccessConfig
Especifica la configuración relacionada con el acceso a los nodos del clúster de usuario de hardware desnudo.
Representación JSON |
---|
{ "loginUser": string } |
Campos | |
---|---|
loginUser |
LoginUser es el nombre de usuario que se usa para acceder a las máquinas de nodos. Si no se define ningún valor, el valor predeterminado será "root". |
BareMetalOsEnvironmentConfig
Especifica la configuración del sistema operativo para el aprovisionamiento del clúster.
Representación JSON |
---|
{ "packageRepoExcluded": boolean } |
Campos | |
---|---|
packageRepoExcluded |
Indica si el repositorio de paquetes no se debe incluir al inicializar máquinas Bare Metal. |
BareMetalClusterUpgradePolicy
BareMetalClusterUpgradePolicy define la política de actualización del clúster.
Representación JSON |
---|
{
"policy": enum ( |
Campos | |
---|---|
policy |
Especifica qué política de actualizaciones se debe usar. |
pause |
Solo de salida. Pause se usa para mostrar el estado de la pausa de la actualización. Por ahora, solo se puede ver. |
NodePoolPolicy
Especifica la política de actualización de los grupos de nodos de trabajador.
Enumeraciones | |
---|---|
NODE_POOL_POLICY_UNSPECIFIED |
No se ha seleccionado ninguna política de actualización. |
SERIAL |
Actualiza los grupos de nodos de trabajador de forma secuencial. |
CONCURRENT |
Actualiza todos los grupos de nodos de trabajo en paralelo. |
Métodos |
|
---|---|
|
Crea un clúster de metal desnudo en un proyecto y una ubicación determinados. |
|
Elimina un solo clúster de Bare Metal. |
|
Registra un clúster de usuario de metal desnudo y sus grupos de nodos en la API Anthos On-Prem de un proyecto y una ubicación determinados. |
|
Obtiene los detalles de un solo clúster de Bare Metal. |
|
Muestra los clústeres de metal desnudo de un proyecto y una ubicación determinados. |
|
Actualiza los parámetros de un solo clúster de Bare Metal. |
|
Consulta la configuración de la versión del clúster de usuarios de metal desnudo. |