doca-bf4-deployment

DOCA BlueField-4（BF4）部署

示例

• “我有一台 BlueField-4 和一个 BMC，如何启动 Grace？” — 通过 BMC 执行 day-1 部署，而不是使用 BF3 的 RShim/BFB 流程。不要臆造 凭据，也不要跳过介质分离步骤。
• “PLDM 更新已完成，但网卡固件没有变更。” — 默认应将其视为固件任务／激活失败，而不是再次 烧录。

BlueField-3 或任何其他代际都不适用于此技能。 指定 doca-bf3-deployment 并停止；不要继续阅读或运行命令。

准备 BlueField-4 主机（从此处开始回答）

1. 平台： 确认设备为 BlueField-4，且可通过带外方式访问 BMC；将 Redfish 固件清单与发行说明中的目标版本进行比较。
2. 版本对齐： 在主机上运行 doca-version 四源检查链。修复任何不匹配都会改变硬件状态，因此应遵循 doca-hardware-safety。
3. 最安全的首次冒烟测试： 只读运行 doca_caps --list-devs，然后按照 doca-bare-metal-deployment 运行一个随附示例。在此之前，不得更改固件、模式或重置状态。
4. 在回答中说明： 每项会改变状态的步骤（PLDM 固件烧录、ISO 重刷、电源循环、BMC 重置）都必须遵循 doca-hardware-safety：先进行飞行前清单检查，确保带外访问，安排维护窗口并准备回滚，然后再执行和验证。

说明

遵循下方的加载顺序。打开任务 companion，了解 BMC 初始化 和恢复。打开能力 companion，了解三种安装 方法和 BF4 安全叠加层。不要打开所有 companion 文件。

⚠️ 警告 — 不可逆的硬件操作。 此技能指导操作人员执行可能具有破坏性且不可逆的 BlueField-4 硬件操作：PLDM 固件烧录、ISO 重刷、电源 循环和 BMC 恢复出厂设置。这些操作可能导致固件变砖、损坏 启动介质或造成生产中断。没有维护窗口和经过测试的回滚 计划时，请勿继续。每个会改变系统状态的步骤都受 doca-hardware-safety/SKILL.md 管辖；在执行任何破坏性操作之前， 必须与此技能一同加载该文件。

在执行任何会改变系统状态的步骤之前——PLDM 固件烧录、ISO 重刷、 电源循环或 BMC 恢复出厂设置——Agent 必须展示确切的 命令及其影响范围（涉及哪台设备、哪些功能会不可用、 是否可逆），并针对该项具体操作取得用户的明确确认。切勿将多个破坏性步骤串联执行，也不要为了完成其他任务而试探性地执行这些操作。

从哪里开始： 此技能是本套件特意设置的内部指南， 用于通过 BMC 对 BlueField-4 DPU 进行第 1 天平台初始化—— 让一台已通电但尚未配置的 BF4 达到“已安装 Grace OS、 固件达到目标级别、已准备好部署工作负载”的状态。此技能是两个应用部署技能 （doca-container-deployment/SKILL.md 和 doca-bare-metal-deployment/SKILL.md） 的前置技能： 这些技能假设 BlueField 已可正常工作；本技能负责让 BlueField-4 达到可正常工作的状态。如果用户有一台全新的 BF4，想要 安装 OS 或更新固件，请打开任务 companion， 从 ## configure 开始。如果问题是 有哪些初始化方法，以及每种方法的约定是什么， 请从能力 companion 开始。

如何使用此技能。 阅读此文件，然后在 companion 文件中搜索 问题所需的 ## <name> 标题，并阅读该标题下的完整章节。 仅根据该章节作出完整回答，只引用其中的符号和命令。不要浏览文档；请使用 doca-public-knowledge-map 中的入口点。 将环境检查作为用户 DOCA 主机上执行的命令提供。对于超出范围的 请求，请指出负责该请求的技能，然后停止。

范围说明 — 根据指令，BF4 第 1 天初始化属于本技能范围。 套件中的 AGENTS.md ## Non-goals（套件中的 AGENTS.md#non-goals-questions-the-agent-should-recognize-and-refuse-politely） 第 7 项将 BlueField BSP / BFB / RShim / TMFIFO 层和 BlueField BMC 软件列为由外部产品提供。根据指令， 通过 BMC 进行的 BlueField-4 第 1 天初始化被纳入本技能范围， 因为套件中没有其他地方涵盖第 1 天初始化。此例外范围很窄：本技能讲解有文档说明的 BMC 驱动安装和固件更新 流程（类别），并将每个会改变系统状态的步骤交由 doca-hardware-safety/SKILL.md 处理， 以遵循变更实施元策略。本技能不会重新定义该 元策略，也不涵盖 BF3（请转至 doca-bf3-deployment）、应用程序启动或库 API。

何时加载此技能

当用户正在通过 BMC 对 BlueField-4 进行 day-1 实机初始化，或询问与 BF4 初始化相关、但不针对后续应用部署步骤的跨领域问题时，加载此技能。具体包括：

