2장. 로컬 스토리지 장치를 사용하여 배포된 OpenShift Data Foundation

절차

1. 노드를 식별하고 교체해야 하는 노드의 레이블을 가져옵니다.

   $ oc get nodes --show-labels | grep <node_name>

   Copy to Clipboard

   <node_name>

   교체해야 하는 노드 이름을 지정합니다.

2. 교체해야 하는 노드에서 실행 중인 모니터 Pod(있는 경우) 및 OSD를 확인합니다.

   $ oc get pods -n openshift-storage -o wide | grep -i <node_name>

   Copy to Clipboard

3. 이전 단계에서 확인한 Pod의 배포를 축소합니다.

   예를 들면 다음과 같습니다.

   $ oc scale deployment rook-ceph-mon-c --replicas=0 -n openshift-storage

   Copy to Clipboard

   $ oc scale deployment rook-ceph-osd-0 --replicas=0 -n openshift-storage

   Copy to Clipboard

   $ oc scale deployment --selector=app=rook-ceph-crashcollector,node_name=<node_name>  --replicas=0 -n openshift-storage

   Copy to Clipboard

4. 노드를 예약 불가능으로 표시합니다.

   $ oc adm cordon <node_name>

   Copy to Clipboard

5. 노드를 드레이닝합니다.

   $ oc adm drain <node_name> --force --delete-emptydir-data=true --ignore-daemonsets

   Copy to Clipboard

6. 노드를 제거합니다.

   $ oc delete node <node_name>

   Copy to Clipboard

7. 필수 인프라를 사용하여 새 베어 메탈 머신을 가져옵니다. 베어 메탈에 설치를 참조하십시오.

   중요

   3노드 OpenShift 컴팩트 베어 메탈 클러스터에 OpenShift Data Foundation을 설치할 때 마스터 노드를 교체하는 방법에 대한 자세한 내용은 OpenShift Container Platform 설명서의 백업 및 복원 가이드를 참조하십시오.

8. 새로운 베어 메탈 머신을 사용하여 새 OpenShift Container Platform 노드를 생성합니다.

9. Pending 상태인 OpenShift Container Platform과 관련된 CSR(인증서 서명 요청)이 있는지 확인합니다.

   $ oc get csr

   Copy to Clipboard

10. 새 노드에 필요한 모든 OpenShift Container Platform CSR을 승인합니다.

    $ oc adm certificate approve <certificate_name>

    Copy to Clipboard

    <certificate_name>

    CSR의 이름을 지정합니다.

11. OpenShift 웹 콘솔에서 컴퓨팅 → 노드를 클릭합니다. 새 노드가 Ready 상태인지 확인합니다.

12. 다음 중 하나를 사용하여 OpenShift Data Foundation 레이블을 새 노드에 적용합니다.

    사용자 인터페이스에서

    1. 새 노드의 Action Menu (ECDHE) Edit Labels 를 클릭합니다.
    2. cluster.ocs.openshift.io/openshift-storage 를 추가하고 저장을 클릭합니다.

    명령줄 인터페이스

    • OpenShift Data Foundation 레이블을 새 노드에 적용합니다.

    $ oc label node <new_node_name> cluster.ocs.openshift.io/openshift-storage=""

    Copy to Clipboard

    <new_node_name>

    새 노드의 이름을 지정합니다.

13. OpenShift 로컬 스토리지 Operator가 설치된 네임스페이스를 확인하고 local_storage_project 변수에 할당합니다.

    $ local_storage_project=$(oc get csv --all-namespaces | awk '{print $1}' | grep local)

    Copy to Clipboard

    예를 들면 다음과 같습니다.

    $ local_storage_project=$(oc get csv --all-namespaces | awk '{print $1}' | grep local)

    Copy to Clipboard

    echo $local_storage_project

    Copy to Clipboard

    출력 예:

    openshift-local-storage

    Copy to Clipboard

