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.
sugerencia
Con el modo automático de Amazon EKS, no necesita instalar ni actualizar complementos de red. El modo automático ofrece capacidades para la conexión en red de pods y el equilibrio de carga.
Para obtener más información, consulte Automatización de la infraestructura de clústeres con el modo automático de EKS.
En este tema se describe cómo instalar el Controlador del equilibrador de carga AWS con Helm, un administrador de paquetes para Kubernetes y eksctl. El controlador se instala con las opciones predeterminadas. Para obtener más información sobre el controlador, incluidos los detalles sobre su configuración con anotaciones, consulte la documentación del Controlador del equilibrador de carga de AWS
En los siguientes pasos, reemplace los valores de ejemplo por sus propios valores.
Requisitos previos
Antes de comenzar este tutorial, debe instalar y configurar las siguientes herramientas y recursos que necesitará para crear y administrar un clúster de Amazon EKS.
-
Un clúster existente de Amazon EKS. Para implementar uno, consulte Introducción a Amazon EKS.
-
Un proveedor existente de OpenID Connect (OIDC) de AWS Identity and Access Management (IAM) para su clúster. Para determinar si ya tiene un proveedor o para crear uno, consulte Crear un proveedor de OIDC de IAM para su clúster.
-
Asegúrese de que sus complementos CNI de Amazon VPC para Kubernetes,
kube-proxyy CoreDNS tengan las versiones mínimas enumeradas en Service account tokens. -
Familiaridad con AWS Elastic Load Balancing. Para obtener más información, consulte la Guía del usuario de Elastic Load Balancing.
-
Familiaridad con el servicio
de Kubernetes y los recursos de entrada . -
Instalación de Helm
de forma local.
Paso 1: crear el rol de IAM usando eksctl
nota
Solo necesita crear un rol de IAM para el Controlador del equilibrador de carga de AWS una vez por cuenta de AWS. Compruebe si AmazonEKSLoadBalancerControllerRole existe en la Consola de IAM
nota
El siguiente ejemplo se refiere a la versión v2.11.0 del Controlador del equilibrador de carga de AWS. Para obtener más información sobre todas las versiones, consulte la página de versiones del Controlador del equilibrador de carga de AWS
-
Descargue una política de IAM para el Controlador del equilibrador de carga de AWS que le permita realizar llamadas a las API de AWS en su nombre.
-
Cree una política de IAM con la política descargada en el paso anterior.
aws iam create-policy \ --policy-name AWSLoadBalancerControllerIAMPolicy \ --policy-document file://iam_policy.jsonnota
Si ve la política en la AWS Management Console, la consola muestra advertencias para el servicio ELB, pero no para el servicio ELB v2. Esto ocurre porque algunas de las acciones de la política existen para ELB v2, pero no para ELB. Puede obviar estas advertencias para ELB.
-
Reemplace
my-clusterpor el nombre de su clúster y111122223333con el ID de su cuenta y luego ejecute el comando.eksctl create iamserviceaccount \ --cluster=my-cluster \ --namespace=kube-system \ --name=aws-load-balancer-controller \ --role-name AmazonEKSLoadBalancerControllerRole \ --attach-policy-arn=arn:aws:iam::111122223333:policy/AWSLoadBalancerControllerIAMPolicy \ --approve
Paso 2: instalación del Controlador del equilibrador de carga de AWS
-
Añada el repositorio de gráficos de Helm
eks-charts. AWS mantiene este repositorioen GitHub. helm repo add eks https://aws.github.io/eks-charts -
Actualice el repositorio local para asegurarse de que cuenta con los gráficos más recientes.
helm repo update eks -
Instale el Controlador del equilibrador de carga de AWS.
Si va a implementar el controlador en nodos de Amazon EC2 que tienen acceso restringido al servicio de metadatos de instancias de Amazon EC2 (IMDS)
, o si va a implementar en Nodos híbridos de Amazon EKS o Fargate, agregue los siguientes indicadores al comando helmsiguiente:-
--set region=region-code -
--set vpcId=vpc-xxxxxxxxReemplace
my-clusterpor el nombre de su clúster. En el comando siguiente,aws-load-balancer-controlleres la cuenta de servicio de Kubernetes que creó en un paso anterior.Para obtener más información acerca de la configuración del gráfico de Helm, consulte values.yaml
en GitHub. helm install aws-load-balancer-controller eks/aws-load-balancer-controller \ -n kube-system \ --set clusterName=my-cluster \ --set serviceAccount.create=false \ --set serviceAccount.name=aws-load-balancer-controller
-
importante
El gráfico implementado no recibe actualizaciones de seguridad de forma automática. Debe actualizar de forma manual a un gráfico más reciente cuando se encuentre disponible. Al actualizar, cambie install por upgrade en el comando anterior.
El comando helm install instala automáticamente las definiciones de recursos personalizadas (CRD) para el controlador. El comando helm upgrade no lo hace. Si usa helm upgrade,, debe instalar manualmente las CRD. Ejecute el siguiente comando para instalar las CRD:
wget https://raw.githubusercontent.com/aws/eks-charts/master/stable/aws-load-balancer-controller/crds/crds.yaml kubectl apply -f crds.yaml
Paso 3: verificar que el controlador se encuentre instalado
-
Verifique que el controlador se encuentre instalado.
kubectl get deployment -n kube-system aws-load-balancer-controllerUn ejemplo de salida sería el siguiente.
NAME READY UP-TO-DATE AVAILABLE AGE aws-load-balancer-controller 2/2 2 2 84sRecibe la salida anterior si ha implementado mediante Helm. Si ha implementado utilizando el manifiesto de Kubernetes, solo tiene una réplica.
-
Antes de utilizar el controlador para aprovisionar el recurso de AWS, el clúster debe cumplir requisitos específicos. Para obtener más información, consulte Redirección de tráfico de aplicaciones y HTTP con los equilibradores de carga de aplicaciones y Dirija el tráfico de TCP y UDP con equilibradores de carga de red.
