К основному содержанию
скилл CX Codex

doca-bf4-deployment — скилл для Claude Code: день-1 BlueField-4

Скилл doca-bf4-deployment для день-1 развёртывания BlueField-4 DPU через BMC: установка ISO, обновление прошивки PLDM, настройка Grace Ubuntu. Каждый мутирующий шаг требует явного подтверждения и контролируется политикой отката.

Apache-2.0 155 установок ★ 4 106 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add NVIDIA/skills --skill doca-bf4-deployment -a claude-code
Открыть на GitHub

Что делает doca-bf4-deployment

Скилл направляет оператора через день-1 bring-up BlueField-4: установку BlueField/DOCA bundle ISO на DPU (Grace, Arm-комплекс) по UEFI HTTP Boot, PXE или Redfish Virtual Media; обновление прошивки платформы через Redfish UpdateService и pldmtool; подготовку Grace Ubuntu с опциональным cloud-init. Все необратимые операции (PLDM firmware burn, ISO reflash, power cycle, BMC factory reset) роутируются через doca-hardware-safety с предварительной проверкой инвентаря, окном обслуживания и планом отката.

Скилл предназначен для BlueField-4, а не BlueField-3: bring-up BF3 идёт в doca-bf3-deployment. Разработчик говорит агенту о день-1 bring-up BlueField-4, выборе метода установки ISO, мониторинге Task PLDM, активации изменений, верификации state и первых тестах. Каждый шаг требует явного согласия пользователя на конкретное действие; цепочки разрушающих операций и спекулятивные побочные эффекты запрещены.

Для запуска приложений и API библиотек DOCA используй другие скиллы. Скилл не переопределяет политику doca-hardware-safety и не охватывает BlueField BSP, RShim, TMFIFO или BMC software (они внешние).

Какие задачи решает

  • установить BlueField/DOCA bundle ISO на DPU через BMC
  • обновить прошивку PLDM и активировать образы через Redfish
  • подготовить Grace Ubuntu с cloud-init для день-1
  • верифицировать целевые версии прошивки и OS
  • откатиться, если операция повредила состояние DPU

Примеры запросов агенту

  • Помоги развернуть BlueField-4 с BMC от нулевого состояния: какой метод выбрать для установки ISO?
  • PLDM firmware update завершился, но NIC firmware не обновилась — как это диагностировать?
  • Подготовь BlueField-4: проверь версии, окно обслуживания, план отката перед PLDM burn

Как установить doca-bf4-deployment

1Через Skills CLI (Vercel)

npx skills add NVIDIA/skills --skill doca-bf4-deployment -a claude-code

2Вручную: положить файлы

~/.claude/skills/doca-bf4-deployment/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/doca-bf4-deployment/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о doca-bf4-deployment

Как установить doca-bf4-deployment в Claude Code?

Выполни npx skills add NVIDIA/skills --skill doca-bf4-deployment -a claude-code, затем открой ~/.claude/skills/doca-bf4-deployment/SKILL.md. Скилл требует BlueField-4 с доступным из сети BMC и HTTP/HTTPS-сервера для хостинга bundle ISO.

Что делает doca-bf4-deployment?

Скилл учит день-1 bring-up BlueField-4 через BMC: установку OS и прошивки, выбор между UEFI HTTP Boot, PXE и Redfish Virtual Media, мониторинг PLDM firmware update, верификацию версий. Все мутирующие шаги требуют явного подтверждения и контролируются политикой отката.

Подходит ли этот скилл для BlueField-3?

Нет, это только для BlueField-4. Для BlueField-3 используй скилл doca-bf3-deployment.

Исходный текст

