本手册面向 openUBMC/manifest 仓构建问题的自主定位,按两个场景组织:
- 场景一:流水线问题——PR 门禁 CI 失败,着重操作方法:怎么看日志、怎么重跑、怎么排查、怎么推包。
- 场景二:本地构建——本地
bingo build等命令失败,着重从现象找原因:错误特征 => 根因 => 处理。
问题统一归为五类:触发失败、构建失败、门禁失败、制品缺失、权限异常。其中触发失败与门禁失败仅流水线场景存在,本地不涉及;本地构建的「跑不起来」多为环境问题(初始化、SDK 配套、网络代理等),单列一节。本地环境类问题的完整报错清单另见构建常见问题。
问题分类总览
| 问题类别 | 流水线侧(场景一) | 本地侧(场景二) |
|---|---|---|
| 触发失败 | CI 未触发(草稿 PR)、排队、运行被抢占、流水线配置问题 | —(本地无触发环节,「跑不起来」多为环境问题) |
| 构建失败 | 编译构建/依赖校验 FAILED、CI 镜像问题 | 编译报错、依赖版本冲突、manifest 配置错误 |
| 门禁失败 | 门禁检查任务 FAILED、needs-issue 等标签阻塞 | —(仅流水线有门禁,推送前自检见门禁失败) |
| 制品缺失 | 组件制品未发布或 revision 不同步 | 制品核对、本地 conan 缓存异常 |
| 权限异常 | 日志 403、认证卡住、CI 内 sudo 受限 | git/conan 凭证、docker 组、mount 权限 |
快速索引
看到以下现象时,直接跳转对应章节:
| 场景 | 现象 | 章节 |
|---|---|---|
| 流水线 | PR 创建/更新后没有 CI 评论,或流水线一直排队未运行 | 触发失败 |
| 流水线 | CI 结果表中「编译构建」系列任务或「依赖校验」为 FAILED | 构建失败 |
| 流水线 | 「PR描述检查」「pre-commit检查」等门禁任务 FAILED,或 PR 被 needs-issue / needs-squash 等标签阻塞 | 门禁失败 |
| 流水线 | 构建日志提示 was not found in remote、recipe revision/包哈希不匹配、reference is not a tree | 制品缺失、怎么推包 |
| 流水线 | 日志出现 403、Username for、permission denied、认证卡住、mount 失败 | 权限异常(流水线侧) |
| 本地 | bingo build / bingo analysis / bingo test 失败,需区分环境、缓存、制品还是代码问题 | 场景二:本地构建 |
场景一:流水线问题
manifest 仓流水线定义于 .gitcode/workflows/PR-pipeline_manifest.yml,实际任务由 openUBMC/openubmc-ci 仓的 ci-build.yml 提供。触发方式:
- PR 打开、重新打开、更新(推送新提交)时自动触发。
- 在 PR 下评论
/retest手动重跑。 - 草稿(Draft)PR 不触发 CI。草稿 PR 即标记为「尚未完成」的 PR:标题带
Draft:前缀,创建 PR 时选择「转换为草稿」,或在 PR 页面评论区右下角点击「转换为草稿」即可标记。 - 流水线并发上限 10,超出后排队(Queue),同一 PR 的新运行会抢占旧运行。
怎么看日志
CI 结束后由机器人(openubmc-ci-bot)在 PR 评论中回帖结果表,表内任务名与流水线 Job 的对应关系如下:
| 结果表任务名 | 流水线 Job | 检查内容 |
|---|---|---|
| pre-commit检查 | pre-commit | 代码格式检查,含 semgrep 敏感信息扫描(命中即阻断) |
| PR描述检查 | check_message | PR 描述模板 5 个字段(功能描述/修改方案/验证方案/测试建议/自验证报告)均需填写且每字段不少于 10 个字符 |
| 修改行数检查 | Test_line_limit_check | 变更行数默认不超过 1000 行,超限打 limit_1k_failed 标签 |
| 防投毒检查 | poison | 恶意代码扫描(openlibing malicious-code-scan) |
| 开源合规检查 | sca | 开源合规 SCA 扫描(含 LICENSE、版权声明) |
| 编译构建 | build | bingo build -b openUBMC -bt debug 主产品构建 |
| 编译构建1712 | build_1712 | 1712 单板构建 |
| 编译构建3095 | build_3095 | 3095 单板构建 |
| 编译构建AST2600 | build_ast2600 | AST2600 单板构建 |
| 依赖校验 | Test_dependency_check | bingo analysis --rebuild 依赖解析校验 |
通用定位路径(PR -> job -> 日志 -> 问题),共四步:
- PR 页:打开 PR,在评论区找到 openubmc-ci-bot 的回帖。
- 有「CI已开始运行,查看流水线详情」评论:点击其中的流水线链接进入第 2 步。
- 没有任何 CI 评论:属于触发失败,见触发失败。
- 有结果表(任务名称/结果表格):先看哪个任务为 FAILED,再点该评论之前最近一次「CI已开始运行」中的流水线链接。
- 流水线页:在运行记录中找到失败的那次运行(时间与结果表回帖对应),点开「CI门禁」阶段。
- Job 日志:点击失败任务(如「编译构建」)进入日志,定位到标红的失败步骤(如「执行构建」)。构建类 Job 失败时会自动打印
temp/log/task.log的最后 1000 行,日志中可直接搜索task.log、ERROR、FAILED、not found等关键字。 - 问题定界:按日志错误特征判断根因类别(见五类问题排查),再执行对应处理。
怎么重跑
| 命令 | 适用场景 | 注意事项 |
|---|---|---|
/retest | CI 未触发、疑似环境抖动、PR 描述修改后 | 门禁类检查结论不随重跑变化,须整改 PR 本身;重复触发会重新排队并抢占旧运行 |
/check-pr | 检视意见全部处理完(含回复或解决)后 | 通过后机器人移除 unresolved-reviews 等阻塞标签 |
/check-issue | 已关联 Issue 但 needs-issue 标签仍在 | 前提是已按格式完成关联 |
- 排队(Queue)一般数分钟内自行缓解,无需重复触发;重复触发反而会再次抢占排队位置。
- 运行被抢占取消属正常行为,以最后一次运行结果为准。
- 门禁失败为什么重跑无效,见门禁失败。
- 完整命令表(含
/publish、/ai review、/lgtm、/approve)见附录。
五类问题排查
触发失败
现象(如何被发现)
- PR 创建或推送更新后,评论区迟迟没有「CI已开始运行」评论。
- 流水线页面显示运行处于排队(Queue)状态长时间不动。
- 结果表回帖迟迟不来,但流水线页显示运行已被新运行抢占取消。
定位步骤
- PR 页确认 PR 状态:是否为草稿(Draft)PR。识别方法:PR 标题带
Draft:前缀,评论区右下角显示「标记为就绪(Ready for review)」按钮。草稿 PR 不触发 CI。 - PR 页确认最新推送是否成功:打开 PR 的「提交」标签页,核对最新一条提交的短 SHA 是否与本地
git log -1一致。本地有新提交但 PR 提交列表未更新,通常是未推送或推送到了其他分支。 - 进入仓库「流水线/CI」页面,按 PR 号过滤运行记录:
- 无任何运行记录:触发事件未到达或被平台过滤。
- 有记录但状态为排队:并发资源紧张(并发上限 10)。
- 有记录但被取消(Canceled):被同 PR 的更新抢占,属正常行为,以最后一次运行为准。
- 若触发配置疑似异常,检查
.gitcode/workflows/PR-pipeline_manifest.yml的on:配置是否被改动(近期是否有人合入流水线配置变更)。
判断依据
- 草稿 PR + 无 CI 评论 => 平台设计行为,非故障。
- 非草稿 + 无 CI 评论 + 无运行记录 => 触发失败。
- 运行记录存在但长时间排队(Queue)=> 资源排队,非代码问题。
- 运行被抢占取消 => 正常,看最后一次运行结果即可。
处理建议
- 草稿 PR 请先标记为就绪(Ready for review)。
- 非草稿 PR 无 CI 评论时,在 PR 下评论
/retest手动触发。 /retest仍无反应时,检查流水线文件与仓库 webhook 配置,或联系 manifest 仓所属 SIG sig-release-management 的维护者;联系人名单见 manifest 仓该 PR 机器人欢迎评论的「联系指引」一节。- 流水线环境自身问题(如镜像构建脚本缺文件、在线拉取公钥不可达等,参考 PR !2491):修 dockerfile/初始化脚本,并在 PR 描述中说明触发版本点(如「26.09 tag 起必现」),便于评审。
构建失败
指 CI 结果表中「编译构建」「编译构建1712」「编译构建3095」「编译构建AST2600」「依赖校验」为 FAILED。这是最常见的失败类别,其中相当一部分根因是制品缺失,定位时注意交叉判断。
现象(如何被发现)
- CI 结果表中一个或多个构建任务 FAILED。典型组合:
- 全部构建任务 + 依赖校验一起失败:多为制品缺失或全局配置问题。
- 仅部分单板失败(如仅 AST2600):多为板间差异配置问题。
/retest重跑后依然失败(非环境抖动)。
定位步骤
- 按怎么看日志进入失败 Job 日志,找到
bingo build报错段落(Job 会自动带出temp/log/task.log尾部 1000 行)。 - 在日志中依次搜索以下关键字并记录命中行:
not found in remote、revision、ModuleNotFoundError、Unable to locate package、CMake Error、internal compiler error、Killed、mount、checkout、mib。 - 按命中关键字跳转判断:
- 本地复现验证:在 manifest 仓执行与 CI 相同的命令
bingo build -b openUBMC -bt debug(单板失败则加对应-b参数),对照temp/log/task.log。
典型场景对照(错误特征 => 根因 => 修复案例)
| 日志错误特征 | 根因 | 真实案例 |
|---|---|---|
ModuleNotFoundError: No module named 'exceptions' | 环境镜像构建脚本缺文件:init.py 重构后新增依赖,dockerfile COPY 清单未同步 | PR !2491(修复镜像构建必现失败) |
Unable to locate package(apt install 阶段) | 镜像构建期在线拉取源公钥不可达,被静默吞掉后安装失败 | PR !2491(公钥随仓内置,消除在线依赖) |
mib 编译报 ocpCardIndex 相关错误 | mib 定义超出合法范围(如未声明 0-255 范围约束) | PR !2418(修复 mib 编译报错) |
CMake Error | 组件 CMake 构建配置或依赖声明错误,日志中会给出具体组件名 | 本地复现定位问题组件后修复(见处理建议) |
| 新增约束/配置文件后多单板构建失败 | 产品配置(如 option_constraints)与部分单板不兼容 | PR !2243(四单板新增约束首版,1712/3095/AST2600 构建失败) |
| 仅 AST2600 等特定单板失败 | 单板差异化配置被破坏(该单板特有组件/权限配置) | PR !2470(mtd 设备节点权限修改致 AST2600 构建失败) |
internal compiler error: Killed | 构建机/本地内存不足 | 参考构建常见问题 |
| mount 阶段卡住失败 | 容器权限不足 | 参考构建常见问题 |
| 编译构建 + 依赖校验同时失败且重跑无效 | 多为闭源组件 patch 缺失或组件版本未发布 | PR !2537/!2442(补充闭源组件 patch) |
处理建议
- 先判断是否环境抖动:评论
/retest重跑一次,连续两次以上相同失败才按代码/配置问题排查。 - 命中制品缺失特征(见制品缺失)时,先修制品/版本,不要改构建代码。
- 属于配置错误时,用本地
bingo build复现修复后再推送;涉及多单板的配置改动,至少本地验证失败过的单板目标。
门禁失败
指非构建类检查任务失败,以及机器人标签阻塞合入。特点是重跑无效(/retest 不会改变检查结论),必须整改 PR 本身。
现象(如何被发现)
- CI 结果表中「PR描述检查」「pre-commit检查」「修改行数检查」「防投毒检查」「开源合规检查」为 FAILED。
- PR 被打上阻塞标签:
needs-issue(未关联 Issue)、needs-squash(提交未压缩)、limit_1k_failed(变更超限)、unresolved-reviews(检视意见未处理)。 - 机器人评论「当前PR有 N 条评论意见,其中 N 条未处理完毕」或「提交的PR需要关联issue」。
定位步骤
- PR 页读机器人评论,确认阻塞项:
- 结果表哪个门禁任务 FAILED。
- 标签区是否有 needs-issue / needs-squash / limit_1k_failed 等。
- 「注意」评论提示的未处理检视意见数量。
- 门禁任务 FAILED 时,进入对应 Job 日志看具体命中项:
- PR描述检查:日志逐字段列出 5 个必填字段的检查结果与字符数。
- pre-commit检查:日志给出具体钩子(如 semgrep、格式化)命中的文件与规则。
- 防投毒/开源合规:日志给出扫描命中的文件与规则说明。
- 检视意见类:在 PR 的 Changes/评论列表中逐条查看未 resolved 的意见。
判断依据
- PR描述检查 FAILED => 描述为空,或 5 个模板字段任一缺失/不足 10 个字符。这是门禁类最高频问题(如 PR !2290 连续多次失败、PR !2491 补全描述后通过)。
- pre-commit检查 FAILED => 格式不符或 semgrep 敏感信息命中(IP、账号、内部标识等)。
- 修改行数检查 FAILED => 变更超过 1000 行且未获超大变更许可,PR 会被打
limit_1k_failed标签;代码更新后机器人会移除limit_1k_suc重新检查。 - 防投毒检查 FAILED => 引入新仓库/新依赖触发恶意代码扫描(如 PR !2203 集成新仓库 web_sol)。
- 开源合规检查 FAILED => LICENSE 或源码版权头不合规(如 PR !2521;社区随后通过 PR !2528 统一 LICENSE 与版权声明治理)。
- needs-issue 标签 => 未按格式关联 Issue(最高频的合入阻塞项)。
- needs-squash 标签 => 存在多个待压缩提交或未按社区提交规范。
处理建议
- PR描述检查:按模板补全 5 个字段,每字段不少于 10 个字符,保存后评论
/retest(描述检查随 CI 重跑)。 - pre-commit:本地
pre-commit run --all-files全量自检,修复格式与敏感信息命中(密钥/账号先移除或脱敏,确属误报再向 SIG 反馈)。 - 修改行数超限:拆分 PR;确需大变更时按超大变更流程申请,通过后获得
limit_1k_suc。 - 防投毒/开源合规误报:在 PR 中说明命中内容用途,联系 sig-release-management 复核;真正的合规问题按 PR !2528 的治理方式整改(木兰 PSL v2 LICENSE、标准版权头)。
- needs-issue:按指导关联 Issue(PR 描述
fixes #编号或页面关联功能),完成后评论/check-issue移除标签。 - needs-squash:压缩/整理提交后推送,机器人自动复查。
- 检视意见全部处理完(含回复或解决)后评论
/check-pr,通过后机器人移除阻塞标签。
推送前本地自检清单(门禁失败重跑无效,推送前提前规避):
pre-commit run --all-files全量通过:修复格式问题与 semgrep 敏感信息命中(密钥/账号先移除或脱敏)。- 自查变更行数:默认不超过 1000 行,超出先拆分 PR;确需大变更按超大变更流程申请。
- 按模板写全 PR 描述 5 个字段(功能描述/修改方案/验证方案/测试建议/自验证报告),每字段不少于 10 个字符。
- 按
fixes #编号格式关联 Issue,或使用页面关联功能。 - 整理提交:压缩零散提交、遵守社区提交规范,避免 needs-squash。
制品缺失
构建/依赖校验失败的最高频根因类别:manifest 引用的组件制品在 conan 仓中不存在、版本未发布,或制品内容已更新但锁定信息(revision/哈希)未同步。
现象(如何被发现)
- 「编译构建」与「依赖校验」同时失败,常见多单板全红;典型触发者是「升级组件版本号」类 PR(如 PR !2488 升级 libsoc_adapter/general_hardware、PR !2496 升级 vpd、PR !2306 升级 devmon 等,均在 CI 中构建+依赖校验失败)。
- 日志含
was not found in remote '<远端名>'(远端名为openubmc_opensource,较早的 Conan 1.x 环境与 CI 镜像中为openubmc_dev,以日志实际输出为准)。 - 日志含 recipe revision 不匹配、SDK 锁定哈希校验失败。
- 日志含
checkout ... returned non-zero exit status 128, reference is not a tree。
定位步骤
- 进入失败的「编译构建」或「依赖校验」Job 日志,确认报错组件名与版本号。
- 确认制品是否已发布:
conan search '组件名/*' -r <远端名>查看远端已发布版本清单,核对目标版本是否存在。远端名以本地conan remote list输出为准:init.py初始化的当前环境为openubmc_opensource,较早的 Conan 1.x 环境为openubmc_dev,两者均为社区制品仓(conan.openubmc.cn),排查方法相同。 - 版本存在仍失败时,核对锁定文件(
build/sdk/openubmc_sdk.lock)中该组件的 revision/哈希与远端实际制品是否一致(版本号相同但 revision 不同即命中本类问题)。 - 报
reference is not a tree时,排查组件发布后源码仓是否被强推或删除过提交。
判断依据
- 目标版本不在
conan search结果中 => 版本未发布(常见于组件仓 PR 刚合入、制品尚未发布就先提了 manifest 升级 PR)。 - 版本存在但 revision/哈希与 lock 文件不一致 => 组件同版本重发布后 manifest 未同步(如 PR !1877:storage 版本号不变、recipe revision 从
3ac2b2db更新为72038784;PR !2184:firmware_mgmt 包哈希更新)。 reference is not a tree=> 组件发布后 git 提交树被变更(强推/删提交)。- 闭源组件触发源码构建(
ERROR in xx Method类报错)=> 闭源制品缺失/本地环境不配套,CI 场景多为闭源组件 patch 未同步(PR !2537/!2442 即为此类)。
处理建议
- 版本未发布:先到组件仓完成制品发布(PR 合入前评论
/publish,见怎么推包),确认conan search可见后再更新 manifest 升级 PR,必要时/retest。 - revision/哈希不一致:同步更新 lock 文件中对应组件的 revision/包哈希(保持版本号不变),参考 PR !1877、!2184、!1855 的做法。
- git 树被变更:遵守社区规范——版本发布后不得修改 git 信息树;已发生变更的需重新发布组件版本。
- 闭源组件问题:按社区指导补齐闭源组件 patch/环境(CI 侧提 patch PR,本地侧参考构建常见问题中 bmc_sdk 配套说明)。
- 预防:升级组件版本的 PR 在描述中注明组件仓发布 PR/制品链接,便于评审与 CI 失败时快速核对。
权限异常(流水线侧)
典型日志特征
- 日志出现
Username for 'https://...'交互提示后卡住,或 git 拉取报 403。 - 日志出现
permission denied/connect to the Docker daemon socket。 - mount 相关步骤持续失败。
- 整包构建长时间无输出,日志(task.log)显示停在 conan 认证等待输入。
- CI 容器内 sudo 相关命令失败。
判断与处理
- CI 内 conan 凭证由流水线 secrets 注入(CONAN_R_USER/PASSWORD),个人无感知;同样命令本地执行失败时,优先怀疑本地凭证配置(见场景二·权限异常)。
- CI 内 sudo 失败 => 容器内非 root 提权受限(PR !1801 即为消除 qemu 构建流程中不必要的 sudo 操作);处理方向是重构构建脚本消除对提权的依赖,而非申请放开权限。
- 其余 403 /
Username for/ mount / docker 权限特征与本地同源,识别与修复方法见场景二·权限异常。
怎么推包
构建与制品类问题的通用修复路径:让 manifest 引用的制品先于升级 PR 存在。
- 组件仓发布:组件开发完成、本地
bingo build验证通过后,在组件仓 PR 合入前评论/publish(任何人可评论):PR 合入后机器人自动执行组件编译构建并发布到 conan 中心仓,同时将构建源码打 tag 发布到 GitCode 平台。漏评论/publish或发布失败时,联系组件仓 maintainer 手动发布。 - 核对制品可见:
conan search '组件名/*' -r <远端名>确认目标版本已出现在远端清单中(远端名说明见制品缺失定位步骤)。 - 更新 manifest:
- 新版本:更新 manifest 中组件版本号。
- 同版本重发布:保持版本号不变,同步更新 lock 文件中的 revision/包哈希(参考 PR !1877、!2184、!1855 的做法)。
- 重跑验证:推送后在 PR 下评论
/retest,确认「编译构建」「依赖校验」转绿。 - 规范:
- 版本发布后不得修改 git 信息树(强推/删提交会触发
reference is not a tree),已变更需重新发布版本。 - 升级组件版本的 PR 在描述中注明组件仓发布 PR/制品链接,便于评审与 CI 失败时快速核对。
- 版本发布后不得修改 git 信息树(强推/删提交会触发
场景二:本地构建
本地执行 bingo build / bingo analysis / bingo test 失败时的定位方法。本地失败与 CI 失败的根因高度重叠(构建失败、制品缺失、权限异常两边通用),本地特有的差异集中在环境问题。因此本地定位的第一步是分清「环境问题」还是「代码/制品问题」,再分流到对应类别。
定位路径:从现象到原因
- 确认环境基线(本地失败优先怀疑环境):
- 执行环境:WSL(推荐)还是原生 Linux 等其他环境;是否已在 manifest 仓执行过
python3 init.py完成初始化。 - 工具版本:
bingo --version是否为最新(老版本存在 mount 权限、认证静默等待等已知问题)。 - SDK 配套:本地
~/sdk、~/rtos_compiler(bmc_sdk)与所构建的 manifest 版本是否配套;切换版本构建时须换用对应版本 bmc_sdk 重新初始化。
- 执行环境:WSL(推荐)还是原生 Linux 等其他环境;是否已在 manifest 仓执行过
- 取完整日志:查看终端输出与
temp/log/task.log(与 CI 同源)。本地可查看全量日志,比 CI 自动带出的尾部 1000 行信息更全。 - 搜索错误特征:使用与场景一·构建失败定位步骤第 2 步相同的关键字列表。
- 按特征分流:按下文各节分组表比对错误特征,跳转对应处理;若 bingo 失败输出中已附带处理提示,优先按提示处理。
与 CI 结果交叉对照
本地与 CI 结果放在一起看,可以快速分界问题归属:
| 组合 | 大概率归属 | 动作 |
|---|---|---|
| 本地失败,CI 通过 | 本地环境/缓存问题(SDK 配套、凭证、资源) | 按环境问题排查,无需改代码 |
| 本地通过,CI 失败 | CI 环境抖动或 CI 镜像问题 | 评论 /retest 重跑;连续两次同错再按构建失败排查 |
| 两边都失败 | 代码/配置/制品问题 | 按场景一构建失败、制品缺失定位;本地日志更全,优先本地复现修复后推送 |
环境问题(本地)
以下案例整理自构建常见问题及社区常见构建报错。本地环境问题与流水线的触发失败相对应:流水线「跑不起来」看触发,本地「跑不起来」看环境。
环境与工具
| 日志错误特征 | 根因 | 处理/去向 |
|---|---|---|
bingo: command not found、conan 未安装 | 环境未初始化 | 开发环境初始化 |
CMAKE_C_COMPILER not set, after EnableLanguage | 环境未初始化(缺交叉编译工具链) | 在 manifest 仓执行 python3 init.py 或 bingo build -t install_sdk |
cannot import name 'decode_text' from 'conans.util.files' | conan 安装损坏(卸载不彻底) | pip3 uninstall conan 后重新 pip3 install conan |
No remote ... defined in remote | 未配置 conan 远端 | conan 仓使用指导,远端名见制品缺失定位步骤 |
| 构建卡住、日志停在 conan 认证等待 | conan 凭证失效未提示(老版本 bingo) | 权限异常(本地) |
KeyError: 'pwd' | bingo test 缺 -jit 选项,或 manifest 与 bmc_sdk 版本不配套 | 加 -jit 重试;核对 SDK 配套 |
自签名找不到 uboot 文件、Error in source() method、闭源组件 ERROR in xx Method | 本地 bmc_sdk 与依赖版本不配套 | 按官网对应版本 bmc_sdk 替换 ~/sdk、~/rtos_compiler,见构建常见问题 |
Couldn't checkout ... git(非 reference is not a tree) | 本机 git 令牌缺失 | 配置 git 凭证,见权限异常(本地) |
Permission denied(文件操作) | Linux 文件/用户权限不足 | 检查出错文件属主与当前用户权限 |
资源与网络
| 日志错误特征 | 根因 | 处理/去向 |
|---|---|---|
internal compiler error: Killed | 构建环境内存不足 | 内存不足解决说明;WSL 可调大 .wslconfig 的 memory=,磁盘充裕建议优先扩充物理内存 |
| 拉取源码、访问 conan 远端超时 | 网络受限,未配置代理 | 在 WSL 终端配置 http_proxy / https_proxy 环境变量,见开发环境初始化 |
配置代理后仍报 Could not resolve host | WSL 的 DNS 解析异常 | 修改 /etc/resolv.conf 为可用 DNS,见开发环境初始化 |
mount 阶段卡住失败、connect to the Docker daemon socket | bingo 构建镜像缺少特权 / 用户不在 docker 组 | 权限异常(本地) |
build.py 报 FileNotFoundError 找不到 SDK 文件 | -s 传入相对路径 | 改用 SDK 压缩包绝对路径 |
构建失败(本地)
manifest 与依赖配置
| 日志错误特征 | 根因 | 处理 |
|---|---|---|
Version conflict: Conflict between ... and ... | 依赖组件版本冲突 | 版本级构建查 temp/log/task.log 找到冲突组件修复;组件构建按控制台输出修复 |
组件没有在manifest中配置 | manifest 缺少依赖组件配置 | 在对应单板 manifest 中配置依赖组件 |
Duplicated requirement: ... | manifest.yml 配置了重复组件 | 删除重复配置 |
代码与配置
| 日志错误特征 | 根因 | 处理 |
|---|---|---|
CMake Error、组件编译报错等其余错误 | 代码/配置问题 | 对照场景一构建失败典型场景表,本地直接复现修复后推送 |
制品缺失(本地)
| 日志错误特征 | 根因 | 处理 |
|---|---|---|
was not found in remote、Unable to find ... in remotes | 组件制品未发布 | 与 CI 同理,见场景一制品缺失与怎么推包 |
revision/包哈希不匹配、reference is not a tree | 同版本重发布未同步 / git 树被变更 | 见怎么推包 |
| 下载组件构建配方(recipe)失败,退出码 1 | 本地 conan 缓存被清 | 组件仓重新 bingo build,见构建常见问题 |
权限异常(本地)
| 现象 | 根因 | 处理 |
|---|---|---|
git 拉取提示 Username for 或 403 | https 访问未配置凭证 | 创建 GitCode 私人令牌,配置 ~/.git-credentials 与 credential.helper store |
| 构建卡在 conan 认证等待 | 凭证失效未提示(老版本 bingo) | 升级最新 bingo(失效时会提示重新登录);老版本进入 task.log 按提示输入账号密码 |
permission denied ... docker daemon socket | 当前用户不在 docker 组 | sudo usermod -aG docker $USER 后重新登录生效 |
| mount 阶段失败 | bingo 构建镜像缺少特权(旧版 bingo 权限逻辑) | docker run 加 --privileged=true,并升级 bingo 至最新版 |
详细操作步骤见构建常见问题。
处理建议
- 环境问题:升级最新 bingo;SDK 不配套时按官网对应版本 bmc_sdk 替换本地
~/sdk、~/rtos_compiler,或重新执行python3 init.py/bingo build -t install_sdk。 - 缓存问题:清理本地 conan 缓存后重试(Conan 1.x:
rm -rf ~/.conan/data;Conan 2.x:conan remove "*" -c或rm -rf ~/.conan2/p/*),仍失败则重跑环境初始化。 - 制品问题:同场景一怎么推包——先发布组件制品,再更新 manifest 升级 PR。
- 自查无果再求助:附上「执行的完整命令、bingo 版本、环境形态(WSL/Linux 发行版等)、
temp/log/task.log尾部日志」四要素,到社区论坛或对应 SIG 提问,可显著缩短往返。
附录:机器人命令与标签速查
常用命令(在 PR 下评论)
| 命令 | 作用 |
|---|---|
| /retest | 重跑流水线(触发失败、环境抖动、描述修改后使用) |
| /check-pr | 检查检视意见是否全部处理完毕 |
| /check-issue | 已关联 Issue 但 needs-issue 标签仍在时移除标签 |
| /publish | 在组件仓 PR 合入前评论,合入后自动构建组件并发布制品到 conan 中心仓(同时打 tag) |
| /ai review | 触发 AI 代码审查 |
| /lgtm | 审核通过标签(需审核者权限) |
| /approve | 批准标签(需批准者权限),与 /lgtm 齐备后机器人自动合并 |
命令详细说明见机器人使用手册(PR 欢迎评论中的链接)。
常见标签
| 标签 | 含义 | 解除方式 |
|---|---|---|
| needs-issue | 未关联 Issue | 关联 Issue 后评论 /check-issue |
| needs-squash | 提交需压缩/整理 | 整理提交后推送 |
| limit_1k_failed | 变更超过 1000 行未通过 | 拆分变更或走超大变更流程 |
| limit_1k_suc | 超千行变更已获通过(代码更新后自动移除重新检查) | 保持 |
| unresolved-reviews | 存在未处理检视意见 | 处理完意见后评论 /check-pr |
| lgtm / approved | 审核通过/批准 | 齐备后自动合并 |
本地复现常用命令
以下命令的前提是已完成构建环境初始化:克隆 manifest 仓并在其目录下执行 python3 init.py -user <用户名> -psw <密码>(自动安装 bingo、配置 conan 远端与凭证),完整流程参考开发环境初始化。遇到命令不存在、认证失败等环境类报错,请参考构建常见问题。
# 主产品构建(与 CI 编译构建 Job 一致)
bingo build -b openUBMC -bt debug
# 依赖解析(与 CI 依赖校验 Job 一致)
bingo analysis --rebuild
# 查询远端已发布组件版本(制品核对;远端名以 conan remote list 为准,
# init.py 初始化的当前环境为 openubmc_opensource,较早环境为 openubmc_dev)
conan search '组件名/*' -r openubmc_opensource
# CI 构建失败时自动打印的日志文件
tail -n 1000 temp/log/task.log