Ayude a mejorar esta página

Para contribuir a esta guía del usuario, elija el enlace Edit this page on GitHub que se encuentra en el panel derecho de cada página.

Creación de una IngressClass para configurar el equilibrador de carga de aplicación

El modo automático de EKS automatiza las tareas rutinarias de equilibrio de carga, incluida la exposición de las aplicaciones del clúster a Internet.

AWS sugiere usar equilibradores de carga de aplicación (ALB) para atender el tráfico HTTP y HTTPS. Los equilibradores de carga de aplicación pueden dirigir las solicitudes en función del contenido de la solicitud. Para obtener más información sobre los equilibradores de carga de aplicación, consulte ¿Qué es un equilibrador de carga de aplicación?

El modo automático de EKS crea y configura equilibradores de carga de aplicación (ALB). Por ejemplo, el modo automático de EKS crea un equilibrador de carga cuando se crea un objeto de Kubernetes de Ingress y lo configura de modo que dirija el tráfico a la carga de trabajo del clúster.

Información general

El modo automático de EKS creará un equilibrador de carga de aplicación que apunte a la carga de trabajo especificada en el recurso de Ingress, con la configuración del equilibrador de carga especificada en el recurso de IngressClassParams.

Requisitos previos

Paso 1: creación de una carga de trabajo

Cree una carga de trabajo que desea exponer a Internet. Puede ser cualquier recurso de Kubernetes que sirva tráfico HTTP, como una implementación o un servicio. Para este ejemplo, utilizamos un servicio HTTP simple llamado service-2048 que sirve el tráfico HTTP en el puerto 80.

Paso 2: creación de IngressClassParams

Cree un objeto de IngressClassParams para especificar opciones de configuración específicas de AWS para el equilibrador de carga de aplicación. En este ejemplo, creamos un recurso IngressClassParams denominado alb (que utilizará en el siguiente paso) que especifica el esquema del equilibrador de carga, tal como se muestra internet-facing en un archivo llamado alb-ingressclassparams.yaml.

apiVersion: eks.amazonaws.com/v1
kind: IngressClassParams
metadata:
  name: alb
spec:
  scheme: internet-facing

Aplique la configuración al clúster:

kubectl apply -f alb-ingressclassparams.yaml

Paso 3: creación de IngressClass

Cree una IngressClass que haga referencia a los valores de configuración específicos de AWS establecidos en el recurso IngressClassParams en un archivo llamado alb-ingressclass.yaml. Anote el nombre de la IngressClass. En este ejemplo, se asigna el nombre de alb tanto a la IngressClass como a los IngressClassParams.

Utilice la anotación is-default-class para controlar si los recursos de Ingress deben usar esta clase de forma predeterminada.

apiVersion: networking.k8s.io/v1
kind: IngressClass
metadata:
  name: alb
  annotations:
    # Use this annotation to set an IngressClass as Default
    # If an Ingress doesn't specify a class, it will use the Default
    ingressclass.kubernetes.io/is-default-class: "true"
spec:
  # Configures the IngressClass to use EKS Auto Mode
  controller: eks.amazonaws.com/alb
  parameters:
    apiGroup: eks.amazonaws.com
    kind: IngressClassParams
    # Use the name of the IngressClassParams set in the previous step
    name: alb

Para obtener más información acerca de las opciones de configuración, consulte Referencia de IngressClassParams.

Aplique la configuración al clúster:

kubectl apply -f alb-ingressclass.yaml

Paso 4: creación del ingreso

Cree un recurso Ingress en un archivo llamado alb-ingress.yaml. El propósito de este recurso es asociar las rutas y los puertos del equilibrador de carga de aplicación a las cargas de trabajo del clúster. Para este ejemplo, creamos un recurso Ingress denominado 2048-ingress que enruta el tráfico a un servicio denominado service-2048 en el puerto 80.

Para obtener más información sobre la configuración de este recurso, consulte Ingreso en la documentación de Kubernetes.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: 2048-ingress
spec:
  # this matches the name of IngressClass.
  # this can be omitted if you have a default ingressClass in cluster: the one with ingressclass.kubernetes.io/is-default-class: "true"  annotation
  ingressClassName: alb
  rules:
    - http:
        paths:
          - path: /*
            pathType: ImplementationSpecific
            backend:
              service:
                name: service-2048
                port:
                  number: 80

Aplique la configuración al clúster:

kubectl apply -f alb-ingress.yaml

Paso 5: comprobación del estado

Utilice kubectl para encontrar el estado de Ingress. El equilibrador de carga puede tardar unos minutos en estar disponible.

Utilice el nombre del recurso de Ingress que definió en el paso anterior. Por ejemplo:

kubectl get ingress 2048-ingress

Una vez que el recurso esté listo, recupere el nombre de dominio del equilibrador de carga.

kubectl get ingress 2048-ingress -o jsonpath='{.status.loadBalancer.ingress[0].hostname}'

Para ver el servicio en un navegador web, revise el puerto y la ruta especificados en el recurso de Ingress.

Paso 6: Efectúe una limpieza

Para limpiar el equilibrador de carga, utilice el siguiente comando:

kubectl delete ingress 2048-ingress
kubectl delete ingressclass alb
kubectl delete ingressclassparams alb

El modo automático de EKS eliminará automáticamente el equilibrador de carga asociado en la cuenta de AWS.

Referencia de IngressClassParams

La siguiente tabla es una referencia rápida de las opciones de configuración que se utilizan con mayor frecuencia.

Consideraciones

Las siguientes tablas proporcionan una comparación detallada de los cambios en las configuraciones de IngressClassParams, Ingress Annotations y TargetGroupBinding para el modo automático de EKS. Estas tablas destacan las principales diferencias entre la capacidad de equilibrio de carga del modo automático de EKS y el controlador del equilibrador de carga de código abierto, incluidos los cambios en la versión de la API, las características obsoletas y la actualización de los nombres de los parámetros.

IngressClassParams

Anotaciones de ingreso

TargetGroupBinding