You need to enable JavaScript to run this app. AWS CodeBuild构建Yocto项目对接Amazon EFS报Too many links错误如何解决
优惠活动
大模型
产品
解决方案
定价
更多

AWS CodeBuild构建Yocto项目对接Amazon EFS报Too many links错误如何解决

问题根因说明
  • Amazon EFS对单个普通文件的硬链接数量有固定配额上限(最多177个),该配额属于服务底层限制,不支持用户自主调整,无需再尝试修改EFS侧配置。
  • Yocto 2.2版本的Bitbake默认优先使用硬链接复用相同文件(比如许可证文件、相同的locale资源文件)来减少磁盘占用,当同一个源文件被跨多个配方/拆分包引用时,就会触发EFS的硬链接上限报错,你遇到的报错刚好集中在会大量复用相同许可证、locale资源的任务环节。
可用解决方案

方案1:修改Bitbake配置禁用硬链接(最简便,改完即可生效)

直接在你的local.conf文件中添加以下配置:

# 针对报错的do_populate_lic任务单独禁用硬链接,强制使用文件复制
LIC_CREATE_LINK = "0"
# 全局禁用所有Bitbake流程的硬链接复用,如果仅改上面一行还有报错可以开启
# BB_ALLOW_LINKING = "0"

该方案改动量最小,刚好匹配你当前的报错场景,唯一缺点是会比硬链接模式多占用一部分磁盘空间,EFS本身为弹性计费,额外占用的空间成本远低于构建失败的损失。

方案2:混合存储架构(性能最优,缓存复用率无损失)

不把整个构建目录都放在EFS中,仅将需要跨任务复用的缓存目录挂载到EFS,其余临时目录放在CodeBuild本地存储,从根源上避开EFS的硬链接限制:
在CodeBuild的buildspec.yml中添加以下挂载逻辑:

# 1. 在本地磁盘创建构建根目录
mkdir -p $CODEBUILD_SRC_DIR/build
# 2. 将需要持久化的缓存目录软链接到EFS路径
ln -s /efs/build/sstate-cache $CODEBUILD_SRC_DIR/build/sstate-cache
ln -s /efs/build/cache $CODEBUILD_SRC_DIR/build/cache
# 3. 仅将需要持久化的tmp子目录挂载到EFS,其余tmp内容留在本地磁盘
mkdir -p /efs/build/tmp/deploy
ln -s /efs/build/tmp/deploy $CODEBUILD_SRC_DIR/build/tmp/deploy

该方案所有会产生大量硬链接的临时工作目录都在CodeBuild本地的Ext4文件系统上,无硬链接数量限制,同时需要跨构建复用的缓存、部署产物依然走EFS持久化,不影响缓存复用率,构建性能也比全量跑在EFS上高很多。

方案3:裁剪glibc-locale配置(针对当前报错场景的轻量化修改)

如果不想改全局配置,可以单独裁剪glibc-locale的生成内容,减少需要创建硬链接的locale数量:
在local.conf中添加:

# 只保留产品实际需要的locale,避免生成全量locale导致大量硬链接
GLIBC_GENERATE_LOCALES = "en_US.UTF-8"
IMAGE_LINGUAS = "en-us"

该方法可以直接减少glibc-locale环节的硬链接创建数量,适合仅需要少量locale的嵌入式场景。

注意事项
  • 不建议全局配置用符号链接替代硬链接,Bitbake部分任务逻辑依赖硬链接的inode特性,符号链接可能会导致后续构建校验失败。
  • 如果选择方案1,建议配合EFS生命周期策略,把超过30天未访问的冷数据转到低频存储,抵消额外的磁盘开销。

内容的提问来源于stack exchange,提问作者pengle

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.13 09:48:01