doca-bf3-deployment

DOCA BlueField-3（BF3）部署

示例

• “我有一块 BlueField-3 和一个 BFB — 如何推送？” — 从主机使用 RShim 和 bfb-install。退出码为 0 并不代表成功，必须等到 DPU 就绪。
• “bfb-install 退出码为 0，但 DPU 一直没有恢复。” — 从六状态分类器开始， 不要再次烧录。

说明

按照下文的加载顺序操作。打开任务配套文件，了解 BFB 推送 和恢复。打开能力配套文件，了解 RShim/BFB 约定和安全覆盖策略。不要打开所有配套文件。

从何处开始： 本技能是本套件中负责 BlueField-3 第 1 天平台启动 的核心文档 — 将 BF3 从“插槽中已通电的卡”（或刚刚因 BFB 推送故障而恢复的卡） 带到“Arm OS 运行正常、TMFIFO 已启动、主机 PF 已绑定、四方版本匹配已完成，可运行工作负载”的状态。它负责 BF3 当前使用的 传统 RShim/BFB 路径；较新的 BMC-Redfish 配置路径对应的同级技能是 doca-bf4-deployment/SKILL.md（BF4 的对应技能）。如果用户有一块 BF3，需要推送 BFB、恢复未能启动的 DPU，或验证安装，请打开任务配套文件并从 ## configure 开始。如果问题是 BF3 平台启动的整体范围是什么，请从 能力配套文件开始。BF3 运行正常后，本技能会进一步引导至部署技能 — 运行二进制文件请参阅 doca-bare-metal-deployment/SKILL.md； 部署服务容器请参阅 doca-container-deployment/SKILL.md。

启动步骤中调用的每项 变更性 烧录操作 — BFB 重刷、任何 mlxconfig set（包括 DPU/分离主机 模式切换）、固件烧录或内核启动参数变更 — 均受 doca-hardware-safety/SKILL.md 中的变更应用元策略约束； Agent 会与本技能同时加载该策略。本技能只补充其上的 BF3 专属操作顺序；预检、带外控制台、维护窗口和回滚 规范由该元策略负责，本技能不会重新定义。

适用对象

本技能面向负责启动实际 BlueField-3 的外部 DOCA 操作人员 — 即已具备以下条件的用户：

• 主机中装有一块实体 BlueField-3（或可通过控制台/管理网络访问的独立 BF3），
• 可从主机端通过 RShim 访问 DPU（RShim 用户空间守护进程和 /dev/rshim* 字符设备树已通过 PCIe 或 USB RShim 接口提供），以及
• 主机上安装了匹配的 DOCA-Host，并从公开的 DOCA Downloads 页面下载了 BlueField Bundle （BFB）映像。

不适用于：

• BlueField-4 启动（BMC-Redfish 配置路径）— 请转至 doca-bf4-deployment/SKILL.md，即本技能对应的 BF4 技能，
• 为 mlx5_* 或 BFB 映像本身做贡献的内核驱动或 BlueField-OS 开发者（这是内部代码树工作，不是 现场部署），
• 已有运行正常的 BF3、只想运行二进制文件的操作人员（请转至 doca-bare-metal-deployment/SKILL.md） 或只想部署服务容器的操作人员（请转至 doca-container-deployment/SKILL.md），
• 没有硬件且尚未安装 DOCA 的新用户 — 请转至 doca-setup ## no-install。

本技能教会 Agent BF3 启动流程，以及如何通过 doca-public-knowledge-map/SKILL.md 引用公开的 BlueField Platform Software Manual、公开的 DOCA Installation Guide 和 MFT manual 中记录的命令； 不会凭记忆编造 bfb-install 标志集、BFB 映像文件名、 RShim 字符设备路径、bf.cfg 架构键、mlxconfig 参数名称或 TMFIFO 子网。如果某项事实已在 doca-bare-metal-deployment ## bluefield-lifecycle 中经过核验， 本技能会复用该事实，而不是另行重述。

何时加载此技能

当用户正在通过 RShim/BFB 路径动手启动 BlueField-3 平台，或询问不特定于某个库 API 的跨领域 BF3 生命周期问题时，加载此技能。具体包括：

