Skip to content
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

use Gateway API release version in versions.yaml, compat matrix #5871

Merged
merged 2 commits into from
Oct 19, 2023
Merged

use Gateway API release version in versions.yaml, compat matrix #5871

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
93e3717
use Gateway API release version in versions.yaml, compat matrix
skriss Oct 19, 2023
2b613eb
changelog
skriss Oct 19, 2023
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
1 change: 1 addition & 0 deletions changelogs/unreleased/5871-skriss-docs.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
Switch to documenting the Gateway API release semantic version instead of API versions in versions.yaml and the [compatibility matrix](https://projectcontour.io/resources/compatibility-matrix/), to provide more information about features available with each release.
121 changes: 66 additions & 55 deletions site/content/resources/compatibility-matrix.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,67 +3,67 @@ title: Compatibility Matrix
layout: page
---

This page documents the compatibility matrix of versions of Contour, Envoy, Kubernetes, and the Contour Operator.
skriss marked this conversation as resolved.
Show resolved Hide resolved
This page documents the compatibility matrix of versions of Contour, Envoy, Kubernetes, and Gateway API.
These combinations of versions are specifically tested in CI and supported by the Contour maintainers.

## Compatibility Matrix

| Contour Version | Envoy Version | Kubernetes Versions | Operator Version | Gateway API Version |
| --------------- | :------------------- | ------------------- | ---------------- | --------------------|
| main | [1.27.2][42] | 1.28, 1.27, 1.26 | N/A | v1alpha2, v1beta1 |
| 1.26.1 | [1.27.2][42] | 1.28, 1.27, 1.26 | N/A | v1alpha2, v1beta1 |
| 1.26.0 | [1.27.0][41] | 1.28, 1.27, 1.26 | N/A | v1alpha2, v1beta1 |
| 1.25.3 | [1.26.6][43] | 1.27, 1.26, 1.25 | N/A | v1alpha2, v1beta1 |
| 1.25.2 | [1.26.4][40] | 1.27, 1.26, 1.25 | N/A | v1alpha2, v1beta1 |
| 1.25.1 | [1.26.4][40] | 1.27, 1.26, 1.25 | N/A | v1alpha2, v1beta1 |
| 1.25.0 | [1.26.1][35] | 1.27, 1.26, 1.25 | N/A | v1alpha2, v1beta1 |
| 1.24.6 | [1.25.11][44] | 1.26, 1.25, 1.24 | N/A | v1alpha2, v1beta1 |
| 1.24.5 | [1.25.9][39] | 1.26, 1.25, 1.24 | N/A | v1alpha2, v1beta1 |
| 1.24.4 | [1.25.6][36] | 1.26, 1.25, 1.24 | N/A | v1alpha2, v1beta1 |
| 1.24.3 | [1.25.4][32] | 1.26, 1.25, 1.24 | N/A | v1alpha2, v1beta1 |
| 1.24.2 | [1.25.2][31] | 1.26, 1.25, 1.24 | N/A | v1alpha2, v1beta1 |
| 1.24.1 | [1.25.1][28] | 1.26, 1.25, 1.24 | N/A | v1alpha2, v1beta1 |
| 1.24.0 | [1.25.0][25] | 1.26, 1.25, 1.24 | [1.24.0][75] | v1alpha2, v1beta1 |
| 1.23.6 | [1.24.10][38] | 1.25, 1.24, 1.23 | N/A | v1alpha2, v1beta1 |
| 1.23.5 | [1.24.5][33] | 1.25, 1.24, 1.23 | N/A | v1alpha2, v1beta1 |
| 1.23.4 | [1.24.3][30] | 1.25, 1.24, 1.23 | N/A | v1alpha2, v1beta1 |
| 1.23.3 | [1.24.2][27] | 1.25, 1.24, 1.23 | N/A | v1alpha2, v1beta1 |
| 1.23.2 | [1.24.1][24] | 1.25, 1.24, 1.23 | N/A | v1alpha2, v1beta1 |
| 1.23.1 | [1.24.1][24] | 1.25, 1.24, 1.23 | N/A | v1alpha2, v1beta1 |
| 1.23.0 | [1.24.0][21] | 1.25, 1.24, 1.23 | [1.23.0][74] | v1alpha2, v1beta1 |
| 1.22.6 | [1.23.7][34] | 1.24, 1.23, 1.22 | N/A | v1alpha2, v1beta1 |
| 1.22.5 | [1.23.5][29] | 1.24, 1.23, 1.22 | N/A | v1alpha2, v1beta1 |
| 1.22.4 | [1.23.4][26] | 1.24, 1.23, 1.22 | N/A | v1alpha2, v1beta1 |
| 1.22.3 | [1.23.3][23] | 1.24, 1.23, 1.22 | N/A | v1alpha2, v1beta1 |
| 1.22.2 | [1.23.3][23] | 1.24, 1.23, 1.22 | N/A | v1alpha2, v1beta1 |
| 1.22.1 | [1.23.1][20] | 1.24, 1.23, 1.22 | [1.22.1][73] | v1alpha2, v1beta1 |
| 1.22.0 | [1.23.0][19] | 1.24, 1.23, 1.22 | [1.22.0][72] | v1alpha2, v1beta1 |
| 1.21.3 | [1.22.6][22] | 1.23, 1.22, 1.21 | N/A | v1alpha2 |
| 1.21.2 | [1.22.6][22] | 1.23, 1.22, 1.21 | N/A | v1alpha2 |
| 1.21.1 | [1.22.2][17] | 1.23, 1.22, 1.21 | [1.21.1][70] | v1alpha2 |
| 1.21.0 | [1.22.0][16] | 1.23, 1.22, 1.21 | [1.21.0][69] | v1alpha2 |
| 1.20.2 | [1.21.3][18] | 1.23, 1.22, 1.21 | [1.20.2][71] | v1alpha2 |
| 1.20.1 | [1.21.1][15] | 1.23, 1.22, 1.21 | [1.20.1][68] | v1alpha2 |
| 1.20.0 | [1.21.0][14] | 1.23, 1.22, 1.21 | [1.20.0][67] | v1alpha2 |
| 1.19.1 | [1.19.1][13] | 1.22, 1.21, 1.20 | [1.19.1][65] | v1alpha1 |
| 1.19.0 | [1.19.1][13] | 1.22, 1.21, 1.20 | [1.19.0][64] | v1alpha1 |
| 1.18.3 | [1.19.1][13] | 1.21, 1.20, 1.19 | [1.18.3][66] | v1alpha1 |
| 1.18.2 | [1.19.1][13] | 1.21, 1.20, 1.19 | [1.18.2][63] | v1alpha1 |
| 1.18.1 | [1.19.1][13] | 1.21, 1.20, 1.19 | [1.18.1][62] | v1alpha1 |
| 1.18.0 | [1.19.0][10] | 1.21, 1.20, 1.19 | [1.18.0][61] | v1alpha1 |
| 1.17.2 | [1.18.4][12] | 1.21, 1.20, 1.19 | N/A | v1alpha1 |
| 1.17.1 | [1.18.3][9] | 1.21, 1.20, 1.19 | N/A | v1alpha1 |
| 1.17.0 | [1.18.3][9] | 1.21, 1.20, 1.19 | [1.17.0][60] | v1alpha1 |
| 1.16.1 | [1.18.4][12] | 1.21, 1.20, 1.19 | N/A | v1alpha1 |
| 1.16.0 | [1.18.3][9] | 1.21, 1.20, 1.19 | [1.16.0][59] | v1alpha1 |
| 1.15.2 | [1.18.4][12] | 1.21, 1.20, 1.19 | N/A | v1alpha1 |
| 1.15.1 | [1.18.3][9] | 1.21, 1.20, 1.19 | [1.15.1][58] | v1alpha1 |
| 1.15.0 | [1.18.2][8] | 1.21, 1.20, 1.19 | [1.15.0][57] | v1alpha1 |
| 1.14.2 | [1.17.4][11] | 1.20, 1.19, 1.18 | N/A | v1alpha1 |
| 1.14.1 | [1.17.2][7] | 1.20, 1.19, 1.18 | [1.14.1][56] | v1alpha1 |
| 1.14.0 | [1.17.1][6] | 1.20, 1.19, 1.18 | [1.14.0][55] | v1alpha1 |
| 1.13.1 | [1.17.1][6] | 1.20, 1.19, 1.18 | [1.13.1][54] | v1alpha1 |
| 1.13.0 | [1.17.0][5] | 1.20, 1.19, 1.18 | [1.13.0][53] | v1alpha1 |
| main | [1.27.2][42] | 1.28, 1.27, 1.26 | N/A | [0.8.1][109] |
| 1.26.1 | [1.27.2][42] | 1.28, 1.27, 1.26 | N/A | [0.8.1][109] |
| 1.26.0 | [1.27.0][41] | 1.28, 1.27, 1.26 | N/A | [0.8.0][108] |
| 1.25.3 | [1.26.6][43] | 1.27, 1.26, 1.25 | N/A | [0.6.2][107] |
| 1.25.2 | [1.26.4][40] | 1.27, 1.26, 1.25 | N/A | [0.6.2][107] |
| 1.25.1 | [1.26.4][40] | 1.27, 1.26, 1.25 | N/A | [0.6.2][107] |
| 1.25.0 | [1.26.1][35] | 1.27, 1.26, 1.25 | N/A | [0.6.2][107] |
| 1.24.6 | [1.25.11][44] | 1.26, 1.25, 1.24 | N/A | [0.6.0][106] |
| 1.24.5 | [1.25.9][39] | 1.26, 1.25, 1.24 | N/A | [0.6.0][106] |
| 1.24.4 | [1.25.6][36] | 1.26, 1.25, 1.24 | N/A | [0.6.0][106] |
| 1.24.3 | [1.25.4][32] | 1.26, 1.25, 1.24 | N/A | [0.6.0][106] |
| 1.24.2 | [1.25.2][31] | 1.26, 1.25, 1.24 | N/A | [0.6.0][106] |
| 1.24.1 | [1.25.1][28] | 1.26, 1.25, 1.24 | N/A | [0.6.0][106] |
| 1.24.0 | [1.25.0][25] | 1.26, 1.25, 1.24 | [1.24.0][75] | [0.6.0][106] |
| 1.23.6 | [1.24.10][38] | 1.25, 1.24, 1.23 | N/A | [0.5.1][105] |
| 1.23.5 | [1.24.5][33] | 1.25, 1.24, 1.23 | N/A | [0.5.1][105] |
| 1.23.4 | [1.24.3][30] | 1.25, 1.24, 1.23 | N/A | [0.5.1][105] |
| 1.23.3 | [1.24.2][27] | 1.25, 1.24, 1.23 | N/A | [0.5.1][105] |
| 1.23.2 | [1.24.1][24] | 1.25, 1.24, 1.23 | N/A | [0.5.1][105] |
| 1.23.1 | [1.24.1][24] | 1.25, 1.24, 1.23 | N/A | [0.5.1][105] |
| 1.23.0 | [1.24.0][21] | 1.25, 1.24, 1.23 | [1.23.0][74] | [0.5.1][105] |
| 1.22.6 | [1.23.7][34] | 1.24, 1.23, 1.22 | N/A | [0.5.0][104] |
| 1.22.5 | [1.23.5][29] | 1.24, 1.23, 1.22 | N/A | [0.5.0][104] |
| 1.22.4 | [1.23.4][26] | 1.24, 1.23, 1.22 | N/A | [0.5.0][104] |
| 1.22.3 | [1.23.3][23] | 1.24, 1.23, 1.22 | N/A | [0.5.0][104] |
| 1.22.2 | [1.23.3][23] | 1.24, 1.23, 1.22 | N/A | [0.5.0][104] |
| 1.22.1 | [1.23.1][20] | 1.24, 1.23, 1.22 | [1.22.1][73] | [0.5.0][104] |
| 1.22.0 | [1.23.0][19] | 1.24, 1.23, 1.22 | [1.22.0][72] | [0.5.0][104] |
| 1.21.3 | [1.22.6][22] | 1.23, 1.22, 1.21 | N/A | [0.4.3][103] |
| 1.21.2 | [1.22.6][22] | 1.23, 1.22, 1.21 | N/A | [0.4.3][103] |
| 1.21.1 | [1.22.2][17] | 1.23, 1.22, 1.21 | [1.21.1][70] | [0.4.3][103] |
| 1.21.0 | [1.22.0][16] | 1.23, 1.22, 1.21 | [1.21.0][69] | [0.4.3][103] |
| 1.20.2 | [1.21.3][18] | 1.23, 1.22, 1.21 | [1.20.2][71] | [0.4.1][102] |
| 1.20.1 | [1.21.1][15] | 1.23, 1.22, 1.21 | [1.20.1][68] | [0.4.1][102] |
| 1.20.0 | [1.21.0][14] | 1.23, 1.22, 1.21 | [1.20.0][67] | [0.4.1][102] |
| 1.19.1 | [1.19.1][13] | 1.22, 1.21, 1.20 | [1.19.1][65] | [0.3.0][101] |
| 1.19.0 | [1.19.1][13] | 1.22, 1.21, 1.20 | [1.19.0][64] | [0.3.0][101] |
| 1.18.3 | [1.19.1][13] | 1.21, 1.20, 1.19 | [1.18.3][66] | [0.3.0][101] |
| 1.18.2 | [1.19.1][13] | 1.21, 1.20, 1.19 | [1.18.2][63] | [0.3.0][101] |
| 1.18.1 | [1.19.1][13] | 1.21, 1.20, 1.19 | [1.18.1][62] | [0.3.0][101] |
| 1.18.0 | [1.19.0][10] | 1.21, 1.20, 1.19 | [1.18.0][61] | [0.3.0][101] |
| 1.17.2 | [1.18.4][12] | 1.21, 1.20, 1.19 | N/A | [0.3.0][101] |
| 1.17.1 | [1.18.3][9] | 1.21, 1.20, 1.19 | N/A | [0.3.0][101] |
| 1.17.0 | [1.18.3][9] | 1.21, 1.20, 1.19 | [1.17.0][60] | [0.3.0][101] |
| 1.16.1 | [1.18.4][12] | 1.21, 1.20, 1.19 | N/A | [0.3.0][101] |
| 1.16.0 | [1.18.3][9] | 1.21, 1.20, 1.19 | [1.16.0][59] | [0.3.0][101] |
| 1.15.2 | [1.18.4][12] | 1.21, 1.20, 1.19 | N/A | [0.3.0][101] |
| 1.15.1 | [1.18.3][9] | 1.21, 1.20, 1.19 | [1.15.1][58] | [0.3.0][101] |
| 1.15.0 | [1.18.2][8] | 1.21, 1.20, 1.19 | [1.15.0][57] | [0.3.0][101] |
| 1.14.2 | [1.17.4][11] | 1.20, 1.19, 1.18 | N/A | [0.2.0][100] |
| 1.14.1 | [1.17.2][7] | 1.20, 1.19, 1.18 | [1.14.1][56] | [0.2.0][100] |
| 1.14.0 | [1.17.1][6] | 1.20, 1.19, 1.18 | [1.14.0][55] | [0.2.0][100] |
| 1.13.1 | [1.17.1][6] | 1.20, 1.19, 1.18 | [1.13.1][54] | [0.2.0][100] |
| 1.13.0 | [1.17.0][5] | 1.20, 1.19, 1.18 | [1.13.0][53] | [0.2.0][100] |
| 1.12.0 | [1.17.0][5] | 1.19, 1.18, 1.17 | [1.12.0][52] | N/A |
| 1.11.0 | [1.16.2][4] | 1.19, 1.18, 1.17 | [1.11.0][51] | N/A |
| 1.10.1 | [1.16.2][4] | 1.19, 1.18, 1.17 | N/A | N/A |
Expand Down Expand Up @@ -202,3 +202,14 @@ __Note:__ This list of extensions was last verified to be complete with Envoy v1

[98]: https://github.com/kubernetes/client-go
[99]: https://github.com/kubernetes/client-go#compatibility-matrix

[100]: https://github.com/kubernetes-sigs/gateway-api/releases/tag/v0.2.0
[101]: https://github.com/kubernetes-sigs/gateway-api/releases/tag/v0.3.0
[102]: https://github.com/kubernetes-sigs/gateway-api/releases/tag/v0.4.1
[103]: https://github.com/kubernetes-sigs/gateway-api/releases/tag/v0.4.3
[104]: https://github.com/kubernetes-sigs/gateway-api/releases/tag/v0.5.0
[105]: https://github.com/kubernetes-sigs/gateway-api/releases/tag/v0.5.1
[106]: https://github.com/kubernetes-sigs/gateway-api/releases/tag/v0.6.0
[107]: https://github.com/kubernetes-sigs/gateway-api/releases/tag/v0.6.2
[108]: https://github.com/kubernetes-sigs/gateway-api/releases/tag/v0.8.0
[109]: https://github.com/kubernetes-sigs/gateway-api/releases/tag/v0.8.1
Loading