Installer AWS Load Balancer Controller avec Helm - Amazon EKS
PrérequisÉtape 1 : créer un rôle IAM à l’aide d’eksctlÉtape 2 : installer l’AWS Load Balancer ControllerÉtape 3 : vérifier que le contrôleur est installé

Aidez à améliorer cette page

Pour contribuer à ce guide de l’utilisateur, cliquez sur le lien Modifier cette page sur GitHub qui se trouve dans le volet droit de chaque page.

Installer AWS Load Balancer Controller avec Helm

Astuce

Avec le mode automatique Amazon EKS, il n’est pas nécessaire d’installer ou de mettre à niveau de modules complémentaires de mise en réseau. Le mode automatique inclut des fonctionnalités de mise en réseau des pods et d’équilibrage de charge.

Pour de plus amples informations, consultez Automatisation de l’infrastructure du cluster avec le mode automatique EKS.

Cette rubrique décrit comment installer l’AWS Load Balancer Controller à l’aide de Helm, un gestionnaire de packages pour Kubernetes, et eksctl. Le contrôleur est installé avec les options par défaut. Pour plus d’informations sur le contrôleur, notamment sur sa configuration à l’aide d’annotations, consultez la Documentation de l’AWS Load Balancer Controller sur GitHub.

Dans les étapes suivantes, remplacez les valeurs d’exemple par vos propres valeurs.

Prérequis

Avant de commencer ce tutoriel, vous devez suivre les étapes suivantes :

Considérations

Avant de procéder aux étapes de configuration décrites sur cette page, tenez compte des points suivants :

  • La politique et le rôle IAM (AmazonEKSLoadBalancerControllerRole) peuvent être réutilisés sur plusieurs clusters EKS du même compte AWS.

  • Si vous installez le contrôleur sur le même cluster où le rôle (AmazonEKSLoadBalancerControllerRole) a été créé à l’origine, passez à l’étape 2 : installer le Load Balancer Controller après avoir vérifié que le rôle existe.

  • Si vous utilisez les rôles IAM pour les comptes de service (IRSA), IRSA doit être configuré pour chaque cluster, et l’ARN du fournisseur OpenID Connect (OIDC) dans la politique de confiance du rôle est spécifique à chaque cluster EKS. De plus, si vous installez le contrôleur sur un nouveau cluster avec un AmazonEKSLoadBalancerControllerRole existant, mettez à jour la politique de confiance du rôle afin d’inclure le fournisseur OIDC du nouveau cluster et créez un nouveau compte de service avec l’annotation de rôle appropriée. Pour déterminer si vous disposez déjà d’un fournisseur OIDC ou pour en créer un, consultez Créer un fournisseur d'identité OIDC IAM pour votre cluster.

Étape 1 : créer un rôle IAM à l’aide d’eksctl

Les étapes suivantes se réfèrent à la version 2.13.3 de l’AWS Load Balancer Controller. Pour plus d’informations sur toutes les versions, consultez la page des versions de l’AWS Load Balancer Controller sur GitHub.

  1. Téléchargez une politique IAM pour le contrôleur de l'équilibreur de charge AWS qui lui permet d'effectuer des appels aux API AWS en votre nom.

    curl -O https://raw.githubusercontent.com/kubernetes-sigs/aws-load-balancer-controller/v2.13.3/docs/install/iam_policy.json

    • Si vous utilisez une partition AWS non standard, telle que celle du gouvernement ou de la région Chine, consultez les politiques sur GitHub et téléchargez la politique appropriée pour votre région.

  2. Créez une politique IAM à l'aide de la politique téléchargée à l'étape précédente.

    aws iam create-policy \
    --policy-name AWSLoadBalancerControllerIAMPolicy \
    --policy-document file://iam_policy.json
    Note

    Si vous consultez la politique sur la AWS Management Console, la console affiche des avertissements pour le service ELB, mais pas pour le service ELB v2. Cela est dû au fait que certaines des actions de la politique sont disponibles pour ELB v2, mais pas pour ELB. Vous pouvez ignorer les avertissements relatifs au service ELB.

  3. Remplacez les valeurs pour le nom du cluster, le code régional et l’ID du compte.

    eksctl create iamserviceaccount \
    --cluster=<cluster-name> \
    --namespace=kube-system \
    --name=aws-load-balancer-controller \
    --attach-policy-arn=arn:aws:iam::<AWS_ACCOUNT_ID>:policy/AWSLoadBalancerControllerIAMPolicy \
    --override-existing-serviceaccounts \
    --region <aws-region-code> \
    --approve

Étape 2 : installer l’AWS Load Balancer Controller

  1. Ajoutez le référentiel des Charts de Helm eks-charts. AWS maintient ce référentiel est géré sur GitHub.

    helm repo add eks https://aws.github.io/eks-charts

  2. Mettez à jour votre référentiel local pour vous assurer que vous disposez des graphiques les plus récents.

    helm repo update eks

  3. Installez le contrôleur de l'équilibreur de charge AWS.

    Si vous déployez le contrôleur sur des nœuds Amazon EC2 dont l’accès au service de métadonnées d’instance (IMDS) Amazon EC2 est restreint, ou si vous effectuez un déploiement sur Fargate ou sur des nœuds hybrides Amazon EKS, ajoutez les indicateurs suivants à la commande helm suivante :

    • --set region=region-code

    • --set vpcId=vpc-xxxxxxxx

      Remplacez my-cluster par le nom de votre cluster. Dans la commande suivante, aws-load-balancer-controller est le compte de service Kubernetes que vous avez créé à l'étape précédente.

      Pour plus d’informations sur la configuration des Charts de Helm, consultez values.yaml sur 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 \
  --version 1.13.0
Important

Le graphique déployé ne reçoit pas automatiquement les mises à jour de sécurité. Vous devez effectuer manuellement une mise à niveau vers un graphique plus récent lorsqu'il sera disponible. Lors de la mise à niveau, remplacez install par upgrade dans la commande précédente.

La commande helm install installe automatiquement les définitions de ressources personnalisées (CRD) pour le contrôleur. Ce n’est pas le cas de la commande helm upgrade. Si vous utilisez helm upgrade,, vous devez installer manuellement les CRD. Exécutez la commande suivante pour installer les CRD :

wget https://raw.githubusercontent.com/aws/eks-charts/master/stable/aws-load-balancer-controller/crds/crds.yaml
kubectl apply -f crds.yaml

Étape 3 : vérifier que le contrôleur est installé

  1. Vérifiez que le contrôleur est installé.

    kubectl get deployment -n kube-system aws-load-balancer-controller

    L'exemple qui suit illustre un résultat.

    NAME                           READY   UP-TO-DATE   AVAILABLE   AGE
aws-load-balancer-controller   2/2     2            2           84s

    Vous recevez la sortie précédente si vous avez déployé à l'aide de Helm. Si vous avez déployé à l'aide du manifeste Kubernetes, vous n'avez qu'un seul réplica.

  2. Avant d'utiliser le contrôleur pour allouer AWS, votre cluster doit répondre à des exigences spécifiques. Pour plus d'informations, consultez Routage du trafic des applications et du trafic HTTP avec des équilibreurs de charge Application Load Balancer et Acheminer le trafic TCP et UDP avec des Network Load Balancers.