Skip to content

Commit cc0465d

Browse files
authored
Merge pull request #48799 from sftim/20241121_gateway_api_1_2_cleanup
Clean up Gateway API v1.2 announcement
2 parents 0660aca + 2580e9c commit cc0465d

File tree

2 files changed

+20
-18
lines changed

2 files changed

+20
-18
lines changed

content/en/blog/_posts/2024-09-30-gateway-api-v1.2/index.md renamed to content/en/blog/_posts/2024-11-21-gateway-api-v1-2/index.md

Lines changed: 20 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ number of conformant implementations of it for you to try out.
1515

1616
Gateway API v1.2 brings a number of new features to the _Standard channel_
1717
(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
1919
changes that you'll want to be careful of.
2020

2121
## Breaking changes
@@ -39,7 +39,7 @@ information about what you need to do to safely upgrade.
3939

4040
[release notes]: https://github.com/kubernetes-sigs/gateway-api/releases/tag/v1.2.0
4141

42-
### Change to `.status.supportedFeatures` (experimental){#status-supported-features}
42+
### Change to `.status.supportedFeatures` (experimental) {#status-supported-features}
4343

4444
A much smaller breaking change: `.status.supportedFeatures` in a Gateway is
4545
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
5959
information on how all of this works, refer to the [Gateway API Versioning
6060
Policy](https://gateway-api.sigs.k8s.io/concepts/versioning/).
6161

62-
### HTTPRoute Timeouts
62+
### HTTPRoute timeouts
6363

6464
[GEP-1742](https://gateway-api.sigs.k8s.io/geps/gep-1742/) introduced the
6565
`timeouts` stanza into HTTPRoute, permitting configuring basic timeouts for
@@ -132,23 +132,25 @@ spec:
132132
linkerd.io/inject: enabled
133133
```
134134

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).
137137

138138
### Backend protocol support
139139

140140
Since Kubernetes v1.20, the Service and EndpointSlice resources have supported
141141
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),
144144
Kubernetes now supports three new `appProtocol` values:
145145

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)
152154

153155
With Gateway API 1.2.0, support for honoring `appProtocol` is now Standard.
154156
For example, given the following Service:
@@ -254,8 +256,8 @@ For more information, check out [GEP
254256

255257
### HTTPRoute percentage-based mirroring
256258

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/)
259261
feature, which allows sending the same request to multiple backends. In
260262
Gateway API 1.2.0, we're introducing percentage-based mirroring, which allows
261263
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
310312
### Additional backend TLS configuration
311313

312314
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_):
314316

315317
1. **A new `backendTLS` field on Gateway**
316318

@@ -383,13 +385,13 @@ https://github.com/kubernetes-sigs/gwctl. `gwctl` has proven a valuable tool
383385
for the Gateway API community; moving it into its own repository will, we
384386
believe, make it easier to maintain and develop. As always, we welcome
385387
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!
387389

388390
### Maintainer changes
389391

390392
Rounding out our changes to the project itself, we're pleased to announce that
391393
[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
393395
happily, [Mike Morris] has returned to the role. We're grateful for everything
394396
Keith has done, and excited to have Mattia and Mike on board.
395397

0 commit comments

Comments
 (0)