nginx-gateway-fabric icon indicating copy to clipboard operation
nginx-gateway-fabric copied to clipboard

Support for spec.infrastructure.service.annotations in NGINX Gateway Fabric (for AWS NLB target-type=ip)

Open xjg2010go opened this issue 3 weeks ago • 3 comments
trafficstars

Hi team,

I'm currently using NGINX Gateway Fabric v2.2.0 on EKS and integrating it with the AWS Load Balancer Controller. The controller automatically creates an NLB with target-type=instance (NodePort) whenever a Gateway is created via GatewayClass.

To achieve target-type=ip (pod IP mode), I tried adding these annotations under spec.kubernetes.service.annotations in my NginxProxy, but the CRD rejected it with the following error:

strict decoding error: unknown field "spec.kubernetes.service.annotations"

Later I noticed discussions suggesting that v2.3.0+ may introduce a new field like:

spec: infrastructure: service: annotations: service.beta.kubernetes.io/aws-load-balancer-type: "nlb" service.beta.kubernetes.io/aws-load-balancer-nlb-target-type: "ip"

However, I couldn’t find any confirmation or documentation for this.

Questions:

Will spec.infrastructure.service.annotations be officially supported in v2.3.0 (or a later release)?

Is there currently any supported way to configure AWS-specific annotations for the automatically generated LoadBalancer service (without manually patching it)?

If not, is it recommended to manually manage the Service (data plane) instead of using NginxProxy for AWS EKS environments?

Thanks for your help — this feature is very important for using NGINX Gateway Fabric with AWS NLB (IP mode).

xjg2010go avatar Oct 26 '25 12:10 xjg2010go