14.3. OpenShift SDN 네트워크 공급자로 롤백

절차

1. 마이그레이션을 사용하려면 다음 명령을 입력하여 Cluster Network Operator 구성 오브젝트에 주석을 설정합니다.

   Copy to Clipboard Toggle word wrap

   $ oc annotate Network.operator.openshift.io cluster \
     'networkoperator.openshift.io/network-migration'=""

2. MCO(Machine Config Operator)에서 관리하는 모든 머신 구성 풀을 중지합니다.

   • 마스터 구성 풀을 중지합니다.

     Copy to Clipboard Toggle word wrap

     $ oc patch MachineConfigPool master --type='merge' --patch \
       '{ "spec": { "paused": true } }'

   • 작업자 구성 풀을 중지합니다.

     Copy to Clipboard Toggle word wrap

     $ oc patch MachineConfigPool worker --type='merge' --patch \
       '{ "spec":{ "paused" :true } }'

3. OpenShift SDN 클러스터 네트워크 공급자를 구성하려면 다음 명령을 입력합니다.

   Copy to Clipboard Toggle word wrap

   $ oc patch Network.config.openshift.io cluster \
     --type='merge' --patch '{ "spec": { "networkType": "OpenShiftSDN" } }'

4. 선택 사항: OpenShift SDN에 대해 네트워크 인프라 요구 사항을 충족하도록 다음 설정을 사용자 지정할 수 있습니다.

   • 최대 전송 단위(MTU)
   • VXLAN 포트

   이전에 명시된 설정 중 하나 또는 둘 다 사용자 정의하려면 사용자 정의하고 다음 명령을 입력합니다. 기본값을 변경할 필요가 없는 경우 패치에서 키를 생략합니다.

   Copy to Clipboard Toggle word wrap

   $ oc patch Network.operator.openshift.io cluster --type=merge \
     --patch '{
       "spec":{
         "defaultNetwork":{
           "openshiftSDNConfig":{
             "mtu":<mtu>,
             "vxlanPort":<port>
       }}}}'

   mtu

   Geneve 오버레이 네트워크용 MTU입니다. MTU 값은 일반적으로 자동으로 지정되지만 클러스터의 모든 노드가 동일한 MTU를 사용하지 않을 때는 최소 노드 MTU 값에서 100을 뺀 값으로 명시적으로 설정해야 합니다.

   port

   Geneve 오버레이 네트워크용 UDP 포트입니다.

   패치 명령 예

   Copy to Clipboard Toggle word wrap

   $ oc patch Network.operator.openshift.io cluster --type=merge \
     --patch '{
       "spec":{
         "defaultNetwork":{
           "openshiftSDNConfig":{
             "mtu":1200
       }}}}'

5. Multus 데몬 세트 롤아웃이 완료될 때까지 기다립니다.

   Copy to Clipboard Toggle word wrap

   $ oc -n openshift-multus rollout status daemonset/multus

   Multus 포드의 이름은 multus-<xxxxx> 형식이며 여기서 <xxxxx>는 임의 문자 순서입니다. 포드를 다시 시작하는 데 시간이 다소 걸릴 수 있습니다.

   출력 예

   Copy to Clipboard Toggle word wrap

   Waiting for daemon set "multus" rollout to finish: 1 out of 6 new pods have been updated...
   ...
   Waiting for daemon set "multus" rollout to finish: 5 of 6 updated pods are available...
   daemon set "multus" successfully rolled out

6. 롤백을 완료하려면 클러스터의 각 노드를 재부팅합니다. 예를 들어 다음과 유사한 bash 스크립트를 사용할 수 있습니다. 이 스크립트는 ssh를 사용하여 각 호스트에 연결할 수 있고 암호를 묻지 않도록 sudo를 구성했다고 가정합니다.

   Copy to Clipboard Toggle word wrap

   #!/bin/bash
   
   for ip in $(oc get nodes  -o jsonpath='{.items[*].status.addresses[?(@.type=="InternalIP")].address}')
   do
      echo "reboot node $ip"
      ssh -o StrictHostKeyChecking=no core@$ip sudo shutdown -r -t 3
   done

7. 클러스터의 노드가 재부팅된 후 모든 머신 구성 풀을 시작합니다.

   • 마스터 구성 풀을 시작합니다.

     Copy to Clipboard Toggle word wrap

     $ oc patch MachineConfigPool master --type='merge' --patch \
       '{ "spec": { "paused": false } }'

   • 작업자 구성 풀을 시작합니다.

     Copy to Clipboard Toggle word wrap

     $ oc patch MachineConfigPool worker --type='merge' --patch \
       '{ "spec": { "paused": false } }'

   MCO는 각 구성 풀에서 머신을 업데이트하므로 각 노드를 재부팅합니다.

   기본적으로 MCO는 한 번에 풀당 단일 머신을 업데이트하므로 마이그레이션이 완료하는 데 필요한 시간은 클러스터 크기와 함께 증가합니다.

