- 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
Es un recurso que representa un clúster de usuario de Bare Metal.
Representación JSON |
---|
{ "name": string, "adminClusterMembership": string, "description": string, "bareMetalVersion": string, "uid": string, "state": enum ( |
Campos | |
---|---|
name |
Inmutable. Es el nombre del recurso del clúster de usuario de Bare Metal. |
adminClusterMembership |
Obligatorio. Es el clúster de administrador al que pertenece este clúster de usuario de Bare Metal. Es el nombre completo del recurso de la membresía de la flota del clúster de administrador. |
description |
Es una descripción legible por humanos de este clúster de usuario de Bare Metal. |
bareMetalVersion |
Obligatorio. La versión de clústeres de Anthos alojados en Bare Metal de tu clúster de usuario. |
uid |
Solo salida. Es el identificador único del clúster de usuario de Bare Metal. |
state |
Solo salida. Es el estado actual del clúster de usuario de Bare Metal. |
endpoint |
Solo salida. Es la dirección IP del servidor de API del clúster de usuario de metal desnudo. |
reconciling |
Solo salida. Si se configura, actualmente hay cambios en tránsito en el clúster de usuario de Bare Metal. |
createTime |
Solo salida. Es la fecha y hora en que se creó el clúster de usuario de Bare Metal. 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: |
updateTime |
Solo salida. Fecha y hora en la que se actualizó el clúster de usuario de Bare Metal 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: |
deleteTime |
Solo salida. Es la fecha y hora en la que se borró el clúster de usuario de Bare Metal. Si el recurso no se borra, debe estar vacío. 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: |
localName |
Solo salida. Nombre del objeto del recurso personalizado del clúster de usuario de equipos físicos en el clúster de administrador asociado. 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 nombre 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. Cuando el nombre local y el nombre del clúster difieren, 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 salida. 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. |
annotations |
Son las 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 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 |
networkConfig |
Obligatorio. Configuración de red |
controlPlane |
Obligatorio. Es la configuración del plano de control. |
loadBalancer |
Obligatorio. Es la configuración del balanceador de cargas. |
storage |
Obligatorio. Es la configuración de almacenamiento. |
proxy |
Es la configuración del proxy. |
clusterOperations |
Es la configuración de las operaciones del clúster. |
maintenanceConfig |
Es la configuración de mantenimiento. |
nodeConfig |
Es la configuración del nodo de carga de trabajo. |
fleet |
Solo salida. Es la configuración de la flota para el clúster. |
status |
Solo salida. Es el estado detallado del clúster. |
validationCheck |
Solo salida. Es el resultado de la verificación previa. |
securityConfig |
Es la configuración relacionada con la seguridad. |
maintenanceStatus |
Solo salida. Es el estado de las tareas de mantenimiento en curso. |
adminClusterName |
Solo salida. Es el nombre del recurso del clúster de administrador de equipos físicos que administra este clúster de usuario. |
nodeAccessConfig |
Son parámetros de configuración relacionados con el acceso a nodos. |
osEnvironmentConfig |
Son configuraciones relacionadas con el entorno del SO. |
binaryAuthorization |
Es la configuración relacionada con la Autorización Binaria. |
upgradePolicy |
Es la política de actualización del clúster. |
localNamespace |
Solo salida. Es el espacio de nombres del clúster. |
Estado
Es el estado del ciclo de vida del clúster de usuario de Bare Metal.
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. |
BareMetalNetworkConfig
Especifica la configuración de red del clúster.
Representación JSON |
---|
{ "advancedNetworking": boolean, "multipleNetworkInterfacesConfig": { object ( |
Campos | |
---|---|
advancedNetworking |
Permite el uso de funciones avanzadas de redes de Anthos, como el balanceo de cargas en paquetes con BGP o la puerta de enlace NAT de salida. Establecer la configuración de las funciones de redes avanzadas establecerá automáticamente esta marca. |
multipleNetworkInterfacesConfig |
Es la configuración para varias interfaces de red. |
srIovConfig |
Es la configuración de SR-IOV. |
Campo de unión cluster_cidr_configuration . Es la configuración de CIDR que se usará en el clúster de usuario de Bare Metal. cluster_cidr_configuration puede ser solo uno de los siguientes: |
|
islandModeCidr |
Es la configuración del CIDR del modo isla. En una red de modo isla, los nodos tienen direcciones IP únicas, pero los Pods no tienen direcciones únicas en todos los clústeres. Esto no genera problemas porque los Pods de un clúster nunca se comunican directamente con los Pods de otro clúster. En su lugar, hay puertas de enlace que median entre un Pod en un clúster y un Pod en otro clúster. |
BareMetalIslandModeCidrConfig
Especifica la configuración del CIDR del clúster cuando se ejecuta en modo isla.
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 rangos. Este campo puede mutar después de la creación a partir de la versión 1.15. |
podAddressCidrBlocks[] |
Obligatorio. A todos los pods del clúster se les asigna una dirección IPv4 RFC1918 de estos rangos. No se puede cambiar este campo después de crearlo. |
BareMetalMultipleNetworkInterfacesConfig
Especifica la configuración del clúster de varias interfaces de redes.
Representación JSON |
---|
{ "enabled": boolean } |
Campos | |
---|---|
enabled |
Indica si se habilitarán varias interfaces de red para tus Pods. Cuando se configura networkConfig.advanced_networking, se establece automáticamente en verdadero. |
BareMetalSrIovConfig
Especifica la configuración del operador de redes de SR-IOV.
Representación JSON |
---|
{ "enabled": boolean } |
Campos | |
---|---|
enabled |
Indica si se debe instalar el operador de 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 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. Es la configuración genérica para 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 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. 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. Es el valor del argumento tal como se pasará a la línea de comandos del servidor de la API. |
BareMetalLoadBalancerConfig
Especifica la configuración del balanceador de cargas.
Representación JSON |
---|
{ "vipConfig": { object ( |
Campos | |
---|---|
vipConfig |
Son las VIP que usa el balanceador de cargas. |
portConfig |
Configura los puertos en los que escuchará el balanceador de cargas. |
Campo de unión load_balancer_configuration . Es la configuración del balanceador de cargas para el clúster de usuario de Metal desnudo. load_balancer_configuration puede ser solo uno de los siguientes: |
|
metalLbConfig |
Es la configuración de los balanceadores de cargas de MetalLB. |
manualLbConfig |
Balanceadores de cargas configurados de forma manual |
bgpLbConfig |
Es la configuración para los balanceadores de cargas con tipo de BGP. Cuando se configura networkConfig.advanced_networking, se establece automáticamente en verdadero. |
BareMetalVipConfig
Especifica la configuración de la VIP para el balanceador de cargas de Metal desnudo.
Representación JSON |
---|
{ "controlPlaneVip": string, "ingressVip": string } |
Campos | |
---|---|
controlPlaneVip |
Es la VIP que reservaste anteriormente para la API de Kubernetes de este clúster de usuario de metal desnudo. |
ingressVip |
Es la VIP que reservaste anteriormente para el tráfico de entrada en este clúster de usuario de equipo físico. |
BareMetalPortConfig
Especifica los puertos del balanceador de cargas para el clúster de usuario de metal desnudo.
Representación JSON |
---|
{ "controlPlaneLoadBalancerPort": integer } |
Campos | |
---|---|
controlPlaneLoadBalancerPort |
Es el puerto en el que escucharán los balanceadores de cargas alojados en el plano de control. |
BareMetalMetalLbConfig
Representa los parámetros de configuración de un balanceador de cargas de MetalLB.
Representación JSON |
---|
{ "addressPools": [ { object ( |
Campos | |
---|---|
addressPools[] |
Obligatorio. AddressPools es una lista de grupos de IP que no se superponen y que usan los servicios con tipo de balanceador de cargas. Todas las direcciones deben poder enrutarse a los nodos del balanceador de cargas. La VIP de Ingress debe incluirse en los grupos. |
loadBalancerNodePoolConfig |
Especifica el grupo de nodos que ejecuta el balanceador de cargas. Se requiere conectividad de capa 2 entre los nodos de este grupo. Si falta, se usa el grupo de nodos del plano de control como grupo de balanceador de cargas. |
BareMetalLoadBalancerAddressPool
Representa un grupo de IPs que usa el balanceador de cargas.
Representación JSON |
---|
{ "pool": string, "addresses": [ string ], "avoidBuggyIps": boolean, "manualAssign": boolean } |
Campos | |
---|---|
pool |
Obligatorio. Es el nombre del grupo de direcciones. |
addresses[] |
Obligatorio. Son 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 rango (1.2.3.1-1.2.3.5). |
avoidBuggyIps |
Si es verdadero, evita usar IPs que terminen en .0 o .255. Esto evita que los dispositivos consumidores con errores descarten por error el tráfico IPv4 para esas direcciones IP especiales. |
manualAssign |
Si es verdadero, evita que se asignen direcciones IP automáticamente. |
BareMetalLoadBalancerNodePoolConfig
Especifica la configuración del grupo de nodos del balanceador de cargas.
Representación JSON |
---|
{
"nodePoolConfig": {
object ( |
Campos | |
---|---|
nodePoolConfig |
Es la configuración genérica para un grupo de nodos que ejecuta un balanceador de cargas. |
BareMetalManualLbConfig
Representa los parámetros de configuración de un balanceador de cargas manual.
Representación JSON |
---|
{ "enabled": boolean } |
Campos | |
---|---|
enabled |
Indica si el balanceo de cargas manual está habilitado. |
BareMetalBgpLbConfig
BareMetalBgpLbConfig representa los parámetros de configuración de un balanceador de cargas del Protocolo de puerta de enlace 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. Es la lista de pares de BGP a los que se conectará el clúster. Se debe configurar al menos un intercambio de tráfico para cada nodo del plano de control. Los nodos del plano de control se conectarán a estos pares para anunciar la VIP del plano de control. El balanceador de cargas de Services también usa estos pares de forma predeterminada. Este campo se puede actualizar después de crear el clúster. |
addressPools[] |
Obligatorio. AddressPools es una lista de grupos de IP que no se superponen y que usan los servicios con tipo de balanceador de cargas. Todas las direcciones deben poder enrutarse a los nodos del balanceador de cargas. La VIP de Ingress debe incluirse en los grupos. |
loadBalancerNodePoolConfig |
Especifica el grupo de nodos que ejecuta el balanceo de cargas del plano de datos. Se requiere conectividad de capa 2 entre los nodos de este grupo. Si falta, se usa el grupo de nodos del plano de control para el balanceo de cargas del plano de datos. |
BareMetalBgpPeerConfig
BareMetalBgpPeerConfig representa los parámetros de configuración de un par del Protocolo de puerta de enlace fronteriza (BGP).
Representación JSON |
---|
{ "asn": string, "ipAddress": string, "controlPlaneNodes": [ string ] } |
Campos | |
---|---|
asn |
Obligatorio. Número del sistema autónomo (ASN) del BGP para la red que contiene el dispositivo de intercambio de tráfico externo. |
ipAddress |
Obligatorio. Es la dirección IP del dispositivo de par externo. |
controlPlaneNodes[] |
Es la dirección IP del nodo del plano de control que se conecta al par externo. Si no especificas ningún nodo del plano de control, todos los nodos del plano de control pueden conectarse al par externo. Si especificas una o más direcciones IP, solo los nodos especificados participan en las sesiones de intercambio de tráfico. |
BareMetalStorageConfig
BareMetalStorageConfig especifica la configuración de almacenamiento del clúster.
Representación JSON |
---|
{ "lvpShareConfig": { object ( |
Campos | |
---|---|
lvpShareConfig |
Obligatorio. Especifica la configuración de PersistentVolumes locales respaldados por subdirectorios en un sistema de archivos compartidos. Estos subdirectorios se crean automáticamente durante la creación del clúster. |
lvpNodeMountsConfig |
Obligatorio. Especifica la configuración de PersistentVolumes locales respaldados por discos de nodos activados. El usuario debe formatear y activar estos discos, lo que se puede hacer antes o después de la creación del clúster. |
BareMetalProxyConfig
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: No proporciones credenciales en el formato |
noProxy[] |
Es una 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 recopilación de registros o métricas de la aplicación (además de los registros o las métricas del sistema). |
BareMetalMaintenanceConfig
Especifica las configuraciones para poner los nodos de metal desnudo en mantenimiento y quitarlos de él.
Representación JSON |
---|
{ "maintenanceAddressCidrBlocks": [ string ] } |
Campos | |
---|---|
maintenanceAddressCidrBlocks[] |
Obligatorio. Todas las direcciones IPv4 de estos rangos se colocarán en modo de mantenimiento. Los nodos en modo de mantenimiento se acordonarán y desviarán. Cuando ambas condiciones son verdaderas, la anotación "baremetal.cluster.gke.io/maintenance" se establecerá en el recurso del nodo. |
BareMetalWorkloadNodeConfig
Especifica la configuración de los nodos de la carga de trabajo.
Representación JSON |
---|
{
"maxPodsPerNode": string,
"containerRuntime": enum ( |
Campos | |
---|---|
maxPodsPerNode |
Es la cantidad máxima de Pods que puede ejecutar un nodo. El tamaño del rango de CIDR asignado al nodo se derivará de este parámetro. |
containerRuntime |
Especifica qué entorno de ejecución del contenedor se usará. |
ContainerRuntime
Es el entorno de ejecución que se usa para ejecutar contenedores en este clúster de usuarios.
Enums | |
---|---|
CONTAINER_RUNTIME_UNSPECIFIED |
No se seleccionó ningún tiempo de ejecución del contenedor. |
CONTAINERD |
Es el 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 del usuario al clúster de usuario. |
BareMetalMaintenanceStatus
Representa el estado de mantenimiento del clúster de usuario de Bare Metal.
Representación JSON |
---|
{
"machineDrainStatus": {
object ( |
Campos | |
---|---|
machineDrainStatus |
Es el estado de mantenimiento de las máquinas de nodos. |
BareMetalMachineDrainStatus
Representa el estado de las máquinas de nodos que se someten a operaciones de vaciado.
Representación JSON |
---|
{ "drainingMachines": [ { object ( |
Campos | |
---|---|
drainingMachines[] |
Es la lista de máquinas de drenaje. |
drainedMachines[] |
Es la lista de máquinas agotadas. |
BareMetalDrainingMachine
Representa una máquina que se está vaciando.
Representación JSON |
---|
{ "nodeIp": string, "podCount": integer } |
Campos | |
---|---|
nodeIp |
Es la dirección IP de la máquina de desvío. |
podCount |
Es el recuento de los pods que aún no se vaciaron. |
BareMetalDrainedMachine
Representa una máquina que se está vaciando.
Representación JSON |
---|
{ "nodeIp": string } |
Campos | |
---|---|
nodeIp |
Es la dirección IP de la máquina agotada. |
BareMetalNodeAccessConfig
Especifica la configuración relacionada con el acceso a los nodos del clúster de usuario de Bare Metal.
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 configura, el valor predeterminado es "root". |
BareMetalOsEnvironmentConfig
Especifica la configuración del sistema operativo para el aprovisionamiento del clúster.
Representación JSON |
---|
{ "packageRepoExcluded": boolean } |
Campos | |
---|---|
packageRepoExcluded |
Indica si no se debe incluir el repositorio de paquetes cuando se inicializan las máquinas físicas. |
BareMetalClusterUpgradePolicy
BareMetalClusterUpgradePolicy define la política de actualización del clúster.
Representación JSON |
---|
{
"policy": enum ( |
Campos | |
---|---|
policy |
Especifica qué política de actualización se debe usar. |
pause |
Solo salida. La pausa se usa para mostrar el estado de pausa de la actualización. Por el momento, solo se puede ver. |
NodePoolPolicy
Especifica la política de actualización para los grupos de nodo trabajador.
Enums | |
---|---|
NODE_POOL_POLICY_UNSPECIFIED |
No se seleccionó ninguna política de actualización. |
SERIAL |
Actualiza los grupos de nodo trabajador de forma secuencial. |
CONCURRENT |
Actualiza todos los grupos de nodo trabajador en paralelo. |
Métodos |
|
---|---|
|
Crea un clúster de metal desnudo nuevo en un proyecto y una ubicación determinados. |
|
Borra un solo clúster de Bare Metal. |
|
Inscribe un clúster de usuario existente alojado en equipos físicos y sus grupos de nodos en la API de Anthos On-Prem dentro de un proyecto y una ubicación determinados. |
|
Obtiene detalles de un solo clúster de Metal. |
|
Enumera los clústeres de metal desnudo en una ubicación y un proyecto 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 usuario de Bare Metal. |