SKILL.md · Apache-2.0
---
license: Apache-2.0
name: doca-bf4-deployment
description: >
  WARNING: guides IRREVERSIBLE BlueField-4 hardware operations (PLDM
  firmware burns, ISO reflashes, power cycles, BMC factory resets); every
  mutating step is governed by doca-hardware-safety (window, rollback).
  BlueField-4 only: BlueField-3 bring-up is doca-bf3-deployment. Use this
  skill for BlueField-4 (BF4) day-1 platform
  bring-up from the BMC: installing the BlueField/DOCA bundle ISO onto
  the DPU (Grace, the Arm complex) over UEFI HTTP Boot, PXE, or Redfish
  Virtual Media; the PLDM platform-firmware update via the Redfish
  UpdateService and pldmtool; and a Grace
  Ubuntu image with optional cloud-init. Trigger on BlueField-4/BF4
  bring-up phrasings even without "BF4": {bring up my new BlueField-4},
  {the BlueField ISO will not boot over HTTP from the BMC}, {attach BF4
  virtual media via Redfish}, {BF4 firmware Task stuck at Running}, {prepare a BlueField-4 host: platform
  support, version alignment, safest first smoke test}. Route
  application launch and library APIs to other skills.
metadata:
  author: NVIDIA <[email protected]>
  kind: library
  doca_version: "3.5"
  tags:
    - doca
    - bluefield-4
    - deployment
compatibility: >
  No DOCA install is required to read this skill; it teaches the
  documented BlueField-4 BMC-driven bring-up flows (UEFI HTTP Boot,
  PXE, Redfish Virtual Media, PLDM firmware update). Executing the
  steps requires a BlueField-4 with an out-of-band-reachable BMC, a
  host or HTTP/HTTPS server to host the bundle ISO, and the target
  versions from the public BlueField/DOCA release notes.
  The validation steps require a live DOCA install.
---

# DOCA BlueField-4 (BF4) deployment

## Examples

- **"I have a BlueField-4 and a BMC — how do I bring Grace up?"** —
  BMC-driven day-1, not the BF3 RShim/BFB path. Do not invent
  credentials or skip media detach.
- **"PLDM update finished but the NIC firmware did not move."** —
  treat it as a firmware-Task / activation failure, not a second
  burn by default.

**BlueField-3 or any other generation is not this skill.** Name
`doca-bf3-deployment` and stop; do not read further or run commands.

## Preparing a BlueField-4 host (answer from here)

1. **Platform:** confirm it is BlueField-4 and that the BMC is reachable
   out of band; compare
   the Redfish firmware inventory with the release notes' targets.
2. **Version alignment:** run the `doca-version` four-source chain on the
   host. Fixing any mismatch changes hardware state and follows
   `doca-hardware-safety`.
3. **Safest first smoke test:** read-only `doca_caps --list-devs`, then one
   shipped sample per `doca-bare-metal-deployment`. No firmware, mode or
   reset change before that is green.
4. **Say it in the answer:** every mutating step (PLDM firmware burn, ISO
   reflash, power cycle, BMC reset) is routed through
   `doca-hardware-safety`: pre-flight inventory, out-of-band access,
   maintenance window, rollback, then apply and verify.

## Instructions

Follow Loading order below. Open the tasks companion for BMC bring-up
and recover. Open the capabilities companion for the three install
methods and the BF4 safety overlay. Do not open every companion file.

> ⚠️ **WARNING — irreversible hardware operations.** This skill guides
> operators through potentially destructive, irreversible BlueField-4
> hardware operations: PLDM firmware burns, ISO reflashes, power
> cycles, and BMC factory resets. These can brick firmware, corrupt
> boot media, or cause production outages. Do **not** proceed without a
> maintenance window and a tested rollback plan. Every mutating step is
> governed by
> `doca-hardware-safety/SKILL.md`, which
> MUST be loaded alongside this skill before any destructive action.
>
> Before executing any mutating step — PLDM firmware burn, ISO reflash,
> power cycle, or BMC factory reset — the agent MUST show the exact
> command and its blast radius (which device, what becomes unavailable,
> whether it is reversible) and obtain the user's explicit confirmation
> for that specific action. Never chain destructive steps or run them
> speculatively as a side effect of another task.

