Skip to content

docs: clarify HTTPProxy match precedence and query-parameter case sensitivity#7538

Open
alliasgher wants to merge 1 commit into
projectcontour:mainfrom
alliasgher:docs-route-precedence
Open

docs: clarify HTTPProxy match precedence and query-parameter case sensitivity#7538
alliasgher wants to merge 1 commit into
projectcontour:mainfrom
alliasgher:docs-route-precedence

Conversation

@alliasgher
Copy link
Copy Markdown

Closes #5774
Closes #5071

Adds two missing pieces to the request-routing guide:

  • A Match Condition Precedence subsection under Conditions explaining the sort order Contour applies to overlapping route match conditions (exact > regex > prefix path matches; tie-break by header count then query-param count). Mirrors the Gateway API HTTPRouteRule precedence spec.
  • A note on the queryParameter section that name is matched case-sensitively, and ignoreCase applies to the value only.

…sitivity

Adds two missing pieces to the request-routing guide:

- A 'Match Condition Precedence' subsection under Conditions explaining
  the sort order Contour applies to overlapping route conditions
  (exact > regex > prefix path matches; tie-break by header count then
  query-param count) so users can predict which route wins. Mirrors the
  Gateway API HTTPRouteRule spec.

- A note on the queryParameter section that 'name' is matched
  case-sensitively, and ignoreCase applies to the value only.

Fixes projectcontour#5774
Fixes projectcontour#5071

Signed-off-by: alliasgher <alliasgher123@gmail.com>
@alliasgher alliasgher requested a review from a team as a code owner May 7, 2026 09:03
@alliasgher alliasgher requested review from sunjayBhatia and tsaarni and removed request for a team May 7, 2026 09:03
@codecov
Copy link
Copy Markdown

codecov Bot commented May 8, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 82.32%. Comparing base (0ac7589) to head (4e2aa68).

Additional details and impacted files

Impacted file tree graph

@@           Coverage Diff           @@
##             main    #7538   +/-   ##
=======================================
  Coverage   82.32%   82.32%           
=======================================
  Files         130      130           
  Lines       15624    15624           
=======================================
  Hits        12863    12863           
  Misses       2478     2478           
  Partials      283      283           
🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@alliasgher
Copy link
Copy Markdown
Author

Could a maintainer add a release-note/docs (or release-note/small) label to unblock the Check release-note label set job? It looks like external contributors can't set labels themselves. Thanks.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document how HTTPProxy route/include match condition precedence works Query parameter matching: case sensitivity

1 participant