第5章 ローカルストレージデバイスを使用してデプロイされた OpenShift Data Foundation

手順

1. 関連するワーカーノードから基礎となるストレージデバイスを削除します。

2. 関連する OSD Pod が CrashLoopBackOff 状態になったことを確認します。

   置き換える必要がある OSD と、その OSD がスケジュールされている OpenShift Container Platform ノードを特定します。

   $ oc get -n openshift-storage pods -l app=rook-ceph-osd -o wide

   出力例:

   rook-ceph-osd-0-6d77d6c7c6-m8xj6    0/1    CrashLoopBackOff    0    24h   10.129.0.16   compute-2   <none>           <none>
   rook-ceph-osd-1-85d99fb95f-2svc7    1/1    Running             0    24h   10.128.2.24   compute-0   <none>           <none>
   rook-ceph-osd-2-6c66cdb977-jp542    1/1    Running             0    24h   10.130.0.18   compute-1   <none>           <none>

   この例では、rook-ceph-osd-0-6d77d6c7c6-m8xj6 を置き換える必要があり、compute-2 は OSD がスケジュールされる OpenShift Container platform ノードです。

3. 置き換えられる OSD の OSD デプロイメントをスケールダウンします。

   $ osd_id_to_remove=0

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

   ここで、osd_id_to_remove は rook-ceph-osd 接頭辞の直後にくる Pod 名の整数です。この例では、デプロイメント名は rook-ceph-osd-0 です。

   出力例:

   deployment.extensions/rook-ceph-osd-0 scaled

4. rook-ceph-osd Pod が停止していることを確認します。

   $ oc get -n openshift-storage pods -l ceph-osd-id=${osd_id_to_remove}

   出力例:

   No resources found in openshift-storage namespace.

   重要

   rook-ceph-osd Pod が数分以上 terminating 状態である場合は、force オプションを使用して Pod を削除します。

   $ oc delete -n openshift-storage pod rook-ceph-osd-0-6d77d6c7c6-m8xj6 --grace-period=0 --force

   出力例:

   warning: Immediate deletion does not wait for confirmation that the running resource has been terminated. The resource may continue to run on the cluster indefinitely.
     pod "rook-ceph-osd-0-6d77d6c7c6-m8xj6" force deleted

5. 新しい OSD を追加できるように、クラスターから古い OSD を削除します。

   1. 古い ocs-osd-removal ジョブを削除します。

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

      出力例:

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

   2. openshift-storage プロジェクトに移動します。

      $ oc project openshift-storage

   3. クラスターから以前の OSD を削除します。

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

      <failed_osd_id>

      rook-ceph-osd 接頭辞の直後の Pod 名の整数です。コマンドにコンマ区切りの OSD ID を追加して、複数の OSD を削除できます (例: FAILED_OSD_IDS=0,1,2)

      OSD が 3 つしかないクラスター、または OSD が削除された後にデータの 3 つのレプリカすべてを復元するにはスペースが不十分なクラスターでは、FORCE_OSD_REMOVAL 値を true に変更する必要があります。

      警告

      この手順により、OSD はクラスターから完全に削除されます。osd_id_to_remove の正しい値が指定されていることを確認します。

6. ocs-osd-removal-job Pod のステータスをチェックして、OSD が正常に削除されたことを確認します。

   Completed のステータスで、OSD の削除ジョブが正常に完了したことを確認します。

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

7. OSD の取り外しが完了したことを確認します。

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

   出力例:

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

   重要

   ocs-osd-removal-job が失敗し、Pod が予想される Completed の状態にない場合、追加のデバッグのために Pod ログを確認します。

   以下に例を示します。

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

8. 暗号化がインストール時に有効にされている場合は、それぞれの OpenShift Data Foundation ノードから削除された OSD デバイスから dm-crypt で管理される device-mapper マッピングを削除します。

   1. ocs-osd-removal-job Pod のログから、置き換えられた OSD の 永続ボリューム要求 (PVC) 名を取得します。

      $ oc logs -l job-name=ocs-osd-removal-job -n openshift-storage --tail=-1  |egrep -i ‘pvc|deviceset’

      出力例:

      2021-05-12 14:31:34.666000 I | cephosd: removing the OSD PVC "ocs-deviceset-xxxx-xxx-xxx-xxx"

   2. これまでに特定した各ノードに以下を実行します。

      1. デバッグ Pod を作成し、ストレージノードのホストに対して chroot を作成します。

         $ oc debug node/<node name>

         <node name>

         ノードの名前。

         $ chroot /host

      2. 直前の手順で特定された PVC 名に基づいて関連するデバイス名を検索します。

         $ dmsetup ls| grep <pvc name>

         <pvc name>

         PVC の名前です。

         出力例:

         ocs-deviceset-xxx-xxx-xxx-xxx-block-dmcrypt (253:0)

      3. マップ済みデバイスを削除します。

         $ cryptsetup luksClose --debug --verbose ocs-deviceset-xxx-xxx-xxx-xxx-block-dmcrypt

         重要

         権限が十分にないため、コマンドがスタックした場合には、以下のコマンドを実行します。

         • CTRL+Z を押して上記のコマンドを終了します。

         • スタックしたプロセスの PID を検索します。

           $ ps -ef | grep crypt

         • kill コマンドを使用してプロセスを終了します。

           $ kill -9 <PID>

           <PID>

           プロセス ID です。

         • デバイス名が削除されていることを確認します。

           $ dmsetup ls

