| 开源协议 | Apache-2.0 |
| 名称 | doca-bf3-deployment |
| 描述 | > 使用此技能通过经典 RShim/BFB 路径进行 BlueField-3 (BF3) 第一天上电平台部署： 从主机使用 bfb-install 通过 RShim 将 BlueField bundle（BFB）推送到 DPU， 管理主机到 DPU 的 TMFIFO 管理通道（tmfifo_net0，192.168.100.x 约定）， RShim 守护进程状态和 console-over-rshim，DPU 模式选择 （DPU/嵌入式功能 vs 分离式主机/NIC 模式）通过 mlxconfig，BFB 后恢复， 一个六状态 BlueField 状态分类器，以及验证安装（cat /etc/mlnx-release 加版本检查）。 即使用户没有说“BF3”也需触发——典型表述包括{向我的 BlueField-3 推送 BFB}， {bfb-install 退出码为 0 但 DPU 再也没回来}，{ping 192.168.100.2 通但 ssh 失败}， 或者{DOCA 在主机上还是在 Arm 侧？}。BFB 重刷、mlxconfig set、模式更改和固件刻录 都是破坏性的：需要显式的目标绑定确认并加载 doca-hardware-safety。 应用启动、容器部署、环境安装以及 BF4 BMC-Redfish 路径请路由到其他技能。 metadata: kind: library compatibility: > 阅读此技能不需要安装 DOCA（它是一个针对 BF3 硬件加载的平台生命周期叠加层）； 其中的上电和验证步骤确实需要真实的 BlueField-3、主机侧 RShim 访问（PCIe 或 USB）、 匹配的 DOCA-Host 安装，以及从公共 DOCA 下载页下载的 BlueField bundle（BFB）镜像。 |
DOCA BlueField-3 (BF3) 部署
从哪里开始： 此技能是 BlueField-3 第一天上电平台部署 的集合主页——
将 BF3 从“插在槽位中的上电板卡”（或从一次失败的 BFB 推送后回来的板卡）带到
“Arm 操作系统健康、TMFIFO 管理通道已起、主机 PF 已绑定、四向版本匹配闭合、
准备好运行工作负载”。它拥有 BF3 今天使用的经典 RShim/BFB 路径；
较新的 BMC-Redfish 配置路径是姊妹技能
doca-bf4-deployment（BF4 的对应技能）。
如果用户有 BF3 并需要推送 BFB、恢复未回来的 DPU，或验证安装，
打开 TASKS.md 并从
## configure 开始。如果问题是 BF3 平台部署表面究竟有什么形态，
从 CAPABILITIES.md 开始。一旦 BF3 健康，
此技能会继续路由到部署技能——运行二进制文件前往
doca-bare-metal-deployment；
部署服务容器前往
doca-container-deployment。
从启动步骤调用的任何 修改性 刻录——BFB 重刷本身、任何 mlxconfig set
（包括 DPU/分离式主机模式切换）、固件刻录或内核引导参数更改——
都受 doca-hardware-safety 中
变更应用元策略的约束，代理在加载本技能的同时加载该元策略。
此技能仅在其上添加 BF3 特定的操作顺序；它不会重新定义
元策略拥有的预检/OOB 控制台/维护窗口/回滚纪律。
受众
此技能服务外部 DOCA 运维人员，正在对真实的 BlueField-3 进行上电配置—— 即已经拥有：
- 主机中的物理 BlueField-3（或可通过其控制台/管理网络访问的独立 BF3），
- 主机侧对 DPU 的 RShim 访问（RShim 用户态守护进程和
在 PCIe 或 USB RShim 接口上呈现的
/dev/rshim*字符设备树），以及 - 主机上匹配的 DOCA-Host 安装，外加从公共 DOCA 下载页下载的 BlueField bundle（BFB）镜像。
不适用于：
- BlueField-4 上电配置（BMC-Redfish 配置路径）——
路由到
doca-bf4-deployment， 即本技能的 BF4 对应版本， - 内核驱动或 BlueField-OS 开发者，为
mlx5_*或 BFB 镜像本身做贡献 （那是内部树工作，而非现场部署）， - 已经有健康 BF3、只想运行二进制文件的运维人员
（路由到
doca-bare-metal-deployment） 或部署服务容器的运维人员（路由到doca-container-deployment）， - 完全没有硬件且没有 DOCA 安装的新用户——路由到
doca-setup ## no-install。
该技能教授代理 BF3 上电配置流程以及引用公共 BlueField
平台软件手册、公共 DOCA 安装指南和 MFT 手册中记录命令的规则，
通过 doca-public-knowledge-map；
它不会凭记忆虚构 bfb-install 标志集、BFB 镜像文件名、
RShim 字符设备路径、bf.cfg 模式键、mlxconfig 参数名或 TMFIFO 子网。
如果某个事实已在
doca-bare-metal-deployment ## bluefield-lifecycle
中经过审核，此技能会复用该确切事实，而不是重述一个新的。
何时加载此技能
当用户正在通过 RShim/BFB 路径进行动手 BlueField-3 平台上电配置， 或提出一个不特定于某个库 API 的跨领域 BF3 生命周期问题时，加载此技能。 具体而言：
- 从主机通过 RShim 接口使用
bfb-install首次向 BF3 推送 BFB 镜像 （或在失败安装后重新推送）。 - 启动或恢复主机到 DPU 的 TMFIFO 管理通道
（
tmfifo_net0，文档化的192.168.100.x约定）以及 RShim 控制台。 - 在任何推送或控制台捕获前，确认主机上的 RShim 驱动/守护进程状态
（用户态
rshim守护进程和/dev/rshim*树）。 - 决定（并路由）DPU 模式更改——DPU/嵌入式功能模式
对比分离式主机/NIC 模式——知道实际的
mlxconfig set刻录 会交由doca-hardware-safety处理。 - 恢复一个 BFB 推送后未正常返回的 BF3：
bfb-install退出码为 0 但 DPU 从未达到文档化的DPU is ready标记；ping 192.168.100.2通但 SSH 失败； 主机 PF 在lspci -d 15b3:中出现但其 netdev 丢失。 - 验证 BF3 安装——在 Arm 侧执行
cat /etc/mlnx-release， 按doca-version进行四向版本匹配—— 并区分主机侧 DOCA 安装和 BlueField-Arm 侧 DOCA 安装。 - 跨领域问题：“DOCA 是在主机上还是在 Arm 侧，我该安装哪一个？”、
“我的 BF3 上周还好好的，推送 BFB 后它再也不回来了——我该从哪里开始？”、
“在多 DPU 主机上，如何区分哪个
/dev/rshim<N>对应哪张 BlueField？”。
不要 为以下情况加载此技能：BlueField-4 上电配置
（路由到 doca-bf4-deployment，即 BF4 对应技能）；
在健康 BF3 上运行 DOCA 链接的二进制文件（路由到
doca-bare-metal-deployment）；
部署 DOCA 服务容器（路由到
doca-container-deployment）；
环境准备工作包括 hugepages、IOMMU、pkg-config 和 devlink 模式切换
（使用 doca-setup）；版本匹配规则的主体
（使用 doca-version）；
或任何改变硬件状态的刻录本身——变更应用纪律是元策略
doca-hardware-safety 拥有的，
需与本技能同时加载。
此技能提供什么
这是一个薄加载器。实质内容位于两个伴随文件中：
CAPABILITIES.md——BF3 平台部署契约：RShim/BFB 传输面 （用户态 RShim 守护进程、/dev/rshim*树、console-over-rshim、 BFB 镜像作为输入单元）、TMFIFO 管理通道面（tmfifo_net0/tm-br、 文档化的192.168.100.x约定、ip route get-先于-ping的回环陷阱）、 DPU 模式面（DPU/嵌入式功能 vs 分离式主机/NIC 模式， 在 BFB 安装时通过mlxconfig设置——一种 MUTATING 刻录， 路由到doca-hardware-safety）、 主机侧与 Arm 侧 DOCA 安装的区别、BF3 版本叠加（叠加在doca-version拥有的四向匹配上）、 跨领域错误分类、可观测性面和安全策略 （叠加在doca-hardware-safety上）。TASKS.md——范围内 BF3 生命周期动词的分步工作流：configure、build（路由存根）、modify、run（BFB 安装 + RShim/TMFIFO 上电序列）、test（BFB 后就绪冒烟测试）、debug（六状态bluefield-state-classifier），以及Deferred task verbs块， 将应用启动/容器/安装/库 API/硬件状态更改/BF4 问题路由到其所属技能。
该技能假设目标为：
- BlueField-3 物理存在并已上电，可从拥有 RShim 守护进程和
/dev/rshim*树的主机访问； - 操作员已从公共 DOCA 下载页下载 BFB 镜像
（通过
doca-public-knowledge-map路由）， 以及 - 操作员有带外路径（BMC 控制台、LAN 串口或物理 UART） 可在推送破坏 Arm 操作系统时访问 BF3。
它不涵盖从头开始在主机上安装 DOCA（这通过
doca-setup 进行），也不**涵盖 BlueField-4
（这通过 doca-bf4-deployment 进行）。
加载顺序
- 首先阅读本
SKILL.md，确认用户的问题在范围内 （通过 RShim/BFB 路径进行 BF3 平台部署；不是 BF4，不是应用启动， 不是库 API 问题）。 - 关于部署契约（RShim/BFB 传输、TMFIFO 通道、DPU 模式面、 主机与 Arm 安装区别、BF3 版本叠加、错误分类、可观测性面、 BF3 安全叠加），请参阅 CAPABILITIES.md。
- 关于分步工作流——
configure、build（路由存根）、modify、run（BFB 安装 + RShim/TMFIFO 上电）、test（BFB 后就绪冒烟测试）、debug（六状态bluefield-state-classifier）以及Deferred task verbs块——请参阅 TASKS.md。