Este documento ha sido traducido utilizando tecnología de traducción automática. Si bien nos esforzamos por proporcionar traducciones precisas, no ofrecemos garantías sobre la integridad, precisión o confiabilidad del contenido traducido. En caso de discrepancia, la versión original en inglés prevalecerá y constituirá el texto autorizado.

Controlador de Nodo Harvester

El Controlador de Nodo Harvester, similar al controlador de Docker Machine, se utiliza para aprovisionar VMs en el clúster SUSE Virtualization, y Rancher lo utiliza para lanzar y gestionar clústeres de Kubernetes.

Un beneficio de instalar Kubernetes en grupos de nodos alojados por el controlador de nodos es que si un nodo pierde conectividad con el clúster, Rancher puede crear automáticamente otro nodo para unirse al clúster y asegurar que el número del grupo de nodos sea el esperado. Además, el controlador de nodo Harvester está integrado con el proveedor de nube Harvester por defecto, proporcionando soporte de balanceador de carga integrado así como passthrough de almacenamiento desde el clúster de equipo sin sistema operativo a los clústeres de Kubernetes invitados para obtener un rendimiento de almacenamiento nativo.

En esta sección, aprenderás a configurar Rancher para utilizar el Controlador de Nodo Harvester para lanzar y gestionar clústeres de Kubernetes.

El Controlador de Nodo Harvester solo admite imágenes de nube. Esto se debe a que las imágenes ISO suelen requerir configuración adicional que interfiere con un despliegue limpio (sin requerir intervención del usuario), y no se utilizan típicamente en entornos de nube.

Controlador de Nodo Harvester

A partir de Rancher v2.6.3, el Controlador de Nodo Harvester está habilitado por defecto. Puedes ir a la página Gestión de Clústeres > Controladores > Controladores de Nodos para comprobar el estado del Controlador de Nodo Harvester.

edit-node-driver

Cuando el Controlador de Nodo Harvester está habilitado, puedes crear clústeres de Kubernetes sobre el clúster SUSE Virtualization y gestionarlos desde Rancher.

harvester-node-driver

  • Consulta la Rancher matriz de soporte de clústeres en sentido descendente para sus versiones RKE2 soportadas y versiones de SO invitado.

  • Los cambios realizados en la configuración del Controlador de Nodo Harvester no se persisten. Cualquier modificación aplicada se restablecerá al reiniciar el contenedor Rancher.

  • A partir de la versión 0.6.3 del Controlador de Nodo Harvester, la inyección automática del qemu-guest-agent ha sido eliminada del backend. Si la imagen que estás utilizando no contiene el paquete qemu-guest-agent, aún puedes instalarlo a través de la configuración userdata. De lo contrario, el clúster no se aprovisionará con éxito.

     #cloud-config
 package_update: true
 packages:
 - qemu-guest-agent
 runcmd:
 - - systemctl
   - enable
   - '--now'
   - qemu-guest-agent.service

Problemas conocidos

Rancher pierde la capacidad de gestionar o escalar clústeres invitados cuando los tokens API correspondientes expiran.

Problema: #5827

Descripción: Rancher utiliza kubeconfigs con tokens de autenticación incrustados para aprovisionar clústeres de Kubernetes invitados en SUSE Virtualization. Cuando estos tokens expiran, Rancher pierde la capacidad de realizar operaciones de gestión para el clúster de Kubernetes invitado correspondiente gestionado por Rancher. Este problema afecta únicamente a los clústeres de Kubernetes invitados que se ejecutan en SUSE Virtualization y utilizan credenciales en la nube creadas después de instalar o actualizar a Rancher v2.8.x, que redujo la configuración de kubeconfig-default-token-ttl-minutes así como la configuración de auth-token-max-ttl-minutes a 30 días y 90 días respectivamente.

Estado: Hay una solución temporal disponible.

Última actualización: 2024-05-21

RKE2 Kubernetes cluster

Ver Creando un clúster de Kubernetes RKE2.

K3s Kubernetes cluster

Ver Creando un clúster de Kubernetes K3s.

Restricciones de distribución de topología

Dentro de tu clúster de Kubernetes invitado, puedes usar restricciones de distribución de topología para gestionar cómo se distribuyen las cargas de trabajo entre los nodos, teniendo en cuenta factores como dominios de fallo como regiones y zonas. Esto ayuda a lograr alta disponibilidad y una utilización eficiente de los recursos del clúster SUSE Virtualization.

Para versiones de RKE2 anteriores a v1.25.x, las versiones mínimas requeridas para soportar la función de sincronización de etiquetas de topología son las siguientes:

Versión mínima requerida de RKE2

>= v1.24.3+rke2r1

>= v1.23.9+rke2r1

>= v1.22.12+rke2r1

Además, para la instalación personalizada, la versión del Proveedor de Nube Harvester debe ser >= v0.1.4.

Sincroniza las etiquetas de topología con el nodo del clúster invitado.

Durante la instalación del clúster, el Controlador de Nodo Harvester ayudará automáticamente a sincronizar las etiquetas de topología desde los nodos de VM a los nodos del clúster invitado. Actualmente, solo se admiten las etiquetas de topología region y zone.

  1. Configura las etiquetas de topología en los nodos SUSE Virtualization en la página Anfitriones > Editar configuración > Etiquetas. Por ejemplo, añade las etiquetas de topología de la siguiente manera:

    topology.kubernetes.io/region: us-east-1
topology.kubernetes.io/zone: us-east-1a
    node add affinity labels

  2. Crea un clúster RKE2 en sentido descendente utilizando el controlador de nodo Harvester con el proveedor de nube Harvester habilitado. Recomendamos añadir las reglas de afinidad de nodos, que evitan que los nodos se desplacen a otras zonas después de la reconstrucción de la VM.

    create rke2 harvester cluster 3

  3. Una vez que el clúster esté listo, confirma que esas etiquetas de topología se hayan sincronizado correctamente con los nodos en el clúster Kubernetes invitado.

  4. Ahora despliega cargas de trabajo en tu clúster Kubernetes invitado, y deberías poder gestionarlas utilizando las restricciones de distribución de topología.

Para el Proveedor de Nube Harvester >= v0.2.0, las etiquetas de topología en el nodo SUSE Virtualization se volverán a sincronizar automáticamente cuando una VM (correspondiente al nodo invitado) sufra migración o actualización.

Para el Proveedor de Nube Harvester < v0.2.0, la sincronización de etiquetas solo ocurrirá durante la inicialización de los nodos invitados. Para evitar que los nodos se desplacen a diferentes regiones o zonas, recomendamos añadir reglas de afinidad de nodos durante el aprovisionamiento del clúster. Esto te permitirá programar VMs en la misma zona incluso después de la reconstrucción.