14. localVolumeDiscovery 및 localVolumeSet 에 새 작업자 노드를 추가합니다.

    1. 새 노드를 포함하도록 localVolumeDiscovery 정의를 업데이트하고 실패한 노드를 제거합니다.

       # oc edit -n $local_storage_project localvolumediscovery auto-discover-devices

       Copy to Clipboard

       출력 예:

       [...]
          nodeSelector:
           nodeSelectorTerms:
             - matchExpressions:
                 - key: kubernetes.io/hostname
                   operator: In
                   values:
                   - server1.example.com
                   - server2.example.com
                   #- server3.example.com
                   - newnode.example.com
       [...]

       Copy to Clipboard

       편집기를 종료하기 전에 저장해야 합니다.

       이 예에서는 server3.example.com 이 제거되고 newnode.example.com 이 새 노드입니다.

    2. 편집할 localVolumeSet 을 결정합니다.

       # oc get -n $local_storage_project localvolumeset

       Copy to Clipboard

       출력 예:

       NAME          AGE
       localblock   25h

       Copy to Clipboard

    3. 새 노드를 포함하도록 localVolumeSet 정의를 업데이트하고 실패한 노드를 삭제합니다.

       # oc edit -n $local_storage_project localvolumeset localblock

       Copy to Clipboard

       출력 예:

       [...]
          nodeSelector:
           nodeSelectorTerms:
             - matchExpressions:
                 - key: kubernetes.io/hostname
                   operator: In
                   values:
                   - server1.example.com
                   - server2.example.com
                   #- server3.example.com
                   - newnode.example.com
       [...]

       Copy to Clipboard

       편집기를 종료하기 전에 저장해야 합니다.

       이 예에서는 server3.example.com 이 제거되고 newnode.example.com 이 새 노드입니다.

15. 새 로컬 블록 PV(영구 볼륨)를 사용할 수 있는지 확인합니다.

    $oc get pv | grep localblock | grep Available

    Copy to Clipboard

    출력 예:

    local-pv-551d950     512Gi    RWO    Delete  Available
    localblock     26s

    Copy to Clipboard

16. openshift-storage 프로젝트로 이동합니다.

    $ oc project openshift-storage

    Copy to Clipboard

17. 클러스터에서 실패한 OSD를 제거합니다. 필요한 경우 여러 개의 실패한 OSD를 지정할 수 있습니다.

    $ oc process -n openshift-storage ocs-osd-removal \
    -p FAILED_OSD_IDS=<failed_osd_id> -p FORCE_OSD_REMOVAL=true | oc create -f -

    Copy to Clipboard

    <failed_osd_id>

    rook-ceph-osd 접두사 직후 Pod 이름의 정수입니다.

    명령에 쉼표로 구분된 OSD ID를 추가하여 OSD를 두 개 이상 제거할 수 있습니다(예: FAILED_OSD_IDS=0,1,2 ).

    OSD가 3개뿐인 클러스터에서 FORCE_OSD_REMOVAL 값을 true 로 변경해야 합니다. OSD를 제거한 후 3개의 데이터 복제본을 모두 복원할 수 있는 공간이 충분하지 않은 클러스터에서는 FORCE_OSD_REMOVAL 값을 true로 변경해야 합니다.

18. ocs-osd-removal-job Pod의 상태를 확인하여 OSD가 성공적으로 제거되었는지 확인합니다.

    Completed 상태로 인해 OSD 제거 작업이 성공했는지 확인합니다.

    # oc get pod -l job-name=ocs-osd-removal-job -n openshift-storage

    Copy to Clipboard

19. OSD 제거가 완료되었는지 확인합니다.

    $ oc logs -l job-name=ocs-osd-removal-job -n openshift-storage --tail=-1 | egrep -i 'completed removal'

    Copy to Clipboard

    출력 예:

    2022-05-10 06:50:04.501511 I | cephosd: completed removal of OSD 0

    Copy to Clipboard
    중요

    ocs-osd-removal-job 이 실패하고 Pod가 예상 Completed 상태가 아닌 경우 Pod 로그를 확인하여 추가 디버깅을 확인합니다.

    예를 들면 다음과 같습니다.

    # oc logs -l job-name=ocs-osd-removal-job -n openshift-storage --tail=-1

    Copy to Clipboard

