doca-bf3-deployment

DOCA BlueField-3（BF3）のデプロイ

例

• 「BlueField-3 と BFB があります。どうやって書き込めばよいですか？」 — ホストから RShim と bfb-install を使用します。終了コード 0 でも、DPU の準備が整うまでは成功ではありません。
• 「bfb-install は終了コード 0 で終了しましたが、DPU が戻ってきませんでした。」 — もう一度書き込むのではなく、6 状態の分類から始めてください。

手順

以下の読み込み順に従ってください。BFB の書き込みと復旧については、タスク用コンパニオンを開いてください。RShim/BFB の契約と安全性に関するオーバーレイについては、機能用コンパニオンを開いてください。すべてのコンパニオンファイルを開く必要はありません。

最初に確認する場所： このスキルは、BlueField-3 の初日のプラットフォーム立ち上げに関するバンドル内の起点です。つまり、BF3 を「スロットに挿した通電中のカード」（または BFB の書き込み後に故障して戻ってきたカード）の状態から、「Arm OS が正常、TMFIFO が稼働、ホスト PF がバインド済み、4 者間のバージョン一致を確認済み、ワークロードを実行する準備完了」の状態にするためのものです。現在 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 に従います。このポリシーは、エージェントがこのスキルと併せて読み込みます。このスキルが追加するのは、その上に重ねるBF3 固有の運用順序のみです。メタポリシーが定める、事前確認、帯域外コンソール、メンテナンス時間、ロールバックに関する規律を再定義するものではありません。

対象読者

このスキルは、実機の BlueField-3 を立ち上げる外部の DOCA オペレーター、すなわち、すでに以下を用意している人を対象とします。

• ホストに搭載された物理的な BlueField-3（またはコンソール／管理ネットワーク経由でアクセス可能な単体の BF3）、
• DPU へのホスト側 RShim アクセス（RShim ユーザー空間デーモンと、PCIe または USB RShim インターフェイス経由で利用できる /dev/rshim* キャラクターデバイスツリー）、および
• ホストにインストールされた対応する DOCA-Host と、公開 DOCA Downloads ページからダウンロードした BlueField バンドル（BFB）イメージ。

以下は対象外です。

• BlueField-4 の立ち上げ（BMC-Redfish プロビジョニング経路）。このスキルの BF4 相当である doca-bf4-deployment/SKILL.md を参照してください。
• mlx5_* または BFB イメージ自体に貢献するカーネルドライバーや BlueField-OS の開発者（これは社内ツリーの作業であり、フィールドでのデプロイではありません）。
• BF3 がすでに正常で、バイナリを実行することだけを希望するオペレーター（ doca-bare-metal-deployment/SKILL.md を参照）、 またはサービスコンテナーをデプロイすることだけを希望するオペレーター（ doca-container-deployment/SKILL.md を参照）。
• ハードウェアも DOCA のインストールもない、まったく新規のユーザー。 doca-setup ## no-install を参照してください。

このスキルでは、公開版の BlueField Platform Software Manual、公開版の DOCA Installation Guide、MFT manual に記載されたコマンドを、以下を通じて引用するためのルールと、BF3 の立ち上げ手順をエージェントに教えます。 doca-public-knowledge-map/SKILL.md また、記憶だけを頼りに 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/SKILL.md を使用してください。
• BFB のプッシュ後に BF3 が復帰しなかった場合に復旧する場合： bfb-install は 0 で終了したものの、DPU が仕様に記載された DPU is ready のマーカーに到達しなかった、ping 192.168.100.2 は成功するが SSH が拒否される、ホスト PF が lspci -d 15b3: に表示されるものの、そのネットデバイスが消失している場合。
• BF3 のインストールを検証する場合（Arm 側で cat /etc/mlnx-release を実行し、 doca-version/SKILL.md に従って 4 つのバージョンが一致することを確認する）、またホスト側の DOCA インストールと BlueField-Arm 側の DOCA インストールを区別する場合。
• 横断的な質問：「DOCA はホスト側と Arm 側のどちらにありますか。どちらをインストールすればよいですか？」「先週まで問題なかった BF3 が、BFB のプッシュ後に復帰しません。どこから確認すればよいですか？」「DPU を複数搭載したホストで、どの /dev/rshim<N> がどの BlueField に対応するか、どうすればわかりますか？」など。

BlueField-4 の立ち上げでは、このスキルを読み込まないでください（BF4 に相当する doca-bf4-deployment/SKILL.md を使用してください）。正常な BF3 上で DOCA にリンクされたバイナリを実行する場合は、doca-bare-metal-deployment/SKILL.md を使用してください。DOCA サービスのコンテナをデプロイする場合は、 doca-container-deployment/SKILL.md を使用してください。巨大ページ、IOMMU、pkg-config、devlink モードの切り替えを含む環境準備には、doca-setup/SKILL.md を使用してください。バージョン一致ルールの詳細には、doca-version/SKILL.md を使用してください。また、ハードウェア状態を変更する書き込み処理そのものには、このスキルを使用しないでください。変更を適用する際の手順を定めるメタポリシーは doca-hardware-safety/SKILL.md が管轄しており、このスキルと併せて読み込む必要があります。

このスキルで提供する内容

これは薄いローダーです。実質的な内容は、次の2つの関連ファイルに記載されています。

• capabilities 関連ファイル — BF3 プラットフォームの立ち上げに関する仕様です。RShim/BFB のトランスポート面（ユーザー空間の RShim デーモン、/dev/rshim* ツリー、RShim 経由のコンソール、入力単位としての BFB イメージ）、TMFIFO 管理チャネル面（tmfifo_net0／tm-br、文書化されている 192.168.100.x の規約、ping の前に ip route get を実行するループバックの落とし穴）、DPU モード面（DPU／組み込み機能モードと、分離ホスト／NIC モード。BFB のインストール時に mlxconfig で設定します。これは変更を伴う書き込みであり、doca-hardware-safety/SKILL.md に案内します）、ホスト側と Arm 側の DOCA インストールの違い、doca-version/SKILL.md が管理する4者の整合性に対する BF3 バージョンのオーバーレイ、横断的なエラー分類、可観測性の範囲、安全ポリシー（doca-hardware-safety/SKILL.md に対するオーバーレイ）。
• tasks 関連ファイル — 対象範囲内の BF3 ライフサイクル動詞に関する、手順ごとのワークフローです。configure、build（ルーティング用スタブ）、modify、run（BFB のインストールと RShim／TMFIFO の立ち上げ手順）、test（BFB 後の準備完了確認スモークテスト）、debug（6状態の bluefield-state-classifier）、およびアプリケーション起動／コンテナー／インストール／ライブラリ API／ハードウェア状態変更／BF4 に関する質問を、それぞれの担当スキルに案内する Deferred task verbs ブロック。

このスキルは、次の条件を満たす対象を想定しています。

• BlueField-3 が物理的に存在して電源が入り、RShim デーモンと /dev/rshim* ツリーを利用できるホストからアクセス可能であること。
• オペレーターが、DOCA の公開ダウンロードページから BFB イメージをダウンロード済みであること（doca-public-knowledge-map/SKILL.md を参照）。
• プッシュによって Arm OS が起動しなくなった場合に BF3 にアクセスできる、帯域外の接続経路（BMC コンソール、シリアル・オーバー・LAN、または物理 UART）がオペレーターにあること。

ホストへの 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（6状態の bluefield-state-classifier）、および Deferred task verbs ブロック）については、tasks 関連ファイルを参照してください。

このスキルが的確に答えられる質問の例

このスキルが意図的に提供しない内容

関連スキル