9. 削除する必要のある永続ボリューム (PV) を検索します。

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

   出力例:

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

10. PV を削除します。

    $ oc delete pv <pv_name>

1. 物理的に新規デバイスをノードに追加します。

2. deviceInclusionSpec に一致するデバイスの PV のプロビジョニングを追跡します。PV をプロビジョニングするのに数分かかる場合があります。

   $ oc -n openshift-local-storage describe localvolumeset localblock

   出力例:

   [...]
   Status:
     Conditions:
       Last Transition Time:          2020-11-17T05:03:32Z
       Message:                       DiskMaker: Available, LocalProvisioner: Available
       Status:                        True
       Type:                          DaemonSetsAvailable
       Last Transition Time:          2020-11-17T05:03:34Z
       Message:                       Operator reconciled successfully.
       Status:                        True
       Type:                          Available
     Observed Generation:             1
     Total Provisioned Device Count: 4
   Events:
   Type    Reason      Age          From                Message
   ----    ------      ----         ----                -------
   Normal  Discovered  2m30s (x4    localvolumeset-     node.example.com -
           NewDevice   over 2m30s)  symlink-controller  found possible
                                                        matching disk,
                                                        waiting 1m to claim
   
   Normal  FoundMatch  89s (x4      localvolumeset-     node.example.com -
           ingDisk     over 89s)    symlink-controller  symlinking matching
                                                        disk

   PV がプロビジョニングされると、新規 OSD Pod が PV 用に自動的に作成されます。

3. ocs-osd-removal ジョブを削除します。

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

   出力例:

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

検証手順

1. 新しい OSD が実行されていることを確認します。

   $ oc get -n openshift-storage pods -l app=rook-ceph-osd

   出力例:

   rook-ceph-osd-0-5f7f4747d4-snshw    1/1     Running     0          4m47s
   rook-ceph-osd-1-85d99fb95f-2svc7    1/1     Running     0          1d20h
   rook-ceph-osd-2-6c66cdb977-jp542    1/1     Running     0          1d20h

   重要

   数分後に新規 OSD が Running と表示されない場合は、rook-ceph-operator Pod を再起動して強制的に調整を行います。

   $ oc delete pod -n openshift-storage -l app=rook-ceph-operator

   出力例:

   pod "rook-ceph-operator-6f74fb5bff-2d982" deleted

2. 新規 PVC が作成されていることを確認します。

   $ oc get -n openshift-storage pvc | grep localblock

   出力例:

   ocs-deviceset-0-0-c2mqb   Bound    local-pv-b481410         1490Gi     RWO            localblock                    5m
   ocs-deviceset-1-0-959rp   Bound    local-pv-414755e0        1490Gi     RWO            localblock                    1d20h
   ocs-deviceset-2-0-79j94   Bound    local-pv-3e8964d3        1490Gi     RWO            localblock                    1d20h

3. (オプション) クラスターでクラスター全体の暗号化が有効な場合には、新規 OSD デバイスが暗号化されていることを確認します。

   1. 新規 OSD Pod が実行しているノードを特定します。

      $ oc get -o=custom-columns=NODE:.spec.nodeName pod/<OSD pod name>

      <OSD pod name>

      OSD Pod の名前です。

      以下に例を示します。

      oc get -o=custom-columns=NODE:.spec.nodeName pod/rook-ceph-osd-0-544db49d7f-qrgqm

   2. 直前の手順で特定された各ノードに以下を実行します。

      1. デバッグ Pod を作成し、選択したホストの chroot 環境を開きます。

         $ oc debug node/<node name>

         <node name>

         ノードの名前。

         $ chroot /host

      2. ocs-deviceset 名の横にある crypt キーワードを確認します。

         $ lsblk

4. OpenShift Web コンソールにログインし、ストレージダッシュボードで OSD のステータスを確認します。