EKS集群缺少Linux Kernel Headers，如何正确获取对应内核头文件？

问题核心判断 #

你当前节点内核版本为5.4.117-58.216.amzn2.x86_64，后缀amzn2说明节点使用的是AWS默认的Amazon Linux 2发行版，该发行版默认使用yum/rpm包管理体系，直接执行apt命令本身就属于体系不兼容，官方对应内核头文件也不会发布在deb软件源中。

常规安装方案（Amazon Linux 2节点，推荐） #

• 第一步：更新本地yum缓存
  sudo yum update -y
• 第二步：安装对应版本的内核头文件和开发包
  sudo yum install -y kernel-devel-$(uname -r) kernel-headers-$(uname -r)
• 第三步：验证安装结果
  执行ls /usr/src/kernels/$(uname -r)，能正常输出目录下的头文件列表即为安装成功。

yum源无匹配包时的离线安装方案 #

如果节点配置的yum源版本滞后，无法找到完全匹配的内核版本包，可手动下载对应rpm包安装：

• 从Amazon Linux 2官方rpm仓库搜索下载对应版本的kernel-devel-5.4.117-58.216.amzn2.x86_64.rpm和kernel-headers-5.4.117-58.216.amzn2.x86_64.rpm包到节点本地
• 执行本地安装命令：
  sudo rpm -ivh kernel-devel-5.4.117-58.216.amzn2.x86_64.rpm kernel-headers-5.4.117-58.216.amzn2.x86_64.rpm
• 若存在依赖缺失，执行自动修复命令：
  sudo yum install -f -y

自定义Ubuntu/Debian系EKS节点的补装方案 #

如果你使用的是自己定制的Ubuntu/Debian系EKS节点，确实需要使用apt安装，源内无对应包时按以下步骤操作：

• 添加Ubuntu官方内核PPA源，更新apt缓存后重新尝试安装
• 若仍找不到，直接下载对应版本的linux-headers deb包到本地，执行：
  sudo dpkg -i linux-headers-*.deb
• 依赖缺失时执行修复：
  sudo apt install -f -y

大规模部署优化方案 #

如果需要在EKS集群中大规模运行eBPF类工作负载，建议直接基于官方EKS节点镜像定制自定义AMI，提前预安装好对应版本的内核头文件，节点启动时直接使用自定义AMI，避免运行时安装的依赖问题和耗时。

内容的提问来源于stack exchange，提问作者Zahi Abow