Referencia del campo de configuración del clúster

anthosBareMetalVersion

Obligatorio. String. Es la versión del clúster. Este valor se establece para la creación y las actualizaciones de clústeres.

Mutabilidad: Este valor no se puede modificar en clústeres existentes. La versión solo se puede actualizar a través del proceso de actualización de clústeres.

authentication

Esta sección contiene la configuración necesaria para usar OpenID Connect (OIDC). OIDC te permite usar tu proveedor de identidad existente para administrar la autenticación de usuarios y grupos en los clústeres de Anthos alojados en clústeres físicos.

authentication.oidc.certificateAuthorityData

Opcional. Un certificado con codificación PEM codificada en base64 para el proveedor de OIDC. Para crear la string, codifica el certificado, incluidos los encabezados, en base64. Incluye la string resultante en certificateAuthorityData como una certificateAuthorityData sola línea.

Por ejemplo (muestra ajustada a la tabla):

certificateAuthorityData:
        LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tC
        ...k1JSUN2RENDQWFT==

authentication.oidc.clientID

Opcional. String. Es el ID de la aplicación cliente que realiza solicitudes de autenticación al proveedor de OpenID.

authentication.oidc.clientSecret

Opcional. String. Un secreto compartido entre la aplicación cliente de OIDC y el proveedor de OIDC.

authentication.oidc.deployCloudConsoleProxy

Opcional. Booleano (true|false). Especifica si se implementa un proxy inverso en el clúster para conectar la consola de Google Cloud a un proveedor de identidad local que no es de acceso público a través de Internet. Si no se puede acceder al proveedor de identidad a través de la Internet pública, establece este campo en true para autenticarte con la consola de Google Cloud. De forma predeterminada, este número se establece en false.

authentication.oidc.extraParams

Opcional. Lista delimitada por comas. Los parámetros de clave-valor adicionales para enviar al proveedor de OpenID.

authentication.oidc.groupPrefix

Opcional. String. El prefijo que se antepone a las reclamaciones de grupos para evitar conflictos con los nombres existentes. Por ejemplo, con un grupo dev y un prefijo oidc:, el valor es oidc:dev.

authentication.oidc.group

Opcional. String. La reclamación de JWT que el proveedor usa para mostrar los grupos de seguridad.

authentication.oidc.issuerURL

Opcional. String de URL. La URL a la que se envían las solicitudes de autorización al OpenID, como https://example.com/adfs. El servidor de la API de Kubernetes usa esta URL a fin de descubrir claves públicas para la verificación de tokens. La URL debe usar HTTPS.

authentication.oidc.kubectlRedirectURL

Opcional. String de URL. La URL de redireccionamiento que usa kubectl para la autorización. Cuando habilitas OIDC, debes especificar un valor de kubectlRedirectURL.

authentication.oidc.proxy

Opcional. String de URL. Servidor proxy que se usará para que el clúster se conecte a tu proveedor de OIDC, si corresponde. El valor debe incluir un nombre de host y una dirección IP, y de forma opcional un puerto, un nombre de usuario y una contraseña. Por ejemplo: http://user:password@10.10.10.10:8888.

authentication.oidc.scopes

Opcional. Lista delimitada por comas. Los permisos adicionales que se deben enviar al proveedor de OpenID. Microsoft Azure y Okta requieren el permiso offline_access.

authentication.oidc.usernamePrefix

Opcional. String. Es el prefijo que se antepone a las reclamaciones de nombre de usuario.

authentication.oidc.username

Opcional. String. Es la reclamación de JWT que se debe usar como nombre de usuario. Si no se especifica, el valor predeterminado es sub.

bypassPreflightCheck

Opcional. Booleano (true|false). Cuando se establece en true, las comprobaciones preliminares internas se ignoran cuando se aplican recursos a los clústeres existentes. La configuración predeterminada es false.

Mutabilidad: Este valor se puede modificar para clústeres existentes con el comando bmctl update.

