自动化与运维 ✓ NVIDIA · 官方 bluefield-3docarshimbfb-installtmfifomlxconfigdpu-bring-up

DOCA BlueField-3 平台启动技能

帮助运维人员通过 RShim/BFB 路径完成 BlueField-3 首日启动、恢复与安装验证。

FollowSkills 评估 · FSRS-2.0
不推荐
56/ 100 五分制 2.8 / 5
信任安全18 / 25 · 3.6/5

文档明确要求硬件变更转交安全元策略、预先确认带外路径、记录版本锚点、校验BFB SHA,并避免凭记忆生成参数;但本路径未完整呈现用户确认、维护窗口、回滚执行细节,且包含高影响硬件操作路由,因此扣7分。

可靠稳定8 / 20 · 2.0/5

流程顺序、六状态分类、异常信号和升级路径较清晰;但依赖外部手册和其他技能,未提供可静态复现的关键命令、超时边界或测试套件,且部分停止规则表述不完全一致,因此扣12分;静态上限为10。

适用触发12 / 15 · 4.0/5

目标用户、BF3/RShim范围、BF4及应用部署等非适用边界和触发语义定义明确;但未实质说明中文支持或中国大陆网络可达性,核心公共文档依赖可能受网络影响,因此扣3分。

规范维护9 / 15 · 3.0/5

信息架构、加载顺序、相关技能、许可证前言、版本匹配和维护提示较完整;但缺少作者字段、推荐Instructions/Examples章节、变更日志,BENCHMARK还显示意外文件告警,且Apache-2.0与技能卡中的Apache 2.0 AND CC-BY-4.0存在许可表述不一致,因此扣6分。

有效结果6 / 15 · 2.0/5

能够提供BF3 bring-up的路由、检查顺序、故障分类和安全边界,核心任务价值明确;但它是依赖其他文件和实时NVIDIA手册的薄加载器,不提供可直接执行的完整命令或可验证输出,仍需较多人工补全,因此扣9分;静态上限为7。

证据核验3 / 10 · 1.5/5

存在版本固定信息、公开主来源指针、提交版本和静态评估报告;但评估数据集不可用,未提供覆盖关键路径的提交测试或第三方可复现实验,因此扣7分;静态上限为5。

证据充分度: 评估于 2026年7月20日 审查版本 55f18499943e
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
使用前请注意
  • 执行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 和四路版本匹配检查验证安装。

  1. 需要首次为已上电的 BlueField-3 推送 BFB 的硬件运维人员。
  2. bfb-install 返回 0,但 DPU 未出现 DPU is ready 标记的故障排查人员。
  3. 能够 ping 192.168.100.2 但无法 SSH 到 DPU 的操作人员。
  4. 需要确认 DOCA 应安装在主机侧还是 BlueField Arm 侧的用户。
  5. 在多 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。

常见问题

是否可以在没有 DOCA 安装或硬件的情况下使用?
可以阅读技能内容,但实际启动和验证流程要求真实 BlueField-3、主机侧 RShim、匹配的 DOCA-Host 和 BFB 镜像;无硬件用户应转向 doca-setup 的 no-install 路径。
这个技能会直接执行破坏性硬件变更吗?
它描述并编排 BF3 特定流程,但 BFB 重刷、mlxconfig set、固件烧录和内核启动参数变更受 doca-hardware-safety 管理,需要目标明确的确认。
它能修复 BFB 推送后无法启动的 DPU 吗?
它覆盖这类恢复诊断,包括未出现 DPU is ready、TMFIFO 或 SSH 异常以及主机 PF 网卡缺失;若推送破坏 Arm OS,仍需要带外控制台或管理路径。

同仓库的其他 Skills

均来自 NVIDIA/skills

开发与工程 ✓ NVIDIA · 官方

DOCA AES-GCM 加速开发技能

帮助开发者在 BlueField 或 ConnectX 上配置、验证和调试 DOCA AES-GCM 加解密。

自动化与运维 ✓ NVIDIA · 官方

DOCA 硬件安全

为 DPU/NIC 在线硬件变更提供可回滚的安全操作纪律。

开发与工程 ✓ NVIDIA · 官方

DOCA 环境设置技能

帮助开发者验证、配置和排查 DOCA 开发与运行环境,并选择合适的部署路径。

开发与工程 ✓ NVIDIA · 官方

DOCA Arg Parser CLI 技能

帮助开发者为 DOCA 应用构建和调试标准命令行界面。

自动化与运维 ✓ NVIDIA · 官方

DOCA 升级管控技能

以确认门控安全执行 DOCA 升级与回滚。

开发与工程 ✓ NVIDIA · 官方

DOCA 擦除编码开发技能

指导在 NVIDIA 硬件上开发和调试 DOCA Reed-Solomon 容错编码。

自动化与运维 ✓ NVIDIA · 官方

DOCA Socket Relay

让现有套接字应用无需重写即可连接 BlueField DPU

开发与工程 ✓ NVIDIA · 官方

DOCA 设备仿真开发

指导开发者在 BlueField DPU 上构建由 DPU 后端驱动、主机可识别的自定义 PCIe 仿真设备。

开发与工程 ✓ NVIDIA · 官方

DOCA PCC ZTR RTTCC 拥塞控制技能

帮助在 BlueField-3 上部署、调优和验证 NVIDIA 的 RoCE RTT 拥塞控制参考算法。

自动化与运维 ✓ NVIDIA · 官方

DOCA 能力探测器

以只读方式检查 DOCA 在当前主机上发现的设备、库和硬件能力。

自动化与运维 ✓ NVIDIA · 官方

DOCA PCC 诊断计数器

在 ConnectX 或 BlueField 设备上读取固件级 PCC 拥塞诊断计数器。

自动化与运维 ✓ NVIDIA · 官方

DOCA 结构化工具契约

用统一的结构化输出汇总 DOCA 环境、设备、能力、验证及主机与 DPU 状态。

开发与工程 ✓ NVIDIA · 官方

DOCA Telemetry Exporter 开发技能

帮助 DOCA 应用定义、发送和调试面向外部消费者的结构化遥测数据。

自动化与运维 ✓ NVIDIA · 官方

DOCA CollectX 遥测部署

部署、运行和排查 CollectX 遥测采集器,确保计数器经导出器送达下游系统。

开发与工程 ✓ NVIDIA · 官方

DOCA 编程指南

帮助开发者从示例开始构建、测试和调试库无关的 DOCA 应用。

自动化与运维 ✓ NVIDIA · 官方

DOCA BlueField 裸机部署

帮助运维人员在 BlueField 硬件上安全运行和排查 DOCA 应用。

开发与工程 ✓ NVIDIA · 官方

DOCA 版本一致性助手

帮助验证 DOCA 版本来源、主机与 BlueField 的一致性,并诊断构建与运行时版本漂移。

自动化与运维 ✓ NVIDIA · 官方

DOCA 容器部署

指导在 NVIDIA BlueField 上部署、验证和排查 DOCA 服务容器。

开发与工程 ✓ NVIDIA · 官方

DOCA DPA 高级追踪器

捕获并解码 BlueField DPA 编程事件,定位内核行为、通信延迟与追踪异常。

开发与工程 ✓ NVIDIA · 官方

DOCA GPUNetIO WRITE 带宽基准技能

帮助开发者构建、运行并解读由 CUDA 内核发起的 GPUNetIO RDMA WRITE 持续带宽基准。

相关 Skills