AWS EKS 플러그인(aws-load-balancer-controller) 설치 트러블슈팅

1. 시험환경

    · AWS EKS : v1.30

    · kubectl : v1.33.2

    · aws-load-balancer-controller : v2.7.2

    · cert-manager : v1.13.5

 

2. 목적

    · AWS EKS 환경에서 aws-load-balancer-controller 설치시 활성화가 되지 않았던 문제를 해결한다.

 

3. 적용

    ① aws-load-balancer-controller 설치 후 kubectl 명령어로 deployment 상태 정보를 확인한다.

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

NAME                                       READY   UP-TO-DATE   AVAILABLE      AGE aws-load-balancer-controller       0/1                1                     0              5m56s

 

    ② pod의 status 정보를 확인한다.

        - $ kubectl  get  pods  -n  kube-system  -l  app.kubernetes.io/name=aws-load-balancer-controller

        - 6번 재시작 후 CrashLoopBackOff 상태로 비활성화 상태임을 확인할 수 있다.

NAME                                                                     READY            STATUS             RESTARTS         AGE aws-load-balancer-controller-5f467cb488-xsmf7       0/1     CrashLoopBackOff       6 (4m10s ago)    10m

 

    ③ pod 로그 정보를 확인한다.

        - $ kubectl  logs  -n  kube-system  [pod-name]

        - "--aws-vpc-id" 파라미터를 명시하라는 로그를 확인 하였다.

level":"error","ts":"2025-06-24T01:45:11Z","logger":"setup","msg":"unable to initialize AWS cloud","error":"failed to introspect vpcID from EC2Metadata or Node name, specify --aws-vpc-id instead if EC2Metadata is unavailable: failed to fetch VPC ID from instance metadata: EC2MetadataError: failed to make EC2Metadata request\n\n\tstatus code: 401, request id: "}

 

    ④ 배포된 pod의 편집모드로 진입하여 "--aws-vpc-id" 파라미터를 추가 및 적용한다.

        - $ kubectl edit deployment -n kube-system aws-load-balancer-controller

containers: - args:   - --cluster-name=<YOUR_CLUSTER_NAME>   - --aws-vpc-id=<YOUR_VPC_ID>     # Add this line with your actual VPC ID   image: 602401143452.dkr.ecr.ap-northeast-2.amazonaws.com/amazon/aws-alb-ingress-controller:v2.7.2   name: aws-load-balancer-controller

 

4. 결과

    · 서비스 배포 상태를 다시 확인한다.

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

NAME                                       READY   UP-TO-DATE   AVAILABLE      AGE aws-load-balancer-controller      1/1                1                     1               5m56s