第11章 DPU Operator

手順

1. デプロイメントモードに基づき、DpuOperatorConfig カスタムリソース (CR) を作成します。

   • デュアルクラスターデプロイメント: ホスト OpenShift Container Platform クラスターと、各 Red Hat build of MicroShift (MicroShift) DPU クラスターの両方に、DpuOperatorConfig CR を作成する必要があります。

   • シングルクラスターデプロイメント: このデプロイメントでは、標準の OpenShift Container Platform クラスターを使用します。このクラスターでは、DpuOperatorConfig CR を 1 回だけ作成する必要があります。

     CR の内容はすべてのクラスターで同じです。

2. 次の YAML を使用して、dpu-operator-config.yaml という名前のファイルを作成します。

   apiVersion: config.openshift.io/v1
   kind: DpuOperatorConfig
   metadata:
    name: dpu-operator-config
   spec:
    logLevel: 0

   Copy to Clipboard Toggle word wrap
   • metadata.name: カスタムリソースの名前を指定します。これは dpu-operator-config である必要があります。
   • spec.logLevel: Operator コンテナーログに任意のログ詳細レベルを設定します。値のデフォルト設定は 0 です。

3. 次のコマンドを実行して、リソースを作成します。

   $ oc apply -f dpu-operator-config.yaml

   Copy to Clipboard Toggle word wrap

4. DPU が接続されている、あるいは DPU として機能している、そのいずれかに該当するすべてのノードにラベルを付けます。次のコマンドを実行してこのラベルを適用できます。

   $ oc label node <node_name> dpu=true

   Copy to Clipboard Toggle word wrap

   ここでは、以下のようになります。

   node_name

   ノードの名前を参照します (例: worker-1)。

   注記

   DPU と互換性のあるクラスターは、次の 2 つの方法でデプロイできます。

   • デュアルクラスターデプロイメント: ホスト上で実行される OpenShift Container Platform と、DPU 上で実行される Red Hat build of MicroShift (MicroShift) で構成されます。このモードでは、Red Hat build of MicroShift (MicroShift) インスタンスも DPU Operator をデプロイする必要があり、ノードに dpu=true のラベルを設定する必要があります。
   • シングルクラスターデプロイメント: DPU がメインクラスターに統合されているホスト上で実行される OpenShift Container Platform のみで構成されます。DPU では、DPU がインストールされているホストノードと DPU ノード自体の両方に dpu=true のラベルが必要です。DPU Operator は、ノードが DPU として実行されているか、DPU が割り当てられたホストとして実行されているかを自動的に検出します。

手順

1. 次の YAML を使用して、ホスト側のワーカーノードで実行するように設計されたサンプルワークロードを作成します。ファイルを workload-host.yaml として保存します。

   apiVersion: v1
   kind: Pod
   metadata:
     name: my-pod
     namespace: default
     annotations:
       k8s.v1.cni.cncf.io/networks: default-sriov-net
   spec:
     nodeSelector:
       kubernetes.io/hostname: worker-237
     containers:
     - name: appcntr1
       image: registry.access.redhat.com/ubi9/ubi:latest
       command: ['/bin/sh', '-c', 'sleep infinity']
       imagePullPolicy: Always
       securityContext:
         priviledged: true
         runAsNonRoot: false
         runAsUser: 0
         seccompProfile:
           type: RuntimeDefault
       resources:
         requests:
           openshift.io/dpu: '1'
         limits:
           openshift.io/dpu: '1'

   Copy to Clipboard Toggle word wrap

   spec.nodeSelector: ノードセレクターは、DPU リソースを持つノード上の Pod をスケジュールします。kubernetes.io/hostname などの標準の Kubernetes セレクターを使用して、サンプル YAML に示すように、特定のノードをターゲットにすることができます。

   注記

   柔軟なスケジューリングのために、DPU Operator はラベル dpu.config.openshift.io/dpuside: "dpu-host" を作成します。このラベルにより、デフォルトのスケジューラーは、DPU を同さいした任意のホストにワークロードを配置できます。ワークロードは自動的にその DPU セカンダリーネットワークに参加します。ノードのラベルが dpu.config.openshift.io/dpuside: "dpu" の場合、そのノードが DPU であることを示しています。DPU Operator は、dpu.config.openshift.io/dpuside ラベルの作成と管理を行います。

2. 次のコマンドを実行して、ワークロードを作成します。

   $ oc apply -f workload-host.yaml

   Copy to Clipboard Toggle word wrap

手順

1. 次のサンプル YAML ファイルを dpu-pod.yaml として保存します。これは、Kubernetes のデフォルトスケジューラーによって DPU ノードに直接スケジュールされる単純な Pod の例です。

   apiVersion: v1
   kind: Pod
   metadata:
     name: "my-network-function"
     namespace: openshift-dpu-operator
     annotations:
       k8s.v1.cni.cncf.io/networks: dpunfcni-conf, dpunfcni-conf
   spec:
     nodeSelector:
       dpu.config.openshift.io/dpuside: "dpu"
     containers:
       - name: "my-network-function"
         image: "quay.io/example-org/my-network-function:latest"
         resources:
           requests:
             openshift.io/dpu: "2"
           limits:
             openshift.io/dpu: "2"
         securityContext:
           privileged: true
           capabilities:
             drop:
               - ALL
             add:
               - NET_RAW
               - NET_ADMIN

   Copy to Clipboard Toggle word wrap
   • metadata.name.annotations.k8s.v1.cni.cncf.io/networks: dpunfcni-conf の値は、NetworkAttachmentDefinition リソースの名前を指定します。DPU Operator は、インストール中にこのリソースを作成して、DPU ネットワーキングを設定します。
   • spec.nodeSelector: nodeSelector は、このワークロードをスケジュールするためのプライマリーメカニズムです。DPU Operator は、dpu.config.openshift.io/dpuside: "dpu" ラベルを作成して管理します。このラベルにより、Pod は確実に DPU の処理ユニットに直接スケジュールされます。
   • spec.containers.name: コンテナーの名前。
   • spec.containers.image: プルして実行するコンテナーイメージ。

