Skip to content

Commit

Permalink
v1.26.3, v1.27.2, v1.28.3 patch release docs (projectcontour#6333)
Browse files Browse the repository at this point in the history
* changelogs
* versions.yaml, compatibility matrix

Signed-off-by: Steve Kriss <stephen.kriss@gmail.com>
Signed-off-by: Saman Mahdanian <saman@mahdanian.xyz>
  • Loading branch information
skriss authored and SamMHD committed Sep 8, 2024
1 parent d8fceef commit 53b5f75
Show file tree
Hide file tree
Showing 5 changed files with 122 additions and 3 deletions.
25 changes: 25 additions & 0 deletions changelogs/CHANGELOG-v1.26.3.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
We are delighted to present version v1.26.3 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

- Updates Envoy to v1.27.4. See the release notes for v1.27.4 [here](https://www.envoyproxy.io/docs/envoy/v1.27.4/version_history/v1.27/v1.27.4).
- Updates Go to v1.20.14. See the release notes for v1.20.14 [here](https://go.dev/doc/devel/release#go1.20.minor).

# 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.26.3 is tested against Kubernetes 1.26 through 1.28.


# 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).
25 changes: 25 additions & 0 deletions changelogs/CHANGELOG-v1.27.2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
We are delighted to present version v1.27.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

- Updates Envoy to v1.28.2. See the release notes for v1.28.2 [here](https://www.envoyproxy.io/docs/envoy/v1.28.2/version_history/v1.28/v1.28.2).
- Updates Go to v1.21.9. See the release notes for v1.21.9 [here](https://go.dev/doc/devel/release#go1.21.minor).

# 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.27.2 is tested against Kubernetes 1.26 through 1.28.


# 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).
34 changes: 34 additions & 0 deletions changelogs/CHANGELOG-v1.28.3.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
We are delighted to present version v1.28.3 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.3

See the release notes for v1.29.3 [here](https://www.envoyproxy.io/docs/envoy/v1.29.3/version_history/v1.29/v1.29.3).

Note that this Envoy version retains the hop-by-hop TE header when set to `trailers`, fixing a regression seen in v1.29.0-v1.29.2 for HTTP/2, particularly gRPC.
However, this version of Contour continues to set the `envoy.reloadable_features.sanitize_te` Envoy runtime setting to `false` to ensure seamless upgrades.
This runtime setting will be removed in Contour v1.29.0.

## Update Go to v1.21.9

See the release notes for v1.21.9 [here](https://go.dev/doc/devel/release#go1.21.minor).

# 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.3 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).
5 changes: 5 additions & 0 deletions site/content/resources/compatibility-matrix.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,11 +11,14 @@ 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.3][50] | 1.29, 1.28, 1.27 | [1.0.0][110] |
| 1.28.3 | [1.29.3][50] | 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.2 | [1.28.2][52] | 1.28, 1.27, 1.26 | [0.8.1][109] |
| 1.27.1 | [1.28.1][47] | 1.28, 1.27, 1.26 | [0.8.1][109] |
| 1.27.0 | [1.28.0][45] | 1.28, 1.27, 1.26 | [0.8.1][109] |
| 1.26.3 | [1.27.4][51] | 1.28, 1.27, 1.26 | [0.8.1][109] |
| 1.26.2 | [1.27.3][48] | 1.28, 1.27, 1.26 | [0.8.1][109] |
| 1.26.1 | [1.27.2][42] | 1.28, 1.27, 1.26 | [0.8.1][109] |
| 1.26.0 | [1.27.0][41] | 1.28, 1.27, 1.26 | [0.8.0][108] |
Expand Down Expand Up @@ -184,6 +187,8 @@ __Note:__ This list of extensions was last verified to be complete with Envoy v1
[48]: https://www.envoyproxy.io/docs/envoy/v1.27.3/version_history/v1.27/v1.27.3
[49]: https://www.envoyproxy.io/docs/envoy/v1.29.2/version_history/v1.29/v1.29.2
[50]: https://www.envoyproxy.io/docs/envoy/v1.29.3/version_history/v1.29/v1.29.3
[51]: https://www.envoyproxy.io/docs/envoy/v1.27.4/version_history/v1.27/v1.27.4
[52]: https://www.envoyproxy.io/docs/envoy/v1.28.2/version_history/v1.28/v1.28.2

[98]: https://github.com/kubernetes/client-go
[99]: https://github.com/kubernetes/client-go#compatibility-matrix
Expand Down
36 changes: 33 additions & 3 deletions versions.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,18 @@ versions:
- "1.27"
gateway-api:
- "1.0.0"
- version: v1.28.2
- version: v1.28.3
supported: "true"
dependencies:
envoy: "1.29.3"
kubernetes:
- "1.29"
- "1.28"
- "1.27"
gateway-api:
- "1.0.0"
- version: v1.28.2
supported: "false"
dependencies:
envoy: "1.29.2"
kubernetes:
Expand Down Expand Up @@ -44,8 +54,18 @@ versions:
- "1.27"
gateway-api:
- "1.0.0"
- version: v1.27.1
- version: v1.27.2
supported: "true"
dependencies:
envoy: "1.28.2"
kubernetes:
- "1.28"
- "1.27"
- "1.26"
gateway-api:
- "0.8.1"
- version: v1.27.1
supported: "false"
dependencies:
envoy: "1.28.1"
kubernetes:
Expand All @@ -64,8 +84,18 @@ versions:
- "1.26"
gateway-api:
- "0.8.1"
- version: v1.26.2
- version: v1.26.3
supported: "true"
dependencies:
envoy: "1.27.4"
kubernetes:
- "1.28"
- "1.27"
- "1.26"
gateway-api:
- "0.8.1"
- version: v1.26.2
supported: "false"
dependencies:
envoy: "1.27.3"
kubernetes:
Expand Down

0 comments on commit 53b5f75

Please sign in to comment.