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.

Provisionamiento de Clústeres de Kubernetes en VMware vSphere

En esta sección, aprenderás a utilizar Rancher para desplegar un RKE2 o K3s clúster de Kubernetes en VMware vSphere.

Primero, configuras tus credenciales de nube de vSphere en Rancher.

Luego, creas un clúster de vSphere en Rancher, y al configurar el nuevo clúster, defines grupos de máquinas para él. Cada grupo de máquinas tiene un rol de Kubernetes de etcd, controlplane o worker. Rancher instala Kubernetes en los nuevos nodos y configura cada nodo con el rol de Kubernetes definido por el grupo de máquinas.

Preparación en VMware vSphere

Esta sección describe los requisitos para configurar vSphere de manera que Rancher pueda aprovisionar VMs y clústeres.

Crear Credenciales en VMware vSphere

Antes de proceder a crear un clúster, debes asegurarte de que tienes un usuario de vSphere con permisos suficientes.

Consulta esta guía de instrucciones para obtener instrucciones sobre cómo crear un usuario en vSphere con los permisos requeridos. Estos pasos resultan en un nombre de usuario y una contraseña que deberás proporcionar a Rancher, lo que permite a Rancher aprovisionar recursos en vSphere.

Permisos de Red

Se debe asegurar que los hosts que ejecutan el servidor Rancher puedan establecer las siguientes conexiones de red:

  • Hacia la API de vSphere en el servidor vCenter (normalmente puerto 443/TCP).

  • Hacia la API del Host (puerto 443/TCP) en todos los hosts ESXi utilizados para instanciar máquinas virtuales para los clústeres (solo requerido al usar el método de creación ISO).

  • Hacia el puerto 22/TCP y 2376/TCP en las VMs creadas

Consulta Requisitos de Red de Nodos para una lista detallada de los requisitos de puertos aplicables para crear nodos en un proveedor de infraestructura.

Licencia ESXi válida para el acceso a la API de VMware vSphere

La licencia gratuita de ESXi no soporta el acceso a la API. Los servidores de vSphere deben tener una licencia ESXi válida o de evaluación.

Reglas de Afinidad VM-VM para Clústeres con DRS

Si tienes un clúster con DRS habilitado, se recomienda configurar Reglas de Afinidad VM-VM. Estas reglas permiten que las VMs asignadas a los roles etcd y control-plane operen en hosts ESXi separados cuando están asignadas a diferentes grupos de nodos. Esta práctica asegura que la falla de una única máquina física no afecte la disponibilidad de esos planos.

Creando un Clúster de VMware vSphere

1. Crea tus credenciales de nube

  1. Haz clic en ☰ > Gestión de Clústeres.

  2. Haz clic en Credenciales de Nube.

  3. Haga clic en Crear.

  4. Haz clic en VMware vSphere.

  5. Introduce tus credenciales de vSphere. Para ayuda, consulta Acceso a la Cuenta en la referencia de configuración de plantilla de nodo.

  6. Haga clic en Crear.

Resultado: Has creado las credenciales de la nube que se utilizan para aprovisionar nodos en tu clúster.

2. Crea tu clúster

Utiliza Rancher para crear un clúster de Kubernetes en vSphere.

  1. En la esquina superior izquierda, haz clic en ☰ > Gestión de Clústeres.

  2. En la página Clústeres, haz clic en Crear.

  3. Haz clic en VMware vSphere.

  4. Introduce un Nombre del Clúster y utiliza tus credenciales de nube de vSphere.

  5. Crea un grupo de máquinas para cada rol de Kubernetes. Consulta las mejores prácticas para recomendaciones sobre asignaciones y conteos de roles.

    1. Para cada grupo de máquinas, define la configuración de la máquina.

  6. Utiliza la Configuración del Clúster para elegir la versión de Kubernetes que deseas instalar, qué proveedor de red utilizar y si deseas habilitar el aislamiento de red del proyecto. Para ayuda configurando el clúster, consulta las referencias de configuración de clúster RKE2 y K3s.

  7. Utiliza Roles de Miembro para configurar la autorización de usuarios para el clúster. Haz clic en Añadir Miembro para agregar usuarios que puedan acceder al clúster. Utiliza el menú desplegable Rol para establecer permisos para cada usuario.

  8. Si deseas aprovisionar dinámicamente almacenamiento persistente u otra infraestructura más adelante, necesitarás habilitar el proveedor de nube vSphere modificando el archivo YAML del clúster. Para más detalles, consulta la documentación del proveedor de nube vSphere en árbol y la documentación del proveedor de nube vSphere fuera de árbol.

  9. Revisa tus opciones para confirmar que son correctas. Luego haz clic en Crear.

Resultado:

Tu clúster ha sido creado y se le ha asignado un estado de Aprovisionamiento. Rancher está configurando tu clúster.

Puedes acceder a tu clúster una vez que su estado se actualice a Activo.

Los clústeres Activos tienen asignados dos proyectos:

  • Default, que contiene el espacio de nombres default

  • System, que contiene los espacios de nombres cattle-system, traefik, kube-public y kube-system

Pasos siguientes opcionales

Después de crear tu clúster, puedes acceder a él a través de la interfaz de usuario de Rancher. Como mejor práctica, recomendamos configurar estas formas alternativas de acceder a tu clúster:

  • Accede a tu clúster con la CLI de kubectl: Sigue estos pasos para acceder a clústeres con kubectl en tu estación de trabajo. En este caso, serás autenticado a través del proxy de autenticación del servidor de Rancher, luego Rancher te conectará al clúster descendente. Este método te permite gestionar el clúster sin la interfaz de usuario de Rancher.

  • Accede a tu clúster con la CLI de kubectl, utilizando el punto final autorizado del clúster: Sigue estos pasos para acceder a tu clúster con kubectl directamente, sin autenticarte a través de Rancher. Recomendamos configurar este método alternativo para acceder a tu clúster, de modo que en caso de que no puedas conectarte a Rancher, aún puedas acceder al clúster.

  • Provisión de almacenamiento: Para un ejemplo de cómo aprovisionar almacenamiento en vSphere utilizando Rancher, consulta esta sección. Para aprovisionar almacenamiento de forma dinámica en vSphere, el proveedor de vSphere debe estar habilitado. Para más detalles, consulta la documentación del proveedor de nube vSphere en árbol y la documentación del proveedor de nube vSphere fuera de árbol.