From 75e7da22bd53d8e9cdd900e8b5789053ba66f37f Mon Sep 17 00:00:00 2001 From: Kayen <90731159+KayenM@users.noreply.github.com> Date: Fri, 25 Oct 2024 12:35:45 -0400 Subject: [PATCH] docs: Add a Gatekeeper-Kubernetes compatibility matrix to the release management page. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit A compatibility matrix would be helpful to Gatekeeper users who are using non-supported versions of Kubernetes. Gatekeeper’s support policy is that it ensures compatibility of currently supported Gatekeeper versions with currently supported Kubernetes versions. Gatekeeper supports n-1 minor release versions where n is the current release. This matrix assumes that at any point in time where there is overlap between a supported version of Gatekeeper and a supported version of Kubernetes, they will be compatible. Signed-off-by: KayenM --- docs/Release_Management.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/Release_Management.md b/docs/Release_Management.md index 6d503e949db..ebd27c44093 100644 --- a/docs/Release_Management.md +++ b/docs/Release_Management.md @@ -60,6 +60,22 @@ Gatekeeper is assumed to be compatible with the [current Kubernetes Supported Ve For example, if Gatekeeper _supported_ versions are v3.7 and v3.8, and Kubernetes _supported_ versions are v1.22, v1.23, v1.24, then all supported Gatekeeper versions (v3.7, v3.8) are assumed to be compatible with all supported Kubernetes versions (v1.22, v1.23, v1.24). If Kubernetes v1.25 is released later, then Gatekeeper v3.7 and v3.8 will be assumed to be compatible with v1.25 if those Gatekeeper versions are still supported at that time. +This is the official compatibility between Gatekeeper and Kubernetes versions. + +| | Kubernetes 1.22.z | Kubernetes 1.23.z | Kubernetes 1.24.z | Kubernetes 1.25.z | Kubernetes 1.26.z | Kubernetes 1.27.z | Kubernetes 1.28.z | Kubernetes 1.29.z | Kubernetes 1.30.z | Kubernetes 1.31.z | +|---------------------|-------------------|-------------------|-------------------|-------------------|-------------------|-------------------|-------------------|-------------------|-------------------|-------------------| +| **Gatekeeper 3.7** | ✓ | ✓ | ✓ | - | - | - | - | - | - | - | +| **Gatekeeper 3.8** | ✓ | ✓ | ✓ | ✓ | - | - | - | - | - | - | +| **Gatekeeper 3.9** | ✓ | ✓ | ✓ | ✓ | ✓ | - | - | - | - | - | +| **Gatekeeper 3.10** | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | - | - | - | - | +| **Gatekeeper 3.11** | - | - | ✓ | ✓ | ✓ | ✓ | - | - | - | - | +| **Gatekeeper 3.12** | - | - | ✓ | ✓ | ✓ | ✓ | ✓ | - | - | - | +| **Gatekeeper 3.13** | - | - | - | ✓ | ✓ | ✓ | ✓ | ✓ | - | - | +| **Gatekeeper 3.14** | - | - | - | - | ✓ | ✓ | ✓ | ✓ | ✓ | - | +| **Gatekeeper 3.15** | - | - | - | - | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | +| **Gatekeeper 3.16** | - | - | - | - | - | ✓ | ✓ | ✓ | ✓ | ✓ | +| **Gatekeeper 3.17** | - | - | - | - | - | - | ✓ | ✓ | ✓ | ✓ | + If you choose to use Gatekeeper with a version of Kubernetes that it does not support, you are using it at your own risk. ## Upgrades