diff --git a/changelogs/CHANGELOG-v1.28.2.md b/changelogs/CHANGELOG-v1.28.2.md new file mode 100644 index 00000000000..9ac00a33ff1 --- /dev/null +++ b/changelogs/CHANGELOG-v1.28.2.md @@ -0,0 +1,36 @@ +We are delighted to present version v1.28.2 of Contour, our layer 7 HTTP reverse proxy for Kubernetes clusters. + +- [All Changes](#all-changes) +- [Installing/Upgrading](#installing-and-upgrading) +- [Compatible Kubernetes Versions](#compatible-kubernetes-versions) + +# All Changes + +## Update Envoy to v1.29.2 + +See the release notes [here](https://www.envoyproxy.io/docs/envoy/v1.29.2/version_history/v1.29/v1.29.2). + +Note that this Envoy version reverts the HTTP/2 codec back to `nghttp2` from `oghttp2`. + +## Disable Envoy removing TE header + +As of version v1.29.0, Envoy removes the hop-by-hop TE header. +However, this causes issues with HTTP/2, particularly gRPC, with implementations expecting the header to be present (and set to `trailers`). +Contour disables this via Envoy runtime setting and reverts to the v1.28.x and prior behavior of allowing the header to be proxied. + +Once [this Envoy PR that enables the TE header including `trailers` to be forwarded](https://github.com/envoyproxy/envoy/pull/32255) is backported to a release or a new minor is cut, Contour will no longer set the aforementioned runtime key. + +# Installing and Upgrading + +For a fresh install of Contour, consult the [getting started documentation](https://projectcontour.io/getting-started/). + +To upgrade an existing Contour installation, please consult the [upgrade documentation](https://projectcontour.io/resources/upgrading/). + + +# Compatible Kubernetes Versions + +Contour v1.28.2 is tested against Kubernetes 1.27 through 1.29. + + +# Are you a Contour user? We would love to know! +If you're using Contour and want to add your organization to our adopters list, please visit this [page](https://projectcontour.io/resources/adopters/). If you prefer to keep your organization name anonymous but still give us feedback into your usage and scenarios for Contour, please post on this [GitHub thread](https://github.com/projectcontour/contour/issues/1269). diff --git a/site/content/resources/compatibility-matrix.md b/site/content/resources/compatibility-matrix.md index b46f17aff1d..c1b76b19501 100644 --- a/site/content/resources/compatibility-matrix.md +++ b/site/content/resources/compatibility-matrix.md @@ -11,6 +11,7 @@ These combinations of versions are specifically tested in CI and supported by th | Contour Version | Envoy Version | Kubernetes Versions | Gateway API Version | | --------------- | :------------------- | ------------------- | --------------------| | main | [1.29.2][49] | 1.29, 1.28, 1.27 | [1.0.0][110] | +| 1.28.2 | [1.29.2][49] | 1.29, 1.28, 1.27 | [1.0.0][110] | | 1.28.1 | [1.29.1][46] | 1.29, 1.28, 1.27 | [1.0.0][110] | | 1.28.0 | [1.29.1][46] | 1.29, 1.28, 1.27 | [1.0.0][110] | | 1.27.1 | [1.28.1][47] | 1.28, 1.27, 1.26 | [0.8.1][109] | diff --git a/versions.yaml b/versions.yaml index 5f50fbf9aa5..6c933d858f6 100644 --- a/versions.yaml +++ b/versions.yaml @@ -14,8 +14,18 @@ versions: - "1.27" gateway-api: - "1.0.0" - - version: v1.28.1 + - version: v1.28.2 supported: "true" + dependencies: + envoy: "1.29.2" + kubernetes: + - "1.29" + - "1.28" + - "1.27" + gateway-api: + - "1.0.0" + - version: v1.28.1 + supported: "false" dependencies: envoy: "1.29.1" kubernetes: