Skip to content

Commit 3137642

Browse files
committed
doc: clarify kernel configuration usage in our repo
We keep in the repo the kernel configurations from which we build the kernel images we use in our CI pipelines. However, we don't mention what kernel sources we use to build these kernel images. Clarify in the documentation that these configurations are meant to be used with kernels provided by Amazon Linux and that we don't guarantee that they can be used to build kernels from upstream Linux. Signed-off-by: Babis Chalios <[email protected]>
1 parent fc55a48 commit 3137642

File tree

1 file changed

+19
-8
lines changed

1 file changed

+19
-8
lines changed

docs/kernel-policy.md

Lines changed: 19 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -21,22 +21,33 @@ and removed in a following release, after its minimum end of support date.
2121

2222
### Host Kernel
2323

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 |
24+
| Host kernel | Min. version | Min. end of support | | ----------: |
25+
-----------: | ------------------: | | v5.10 | v1.0.0 | 2024-01-31 | | v6.1 |
26+
v1.5.0 | 2025-10-12 |
2827

2928
### Guest Kernel
3029

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 |
30+
| Guest kernel | Min. version | Min. end of support | | -----------: |
31+
-----------: | ------------------: | | v5.10 | v1.0.0 | 2024-01-31 | | v6.1 |
32+
v1.9.0 | 2026-09-02 |
3533

3634
The guest kernel configs used in our validation pipelines can be found
3735
[here](../resources/guest_configs/) while a breakdown of the relevant guest
3836
kernel modules can be found in the next section.
3937

38+
We use these configurations to build microVM-specific kernels vended by Amazon
39+
Linux. microVM kernels source code are published in Amazon Linux
40+
[linux repo](https://github.com/amazonlinux/linux) under tags in the form of
41+
`microvm-kernel-*`, e.g. 6.1.128-3.201.amazn2023 kernel can be found
42+
[here](https://github.com/amazonlinux/linux/tree/microvm-kernel-6.1.128-3.201.amzn2023).
43+
These kernels may have diverged from the equivalent mainline versions, as we
44+
often backport patches that we require for supporting Firecracker features not
45+
present in the kernel versions we officially support. As a result, kernel
46+
configurations found in this repo should be used to build exclusively the
47+
aforementioned Amazon Linux kernels. We do not guarantee that using these
48+
configurations to build upstream kernels, will work or produce usable kernel
49+
images.
50+
4051
## Guest kernel configuration items
4152

4253
The configuration items that may be relevant for Firecracker are:

0 commit comments

Comments
 (0)