Archivo de configuración de clústeres de usuarios 1.29

En esta página, se describen los campos del archivo de configuración del clúster de usuarios de Google Distributed Cloud.

Genera una plantilla para tu archivo de configuración

Si usaste gkeadm a fin de crear tu estación de trabajo de administrador, gkeadm generó una plantilla para tu archivo de configuración de clústeres de usuarios. Además, gkeadm completó algunos de los campos por ti.

Si no usaste gkeadm para crear tu estación de trabajo de administrador, puedes usar gkectl a fin de generar una plantilla para el archivo de configuración de clústeres de usuarios.

Si deseas generar una plantilla para el archivo de configuración de clústeres de usuarios, haz lo siguiente:

gkectl create-config cluster --config=OUTPUT_FILENAME --gke-on-prem-version=VERSION

Reemplaza lo siguiente:

OUTPUT_FILENAME: una ruta de acceso que elijas para la plantilla generada. Si omites esta marca, gkectl asigna un nombre al archivo user-cluster.yaml y lo coloca en el directorio actual.

VERSION: El número de versión deseado. Por ejemplo: gkectl create-config cluster --gke-on-prem-version=1.10.0-gke.8

Plantilla

Campos obligatorios y valores predeterminados

Si un campo está marcado como Obligatorio, el archivo de configuración completado debe tener un valor para el campo.

Algunos campos son obligatorios de forma condicional. Por ejemplo, loadBalancer.metalLB.addressPools es obligatorio si loadBalancer.kind es igual a MetalLB.

Si se proporciona un valor Predeterminado para un campo, el clúster usará ese valor si no ingresas nada para el campo. Para anular un valor predeterminado, debes ingresar un valor.

Si un campo no está marcado como obligatorio y no se proporciona un valor predeterminado, el campo es opcional. Puedes completarla si es relevante para ti, pero no es obligatorio.

Completa el archivo de configuración

En el archivo de configuración, ingresa los valores de los campos como se describe en las siguientes secciones.

name

Obligatorio
String

El nombre que elijas para el clúster de usuario. El nombre debe cumplir con los siguientes requisitos:

  • Contener 40 caracteres como máximo.
  • Contener solo caracteres alfanuméricos en minúscula o un guiones (-).
  • Comenzar con un carácter alfabético
  • Terminar con un carácter alfanumérico

Ejemplo:

name: "my-user-cluster"

gkeOnPremVersion

Obligatorio
Mutable
Cadena

La versión de Google Distributed Cloud para tu clúster de usuario.

Ejemplo:

gkeOnPremVersion: "1.29.0-gke.1456"

preparedSecrets.namespace

Si deseas usar credenciales preparadas, completa este campo. De lo contrario, quita este campo o déjalo como comentario.

Inmutable
Cadena
Valores posibles: Una cadena que comienza con “gke-onprem-secrets-”

Es el nombre de un espacio de nombres de Kubernetes en el clúster de administrador en el que se conservarán los Secrets preparados para este clúster de usuario.

Ejemplo:

preparedSecrets:
  namespace: "gke-onprem-secrets-alice"

enableControlplaneV2

1.30 y versiones más altas

Mutable (se permite de false a true)
Booleano
Prepropagado: verdadero
Predeterminado: verdadero

En la versión 1.30 y versiones posteriores, Controlplane V2 es obligatorio para los clústeres de usuarios nuevos. Si incluyes este campo en tu archivo de configuración, debe establecerse como true.

Para migrar un clúster existente a Controlplane V2, consulta Migra un clúster de usuario a las funciones recomendadas. Después de migrar a Controlplane V2, no se permite inhabilitarlo.

Con Controlplane V2, el plano de control de un clúster de usuario se ejecuta en uno o más nodos en el clúster de usuario. Estos son algunos de los beneficios de Controlplane V2:

  • Coherencia arquitectónica entre los clústeres de administrador y de usuario

  • Aislamiento de fallas. Una falla del clúster de administrador no afecta a los clústeres de usuario.

  • Separación operativa. Una actualización de un clúster de administrador no genera tiempo de inactividad para los clústeres de usuario.

  • Separación de la implementación. Puedes colocar los clústeres de administrador y de usuario en diferentes dominios con fallas o sitios geográficos. Por ejemplo, un clúster de usuario en una ubicación perimetral podría estar en un sitio geográfico diferente del clúster de administrador.

1.29 y versiones más bajas

Inmutable
Booleano
Prepropagado: verdadero
Predeterminado: verdadero

Para habilitar Controlplane V2, configura enableControlplaneV2 como true o quita la configuración del archivo de configuración del clúster de usuario. De lo contrario, configúralo como false. Con Controlplane V2, el plano de control de un clúster de usuario se ejecuta en uno o más nodos en el clúster de usuario. Cuando Controlplane V2 no está habilitado, el plano de control del clúster de usuario se ejecuta en el clúster de administrador.

Te recomendamos que habilites Controlplane V2.

Ejemplo:

enableControlplaneV2: true

vCenter

En esta sección, se incluye información sobre el entorno de vSphere y la conexión a vCenter Server.

Si deseas que un campo en esta sección sea igual al que especificaste para tu clúster de administrador, quita el campo o déjalo como comentario.

Si quieres que un campo sea diferente del que especificaste para el clúster de administrador, rellénalo aquí. Cualquier campo que completes aquí en la sección vCenter anulará los campos correspondientes en el archivo de configuración del clúster de administrador.

vCenter.address

Cadena
Inmutable
Predeterminado: Hereda del clúster de administrador

Es la dirección IP o el nombre de host de la instancia de vCenter Server que quieres usar para este clúster de usuario.

Para obtener más información, consulta Busca la dirección de tu servidor de vCenter.

Si especificas un valor diferente de la instancia de vCenter Server que usa el clúster de administrador, se debe habilitar Controlplane V2 y debes proporcionar valores para network.vCenter.networkName y todos los campos obligatorios en la sección vCenter.

Ejemplos:

vCenter:
  address: "203.0.113.101"

vCenter:
  address: "my-vcenter-server-2.my-domain.example"

vCenter.datacenter

Cadena
Inmutable
Predeterminado: Hereda del clúster de administrador

Es la ruta de acceso relativa de un centro de datos de vSphere.

Si especificas un valor para este campo, también debes especificar lo siguiente:

  • vCenter.networkName
  • vCenter.datastore o vCenter.storagePolicyName
  • vCenter.cluster o vCenter.resourcePool

El valor que especifiques es relativo a la carpeta raíz llamada /.

Si tu centro de datos está en la carpeta raíz, el valor es el nombre del centro de datos.

Ejemplo:

vCenter:
  datacenter: "my-uc-data-center"

De lo contrario, el valor es una ruta de acceso relativa que incluye una o más carpetas junto con el nombre del centro de datos.

Ejemplo:

vCenter:
  datacenter: "data-centers/data-center-2"

vCenter.cluster

Cadena
Inmutable
Predeterminado: Hereda del clúster de administrador

Es la ruta de acceso relativa de un clúster de vSphere que representa los hosts ESXi en los que se ejecutarán las VMs de tu clúster de usuario. Este clúster de vSphere representa un subconjunto de los hosts ESXi físicos en tu centro de datos de vCenter.

Si especificas un valor para este campo, también debes especificar lo siguiente:

  • vCenter.networkName
  • vCenter.datacenter
  • vCenter.datastore o vCenter.storagePolicyName

El valor que especifiques es relativo a /.../DATA_CENTER/vm/.

Si tu clúster de vSphere se encuentra en la carpeta /.../DATA_CENTER/vm/, el valor es el nombre del clúster de vSphere.

Ejemplo:

vCenter:
  cluster: "my-uc-vsphere-cluster"

De lo contrario, el valor es una ruta de acceso relativa que incluye una o más carpetas junto con el nombre del clúster de vSphere.

Ejemplo:

vCenter:
  cluster: "clusters/vsphere-cluster-2"

vCenter.resourcePool

Cadena
Inmutable
Predeterminado: Hereda del clúster de administrador

Un grupo de recursos de vCenter para las VMs de tu clúster de usuario

Si deseas usar el grupo de recursos predeterminado, configúralo como VSPHERE_CLUSTER/Resources.

Ejemplo:

vCenter:
  resourcePool: "my-uc-vsphere-cluster/Resources"

El valor que especifiques es relativo a /.../DATA_CENTER/host/.../VSPHERE_CLUSTER/Resources/.

Si tu grupo de recursos es un elemento secundario directo de /.../DATA_CENTER/host/.../VSPHERE_CLUSTER/Resources/, el valor es el nombre del grupo de recursos.

Ejemplo:

vCenter:
  resourcePool: "my-uc-resource-pool"

De lo contrario, el valor es una ruta de acceso relativa que tiene dos o más grupos de recursos.