20. PVC(영구 볼륨 클레임)와 연결된 PV(영구 볼륨)를 식별합니다.

    # oc get pv -L kubernetes.io/hostname | grep localblock | grep Released

    Copy to Clipboard

    출력 예:

    local-pv-d6bf175b  1490Gi  RWO  Delete  Released  openshift-storage/ocs-deviceset-0-data-0-6c5pw  localblock  2d22h  compute-1

    Copy to Clipboard

    릴리스된 PV가 있는 경우 이를 삭제합니다.

    # oc delete pv <persistent_volume>

    Copy to Clipboard

    예를 들면 다음과 같습니다.

    # oc delete pv local-pv-d6bf175b

    Copy to Clipboard

    출력 예:

    persistentvolume "local-pv-d9c5cbd6" deleted

    Copy to Clipboard

21. crashcollector Pod 배포를 확인합니다.

    $ oc get deployment --selector=app=rook-ceph-crashcollector,node_name=<failed_node_name> -n openshift-storage

    Copy to Clipboard

    기존 crashcollector Pod 배포가 있는 경우 삭제합니다.

    $ oc delete deployment --selector=app=rook-ceph-crashcollector,node_name=<failed_node_name> -n openshift-storage

    Copy to Clipboard

22. ocs-osd-removal-job 을 삭제합니다.

    # oc delete -n openshift-storage job ocs-osd-removal-job

    Copy to Clipboard

    출력 예:

    job.batch "ocs-osd-removal-job" deleted

    Copy to Clipboard

검증 단계

1. 새 노드가 출력에 있는지 확인합니다.

   $ oc get nodes --show-labels | grep cluster.ocs.openshift.io/openshift-storage= |cut -d' ' -f1

   Copy to Clipboard

2. 워크로드 포드 를 클릭합니다. 새 노드의 다음 Pod가 Running 상태인지 확인합니다.

   • csi-cephfsplugin-*
   • csi-rbdplugin-*

3. 기타 필요한 모든 OpenShift Data Foundation Pod가 Running 상태인지 확인합니다.

   새로운 incremental mon 이 생성되고 Running 상태에 있는지 확인합니다.

   $ oc get pod -n openshift-storage | grep mon

   Copy to Clipboard

   출력 예:

   rook-ceph-mon-a-cd575c89b-b6k66         2/2     Running
   0          38m
   rook-ceph-mon-b-6776bc469b-tzzt8        2/2     Running
   0          38m
   rook-ceph-mon-d-5ff5d488b5-7v8xh        2/2     Running
   0          4m8s

   Copy to Clipboard

   OSD 및 모니터링 포드의 상태가 Running 이 되는 데 몇 분이 걸릴 수 있습니다.

4. 새 OSD 포드가 대체 노드에서 실행 중인지 확인합니다.

   $ oc get pods -o wide -n openshift-storage| egrep -i <new_node_name> | egrep osd

   Copy to Clipboard

5. 선택 사항: 클러스터에서 클러스터 전체 암호화를 사용하는 경우 새 OSD 장치가 암호화되었는지 확인합니다.

   이전 단계에서 확인된 각 새 노드에 대해 다음을 수행합니다.

   1. 디버그 Pod를 생성하고 하나 이상의 선택한 호스트에 대한 chroot 환경을 엽니다.

      $ oc debug node/<node_name>

      Copy to Clipboard

      $ chroot /host

      Copy to Clipboard

   2. 사용 가능한 블록 장치 목록을 표시합니다.

      $ lsblk

      Copy to Clipboard

      하나 이상의 ocs-deviceset 이름 옆에 crypt 키워드가 있는지 확인합니다.

6. 검증 단계가 실패하면 Red Hat 지원팀에 문의하십시오.

절차

