Configura dominios de topología

Los dominios de topología en el software de Google Distributed Cloud solo para VMware te permiten distribuir Pods en grupos de nodos que comparten un riesgo de falla correlacionada, como nodos en diferentes bastidores o servidores de vCenter. Distribuir los Pods de esta manera ayuda a que tus cargas de trabajo sigan disponibles cuando falla el hardware o el software. En este documento, se explica cómo funcionan los dominios de topología y se proporcionan lineamientos para configurarlos.

Para configurar un dominio de topología, debes habilitar el clúster avanzado.

Descripción general

Un dominio de topología es un grupo de nodos de clúster que se consideran parte de la misma agrupación lógica o física, como un campus o un centro de datos. Un dominio de topología debe corresponder a algún hardware o software subyacente que tenga alguna posibilidad de falla correlacionada. Por ejemplo:

  • Falla de software, como diferentes servidores de vCenter
  • Fallas de hardware, como diferentes bastidores, fuentes de alimentación y edificios

En Google Distributed Cloud solo de software para VMware, como parte de la configuración de un dominio de topología cuando creas un clúster, defines una etiqueta de topología. Después de crear el clúster, la etiqueta de topología se propaga a las etiquetas de los nodos en el dominio de topología.

Para usar un dominio de topología, tienes las siguientes opciones:

  • Versión 1.32 y posteriores: Configura restricciones de distribución de topología predeterminadas a nivel del clúster. Para obtener más información, consulta schedulerConfiguration.

  • Usa la restricción predeterminada a nivel del clúster de Kubernetes, "topology.kubernetes.io/zone", como la clave en la etiqueta de topología. Para obtener más información, consulta Restricciones predeterminadas integradas.

  • Configura el PodTemplate en tu Deployment, StatefulSet o ReplicaSet, según corresponda, con la clave de etiqueta de topología. En la especificación del Pod, usa la clave en la etiqueta de topología como el valor del campo topologySpreadConstraints.topologyKey. Esta clave permite que el programador de Kubernetes distribuya los Pods en el dominio de topología para garantizar la alta disponibilidad y evitar la concentración excesiva en cualquier área en caso de falla. Para obtener más información sobre cómo configurar topologySpreadConstraints en la especificación de tu Pod, consulta Restricciones de distribución de la topología de Pod en la documentación de Kubernetes.

Ejemplo de etiquetas de dominio de topología

Supongamos que creas los siguientes tres dominios de topología cuando creas un clúster de usuario:

...
topologyDomains:
- name: "topology-domain-1"
  topologyLabels:
    "topology.examplepetstore.com/zone": "zone-1"
...
...
topologyDomains:
- name: "topology-domain-2"
  topologyLabels:
    "topology.examplepetstore.com/zone": "zone-2"
...
...
topologyDomains:
- name: "topology-domain-3"
  topologyLabels:
    "topology.examplepetstore.com/zone": "zone-3"
...

Después de crear el clúster, actualiza la especificación del Pod, por ejemplo:

...
topologySpreadConstraints:
  topologyKey: "topology.examplepetstore.com/zone"
...

A grandes rasgos, el programador de Kubernetes usa topology.examplepetstore.com/zone para separar los nodos del clúster en diferentes grupos: zone-1, zone-2 y zone-3. Luego, el programador distribuye los Pods en estos tres grupos de nodos.

Lineamientos para configurar dominios de topología

Para garantizar que el programador de Kubernetes use de forma eficaz todos los recursos del clúster, te recomendamos que sigas estos lineamientos:

  • Los dominios de topología deben estar equilibrados. Debes proporcionar cantidades casi iguales de capacidad de CPU y RAM en cada dominio de topología.
  • Proporciona al menos dos y, preferiblemente, tres dominios de topología.
  • No distribuyas por más de una clave de topología.
  • Los nodos deben tener un tamaño similar en cada dominio de topología.
  • Si usas tolerancias y taints para separar las cargas de trabajo dentro de un clúster, cada grupo de nodos debe cumplir con los requisitos anteriores.

Si no se cumplen estos lineamientos, el programador intentará usar la capacidad total del clúster, pero es posible que tarde más en programar los Pods y que no todos los Pods obtengan el comportamiento de distribución esperado.

Limitaciones

No puedes usar gkectl get-config para generar archivos de configuración desde clústeres que usan dominios de topología. Esta limitación se aplica al clúster de administrador y a todos los clústeres de usuario que administra. Conserva los archivos de configuración que usas para crear y actualizar estos clústeres, incluido el archivo de configuración de la infraestructura de vSphere y los archivos de bloque de IP. Usa estos archivos como la fuente de información para la configuración de tu clúster.

¿Qué sigue?