clusterNetwork

Esta sección contiene la configuración de red para tu clúster.

clusterNetwork.advancedNetworking

Booleano. Configura este campo como true para habilitar las funciones de redes avanzadas, como el balanceo de cargas en paquetes con BGP o la puerta de enlace NAT de salida. Ambas funciones usan Anthos Network Gateway. Anthos Network Gateway es el componente clave para habilitar las funciones avanzadas de redes en Anthos y Google Kubernetes Engine (GKE). Uno de los principales beneficios de Anthos Network Gateway es que puede asignar direcciones IP flotantes de forma dinámica a partir de un conjunto de direcciones que especifiques en un recurso personalizado “NetworkGatewayGroup”.

Para obtener más información sobre Anthos Network Gateway y las funciones avanzadas de redes relacionadas, consulta Configura una puerta de enlace NAT de salida y Configura balanceadores de cargas en paquetes con BGP.

clusterNetwork.flatIPv4

Booleano. Establece este campo en true para habilitar el modelo de redes del clúster de modo plano. En el modo plano, cada Pod tiene su propia dirección IP única. Los Pods pueden comunicarse entre sí directamente sin necesidad de una puerta de enlace intermedia ni traducción de direcciones de red (NAT). flatIPv4 es false de forma predeterminada. Puedes habilitar el modo plano solo durante la creación del clúster. Una vez que habilites el modo plano para el clúster, no podrás inhabilitarlo. Durante la creación del clúster, los CIDR de Pods especificados en la configuración de tus clústeres se convierten en un recurso personalizado predeterminado “ClusterCIDRConfig” y se usan como CIDR de Pod de todo el clúster.

clusterNetwork.multipleNetworkInterfaces

Opcional. Booleano. Establece este campo en true a fin de habilitar varias interfaces de red para los Pods.

Para obtener más información sobre cómo configurar y usar varias interfaces de red, consulta la versión preliminar de la documentación Configura interfaces de red múltiples para Pods.

clusterNetwork.pods.cidrBlocks

Obligatorio. Rango de direcciones IPv4 en formato de bloque CIDR. Los Pods especifican los rangos de IP desde los que se asignan las redes de pods.

Por ejemplo:

pods:
  cidrBlocks:
  - 192.168.0.0/16

clusterNetwork.services.cidrBlocks

Obligatorio. Rango de direcciones IPv4 en formato de bloque CIDR. Especifica el rango de direcciones IP desde las que se asignan las direcciones IP virtuales de servicio (VIP). Estos rangos no debe superponerse con ninguna subred accesible desde tu red. Si deseas obtener más información sobre la asignación de direcciones para Internet privada, consulta RFC 1918.

Por ejemplo:

services:
  cidrBlocks:
  - 10.96.0.0/12

clusterOperations

En esta sección, se incluye información de Cloud Logging y Cloud Monitoring.

clusterOperations.enableApplication

Booleano. Configúralo como true para recopilar registros o métricas de la aplicación, además de la recopilación predeterminada de registros o métricas del sistema, que corresponden a los componentes del sistema, como el plano de control de Kubernetes o los agentes de administración de clústeres. Puedes cambiar este valor en cualquier momento.

clusterOperations.disableCloudAuditLogging

Booleano. Los Registros de auditoría de Cloud son útiles para investigar solicitudes sospechosas a la API y recopilar estadísticas. Los Registros de auditoría de Cloud están habilitados (disableCloudAuditLogging: false) de forma predeterminada. Configúralo como true para inhabilitar los Registros de auditoría de Cloud.

Para obtener más información, consulta Usa Registros de auditorías.

clusterOperations.location

String. Es una región de Google Cloud en la que deseas almacenar los registros de Logging y las métricas de Monitoring. Es recomendable elegir una región cercana al centro de datos local. Para obtener más información, consulta Ubicaciones globales.

Por ejemplo:

location: us-central1

clusterOperations.projectID

