Distribution Versioning

KFD follows closely Kubernetes versioning.

Previously, the Kubernetes Fury Distribution had its own versioning following semantic versioning, but this approach showed some downsides in practice. In particular it was difficult to follow what Kubernetes versions where supported by a version of KFD.

Current versioning scheme

From version 1.21, The Kubernetes Fury Distribution follows closely Kubernetes versioning. KFD uses the same major and minor version than the Kubernetes version it supports, but the patch number is independent.

This means that each KFD version has a 1:1 compatibility with a specific Kubernetes version.

For example:

• KFD 1.22.0 is compatible with Kubernetes 1.22.x
• KFD 1.22.5 is compatible with Kubernetes 1.22.x
• KFD 1.23.0 is compatible with Kubernetes 1.23.x
• KFD 1.23.1 is compatible with Kubernetes 1.23.x
• KFD 1.23.2 is compatible with Kubernetes 1.23.x
• KFD 1.24.0 is compatible with Kubernetes 1.24.x

To see the full list of compatible versions, refer to the Compatibility Matrix below.

Upgrades

Each KFD version will come with comprehensive documentation on all supported upgrade paths (es. tutorials to upgrade minor to minor, including patches if present).

See the upgrade path document for more details.

Compatibility Matrix

KFD / Kubernetes Version	1.14.X	1.15.X	1.16.X	1.17.X	1.18.X	1.19.X	1.20.X	1.21.X	1.22.X	1.23.X	1.24.X
v1.1.0	✅	✅	✅
v1.2.0	✅	✅	✅
v1.3.0			✅	✅	✅
v1.4.0			✅	✅	✅	⚠️
v1.5.0				⚠️	⚠️	⚠️	⚠️
v1.5.1				✅	✅	✅	⚠️
v1.6.0					✅	✅	✅	⚠️
v1.7.0						✅	✅	✅
v1.7.1						✅	✅	✅
v1.21.0								✅
v1.22.0								✅	✅
v1.22.1									✅	✅
v1.23.0							❌	❌	❌	⚠️
v1.23.1							✅	✅	✅	⚠️
v1.23.2										✅
v1.23.3										✅	✅
v1.24.0											✅

Installer / KFD Version	1.24.0	1.23.3	1.22.1
AKS	✅	✅	✅
EKS	✅	✅	✅
GKE	✅	✅	✅
on-premises	✅	✅	✅

Legend:

• ✅ Compatible
• ⚠️ Has issues
• ❌ Incompatible

Warnings

• ❌: version: v1.23.0 has a known bug breaking upgrades. Please do not use.