1. 노드를 식별하고 교체해야 하는 노드의 레이블을 가져옵니다.

   $ oc get nodes --show-labels | grep <node_name>

   Copy to Clipboard

   <node_name>

   교체해야 하는 노드 이름을 지정합니다.

2. 교체해야 하는 노드에서 실행 중인 모니터 Pod(있는 경우) 및 OSD를 확인합니다.

   $ oc get pods -n openshift-storage -o wide | grep -i <node_name>

   Copy to Clipboard

3. 이전 단계에서 확인한 Pod의 배포를 축소합니다.

   예를 들면 다음과 같습니다.

   $ oc scale deployment rook-ceph-mon-c --replicas=0 -n openshift-storage

   Copy to Clipboard

   $ oc scale deployment rook-ceph-osd-0 --replicas=0 -n openshift-storage

   Copy to Clipboard

   $ oc scale deployment --selector=app=rook-ceph-crashcollector,node_name=<node_name>  --replicas=0 -n openshift-storage

   Copy to Clipboard

4. 노드를 예약 불가능으로 표시합니다.

   $ oc adm cordon <node_name>

   Copy to Clipboard

5. 상태가 종료되는 Pod를 제거합니다.

   $ oc get pods -A -o wide | grep -i <node_name> |  awk '{if ($4 == "Terminating") system ("oc -n " $1 " delete pods " $2  " --grace-period=0 " " --force ")}'

   Copy to Clipboard

6. 노드를 드레이닝합니다.

   $ oc adm drain <node_name> --force --delete-emptydir-data=true --ignore-daemonsets

   Copy to Clipboard

7. 노드를 제거합니다.

   $ oc delete node <node_name>

   Copy to Clipboard

8. 필수 인프라를 사용하여 새 베어 메탈 머신을 가져옵니다. 베어 메탈에 설치를 참조하십시오.

   중요

   3노드 OpenShift 컴팩트 베어 메탈 클러스터에 OpenShift Data Foundation을 설치할 때 마스터 노드를 교체하는 방법에 대한 자세한 내용은 OpenShift Container Platform 설명서의 백업 및 복원 가이드를 참조하십시오.

9. 새로운 베어 메탈 머신을 사용하여 새 OpenShift Container Platform 노드를 생성합니다.

10. Pending 상태인 OpenShift Container Platform과 관련된 CSR(인증서 서명 요청)이 있는지 확인합니다.

    $ oc get csr

    Copy to Clipboard

11. 새 노드에 필요한 모든 OpenShift Container Platform CSR을 승인합니다.

    $ oc adm certificate approve <certificate_name>

    Copy to Clipboard

    <certificate_name>

    CSR의 이름을 지정합니다.

12. OpenShift 웹 콘솔에서 컴퓨팅 → 노드를 클릭합니다. 새 노드가 Ready 상태인지 확인합니다.

13. 다음 중 하나를 사용하여 OpenShift Data Foundation 레이블을 새 노드에 적용합니다.

    사용자 인터페이스에서

    1. 새 노드의 Action Menu (ECDHE) Edit Labels 를 클릭합니다.
    2. cluster.ocs.openshift.io/openshift-storage 를 추가하고 저장을 클릭합니다.

    명령줄 인터페이스

    • OpenShift Data Foundation 레이블을 새 노드에 적용합니다.

    $ oc label node <new_node_name> cluster.ocs.openshift.io/openshift-storage=""

    Copy to Clipboard

    <new_node_name>

    새 노드의 이름을 지정합니다.

14. OpenShift 로컬 스토리지 Operator가 설치된 네임스페이스를 확인하고 local_storage_project 변수에 할당합니다.

    $ local_storage_project=$(oc get csv --all-namespaces | awk '{print $1}' | grep local)

    Copy to Clipboard

    예를 들면 다음과 같습니다.

    $ local_storage_project=$(oc get csv --all-namespaces | awk '{print $1}' | grep local)

    Copy to Clipboard

    echo $local_storage_project

    Copy to Clipboard

    출력 예:

    openshift-local-storage

    Copy to Clipboard

