Skip to content

Update USP doc for routing to clusterIPs#2006

Draft
bjee19 wants to merge 1 commit into
nginx:ngf-release-2.7from
bjee19:ngf/clusterip-routing
Draft

Update USP doc for routing to clusterIPs#2006
bjee19 wants to merge 1 commit into
nginx:ngf-release-2.7from
bjee19:ngf/clusterip-routing

Conversation

@bjee19
Copy link
Copy Markdown
Contributor

@bjee19 bjee19 commented May 28, 2026

Proposed changes

Update USP documentation to add section on routing to Service ClusterIP.

Checklist

Before sharing this pull request, I completed the following checklist:

Footnotes

  1. Potentially sensitive information includes personally identify information (PII), authentication credentials, and live URLs. Refer to the style guide for guidance about placeholder content.

@github-actions github-actions Bot added documentation Improvements or additions to documentation product/ngf Issues related to NGINX Gateway Fabric labels May 28, 2026
@bjee19
Copy link
Copy Markdown
Contributor Author

bjee19 commented May 28, 2026

This PR is blocked on merging until nginx/nginx-gateway-fabric#5280 goes through.

kind: Service
name: tea
loadBalancingMethod: "hash consistent"
hashMethodKey: "$upstream_addr"
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

wouldn't apply correctly without this change

Copy link
Copy Markdown
Contributor

@salonichf5 salonichf5 May 28, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

what is the error message? Most definitely worked for me

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we should update the examples folder in NGF too then

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The UpstreamSettingsPolicy "lb-method-hash" is invalid: spec.hashMethodKey: Invalid value: "": spec.hashMethodKey in body should match '^\$[a-z_]+$'

I think for some reason in my terminal atleast, since its not escaped, the $ like causes it to evaluate the variable

Comment on lines 516 to +531
@@ -527,7 +528,7 @@ EOF
Verify that the `UpstreamSettingsPolicy` is Accepted:

```shell
kubectl describe upstreamsettingspolicies.gateway.nginx.org upstream-unset-keepAlive
kubectl describe upstreamsettingspolicies.gateway.nginx.org upstream-unset-keepalive
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

apparently names need to be all lowercased, so this wasn't working either

@bjee19 bjee19 requested a review from a team May 28, 2026 22:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation product/ngf Issues related to NGINX Gateway Fabric

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants