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.

Requisitos para la instalación

Esta página describe los requisitos de software, hardware y red para los nodos donde se instalará el servidor Rancher. El servidor Rancher se puede instalar en un único nodo o en un clúster de Kubernetes de alta disponibilidad.

Importante:

Si instalas Rancher en un clúster de Kubernetes, los requisitos son diferentes de los requisitos de nodo para clústeres de usuarios en sentido descendente, que ejecutarán tus aplicaciones y servicios.

La interfaz de usuario de Rancher funciona mejor en navegadores basados en Firefox o Chromium (Chrome, Edge, Opera, Brave, etc.).

Consulta nuestra página sobre mejores prácticas para obtener una lista de recomendaciones para ejecutar un servidor Rancher en producción.

Compatibilidad de Kubernetes con Rancher

Rancher debe instalarse en una versión de Kubernetes compatible. Consulta la matriz de soporte de Rancher para asegurarte de que la versión de Kubernetes que deseas utilizar es compatible.

Independientemente de la versión y distribución, el clúster de Kubernetes debe tener la capa de API de agregación configurada correctamente para soportar la extensión API utilizada por Rancher.

Instala Rancher en un clúster de Kubernetes endurecido

Si instalas Rancher en un clúster de Kubernetes endurecido, consulta la sección Exención de los espacios de nombres requeridos de Rancher para obtener requisitos detallados.

Instala Rancher en un clúster de Kubernetes solo IPv6 o de doble pila

Puedes desplegar Rancher en un clúster de Kubernetes solo IPv6 o de doble pila.

Para obtener detalles sobre el soporte de Rancher para IPv6 solo y doble pila, consulta la página Doble pila IPv4/IPv6.

Requisitos de sistemas operativos y del entorno de ejecución de contenedor

Todos los sistemas operativos compatibles son de 64 bits x86. Rancher debería funcionar con cualquier distribución moderna de Linux.

La matriz de soporte de Rancher lista qué versiones de OS y Docker fueron probadas para cada versión de Rancher.

Docker es necesario para los nodos que ejecutarán clústeres RKE. No es necesario para clústeres RKE2 o K3s.

El paquete ntp (Protocolo de Tiempo de Red) debe estar instalado. Esto previene errores con la validación de certificados que pueden ocurrir cuando el tiempo no está sincronizado entre el cliente y el servidor.

Algunas distribuciones de Linux pueden tener reglas de firewall predeterminadas que bloquean la comunicación dentro del clúster de Kubernetes. Desde Kubernetes v1.19, firewalld debe estar desactivado, ya que entra en conflicto con los complementos de red de Kubernetes.

Si no te sientes cómodo haciéndolo, puedes consultar las sugerencias en el problema respectivo. Algunos usuarios tuvieron éxito creando una zona de firewalld separada con una directiva de ACEPTAR para el CIDR de Pod.

Si planeas ejecutar Rancher en ARM64, consulta Ejecutando en ARM64 (Experimental).

SUSE® Rancher Prime: RKE2 Requisitos Específicos

RKE2 incluye su propio entorno de ejecución de contenedor, containerd.

Para detalles sobre qué versiones de OS fueron probadas con RKE2, consulta la matriz de soporte de Rancher.

SUSE® Rancher Prime: K3s Requisitos Específicos

Para el entorno de ejecución de contenedor, K3s incluye por defecto su propio containerd. Alternativamente, puedes configurar K3s para usar un entorno de ejecución de Docker ya instalado. Para más información sobre el uso de K3s con Docker, consulta la documentación de K3s.

Rancher debe instalarse en una versión de Kubernetes compatible. Para averiguar qué versiones de Kubernetes son compatibles con tu versión de Rancher, consulta la matriz de soporte de Rancher. Para especificar la versión de K3s, utiliza la variable de entorno INSTALL_K3S_VERSION al ejecutar el script de instalación de K3s.

Si estás instalando Rancher en un clúster K3s con Raspbian Buster, sigue estos pasos para cambiar a paquete de tablas IP heredado.

Si estás instalando Rancher en un clúster K3s con Alpine Linux, sigue estos pasos para una configuración adicional.

Requisitos de hardware