Ejemplo:

vCenter:
  resourcePool: "uc-resource-pool-1/uc-resource-pool-2"

vCenter.datastore

Opcional
Inmutable
Cadena
Predeterminado: Hereda del clúster de administrador

Es el nombre de un almacén de datos de vSphere para tu clúster de usuarios.

El valor que especifiques debe ser un nombre, no una ruta. No incluyas ninguna carpeta en el valor.

Ejemplo:

vCenter:
  datastore: "my-datastore"

Si especificas un valor para este campo, no especifiques un valor para vCenter.storagePolicyName. El campo vCenter.datastore es inmutable, excepto cuando configuras el campo como una cadena vacía cuando migras un almacén de datos a la administración basada en políticas de almacenamiento (SPBM).

vCenter.storagePolicyName

Opcional
Cadena
Inmutable

Es el nombre de una política de almacenamiento de VM para los nodos del clúster.

También puedes especificar una política de almacenamiento de VM para los nodos de un grupo de nodos específico. Sin embargo, la política especificada aquí se aplica a cualquier grupo de nodos que no tenga su propia política.

Para obtener más información, consulta Configura una política de almacenamiento.

Si especificas un valor para este campo, no especifiques un valor para vCenter.datastore.

vCenter.caCertPath

Mutable
Cadena
Predeterminado: Hereda del clúster de administrador

Es la ruta de acceso del certificado de CA de vCenter Server. Para obtener más información, consulta Obtén tu certificado de CA de vCenter.

Ejemplo:

vCenter:
  caCertPath: "/usr/local/google/home/me/certs/vcenter-ca-cert-2.pem"

Si deseas obtener información para actualizar este campo, consulta Actualiza las referencias de certificados de vCenter.

vCenter.credentials.fileRef.path

Mutable
Cadena
Predeterminado: Hereda del clúster de administrador

Si proporcionas un valor para preparedSecrets.namespace, no proporciones un valor para este campo. En su lugar, proporciona un valor para vCenter.credentials.secretRef.version.

Es la ruta de acceso de un archivo de configuración de credenciales que contiene el nombre de usuario y la contraseña de tu cuenta de usuario de vCenter. La cuenta de usuario debe tener el rol de administrador o privilegios equivalentes. Consulta los requisitos de vSphere.

Puedes usar gkectl update credentials para actualizar este campo en un clúster existente. Para obtener más información, consulta Rota claves de cuentas de servicio.

Si deseas obtener información para actualizar tus credenciales de vCenter, consulta Actualiza las credenciales de clústeres.

Ejemplo:

vCenter:
  credentials:
    fileRef:
      path: "my-config-directory/my-credentials-2.yaml"

vCenter.credentials.fileRef.entry

Mutable
Cadena
Predeterminado: Hereda del clúster de administrador

Es el nombre del bloque de credenciales en el archivo de configuración de credenciales, que contiene el nombre de usuario y la contraseña de tu cuenta de usuario de vCenter.

Ejemplo:

vCenter:
  credentials:
    fileRef:
      entry: "vcenter-credentials-2"

vCenter.credentials.secretRef.version

Cadena
Valores posibles: Una cadena de número entero o “la más reciente”
Valor predeterminado: “la más reciente”

Si proporcionas un valor para preparedSecrets.namespace, completa este campo. De lo contrario, quita este campo o déjalo como comentario.

Es la versión de un Secret preparado en el clúster de administrador que contiene el nombre de usuario y la contraseña de la instancia de vCenter Server que deseas usar para este clúster de usuarios.

Ejemplo:

vCenter:
  credentials:
    secretRef:
      version: "1"

vCenter.folder

Cadena
Inmutable
Predeterminado: Hereda del clúster de administrador

La ruta de acceso relativa a una carpeta de vSphere que ya creaste Esta carpeta contendrá las VMs de tu clúster de usuario.

Si no especificas un valor, las VMs de tu clúster de usuarios se colocarán en /.../DATA_CENTER/vm/.

Si especificas un valor, este es relativo a /.../DATA_CENTER/vm/.

El valor puede ser el nombre de una carpeta.

Ejemplo:

vCenter:
  folder: "my-uc-folder"

O bien, el valor puede ser una ruta de acceso relativa que incluya más de una carpeta.

Ejemplo:

vCenter:
  folder: "folders/folder-2"

componentAccessServiceAccountKeyPath

Mutable
Cadena
Predeterminado: Hereda del clúster de administrador

Es la ruta de acceso del archivo de claves JSON para la cuenta de servicio de acceso a los componentes.

Ejemplo:

componentAccessServiceAccountKeyPath: "my-key-folder/uc-access-key.json"

componentAccessServiceAccountKey.secretRef.version

Mutable
Cadena
Valores posibles: Una cadena de número entero o “la más reciente”
Valor predeterminado: “la más reciente”

La versión de un Secret preparado en el clúster de administrador que contiene una clave JSON para tu cuenta de servicio de acceso a componentes.

Ejemplo:

componentAccessServiceAccountKey:
  secretRef:
    version: "1"

privateRegistry

Completa esta sección solo si tu clúster de administrador usa un registro privado y deseas que tu clúster de usuario use un registro privado diferente. De lo contrario, quita esta sección o déjala como comentario.

Si deseas tener parámetros de configuración diferentes de los del clúster de administrador, haz lo siguiente:

  • Nombre de usuario, contraseña y certificado diferentes

  • (Solo disponible para el plano de control V2) Dirección de registro privado diferente

Completa los campos privateRegistry aquí. La configuración nueva se recupera durante la creación y actualización del clúster.

privateRegistry.address

Cadena
Inmutable
Predeterminado: Hereda del clúster de administrador

La dirección IP o FQDN (nombre de dominio completamente calificado) de la máquina que ejecuta el registro privado de Docker.

Ejemplos:

privateRegistry:
  address: "203.0.113.10"

privateRegistry:
  address: "fqdn.example.com"

privateRegistry.credentials.fileRef.path

Mutable
Cadena
Predeterminado: Hereda del clúster de administrador

Si planeas usar un Secret preparado para el registro privado, no proporciones un valor para este campo. En su lugar, proporciona un valor para privateRegistry.credentials.secretRef.version.

Es la ruta de acceso de un archivo de configuración de credenciales que contiene el nombre de usuario y la contraseña de una cuenta que Google Distributed Cloud puede usar para acceder a tu registro privado de Docker.

Ejemplo:

privateRegistry:
  credentials:
    fileRef:
      path: "my-config-folder/admin-creds.yaml"

privateRegistry.credentials.fileRef.entry

Mutable
Cadena
Predeterminado: Hereda del clúster de administrador

Es el nombre del bloque de credenciales del archivo de configuración de credenciales que contiene el nombre de usuario y la contraseña de la cuenta del registro de Docker privado.

privateRegistry:
  credentials:
    fileRef:
      entry: "private-registry-creds"

privateRegistry.credentials.secretRef.version

Cadena
Valores posibles: Una cadena de número entero o “la más reciente”
Valor predeterminado: “la más reciente”

Si proporcionas un valor para preparedSecrets.namespace y deseas usar el Secret preparado para un registro privado, completa este campo. De lo contrario, quita este campo o déjalo como comentario.

Es la versión de un Secret preparado en el clúster de administrador que contiene el nombre de usuario y la contraseña de la instancia de vCenter Server que deseas usar para este clúster de usuarios.

Ejemplo:

privateRegistry:
  credentials:
    secretRef:
      version: "1"

privateRegistry.caCertPath

Mutable
Cadena
Predeterminado: Hereda del clúster de administrador

Cuando Docker extrae una imagen del registro privado, el registro debe demostrar su identidad mediante la presentación de un certificado. El certificado del registro está firmado por una autoridad certificada (CA). Docker usa el certificado de la CA para validar el certificado del registro.

Establece el campo en la ruta de acceso del certificado de la CA.

Ejemplo:

privateRegistry:
  caCertPath: "my-cert-folder/registry-ca.crt"

network

Esta sección contiene información sobre tu red de clústeres de usuarios.

network.hostConfig

En esta sección, se incluye información sobre los servidores NTP, los servidores DNS y los dominios de búsqueda de DNS que usan las VM que son los nodos del clúster. Si usas el balanceador de cargas de Seesaw, esta información también se aplica a las VM de Seesaw.

Esta sección es obligatoria si se cumple una o más de las siguientes condiciones:

  • network.ipMode.type se configura como static.
  • enableControlplaneV2 se establece en true o se permite que se establezca de forma predeterminada en true.
  • loadBalancer.kind se configura como "Seesaw".

network.hostConfig.dnsServers

Obligatorio
Inmutable
Array de cadenas.
La cantidad máxima de elementos en el array es tres.

Son las direcciones de los servidores DNS de las VMs.

Ejemplo:

network:
  hostConfig:
    dnsServers:
    - "172.16.255.1"
    - "172.16.255.2"

network.hostConfig.ntpServers

Obligatorio
Inmutable
Array de cadenas

Son las direcciones de los servidores de tiempo para las VM.

Ejemplo:

network:
  hostConfig:
    ntpServers:
    - "216.239.35.0"

network.hostConfig.searchDomainsForDNS

Inmutable
Array de cadenas

Son dominios de búsqueda de DNS para los hosts. Estos dominios se usan como parte de una lista de búsqueda de dominios.

Ejemplo:

network:
  hostConfig:
    searchDomainsForDNS:
    - "my.local.com"

network.ipMode.type

Inmutable
Cadena
Prepropagado: “estático”
Predeterminado: “DHCP”

Si deseas que los nodos del clúster obtengan la dirección IP de un servidor DHCP, configura esto como "dhcp". Si quieres que los nodos del clúster tengan direcciones IP estáticas seleccionadas de una lista que proporciones, configura esto como "static".

Ejemplo:

network:
  ipMode:
    type: "static"

network.ipMode.ipBlockFilePath

Obligatorio si network.ipMode.type = static
Inmutable
Cadena

La ruta de acceso del archivo de bloque de IP de tu clúster.

Ejemplo:

network:
  ipMode:
    ipBlockFilePath: "/my-config-folder/user-cluster-ipblock.yaml"

network.serviceCIDR

Inmutable
Cadena
Prepropagado: “10.96.0.0/20”
>

Un rango de direcciones IP, en formato CIDR, que se usarán para los servicios en tu clúster. Debe ser al menos un rango de /24.

Ejemplo:

network:
  serviceCIDR: "10.96.0.0/20"

network.podCIDR

Inmutable
Cadena
Prepropagado: “192.168.0.0/16”
Predeterminado: “192.168.0.0/16”

Un rango de direcciones IP, en formato CIDR, que se usará para los Pods en tu clúster. Debe ser al menos un rango /18.

Ejemplo:

network:
  podCIDR: "192.168.0.0/16"

El rango de Service no debe superponerse con el rango de Pod.

Los rangos de Service y Pod no deben superponerse con ninguna dirección fuera del clúster a la que deseas llegar desde dentro del clúster.

Por ejemplo, supongamos que el rango de Service es 10.96.232.0/24 y el rango de Pod es 192.168.0.0/16. El tráfico enviado desde un Pod a una dirección en cualquiera de esos rangos se tratará como tráfico en el clúster y no llegará a ningún destino fuera del clúster.

En particular, los rangos de Service y Pod no deben superponerse con lo siguiente:

  • Direcciones IP de nodos en cualquier clúster

  • Direcciones IP que usan las máquinas del balanceador de cargas

  • VIP que usan los balanceadores de cargas y los nodos del plano de control

  • Dirección IP de los servidores de vCenter, DNS y NTP

Recomendamos que los rangos de Service y Pod estén en el espacio de direcciones RFC 1918.

Esta es una razón para que la recomendación use direcciones RFC 1918. Supongamos que tu rango de Pod o Service contiene direcciones IP externas. Cualquier tráfico enviado desde un Pod a una de esas direcciones externas se tratará como tráfico en el clúster y no llegará al destino externo.

network.vCenter.networkName

Obligatorio si vCenter.address es diferente de la dirección de vCenter que usas para el clúster de administrador.
Inmutable
Cadena

Es el nombre de la red de vSphere para los nodos del clúster de usuarios.

Ejemplo:

network:
  vCenter:
    networkName: "my-network"

Si el nombre contiene un carácter especial, debes usar una secuencia de escape.

Caracteres especiales Secuencia de escape
Barra (/) %2f
Barra inversa (\) %5c
Signo de porcentaje (%) %25

Si el nombre de la red no es único en tu centro de datos, puedes especificar una ruta de acceso completa.

Ejemplo:

network:
  vCenter:
    networkName: "/my-uc-datacenter/network/my-network"

network.additionalNodeInterfaces

Si configuras multipleNetworkInterfaces como true, completa esta sección. De lo contrario, quita esta sección o déjala como comentario.

Inmutable

Un array de objetos, cada uno de los cuales describe una interfaz de red que se puede usar en todos o algunos de tus nodos de clúster.

network.additionalNodeInterfaces[i].networkName

Obligatorio si multipleNetworkInterfaces = true
Inmutable
Cadena

Es el nombre de la red de vSphere a la que se conectará esta interfaz de nodo adicional.

Ejemplo:

network:
  additionalNodeInterfaces:
  - networkName: "my-node-interface-1"

network.additionalNodeInterfaces[i].type

Obligatorio si multipleNetworkInterfaces = true
Inmutable
Cadena

Ejemplo:

network:
  additionalNodeInterfaces:
  - name: "my-node-interface-1"
    type: "static"

network.additionalNodeInterfaces[i].ipBlockFilePath

Obligatorio si network.additionalNodeInterfaces[i].type = static
Inmutable
Cadena

Es la ruta de acceso de un archivo de bloque de IP que contiene direcciones IP para esta interfaz de red en los nodos que tienen esta interfaz de red.

Ejemplo:

network:
  additionalNodeInterfaces:
  - name: "my-node-interface-1"
    type: "static"
    ipBlockFilePath: "my-ipblock-file-1"

network.controlPlaneIPBlock

Si configuras enableControlplaneV2 como true, completa esta sección. De lo contrario, quita esta sección o déjala como comentario.

network.controlPlaneIPBlock.netmask

Obligatorio si enableControlplaneV2 = true
Inmutable
Cadena

Ejemplo:

network:
  controlPlaneIPBlock:
    netmask: "255.255.255.0"

network.controlPlaneIPBlock.gateway

Obligatorio si enableControlplaneV2 = true
Inmutable
Cadena

Ejemplo:

network:
  controlPlaneIPBlock:
    gateway: "172.16.21.1"

network.controlPlaneIPBlock.ips

Obligatorio si enableControlplaneV2 = true
Inmutable
Array de objetos, cada uno de los cuales tiene una dirección IP y un nombre de host opcional.

En el caso de un clúster de usuario con alta disponibilidad (HA), el array tiene tres elementos. En un clúster de usuario sin alta disponibilidad, el array tiene un elemento.

Ejemplo:

network:
  controlPlaneIPBlock:
    ips:
    - ip: "172.16.21.6"
      hostname: "cp-vm-1"
    - ip: "172.16.21.7"
      hostname: "cp-vm-2"
    - ip: "172.16.21.8"
      hostname: "cp-vm-3"

loadBalancer

En esta sección, se conserva información sobre el balanceador de cargas para el clúster de usuarios.

loadBalancer.vips.controlPlaneVIP

Obligatorio
Cadena
Inmutable

Es la dirección IP que elegiste configurar en el balanceador de cargas para el servidor de la API de Kubernetes del clúster de usuario.

Ejemplo:

loadBalancer:
  vips:
    controlplaneVIP: "203.0.113.3"

loadBalancer.vips.ingressVIP

Obligatorio
Cadena
Inmutable

Es la dirección IP que elegiste configurar en el balanceador de cargas para el proxy de entrada.

Ejemplo:

loadBalancer:
  vips:
    ingressVIP: "203.0.113.4"

loadBalancer.kind

Obligatorio
Inmutable
Cadena
Prepropagado: “MetalLB”

Configura esto como "ManualLB", "F5BigIP", "Seesaw" o "MetalLB".

Para habilitar funciones nuevas y avanzadas, te recomendamos que uses "ManualLB" si tienes un balanceador de cargas de terceros (como BIG-IP de F5 o Citrix) o "MetalLB" para nuestra solución en paquete.

Ejemplo:

loadBalancer:
  kind: "MetalLB"

loadBalancer.manualLB

Si configuras loadbalancer.kind como "manualLB", completa esta sección. De lo contrario, quita esta sección o déjala como comentario.

loadBalancer.manualLB.ingressHTTPNodePort

Obligatorio si loadBalancer.kind = ManualLB
Inmutable
Número entero
Prepropagado: 30243

El proxy de entrada en un clúster de usuario se expone mediante un servicio de Kubernetes de tipo LoadBalancer. El servicio tiene un ServicePort para HTTP. Debes elegir un valor nodePort para los ServicePort de HTTP.

Establece este campo en el valor nodePort.

Ejemplo:

loadBalancer:
  manualLB:
    ingressHTTPNodePort: 32527

loadBalancer.manualLB.ingressHTTPSNodePort

Obligatorio si loadBalancer.kind = ManualLB
Inmutable
Número entero
Prepropagado: 30879

Un Service de tipo LoadBalancer expone el proxy de entrada en un clúster de usuario. El Servicio tiene un ServicePort para HTTPS. Debes elegir un valor nodePort para el ServicePort de HTTPS.