String. Es el ID del proyecto de Google Cloud en el que deseas ver los registros y las métricas.

controlPlane

En esta sección, se incluye información sobre el plano de control y sus componentes.

controlPlane.nodePoolSpec

En esta sección, se especifican las direcciones IP para el grupo de nodos que usa el plano de control y sus componentes. La especificación del grupo de nodos del plano de control (como la especificación del grupo de nodos del balanceador de cargas) es especial. Esta especificación declara y controla los recursos críticos del clúster. La fuente canónica de este recurso es esta sección en el archivo de configuración del clúster. No modifiques directamente los recursos del grupo de nodos del plano de control de nivel superior. En su lugar, modifica las secciones asociadas en el archivo de configuración del clúster.

controlPlane.nodePoolSpec.nodes

Obligatorio. Un array de direcciones IP. Por lo general, este array es una dirección IP para una sola máquina o direcciones IP para tres máquinas para una implementación de alta disponibilidad (HA).

Por ejemplo:

controlPlane:
  nodePoolSpec:
    nodes:
    - address: 192.168.1.212
    - address: 192.168.1.213
    - address: 192.168.1.214
        

Este campo se puede cambiar cada vez que actualizas un clúster.

gkeConnect

En esta sección, se incluye información sobre el proyecto de Google Cloud que deseas usar para conectar tu clúster a Google Cloud.

gkeConnect.projectID

Obligatorio, string Es el ID del proyecto de Google Cloud que deseas usar para conectar el clúster a Google Cloud.

Por ejemplo:

spec:
  ...
  gkeConnect:
    projectID: "my-connect-project-123"

No se puede modificar este valor para los clústeres existentes.

kubevirt.useEmulation

Booleano. Determina si se usa la emulación de software para ejecutar máquinas virtuales. Si el nodo admite la virtualización de hardware, establece useEmulation en false para obtener un mejor rendimiento. Si la virtualización de hardware no es compatible o no estás seguro, configúrala en true.

loadBalancer

Esta sección contiene la configuración del balanceo de cargas del clúster.

loadBalancer.addressPools

Objeto. Es el nombre y un array de direcciones IP para el grupo de balanceadores de cargas del clúster. La configuración del grupo de direcciones solo es válida para el modo de LB bundled en los clústeres que no sean de administrador. Puedes agregar grupos de direcciones nuevos en cualquier momento, pero no puedes modificar ni quitar grupos de direcciones existentes.

loadBalancer.addressPools.addresses

Array de rangos de direcciones IP. Especifica una lista de rangos de IP no superpuestos para el balanceador de cargas del plano de datos. Todas las direcciones deben estar en la misma subred que los nodos del balanceador de cargas.

Por ejemplo:

addressPools:
- name: pool1
  addresses:
  - 192.168.1.0-192.168.1.4
  - 192.168.1.240/28
  

loadBalancer.addressPools.name

String. Es el nombre que elijas para el grupo de balanceadores de cargas del clúster.

loadBalancer.addressPools.avoidBuggyIPs

Opcional. Booleano (true | false). Si es true, el grupo omite las direcciones IP que terminan en .0 y .255. Algunos hardware de red descartan el tráfico hacia estas direcciones especiales. Puedes omitir este campo, su valor predeterminado es false.

loadBalancer.addressPools.manualAssign

Opcional. Booleano (true | false). Si es true, las direcciones de este grupo no se asignan de forma automática a los servicios de Kubernetes. Si es true, una dirección IP en este grupo se usa solo cuando un servicio lo especifica de manera explícita. Puedes omitir este campo, su valor predeterminado es false.

loadBalancer.mode

Obligatorio. String. Especifica el modo de balanceo de cargas. En el modo bundled, los clústeres de Anthos en el equipo físico instalan un balanceador de cargas en los nodos del balanceador de cargas durante la creación. En el modo manual, el clúster se basa en un balanceador de cargas externo configurado de forma manual. Para obtener más información, consulta Descripción general de los balanceadores de cargas.

