Distribution Versioning
Introduction
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).
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 |
|---|---|---|---|---|---|---|---|---|---|---|
| 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.23.0 | ❌ | ❌ | ❌ | ⚠️ | ||||||
| v1.23.1 | ✅ | ✅ | ✅ | ⚠️ | ||||||
| v1.23.2 | ✅ |
✅ Compatible
⚠️ Has issues
❌ Incompatible
Warnings
- ❌: version:
v1.23.0has a known bug breaking upgrades. Please do not use.