@@ -15,7 +15,7 @@ number of conformant implementations of it for you to try out.
15
15
16
16
Gateway API v1.2 brings a number of new features to the _ Standard channel_
17
17
(Gateway API's GA release channel), introduces some new experimental features,
18
- and inaugurates our new release process -- but it also brings two breaking
18
+ and inaugurates our new release process — but it also brings two breaking
19
19
changes that you'll want to be careful of.
20
20
21
21
## Breaking changes
@@ -39,7 +39,7 @@ information about what you need to do to safely upgrade.
39
39
40
40
[ release notes ] : https://github.com/kubernetes-sigs/gateway-api/releases/tag/v1.2.0
41
41
42
- ### Change to ` .status.supportedFeatures ` (experimental){#status-supported-features}
42
+ ### Change to ` .status.supportedFeatures ` (experimental) {#status-supported-features}
43
43
44
44
A much smaller breaking change: ` .status.supportedFeatures ` in a Gateway is
45
45
now a list of objects instead of a list of strings. The objects have a single
@@ -59,7 +59,7 @@ refinements and improvements to these new features in the future. For more
59
59
information on how all of this works, refer to the [ Gateway API Versioning
60
60
Policy] ( https://gateway-api.sigs.k8s.io/concepts/versioning/ ) .
61
61
62
- ### HTTPRoute Timeouts
62
+ ### HTTPRoute timeouts
63
63
64
64
[ GEP-1742] ( https://gateway-api.sigs.k8s.io/geps/gep-1742/ ) introduced the
65
65
` timeouts ` stanza into HTTPRoute, permitting configuring basic timeouts for
@@ -132,23 +132,25 @@ spec:
132
132
linkerd.io/inject: enabled
133
133
` ` `
134
134
135
- For more information, check out the [`infrastructure` API
136
- reference](https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1.GatewayInfrastructure).
135
+ For more information, check out the
136
+ [`infrastructure` API reference](https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1.GatewayInfrastructure).
137
137
138
138
# ## Backend protocol support
139
139
140
140
Since Kubernetes v1.20, the Service and EndpointSlice resources have supported
141
141
a stable `appProtocol` field to allow users to specify the L7 protocol that
142
- Service supports. With the adoption of [KEP
143
- 3726](https://github.com/kubernetes/enhancements/tree/master/keps/sig-network/3726-standard-application-protocols),
142
+ Service supports. With the adoption of
143
+ [KEP 3726](https://github.com/kubernetes/enhancements/tree/master/keps/sig-network/3726-standard-application-protocols),
144
144
Kubernetes now supports three new `appProtocol` values :
145
145
146
- - ` kubernetes.io/h2c` - HTTP/2 over cleartext as described in
147
- [RFC7540](https://www.rfc-editor.org/rfc/rfc7540)
148
- - ` kubernetes.io/ws` - WebSocket over cleartext as described in
149
- [RFC6445](https://www.rfc-editor.org/rfc/rfc6445)
150
- - ` kubernetes.io/wss` - WebSocket over TLS as described in
151
- [RFC6445](https://www.rfc-editor.org/rfc/rfc6445)
146
+ ` kubernetes.io/h2c`
147
+ : HTTP/2 over cleartext as described in [RFC7540](https://www.rfc-editor.org/rfc/rfc7540)
148
+
149
+ ` kubernetes.io/ws`
150
+ : WebSocket over cleartext as described in [RFC6445](https://www.rfc-editor.org/rfc/rfc6445)
151
+
152
+ ` kubernetes.io/wss`
153
+ : WebSocket over TLS as described in [RFC6445](https://www.rfc-editor.org/rfc/rfc6445)
152
154
153
155
With Gateway API 1.2.0, support for honoring `appProtocol` is now Standard.
154
156
For example, given the following Service :
@@ -254,8 +256,8 @@ For more information, check out [GEP
254
256
255
257
# ## HTTPRoute percentage-based mirroring
256
258
257
- Gateway API has long supported the [Request
258
- Mirroring](https://gateway-api.sigs.k8s.io/guides/http-request-mirroring/)
259
+ Gateway API has long supported the
260
+ [Request Mirroring](https://gateway-api.sigs.k8s.io/guides/http-request-mirroring/)
259
261
feature, which allows sending the same request to multiple backends. In
260
262
Gateway API 1.2.0, we're introducing percentage-based mirroring, which allows
261
263
you to specify a percentage of requests to mirror to a different backend. For
@@ -310,7 +312,7 @@ which may be relevant with very high request rates. For more details, see
310
312
# ## Additional backend TLS configuration
311
313
312
314
This release includes three additions related to TLS configuration for
313
- communications between a Gateway and a workload (a "backend" ) :
315
+ communications between a Gateway and a workload (a _backend_ ) :
314
316
315
317
1. **A new `backendTLS` field on Gateway**
316
318
@@ -383,13 +385,13 @@ https://github.com/kubernetes-sigs/gwctl. `gwctl` has proven a valuable tool
383
385
for the Gateway API community; moving it into its own repository will, we
384
386
believe, make it easier to maintain and develop. As always, we welcome
385
387
contributions; while still experimental, `gwctl` already helps make working
386
- with Gateway API a bit easier -- especially for newcomers to the project!
388
+ with Gateway API a bit easier — especially for newcomers to the project!
387
389
388
390
# ## Maintainer changes
389
391
390
392
Rounding out our changes to the project itself, we're pleased to announce that
391
393
[Mattia Lavacca] has joined the ranks of Gateway API Maintainers! We're also
392
- sad to announce that [Keith Mattix] has stepped down as a GAMMA lead --
394
+ sad to announce that [Keith Mattix] has stepped down as a GAMMA lead —
393
395
happily, [Mike Morris] has returned to the role. We're grateful for everything
394
396
Keith has done, and excited to have Mattia and Mike on board.
395
397
0 commit comments