12.3. 对节点网络配置进行故障排除

流程

1. 创建策略并将其应用到集群。以下示例在 ens01 接口上创建了一个简单桥接：

   apiVersion: nmstate.io/v1beta1
   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

   $ 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

2. 运行以下命令，验证策略的状态：

   $ oc get nncp

   Copy to Clipboard Toggle word wrap

   输出显示策略失败：

   输出示例

   NAME                    STATUS
   ens01-bridge-testfail   FailedToConfigure

   Copy to Clipboard Toggle word wrap

   但是，仅有策略状态并不表示它在所有节点或某个节点子集中是否失败。

3. 列出节点网络配置以查看策略在任意节点上是否成功。如果策略只针对某个节点子集失败，这表示问题在于特定的节点配置。如果策略在所有节点上都失败，这表示问题在于策略。

   $ 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

4. 查看失败的原因之一并查看回溯信息。以下命令使用输出工具 jsonpath 来过滤输出结果：

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

   Copy to Clipboard Toggle word wrap

   这个命令会返回一个大的回溯信息，它被编辑为 brevity:

   输出示例

   error reconciling NodeNetworkConfigurationPolicy at desired state apply: , failed to execute nmstatectl set --no-commit --timeout 480: 'exit status 1' ''
   ...
   libnmstate.error.NmstateVerificationError:
   desired
   =======
   ---
   name: br1
   type: linux-bridge
   state: up
   bridge:
     options:
       group-forward-mask: 0
       mac-ageing-time: 300
       multicast-snooping: true
       stp:
         enabled: false
         forward-delay: 15
         hello-time: 2
         max-age: 20
         priority: 32768
     port:
     - name: ens01
   description: Linux bridge with the wrong port
   ipv4:
     address: []
     auto-dns: true
     auto-gateway: true
     auto-routes: true
     dhcp: true
     enabled: true
   ipv6:
     enabled: false
   mac-address: 01-23-45-67-89-AB
   mtu: 1500
   
   current
   =======
   ---
   name: br1
   type: linux-bridge
   state: up
   bridge:
     options:
       group-forward-mask: 0
       mac-ageing-time: 300
       multicast-snooping: true
       stp:
         enabled: false
         forward-delay: 15
         hello-time: 2
         max-age: 20
         priority: 32768
     port: []
   description: Linux bridge with the wrong port
   ipv4:
     address: []
     auto-dns: true
     auto-gateway: true
     auto-routes: true
     dhcp: true
     enabled: true
   ipv6:
     enabled: false
   mac-address: 01-23-45-67-89-AB
   mtu: 1500
   
   difference
   ==========
   --- desired
   +++ current
   @@ -13,8 +13,7 @@
          hello-time: 2
          max-age: 20
          priority: 32768
   -  port:
   -  - name: ens01
   +  port: []
    description: Linux bridge with the wrong port
    ipv4:
      address: []
     line 651, in _assert_interfaces_equal\n    current_state.interfaces[ifname],\nlibnmstate.error.NmstateVerificationError:

   Copy to Clipboard Toggle word wrap

   NmstateVerificationError 列出了 desired（期望的） 策略配置，策略在节点上的current（当前的） 配置，并高亮标识了不匹配参数间的difference（不同）。在本示例中，此 port 包含在 difference 部分，这表示策略中的端口配置问题。

5. 要确保正确配置了策略，请求 NodeNetworkState 来查看一个或多个节点的网络配置。以下命令返回 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

6. 通过编辑现有策略修正错误：

   $ oc edit nncp ens01-bridge-testfail

   Copy to Clipboard Toggle word wrap

   ...
             port:
               - name: ens1

   Copy to Clipboard Toggle word wrap

   保存策略以应用更正。

7. 检查策略的状态，以确保它被成功更新：

   $ oc get nncp

   Copy to Clipboard Toggle word wrap

   输出示例

   NAME                    STATUS
   ens01-bridge-testfail   SuccessfullyConfigured

   Copy to Clipboard Toggle word wrap