Skip to content

feat(api): add HTTP/2 connection keepalive to ClientTrafficPolicy and BackendTrafficPolicy #8215

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
rajatvig wants to merge 10 commits into
base: main
Choose a base branch
from
+2,243 −0
Open

feat(api): add HTTP/2 connection keepalive to ClientTrafficPolicy and BackendTrafficPolicy #8215

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
fff4d05
feat(api): add HTTP/2 connection keepalive to ClientTrafficPolicy and…
rajatvig Feb 8, 2026
b927fd8
add intervalJitter
rajatvig Feb 9, 2026
55cfed6
add generated code
rajatvig Feb 9, 2026
f3fbb68
add validations
rajatvig Feb 9, 2026
1eb2bf7
add CEL validations + change buildHTTP2Settings
rajatvig Feb 16, 2026
63f3e61
Merge remote-tracking branch 'upstream/main' into feature/http2-keepa…
rajatvig Feb 16, 2026
4971497
fix: gen code
rajatvig Feb 16, 2026
fa3c82a
fix: use metav1.Duration in IR
rajatvig Feb 16, 2026
d86786e
fix: gen code
rajatvig Feb 16, 2026
2569836
Merge remote-tracking branch 'upstream/main' into feature/http2-keepa…
rajatvig Feb 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 27 additions & 0 deletions api/v1alpha1/shared_types.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -718,6 +718,33 @@ type HTTP2Settings struct {
// Default: TerminateConnection
// +optional
OnInvalidMessage *InvalidMessageAction `json:"onInvalidMessage,omitempty"`

// ConnectionKeepalive configures HTTP/2 connection keepalive using PING frames.
// +optional
ConnectionKeepalive *HTTP2ConnectionKeepalive `json:"connectionKeepalive,omitempty"`
}

// HTTP2ConnectionKeepalive configures HTTP/2 PING-based keepalive settings.
// +kubebuilder:validation:XValidation:rule="!has(self.timeout) || !has(self.interval) || duration(self.timeout) < duration(self.interval)",message="timeout must be less than interval"
type HTTP2ConnectionKeepalive struct {
// Interval specifies how often to send HTTP/2 PING frames to keep the connection alive.
// +optional
Interval *gwapiv1.Duration `json:"interval,omitempty"`

// Timeout specifies how long to wait for a PING response before considering the connection dead.
// +optional
Timeout *gwapiv1.Duration `json:"timeout,omitempty"`

// IntervalJitter specifies a random jitter percentage added to each interval.
// Defaults to 15% if not specified.
// +kubebuilder:validation:Minimum=0
// +kubebuilder:validation:Maximum=100
// +optional
IntervalJitter *uint32 `json:"intervalJitter,omitempty"`

// ConnectionIdleInterval specifies how long a connection must be idle before a PING is sent.
// +optional
ConnectionIdleInterval *gwapiv1.Duration `json:"connectionIdleInterval,omitempty"`
}

// ResponseOverride defines the configuration to override specific responses with a custom one.
Expand Down
40 changes: 40 additions & 0 deletions api/v1alpha1/zz_generated.deepcopy.go
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

32 changes: 32 additions & 0 deletions ...s/gateway-crds-helm/templates/generated/gateway.envoyproxy.io_backendtrafficpolicies.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -649,6 +649,38 @@ spec:
http2:
description: HTTP2 provides HTTP/2 configuration for backend connections.
properties:
connectionKeepalive:
description: ConnectionKeepalive configures HTTP/2 connection
keepalive using PING frames.
properties:
connectionIdleInterval:
description: ConnectionIdleInterval specifies how long a connection
must be idle before a PING is sent.
pattern: ^([0-9]{1,5}(h|m|s|ms)){1,4}$
type: string
interval:
description: Interval specifies how often to send HTTP/2 PING
frames to keep the connection alive.
pattern: ^([0-9]{1,5}(h|m|s|ms)){1,4}$
type: string
intervalJitter:
description: |-
IntervalJitter specifies a random jitter percentage added to each interval.
Defaults to 15% if not specified.
format: int32
maximum: 100
minimum: 0
type: integer
timeout:
description: Timeout specifies how long to wait for a PING
response before considering the connection dead.
pattern: ^([0-9]{1,5}(h|m|s|ms)){1,4}$
type: string
type: object
x-kubernetes-validations:
- message: timeout must be less than interval
rule: '!has(self.timeout) || !has(self.interval) || duration(self.timeout)
< duration(self.interval)'
initialConnectionWindowSize:
allOf:
- pattern: ^(\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))(([KMGTPE]i)|[numkMGTPE]|([eE](\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))))?$
Expand Down
32 changes: 32 additions & 0 deletions ...ts/gateway-crds-helm/templates/generated/gateway.envoyproxy.io_clienttrafficpolicies.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -799,6 +799,38 @@ spec:
http2:
description: HTTP2 provides HTTP/2 configuration on the listener.
properties:
connectionKeepalive:
description: ConnectionKeepalive configures HTTP/2 connection
keepalive using PING frames.
properties:
connectionIdleInterval:
description: ConnectionIdleInterval specifies how long a connection
must be idle before a PING is sent.
pattern: ^([0-9]{1,5}(h|m|s|ms)){1,4}$
type: string
interval:
description: Interval specifies how often to send HTTP/2 PING
frames to keep the connection alive.
pattern: ^([0-9]{1,5}(h|m|s|ms)){1,4}$
type: string
intervalJitter:
description: |-
IntervalJitter specifies a random jitter percentage added to each interval.
Defaults to 15% if not specified.
format: int32
maximum: 100
minimum: 0
type: integer
timeout:
description: Timeout specifies how long to wait for a PING
response before considering the connection dead.
pattern: ^([0-9]{1,5}(h|m|s|ms)){1,4}$
type: string
type: object
x-kubernetes-validations:
- message: timeout must be less than interval
rule: '!has(self.timeout) || !has(self.interval) || duration(self.timeout)
< duration(self.interval)'
initialConnectionWindowSize:
allOf:
- pattern: ^(\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))(([KMGTPE]i)|[numkMGTPE]|([eE](\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))))?$
Expand Down
34 changes: 34 additions & 0 deletions ...s/gateway-crds-helm/templates/generated/gateway.envoyproxy.io_envoyextensionpolicies.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -710,6 +710,40 @@ spec:
description: HTTP2 provides HTTP/2 configuration for backend
connections.
properties:
connectionKeepalive:
description: ConnectionKeepalive configures HTTP/2 connection
keepalive using PING frames.
properties:
connectionIdleInterval:
description: ConnectionIdleInterval specifies how
long a connection must be idle before a PING is
sent.
pattern: ^([0-9]{1,5}(h|m|s|ms)){1,4}$
type: string
interval:
description: Interval specifies how often to send
HTTP/2 PING frames to keep the connection alive.
pattern: ^([0-9]{1,5}(h|m|s|ms)){1,4}$
type: string
intervalJitter:
description: |-
IntervalJitter specifies a random jitter percentage added to each interval.
Defaults to 15% if not specified.
format: int32
maximum: 100
minimum: 0
type: integer
timeout:
description: Timeout specifies how long to wait
for a PING response before considering the connection
dead.
pattern: ^([0-9]{1,5}(h|m|s|ms)){1,4}$
type: string
type: object
x-kubernetes-validations:
- message: timeout must be less than interval
rule: '!has(self.timeout) || !has(self.interval) ||
duration(self.timeout) < duration(self.interval)'
initialConnectionWindowSize:
allOf:
- pattern: ^(\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))(([KMGTPE]i)|[numkMGTPE]|([eE](\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))))?$
Expand Down
Loading
Loading