Valores permitidos: bundled | manual

loadBalancer.type

Opcional. String. Especifica el tipo de balanceo de cargas en paquetes que se usa, capa 2 o protocolo de puerta de enlace fronteriza (BGP). Si usas el balanceo de cargas estándar en paquetes, configura type en layer2. Si usas el balanceo de cargas en paquetes con BGP, configura type en bgp. Si no configuras type, el valor predeterminado es layer2.

Valores permitidos: layer2 | bgp

loadBalancer.nodePoolSpec

Opcional. Usa esta sección para configurar un grupo de nodos del balanceador de cargas. Los nodos que especificas son parte del clúster de Kubernetes y ejecutan cargas de trabajo y balanceadores de cargas normales. Si no especificas un grupo de nodos, los nodos del plano de control se usan para el balanceo de cargas. En esta sección, solo se aplica cuando el modo de balanceo de cargas se establece en bundled.

loadBalancer.nodePoolSpec.nodes

En esta sección, se muestra un array de direcciones IP para los nodos de tu grupo de nodos del balanceador de cargas.

loadBalancer.nodePoolSpec.nodes.address

Opcional. String (dirección IPv4). Es la dirección IP de un nodo.

loadBalancer.ports.controlPlaneLBPort

Number. Es el puerto de destino que se usa para el tráfico enviado al plano de control de Kubernetes (los servidores de la API de Kubernetes).

loadBalancer.vips.controlPlaneVIP

Obligatorio. Especifica la dirección IP virtual (VIP) que se conectará al servidor de la API de Kubernetes. Esta dirección no debe estar dentro del rango de ninguna dirección IP que se usa para los grupos de direcciones del balanceador de cargas, loadBalancer.addressPools.addresses.

loadBalancer.vips.ingressVIP

Opcional. String (dirección IPv4). Es la dirección IP que elegiste configurar en el balanceador de cargas para el tráfico de entrada.

loadBalancer.localASN (vista previa)

Opcional. String. Especifica el número del sistema autónomo (ASN) para el clúster que se crea. Este campo se usa cuando se configura la solución de balanceo de cargas en paquetes que usa el protocolo de puerta de enlace fronteriza (BGP). Para obtener más información, consulta Configura balanceadores de cargas en paquetes con BGP.

loadBalancer.bgpPeers (vista previa)

Opcional. Objeto (lista de asignaciones). En esta sección, se especifica uno o más pares de protocolos de puerta de enlace fronteriza (BGP) de tu red local (externa al clúster). Debes especificar los pares de BGP cuando configuras la parte de balanceo de cargas del plano de control de la solución de balanceo de cargas en paquetes que usan BGP. Cada par se especifica con una asignación, que consta de una dirección IP, un número de sistema autónomo (ASN) y, de forma opcional, una lista de una o más direcciones IP para los nodos del plano de control. La configuración de intercambio de tráfico de BGP para el balanceo de cargas del plano de control no se puede actualizar después de crear el clúster.

Por ejemplo:

loadBalancer:
  mode: bundled
  type: bgp
  localASN: 65001
  bgpPeers:
  - ip: 10.0.1.254
    asn: 65002
    controlPlaneNodes:
      - 10.0.1.10
      - 10.0.1.11
  - ip: 10.0.2.254
    asn: 65002
    controlPlaneNodes:
      - 10.0.2.10
  

Para obtener más información, consulta Configura balanceadores de cargas en paquetes con BGP.

loadBalancer.bgpPeers.ip (vista previa)

Opcional. String (dirección IPv4). La dirección IP de un dispositivo de intercambio de tráfico externo de tu red local. Para obtener más información, consulta Configura balanceadores de cargas en paquetes con BGP.

loadBalancer.bgpPeers.asn (vista previa)