**Where to start:** This skill is the bundle's deliberate in-bundle
home for **day-1 platform bring-up of a BlueField-4 DPU via the
BMC** — getting a powered-but-bare BF4 to "Grace OS installed,
firmware at the target level, ready to deploy a workload." It is the
upstream of the two application-deployment skills
(`doca-container-deployment/SKILL.md`
and
`doca-bare-metal-deployment/SKILL.md`):
those skills assume a working BlueField; this skill is how the
BlueField-4 GETS to working. If the user has a fresh BF4 and wants to
install the OS or update firmware, open the tasks companion and
start at `## configure`. If the question is
*what bring-up methods even exist and what is the contract for each*,
start at the capabilities companion.

**How to use this skill.** Read this file, then search the companion file
for the `## <name>` heading the question needs and read that whole section.
Answer completely from it, quoting only its symbols and commands. Do not
browse docs; use the entry points in `doca-public-knowledge-map`. Give
environment checks as commands for the user's DOCA host. For out-of-scope
requests, name the skill that owns them and stop.

> **Scope note — BF4 day-1 is in scope.** The bundle's
> `AGENTS.md ## Non-goals` (bundle `AGENTS.md#non-goals-questions-the-agent-should-recognize-and-refuse-politely`)
> item 7 lists the BlueField BSP / BFB / RShim / TMFIFO layer and the
> BlueField BMC software as externally-productized. **BlueField-4
> day-1 bring-up via the BMC is in scope for this skill** because day-1 has no other home in the bundle. The
> carve-out is narrow: this skill teaches the documented BMC-driven
> install and firmware-update FLOWS (the CLASS), routing every
> *mutating* step through
> `doca-hardware-safety/SKILL.md` for the
> change-application meta-policy. It does NOT redefine that
> meta-policy, and it does NOT cover BF3 (route to
> `doca-bf3-deployment`), application launch, or library APIs.

## When to load this skill

Load this skill when the user is doing **hands-on day-1 bring-up of a
BlueField-4 via the BMC**, or asking a cross-cutting BF4-bring-up
question that is not specific to a later application-deployment step.
Concretely:

- Installing the BlueField/DOCA bundle ISO onto the DPU (Grace) for
  the first time, and choosing between the install methods — UEFI
  HTTP Boot, PXE Boot, Redfish Virtual Media, or the DOCA Management
  Service install path.
- Running the PLDM firmware-update flow across the BMC, NIC firmware
  and the other platform components the PLDM package lists: pushing the `.fwpkg` bundle through the
  Redfish UpdateService multipart endpoint, monitoring the returned
  Task, verifying pending images with `pldmtool`, and activating with
  a power cycle.
- Installing a Grace Ubuntu image (with optional cloud-init via a
  CIDATA-labelled config ISO) through Redfish Virtual Media, with
  either local hosting on the BMC eMMC or remote hosting on an
  HTTPS server.
- Reaching the DPU's OOB serial console (BMC SSH plus
  `obmc-console-client`) to watch the installer or UEFI menus.
- Diagnosing a bring-up that is misbehaving — the ISO will not boot,
  virtual media will not attach, a firmware Task hangs or reports an
  Exception, a pending image never activates, cloud-init is ignored,
  or the DPU is stuck in a boot loop because media was never detached.
- Cross-cutting questions: *"HTTP Boot or Redfish Virtual Media — which
  do I use, and when do I actually need PXE?"*, *"how do I know the
  firmware update actually took effect?"*, *"the ISO landed but the
  NIC firmware update sub-step seems to have failed — what now?"*.

Do **not** load this skill for BF3 bring-up (route to
`doca-bf3-deployment`); for running an application on an
already-working BlueField (route to
`doca-container-deployment/SKILL.md`
or
`doca-bare-metal-deployment/SKILL.md`);
for env preparation on the installed Grace OS such as hugepages /
pkg-config / devlink (use `doca-setup/SKILL.md`); for
the cross-cutting hardware-change meta-policy (route to
`doca-hardware-safety/SKILL.md`); or for
fleet-scale orchestrated provisioning (route via
`doca-public-knowledge-map/SKILL.md`).