Las siguientes secciones describen los requisitos de CPU, memoria y E/S para los nodos donde se instala Rancher. Los requisitos varían según el tamaño de la infraestructura.

Consideraciones Prácticas

La huella de hardware de Rancher depende de varios factores, incluyendo:

  • Tamaño de la infraestructura gestionada (por ejemplo, número de nodos, número de clústeres).

  • Complejidad de las reglas de control de acceso deseadas (por ejemplo, RoleBinding número de objetos).

  • Número de cargas de trabajo (por ejemplo, ampliaciones de Kubernetes, ampliaciones de Fleet).

  • Patrones de uso (por ejemplo, subconjunto de funcionalidades utilizadas activamente, frecuencia de uso, número de usuarios concurrentes).

Dado que hay un alto número de factores influyentes que pueden variar con el tiempo, los requisitos enumerados aquí deben entenderse como puntos de partida razonables que funcionan bien para la mayoría de los casos de uso. No obstante, su caso de uso puede tener requisitos diferentes. Para consultas sobre un escenario específico, por favor contacta con Rancher para obtener más orientación.

En particular, los requisitos en esta página están sujetos a suposiciones de uso típicas, que incluyen:

  • Menos de 60,000 recursos de Kubernetes en total, por tipo.

  • Hasta 120 pods por nodo.

  • Hasta 200 CRDs en el clúster local (sentido ascendente).

  • Hasta 100 CRDs en clústeres de sentido descendente.

  • Hasta 50 ampliaciones de Fleet.

Números más altos son posibles, pero los requisitos podrían ser mayores. Si tienes más de 20,000 recursos del mismo tipo, el tiempo de carga de toda la lista a través de la interfaz de usuario de Rancher podría tardar varios segundos.

Evolution:

La base de código de Rancher evoluciona, los casos de uso cambian y el cuerpo de experiencia acumulada de Rancher crece cada día.

Las recomendaciones de requisitos de hardware están sujetas a cambios con el tiempo, a medida que las directrices mejoran en precisión y se vuelven más concretas.

Si encuentras que tu ampliación de Rancher ya no cumple con las recomendaciones listadas, contacta con Rancher para una reevaluación.

SUSE® Rancher Prime: RKE2 Kubernetes

La siguiente tabla enumera los requisitos mínimos de CPU y memoria para cada nodo en el clúster local (sentido ascendente).

Ten en cuenta que se requiere una configuración altamente disponible con al menos tres nodos para producción.

Tamaño de Infraestructura Gestionada Número máximo de clústeres Número máximo de nodos vCPUs RAM

Pequeño

150

1.500

4

16 GB

Media

300

3000

8

32 GB

Grande (*)

500

5000

16

64 GB

Más grande (†)

(†)

(†)

(†)

(†)

(*): Las ampliaciones grandes requieren que sigáis las mejores prácticas para un rendimiento adecuado.

(†): Los tamaños de ampliación más grandes son generalmente posibles con recomendaciones de hardware ad-hoc y ajustes. Puedes contactar con Rancher para una evaluación personalizada.

Consulta la documentación de RKE2 para obtener información más detallada sobre los requisitos generales de RKE2.

SUSE® Rancher Prime: K3s Kubernetes

La siguiente tabla enumera los requisitos mínimos de CPU y memoria para cada nodo en el clúster de sentido ascendente.

Ten en cuenta que se requiere una configuración altamente disponible con al menos tres nodos para producción.

Tamaño de Infraestructura Gestionada Número máximo de Clústeres Número máximo de Nodos vCPUs RAM Host de Base de Datos Externa (*)

Pequeño

150

1.500

4

16 GB

2 vCPUs, 8 GB + 1000 IOPS

Media

300

3000

8

32 GB

4 vCPUs, 16 GB + 2000 IOPS

Grande (†)

500

5000

16

64 GB

8 vCPUs, 32 GB + 4000 IOPS

(*): El Host de Base de Datos Externa se refiere a alojar el almacén de datos del clúster K3s en un host externo dedicado. Este campo es opcional. Los requisitos exactos dependen del almacén de datos externo.

(†): Las ampliaciones grandes requieren que sigáis las mejores prácticas para un rendimiento adecuado.