15. localVolumeDiscovery 및 localVolumeSet 에 새 작업자 노드를 추가합니다.

    1. 새 노드를 포함하도록 localVolumeDiscovery 정의를 업데이트하고 실패한 노드를 제거합니다.

       # oc edit -n $local_storage_project localvolumediscovery auto-discover-devices

       Copy to Clipboard

       출력 예:

       [...]
          nodeSelector:
           nodeSelectorTerms:
             - matchExpressions:
                 - key: kubernetes.io/hostname
                   operator: In
                   values:
                   - server1.example.com
                   - server2.example.com
                   #- server3.example.com
                   - newnode.example.com
       [...]

       Copy to Clipboard

       편집기를 종료하기 전에 저장해야 합니다.

       이 예에서는 server3.example.com 이 제거되고 newnode.example.com 이 새 노드입니다.

    2. 편집할 localVolumeSet 을 결정합니다.

       # oc get -n $local_storage_project localvolumeset

       Copy to Clipboard

       출력 예:

       NAME          AGE
       localblock   25h

       Copy to Clipboard

    3. 새 노드를 포함하도록 localVolumeSet 정의를 업데이트하고 실패한 노드를 삭제합니다.

       # oc edit -n $local_storage_project localvolumeset localblock

       Copy to Clipboard

       출력 예:

       [...]
          nodeSelector:
           nodeSelectorTerms:
             - matchExpressions:
                 - key: kubernetes.io/hostname
                   operator: In
                   values:
                   - server1.example.com
                   - server2.example.com
                   #- server3.example.com
                   - newnode.example.com
       [...]

       Copy to Clipboard

       편집기를 종료하기 전에 저장해야 합니다.

       이 예에서는 server3.example.com 이 제거되고 newnode.example.com 이 새 노드입니다.

16. 새 로컬 블록 PV(영구 볼륨)를 사용할 수 있는지 확인합니다.

    $oc get pv | grep localblock | grep Available

    Copy to Clipboard

    출력 예:

    local-pv-551d950     512Gi    RWO    Delete  Available
    localblock     26s

    Copy to Clipboard

17. openshift-storage 프로젝트로 이동합니다.

    $ oc project openshift-storage

    Copy to Clipboard

18. 클러스터에서 실패한 OSD를 제거합니다. 필요한 경우 여러 개의 실패한 OSD를 지정할 수 있습니다.

    $ oc process -n openshift-storage ocs-osd-removal \
    -p FAILED_OSD_IDS=<failed_osd_id> -p FORCE_OSD_REMOVAL=true | oc create -f -

    Copy to Clipboard

    <failed_osd_id>

    rook-ceph-osd 접두사 직후 Pod 이름의 정수입니다.

    명령에 쉼표로 구분된 OSD ID를 추가하여 OSD를 두 개 이상 제거할 수 있습니다(예: FAILED_OSD_IDS=0,1,2 ).

    OSD가 3개뿐인 클러스터에서 FORCE_OSD_REMOVAL 값을 true 로 변경해야 합니다. OSD를 제거한 후 3개의 데이터 복제본을 모두 복원할 수 있는 공간이 충분하지 않은 클러스터에서는 FORCE_OSD_REMOVAL 값을 true로 변경해야 합니다.

19. ocs-osd-removal-job Pod의 상태를 확인하여 OSD가 성공적으로 제거되었는지 확인합니다.

    Completed 상태로 인해 OSD 제거 작업이 성공했는지 확인합니다.

    # oc get pod -l job-name=ocs-osd-removal-job -n openshift-storage

    Copy to Clipboard

20. OSD 제거가 완료되었는지 확인합니다.

    $ oc logs -l job-name=ocs-osd-removal-job -n openshift-storage --tail=-1 | egrep -i 'completed removal'

    Copy to Clipboard

    출력 예:

    2022-05-10 06:50:04.501511 I | cephosd: completed removal of OSD 0

    Copy to Clipboard
    중요

    ocs-osd-removal-job 이 실패하고 Pod가 예상 Completed 상태가 아닌 경우 Pod 로그를 확인하여 추가 디버깅을 확인합니다.

    예를 들면 다음과 같습니다.

    # oc logs -l job-name=ocs-osd-removal-job -n openshift-storage --tail=-1

    Copy to Clipboard

