Raise eBPF dataplane minimum kernel to v5.10#2586
Raise eBPF dataplane minimum kernel to v5.10#2586tomastigera wants to merge 3 commits intotigera:mainfrom
Conversation
Drop support for kernels older than 5.10 for the eBPF dataplane. Update minimum to v5.10 (RHEL 8.4 / v4.18.0-305), Ubuntu 22.04, remove XDP row from feature table (v4.16 is below new minimum), and simplify CO-RE warning since v5.10 already includes CO-RE. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
✅ Deploy Preview for calico-docs-preview-next ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
✅ Deploy Preview succeeded!Built without sensitive environment variables
To edit notification comments on pull requests, go to your Netlify project configuration. |
There was a problem hiding this comment.
Pull request overview
Raises the documented minimum Linux kernel requirements for the eBPF dataplane across Calico OSS, Enterprise, and Cloud docs, aligning distro guidance and kernel feature notes with a new v5.10 baseline.
Changes:
- Update eBPF dataplane minimum kernel references (v5.3 → v5.10) and corresponding RHEL build (4.18.0-193 → 4.18.0-305 / RHEL 8.4).
- Update Ubuntu minimum for eBPF guidance (20.04 → 22.04).
- Remove the XDP acceleration row from the eBPF feature/kernel table and simplify CO-RE guidance.
Reviewed changes
Copilot reviewed 8 out of 8 changed files in this pull request and generated 5 comments.
Show a summary per file
| File | Description |
|---|---|
| calico_versioned_docs/version-3.31/operations/ebpf/install.mdx | Updates versioned Calico OSS eBPF install requirements and feature/kernel table to v5.10 baseline. |
| calico_versioned_docs/version-3.31/operations/ebpf/enabling-ebpf.mdx | Updates versioned Calico OSS eBPF enablement prerequisites to v5.10 baseline. |
| calico/operations/ebpf/install.mdx | Updates unversioned Calico OSS eBPF install requirements and feature/kernel table to v5.10 baseline. |
| calico/operations/ebpf/enabling-ebpf.mdx | Updates unversioned Calico OSS eBPF enablement prerequisites to v5.10 baseline. |
| calico-enterprise_versioned_docs/version-3.23-1/operations/ebpf/install.mdx | Updates versioned Calico Enterprise eBPF install requirements and feature/kernel table to v5.10 baseline. |
| calico-enterprise/operations/ebpf/install.mdx | Updates unversioned Calico Enterprise eBPF install requirements and feature/kernel table to v5.10 baseline. |
| calico-cloud_versioned_docs/version-22-2/operations/ebpf/enabling-ebpf.mdx | Updates versioned Calico Cloud eBPF enablement prerequisites and kernel-check guidance to v5.10 baseline. |
| calico-cloud/operations/ebpf/enabling-ebpf.mdx | Updates unversioned Calico Cloud eBPF enablement prerequisites and kernel-check guidance to v5.10 baseline. |
| - Another [supported distribution](../../getting-started/kubernetes/requirements.mdx) with Linux kernel v5.3 or above. Kernel v5.8 or above with CO-RE enabled is recommended for better performance. | ||
| - Ubuntu 22.04. | ||
| - Red Hat v8.4 with Linux kernel v4.18.0-305 or above (Red Hat have backported the required features to that build). | ||
| - Another [supported distribution](../../getting-started/kubernetes/requirements.mdx) with Linux kernel v5.10 or above. |
There was a problem hiding this comment.
This page now states a v5.10+ minimum kernel, but later in the same document the kernel-check examples still say v5.4 is suitable and reference RHEL build 193 as suitable. Please update the verification section/examples to match the new minimums (v5.10 / RHEL 4.18.0-305).
| - Another [supported distribution](../../getting-started/kubernetes/requirements.mdx) with Linux kernel v5.10 or above. | |
| - Another [supported distribution](../../getting-started/kubernetes/requirements.mdx) with Linux kernel v5.10 or above (earlier kernels such as v5.4 are not sufficient for eBPF mode). |
| - Another [supported distribution](../../getting-started/kubernetes/requirements.mdx) with Linux kernel v5.3 or above. Kernel v5.8 or above with CO-RE enabled is recommended for better performance. | ||
| - Ubuntu 22.04. | ||
| - Red Hat v8.4 with Linux kernel v4.18.0-305 or above (Red Hat have backported the required features to that build). | ||
| - Another [supported distribution](../../getting-started/kubernetes/requirements.mdx) with Linux kernel v5.10 or above. |
There was a problem hiding this comment.
This page now states a v5.10+ minimum kernel, but later in the same document the kernel-check examples still say v5.4 is suitable and reference RHEL build 193 as suitable. Please update the verification section/examples to match the new minimums (v5.10 / RHEL 4.18.0-305).
| - Another [supported distribution](../../getting-started/kubernetes/requirements.mdx) with Linux kernel v5.10 or above. | |
| - Another [supported distribution](../../getting-started/kubernetes/requirements.mdx) with Linux kernel v5.10 or above (earlier versions such as v5.4 are not supported for the eBPF data plane). |
| @@ -113,15 +112,15 @@ The output should look like this: | |||
| 5.4.0-42-generic #46-Ubuntu SMP Fri Jul 10 00:24:02 UTC 2020 | |||
| ``` | |||
|
|
|||
| In this case the kernel version is v5.4, which is suitable. | |||
| In this case the kernel version is v5.4, which is not suitable (minimum is v5.10). | |||
There was a problem hiding this comment.
The text now correctly says the sample v5.4 kernel is not suitable, but the preceding line still says "The output should look like this", which reads like a recommended/expected (working) example. Consider changing that wording (for example, "may look like this") or updating the sample output to a v5.10+ kernel so the example and explanation are aligned.
| @@ -113,15 +112,15 @@ The output should look like this: | |||
| 5.4.0-42-generic #46-Ubuntu SMP Fri Jul 10 00:24:02 UTC 2020 | |||
| ``` | |||
|
|
|||
| In this case the kernel version is v5.4, which is suitable. | |||
| In this case the kernel version is v5.4, which is not suitable (minimum is v5.10). | |||
There was a problem hiding this comment.
The text now correctly says the sample v5.4 kernel is not suitable, but the preceding line still says "The output should look like this", which reads like a recommended/expected (working) example. Consider changing that wording (for example, "may look like this") or updating the sample output to a v5.10+ kernel so the example and explanation are aligned.
| - Ubuntu 22.04 or above. | ||
| - Red Hat v8.4 with Linux kernel v4.18.0-305 or above (Red Hat have backported the required features to that build). | ||
| - Another [supported distribution](../../getting-started/kubernetes/requirements.mdx) with Linux kernel v5.10 or above. |
There was a problem hiding this comment.
The PR description says references to v5.3 / RHEL 4.18.0-193 / Ubuntu 20.04 are updated in the latest docs, but there are still eBPF dataplane kernel minimum references elsewhere (for example, calico-enterprise/operations/ebpf/enabling-ebpf.mdx still treats v5.4 and RHEL 4.18.0-193 as suitable, and calico-cloud/reference/component-resources/node/felix/configuration.mdx still says eBPF mode requires a v5.3 kernel). Please update those remaining docs or narrow the PR description/scope so the docs are consistent.
| @@ -113,15 +112,15 @@ The output should look like this: | |||
| 5.4.0-42-generic #46-Ubuntu SMP Fri Jul 10 00:24:02 UTC 2020 | |||
There was a problem hiding this comment.
We should put a suitable output:
5.10.0-26-generic #28~20.04.1-Ubuntu SMP Fri Jan 27 14:30:10 UTC 2023
| ``` | ||
|
|
||
| In this case the kernel version is v5.4, which is suitable. | ||
| In this case the kernel version is v5.4, which is not suitable (minimum is v5.10). |
There was a problem hiding this comment.
This change should be rolled back, and updated the version from 5.4 to 5.10
| @@ -113,15 +112,15 @@ The output should look like this: | |||
| 5.4.0-42-generic #46-Ubuntu SMP Fri Jul 10 00:24:02 UTC 2020 | |||
There was a problem hiding this comment.
Same here:
5.10.0-26-generic #28~20.04.1-Ubuntu SMP Fri Jan 27 14:30:10 UTC 2023
| ``` | ||
|
|
||
| In this case the kernel version is v5.4, which is suitable. | ||
| In this case the kernel version is v5.4, which is not suitable (minimum is v5.10). |
- Update uname example to show v5.10 kernel as suitable output instead of showing v5.4 as not suitable (per reviewer feedback) - Update Felix configuration reference to require v5.10 kernel for eBPF dataplane Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
| The output should look like this: | ||
|
|
||
| ``` | ||
| 5.4.0-42-generic #46-Ubuntu SMP Fri Jul 10 00:24:02 UTC 2020 |
There was a problem hiding this comment.
Need update here:
5.10.0-26-generic #28~20.04.1-Ubuntu SMP Fri Jan 27 14:30:10 UTC 2023
| The output should look like this: | ||
|
|
||
| ``` | ||
| 5.4.0-42-generic #46-Ubuntu SMP Fri Jul 10 00:24:02 UTC 2020 |
There was a problem hiding this comment.
needs update here:
5.10.0-26-generic #28~20.04.1-Ubuntu SMP Fri Jan 27 14:30:10 UTC 2023
|
Not all versions (cloud, enterprise and oss) were covered by the refactor. Some |
Summary
Test plan
🤖 Generated with Claude Code