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.

Instalando SUSE Rancher Prime en Amazon EKS

Esta página cubre la instalación de Rancher en un clúster de Amazon EKS. También puedes instalar Rancher a través del AWS Marketplace.

Si ya tienes un clúster de Kubernetes EKS, salta al paso sobre instalar un Ingress. Luego instala el chart de Helm de Rancher siguiendo las instrucciones en esta página.

Creando un clúster EKS para el servidor Rancher

En esta sección, instalarás un clúster EKS con un Ingress utilizando herramientas shell. Esta guía puede ser útil si deseas usar menos recursos mientras pruebas Rancher en EKS.

Requisitos previos:

  • Ya deberías tener una cuenta de AWS.

  • Se recomienda usar un usuario IAM en lugar de la cuenta raíz de AWS. Necesitarás la clave de acceso y la clave secreta del usuario IAM para configurar la interfaz de línea de comandos de AWS.

  • El usuario IAM necesita las políticas IAM mínimas descritas en la documentación oficial de eksctl.

1. Prepara tu estación de trabajo

Instala las siguientes herramientas shell en tu estación de trabajo:

2. Configura la AWS CLI

Para configurar la AWS CLI, ejecuta el siguiente comando:

aws configure

Luego introduce los siguientes valores:

Valor Descripción

ID de clave de acceso de AWS

La credencial de clave de acceso para el usuario IAM con permisos de EKS.

Clave de acceso secreta de AWS

La credencial de clave secreta para el usuario IAM con permisos de EKS.

Nombre de la región por defecto

Una región de AWS donde se ubicarán los nodos del clúster.

Formato de salida por defecto

Introduzca el archivo json.

3. Crea el clúster de EKS

Para crear un clúster de EKS, ejecuta el siguiente comando. Utiliza la región de AWS que se aplique a tu caso de uso. Al elegir una versión de Kubernetes, asegúrate de consultar primero la matriz de soporte para encontrar la versión más alta de Kubernetes que ha sido validada para tu versión de Rancher.

eksctl create cluster \
  --name rancher-server \
  --version <VERSION> \
  --region us-west-2 \
  --nodegroup-name ranchernodes \
  --nodes 3 \
  --nodes-min 1 \
  --nodes-max 4 \
  --managed

El clúster tardará un tiempo en desplegarse con CloudFormation.

4. Prueba el clúster

Para probar el clúster, ejecuta:

eksctl get cluster

El resultado debería verse como el siguiente:

eksctl get cluster
2021-03-18 15:09:35 [ℹ]  eksctl version 0.40.0
2021-03-18 15:09:35 [ℹ]  using region us-west-2
NAME        REGION        EKSCTL CREATED
rancher-server-cluster        us-west-2    True

5. Instala un Ingress

El clúster necesita un Ingress para que Rancher pueda ser accedido desde fuera del clúster. Instalar un Ingress requiere asignar una dirección IP pública. Asegúrate de tener suficiente cuota, de lo contrario, no se podrá asignar la dirección IP. Los límites para las direcciones IP públicas son aplicables a nivel regional por cada suscripción. Puedes utilizar un controlador de Ingress gestionado proporcionado por AWS (ALB) o un controlador de Ingress de terceros como Traefik.

No se recomienda instalar un controlador de Ingress de terceros, como Traefik, si ya se está utilizando un controlador de Ingress gestionado.

Ingress-NGINX EOL: El controlador de la comunidad ingress-nginx alcanzará el final de su vida útil (EOL) en marzo de 2026. Esta página utiliza Traefik, que es la ruta de migración recomendada para entornos Rancher.

Traefik incluye un proveedor nativo de Ingress NGINX. Esto te permite migrar de NGINX sin reescribir tus objetos de Ingress existentes, ya que Traefik interpretará automáticamente las anotaciones nginx.ingress.kubernetes.io. Si estás actualizando un clúster que ya está utilizando ingress-nginx, sigue esta guía para más información.

Para instalar Traefik, te recomendamos encarecidamente utilizar la aplicación Traefik en la Colección de aplicaciones Rancher Prime. Consulta su documentación para integrarte con Rancher Manager.

6. Obtener IP del Balanceador de Carga

Para obtener la dirección del balanceador de carga, ejecuta:

kubectl get service traefik --namespace=traefik

El resultado debe ser similar al siguiente:

NAME                       TYPE           CLUSTER-IP     EXTERNAL-IP                                                              PORT(S)
 AGE
traefik  LoadBalancer   10.0.116.18    40.31.180.83   80:31229/TCP,443:31050/TCP 27m

Guarda el EXTERNAL-IP.

7. Configurar DNS

El tráfico externo al servidor Rancher deberá dirigirse al balanceador de carga que creaste.

Configura el DNS para apuntar a la IP externa que guardaste. Este DNS se usará como la URL del servidor Rancher.

Existen muchas maneras válidas de configurar el DNS. Para obtener ayuda, consulta la documentación de AWS sobre enrutamiento de tráfico a un balanceador de carga ELB.

8. Instala el Chart de Helm de Rancher

A continuación, instala el chart de Helm de Rancher siguiendo las instrucciones en esta página. Las instrucciones de Helm son las mismas para instalar Rancher en cualquier distribución de Kubernetes.

Utiliza ese nombre de DNS del paso anterior como la URL del servidor Rancher cuando instales Rancher. Se puede pasar como una opción de Helm. Por ejemplo, si el nombre de DNS es rancher.my.org, podrías ejecutar el comando de instalación de Helm con la opción --set hostname=rancher.my.org.

Al instalar Rancher sobre esta configuración, también necesitarás pasar el valor a continuación en el comando de instalación de Helm de Rancher para establecer el nombre del controlador de Ingress que se utilizará con el recurso de Ingress de Rancher:

--set ingress.ingressClassName=traefik

Consulta aquí para el comando de instalación de Helm para tu opción de certificado elegida.