21. PVC(영구 볼륨 클레임)와 연결된 PV(영구 볼륨)를 식별합니다.

    # oc get pv -L kubernetes.io/hostname | grep localblock | grep Released

    Copy to Clipboard

    출력 예:

    local-pv-d6bf175b  1490Gi  RWO  Delete  Released  openshift-storage/ocs-deviceset-0-data-0-6c5pw  localblock  2d22h  compute-1

    Copy to Clipboard

    릴리스된 PV가 있는 경우 이를 삭제합니다.

    # oc delete pv <persistent_volume>

    Copy to Clipboard

    예를 들면 다음과 같습니다.

    # oc delete pv local-pv-d6bf175b

    Copy to Clipboard

    출력 예:

    persistentvolume "local-pv-d9c5cbd6" deleted

    Copy to Clipboard

22. crashcollector Pod 배포를 확인합니다.

    $ oc get deployment --selector=app=rook-ceph-crashcollector,node_name=<failed_node_name> -n openshift-storage

    Copy to Clipboard

    기존 crashcollector Pod 배포가 있는 경우 삭제합니다.

    $ oc delete deployment --selector=app=rook-ceph-crashcollector,node_name=<failed_node_name> -n openshift-storage

    Copy to Clipboard

23. ocs-osd-removal-job 을 삭제합니다.

    # oc delete -n openshift-storage job ocs-osd-removal-job

    Copy to Clipboard

    출력 예:

    job.batch "ocs-osd-removal-job" deleted

    Copy to Clipboard

검증 단계

1. 새 노드가 출력에 있는지 확인합니다.

   $ oc get nodes --show-labels | grep cluster.ocs.openshift.io/openshift-storage= |cut -d' ' -f1

   Copy to Clipboard

2. 워크로드 포드 를 클릭합니다. 새 노드의 다음 Pod가 Running 상태인지 확인합니다.

   • csi-cephfsplugin-*
   • csi-rbdplugin-*

3. 기타 필요한 모든 OpenShift Data Foundation Pod가 Running 상태인지 확인합니다.

   새로운 incremental mon 이 생성되고 Running 상태에 있는지 확인합니다.

   $ oc get pod -n openshift-storage | grep mon

   Copy to Clipboard

   출력 예:

   rook-ceph-mon-a-cd575c89b-b6k66         2/2     Running
   0          38m
   rook-ceph-mon-b-6776bc469b-tzzt8        2/2     Running
   0          38m
   rook-ceph-mon-d-5ff5d488b5-7v8xh        2/2     Running
   0          4m8s

   Copy to Clipboard

   OSD 및 모니터링 포드의 상태가 Running 이 되는 데 몇 분이 걸릴 수 있습니다.

4. 새 OSD 포드가 대체 노드에서 실행 중인지 확인합니다.

   $ oc get pods -o wide -n openshift-storage| egrep -i <new_node_name> | egrep osd

   Copy to Clipboard

5. 선택 사항: 클러스터에서 클러스터 전체 암호화를 사용하는 경우 새 OSD 장치가 암호화되었는지 확인합니다.

   이전 단계에서 확인된 각 새 노드에 대해 다음을 수행합니다.

   1. 디버그 Pod를 생성하고 하나 이상의 선택한 호스트에 대한 chroot 환경을 엽니다.

      $ oc debug node/<node_name>

      Copy to Clipboard

      $ chroot /host

      Copy to Clipboard

   2. 사용 가능한 블록 장치 목록을 표시합니다.

      $ lsblk

      Copy to Clipboard

      하나 이상의 ocs-deviceset 이름 옆에 crypt 키워드가 있는지 확인합니다.

6. 검증 단계가 실패하면 Red Hat 지원팀에 문의하십시오.