Opcional. String. El número del sistema autónomo (ANS) para la red que contiene el dispositivo de intercambio de tráfico externo. Especifica un ASN para cada par de BGP que configures en el balanceo de cargas del plano de control cuando configures la solución de balanceo de cargas en paquetes que usa BGP. Para obtener más información, consulta Configura balanceadores de cargas en paquetes con BGP.

loadBalancer.bgpPeers.controlPlaneNodes (vista previa)

Opcional. Array de direcciones IP (IPv4). Una o más direcciones IP para los nodos del plano de control que se conectan al par de BGP externo cuando configuras la solución de balanceo de cargas en paquetes que usa BGP. Si no especificas ningún nodo del plano de control, todos los nodos del plano de control se conectarán al par externo. Si especificas una o más direcciones IP, solo los nodos especificados participan en las sesiones de intercambio de tráfico. Para obtener más información, consulta Configura balanceadores de cargas en paquetes con BGP.

maintenanceBlocks.cidrBlocks

Opcional. Una sola dirección IPv4 o un rango de direcciones IPv4. Especifica las direcciones IP de las máquinas del nodo que deseas poner en modo de mantenimiento. Para obtener más información, consulta Coloca los nodos en modo de mantenimiento.

Por ejemplo:

  maintenanceBlocks:
    cidrBlocks:
    - 192.168.1.200  # Single machine
    - 192.168.1.100-192.168.1.109  # Ten machines
  

nodeAccess.loginUser

Opcional. String. Especifica el nombre de usuario no raíz que deseas usar tener acceso con la función SUDO sin contraseña a las máquinas de nodo en tu clúster. Tu clave SSH, sshPrivateKeyPath, debe funcionar para el usuario especificado. Las operaciones de creación y actualización de clústeres verifican que se pueda acceder a las máquinas de nodo con el usuario y la clave SSH especificados.

osEnvironmentConfig.addPackageRepo

Opcional. Booleano (true|false). Especifica si se debe agregar un repositorio de paquetes cuando se inicializan las máquinas físicas.

nodeConfig.containerRuntime

Opcional. String. Especifica qué entorno de ejecución de contenedor, docker o containerd, se usará para programar contenedores en nodos. Si no especificas el entorno de ejecución del contenedor, la configuración predeterminada es docker. Si deseas obtener más información para configurar el entorno de ejecución del contenedor, consulta Cambia el entorno de ejecución del contenedor.

Valores permitidos: containerd | docker

nodeConfig.podDensity

En esta sección, se especifica la configuración de densidad del Pod.

nodeConfig.podDensity.maxPodsPerNode

Opcional. String. Especifica la cantidad máxima de Pods que pueden ejecutarse en un solo nodo. En el caso de los clústeres autoadministrados, los valores permitidos para maxPodsPerNode son de 32 a 250 para los clústeres con alta disponibilidad (HA) y de 64 a 250 para clústeres sin alta disponibilidad. Para los clústeres de usuario, los valores permitidos para maxPodsPerNode son de 32 a 250. Si no se especifica, el valor predeterminado es 110. Una vez que se crea el clúster, este valor no se puede actualizar.

Kubernetes asigna un bloque de enrutamiento entre dominios sin clases (CIDR) a cada nodo para que cada Pod pueda tener una dirección IP única. El tamaño del bloque CIDR corresponde al número máximo de Pods por nodo. Para obtener más información sobre la configuración de la cantidad máxima de Pods por nodo, consulta Herramientas de redes de Pods.

profile

Opcional. String. Cuando profile se establece en edge para un clúster independiente, minimiza el consumo de recursos del clúster. El perfil perimetral solo está disponible para clústeres independientes. El perfil perimetral tiene requisitos de recursos del sistema reducidos y se recomienda para los dispositivos perimetrales con limitaciones de recursos restrictivas. Si deseas conocer los requisitos de hardware asociados con el perfil perimetral, consulta Requisitos de recursos para clústeres independientes que usan el perfil perimetral.

proxy