Establece este campo en el valor nodePort. Ejemplo:

loadBalancer:
  manualLB:
    ingressHTTPSNodePort: 30139

loadBalancer.manualLB.controlPlaneNodePort

Obligatorio si loadBalancer.kind = ManualLB y enableControlplaneV2 = false
Inmutable
Número entero
Prepropagado: 30562

El servidor de la API de Kubernetes de un clúster de usuario se ejecuta en el clúster de administrador y se expone mediante un Service de tipo LoadBalancer. Debes elegir un valor nodePort para el Service.

Establece este campo en el valor nodePort.

Ejemplo:

loadBalancer:
  manualLB:
    controlPlaneNodePort: 30968

loadBalancer.manualLB.konnectivityServerNodePort

Obligatorio si loadBalancer.kind = ManualLB y enableControlplaneV2 = false
Inmutable
Número entero
Prepropagado: 30563

El servidor de la API de Kubernetes de un clúster de usuario que usa kubeception se ejecuta en el clúster de administrador y se expone mediante un Service de tipo LoadBalancer. El servidor de Konnectivity vuelve a usar este servicio con un valor nodePort diferente. Debes elegir un valor nodePort para el servidor de Konnectivity.

Configura este campo con el valor nodePort para el servidor de Konnectivity.

Ejemplo:

loadBalancer:
  manualLB:
    konnectivityServerNodePort: 30969

loadBalancer.f5BigIP

Si configuras loadbalancer.kind como "f5BigIP", completa esta sección. De lo contrario, quita esta sección o déjala como comentario.

Para habilitar funciones nuevas y avanzadas, te recomendamos que configures el balanceo de cargas manual para tu balanceador de cargas de BIG-IP de F5. Para habilitar el balanceo de cargas manual, configura loadbalancer.kind como "ManualLB" y completa la sección loadBalancer.manualLB. Para obtener más información, consulta cómo Habilitar el balanceo de cargas manual.

loadBalancer.f5BigIP.address

Obligatorio si loadBalancer.kind = "f5BigIP"
Cadena

Es la dirección del balanceador de cargas BIG-IP de F5.

Ejemplo:

loadBalancer:
  f5BigIP:
      address: "203.0.113.2"

loadBalancer.f5BigIP.credentials.fileRef.path

Obligatorio si loadBalancer.kind = "f5BigIP"
String

Es la ruta de un archivo de credenciales que contiene el nombre de usuario y la contraseña de una cuenta que Google Distributed Cloud puede usar para conectarse a tu balanceador de cargas BIG-IP de F5.

La cuenta de usuario debe tener un rol del usuario que tenga permisos suficientes para configurar y administrar el balanceador de cargas. La función de administrador o de administrador de recursos es suficiente.

Si deseas obtener información para actualizar las credenciales de BIG-IP de F5, consulta Actualiza las credenciales del clúster.

Ejemplo:

loadBalancer:
  f5BigIP:
    credentials:
      fileRef:
        path: ""my-config-folder/user-creds.yaml"

loadBalancer.f5BigIP.credentials.fileRef.entry

Obligatorio si loadBalancer.kind = "f5BigIP"
Cadena

Es el nombre del bloque de credenciales del archivo de configuración de credenciales que contiene el nombre de usuario y la contraseña de la cuenta BIG-IP de F5.

Ejemplo:

loadBalancer:
  f5BigIP:
    credentials:
      fileRef:
        entry: "f5-creds"

loadBalancer.f5BigIP.partition

Obligatorio si loadBalancer.kind = "f5BigIP"
Cadena

Es el nombre de una partición de BIG-IP que creaste para el clúster de usuario.

Ejemplo:

loadBalancer:
  f5BigIP:
    partition: "my-f5-user-partition"

loadBalancer.f5BigIP.snatPoolName

Obligatorio si loadBalancer.kind = "f5BigIP" y usas SNAT
String

El nombre de tu grupo de SNAT.

Ejemplo:

loadBalancer:
  f5BigIP:
    snatPoolName: "my-snat-pool"

loadBalancer.seesaw

Si configuras loadbalancer.kind como "Seesaw", completa esta sección. De lo contrario, quita esta sección o déjala como comentario.

Ten en cuenta las siguientes limitaciones del balanceador de cargas Seesaw:

Para usar estas funciones, te recomendamos que configures el balanceador de cargas MetalLB. Para habilitar el balanceador de cargas de MetalLB, configura loadbalancer.kind como "MetalLB" y completa la sección loadBalancer.metalLB. Para obtener más información, consulta Balanceo de cargas en paquetes con MetalLB.

Si actualmente usas el balanceador de cargas de Seesaw, te recomendamos que migres a MetalLB.

loadBalancer.seesaw.ipBlockFilePath

Obligatorio si loadBalancer.kind = Seesaw
Inmutable
Cadena

Es la ruta del archivo de bloque de IP para las VM de Seesaw.

Ejemplo:

loadBalancer:
  seesaw:
    ipBlockFilePath: "config-folder/user-seesaw-ipblock.yaml"

loadBalancer.seesaw.vrid

Obligatorio si loadBalancer.kind = Seesaw
Inmutable
Valor entero
Valores posibles: 1 - 255
Prepropagado: 0

Es el identificador del router virtual de la VM de Seesaw. Este identificador, que es un número entero que debes elegir, debe ser único en una VLAN.

Ejemplo:

loadBalancer:
  seesaw:
    vrid: 125

loadBalancer.seesaw.masterIP

Obligatorio si loadBalancer.kind = Seesaw
Inmutable
Cadena

La dirección IP virtual configurada en la VM de Seesaw de la instancia principal.

Ejemplo:

loadBalancer:
  seesaw:
    masterIP: 172.16.20.21

loadBalancer.seesaw.cpus

Obligatorio si loadBalancer.kind = Seesaw
Mutable
Número entero
Prepropagado: 4

Es la cantidad de CPU para cada una de tus VM de Seesaw.

Ejemplo:

loadBalancer:
  seesaw:
    cpus: 8

loadBalancer.seesaw.memoryMB

Obligatorio si loadBalancer.kind = Seesaw
Mutable
Número entero
Prepropagado: 3072

Es la cantidad de megabytes de memoria para cada una de tus VM de Seesaw.

Ejemplo:

loadBalancer:
  seesaw:
    memoryMB: 8192

Nota: Este campo especifica la cantidad de megabytes de memoria, no de megabytes. Un mebibyte es 2^20 y es igual a 1,048,576 bytes. Un megabyte es 10^6 y es igual a 1,000,000 bytes.

loadBalancer.seesaw.vCenter.networkName

Inmutable
Cadena
Predeterminado: Igual que los nodos del clúster

Es el nombre de la red de vCenter que contiene las VM de Seesaw.

Ejemplo:

loadBalancer:
  seesaw:
    vCenter:
      networkName: "my-seesaw-network"

loadBalancer.seesaw.enableHA

Inmutable
Es relevante si loadBalancer.kind = Seesaw
Booleano
Prepropagado: falso
Predeterminado: falso

Si deseas crear un balanceador de cargas de Seesaw con alta disponibilidad (HA), configura esto como true. De lo contrario, configúralo como false. Un balanceador de cargas de Seesaw con alta disponibilidad usa un par (principal, copia de seguridad) de las VM.

Ejemplo:

loadBalancer:
  seesaw:
    enableHA: true

loadBalancer.seesaw.disableVRRPMAC

Inmutable
Importante si loadBalancer.kind = Seesaw
Booleano
Prepropagado: verdadero
Predeterminado: verdadero

Si estableces esto como true, el balanceador de cargas de Seesaw no usará el aprendizaje de MAC para la conmutación por error. En su lugar, usa un ARP injustificado. Si configuras esto como false, el balanceador de cargas de Seesaw usa el aprendizaje de MAC. Te recomendamos establecer esto en true. Si usas vSphere 7 o una versión posterior, y tienes un balanceador de cargas de Seesaw de alta disponibilidad, debes establecerlo en true.

Ejemplo:

loadBalancer:
  seesaw:
    disableVRRPMAC: true

loadBalancer.metalLB

Si configuras loadbalancer.kind como "MetalLB", completa esta sección. De lo contrario, quita esta sección o déjala como comentario.

Para obtener más información, consulta Balanceo de cargas en paquetes con MetalLB.

loadBalancer.metalLB.addressPools

Obligatorio si loadBalancer.kind = “MetalLB”
Mutable

Array de objetos, cada uno de los cuales contiene información sobre un grupo de direcciones que usará el balanceador de cargas de MetalLB.

loadBalancer.metalLB.addressPools[i].name

Obligatorio si loadBalancer.kind = MetalLB
Mutable
Cadena

Un nombre de tu elección para el grupo de nodos.

Ejemplo:

loadBalancer:
  metalLB:
    addressPools:
    - name: "my-address-pool-1"
loadBalancer.metalLB.addressPools[i].addresses

Obligatorio si loadBalancer.kind = MetalLB
Mutable

Array de cadenas, cada uno de los cuales es un rango de direcciones. Cada rango debe estar en formato CIDR o con rango con guiones.

Ejemplo:

loadBalancer:
  metalLB:
    addressPools:
    - name: "my-address-pool-1"
      addresses:
      - "192.0.2.0/26"
      - "192.0.2.64-192.0.2.72"
loadBalancer.metalLB.addressPools[i].avoidBuggyIPs

Es relevante si loadBalancer.kind = MetalLB
Mutable
Booleano
Prepropagado: falso
Predeterminado: falso

Si configuras esto como true, el controlador de MetalLB no asignará direcciones IP que terminen en .0 o .255 a los Services. Esto evita el problema de los dispositivos consumidores con errores que descartan por error el tráfico enviado a esas direcciones IP especiales.

Ejemplo:

loadBalancer:
  metalLB:
    addressPools:
    - name: "my-address-pool-1"
      - "192.0.2.0/26"
      - "192.0.2.64-192.0.2.72"
      avoidBuggyIPs: true
loadBalancer.metalLB.addressPools[i].manualAssign

Es relevante si loadBalancer.kind = MetalLB
Mutable
Booleano
Prepropagado: falso
Predeterminado: falso

Si no quieres que el controlador MetalLB asigne de forma automática direcciones IP de este grupo a objetos Service, configura esto como true. Luego, un desarrollador puede crear un objeto Service de tipo LoadBalancer y especificar de forma manual una de las direcciones del grupo.

De lo contrario, establécelo en false.

Ejemplo:

loadBalancer:
  metalLB:
    addressPools:
    - name: "my-address-pool-1"
      manualAssign: true

enableDataplaneV2

1.30 y versiones más altas

Mutable (se permite de false a true)
Booleano
Prepropagado: verdadero
Predeterminado: verdadero

Este campo controla la interfaz de red de contenedor (CNI) que usa el clúster. Para usar Controlplane V2, debes habilitar Dataplane V2. Puedes cambiar el campo de false a true para habilitar Dataplane V2, pero no se permite inhabilitarlo.

Los beneficios de Dataplane V2 incluyen lo siguiente:

  • Dataplane V2 te proporciona una interfaz de red de contenedor (CNI) más avanzada y capaz en comparación con la opción de CNI anterior, Calico. Calico está en modo de mantenimiento, lo que significa que solo recibe correcciones de errores y actualizaciones de seguridad críticas, pero no se desarrolla ninguna función nueva. En cambio, Dataplane V2 se desarrolla y mejora de forma activa, lo que garantiza que tengas acceso a las innovaciones y capacidades de redes más recientes.

  • Dataplane V2 es la CNI preferida para GKE y otros productos de Google Distributed Cloud.

1.29 y versiones más bajas

Inmutable
Booleano
Prepropagado: verdadero
Predeterminado: falso

Si deseas habilitar Dataplane V2 o usar Controlplane V2, configúralo como true. De lo contrario, configúralo como false.

Te recomendamos que habilites Dataplane V2.

Ejemplo:

  enableDataplaneV2: true

Consulta Solución de problemas de NFS y DataPlane v2 de Google Distributed Cloud para obtener pasos para solucionar problemas.

dataplaneV2.forwardMode

Inmutable
Cadena
Valores posibles: “snat” o “dsr”
Prepropagado: “snat”
Configuración predeterminada: “snat”

El modo de reenvío para un clúster que tiene habilitado Dataplane V2.

Con el modo de traducción de direcciones de red de origen (SNAT), un paquete se traduce con SNAT cuando se reenvía de un nodo de balanceador de cargas a un Pod de backend. El Pod no puede ver la dirección IP de origen original, y el paquete de devolución debe pasar por el nodo del balanceador de cargas.

Con el modo de devolución directa del servidor (DSR), un paquete retiene su dirección IP de origen original cuando se reenvía de un nodo de balanceador de cargas a un Pod de backend. El Pod puede ver la dirección IP de origen original, y el paquete de devolución va directamente al cliente sin pasar por el nodo del balanceador de cargas.

Ejemplo:

dataplaneV2:
  forwardMode: "dsr"

Nota: Si actualizas este campo, es posible que se produzca un problema conocido según las versiones del clúster. Aplica la solución mencionada si tu versión del clúster se ve afectada.

multipleNetworkInterfaces

Inmutable
Booleano
Prepropagado: falso
Predeterminado: falso

Si deseas habilitar interfaces de red múltiples para Pods, configura esto como true. De lo contrario, configúralo como false.

Si deseas obtener más información, consulta Configura interfaces de red múltiples para Pods.

Ejemplo:

multipleNetworkInterfaces: true

advancedNetworking

Inmutable
Booleano
Prepropagado: falso
Predeterminado: falso

Si planeas crear una puerta de enlace NAT de salida, configura como true. De lo contrario, configúralo como false.

Si configuras esto como true, también debes establecer enableDataplaneV2 en true.

Ejemplo:

advancedNetworking: true

disableBundledIngress

Configúralo como true si deseas inhabilitar el acceso agrupado del clúster. De lo contrario, configúralo como false.

Booleano
Mutable
Prepropagado: falso
Predeterminado: falso

Ejemplo:

disableBundledIngress: true

storage.vSphereCSIDisabled

Si quieres inhabilitar la implementación de los componentes de CSI de vSphere, configura esto como true. De lo contrario, configúralo como false.

Mutable
Booleano
Prepropagado: falso
Predeterminado: falso

Ejemplo:

storage:
  vSphereCSIDisabled: false

masterNode

En esta sección, se conserva información sobre los nodos que funcionan como nodos del plano de control en tu clúster de usuario.

masterNode.cpus

Mutable
Número entero
Prepropagado: 4
Predeterminado: 4

Es la cantidad de CPU para cada nodo que funciona como plano de control de este clúster de usuario.

Ejemplo:

masterNode:
  cpus: 8

masterNode.memoryMB

Mutable
Número entero
Prepropagado: 8192
Predeterminado: 8192

Los mebibytes de memoria para cada nodo que funciona como un plano de control para este clúster de usuario. Debe ser múltiplo de 4.

Ejemplo:

masterNode:
  memoryMB: 8192

Nota: Este campo especifica la cantidad de megabytes de memoria, no de megabytes. Un mebibyte es 2^20 y es igual a 1,048,576 bytes. Un megabyte es 10^6 y es igual a 1,000,000 bytes.

masterNode.replicas

Inmutable
Número entero
Valores posibles: 1 o 3
Prepropagado: 1
Valor predeterminado: 1

Es la cantidad de nodos del plano de control para este clúster de usuario. Esta cantidad no se puede cambiar una vez que creaste el clúster. Si quieres actualizar la cantidad de réplicas más adelante, debes volver a crear el clúster de usuario.

Ejemplo:

masterNode:
  replicas: 3

masterNode.autoResize.enabled

Mutable
Booleano
Prepropagado: falso
Predeterminado: falso

Configúralo como true para habilitar el cambio de tamaño automático de los nodos del plano de control del clúster de usuario. De lo contrario, establécelo en false.

Para obtener más información, consulta Habilita el cambio de tamaño de los nodos para los nodos del plano de control de un clúster de usuario.

Ejemplo:

masterNode:
  autoResize:
    enabled: true

masterNode.vsphere.datastore

Opcional
Inmutable
Cadena
Predeterminado: El valor de vCenter.datastore

El almacén de datos en el que se crearán los nodos de plano de control para este clúster de usuario.

El valor que especifiques debe ser un nombre, no una ruta. No incluyas ninguna carpeta en el valor.

Ejemplo:

masterNode:
  vSphere:
    datastore: "control-plane-datastore"

Si especificas un valor para este campo, no especifiques un valor para masterNode.vsphere.storagePolicyName. El campo masterNode.vsphere.datastore es inmutable, excepto cuando estableces el campo en una cadena vacía cuando migras un almacén de datos a la administración basada en políticas de almacenamiento (SPBM).

masterNode.vsphere.storagePolicyName

Opcional
Inmutable
Cadena
Predeterminado: El valor de vCenter.storagePolicyName

Es el nombre de una política de almacenamiento de VM para los nodos del plano de control.

Para obtener más información, consulta Configura una política de almacenamiento.

Ejemplo:

masterNode:
  vSphere:
    storagePolicyName: "control-plane-storage-policy"

Si especificas un valor para este campo, no especifiques un valor para masterNode.vsphere.datastore.

nodePools

Obligatorio
Mutable
Array de objetos, cada uno de los cuales describe un grupo de nodos.

Para obtener más información, consulta Crea y administra grupos de nodos.

