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.

Lanzando Kubernetes en Nodos Personalizados Existentes

Cuando creáis un clúster personalizado, Rancher puede utilizar RKE2/K3s para crear un clúster de Kubernetes en servidores de equipo sin sistema operativo locales, máquinas virtuales locales o en cualquier nodo alojado por un proveedor de infraestructura.

Para utilizar esta opción, necesitáis acceso a los servidores que formarán parte de vuestro clúster de Kubernetes. Aprovisionad cada servidor de acuerdo con los requisitos. Luego, ejecutad el comando proporcionado en la interfaz de usuario de Rancher en cada servidor para convertirlo en un nodo de Kubernetes.

Esta sección describe cómo configurar un clúster personalizado.

Creando un Clúster con Nodos Personalizados

¿Queréis utilizar hosts Windows como trabajadores de Kubernetes?

Consultad Configuración de Clústeres Personalizados para Windows antes de empezar.

1. Aprovisionad un Host Linux

Comenzad la creación de un clúster personalizado aprovisionando un host Linux. Vuestro host puede ser:

  • Una máquina virtual (VM) en la nube

  • Una VM local

  • Un servidor de equipo sin sistema operativo

Si deseáis reutilizar un nodo de un clúster personalizado anterior, limpiad el nodo antes de usarlo en un clúster nuevamente. Si reutilizáis un nodo que no ha sido limpiado, la provisión del clúster puede fallar.

Aprovisionad el host de acuerdo con los requisitos de instalación y la lista de verificación para clústeres listos para producción.

Clúster solo IPv6

Para un clúster solo IPv6, aseguraos de que vuestro sistema operativo configure correctamente el archivo /etc/hosts.

::1       localhost

2. Crea el Clúster Personalizado

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

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

  3. Haz clic en Personalizado.

  4. Introduce un Nombre del clúster.

  5. Utiliza la sección Configuración del Clúster para configurar el clúster. Para más información, consulta Referencia de Configuración del Clúster RKE2 y Referencia de Configuración del Clúster K3s.

    Nodos de Windows

    Para aprender más sobre el uso de nodos de Windows como trabajadores de Kubernetes, consulta Lanzando Kubernetes en Clústeres de Windows.

  6. Haga clic en Crear.

    Resultado: La interfaz redirige a la página Registro, donde puedes generar el comando de registro para tus nodos.

  7. Desde Rol del Nodo, selecciona los roles que deseas que un nodo del clúster cumpla. Debes provisionar al menos un nodo para cada rol: etcd, trabajador y plano de control. Un clúster personalizado requiere los tres roles para finalizar la provisión. Para más información sobre los roles, consulta Roles para Nodos en Clústeres de Kubernetes.

    Servidor de equipo sin sistema operativo

    Si planeáis dedicar servidores de equipo sin sistema operativo a cada rol, debéis provisionar un servidor de equipo sin sistema operativo para cada rol (es decir, provisionar múltiples servidores de equipo sin sistema operativo).

  8. Opcional: Haz clic en Mostrar Avanzado para configurar ajustes adicionales como especificar la(s) dirección(es) IP, sobrescribir el nombre del nodo o añadir etiquetas o taints al nodo.

    • Los campos IP Pública del Nodo y IP Privada del Nodo pueden aceptar ya sea una única dirección o una lista de direcciones separadas por comas (por ejemplo: 10.0.0.5,2001:db8::1).
    Clúster solo IPv6 o de doble pila

    • En clústeres tanto solo IPv6 como de doble pila, debéis especificar la dirección IPv6 del nodo como la IP Privada del Nodo.

  9. Copiad el comando mostrado en pantalla en vuestro portapapeles.

  10. Inicia sesión en tu host de Linux utilizando tu shell preferido, como PuTTy o una conexión de Terminal remota. Ejecuta el comando copiado en tu portapapeles.

Repetid los pasos 7-10 si deseáis dedicar hosts específicos a roles específicos de nodo. Repetid los pasos tantas veces como sea necesario.

Resultado:

El clúster se crea y transita al estado Actualizando mientras Rancher inicializa y aprovisiona los componentes del 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

3. Amazon Only: Etiquetar Recursos

Si habéis configurado vuestro clúster para usar Amazon como Proveedor de Nube, etiquetad vuestros recursos de AWS con un ID de clúster.

Documentación de Amazon: Etiquetado de vuestros Recursos de Amazon EC2

Podéis usar instancias de Amazon EC2 sin configurar un proveedor de nube en Kubernetes. Solo tenéis que configurar el proveedor de nube si deseáis utilizar funcionalidades específicas del proveedor de nube de Kubernetes. Para más información, consultad Proveedores de Nube de Kubernetes

Los siguientes recursos necesitan ser etiquetados con un ClusterID:

  • Nodos: Todos los hosts añadidos en Rancher.

  • Subred: La subred utilizada para vuestro clúster

  • Grupo de Seguridad: El grupo de seguridad utilizado para vuestro clúster.

No etiquetéis múltiples grupos de seguridad. Etiquetar múltiples grupos genera un error al crear el Elastic Load Balancer.

La etiqueta que se debe utilizar es:

Key=kubernetes.io/cluster/<CLUSTERID>, Value=owned

<CLUSTERID> puede ser cualquier cadena que elijáis. Sin embargo, la misma cadena debe utilizarse en todos los recursos que etiquetéis. Establecer el valor de la etiqueta a owned informa al clúster que todos los recursos etiquetados con el <CLUSTERID> son propiedad y están gestionados por este clúster.

Si compartís recursos entre clústeres, podéis cambiar la etiqueta a:

Key=kubernetes.io/cluster/CLUSTERID, Value=shared

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.