29.3. 노드 네트워크 구성 문제 해결

절차

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
   # ...

2. 네트워크 인터페이스에 정책을 적용합니다.

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

   출력 예

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

3. 다음 명령을 실행하여 정책의 상태를 확인합니다.

   $ oc get nncp

   출력에 정책이 실패했다는 내용이 표시됩니다.

   출력 예

   NAME                    STATUS
   ens01-bridge-testfail   FailedToConfigure

   정책 상태만으로는 모든 노드에서 실패했는지 또는 노드의 하위 집합에서 실패했는지를 나타내지 않습니다.

4. 노드 네트워크 구성 시행을 나열하여 정책이 모든 노드에서 성공적인지 확인합니다. 정책이 노드 서브 세트에서만 실패한 경우 출력에 특정 노드 구성에 문제가 있음을 나타냅니다. 정책이 모든 노드에서 실패하면 출력에 문제가 정책에 있음을 나타냅니다.

   $ oc get nnce

   출력에 정책이 모든 노드에서 실패했다는 내용이 표시됩니다.

   출력 예

   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

5. 실패한 시행 중 하나를 봅니다. 다음 명령은 출력 툴 jsonpath를 사용하여 출력을 필터링합니다.

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

   출력 예

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

   이전 예제에서는 ens01 이 알 수 없는 포트임을 나타내는 InvalidArgument 오류의 출력을 보여줍니다. 이 예에서는 정책 구성 파일에서 포트 구성을 변경해야 할 수 있습니다.

6. 정책이 제대로 구성되었는지 확인하기 위해 NodeNetworkState 오브젝트를 요청하여 하나 또는 모든 노드의 네트워크 구성을 확인합니다. 다음 명령에서는 control-plane-1 노드의 네트워크 구성을 반환합니다.

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

   출력에 노드의 인터페이스 이름이 ens1인데 실패한 정책에서 ens01로 잘못 사용하고 있다는 내용이 표시됩니다.

   출력 예

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

7. 기존 정책을 편집하여 오류를 수정합니다.

   $ oc edit nncp ens01-bridge-testfail

   # ...
             port:
               - name: ens1

   정책을 저장하여 수정 사항을 적용합니다.

8. 정책 상태를 확인하여 업데이트가 완료되었는지 확인합니다.

   $ oc get nncp

   출력 예

   NAME                    STATUS
   ens01-bridge-testfail   SuccessfullyConfigured

   업데이트된 정책이 클러스터의 모든 노드에 성공적으로 구성되었습니다.