Skip to content

document HTTP Proxy route/include match condition precedence#7492

Open
Skyee90 wants to merge 2 commits into
projectcontour:mainfrom
Skyee90:patch-1
Open

document HTTP Proxy route/include match condition precedence#7492
Skyee90 wants to merge 2 commits into
projectcontour:mainfrom
Skyee90:patch-1

Conversation

@Skyee90
Copy link
Copy Markdown

@Skyee90 Skyee90 commented Mar 23, 2026

This PR documents how Contour determines precedence when multiple HTTPProxy routes (including routes reached via includes) match a request.

It explains how route specificity affects evaluation order, including:

  • exact path matches
  • regex path matches (ordered by length)
  • prefix path matches (ordered by length)
  • header match conditions
  • query parameter match conditions

This follows Contour's internal route sorting logic and clarifies how deterministic request matching is achieved.

This PR documents how Contour determines precedence when multiple HTTPProxy routes (including routes reached via includes) match a request.

It explains how route specificity affects evaluation order, including:
- exact path matches
- regex path matches (ordered by length)
- prefix path matches (ordered by length)
- header match conditions
- query parameter match conditions

This follows Contour's internal route sorting logic and clarifies how deterministic request matching is achieved.
@Skyee90 Skyee90 requested a review from a team as a code owner March 23, 2026 17:12
@Skyee90 Skyee90 requested review from sunjayBhatia and tsaarni and removed request for a team March 23, 2026 17:12
@sunjayBhatia sunjayBhatia requested review from a team, davinci26 and rajatvig and removed request for a team March 23, 2026 17:12
@github-actions
Copy link
Copy Markdown

Hi @Skyee90! Welcome to our community and thank you for opening your first Pull Request. Someone will review it soon. Thank you for committing to making Contour better. You can also join us on our mailing list and in our channel in the Kubernetes Slack Workspace

@Skyee90
Copy link
Copy Markdown
Author

Skyee90 commented Apr 1, 2026

@davinci26 HI, I'd appreciate it if you could review this PR when you have time.
Happy to make any changes if needed!

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 2, 2026

The Contour project currently lacks enough contributors to adequately respond to all PRs.

This bot triages PRs according to the following rules:

  • After 30d of inactivity, lifecycle/stale is applied
  • After 60d of inactivity since lifecycle/stale was applied, the PR is closed

You can:

  • Ensure your PR is passing all CI checks. PRs that are fully green are more likely to be reviewed. If you are having trouble with CI checks, reach out to the #contour channel in the Kubernetes Slack workspace.
  • Mark this PR as fresh by commenting or pushing a commit
  • Close this PR
  • Offer to help out with triage

Please send feedback to the #contour channel in the Kubernetes Slack

@github-actions github-actions Bot added the lifecycle/stale Denotes an issue or PR has remained open with no activity and has become stale. label May 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

lifecycle/stale Denotes an issue or PR has remained open with no activity and has become stale.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant