docs(ngf): add clarification on listener certificateRefs - #2176
Open
pvillaverde wants to merge 1 commit into
Open
docs(ngf): add clarification on listener certificateRefs#2176pvillaverde wants to merge 1 commit into
pvillaverde wants to merge 1 commit into
Conversation
|
✅ All required contributors have signed the F5 CLA for this PR. Thank you! |
Author
|
I have hereby read the F5 CLA and agree to its terms |
sjberman
approved these changes
Jul 28, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Proposed changes
Add a clarification note to the cert-manager integration guide to clarify how multiple
certificateRefson an HTTPS Listener are handled based on nginx/nginx-gateway-fabric#5647The current documentation may lead readers to expect that certificates are automatically selected based on the
hostnamesof attachedHTTPRouteresources. In practice,certificateRefsare associated with the Listener, not individual routes. When different domains require different TLS certificates, separate HTTPS Listeners with distinct, non-overlappinghostnamevalues are required.This PR adds a short note to clarify this behavior and help users avoid hours of nightmare debugging trying to find what's wrong. I'm not sure if this is the best place to put it, but it's the one I would have found it when I checked the docs I think.
Checklist
Before sharing this pull request, I completed the following checklist:
Footnotes
Potentially sensitive information includes personally identify information (PII), authentication credentials, and live URLs. Refer to the style guide for guidance about placeholder content. ↩