You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: geps/gep-1713/index.md
+17-14Lines changed: 17 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -49,6 +49,9 @@ The feature will be part of the experimental channel, which implementations can
49
49
50
50
This proposal introduces a new `ListenerSet` resource that has the ability to attach a set of listeners to multiple parent `Gateways`.
51
51
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
+
52
55
### Go
53
56
54
57
```go
@@ -362,7 +365,7 @@ spec:
362
365
port: 80
363
366
---
364
367
apiVersion: gateway.networking.x-k8s.io/v1alpha1
365
-
kind: ListenerSet
368
+
kind: XListenerSet
366
369
metadata:
367
370
name: first-workload-listeners
368
371
spec:
@@ -383,7 +386,7 @@ spec:
383
386
name: first-workload-cert # Provisioned via HTTP01 challenge
384
387
---
385
388
apiVersion: gateway.networking.x-k8s.io/v1alpha1
386
-
kind: ListenerSet
389
+
kind: XListenerSet
387
390
metadata:
388
391
name: second-workload-listeners
389
392
spec:
@@ -449,11 +452,11 @@ metadata:
449
452
spec:
450
453
parentRefs:
451
454
- name: second-workload-listeners
452
-
kind: ListenerSet
455
+
kind: XListenerSet
453
456
sectionName: second
454
457
```
455
458
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:
457
460
458
461
```yaml
459
462
apiVersion: gateway.networking.k8s.io/v1
@@ -463,14 +466,14 @@ metadata:
463
466
spec:
464
467
parentRefs:
465
468
- name: second-workload-listeners
466
-
kind: ListenerSet
469
+
kind: XListenerSet
467
470
sectionName: second
468
471
- name: parent-gateway
469
472
kind: Gateway
470
473
sectionName: foo
471
474
```
472
475
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`.
474
477
This is not valid and the route's status `Accepted` condition should be set to `False`
475
478
476
479
```yaml
@@ -490,7 +493,7 @@ spec:
490
493
port: 80
491
494
---
492
495
apiVersion: gateway.networking.x-k8s.io/v1alpha1
493
-
kind: ListenerSet
496
+
kind: XListenerSet
494
497
metadata:
495
498
name: first-workload-listeners
496
499
spec:
@@ -547,7 +550,7 @@ spec:
547
550
port: 80
548
551
---
549
552
apiVersion: gateway.networking.x-k8s.io/v1alpha1
550
-
kind: ListenerSet
553
+
kind: XListenerSet
551
554
metadata:
552
555
name: first-workload-listeners
553
556
spec:
@@ -709,7 +712,7 @@ spec:
709
712
name: default-cert
710
713
---
711
714
apiVersion: gateway.networking.x-k8s.io/v1alpha1
712
-
kind: ListenerSet
715
+
kind: XListenerSet
713
716
metadata:
714
717
name: user-listenerset
715
718
namespace: user01
@@ -738,7 +741,7 @@ but they use different termination TLS certificates:
738
741
739
742
```yaml
740
743
apiVersion: gateway.networking.x-k8s.io/v1alpha1
741
-
kind: ListenerSet
744
+
kind: XListenerSet
742
745
metadata:
743
746
name: user-listenerset
744
747
namespace: user01
@@ -770,7 +773,7 @@ was not accepted
770
773
771
774
```yaml
772
775
apiVersion: gateway.networking.x-k8s.io/v1alpha1
773
-
kind: ListenerSet
776
+
kind: XListenerSet
774
777
metadata:
775
778
creationTimestamp: "2025-08-11T15:44:05Z"
776
779
name: listenerset1
@@ -793,7 +796,7 @@ spec:
793
796
name: app-cert
794
797
---
795
798
apiVersion: gateway.networking.x-k8s.io/v1alpha1
796
-
kind: ListenerSet
799
+
kind: XListenerSet
797
800
metadata:
798
801
creationTimestamp: "2025-08-11T13:44:05Z"
799
802
name: listenerset2
@@ -825,7 +828,7 @@ The status of ListenerSets can be defined as the following:
0 commit comments