Si la red está detrás de un servidor proxy, completa esta sección. De lo contrario, quita esta sección.

proxy.noProxy

String. Es una lista separada por comas de direcciones IP, rangos de direcciones IP, nombres de host y nombres de dominio que no deben pasar por el servidor proxy. Cuando los clústeres de Anthos alojados en equipos físicos envían una solicitud a una de estas direcciones, hosts o dominios, la solicitud se envía directamente.

proxy.url

String. La dirección HTTP del servidor proxy. Incluye el número de puerto incluso si es el mismo que el puerto predeterminado del esquema.

Por ejemplo:

proxy:
  url:   url: "http://my-proxy.example.local:80"
  noProxy: "10.151.222.0/24, my-host.example.local,10.151.2.1"
  

storage.lvpNodeMounts.path

Obligatorio. String. Usa el campo path para especificar la ruta de la máquina host en la que se pueden descubrir los discos activados. Se crea un PersistentVolume (PV) local para cada activación. La ruta predeterminada es /mnt/localpv-share. Si deseas obtener instrucciones para configurar activaciones de nodos, consulta Configura activaciones de nodos LVP.

storage.lvpNodeMounts

En esta sección, se especifica la configuración (ruta) para volúmenes persistentes locales respaldados por discos activados. Debes dar formato a estos discos y activarlos. Puedes realizar esta tarea antes o después de crear el clúster. Para obtener más información, consulta Activaciones de nodos LVP.

storage.lvpShare

En esta sección, se especifica la configuración para volúmenes persistentes locales respaldados por subdirectorios en un sistema de archivos compartidos. Estos subdirectorios se crean automáticamente durante la creación del clúster. Para obtener más información, consulta Uso compartido de LVP.

storage.lvpShare.path

Obligatorio. String. Usa el campo path para especificar la ruta de la máquina anfitrión en la que se pueden crear subdirectorios. Se crea un PersistentVolume (PV) local para cada subdirectorio. Si deseas obtener instrucciones para configurar tu recurso compartido de LVP, consulta Configura un recurso compartido de LVP.

storage.lvpShare.numPVUnderSharedPath

Obligatorio. String. Especifica la cantidad de subdirectorios que se crearán en lvpShare.path. El valor predeterminado es 5. Si deseas obtener instrucciones para configurar tu recurso compartido de LVP, consulta Configura un recurso compartido de LVP.

storage.lvpShare.storageClassName

Obligatorio. String. Especifica la StorageClass que se usará para crear volúmenes persistentes. StorageClass se crea durante la creación del clúster. El valor predeterminado es local-shared. Si deseas obtener instrucciones para configurar tu recurso compartido de LVP, consulta Cómo configurar un recurso compartido de LVP.

type

Obligatorio. String. Especifica el tipo de clúster. El modelo de implementación estándar consta de un único clúster de administrador y uno o más clústeres de usuarios, que se administran mediante el clúster de administrador. Los clústeres de Anthos alojados en equipos físicos admiten los siguientes tipos de clústeres:

• De administrador: un clúster que se usa para administrar clústeres de usuario.
• Usuario: un clúster que se usa para ejecutar cargas de trabajo.
• Híbrido: un clúster único para el administrador y las cargas de trabajo que también puede administrar clústeres de usuario.
• Independiente: un clúster único que puede administrarse a sí mismo y que también puede ejecutar cargas de trabajo, pero no puede crear ni administrar otros clústeres de usuarios.

El tipo de clúster se especifica en la creación del clúster y no se puede cambiar para actualizaciones. Si deseas obtener más información para crear un clúster, consulta Crea clústeres: descripción general.

Valores permitidos: admin | user | hybrid | standalone

No se puede modificar este valor para los clústeres existentes.

name

Obligatorio. String. Por lo general, el nombre del espacio de nombres usa un patrón de cluster-CLUSTER_NAME, pero el prefijo cluster- no es estrictamente obligatorio, ya que los clústeres de Anthos se alojan en la versión de equipo físico 1.7.2.