nodePools[i].name

Obligatorio
Inmutable
Cadena

Un nombre de tu elección para el grupo de nodos. El nombre debe cumplir con los siguientes requisitos:

  • Contener 40 caracteres como máximo.
  • Contener solo caracteres alfanuméricos en minúscula o un guiones (-).
  • Comenzar con un carácter alfabético
  • Terminar con un carácter alfanumérico

Ejemplo:

nodePools:
- name: "my-node-pool-1"

nodePools[i].gkeOnPremVersion

Cuando actualizas un clúster de usuario, puedes especificar que los grupos de nodos seleccionados permanezcan en la versión anterior.

Si deseas que este grupo de nodos permanezca en la versión anterior, configúralo en la versión anterior. De lo contrario, quita este campo o configúralo como una cadena vacía. Para obtener más información, consulta Actualiza un clúster de usuario.

Mutable
Cadena
Opción predeterminada: El clúster gkeOnPremVersion

Ejemplo:

nodePools:
- name: "my-node-pool"
  gkeOnPremVersion: "1.13.0-gke.16"

nodePools[i].cpus

Obligatorio
Mutable
Número entero
Prepropagado: 4

Es la cantidad de CPU para cada nodo en el grupo.

Ejemplo:

nodePools"
- name: "my-node-pool"
  cpus: 8

nodePools[i].memoryMB

Obligatorio
Mutable
Número entero
Prepropagado: 8192

Son los mebibytes de memoria para cada nodo en el grupo. Debe ser múltiplo de 4.

Ejemplo:

nodePools"
- name: "my-node-pool"
  memoryMB: 8192

Nota: Este campo especifica la cantidad de megabytes de memoria, no de megabytes. Un mebibyte es 2^20 y es igual a 1,048,576 bytes. Un megabyte es 10^6 y es igual a 1,000,000 bytes.

nodePools[i].replicas

Obligatorio
Mutable
Número entero
Prepropagado: 3
Valores posibles: La cantidad total de nodos sin taints en todos los grupos de nodos del clúster debe ser al menos 3.

Es la cantidad de nodos del grupo.

Ejemplo:

nodePools:
- name: "my-node-pool"
  replicas: 5

nodePools[i].bootDiskSizeGB

Mutable
Número entero
Prepropagado: 40
Predeterminado: 40

El tamaño del disco de arranque en gigabytes por cada nodo del grupo.

Ejemplo:

nodePools
- name: "my-node-pool"
  bootDiskSizeGB: 40

nodePools[i].osImageType

Cadena
mutable
Valores posibles: “ubuntu_containerd”, “cos”, “ubuntu_cgv2”, “cos_cgv2” y “windows”
Prepropagado: “ubuntu_cgv2”
Configuración predeterminada: “ubuntu_containerd”

El tipo de imagen de SO que se ejecutará en las VM del grupo de nodos.

Ejemplo:

nodePools
- name: "my-node-pool"
  osImageType: "ubuntu_cgv2"

nodePools[i].osImage

Obligatorio si nodePools[i].osImageType = windows
Mutable
Cadena

El nombre de una plantilla de VM de Windows. La plantilla debe basarse en una imagen ISO de Windows Server 2019 que tenga la etiqueta de idioma o región en-US.

Si deseas obtener más información, consulta la guía del usuario para grupos de nodos del SO de Windows Server.

nodePools[i].labels

Asignación
mutable

Etiquetas para aplicar a cada objeto de nodo de Kubernetes en el grupo.

Ejemplo:

nodePools:
- name: "my-node-pool"
  labels:
    environment: "production"
    tier: "cache"

Por motivos de seguridad, kubelet no puede aplicarse etiquetas en ciertos espacios de nombres.

Los espacios de nombres de etiquetas de nodos reservados son kubernetes.io, k8s.io y googleapis.com.

nodePools[i].taints

Mutable
Array de objetos, cada uno de los cuales describe un taint de Kubernetes que se aplica a cada nodo del grupo. Los taints son pares clave-valor asociados con un effect. Los taints se usan con tolerancias para la programación de Pods. Especifica una de las siguientes opciones para effect: NoSchedule, PreferNoSchedule, NoExecute.

Ejemplo:

nodePools:
- name: "my-node-pool"
  taints:
  - key: "staging"
    value: "true"
    effect: "NoSchedule"

nodePools[i].vsphere.datastore

Mutable
Cadena
Predeterminado: El valor de vCenter.datastore

El nombre del almacén de datos de vCenter en el que se crearán los nodos.

Ejemplo:

nodePools:
- name: "my-node-pool"
  vsphere:
    datastore: "my-datastore"

Si especificas un valor para este campo, no especifiques un valor para nodePools[i].vsphere.storagePolicyName.

nodePools[i].vsphere.storagePolicyName

Mutable
Cadena
Predeterminado: El valor de vCenter.storagePolicyName

Es el nombre de una política de almacenamiento de VM para los nodos del grupo.

Para obtener más información, consulta Configura una política de almacenamiento.

Ejemplo:

nodePools:
- name: "my-node-pool"
  vsphere:
    storagePolicyName: "my-storage-policy"

Si especificas un valor para este campo, no especifiques un valor para nodePools[i].vsphere.datastore.

nodePools[i].vsphere.hostgroups

Completa esta sección si deseas configurar tu clúster para que use la afinidad de VM-host.


Array mutable de cadenas, cada una de las cuales es el nombre de un grupo de DRS de host.

El array puede tener solo un elemento.

Ejemplo:

nodePools:
- name: "my-node-pool"
  vsphere:
    hostgroups:
    - "my-hostgroup"

nodePools[i].vsphere.tags

Mutable
Array de objetos, cada uno de los cuales describe una etiqueta de vSphere para colocar en las VMs en el grupo de nodos.

Cada etiqueta tiene una categoría y un nombre.

Ejemplo:

nodePools:
- name: "my-node-pool"
  vsphere:
    tags:
    - category: "purpose"
      name: "testing"

Si deseas adjuntar etiquetas a todas las VM en un grupo de nodos, tu cuenta de usuario de vCenter debe tener estos privilegios de etiquetado de vSphere:

  • vSphere Tagging.Assign o Unassign vSphere Tag
  • vSphere Tagging.Assign o Unassign vSphere Tag on Object (vSphere 7)

nodePools[i].autoscaling

Mutable

Si deseas habilitar el ajuste de escala automático para el grupo de nodos, completa esta sección. De lo contrario, quita esta sección o déjala como comentario.

nodePools[i].autoscaling.minReplicas

Mutable
Número entero
Valores posibles: Mayor o igual que 1
Prepropagado: 0

La cantidad mínima de nodos que el escalador automático puede configurar para el grupo.

Ejemplo:

nodePools:
- name: "my-node-pool"
  autoscaling:
    minReplicas: 5

nodePools[i].autoscaling.maxReplicas

Mutable
Número entero
Prepropagado: 0

La cantidad máxima de nodos que el escalador automático puede configurar para el grupo.

Ejemplo:

nodePools:
- name: "my-node-pool"
  autoscaling:
    maxReplicas: 10

nodePools[i].enableLoadBalancer

Es relevante si loadBalancer.kind = "MetalLB"
Mutable
Booleano
Prepropagado: verdadero
Predeterminado: falso

Configúralo como true si deseas permitir que la bocina de MetalLB se ejecute en los nodos del grupo. De lo contrario, configúralo como false.

Para obtener más información, consulta Balanceo de cargas en paquetes con MetalLB.

Ejemplo:

nodePools:
- name: "my-node-pool"
  enableLoadBalancer: true

nodePools[i].updateStrategy.rollingUpdate.maxSurge

Vista previa
Mutable
Número entero
Predeterminado: 1

Es la cantidad máxima de máquinas en el grupo de nodos que se pueden actualizar de forma simultánea durante una actualización.

nodePools:
- name: "my-node-pool"
  updateStrategy:
    rollingUpdate:
      maxSurge: 3

antiAffinityGroups.enabled

Mutable
Booleano
Prepropagado: verdadero
Predeterminado: verdadero

Si este campo es true, Google Distributed Cloud crea reglas de antiafinidad de Distributed Resource Scheduler (DRS) de VMware para los nodos del clúster de usuario, lo que hace que se distribuyan en al menos tres hosts ESXi físicos en tu centro de datos.

Para esta función, se requiere que el entorno de vSphere cumpla con las siguientes condiciones:

  • DRS de VMware debe estar habilitado. Para DRS de VMware, se requiere la edición de licencia vSphere Enterprise Plus.

  • La cuenta de usuario de vSphere debe tener el privilegio Host.Inventory.Modify cluster.

  • Debe haber al menos cuatro hosts ESXi disponibles.

Aunque la regla requiere que los nodos del clúster se distribuyan en tres hosts ESXi, te recomendamos que tengas al menos cuatro hosts ESXi disponibles.

