Bottlerocket项目构建系统迁移至核心工具包后的仓库创建问题解析

Bottlerocket操作系统团队近期将项目架构迁移至bottlerocket-core-kit核心工具包，这一架构变更在开发分支(develop)上已经实施。然而，这一迁移过程中出现了一个影响开发者工作流的关键问题：当用户尝试使用cargo make repo命令创建TUF仓库时，构建系统会失败。

问题现象

在aarch64架构下，当开发者执行以下命令尝试为特定变体(如aws-k8s-1.29)创建仓库时：

cargo make -e ARCH=aarch64 -e BUILDSYS_VARIANT=aws-k8s-1.29 repo

系统会报错，提示无法找到波浪发布策略文件(default-waves.toml)。错误信息显示构建系统仍在尝试从旧的路径sources/updater/waves/下寻找该文件，而实际上该文件在新架构下的位置已经变更。

技术背景

Bottlerocket使用波浪发布策略(wave policy)来控制更新的推送节奏。这个策略文件定义了不同批次设备接收更新的时间偏移量。在旧版架构中，该文件位于sources/updater/waves/目录下，而迁移至bottlerocket-core-kit后，其位置发生了变化。

解决方案

开发团队已经在新版Twoliter工具(v0.4.2)中修复了这个问题。对于希望立即测试修复效果的开发者，可以采取以下步骤：

1. 在bottlerocket-core-kit仓库中，修改Makefile，将TWOLITER_VERSION设置为0.4.2
2. 在变体仓库中，修改Makefile.toml：
   • 更新TWOLITER_VERSION为v0.4.2
   • 调整波浪策略路径为：${BUILDSYS_BUILD_DIR}/tools/waves/default-waves.toml

完成这些修改后，开发者应该能够正常执行构建和仓库创建操作。

项目规划

值得注意的是，当前稳定版本(1.20.3)仍保持旧有架构。开发团队计划在下一个次要版本(1.21.0)中正式采用基于bottlerocket-core-kit的新架构。在过渡期间，团队保留了1.20.x分支以继续提供稳定版本，同时在新架构上解决各类兼容性问题。

开发者建议

对于正在使用Bottlerocket开发分支的开发者，如果遇到其他与新架构相关的问题，建议及时向项目团队反馈。架构迁移过程中可能会出现各种意料之外的兼容性问题，早期发现和报告有助于团队更快地完善新架构。