- 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. |
admin |
Obligatorio. El clúster de administrador al que pertenece este clúster de usuario de Bare Metal Este es el nombre completo del recurso de la membresía de la flota del clúster de administrador. |
description |
Una descripción legible por humanos de este clúster de usuarios de Bare Metal. |
bare |
Obligatorio. La versión de los 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 usuarios de Bare Metal. |
state |
Solo salida. El estado actual del clúster de usuario de Bare Metal. |
endpoint |
Solo salida. La dirección IP del servidor de API del clúster de usuario de Bare Metal |
reconciling |
Solo salida. Si se configura, actualmente hay cambios en tránsito en el clúster de usuario de Bare Metal. |
create |
Solo salida. Es la hora en la que se creó el clúster de usuario de Bare Metal. 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: |
update |
Solo salida. La hora en la que se actualizó el clúster de usuarios de Bare Metal 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: |
delete |
Solo salida. Es la hora en la que se borró el clúster de usuarios de Bare Metal. Si el recurso no se borra, debe estar vacío. 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: |
local |
Solo salida. Es el nombre del objeto del recurso personalizado del clúster de usuario de Bare Metal 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 use como parte de la inscripción del clúster, este campo diferirá del 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. Cuando el nombre local y el nombre del clúster difieren, se usa el nombre local 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 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. |
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 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 |
network |
Obligatorio. Configuración de red |
control |
Obligatorio. Configuración del plano de control |
load |
Obligatorio. Configuración del balanceador de cargas |
storage |
Obligatorio. Configuración de almacenamiento. |
proxy |
Configuración de proxy. |
cluster |
Configuración de las operaciones del clúster |
maintenance |
Configuración de mantenimiento. |
node |
Configuración del nodo de la carga de trabajo |
fleet |
Solo salida. Configuración de la flota para el clúster. |
status |
Solo salida. Estado detallado del clúster |
validation |
Solo salida. Es el resultado de la verificación previa. |
security |
Configuración relacionada con la seguridad. |
maintenance |
Solo salida. Estado de las tareas de mantenimiento en curso. |
admin |
Solo salida. Es el nombre del recurso del clúster de administrador de Bare Metal que administra este clúster de usuario. |
node |
Parámetros de configuración relacionados con el acceso a nodos |
os |
Parámetros de configuración relacionados con el entorno del SO. |
binary |
Parámetros de configuración relacionados con la autorización binaria |
upgrade |
La política de actualización del clúster |
Estado
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. 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. |
BareMetalNetworkConfig
Especifica la configuración de red del clúster.
Representación JSON |
---|
{ "advancedNetworking": boolean, "multipleNetworkInterfacesConfig": { object ( |
Campos | |
---|---|
advanced |
Habilita 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. La configuración de las funciones avanzadas de red establecerá automáticamente esta marca. |
multiple |
Configuración para varias interfaces de red |
sr |
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 usuarios de Bare Metal. cluster_cidr_configuration puede ser solo uno de los siguientes: |
|
island |
Configuración del CIDR del modo de isla En una red de modo isla, los nodos tienen direcciones IP únicas, pero los Pods no tienen direcciones únicas entre 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 de CIDR del clúster mientras se ejecuta en modo isla.
Representación JSON |
---|
{ "serviceAddressCidrBlocks": [ string ], "podAddressCidrBlocks": [ string ] } |
Campos | |
---|---|
service |
Obligatorio. A todos los servicios del clúster se les asigna una dirección IPv4 RFC1918 de estos rangos. Este campo es mutable después de la creación a partir de la versión 1.15. |
pod |
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 red.
Representación JSON |
---|
{ "enabled": boolean } |
Campos | |
---|---|
enabled |
Si deseas habilitar varias interfaces de red para tus pods. Cuando se establece 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 |
Si se debe instalar el operador de SR-IOV. |
BareMetalControlPlaneConfig
Especifica la configuración del plano de control.
Representación JSON |
---|
{ "controlPlaneNodePoolConfig": { object ( |
Campos | |
---|---|
control |
Obligatorio. Configura el grupo de nodos que ejecuta el plano de control. |
api |
Personaliza los argumentos del servidor de la API predeterminados. 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 | |
---|---|
node |
Obligatorio. La configuración genérica para un grupo de nodos que ejecuta el plano de control. |
BareMetalApiServerArgument
Representa un par nombre->valor de arg. 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. 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. 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 | |
---|---|
vip |
Las VIP que usa el balanceador de cargas |
port |
Configura los puertos en los que el balanceador de cargas escuchará. |
Campo de unión load_balancer_configuration . La configuración del balanceador de cargas para el clúster de usuario de bare metal load_balancer_configuration puede ser solo uno de los siguientes: |
|
metal |
Configuración para balanceadores de cargas de MetalLB. |
manual |
Balanceadores de cargas configurados de forma manual |
bgp |
Configuración para balanceadores de cargas de tipo BGP. Cuando se establece networkConfig.advanced_networking, se establece automáticamente en verdadero. |
BareMetalVipConfig
Especifica la configuración de VIP para el balanceador de cargas de Bare Metal.
Representación JSON |
---|
{ "controlPlaneVip": string, "ingressVip": string } |
Campos | |
---|---|
control |
La VIP que reservaste anteriormente para la API de Kubernetes de este clúster de usuarios de bare metal |
ingress |
La VIP que reservaste anteriormente para el tráfico de entrada a este clúster de usuario de Bare Metal |
BareMetalPortConfig
Especifica los puertos del balanceador de cargas para el clúster de usuario de Bare Metal.
Representación JSON |
---|
{ "controlPlaneLoadBalancerPort": integer } |
Campos | |
---|---|
control |
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 MetalLB.
Representación JSON |
---|
{ "addressPools": [ { object ( |
Campos | |
---|---|
address |
Obligatorio. AddressPools es una lista de grupos de IP no superpuestos que usan los servicios de tipo de balanceador de cargas. Todas las direcciones deben poder enrutarse a los nodos del balanceador de cargas. Se debe incluir IngressVIP en los grupos. |
load |
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, el grupo de nodos del plano de control se usa como el grupo de balanceador de cargas. |
BareMetalLoadBalancerAddressPool
Representa un grupo de IP 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. Las direcciones que forman parte de este grupo. Cada dirección debe estar en formato CIDR (1.2.3.0/24) o de rango (1.2.3.1-1.2.3.5). |
avoid |
Si es verdadero, evita usar IPs que terminen en .0 o .255. Esto evita que los dispositivos de consumo con errores descarten por error el tráfico IPv4 para esas direcciones IP especiales. |
manual |
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 | |
---|---|
node |
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 de protocolo de puerta de enlace de frontera (BGP).
Representación JSON |
---|
{ "asn": string, "bgpPeerConfigs": [ { object ( |
Campos | |
---|---|
asn |
Obligatorio. Es el número de sistema autónomo (ASN) de BGP del clúster. Este campo se puede actualizar después de crear el clúster. |
bgp |
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 los servicios también usa estos pares de forma predeterminada. Este campo se puede actualizar después de crear el clúster. |
address |
Obligatorio. AddressPools es una lista de grupos de IP no superpuestos que usan los servicios de tipo de balanceador de cargas. Todas las direcciones deben poder enrutarse a los nodos del balanceador de cargas. Se debe incluir IngressVIP en los grupos. |
load |
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 de protocolo de puerta de enlace de frontera (BGP).
Representación JSON |
---|
{ "asn": string, "ipAddress": string, "controlPlaneNodes": [ string ] } |
Campos | |
---|---|
asn |
Obligatorio. Número del sistema autónomo (ASN) de BGP para la red que contiene el dispositivo de intercambio de tráfico externo. |
ip |
Obligatorio. Es la dirección IP del dispositivo externo del par. |
control |
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 | |
---|---|
lvp |
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. |
lvp |
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 |
no |
Es una lista de IP, 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 | |
---|---|
enable |
Si se debe habilitar la recopilación de registros o métricas de la aplicación (además de los registros o métricas del sistema) |
BareMetalMaintenanceConfig
Especifica las configuraciones para poner nodos Bare Metal en mantenimiento y sacarlos de él.
Representación JSON |
---|
{ "maintenanceAddressCidrBlocks": [ string ] } |
Campos | |
---|---|
maintenance |
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 se desviarán. Cuando se cumplan ambas condiciones, se establecerá la anotación "baremetal.cluster.gke.io/maintenance" en el recurso del nodo. |
BareMetalWorkloadNodeConfig
Especifica las configuraciones de los nodos de la carga de trabajo.
Representación JSON |
---|
{
"maxPodsPerNode": string,
"containerRuntime": enum ( |
Campos | |
---|---|
max |
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. |
container |
Especifica qué entorno de ejecución de 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 entorno 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 Bare Metal.
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 usuario de Bare Metal.
Representación JSON |
---|
{
"machineDrainStatus": {
object ( |
Campos | |
---|---|
machine |
Es el estado de mantenimiento de las máquinas de nodos. |
BareMetalMachineDrainStatus
Representa el estado de las máquinas de nodos que están realizando operaciones de drenaje.
Representación JSON |
---|
{ "drainingMachines": [ { object ( |
Campos | |
---|---|
draining |
La lista de máquinas de drenaje. |
drained |
La lista de máquinas drenadas |
BareMetalDrainingMachine
Representa una máquina que se está agotando.
Representación JSON |
---|
{ "nodeIp": string, "podCount": integer } |
Campos | |
---|---|
node |
Dirección IP de la máquina de drenaje. |
pod |
Es el recuento de pods que aún no se agotan. |
BareMetalDrainedMachine
Representa una máquina que se está agotando.
Representación JSON |
---|
{ "nodeIp": string } |
Campos | |
---|---|
node |
Dirección IP de la máquina agotada. |
BareMetalNodeAccessConfig
Especifica la configuración relacionada con el acceso a los nodos para el clúster de usuarios de Bare Metal.
Representación JSON |
---|
{ "loginUser": string } |
Campos | |
---|---|
login |
LoginUser es el nombre de usuario que se usa para acceder a las máquinas de nodos. Si no se establece, el valor predeterminado es "root". |
BareMetalOsEnvironmentConfig
Especifica la configuración del sistema operativo para el aprovisionamiento de clústeres.
Representación JSON |
---|
{ "packageRepoExcluded": boolean } |
Campos | |
---|---|
package |
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 usar. |
pause |
Solo salida. La pausa se usa para mostrar el estado de pausa de la actualización. Por ahora, solo es de solo lectura. |
NodePoolPolicy
Especifica la política de actualización para los grupos de nodos trabajadores.
Enums | |
---|---|
NODE_POOL_POLICY_UNSPECIFIED |
No se seleccionó ninguna política de actualización. |
SERIAL |
Actualiza los grupos de nodos trabajadores de forma secuencial. |
CONCURRENT |
Actualiza todos los grupos de nodos trabajadores en paralelo. |
Métodos |
|
---|---|
|
Crea un clúster de bare metal nuevo en un proyecto y una ubicación determinados. |
|
Borra un solo clúster de Bare Metal. |
|
Inscribe un clúster de usuario existente de bare metal 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 Bare Metal. |
|
Muestra una lista de clústeres de bare metal 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. |