|
2 | 2 |
|
3 | 3 | This document outlines Skyhook's approach to supporting different Kubernetes versions. |
4 | 4 |
|
5 | | -## Current Support Matrix |
| 5 | +## What Version Should I Use? |
6 | 6 |
|
7 | | -| Kubernetes Version | Skyhook Version | Status | Notes | |
8 | | -|--------------------|-----------------|---------|-------| |
9 | | -| 1.35, 1.34, 1.33, 1.32, 1.31 | v0.11.0+ | ✅ Fully Supported | Current stable versions | |
10 | | -| 1.34, 1.33, 1.32, 1.31 | 0.10.x | ✅ Fully Supported | Use v0.11.x | |
11 | | -| 1.34, 1.33, 1.32, 1.31 | v0.9.x | ✅ Fully Supported | | |
12 | | -| 1.30 | v0.8.x | ⚠️ Use older Skyhook | K8s 1.30 EOL: June 28, 2025 | |
13 | | -| 1.29 and older | v0.8.x or older | ⚠️ Use older Skyhook | No longer maintained | |
| 7 | +| Kubernetes Version | Recommended Skyhook | Status | |
| 8 | +|--------------------|---------------------|--------| |
| 9 | +| 1.35, 1.34, 1.33, 1.32, 1.31 | v0.12.x (latest) | ✅ Fully Supported, CI tested | |
| 10 | +| 1.30 and older | v0.8.x | ⚠️ Legacy (K8s 1.30 EOL June 2025) | |
| 11 | + |
| 12 | +### Previous Release Compatibility |
| 13 | + |
| 14 | +| Skyhook Version | Supported Kubernetes Versions | |
| 15 | +|-----------------|-------------------------------| |
| 16 | +| v0.12.x | 1.31, 1.32, 1.33, 1.34, 1.35 | |
| 17 | +| v0.11.x | 1.31, 1.32, 1.33, 1.34, 1.35 | |
| 18 | +| v0.10.x | 1.31, 1.32, 1.33, 1.34 | |
| 19 | +| v0.9.x | 1.31, 1.32, 1.33, 1.34 | |
| 20 | +| v0.8.x | 1.30 | |
14 | 21 |
|
15 | 22 | ## Support Policy |
16 | 23 |
|
@@ -59,21 +66,21 @@ We understand many installations run slightly older Kubernetes versions. Our str |
59 | 66 |
|
60 | 67 | **Choose your Skyhook version based on your Kubernetes version:** |
61 | 68 |
|
62 | | -- **Kubernetes 1.34, 1.33, 1.32, or 1.31:** Use latest Skyhook (v0.9.x or v0.10.0) |
| 69 | +- **Kubernetes 1.35, 1.34, 1.33, 1.32, or 1.31:** Use latest Skyhook (v0.12.x) |
63 | 70 | - **Kubernetes 1.30:** Use Skyhook v0.8.x (K8s 1.30 is EOL but v0.8.x still works) |
64 | 71 | - **Kubernetes 1.29 or older:** Use Skyhook v0.8.x or older (check release notes for compatibility) |
65 | 72 |
|
66 | 73 | ### Migration Path |
67 | 74 |
|
68 | 75 | **If you're on an older Kubernetes version:** |
69 | | -1. **First:** Upgrade your Kubernetes cluster to a supported version (1.31, 1.32, 1.33, or 1.34) |
| 76 | +1. **First:** Upgrade your Kubernetes cluster to a supported version (1.31, 1.32, 1.33, 1.34, or 1.35) |
70 | 77 | 2. **Then:** Upgrade to the latest Skyhook version |
71 | 78 |
|
72 | 79 | **If you're on Kubernetes 1.30:** |
73 | | -- **Option A:** Upgrade to K8s 1.31/1.32/1.33/1.34, then use latest Skyhook |
| 80 | +- **Option A:** Upgrade to K8s 1.31/1.32/1.33/1.34/1.35, then use latest Skyhook |
74 | 81 | - **Option B:** Stay on Skyhook v0.8.x until you can upgrade Kubernetes |
75 | 82 |
|
76 | | -**Recommended:** If you can choose your Kubernetes version, use 1.34, 1.33, or 1.32 for the longest support runway. |
| 83 | +**Recommended:** If you can choose your Kubernetes version, use 1.35, 1.34, or 1.33 for the longest support runway. |
77 | 84 |
|
78 | 85 | ## FAQ |
79 | 86 |
|
@@ -104,7 +111,7 @@ Waiting 4+ weeks lets the ecosystem stabilize and gives us confidence in support |
104 | 111 | ### How do you test compatibility? |
105 | 112 |
|
106 | 113 | For each Skyhook release, we test against all supported Kubernetes versions using: |
107 | | -- GitHub Actions matrix builds with multiple K8s versions (currently 1.31, 1.32, 1.33, 1.34) |
| 114 | +- GitHub Actions matrix builds with multiple K8s versions (currently 1.31, 1.32, 1.33, 1.34, 1.35) |
108 | 115 | - Local testing with [kind](https://kind.sigs.k8s.io/) |
109 | 116 | - Basic functionality and integration tests |
110 | 117 |
|
|
0 commit comments