doca-bf4-deployment

DOCA BlueField-4（BF4）のデプロイ

例

• 「BlueField-4 と BMC があります。Grace を起動するにはどうすればよいですか？」 — BMC を使用する day-1 の手順であり、BF3 の RShim/BFB の手順ではありません。認証情報を捏造したり、メディアの取り外しを省略したりしないでください。
• 「PLDM の更新は完了しましたが、NIC ファームウェアが変わりません。」 — デフォルトでは、2 回目の書き込みではなく、ファームウェアタスクまたはアクティベーションの失敗として扱ってください。

BlueField-3 やその他の世代は、このスキルの対象ではありません。 doca-bf3-deployment の名前を伝えて、そこで終了してください。それ以上読み進めたり、コマンドを実行したりしないでください。

BlueField-4 ホストの準備（ここから回答してください）

1. プラットフォーム： BlueField-4 であること、および BMC に帯域外で接続できることを確認します。Redfish のファームウェアインベントリーと、リリースノートに記載された対象バージョンを比較します。
2. バージョンの整合： ホストで doca-version の 4 つのソースを確認する手順を実行します。不一致の修正はハードウェアの状態を変更するため、doca-hardware-safety に従ってください。
3. 最も安全な初回スモークテスト： 読み取り専用の doca_caps --list-devs を実行してから、doca-bare-metal-deployment に従って付属サンプルを 1 つ実行します。すべて問題ないことが確認できるまでは、ファームウェア、モード、リセットを変更しないでください。
4. 回答で明記すること： 変更を伴うすべての手順（PLDM ファームウェアの書き込み、ISO の再フラッシュ、電源の再投入、BMC のリセット）は、doca-hardware-safety に従って実施します。事前インベントリーの確認、帯域外アクセス、メンテナンスウィンドウ、ロールバックを行ってから適用し、検証してください。

手順

以下の読み込み順に従ってください。BMC の起動と復旧についてはタスク用コンパニオンを開いてください。3 つのインストール方法と BF4 の安全性オーバーレイについては、機能用コンパニオンを開いてください。すべてのコンパニオンファイルを開く必要はありません。

⚠️ 警告 — 取り消し不能なハードウェア操作です。 このスキルでは、PLDM ファームウェアの書き込み、ISO の再フラッシュ、電源の再投入、BMC の工場出荷時設定へのリセットなど、破壊的で取り消し不能な可能性のある BlueField-4 ハードウェア操作をオペレーター向けに案内します。これらの操作により、ファームウェアが起動不能になったり、ブートメディアが破損したり、本番環境が停止したりする可能性があります。メンテナンス時間を確保し、テスト済みのロールバック計画を用意するまでは、作業を進めないでください。変更を伴うすべての手順は doca-hardware-safety/SKILL.md に従います。破壊的な操作を行う前に、このスキルと併せて必ず読み込んでください。

PLDM ファームウェアの書き込み、ISO の再フラッシュ、電源の再投入、BMC の工場出荷時設定へのリセットなど、変更を伴う操作を実行する前に、エージェントは必ず正確なコマンドとその影響範囲（対象デバイス、使用できなくなるもの、取り消し可能かどうか）を提示し、その特定の操作についてユーザーから明示的な確認を得る必要があります。破壊的な操作を連続して実行したり、別のタスクの副作用として推測で実行したりしないでください。

まず確認する場所： このスキルは、バンドル内で意図的に用意された、BMC 経由で BlueField-4 DPU を初日に立ち上げるための場所です。「電源は入っているが何も搭載されていない BF4」を、「Grace OS がインストールされ、ファームウェアが目標レベルにあり、ワークロードをデプロイできる」状態にします。このスキルは、2 つのアプリケーションデプロイ用スキル（doca-container-deployment/SKILL.md と doca-bare-metal-deployment/SKILL.md）に先行します。これらのスキルは稼働中の BlueField があることを前提とします。このスキルでは、BlueField-4 を稼働状態にする方法を説明します。ユーザーが新しい BF4 に OS をインストールしたい場合、またはファームウェアを更新したい場合は、タスク用コンパニオンを開き、## configure から始めてください。質問が「どのような立ち上げ方法があり、それぞれの前提条件は何か」であれば、機能用コンパニオンから始めてください。

このスキルの使い方。 このファイルを読んでから、質問に必要な ## <name> 見出しをコンパニオンファイル内で検索し、そのセクション全体を読んでください。回答はその内容に基づいて完全に説明し、記号とコマンドのみを引用してください。ドキュメントを閲覧せず、doca-public-knowledge-map のエントリーポイントを使用してください。環境の確認方法は、ユーザーの DOCA ホストで実行するコマンドとして提示してください。対象範囲外のリクエストについては、担当するスキルを示して対応を終了してください。

