第2章 ノードのネットワーク設定のトラブルシューティング

手順

1. クラスターにポリシーを作成します。次の例では、ens01 をメンバーとして持つ単純なブリッジ br1 を作成します。

   apiVersion: nmstate.io/v1
   kind: NodeNetworkConfigurationPolicy
   metadata:
     name: ens01-bridge-testfail
   spec:
     desiredState:
       interfaces:
         - name: br1
           description: Linux bridge with the wrong port
           type: linux-bridge
           state: up
           ipv4:
             dhcp: true
             enabled: true
           bridge:
             options:
               stp:
                 enabled: false
             port:
               - name: ens01
   # ...

   Copy to Clipboard Toggle word wrap

2. ネットワークインターフェイスにポリシーを適用します。

   $ oc apply -f ens01-bridge-testfail.yaml

   Copy to Clipboard Toggle word wrap

   出力例

   nodenetworkconfigurationpolicy.nmstate.io/ens01-bridge-testfail created

   Copy to Clipboard Toggle word wrap

3. 以下のコマンドを実行してポリシーのステータスを確認します。

   $ oc get nncp

   Copy to Clipboard Toggle word wrap

   この出力は、ポリシーが失敗したことを示しています。

   出力例

   NAME                    STATUS
   ens01-bridge-testfail   FailedToConfigure

   Copy to Clipboard Toggle word wrap

   ポリシーのステータスのみでは、すべてのノードで失敗したか、ノードのサブセットで失敗したかを確認することはできません。

4. ノードのネットワーク設定の enactment (実行) をリスト表示し、ポリシーがいずれかのノードで成功したかどうかを確認します。ポリシーがノードのサブセットに対してのみ失敗した場合、出力は、問題が特定のノード設定にあることを示唆します。すべてのノードでポリシーが失敗した場合、出力はポリシーに問題があることを示唆します。

   $ oc get nnce

   Copy to Clipboard Toggle word wrap

   この出力は、ポリシーがすべてのノードで失敗したことを示しています。

   出力例

   NAME                                         STATUS
   control-plane-1.ens01-bridge-testfail        FailedToConfigure
   control-plane-2.ens01-bridge-testfail        FailedToConfigure
   control-plane-3.ens01-bridge-testfail        FailedToConfigure
   compute-1.ens01-bridge-testfail              FailedToConfigure
   compute-2.ens01-bridge-testfail              FailedToConfigure
   compute-3.ens01-bridge-testfail              FailedToConfigure

   Copy to Clipboard Toggle word wrap

5. 失敗した enactment の 1 つを表示します。以下のコマンドは、出力ツール jsonpath を使用して出力をフィルターします。

   $ oc get nnce compute-1.ens01-bridge-testfail -o jsonpath='{.status.conditions[?(@.type=="Failing")].message}'

   Copy to Clipboard Toggle word wrap

   出力例

   [2024-10-10T08:40:46Z INFO  nmstatectl] Nmstate version: 2.2.37
   NmstateError: InvalidArgument: Controller interface br1 is holding unknown port ens01

   Copy to Clipboard Toggle word wrap

   前の例は、InvalidArgument エラーからの出力で、ens01 が不明なポートであることを示しています。この例では、ポリシー設定ファイル内のポート設定を変更する必要がある場合があります。

6. ポリシーが適切に設定されていることを確認するには、NodeNetworkState オブジェクトを要求して、1 つまたはすべてのノードのネットワーク設定を表示します。以下のコマンドは、control-plane-1 ノードのネットワーク設定を返します。

   $ oc get nns control-plane-1 -o yaml

   Copy to Clipboard Toggle word wrap

   出力は、ノード上のインターフェイス名は ens1 であるものの、失敗したポリシーが ens01 を誤って使用していることを示します。

   出力例

      - ipv4:
   # ...
         name: ens1
         state: up
         type: ethernet

   Copy to Clipboard Toggle word wrap

7. 既存のポリシーを編集してエラーを修正します。

   $ oc edit nncp ens01-bridge-testfail

   Copy to Clipboard Toggle word wrap

   # ...
             port:
               - name: ens1

   Copy to Clipboard Toggle word wrap

   ポリシーを保存して修正を適用します。

8. ポリシーのステータスをチェックして、更新が正常に行われたことを確認します。

   $ oc get nncp

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                    STATUS
   ens01-bridge-testfail   SuccessfullyConfigured

   Copy to Clipboard Toggle word wrap

   更新されたポリシーは、クラスターのすべてのノードで正常に設定されました。