From ec015517d23c27c87a546915ef2de6e2392e2eff Mon Sep 17 00:00:00 2001 From: Yashraj Shukla Date: Thu, 13 Aug 2026 19:58:57 +0000 Subject: [PATCH 1/3] docs: add Kubernetes compatibility matrix, update stale max-kube version Addresses kagent-dev/kagent#2268 Signed-off-by: Yashraj Shukla --- docs-site/assets/versions/max-kube.md | 1 + .../resources/kubernetes-compatibility.md | 29 +++++++++++++++++++ 2 files changed, 30 insertions(+) create mode 100644 docs-site/assets/versions/max-kube.md create mode 100644 docs-site/content/kagent/resources/kubernetes-compatibility.md diff --git a/docs-site/assets/versions/max-kube.md b/docs-site/assets/versions/max-kube.md new file mode 100644 index 00000000..f7613c2d --- /dev/null +++ b/docs-site/assets/versions/max-kube.md @@ -0,0 +1 @@ +1.35 diff --git a/docs-site/content/kagent/resources/kubernetes-compatibility.md b/docs-site/content/kagent/resources/kubernetes-compatibility.md new file mode 100644 index 00000000..37568ce7 --- /dev/null +++ b/docs-site/content/kagent/resources/kubernetes-compatibility.md @@ -0,0 +1,29 @@ +--- +title: Kubernetes Compatibility +linkTitle: Kubernetes Compatibility +description: Which Kubernetes versions kagent is tested and supported against. +weight: 4 +author: kagent.dev +--- + +kagent's CI tests against Kubernetes {{}} today. Below is a history of which Kubernetes version each release was tested against, and the policy we follow going forward. + +## Compatibility matrix + +| kagent version | Kubernetes version tested | Status | +|---|---|---| +| v0.7.11 and later (including main) | 1.35 | Supported | +| v0.6.16 to v0.7.10 | 1.34 | Supported | +| Earlier than v0.6.16 | 1.33 and earlier | Untested, best effort only | + +The tested version comes from `KIND_IMAGE_VERSION` in the [kagent Makefile](https://github.com/kagent-dev/kagent/blob/main/Makefile). This pins the [kindest/node](https://hub.docker.com/r/kindest/node) image used to spin up the Kind cluster in [CI](https://github.com/kagent-dev/kagent/blob/main/.github/workflows/ci.yaml). Right now CI only exercises one Kubernetes minor version per release, not a matrix. + +## Support policy + +kagent tests and supports one Kubernetes minor version per release: whatever `KIND_IMAGE_VERSION` was pinned to when that release was cut. We want to move to an N-2 policy (current version plus the two before it) once CI actually runs a version matrix instead of a single pinned version. + +Versions not listed in the table above are not tested in CI. They might still work. kagent's Kubernetes client libraries (client-go, k8s.io/api, k8s.io/apimachinery) follow the [official client-go skew policy](https://github.com/kubernetes/client-go#compatibility-matrix), which generally supports API servers within one minor version of the client. That said, kagent does not guarantee compatibility outside the versions above. + +## Keeping this page current + +Update this page whenever `KIND_IMAGE_VERSION` changes in the kagent Makefile, or when a new kagent version ships. The current tested version is sourced from `docs-site/assets/versions/max-kube.md`. Update that file, then add a new row to the table for the release. From 3638d4a416965c9085e92064fd6a92e9b71aeb7a Mon Sep 17 00:00:00 2001 From: Yashraj Shukla Date: Thu, 13 Aug 2026 20:07:54 +0000 Subject: [PATCH 2/3] fix: use correct reuse shortcode syntax (was using escaped/documentation form) Signed-off-by: Yashraj Shukla --- docs-site/content/kagent/resources/kubernetes-compatibility.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-site/content/kagent/resources/kubernetes-compatibility.md b/docs-site/content/kagent/resources/kubernetes-compatibility.md index 37568ce7..1883a5fe 100644 --- a/docs-site/content/kagent/resources/kubernetes-compatibility.md +++ b/docs-site/content/kagent/resources/kubernetes-compatibility.md @@ -6,7 +6,7 @@ weight: 4 author: kagent.dev --- -kagent's CI tests against Kubernetes {{}} today. Below is a history of which Kubernetes version each release was tested against, and the policy we follow going forward. +kagent's CI tests against Kubernetes {{< reuse "versions/max-kube.md" >}} today. Below is a history of which Kubernetes version each release was tested against, and the policy we follow going forward. ## Compatibility matrix From 81c68d73f0f0db45b53b6b88cb6a16a61990fc49 Mon Sep 17 00:00:00 2001 From: Yashraj Shukla Date: Sat, 15 Aug 2026 16:56:12 +0000 Subject: [PATCH 3/3] docs: address review feedback, drop unsupported-version claims - rename page to Version Support / versions.md - state only the current release is supported, not a historical matrix - remove unsourced N-2 policy statement - remove first-person language Signed-off-by: Yashraj Shukla --- .../resources/kubernetes-compatibility.md | 29 ------------------- .../content/kagent/resources/versions.md | 17 +++++++++++ 2 files changed, 17 insertions(+), 29 deletions(-) delete mode 100644 docs-site/content/kagent/resources/kubernetes-compatibility.md create mode 100644 docs-site/content/kagent/resources/versions.md diff --git a/docs-site/content/kagent/resources/kubernetes-compatibility.md b/docs-site/content/kagent/resources/kubernetes-compatibility.md deleted file mode 100644 index 1883a5fe..00000000 --- a/docs-site/content/kagent/resources/kubernetes-compatibility.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: Kubernetes Compatibility -linkTitle: Kubernetes Compatibility -description: Which Kubernetes versions kagent is tested and supported against. -weight: 4 -author: kagent.dev ---- - -kagent's CI tests against Kubernetes {{< reuse "versions/max-kube.md" >}} today. Below is a history of which Kubernetes version each release was tested against, and the policy we follow going forward. - -## Compatibility matrix - -| kagent version | Kubernetes version tested | Status | -|---|---|---| -| v0.7.11 and later (including main) | 1.35 | Supported | -| v0.6.16 to v0.7.10 | 1.34 | Supported | -| Earlier than v0.6.16 | 1.33 and earlier | Untested, best effort only | - -The tested version comes from `KIND_IMAGE_VERSION` in the [kagent Makefile](https://github.com/kagent-dev/kagent/blob/main/Makefile). This pins the [kindest/node](https://hub.docker.com/r/kindest/node) image used to spin up the Kind cluster in [CI](https://github.com/kagent-dev/kagent/blob/main/.github/workflows/ci.yaml). Right now CI only exercises one Kubernetes minor version per release, not a matrix. - -## Support policy - -kagent tests and supports one Kubernetes minor version per release: whatever `KIND_IMAGE_VERSION` was pinned to when that release was cut. We want to move to an N-2 policy (current version plus the two before it) once CI actually runs a version matrix instead of a single pinned version. - -Versions not listed in the table above are not tested in CI. They might still work. kagent's Kubernetes client libraries (client-go, k8s.io/api, k8s.io/apimachinery) follow the [official client-go skew policy](https://github.com/kubernetes/client-go#compatibility-matrix), which generally supports API servers within one minor version of the client. That said, kagent does not guarantee compatibility outside the versions above. - -## Keeping this page current - -Update this page whenever `KIND_IMAGE_VERSION` changes in the kagent Makefile, or when a new kagent version ships. The current tested version is sourced from `docs-site/assets/versions/max-kube.md`. Update that file, then add a new row to the table for the release. diff --git a/docs-site/content/kagent/resources/versions.md b/docs-site/content/kagent/resources/versions.md new file mode 100644 index 00000000..196f005f --- /dev/null +++ b/docs-site/content/kagent/resources/versions.md @@ -0,0 +1,17 @@ +--- +title: Version Support +linkTitle: Version Support +description: Which Kubernetes version kagent is tested against. +weight: 4 +author: kagent.dev +--- + +kagent's CI tests against Kubernetes {{< reuse "versions/max-kube.md" >}} today. + +Only the latest kagent release is supported. The tested Kubernetes version above applies to that release. Older kagent releases are not maintained or supported, regardless of which Kubernetes version they were originally tested against. + +The tested version is sourced from `KIND_IMAGE_VERSION` in the [kagent Makefile](https://github.com/kagent-dev/kagent/blob/main/Makefile), which pins the [kindest/node](https://hub.docker.com/r/kindest/node) image used in [CI](https://github.com/kagent-dev/kagent/blob/main/.github/workflows/ci.yaml). CI tests one Kubernetes minor version at a time, not a matrix. + +Kubernetes versions other than the one listed above are not tested in CI and are not guaranteed to work, though kagent's Kubernetes client libraries generally follow the [client-go version skew policy](https://github.com/kubernetes/client-go#compatibility-matrix). + +This page should be updated whenever `KIND_IMAGE_VERSION` changes in the kagent Makefile. The value is sourced from `docs-site/assets/versions/max-kube.md`.