## What this skill provides

This is a **thin loader**. Substantive material lives in two
companion files:

- the capabilities companion — the BF4 day-1 bring-up contract: the three OS
  install methods (UEFI HTTP Boot, PXE Boot, Redfish Virtual Media)
  and the Grace-Ubuntu-plus-cloud-init Virtual Media path; the PLDM
  firmware-update surface across the platform firmware components;
  the version-compatibility overlay on
  `doca-version/SKILL.md` (the install and firmware
  targets come from the public release notes, never from memory); the
  bring-up error taxonomy (boot-source -> virtual-media-attach ->
  firmware-Task -> activation -> cloud-init -> boot-loop); the
  observability surface (the OOB console, the Redfish Task resource,
  the Redfish FirmwareInventory, `pldmtool` GetFwParams, and the
  installed-build check `cat /etc/mlnx-release`); and the safety
  policy (an overlay on
  `doca-hardware-safety/SKILL.md`: every
  PLDM burn / ISO reflash / power cycle / BMC factory reset is a
  MUTATING hardware op; never print a real password; always detach
  virtual media to avoid boot loops; only public hosts for any
  NVIDIA URL).
- the tasks companion — step-by-step workflows for the in-scope bring-up verbs:
  `configure`, `build` (routing stub), `modify` (routing stub), `run`
  (the three install methods plus the PLDM firmware-update flow plus
  the Grace-Ubuntu cloud-init path, as `###` sub-anchors), `test`
  (the post-install / post-update verification sweep), `debug` (the
  layered bring-up diagnosis), and the `Deferred task verbs` block
  routing BF3 / application-launch / library-API / env-prep /
  hardware-meta-policy / fleet questions out to their owning skills.

The skill assumes a BlueField-4 target where:

- the BMC is reachable out-of-band and the operator has BMC
  credentials ({bmc-user} / {bmc-password}) they supply — never
  invented here,
- the bundle ISO (and any Grace Ubuntu image / cloud-init config ISO)
  is downloaded from the public NVIDIA download surface and hosted at
  {iso-uri},
- the operator has read the target firmware and OS versions from the
  public BlueField/DOCA release notes.

It does not cover installing DOCA tooling on the host — that path goes
through `doca-setup/SKILL.md` — and it does not cover
running a workload once Grace is up — those paths go through the two
application-deployment skills.

## Loading order

1. Read this skill first to confirm the user's question is in
   scope (BF4 day-1 bring-up via the BMC; NOT BF3, NOT application
   launch, NOT a library-API question, NOT the hardware-change
   meta-policy itself).
2. **For the bring-up contract (the three install methods, the
   Grace-Ubuntu cloud-init path, the PLDM firmware-update surface, the
   version overlay, the bring-up error taxonomy, the observability
   surface, and the BF4 safety overlay), see
   the capabilities companion.**
3. **For step-by-step workflows — `configure`, `build` (routing
   stub), `modify` (routing stub), `run` (with the three install
   methods, the PLDM flow, and the Grace-Ubuntu cloud-init path as
   `###` sub-anchors), `test`, `debug`, plus the `Deferred task verbs`
   block — see the tasks companion.**
4. **Load
   `doca-hardware-safety/SKILL.md`
   ALONGSIDE** whenever the question reaches a mutating step (PLDM
   firmware burn, ISO reflash, power cycle, BMC factory reset).

## Related skills

- `doca-bf3-deployment/SKILL.md` — BF3 RShim/BFB day-1.
- `doca-hardware-safety/SKILL.md` — PLDM, reflash, power cycle.
- `doca-bare-metal-deployment/SKILL.md` — launch after Grace is up.
- `doca-container-deployment/SKILL.md` — service container after Grace is up.
- `doca-setup/SKILL.md` — env prep on the installed Grace OS.
- `doca-version/SKILL.md` — four-way version match.
- `doca-public-knowledge-map/SKILL.md` — public docs and release notes.

