kubernetes-sigs / kubernetes-sigs/gateway-api

Gateway doc needs improvements regarding inter Gateway listener conflicts

Open Beginner friendly
#4,161 7 comments 0 reactions 0 assignees View on GitHub
kind/documentation lifecycle/active
Dominant language
Go
Stars
3k
Forks
789
Avg merge
2d 15h
Merged PRs (30d)
45

Description

**What would you like to be added**:
Clarify on our docs and API docs what should happen when 2 distinct Gateways have a conflict on a listener. Per the discussion on our community meeting: https://youtu.be/AShtmkJXAR8?si=qFA86Z21O7ncoqsL&t=1032

- Two Gateways CAN have the same listeners, even if they conflict, as each gateway should be an independent instance
- Implementations that merge all of their listeners on a single proxy instance SHOULD work internally on the listener isolation
- Implementations that merge all of their listeners on a single proxy but can't isolate the bind/listener MUST add a condition to the Gateway (this is Implementation Specific)

**Why this is needed**:

Clarify when conflicts may exist

/cc @candita @youngnick

Contributor guide

Open the contributing guide

Research direction

Start by reviewing the project documentation and API documentation areas, then read the linked community-meeting discussion for the intended listener-conflict behavior. Update both documentation surfaces to clarify the three stated cases, including when an implementation-specific Gateway condition is required; the work is done when conflicts between distinct Gateways and listener isolation are unambiguous.

Written by the indexing model from the issue text.

Assessment

Tech stack
kubernetes
Domain
api, documentation, networking
Issue type
Documentation
Difficulty
2/5
Estimated time
Half a day
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
68/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.