8. 호스트의 새 머신 구성 상태를 확인합니다.

   1. 머신 구성 상태 및 적용된 머신 구성 이름을 나열하려면 다음 명령을 입력합니다.

      Copy to Clipboard Toggle word wrap

      $ oc describe node | egrep "hostname|machineconfig"

      출력 예

      Copy to Clipboard Toggle word wrap

      kubernetes.io/hostname=master-0
      machineconfiguration.openshift.io/currentConfig: rendered-master-c53e221d9d24e1c8bb6ee89dd3d8ad7b
      machineconfiguration.openshift.io/desiredConfig: rendered-master-c53e221d9d24e1c8bb6ee89dd3d8ad7b
      machineconfiguration.openshift.io/reason:
      machineconfiguration.openshift.io/state: Done

      다음 구문이 올바른지 확인합니다.

      • machineconfiguration.openshift.io/state 필드의 값은 Done입니다.
      • machineconfiguration.openshift.io/currentConfig 필드의 값은 machineconfiguration.openshift.io/desiredConfig 필드의 값과 동일합니다.

   2. 머신 구성이 올바른지 확인하려면 다음 명령을 입력합니다.

      Copy to Clipboard Toggle word wrap

      $ oc get machineconfig <config_name> -o yaml

      여기서 <config_name>은 machineconfiguration.openshift.io/currentConfig 필드에서 머신 구성의 이름입니다.

9. 마이그레이션이 성공했는지 확인합니다.

   1. 기본 CNI 네트워크 공급자가 OVN-Kubernetes인지 확인하려면 다음 명령을 입력합니다. status.networkType 값은 OpenShiftSDN이어야 합니다.

      Copy to Clipboard Toggle word wrap

      $ oc get network.config/cluster -o jsonpath='{.status.networkType}{"\n"}'

   2. 클러스터 노드가 준비 상태에 있는지 확인하려면 다음 명령을 입력합니다.

      Copy to Clipboard Toggle word wrap

      $ oc get nodes

   3. 노드가 NotReady 상태에 있는 경우 머신 구성 데몬 포드 로그를 조사하고 오류를 해결합니다.

      1. 포드를 나열하려면 다음 명령을 입력합니다.

         Copy to Clipboard Toggle word wrap

         $ oc get pod -n openshift-machine-config-operator

         출력 예

         Copy to Clipboard Toggle word wrap

         NAME                                         READY   STATUS    RESTARTS   AGE
         machine-config-controller-75f756f89d-sjp8b   1/1     Running   0          37m
         machine-config-daemon-5cf4b                  2/2     Running   0          43h
         machine-config-daemon-7wzcd                  2/2     Running   0          43h
         machine-config-daemon-fc946                  2/2     Running   0          43h
         machine-config-daemon-g2v28                  2/2     Running   0          43h
         machine-config-daemon-gcl4f                  2/2     Running   0          43h
         machine-config-daemon-l5tnv                  2/2     Running   0          43h
         machine-config-operator-79d9c55d5-hth92      1/1     Running   0          37m
         machine-config-server-bsc8h                  1/1     Running   0          43h
         machine-config-server-hklrm                  1/1     Running   0          43h
         machine-config-server-k9rtx                  1/1     Running   0          43h

         구성 데몬 포드의 이름은 다음 형식입니다. machine-config-daemon-<seq>. <seq> 값은 임의 5자 영숫자 순서입니다.

      2. 이전 출력에 표시된 각 머신 구성 데몬 포드에 대한 포드 로그를 표시하려면 다음 명령을 입력합니다.

         Copy to Clipboard Toggle word wrap

         $ oc logs <pod> -n openshift-machine-config-operator

         여기서 pod는 머신 구성 데몬 포드의 이름입니다.

      3. 이전 명령의 출력에 표시된 로그의 오류를 해결합니다.

   4. Pod가 오류 상태가 아닌지 확인하려면 다음 명령을 입력합니다.

      Copy to Clipboard Toggle word wrap

      $ oc get pods --all-namespaces -o wide --sort-by='{.spec.nodeName}'

      노드의 Pod가 오류 상태인 경우 해당 노드를 재부팅합니다.

10. 마이그레이션이 성공하고 클러스터가 양호한 상태인 경우에만 다음 단계를 완료합니다.

    1. Cluster Network Operator 구성 오브젝트에서 마이그레이션 주석을 제거하려면 다음 명령을 입력합니다.

       Copy to Clipboard Toggle word wrap

       $ oc annotate Network.operator.openshift.io cluster \
         networkoperator.openshift.io/network-migration-

    2. OVN-Kubernetes 네트워크 공급자 네임스페이스를 제거하려면 다음 명령을 입력합니다.

       Copy to Clipboard Toggle word wrap

       $ oc delete namespace openshift-ovn-kubernetes