Skip to content

Commit 99abce2

Browse files
authored
Kubernetes agent supported versions policy (#2590)
* k8s agent supported versions policy * Rename title * Add section about older versions
1 parent 91ea99a commit 99abce2

File tree

2 files changed

+28
-0
lines changed

2 files changed

+28
-0
lines changed

src/pages/docs/kubernetes/targets/kubernetes-agent/index.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -80,6 +80,8 @@ The Kubernetes agent follows [semantic versioning](https://semver.org/), so a ma
8080

8181
Additionally, the Kubernetes agent only supports **Linux AMD64** and **Linux ARM64** Kubernetes nodes.
8282

83+
See our [support policy](/docs/kubernetes/targets/kubernetes-agent/supported-versions-policy) for more information.
84+
8385
## Installing the Kubernetes agent
8486

8587
The Kubernetes agent is installed using [Helm](https://helm.sh) via the [octopusdeploy/kubernetes-agent](https://hub.docker.com/r/octopusdeploy/kubernetes-agent) chart.
Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
---
2+
layout: src/layouts/Default.astro
3+
pubDate: 2024-12-11
4+
modDate: 2024-12-11
5+
title: Support Policy for Kubernetes Versions
6+
navTitle: Supported Versions Policy
7+
navSection: Kubernetes agent
8+
description: Policy for which versions of Kubernetes are supported by the Kubernetes agent
9+
navOrder: 100
10+
---
11+
12+
[The Kubernetes project](https://kubernetes.io/releases/version-skew-policy/#supported-versions) maintains release branches for the most recent three minor releases of Kubernetes.
13+
14+
Octopus aims to follow this support policy as closely as makes sense.
15+
16+
## Kubernetes Agent
17+
18+
The Kubernetes agent uses the [Kubernetes C# client](https://github.com/kubernetes-client/csharp) to interact with the Kubernetes API, so we are bound to their release cadence. The Kubernetes agent will receive an update within **3 months** of a new major release of the Kubernetes C# client being released.
19+
20+
If your use case requires the latest and greatest version of Kubernetes before we have released a new version, please [contact support](https://octopus.com/company/contact) to discuss options.
21+
22+
### Support for older versions
23+
24+
Each time the Kubernetes agent is updated to support a new version of Kubernetes, support for older versions will be dropped in line with the Kubernetes project's supported versions. Historically, the APIs in use have been stable and the Kubernetes agent has remained compatible with older version of Kubernetes, however we can make no guarantees of this in the future.
25+
26+
We strongly recommend leaving automatic Kubernetes agent updates enabled and keeping your Kubernetes cluster up to date in line with the latest support version. If you must maintain support for older versions, you can configure how the Kubernetes agent is automatically updated with [machine policies](/docs/infrastructure/deployment-targets/machine-policies#configure-machine-updates).

0 commit comments

Comments
 (0)