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

Switches to using the Gateway API release version in versions.yaml and the compatibility matrix instead of API versions, to provide more information about features available with each release. Closes #5728. Signed-off-by: Steve Kriss <[email protected]>
projectcontour · Oct 19, 2023 · 442cf01 · 442cf01
1 parent dfb9aef
commit 442cf01
Show file tree

Hide file tree

Showing 3 changed files with 121 additions and 137 deletions.
diff --git a/changelogs/unreleased/5871-skriss-docs.md b/changelogs/unreleased/5871-skriss-docs.md
@@ -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.
diff --git a/site/content/resources/compatibility-matrix.md b/site/content/resources/compatibility-matrix.md
@@ -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.
+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                 |
@@ -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
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.