No se puede modificar este valor para los clústeres existentes.

clusterName

String. Obligatorio. El nombre del clúster en el que agregas el grupo de nodos. Crea el recurso del grupo de nodos en el mismo espacio de nombres que el clúster asociado y haz referencia al nombre del clúster en este campo. Para obtener más información, consulta Agrega y quita grupos de nodos en un clúster.

Por ejemplo:

apiVersion: baremetal.cluster.gke.io/v1
kind: NodePool
metadata:
  name: node-pool-new
  namespace: cluster-my-cluster
spec:
  clusterName: my-cluster
  nodes:
  - address:  10.200.0.10
  - address:  10.200.0.11
  - address:  10.200.0.12

nodes

Opcional. Array de direcciones IP (IPv4). Esto define el grupo de nodos de tus nodos trabajadores.

nodes.address

Opcional. String (dirección IPv4). Una o más direcciones IP para los nodos que conforman tu grupo de nodos trabajadores.

taints

Opcional. Objeto. Un taint de nodo te permite marcar un nodo a fin de que el programador evite o impida su uso para ciertos Pods. Un taint consiste en un par clave-valor y un efecto asociado. Los valores key y value son strings que usas para identificar el taint, y el valor effect especifica cómo se manejan los Pods para el nodo. El objeto taints puede tener varios taints.

El campo effect puede tener uno de los siguientes valores:

• NoSchedule: ningún Pod puede programar en el nodo, a menos que tenga una tolerancia coincidente.
• PreferNoSchedule: el sistema evita colocar un Pod que no tolera el taint en el nodo, pero no es obligatorio.
• NoExecute: los Pods que no toleran el taint se expulsan de inmediato y los que sí toleran el taint nunca se expulsan.

En los clústeres de Anthos en equipos físicos, los taints se concilian con los nodos del grupo de nodos, a menos que se aplique la anotación baremetal.cluster.gke.io/label-taint-no-sync al clúster. Para obtener más información sobre los taints, consulta Taints and Tolerancias.

Por ejemplo:

  taints:
  - key: status
    value: testpool
    effect: NoSchedule
  

labels

Opcional. Asignación (pares clave-valor). Las etiquetas se concilian con los nodos del grupo de nodos, a menos que la anotación baremetal.cluster.gke.io/label-taint-no-sync se aplique al clúster. Para obtener más información sobre las etiquetas, consulta Etiquetas de recurso y selectores.

registryMirrors

Opcional. En esta sección, especifica una duplicación del registro que se usará para instalar clústeres, en lugar de Container Registry (gcr.io). Para obtener más información sobre el uso de una duplicación de registro, consulta Instala clústeres de Anthos en equipos físicos con una duplicación de registro.

Por ejemplo:

registryMirrors:
  - endpoint: https://172.18.0.20:5000
    caCertPath: /root/ca.crt
    pullCredentialConfigPath: /root/.docker/config.json
    hosts:
      - somehost.io
      - otherhost.io
     

registryMirrors.endpoint

String. El extremo de la duplicación, que consiste en la dirección IP y el número de puerto del servidor de registro. De forma opcional, puedes usar tu propio espacio de nombres en tu servidor de registro en lugar del espacio de nombres raíz. Sin un espacio de nombres, el formato de extremo es REGISTRY_IP:PORT. Cuando usas un espacio de nombres, el formato del extremo es REGISTRY_IP:PORT/v2/NAMESPACE. /v2 es obligatorio cuando se especifica un espacio de nombres.

El campo endpoint es obligatorio cuando especificas una duplicación del registro. Puedes especificar varias duplicaciones o extremos.

Por ejemplo:

- endpoint: https://172.18.0.20:5000/v2/test-namespace

registryMirrors.caCertPath

Opcional. String. Ruta de acceso del archivo de certificado de CA si el servidor de registro usa un certificado TLS privado. Si tu registro local no requiere un certificado TLS privado, puedes omitir este campo.