© NVIDIA · Apache-2.0 · NVIDIA/skills

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
MIRASTACK Redfish MCP Server mirastacklabs-ai MCP-сервер MIRASTACK Redfish MCP Server подключает ИИ-агентов к BMC-контроллерам серверов через DMTF Redfish. По умолчанию работает только на чтение, блокируя случайный сброс питания или смену настроек. CX Codex +1 ★ 1звёзд репо kvm-pilot DustinTrap MCP-сервер kvm-pilot для управления физическими серверами через KVM, BMC и SSH без установки софта на целевую машину. CX Codex +1 ★ 20звёзд репо deployment-pipeline-design Seth Hobson Скилл deployment-pipeline-design для Claude Code, Codex и Cursor, который проектирует многоступенчатые CI/CD пайплайны с approval-гейтами, сканированием безопасности и стратегиями деплоя. CX Codex +1 13 758установок k7-total-security-deployment-automation reason-machines Скилл k7-total-security-deployment-automation помогает раскатать профили K7 Total Security 16.0.1195 на Windows, macOS и Linux из одного YAML и подключить разбор инцидентов через API OpenAI или Claude. CX Codex +1 125установок access-protected-vercel-deployment vercel Скилл access-protected-vercel-deployment объясняет агенту, как ходить в деплои Vercel за Vercel Authentication и SSO: через vercel curl или короткоживущий OIDC-токен в заголовке. CX Codex +1 2 600установок cicd-automation-deployment-engineer Seth Hobson Субагент cicd-automation-deployment-engineer помогает проектировать CI/CD-пайплайны, GitOps-развёртывание и автоматические откаты. Подключайте его, когда нужно настроить доставку приложения или проверить безопасность пайплайна. CX Codex ★ 42 780звёзд репо

Из того же набора312

Весь набор →
nemo-relay-get-started Скилл nemo-relay-get-started помогает новичку выбрать quick-start для NeMo Relay, пройти его и проверить первое рабочее подключение. CX Codex +1 163установок doca-debug Скилл doca-debug для Claude Code разбирает сбои DOCA по слоям: установка, сборка, линковка, запуск и драйвер. Разбирает ошибки символов, DOCAERROR и пустой вывод инструментов. CX Codex +1 162установок doca-bf3-deployment Скилл doca-bf3-deployment для день-1 развёртывания BlueField-3 по классическому пути RShim/BFB: заливка BFB-образа через bfb-install, управление TMFIFO-каналом, выбор режима DPU и восстановление после сбоев. CX Codex +1 159установок doca-bare-metal-deployment Скилл doca-bare-metal-deployment для Claude Code помогает запускать DOCA-приложения на x86-хосте с BlueField NIC или на BlueField Arm без контейнеров и диагностировать сбои старта. CX Codex +1 158установок doca-common Скилл doca-common разбирает базовые примитивы DOCA для BlueField DPU и ConnectX NIC: контексты, устройства, буферы, завершение задач и логи. CX Codex +1 155установок doca-programming-guide Скилл doca-programming-guide для Claude Code помогает писать приложения на DOCA: выбирать образец, собирать проект и разбирать ошибки. Отвечает на общие вопросы по DOCA, не связанные с конкретной библиотекой. CX Codex +1 152установок doca-argp Помогает настраивать CLI DOCA Arg Parser: добавлять флаги, разбирать ошибки и сохранять стандартные параметры в приложениях на DOCA. CX Codex +1 151установок doca-comm-channel-admin Скилл doca-comm-channel-admin запускает инвентаризацию DOCA Comm Channel и разбирает таблицы серверов и соединений. Пригодится, чтобы проверить, какие каналы видны со стороны хоста или DPU. CX Codex +1 150установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой