Upgrade AWS Load Balancer Controller from chart 1.6.0 (app v2.6.0) to v3.2.2+
Nobody has claimed this yet.
- Dominant language
- Go
- Stars
- 7
- Forks
- 2
- Avg merge
- 1d 15h
- Merged PRs (30d)
- 3
Description
Summary
Upgrade the default AWS Load Balancer Controller (aws-load-balancer-controller) from Helm chart 1.6.0 (app v2.6.0) to chart v3.2.2 (app v3.2.2+).
Why this is needed
Chart 1.6.0 corresponds to AWS LBC app version v2.6.0, released August 2023. This version has no validation against Kubernetes 1.36 (released April 2026). AWS only actively tests and supports recent controller versions against new EKS releases. Running a ~3-year-old controller on a new cluster version is an operational risk.
Additionally, the v3.x line introduced improvements including updated Gateway API support (1.3 → 1.5) and corrected VPC tag filtering semantics.
This upgrade is a prerequisite for the planned Kubernetes 1.36 upgrade on EKS clusters.
Relevant links:
- AWS LBC GitHub releases: https://github.com/kubernetes-sigs/aws-load-balancer-controller/releases
- AWS EKS LBC installation docs: https://docs.aws.amazon.com/eks/latest/userguide/aws-load-balancer-controller.html
- AWS LBC install guide: https://kubernetes-sigs.github.io/aws-load-balancer-controller/latest/deploy/installation/
Backward compatibility
AWS LBC v3.2.2 requires Kubernetes 1.22+. It can be deployed in place on clusters currently running K8s 1.31 through 1.35 — this upgrade can be performed independently of and prior to the Kubernetes 1.36 upgrade.
Breaking changes in the upgrade (v2 → v3)
- Helm chart versioning — In v3.x, the Helm chart version aligns with the app version (previously chart v1.x = app v2.x). This changes how version pinning is expressed.
- VPC tag filtering — The
--aws-vpc-tagsflag now requires ALL specified tags to match (previously allowed partial matches). Review any VPC tag configurations. - Gateway API version — Gateway API bumped from 1.3 to 1.5;
TLSRoutepromoted from alpha to v1. Affects any NLB Gateway configurations.
Acceptance criteria
- Default AWS LBC chart version updated to
v3.2.2(or latest v3.x) inworkload.go - VPC tag filter configuration reviewed for breaking change
- Verified working on a staging EKS cluster before rolling to production
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start in workload.go to locate the default AWS Load Balancer Controller chart version and inspect how VPC tag filters are configured. Review the v3.2.2 Helm and AWS controller release notes for the chart, tag-matching, and Gateway API changes, then validate the upgrade on a staging EKS cluster. Done means the default is v3.2.2 or a later v3 release, configurations are compatible, and staging succeeds.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- aws, go, helm, kubernetes
- Domain
- cloud, devops, infrastructure
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Clearly specified
- Newbie friendliness
- 55/100