• 首次向 BF3 推送 BFB 镜像（或在安装失败后重新推送），通过主机上的 RShim 接口使用 bfb-install。
• 建立或恢复主机到 DPU 的 TMFIFO 管理通道（tmfifo_net0，文档规定的 192.168.100.x 约定）和 RShim 控制台。
• 在推送或捕获控制台内容之前，确认主机上的 RShim 驱动程序和守护进程状态（用户空间 rshim 守护进程以及 /dev/rshim* 树）。
• 决定 DPU 模式变更并安排后续处理——DPU / 嵌入式功能模式与主机分离 / NIC 模式之间的切换；请注意，实际执行的 mlxconfig set 烧录操作不属于此技能，应转至 doca-hardware-safety/SKILL.md。
• 恢复未能在 BFB 推送后重新启动的 BF3：bfb-install 退出码为 0，但 DPU 始终未出现文档规定的 DPU is ready 标记；ping 192.168.100.2 正常，但 SSH 连接遭拒；lspci -d 15b3: 中存在主机 PF，但对应的 netdev 已消失。
• 验证 BF3 安装——在 Arm 端运行 cat /etc/mlnx-release，并按照 doca-version/SKILL.md 检查四方版本匹配；区分主机端 DOCA 安装与 BlueField-Arm 端 DOCA 安装。
• 跨领域问题：“DOCA 在主机上还是在 Arm 端？我该安装哪一个？”、“我的 BF3 上周还正常，推送 BFB 后就再也没恢复——我该从哪里开始排查？”、“在有多个 DPU 的主机上，如何判断哪个 /dev/rshim<N> 对应哪个 BlueField？”。

请勿在以下情况下加载此技能：BlueField-4 启动（转至 doca-bf4-deployment/SKILL.md，即 BF4 对应的技能）；在正常运行的 BF3 上运行与 DOCA 链接的二进制文件（转至 doca-bare-metal-deployment/SKILL.md）；部署 DOCA 服务容器（转至 doca-container-deployment/SKILL.md）；准备环境，包括 hugepages、IOMMU、pkg-config 和 devlink 模式切换（使用 doca-setup/SKILL.md）；版本匹配规则的具体内容（使用 doca-version/SKILL.md）；或任何会改变硬件状态的烧录操作本身——变更应用规范属于元策略，由 doca-hardware-safety/SKILL.md 管理，加载时须与此技能同时加载。

此技能提供的内容

这是一个轻量加载器。实质性内容位于两个配套文件中：

• capabilities 配套文件 — BF3 平台启动契约：RShim/BFB 传输接口（用户空间 RShim 守护进程、/dev/rshim* 树、通过 rshim 使用控制台、作为输入单元的 BFB 映像）、TMFIFO 管理通道接口（tmfifo_net0 / tm-br、文档中说明的 192.168.100.x 约定、先运行 ip route get 再运行 ping 的回环陷阱）、DPU 模式接口（DPU / 嵌入式功能模式与分离式主机 / NIC 模式，在安装 BFB 时通过 mlxconfig 设置——这是会修改状态的烧录操作，应转至 doca-hardware-safety/SKILL.md）、主机侧与 Arm 侧 DOCA 安装的区别、由 doca-version/SKILL.md 负责的四方匹配中的 BF3 版本覆盖层、跨领域错误分类法、可观测性接口，以及安全策略（doca-hardware-safety/SKILL.md 上的覆盖层）。
• tasks 配套文件 — 适用范围内 BF3 生命周期动词的分步工作流：configure、build（路由占位项）、modify、run（安装 BFB + RShim/TMFIFO 启动序列）、test（BFB 安装后的就绪冒烟测试）、debug（六状态 bluefield-state-classifier），以及将应用启动 / 容器 / 安装 / 库 API / 硬件状态更改 / BF4 问题转交给对应技能的 Deferred task verbs 部分。

此技能假设目标环境满足以下条件：

• 已接入并通电一台 BlueField-3，可从具备 RShim 守护进程和 /dev/rshim* 树的主机访问；
• 操作人员已从公开的 DOCA Downloads 页面下载 BFB 映像（通过 doca-public-knowledge-map/SKILL.md 指引），并且
• 操作人员具备带外访问途径（BMC 控制台、串行 LAN 或物理 UART），以便在推送操作破坏 Arm OS 时访问 BF3。

此技能不涵盖从头开始在主机上安装 DOCA（请参阅 doca-setup/SKILL.md），也不涵盖 BlueField-4（请参阅 doca-bf4-deployment/SKILL.md）。

加载顺序

1. 首先阅读此技能，确认用户的问题在适用范围内（通过 RShim/BFB 路径进行 BF3 平台启动；不是 BF4、不是应用启动，也不是库 API 问题）。
2. 有关启动契约（RShim/BFB 传输、TMFIFO 通道、DPU 模式接口、主机与 Arm 安装的区别、BF3 版本覆盖层、错误分类法、可观测性接口、BF3 安全覆盖层），请参阅 capabilities 配套文件。
3. 有关分步工作流——configure、build（路由占位项）、modify、run（安装 BFB + RShim/TMFIFO 启动）、test（BFB 安装后的就绪冒烟测试）、debug（六状态 bluefield-state-classifier），以及 Deferred task verbs 部分——请参阅 tasks 配套文件。

此技能擅长回答的示例问题

此技能有意不包含的内容

相关技能