対象範囲に関する注記 — 指示により BF4 の初日立ち上げは対象範囲に含まれます。 バンドルの 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 初日立ち上げは、指示によりこのスキルの対象範囲に含まれます。この例外の範囲は限定されています。このスキルでは、文書化された BMC 駆動のインストールおよびファームウェア更新の**フロー（クラス）**について説明し、変更を伴うすべての手順は、変更適用のメタポリシーに従って doca-hardware-safety/SKILL.md を通じて行います。このスキルがそのメタポリシーを再定義することはなく、BF3（doca-bf3-deployment に案内してください）、アプリケーションの起動、ライブラリ API も対象外です。

このスキルを読み込むタイミング

ユーザーがBMC 経由で BlueField-4 を実機で初回起動・セットアップする作業を行っている場合、または後続のアプリケーションデプロイ手順に特化していない、BF4 の初回起動・セットアップに関する横断的な質問をしている場合に、このスキルを読み込みます。具体的には、以下の場合です。

• DPU（Grace）に BlueField／DOCA バンドル ISO を初めてインストールする場合、および文書化されている 3 つのインストール方法（推奨の UEFI HTTP Boot、PXE Boot、Redfish Virtual Media）から選択する場合。
• BMC／NIC ファームウェア／SBIOS／ERoT コンポーネントに対して PLDM ファームウェア更新フローを実行する場合。Redfish UpdateService のマルチパートエンドポイントを使って .fwpkg バンドルを送信し、返された Task を監視し、pldmtool で保留中のイメージを確認して、電源サイクルで有効化します。
• Redfish Virtual Media を通じて Grace Ubuntu イメージをインストールする場合（オプションで CIDATA ラベル付きの設定 ISO を使って cloud-init を利用できます）。BMC eMMC でローカルホストする方法、または HTTPS サーバーでリモートホストする方法があります。
• DPU の OOB シリアルコンソールに接続し、インストーラーや UEFI メニューを確認する場合（BMC SSH と obmc-console-client を使用）。
• 初回起動・セットアップに問題がある場合の診断。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 を経由して案内してください）も同様です。

このスキルで提供される内容

これは薄いローダーです。実質的な情報は、次の2つの関連ファイルにあります。

• capabilities companion — BF4 の初日セットアップ契約。3つの OS インストール方法（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 には公開ホストのみを使用してください）。
• tasks companion — 対象範囲内のセットアップ動詞を扱う、手順ごとのワークフローです。configure、build（ルーティング用スタブ）、modify（ルーティング用スタブ）、run（3つのインストール方法、PLDM ファームウェア更新フロー、Grace-Ubuntu cloud-init の手順を ### サブアンカーとして記載）、test（インストール後／更新後の検証一式）、debug（段階別のセットアップ診断）、および BF3／アプリケーション起動／ライブラリ API／環境準備／ハードウェアメタポリシー／フリートに関する質問を担当スキルに振り分ける Deferred task verbs ブロックが含まれます。

このスキルでは、次の条件を満たす BlueField-4 ターゲットを想定します。

• BMC に帯域外で接続でき、オペレーターが BMC の認証情報（{bmc-user}／{bmc-password}）を提供します。ここで捏造してはいけません。
• バンドル ISO（および Grace Ubuntu イメージ／cloud-init 設定 ISO）は NVIDIA の公開ダウンロードサイトからダウンロードし、{iso-uri} でホストします。
• オペレーターは、公開されている BlueField／DOCA リリースノートから、ターゲットのファームウェアと OS のバージョンを確認済みです。

ホストへの DOCA ツールのインストールは対象外です。この手順については doca-setup/SKILL.md を参照してください。また、Grace の起動後にワークロードを実行する手順も対象外です。これらの手順については、2つのアプリケーションデプロイ用スキルを参照してください。

読み込み順序

1. まずこのスキルを読み、ユーザーの質問が対象範囲内（BMC 経由の BF4 初日セットアップ。BF3 ではない、アプリケーション起動ではない、ライブラリ API に関する質問ではない、ハードウェア変更のメタポリシーそのものではない）であることを確認します。
2. セットアップ契約（3つのインストール方法、Grace-Ubuntu cloud-init の手順、PLDM ファームウェア更新の範囲、バージョンオーバーレイ、セットアップ時のエラー分類、可観測性の範囲、BF4 の安全性オーバーレイ）については、capabilities companion を参照してください。
3. 手順ごとのワークフロー（configure、build（ルーティング用スタブ）、modify（ルーティング用スタブ）、run（3つのインストール方法、PLDM フロー、Grace-Ubuntu cloud-init の手順を ### サブアンカーとして記載）、test、debug、および Deferred task verbs ブロック）については、tasks companion を参照してください。
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 OS の環境準備。
• doca-version/SKILL.md — 4種類のバージョンの照合。
• doca-public-knowledge-map/SKILL.md — 公開ドキュメントとリリースノート。