2. 以下のコマンドを実行して Pod を作成します。

   $ oc apply -f dpu-pod.yaml

   Copy to Clipboard Toggle word wrap

3. 次のコマンドを実行して Pod のステータスを確認します。

   $ oc get pods -n openshift-dpu-operator

   Copy to Clipboard Toggle word wrap

   Pod のステータスが Running であることを確認します。

手順

1. 次のコマンドを実行して、ノードの全体的な健全性を確認します。

   $ oc get nodes

   Copy to Clipboard Toggle word wrap

   出力例では、クラスター内のすべてのノードとそのステータスのリストが提供されます。すべてのノードが Ready 状態であることを確認してから続行してください。

   NAME                           STATUS   ROLES    AGE    VERSION
   ocpcluster-master-1            Ready    master   10d    v1.32.9
   ocpcluster-master-2            Ready    master   10d    v1.32.9
   ocpcluster-master-3            Ready    master   10d    v1.32.9
   ocpcluster-dpu-ipu-219         Ready    worker   42h    v1.32.9
   ocpcluster-dpu-marvell-41      Ready    worker   3d23h  v1.32.9
   ocpcluster-dpu-ptl-243         Ready    worker   3d23h  v1.32.9
   worker-host-ipu-219            Ready    worker   3d19h  v1.32.9
   worker-host-marvell-41         Ready    worker   4d     v1.32.9
   worker-host-ptl-243            Ready    worker   3d23h  v1.32.9

   Copy to Clipboard Toggle word wrap

   この出力には、3 つのマスターノードと、worker-host の接頭辞 (例: worker-host-ipu-219) で識別される 3 つのワーカーノードが表示されます。各ワーカーノードには、ocpcluster-dpu の接頭辞で識別される DPU (例: ocpcluster-dpu-ipu-219) が含まれます。

2. 次のコマンドを実行して、DPU のステータスを報告します。

   $ oc get dpu

   Copy to Clipboard Toggle word wrap

   出力例では、検出された DPU のリストが提供されます。

   NAME                                 DPU PRODUCT                    DPU SIDE        MODE NAME               STATUS
   030001163eec00ff-host                Intel Netsec Accelerator       false           worker-host-ptl-243     True
   d4-e5-c9-00-ec-3v-dpu                Intel Netsec Accelerator       true            worker-dpu-ptl-243      True
   intel-ipu-0000-06-00.0-host          Intel IPU E2100                false           worker-host-ipu-219     False
   intel-ipu-dpu                        Intel IPU E2100                true            worker-dpu-ipu-219      False
   marvell-dpu-0000-87-00.0-host        Marvell DPU                    false           worker-host-marvell-41  True
   marvell-dpu-ipu                      Marvell DPU                    true            worker-dpu-marvell-41   True

   Copy to Clipboard Toggle word wrap
   • DPU PRODUCT: DPU のベンダーまたはタイプ (Intel や Marvell など) が表示されます。
   • DPU SIDE: DPU がホスト側 (false) と DPU 側 (true) のどちらで動作しているか示します。物理 DPU はそれぞれ 2 回表示されます。
   • MODE NAME: DPU が配置されているノードの名前。これは、false エントリーの場合はホストワーカーノード、true エントリーの場合は DPU ノードです。

   • STATUS: DPU が正しく機能しているか (True)、問題があるか (False) を示します。

     注記

     ステータスの詳細を取得するには、oc get dpu -o yaml を実行します。

手順

1. 次のコマンドを実行して作成された DpuOperatorConfig CR を削除します。

   $ oc delete DpuOperatorConfig dpu-operator-config

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを実行して、DPU Operator のインストールに使用されたサブスクリプションを削除します。

   $ oc delete Subscription openshift-dpu-operator-subscription -n openshift-dpu-operator

   Copy to Clipboard Toggle word wrap

3. 次のコマンドを実行して、作成された OperatorGroup リソースを削除します。

   $ oc delete OperatorGroup dpu-operators -n openshift-dpu-operator

   Copy to Clipboard Toggle word wrap

4. 次のように DPU Operator をアンインストールします。

   1. 次のコマンドを実行して、インストールされている Operator を確認します。

      $ oc get csv -n openshift-dpu-operator

      Copy to Clipboard Toggle word wrap

      出力例

      NAME                                DISPLAY        VERSION               REPLACES   PHASE
      dpu-operator.v4.20.0-202503130333   DPU Operator   4.20.0-202503130333              Failed

      Copy to Clipboard Toggle word wrap

   2. 次のコマンドを実行して DPU Operator を削除します。

      $ oc delete csv dpu-operator.v4.20.0-202503130333 -n openshift-dpu-operator

      Copy to Clipboard Toggle word wrap

5. 次のコマンドを実行して、DPU Operator 用に作成された namespace を削除します。

   $ oc delete namespace openshift-dpu-operator

   Copy to Clipboard Toggle word wrap

検証

1. 次のコマンドを実行して、DPU Operator がアンインストールされていることを確認します。コマンドが成功した場合は、たとえば No resources found in openshift-dpu-operator namespace が出力されます。

   $ oc get csv -n openshift-dpu-operator

   Copy to Clipboard Toggle word wrap