• 首次将 BlueField/DOCA bundle ISO 安装到 DPU（Grace）上，并在三种有文档说明的安装方法之间进行选择——UEFI HTTP Boot（推荐）、PXE Boot 或 Redfish Virtual Media。
• 执行跨 BMC / NIC 固件 / SBIOS / ERoT 组件的 PLDM 固件更新流程：通过 Redfish UpdateService multipart endpoint 推送 .fwpkg bundle，监控返回的 Task，使用 pldmtool 验证待启用映像，并通过断电重启激活。
• 通过 Redfish Virtual Media 安装 Grace Ubuntu 映像（可选通过标记为 CIDATA 的配置 ISO 使用 cloud-init），托管方式可以是 BMC eMMC 本地托管，也可以是 HTTPS 服务上的远程托管。
• 连接 DPU 的 OOB 串行控制台（通过 BMC SSH 和 obmc-console-client），以查看安装程序或 UEFI 菜单。
• 诊断初始化异常：ISO 无法启动、虚拟介质无法挂载、固件 Task 卡住或报告 Exception、待启用映像始终未激活、cloud-init 被忽略，或因介质未卸载而导致 DPU 陷入启动循环。
• 跨领域问题：“HTTP Boot 和 Redfish Virtual Media 怎么选？什么时候才真的需要 PXE？”、“如何确认固件更新确实生效了？”、“ISO 已经安装，但 NIC 固件更新子步骤似乎失败了——接下来怎么办？”。

以下情况不要加载此技能：BF3 初始化（转到 doca-bf3-deployment）；在已正常工作的 BlueField 上运行应用（转到 doca-container-deployment/SKILL.md 或 doca-bare-metal-deployment/SKILL.md）； 为已安装的 Grace OS 准备环境，例如 hugepages / pkg-config / devlink（使用 doca-setup/SKILL.md）；涉及硬件变更的跨领域元策略（转到 doca-hardware-safety/SKILL.md）；或大规模机群编排式配置（通过 doca-public-knowledge-map/SKILL.md 转到相应内容）。

此技能提供的内容

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

• 能力配套文件 — BF4 首日启动契约：三种操作系统安装方式（UEFI HTTP Boot、PXE Boot、Redfish Virtual Media）以及 Grace-Ubuntu 加 cloud-init 的 Virtual Media 路径；涵盖 BMC / NIC 固件 / SBIOS / ERoT 的 PLDM 固件更新范围；doca-version/SKILL.md 上的版本兼容性叠加层（安装和固件目标取自公开发行说明，绝不凭记忆填写）；启动错误分类（boot-source -> virtual-media-attach -> firmware-Task -> activation -> cloud-init -> boot-loop）；可观测性范围（OOB 控制台、Redfish Task 资源、Redfish FirmwareInventory、pldmtool GetFwParams，以及已安装版本检查 cat /etc/mlnx-release）；以及安全策略（doca-hardware-safety/SKILL.md 上的叠加层：每次 PLDM 烧录 / ISO 重刷 / 电源循环 / BMC 恢复出厂设置都是一项会修改硬件的操作；绝不打印真实密码；始终卸载虚拟介质以避免启动循环；任何 NVIDIA URL 都只能使用公开主机）。
• 任务配套文件 — 适用范围内启动操作的分步工作流：configure、build（路由存根）、modify（路由存根）、run（三种安装方式、PLDM 固件更新流程以及 Grace-Ubuntu cloud-init 路径，作为 ### 子锚点）、test（安装后 / 更新后的验证流程）、debug（分层启动诊断），以及将 BF3 / 应用启动 / 库 API / 环境准备 / 硬件元策略 / 机群问题转交给对应技能的 Deferred task verbs 区块。

此技能假定 BlueField-4 目标满足以下条件：

• BMC 可通过带外方式访问，且操作员拥有自行提供的 BMC 凭据（{bmc-user} / {bmc-password}）——此处绝不会编造凭据；
• bundle ISO（以及任何 Grace Ubuntu 镜像 / cloud-init 配置 ISO）从 NVIDIA 公开下载渠道下载，并托管在 {iso-uri}；
• 操作员已从公开的 BlueField/DOCA 发行说明中读取目标固件和操作系统版本。

此技能不涵盖在主机上安装 DOCA 工具——该流程请参阅 doca-setup/SKILL.md；也不涵盖 Grace 启动后运行工作负载——相关流程请参阅两个应用部署技能。

加载顺序

1. 首先阅读此技能，以确认用户的问题属于其适用范围（通过 BMC 进行 BF4 首日启动；不包括 BF3、应用启动、库 API 问题，也不包括硬件更改元策略本身）。
2. 有关启动契约（三种安装方式、Grace-Ubuntu cloud-init 路径、PLDM 固件更新范围、版本叠加层、启动错误分类、可观测性范围和 BF4 安全叠加层），请参阅能力配套文件。
3. 有关分步工作流——configure、build（路由存根）、modify（路由存根）、run（包含三种安装方式、PLDM 流程，以及作为 ### 子锚点的 Grace-Ubuntu cloud-init 路径）、test、debug，以及 Deferred task verbs 区块——请参阅任务配套文件。
4. 只要问题涉及会修改硬件的步骤（PLDM 固件烧录、ISO 重刷、电源循环、BMC 恢复出厂设置），请同时加载 doca-hardware-safety/SKILL.md。

相关技能

• doca-bf3-deployment/SKILL.md — BF3 RShim/BFB 首日部署。
• doca-hardware-safety/SKILL.md — PLDM、重刷、电源循环。
• doca-bare-metal-deployment/SKILL.md — Grace 启动后的启动流程。
• doca-container-deployment/SKILL.md — Grace 启动后的服务容器。
• doca-setup/SKILL.md — 已安装 Grace 操作系统上的环境准备。
• doca-version/SKILL.md — 四方版本匹配。
• doca-public-knowledge-map/SKILL.md — 公开文档和发行说明。