Recuerda que si tienes una licencia de vSphere Standard, no puedes habilitar DRS de VMware.

Si no tienes DRS habilitado o no tienes al menos tres hosts en los que se puedan programar las VM de vSphere, configura antiAffinityGroups.enabled como false.

Ejemplo:

antiAffinityGroups:
  enabled: false

enableVMTracking

Vista previa
Inmutable
Prepropagado: falso

Configúralo como true para habilitar el seguimiento de VM con etiquetas de vSphere. De lo contrario, configúralo como false.

Para obtener más información, consulta Habilita el seguimiento de VM.

Ejemplo:

enableVMTracking: true

nodePoolUpdatePolicy.maximumConcurrentNodePoolUpdate

Mutable
Número entero
Valores posibles: 0 o 1
Prepropagado: 0 Valor predeterminado: TODO: REVISORES: ¿TIENE UN VALOR PREDETERMINADO?

Es la cantidad de grupos de nodos que se actualizarán a la vez. Un valor de 1 especifica que se puede actualizar un grupo de nodos a la vez. Un valor de 0 especifica que se puede actualizar una cantidad ilimitada de grupos de nodos a la vez.

Ejemplo:

nodePoolUpdatePolicy:
  maximumConcurrentNodePoolUpdate: 1

nodePoolUpdatePolicy.updateStrategy.rollingUpdate.maxSurge

Vista previa
Mutable
Número entero
Predeterminado: 1

Es la cantidad máxima de máquinas en un grupo de nodos que se pueden actualizar de forma simultánea durante una actualización. Se aplica a cualquier grupo de nodos que no especifique su propia estrategia de actualización.

nodePools:
- name: "my-node-pool"
  updateStrategy:
    rollingUpdate:
      maxSurge: 3

authentication

En esta sección, se conserva la información sobre cómo se autentican y autorizan los usuarios del clúster.

authentication.oidc

No uses esta sección. En su lugar, después de la creación del clúster, edita el recurso personalizado ClientConfig como se describe en Configura clústeres para Anthos Identity Service con OIDC.

authentication.sni

Si deseas proporcionar un certificado de entrega adicional para el servidor de la API de Kubernetes del clúster, completa esta sección. De lo contrario, quita esta sección o déjala como comentario.

authentication.sni.certPath

String

Es la ruta a un certificado de entrega para el servidor de API de Kubernetes.

Ejemplo:

authentication:
  sni:
    certPath: "my-cert-folder/example.com.crt"

authentication.sni.keyPath

Opcional
Cadena

Es la ruta de acceso del archivo de claves privadas del certificado.

Ejemplo:

authentication:
  sni:
    keyPath: "my-cert-folder/example.com.key"

gkeConnect

Obligatorio
Inmutable

En esta sección, se incluye información sobre el proyecto y la cuenta de servicio de Google Cloud que deseas usar pararegistrar tu clústeren una flota de Google Cloud .

gkeConnect.projectID

Obligatorio
Cadena
Inmutable

El ID del proyecto host de tu flota. En el caso de los clústeres nuevos, este ID de proyecto debe ser el mismo que el ID establecido en stackdriver.projectID y cloudAuditLogging.projectID. Si los IDs de proyecto no son los mismos, la creación del clúster fallará. Este requisito no se aplica a los clústeres existentes.

Ejemplo:

gkeConnect:
  projectID: "my-fleet-host-project"

gkeConnect.location

Inmutable
Cadena
Predeterminado: global

El servicio de la flota (gkehub.googleapis.com) y el servicio de Connect (gkeconnect.googleapis.com) administran la membresía de la flota de cada clúster. La ubicación de los servicios puede ser global o regional. En la versión 1.28 y versiones posteriores, puedes especificar de manera opcional la región de Google Clouden la que se ejecutan los servicios de Fleet y Connect. Si no se especifica, se usan las instancias globales de los servicios. Ten en cuenta lo siguiente:

  • Los clústeres de usuario creados antes de la versión 1.28 son administrados por los servicios globales de la flota y de Connect.

  • Los clústeres nuevos creados con los clientes de la API de GKE On-Prem (la consola de Google Cloud , Google Cloud CLI o Terraform) usan la misma región que especificas para la API de GKE On-Prem.

  • En el caso de los clústeres nuevos, si incluyes este campo, la región que especifiques debe ser la misma que la región configurada en cloudAuditLogging.clusterLocation, stackdriver.clusterLocation y gkeOnPremAPI.location. Si las regiones no son las mismas, la creación del clúster fallará.

Ejemplo:

gkeConnect:
  location: "us-central1"

gkeConnect.registerServiceAccountKeyPath

Obligatorio
Cadena
Mutable

Es la ruta del archivo de claves JSON para tu cuenta de servicio de registro de conexión.

Para actualizar el valor de este campo, usa gkectl update cluster.

Si deseas obtener información para cambiar la clave de tu cuenta de servicio del registro de conexión, consulta Rota las claves de cuenta de servicio.

Ejemplo:

gkeConnect:
  registerServiceAccountKeyPath: "my-key-folder/connect-register-key.json"

gkeConnect.registerServiceAccountKey.secretRef.version

Mutable
Cadena
Valores posibles: Una cadena de número entero o “la más reciente”
Valor predeterminado: “la más reciente”

Es la versión de un Secret preparado en el clúster de administrador que contiene una clave JSON para tu cuenta de servicio de registro de conexión.

Ejemplo:

gkeConnect:
  registerServiceAccountKey:
    secretRef:
      version: "1"

gkeOnPremAPI

En la versión 1.16 y versiones posteriores, si la API de GKE On-Prem está habilitada en tu proyecto deGoogle Cloud , todos los clústeres del proyecto se inscriben en la API de GKE On-Prem automáticamente en la región configurada en stackdriver.clusterLocation.

  • Si deseas inscribir todos los clústeres del proyecto en la API de GKE On-Prem, asegúrate de seguir los pasos que se indican en Antes de comenzar para activar y usar la API de GKE On-Prem en el proyecto.

  • Si no deseas inscribir el clúster en la API de GKE On-Prem, incluye esta sección y configura gkeOnPremAPI.enabled como false. Si no deseas inscribir ningún clúster en el proyecto, inhabilita gkeonprem.googleapis.com (el nombre del servicio para la API de GKE On-Prem) en el proyecto. Para obtener instrucciones, consulta Inhabilita servicios.

Inscribir tu clúster de usuario en la API de GKE On-Prem te permite usar las herramientas estándar (la consola de Google Cloud , Google Cloud CLI y Terraform) para administrar el ciclo de vida del clúster. Además, inscribir el clúster te permite usar la consola o gcloud CLI para ver los detalles del clúster. Por ejemplo, puedes ejecutar comandos gcloud para obtener información sobre el clúster de usuario.

Después de agregar esta sección y crear o actualizar el clúster, si posteriormente quitas la sección y actualizas el clúster, la actualización fallará.

gkeOnPremAPI.enabled

Mutable
Booleano
Predeterminado: true

De forma predeterminada, el clúster se inscribe en la API de GKE On-Prem si esta API está habilitada en tu proyecto. Establece false si no deseas inscribir el clúster.

Después de que el clúster se inscriba en la API de GKE On-Prem, si necesitas dar de baja el clúster, realiza el siguiente cambio y, luego, actualízalo:

gkeOnPremAPI:
  enabled: false

gkeOnPremAPI.location

Inmutable
Cadena
Predeterminado: stackdriver.clusterLocation

La región de Google Cloud en la que se ejecuta la API de GKE On-Prem y se almacenan los metadatos del clúster. Elige una de las regiones admitidas. Debes usar la misma región que se configuró en gkeConnect.location, stackdriver.clusterLocation y cloudAuditLogging.clusterLocation. Si gkeOnPremAPI.enabled es false, no incluyas este campo.

stackdriver

Obligatorio de forma predeterminada
Mutable

Si deseas habilitar Cloud Logging y Cloud Monitoring para tu clúster, completa esta sección. De lo contrario, quita esta sección o déjala como comentario.

Esta sección es obligatoria de forma predeterminada. Es decir, si no incluyes esta sección, debes incluir la marca --skip-validation-stackdriver cuando ejecutes gkectl create cluster.

Esta sección es obligatoria si deseas administrar el ciclo de vida del clúster de usuario con clientes de la API de GKE On-Prem.

stackdriver.projectID

Obligatorio para Logging y Monitoring
Cadena
Inmutable

El ID del proyecto host de tu flota. En el caso de los clústeres nuevos, este ID de proyecto debe ser el mismo que el ID establecido en gkeConnect.projectID y cloudAuditLogging.projectID. Si los IDs de proyecto no son los mismos, la creación del clúster fallará. Este requisito no se aplica a los clústeres existentes.