registryMirrors.pullCredentialConfigPath

Opcional. String. Ruta de acceso al archivo de configuración de la CLI de Docker, config.json. Docker guarda la configuración de autenticación en el archivo de configuración. Este campo se aplica solo al uso de duplicaciones de registro. Si tu servidor de registro no requiere un archivo de configuración de Docker para la autenticación, puedes omitir este campo.

Por ejemplo:

registryMirrors:
  - endpoint: https://172.18.0.20:5000
    caCertPath: /root/ca.crt
    pullCredentialConfigPath: /root/.docker/config.json
        

registryMirrors.hosts

Opcional. Un array de nombres de dominio para hosts que se duplican de forma local para la duplicación de registro determinada (endpoint). Cuando el entorno de ejecución del contenedor encuentra solicitudes de extracción de imágenes de un host especificado, primero verifica la duplicación del registro local. Para obtener información adicional, consulta Crea clústeres desde la duplicación del registro.

Por ejemplo:

registryMirrors:
  - endpoint: https://172.18.0.20:5000
    caCertPath: /root/ca.crt
    pullCredentialConfigPath: /root/.docker/config.json
    hosts:
    - somehost.io
    - otherhost.io
         

Credenciales

El archivo de configuración del clúster que genera bmctl para los clústeres de Anthos en equipos físicos incluye campos para especificar rutas de acceso a las credenciales y los archivos de claves en el sistema de archivos local. Estas credenciales y claves son necesarias para conectar los clústeres entre sí y con tu proyecto de Google Cloud.

Por ejemplo:

gcrKeyPath: bmctl-workspace/.sa-keys/my-gcp-project-anthos-baremetal-gcr.json
sshPrivateKeyPath: /home/root-user/.ssh/id_rsa
gkeConnectAgentServiceAccountKeyPath: bmctl-workspace/.sa-keys/my-gcp-project-anthos-baremetal-connect.json
gkeConnectRegisterServiceAccountKeyPath: bmctl-workspace/.sa-keys/my-gcp-project-anthos-baremetal-register.json
cloudOperationsServiceAccountKeyPath: bmctl-workspace/.sa-keys/my-gcp-project-anthos-baremetal-cloud-ops.json
        

gcrKeyPath

String. Es la ruta a la clave de la cuenta de servicio de Container Registry. La cuenta de servicio de Container Registry es una cuenta de servicio administrada por Google que actúa en nombre de Container Registry cuando interactúa con los servicios de Google Cloud.

sshPrivateKeyPath

String. Es la ruta a la clave privada SSH. Se requiere SSH para el acceso a los nodos.

gkeConnectAgentServiceAccountKeyPath

String. Es la ruta a la clave de la cuenta de servicio del agente. Los clústeres de Anthos en el equipo físico usan esta cuenta de servicio para mantener una conexión entre los clústeres de Anthos en el equipo físico y Google Cloud.

Si deseas obtener instrucciones para configurar esta cuenta de servicio, consulta Configura cuentas de servicio para usar con Connect.

gkeConnectRegisterServiceAccountKeyPath

String. Es la ruta a la clave de la cuenta de servicio de registro. Los clústeres de Anthos alojados en equipos físicos usan esta cuenta de servicio para registrar los clústeres de usuarios con Google Cloud.

Si deseas obtener instrucciones para configurar esta cuenta de servicio, consulta Configura cuentas de servicio para usar con Connect.

cloudOperationsServiceAccountKeyPath

String. Es la ruta a la clave de la cuenta de servicio de operaciones. Los clústeres de Anthos en el equipo físico usan la cuenta de servicio de operaciones para autenticarse con Google Cloud's operations suite para acceder a la API de Logging y a la API de Monitoring.

Si deseas obtener instrucciones para configurar esta cuenta de servicio, consulta Configura una cuenta de servicio para usar con Logging y Monitoring.