Consulta la documentación de K3s para obtener información más detallada sobre requisitos generales.

Kubernetes alojado

La siguiente tabla enumera los requisitos mínimos de CPU y memoria para cada nodo en el clúster de sentido ascendente.

Ten en cuenta que se requiere una configuración altamente disponible con al menos tres nodos para producción.

Estos requisitos se aplican a los clústeres de Kubernetes alojados, como Amazon Elastic Kubernetes Service (EKS), Azure Kubernetes Service (AKS) o Google Kubernetes Engine (GKE). No se aplican a soluciones SaaS de Rancher como Rancher Prime Hosted.

Tamaño de Infraestructura Gestionada Número máximo de Clústeres Número máximo de Nodos vCPUs RAM

Pequeño

150

1.500

4

16 GB

Media

300

3000

8

32 GB

Grande (*)

500

5000

16

64 GB

(*): Las ampliaciones grandes requieren que sigáis las mejores prácticas para un rendimiento adecuado.

Ingress

Cada nodo en el clúster de Kubernetes en el que está instalado Rancher debe ejecutar un Ingress.

El Ingress debe desplegarse como DaemonSet para garantizar que tu equilibrador de carga pueda enrutar el tráfico con éxito a todos los nodos.

Para instalaciones de RKE2 y K3s, no es necesario instalar el Ingress manualmente porque se instala por defecto.

Para clústeres de Kubernetes alojados (EKS, GKE, AKS), necesitarás configurar el ingress.

  • Amazon EKS: Para obtener detalles sobre cómo instalar Rancher en Amazon EKS, incluyendo cómo instalar un ingress para que se pueda acceder al servidor de Rancher, consulta esta página.

  • AKS: Para obtener detalles sobre cómo instalar Rancher con Azure Kubernetes Service, incluyendo cómo instalar un ingress para que se pueda acceder al servidor de Rancher, consulta esta página.

  • GKE: Para obtener detalles sobre cómo instalar Rancher con Google Kubernetes Engine, incluyendo cómo instalar un ingress para que se pueda acceder al servidor de Rancher, consulta esta página.

Discos

El rendimiento de Rancher depende del rendimiento de etcd en el clúster. Para garantizar una velocidad óptima, recomendamos utilizar siempre discos SSD para respaldar tu clúster de Kubernetes de gestión de Rancher. En proveedores de nube, también querrás utilizar el tamaño mínimo que permita el máximo IOPS. En clústeres más grandes, considera utilizar dispositivos de almacenamiento dedicados para los datos de etcd y los directorios wal.

Requisitos de red

Esta sección describe los requisitos de red para el/los nodo(s) donde se instala el servidor Rancher.

Si un servidor que contiene Rancher tiene el encabezado X-Frame-Options=DENY, algunas páginas en la nueva interfaz de usuario de Rancher no podrán renderizarse después de actualizar desde la interfaz de usuario heredada. Esto se debe a que algunas páginas heredadas están incrustadas como iFrames en la nueva interfaz de usuario.

Direcciones IP de los nodos

Cada nodo utilizado debe tener una IP estática configurada, independientemente de si se está instalando Rancher en un solo nodo o en un clúster HA. En caso de DHCP, cada nodo debe tener una reserva DHCP para asegurarse de que el nodo obtenga la misma IP asignada.

Requisitos de puertos

Para operar correctamente, Rancher requiere que un número de puertos estén abiertos en los nodos de Rancher y en los nodos del clúster de Kubernetes en sentido descendente. Requisitos de puertos enumera todos los puertos necesarios para Rancher y clústeres en sentido descendente para los diferentes tipos de clústeres.

Requisitos del balanceador de carga

Si utilizas un balanceador de carga, debe ser compatible con HTTP/2.

Para recibir ayuda del soporte de SUSE, los clientes de Rancher Prime que utilizan balanceadores de carga (o cualquier otro dispositivo intermedio como firewall), deben usar uno que sea compatible con HTTP/2.

Cuando HTTP/2 no está disponible, Rancher vuelve a HTTP/1.1. Sin embargo, dado que HTTP/2 ofrece un mejor rendimiento de las aplicaciones web, utilizar HTTP/1.1 puede crear problemas de rendimiento.