Si es necesario, puedes configurar un router de registros en este proyecto para enrutar los registros a buckets de registros en otro proyecto. Para obtener información sobre cómo configurar el router de registros, consulta Destinos compatibles.

Ejemplo:

stackdriver:
  projectID: "my-fleet-host-project"

stackdriver.clusterLocation

Obligatorio para Logging y Monitoring
Inmutable
Cadena
Prepropagado: “us-central1”

Es la región de Google Cloud en la que deseas almacenar los registros. Te recomendamos que elijas una región cercana a tu centro de datos local.

En el caso de los clústeres nuevos, si incluyes las secciones gkeOnPremAPI y cloudAuditLogging en el archivo de configuración, la región que establezcas aquí debe ser la misma que establezcas en gkeConnect.location, gkeOnPremAPI.location y cloudAuditLogging.clusterLocation. Si las regiones no son las mismas, la creación del clúster fallará.

Ejemplo:

stackdriver:
  clusterLocation: "us-central1"

stackdriver.enableVPC

Inmutable
Booleano
Prepropagado: falso

Si la red del clúster está controlada por una VPC, establece este campo en true. Esto garantiza que toda la telemetría fluya a través de las direcciones IP restringidas de Google. De lo contrario, configúralo como false.

Ejemplo:

stackdriver:
  enableVPC: false

stackdriver.serviceAccountKeyPath

Obligatorio para Logging y Monitoring
Mutable
Cadena

Es la ruta del archivo de claves JSON para la cuenta de servicio de supervisión y registro.

Para actualizar el valor de este campo, usa gkectl update cluster.

Si deseas obtener información para cambiar la clave de tu cuenta de servicio de supervisión de registros, consulta Rota claves de cuentas de servicio.

Ejemplo:

stackdriver:
  serviceAccountKeyPath: "my-key-folder/log-mon-key.json"

stackdriver.serviceAccountKey.secretRef.version

Mutable
Cadena
Valores posibles: Una cadena de número entero o “la más reciente”
Valor predeterminado: “la más reciente”

Es la versión de un Secret preparado en el clúster de administrador que contiene una clave JSON para tu cuenta de servicio de supervisión de registros.

Ejemplo:

stackdriver:
  serviceAccountKey:
    secretRef:
      version: "1"

stackdriver.disableVsphereResourceMetrics

Mutable
Booleano
Prepropagado: falso
Predeterminado: falso

Configúralo como true para inhabilitar la recopilación de métricas de vSphere. De lo contrario, configúralo como false.

Ejemplo:

stackdriver:
  disableVsphereResourceMetrics: true

usageMetering

Vista previa
Inmutable

Si deseas habilitar la medición de uso para tu clúster, completa esta sección. De lo contrario, quita esta sección o déjala como comentario.

usageMetering.bigQueryProjectID

Vista previa
Obligatorio para la medición de uso
Inmutable
Cadena

Es el ID del proyecto de Google Cloud en el que deseas almacenar datos de medición de uso.

Ejemplo:

usageMetering:
  bigQueryProjectID: "my-bq-project"

usageMetering.bigQueryDatasetID

Vista previa
Obligatorio para la medición de uso
Inmutable
Cadena

Es el ID del conjunto de datos de BigQuery en el que deseas almacenar los datos de medición de uso. Ejemplo:

usageMetering:
  bigQueryDatasetID: "my-bq-dataset"

usageMetering.bigQueryServiceAccountKeyPath

Vista previa
Obligatorio para la medición de uso
Inmutable
Cadena.

Es la ruta del archivo de claves JSON para tu cuenta de servicio de BigQuery

Para actualizar el valor de este campo, usa gkectl update cluster.

Si deseas obtener información para cambiar la clave de tu cuenta de servicio de BigQuery, consulta Rota claves de cuenta de servicio.

Ejemplo:

usageMetering:
  bigQueryServiceAccountKeyPath: "my-key-folder/bq-key.json"

usageMetering.bigQueryServiceAccountKey.secretRef.version

Mutable
Cadena
Valores posibles: Una cadena de número entero o “la más reciente”
Valor predeterminado: “la más reciente”

Es la versión de un Secret preparado en el clúster de administrador que contiene una clave JSON para tu cuenta de servicio de BigQuery.

Ejemplo:

gkeConnect:
  bigQueryServiceAccountKey:
    secretRef:
      version: "1"

usageMetering.enableConsumptionMetering

Vista previa
Obligatorio para la medición de uso
Inmutable
Booleano
Prepropagado: falso

Configúralo como true si deseas habilitar la medición basada en el consumo. De lo contrario, configúralo como falso.

Ejemplo:

usageMetering:
  enableConsumptionMetering: true

cloudAuditLogging

Si deseas integrar los registros de auditoría del servidor de la API de Kubernetes del clúster a los registros de auditoría de Cloud, completa esta sección. De lo contrario, quita esta sección o déjala como comentario.

cloudAuditLogging.projectID

Obligatorio para los registros de auditoría de Cloud
Inmutable
Cadena

El ID del proyecto host de tu flota. En el caso de los clústeres nuevos, este ID de proyecto debe ser el mismo que el ID establecido en gkeConnect.projecID y stackdriver.projectID. Si los IDs de proyecto no son los mismos, la creación del clúster fallará. Este requisito no se aplica a los clústeres existentes.

Si es necesario, puedes configurar un router de registros en este proyecto para enrutar los registros a buckets de registros en otro proyecto. Para obtener información sobre cómo configurar el router de registros, consulta Destinos compatibles.

Ejemplo:

cloudAuditLogging:
  projectID: "my-fleet-host-project"

cloudAuditLogging.clusterLocation

Obligatorio para los registros de auditoría de Cloud
Cadena
Inmutable

La región de Google Cloud en la que deseas almacenar los registros de auditoría. Te recomendamos que elijas una región cercana a tu centro de datos local.

En el caso de los clústeres nuevos, si incluyes las secciones gkeOnPremAPI y stackdriver en el archivo de configuración, la región que establezcas aquí debe ser la misma que establezcas en gkeConnect.location, gkeOnPremAPI.location y stackdriver.clusterLocation. Si las regiones no son las mismas, la creación del clúster fallará.

Ejemplo:

cloudAuditLogging:
  clusterLocation: "us-central1"

cloudAuditLogging.serviceAccountKeyPath

Obligatorio para los registros de auditoría de Cloud
Mutable
Cadena

Es la ruta de acceso del archivo de claves JSON para la cuenta de servicio de registro y auditoría.

Para actualizar el valor de este campo, usa gkectl update cluster.

Si deseas obtener información para cambiar la clave de tu cuenta de servicio de registro de auditoría, consulta Rota claves de cuentas de servicio.

Ejemplo:

cloudAuditLogging:
  serviceAccountKeyPath: "my-key-folder/audit-log-key.json"

cloudAuditLogging.serviceAccountKey.secretRef.version

Mutable
Cadena
Valores posibles: Una cadena de número entero o “la más reciente”
Valor predeterminado: “la más reciente”

Es la versión de un Secret preparado en el clúster de administrador que contiene una clave JSON para tu cuenta de servicio de registro de auditoría.

Ejemplo:

cloudAuditLogging:
  serviceAccountKey:
    secretRef:
      version: "1"

autoRepair.enabled

Opcional
Mutable
Booleano
Prepropagado: verdadero

Configúralo como true para habilitar la reparación automática de nodos. De lo contrario, configúralo como false.

Ejemplo:

autoRepair:
  enabled: true

secretsEncryption

Si deseas encriptar Secretos sin la necesidad de tener un KMS externo (servicio de administración de claves) o cualquier otra dependencia, completa esta sección. De lo contrario, quita esta sección o déjala como comentario.

secretsEncryption.mode

Obligatorio para la encriptación de Secrets
Inmutable
Cadena
Cadena posible: "GeneratedKey"
Prepropagado: "GeneratedKey"

El modo de encriptación de Secret.

secretsEncryption:
  mode: "GeneratedKey"

secretsEncryption.generatedKey.keyVersion

Obligatorio para la encriptación de Secrets
Mutable
Número entero
Prepropagado: 1

Un número entero que elijas para el número de versión de la clave. Te recomendamos que comiences con 1.

Si deseas obtener información para actualizar este campo para un clúster existente, consulta Encriptación de secretos siempre activados.

Ejemplo:

secretsEncryption:
  generatedKey:
    keyVersion: 1

secretsEncryption.generatedKey.disabled

Mutable
Booleano
Prepropagado: falso

Configúralo como true para inhabilitar la encriptación de Secrets. De lo contrario, configúralo como false.

Si deseas obtener información para actualizar este campo para un clúster existente, consulta Encriptación de secretos siempre activados.

Ejemplo:

secretsEncryption:
  generatedKey:
    disabled: false