Skip to content

Commit b35ea23

Browse files
committed
chore(doc): clarify kernel policy and remove 4.14
The current wording is unclear since all kernel versions seem to be expired or to expire this year. This commit attempts to make it clear that 2 versions will always be supported. Furthermore, any reference to 4.14 is removed. Signed-off-by: Riccardo Mancini <[email protected]>
1 parent 3db826f commit b35ea23

File tree

1 file changed

+18
-13
lines changed

1 file changed

+18
-13
lines changed

docs/kernel-policy.md

Lines changed: 18 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -7,26 +7,31 @@ related changes.
77

88
We are continuously validating the currently supported Firecracker releases (as
99
per [Firecracker’s release policy](../docs/RELEASE_POLICY.md)) using a
10-
combination of:
11-
12-
- host linux kernel versions 5.10, and 6.1;
13-
- guest linux kernel versions 5.10 and 6.1. Guest linux kernels 4.14 are
14-
deprecated with Firecracker v1.9 and we will drop support for them with
15-
Firecracker v1.10.
10+
combination of all supported host and guest kernel versions in the table below.
1611

1712
While other versions and other kernel configs might work, they are not
1813
periodically validated in our test suite, and using them might result in
1914
unexpected behaviour. Starting with release `v1.0` each major and minor release
2015
will specify the supported kernel versions.
2116

22-
Once a kernel version is officially enabled, it is supported for a **minimum of
23-
2 years**. Adding support for a new kernel version will result in a Firecracker
24-
release only if compatibility changes are required.
17+
Once a kernel version is officially added, it is supported for a **minimum of 2
18+
years**. At least 2 major guest and host versions will be supported at any time.
19+
When support is added for a third kernel version, the oldest will be deprecated
20+
and removed in a following release, after its minimum end of support date.
21+
22+
### Host Kernel
23+
24+
| Host kernel | Min. version | Min. end of support |
25+
| ----------: | -----------: | ------------------: |
26+
| v5.10 | v1.0.0 | 2024-01-31 |
27+
| v6.1 | v1.5.0 | 2025-10-12 |
28+
29+
### Guest Kernel
2530

26-
| Host kernel | Guest kernel v4.14 (deprecated) | Guest kernel v5.10 | Guest kernel v6.1 | Min. end of support |
27-
| ----------: | :-----------------------------: | :----------------: | :---------------: | ------------------: |
28-
| v5.10 | Y (deprecated) | Y | Y | 2024-01-31 |
29-
| v6.1 | Y (deprecated) | Y | Y | 2025-10-12 |
31+
| Guest kernel | Min. version | Min. end of support |
32+
| -----------: | -----------: | ------------------: |
33+
| v5.10 | v1.0.0 | 2024-01-31 |
34+
| v6.1 | v1.9.0 | 2026-09-02 |
3035

3136
The guest kernel configs used in our validation pipelines can be found
3237
[here](../resources/guest_configs/) while a breakdown of the relevant guest

0 commit comments

Comments
 (0)