DOCA BlueField-3 平台启动技能
帮助运维人员通过 RShim/BFB 路径完成 BlueField-3 首日启动、恢复与安装验证。
文档明确要求硬件变更转交安全元策略、预先确认带外路径、记录版本锚点、校验BFB SHA,并避免凭记忆生成参数;但本路径未完整呈现用户确认、维护窗口、回滚执行细节,且包含高影响硬件操作路由,因此扣7分。
流程顺序、六状态分类、异常信号和升级路径较清晰;但依赖外部手册和其他技能,未提供可静态复现的关键命令、超时边界或测试套件,且部分停止规则表述不完全一致,因此扣12分;静态上限为10。
目标用户、BF3/RShim范围、BF4及应用部署等非适用边界和触发语义定义明确;但未实质说明中文支持或中国大陆网络可达性,核心公共文档依赖可能受网络影响,因此扣3分。
信息架构、加载顺序、相关技能、许可证前言、版本匹配和维护提示较完整;但缺少作者字段、推荐Instructions/Examples章节、变更日志,BENCHMARK还显示意外文件告警,且Apache-2.0与技能卡中的Apache 2.0 AND CC-BY-4.0存在许可表述不一致,因此扣6分。
能够提供BF3 bring-up的路由、检查顺序、故障分类和安全边界,核心任务价值明确;但它是依赖其他文件和实时NVIDIA手册的薄加载器,不提供可直接执行的完整命令或可验证输出,仍需较多人工补全,因此扣9分;静态上限为7。
存在版本固定信息、公开主来源指针、提交版本和静态评估报告;但评估数据集不可用,未提供覆盖关键路径的提交测试或第三方可复现实验,因此扣7分;静态上限为5。
- 执行BFB重刷、mlxconfig set、固件烧录或内核参数变更前,必须确认配套安全元策略实际加载,并获得明确确认、维护窗口、带外访问和可执行回滚方案。
- 该技能不提供完整可复制命令,必须按目标DOCA/BFB版本核对实时NVIDIA手册和工具--help;不要直接套用文中的示例符号、地址或参数。
- 许可证元数据与技能卡的许可表述不一致,发布前应统一并明确适用范围。
- 未验证中文交互和中国大陆网络可达性;依赖的海外公共文档可能需要镜像、缓存或人工提供。
这个 Skill 能做什么,适合哪些场景?
该技能面向拥有真实 BlueField-3 硬件的 DOCA 运维人员,覆盖经典 RShim/BFB 平台启动流程。它指导从主机使用 bfb-install 推送 BFB,并处理 RShim 守护进程、RShim 控制台和 TMFIFO 管理通道。技能还覆盖 DPU/嵌入式功能模式与分离主机/NIC 模式、BFB 推送后的恢复,以及安装和版本匹配验证。它不负责 BlueField-4、应用启动、服务容器部署或从零安装 DOCA。
检查并指导主机侧 RShim 守护进程和 /dev/rshim* 设备树的使用;通过 bfb-install 将 BFB 推送到 BlueField-3;处理 console-over-rshim、tmfifo_net0、tm-br 和 192.168.100.x 管理地址约定;指导使用 mlxconfig 进行模式选择,并将变更操作交由硬件安全策略;针对 BFB 推送后 DPU 未恢复、SSH 拒绝或主机 PF 网卡缺失等情况进行分类诊断;通过 Arm 侧 cat /etc/mlnx-release 和四路版本匹配检查验证安装。
- 需要首次为已上电的 BlueField-3 推送 BFB 的硬件运维人员。
- bfb-install 返回 0,但 DPU 未出现 DPU is ready 标记的故障排查人员。
- 能够 ping 192.168.100.2 但无法 SSH 到 DPU 的操作人员。
- 需要确认 DOCA 应安装在主机侧还是 BlueField Arm 侧的用户。
- 在多 DPU 主机上需要识别不同 /dev/rshim<N> 对应设备的运维人员。
这个 Skill 有哪些优点和局限?
- 覆盖 BF3 首日平台启动、恢复、TMFIFO/RShim 管理通道和安装验证。
- 明确区分主机侧 DOCA 与 Arm 侧 DOCA。
- 包含六状态 BlueField 状态分类器和明确的技能边界。
- 对 BFB 重刷、模式切换和固件烧录设置安全路由。
- 依赖真实 BlueField-3 硬件、RShim 访问、DOCA-Host 和 BFB 镜像。
- 不覆盖 BlueField-4 的 BMC-Redfish 启动路径。
- 不负责 DOCA 从零安装、应用运行、服务容器部署或库 API 使用。
- SKILL.md 是薄加载器,实质流程位于同目录的 CAPABILITIES.md 和 TASKS.md;当前提供材料未展示这些文件的完整内容。
如何安装这个 Skill?
使用 NVIDIA skills CLI 安装指定技能:
npx skills add nvidia/skills --skill doca-bf3-deployment --yes
README 未规定手动复制该技能目录的具体步骤。
如何使用这个 Skill?
安装后,在相关任务中直接描述目标,例如:"Push a BFB to my BlueField-3"、"bfb-install exited 0 but the DPU never came back" 或 "ping 192.168.100.2 works but ssh fails"。使用前应具备真实 BlueField-3、主机侧 RShim 访问、匹配的 DOCA-Host、BFB 镜像,以及故障恢复所需的带外控制台路径。BFB 重刷、mlxconfig set、固件烧录和内核启动参数变更需要目标明确的确认,并配合 doca-hardware-safety。
这个 Skill 与同类方案有什么区别?
技能明确将 BlueField-4 的 BMC-Redfish provisioning path 交由 doca-bf4-deployment,并将健康 BF3 上运行二进制或部署服务容器分别交由 doca-bare-metal-deployment 和 doca-container-deployment。