Skip to content

Commit a7dd8ef

Browse files
committed
Use XListenerSet on example kinds
1 parent 77cfafd commit a7dd8ef

File tree

1 file changed

+17
-14
lines changed

1 file changed

+17
-14
lines changed

geps/gep-1713/index.md

Lines changed: 17 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,9 @@ The feature will be part of the experimental channel, which implementations can
4949

5050
This proposal introduces a new `ListenerSet` resource that has the ability to attach a set of listeners to multiple parent `Gateways`.
5151

52+
**Note**: While this API is experimental, its `Kind` will be `XListenerSet` and
53+
once the API is gratuated to stable it will be renamed to `ListenerSet`.
54+
5255
### Go
5356

5457
```go
@@ -362,7 +365,7 @@ spec:
362365
port: 80
363366
---
364367
apiVersion: gateway.networking.x-k8s.io/v1alpha1
365-
kind: ListenerSet
368+
kind: XListenerSet
366369
metadata:
367370
name: first-workload-listeners
368371
spec:
@@ -383,7 +386,7 @@ spec:
383386
name: first-workload-cert # Provisioned via HTTP01 challenge
384387
---
385388
apiVersion: gateway.networking.x-k8s.io/v1alpha1
386-
kind: ListenerSet
389+
kind: XListenerSet
387390
metadata:
388391
name: second-workload-listeners
389392
spec:
@@ -449,11 +452,11 @@ metadata:
449452
spec:
450453
parentRefs:
451454
- name: second-workload-listeners
452-
kind: ListenerSet
455+
kind: XListenerSet
453456
sectionName: second
454457
```
455458

456-
If routes MUST attach to a `ListenerSet` and its parent `Gateway`, it MUST have multiple `parentRefs` eg:
459+
If routes MUST attach to a `XListenerSet` and its parent `Gateway`, it MUST have multiple `parentRefs` eg:
457460

458461
```yaml
459462
apiVersion: gateway.networking.k8s.io/v1
@@ -463,14 +466,14 @@ metadata:
463466
spec:
464467
parentRefs:
465468
- name: second-workload-listeners
466-
kind: ListenerSet
469+
kind: XListenerSet
467470
sectionName: second
468471
- name: parent-gateway
469472
kind: Gateway
470473
sectionName: foo
471474
```
472475

473-
For instance, the following `HTTPRoute` attempts to attach to a listener defined in the parent `Gateway` using the sectionName `foo`, which also exists on a ListenerSet.
476+
For instance, the following `HTTPRoute` attempts to attach to a listener defined in the parent `Gateway` using the sectionName `foo`, which also exists on a `ListenerSet`.
474477
This is not valid and the route's status `Accepted` condition should be set to `False`
475478

476479
```yaml
@@ -490,7 +493,7 @@ spec:
490493
port: 80
491494
---
492495
apiVersion: gateway.networking.x-k8s.io/v1alpha1
493-
kind: ListenerSet
496+
kind: XListenerSet
494497
metadata:
495498
name: first-workload-listeners
496499
spec:
@@ -547,7 +550,7 @@ spec:
547550
port: 80
548551
---
549552
apiVersion: gateway.networking.x-k8s.io/v1alpha1
550-
kind: ListenerSet
553+
kind: XListenerSet
551554
metadata:
552555
name: first-workload-listeners
553556
spec:
@@ -709,7 +712,7 @@ spec:
709712
name: default-cert
710713
---
711714
apiVersion: gateway.networking.x-k8s.io/v1alpha1
712-
kind: ListenerSet
715+
kind: XListenerSet
713716
metadata:
714717
name: user-listenerset
715718
namespace: user01
@@ -738,7 +741,7 @@ but they use different termination TLS certificates:
738741

739742
```yaml
740743
apiVersion: gateway.networking.x-k8s.io/v1alpha1
741-
kind: ListenerSet
744+
kind: XListenerSet
742745
metadata:
743746
name: user-listenerset
744747
namespace: user01
@@ -770,7 +773,7 @@ was not accepted
770773

771774
```yaml
772775
apiVersion: gateway.networking.x-k8s.io/v1alpha1
773-
kind: ListenerSet
776+
kind: XListenerSet
774777
metadata:
775778
creationTimestamp: "2025-08-11T15:44:05Z"
776779
name: listenerset1
@@ -793,7 +796,7 @@ spec:
793796
name: app-cert
794797
---
795798
apiVersion: gateway.networking.x-k8s.io/v1alpha1
796-
kind: ListenerSet
799+
kind: XListenerSet
797800
metadata:
798801
creationTimestamp: "2025-08-11T13:44:05Z"
799802
name: listenerset2
@@ -825,7 +828,7 @@ The status of ListenerSets can be defined as the following:
825828

826829
```yaml
827830
apiVersion: gateway.networking.x-k8s.io/v1alpha1
828-
kind: ListenerSet
831+
kind: XListenerSet
829832
metadata:
830833
creationTimestamp: "2025-08-11T15:44:05Z"
831834
name: listenerset1
@@ -843,7 +846,7 @@ status:
843846
type: Conflicted
844847
---
845848
apiVersion: gateway.networking.x-k8s.io/v1alpha1
846-
kind: ListenerSet
849+
kind: XListenerSet
847850
metadata:
848851
creationTimestamp: "2025-08-11T13:44:05Z"
849852
name: listenerset2

0 commit comments

Comments
 (0)