5.4. Logical Volume Manager Storage を使用した永続ストレージ

手順

1. OpenShift Container Platform Web コンソールにログインします。
2. Operators OperatorHub をクリックします。
3. スクロールするか、LVM Storage を Filter by keyword ボックスに入力して、LVM Storage を見つけます。
4. Install をクリックします。

5. Install Operator ページで、以下のオプションを設定します。

   1. stable-4.12 としての Update Channel。
   2. クラスター上の特定の namespace としての Installation Mode。
   3. Installed Namespace を Operator recommended namespace openshift-storage に設定します。openshift-storage namespace が存在しない場合は、Operator のインストール中に作成されます。

   4. Approval Strategy を Automatic または Manual に設定します。

      Automatic (自動) 更新を選択すると、Operator Lifecycle Manager (OLM) は介入なしに、Operator の実行中のインスタンスを自動的にアップグレードします。

      Manual 更新を選択すると、OLM は更新要求を作成します。クラスター管理者は、Operator を新しいバージョンに更新できるように更新要求を手動で承認する必要があります。

6. Install をクリックします。

手順

1. OpenShift Container Platform の認証情報を使用して RHACM CLI にログインします。

2. ポリシーを作成する namespace を作成します。

   # oc create ns lvms-policy-ns

   Copy to Clipboard Toggle word wrap

3. ポリシーを作成するには、次の YAML を policy-lvms-operator.yaml などの名前でファイルに保存します。

   apiVersion: apps.open-cluster-management.io/v1
   kind: PlacementRule
   metadata:
     name: placement-install-lvms
   spec:
     clusterConditions:
     - status: "True"
       type: ManagedClusterConditionAvailable
     clusterSelector: 

   1

   
       matchExpressions:
       - key: mykey
         operator: In
         values:
         - myvalue
   ---
   apiVersion: policy.open-cluster-management.io/v1
   kind: PlacementBinding
   metadata:
     name: binding-install-lvms
   placementRef:
     apiGroup: apps.open-cluster-management.io
     kind: PlacementRule
     name: placement-install-lvms
   subjects:
   - apiGroup: policy.open-cluster-management.io
     kind: Policy
     name: install-lvms
   ---
   apiVersion: policy.open-cluster-management.io/v1
   kind: Policy
   metadata:
     annotations:
       policy.open-cluster-management.io/categories: CM Configuration Management
       policy.open-cluster-management.io/controls: CM-2 Baseline Configuration
       policy.open-cluster-management.io/standards: NIST SP 800-53
     name: install-lvms
   spec:
     disabled: false
     remediationAction: enforce
     policy-templates:
     - objectDefinition:
         apiVersion: policy.open-cluster-management.io/v1
         kind: ConfigurationPolicy
         metadata:
           name: install-lvms
         spec:
           object-templates:
           - complianceType: musthave
             objectDefinition:
               apiVersion: v1
               kind: Namespace
               metadata:
                 labels:
                   openshift.io/cluster-monitoring: "true"
                   pod-security.kubernetes.io/enforce: privileged
                   pod-security.kubernetes.io/audit: privileged
                   pod-security.kubernetes.io/warn: privileged
                 name: openshift-storage
           - complianceType: musthave
             objectDefinition:
               apiVersion: operators.coreos.com/v1
               kind: OperatorGroup
               metadata:
                 name: openshift-storage-operatorgroup
                 namespace: openshift-storage
               spec:
                 targetNamespaces:
                 - openshift-storage
           - complianceType: musthave
             objectDefinition:
               apiVersion: operators.coreos.com/v1alpha1
               kind: Subscription
               metadata:
                 name: lvms
                 namespace: openshift-storage
               spec:
                 installPlanApproval: Automatic
                 name: lvms-operator
                 source: redhat-operators
                 sourceNamespace: openshift-marketplace
           remediationAction: enforce
           severity: low
     - objectDefinition:
         apiVersion: policy.open-cluster-management.io/v1
         kind: ConfigurationPolicy
         metadata:
           name: lvms
         spec:
           object-templates:
              - complianceType: musthave
                objectDefinition:
                  apiVersion: lvm.topolvm.io/v1alpha1
                  kind: LVMCluster
                  metadata:
                    name: my-lvmcluster
                    namespace: openshift-storage
                  spec:
                    storage:
                      deviceClasses:
                      - name: vg1
                        deviceSelector: 

   2

   
                          paths:
                          - /dev/disk/by-path/pci-0000:87:00.0-nvme-1
                          - /dev/disk/by-path/pci-0000:88:00.0-nvme-1
                        thinPoolConfig:
                          name: thin-pool-1
                          sizePercent: 90
                          overprovisionRatio: 10
                        nodeSelector: 

   3

   
                          nodeSelectorTerms:
                          - matchExpressions:
                              - key: app
                                operator: In
                                values:
                                - test1
           remediationAction: enforce
           severity: low

   Copy to Clipboard Toggle word wrap

   1

   LVM ストレージをインストールするシングルノード OpenShift クラスターに設定されたラベルと一致するように、PlacementRule.spec.clusterSelector のキーと値を置き換えます。

   2

   ボリュームグループを優先ディスクに制御または制限するには、LVMCluster YAML の deviceSelector セクションでディスクのローカルパスを手動で指定します。

   3

   追加のワーカーノードのサブセットであるノードフィルターを追加するには、nodeSelector セクションに必要なフィルターを指定します。LVM Storage は、新しいノードが表示されると、追加のワーカーノードを検出して使用します。

   重要

   この nodeSelector ノードフィルターの一致は、Pod ラベルの一致と同じではありません。

4. 次のコマンドを実行して、namespace にポリシーを作成します。

   # oc create -f policy-lvms-operator.yaml -n lvms-policy-ns 

   1

   Copy to Clipboard Toggle word wrap

   1

   policy-lvms-operator.yaml は、ポリシーが保存されるファイルの名前です。

   これにより、lvms-policy-ns namespace に Policy、PlacementRule、および PlacementBinding オブジェクトが作成されます。このポリシーは、配置ルールに一致するクラスター上に Namespace、OperatorGroup、Subscription、および LVMCluster リソースを作成します。これにより、選択基準に一致するシングルノード OpenShift クラスターに Operator がデプロイされ、ストレージをプロビジョニングするために必要なリソースをセットアップするように設定されます。Operator は LVMCluster CR で指定されたすべてのディスクを使用します。ディスクが指定されていない場合、Operator はシングルノード OpenShift ノード上の未使用のディスクをすべて使用します。

   重要

   LVMCluster に追加されたデバイスは削除できません。

1. 理論的サイズ。
2. テスト済みサイズ。

手順

1. oc コマンドを実行する必要があるシングルノード OpenShift にログインします。

2. 次の YAML を lvms-vol-snapshot.yaml などの名前でファイルに保存します。

   ボリュームスナップショットを作成する YAML の例

   apiVersion: snapshot.storage.k8s.io/v1
   kind: VolumeSnapshot
   metadata:
       name: lvm-block-1-snap
   spec:
       volumeSnapshotClassName: lvms-vg1
       source:
           persistentVolumeClaimName: lvm-block-1

   Copy to Clipboard Toggle word wrap

3. PVC と同じ namespace で次のコマンドを実行して、スナップショットを作成します。

   # oc create -f lvms-vol-snapshot.yaml

   Copy to Clipboard Toggle word wrap

手順

1. ソース PVC のストレージクラス名とボリュームスナップショット名を特定します。

2. 次の YAML を lvms-vol-restore.yaml などの名前でファイルに保存して、スナップショットを復元します。

   PVC を復元する YAML の例。

   kind: PersistentVolumeClaim
   apiVersion: v1
   metadata:
     name: lvm-block-1-restore
   spec:
     accessModes:
     - ReadWriteOnce
     volumeMode: Block
     Resources:
       Requests:
         storage: 2Gi
     storageClassName: lvms-vg1
     dataSource:
       name: lvm-block-1-snap
       kind: VolumeSnapshot
       apiGroup: snapshot.storage.k8s.io

   Copy to Clipboard Toggle word wrap

3. スナップショットと同じ namespace で次のコマンドを実行して、ポリシーを作成します。

   # oc create -f lvms-vol-restore.yaml

   Copy to Clipboard Toggle word wrap

手順

1. 次のコマンドを実行して、ボリュームスナップショットリソースを削除します。

   # oc delete volumesnapshot <volume_snapshot_name> -n <namespace>

   Copy to Clipboard Toggle word wrap
   注記

   永続ボリューム要求 (PVC) を削除しても、PVC のスナップショットは削除されません。

2. 復元されたボリュームスナップショットを削除するには、次のコマンドを実行して、ボリュームスナップショットを復元するために作成された PVC を削除します。

   # oc delete pvc <pvc_name> -n <namespace>

   Copy to Clipboard Toggle word wrap

手順

1. ソース PVC のストレージクラスを特定します。

2. ボリュームクローンを作成するには、次の YAML を lvms-vol-clone.yaml などの名前でファイルに保存します。

   ボリュームをクローン作成する YAML の例

   apiVersion: v1
   kind: PersistentVolumeClaim
   Metadata:
     name: lvm-block-1-clone
   Spec:
     storageClassName: lvms-vg1
     dataSource:
       name: lvm-block-1
       kind: PersistentVolumeClaim
     accessModes:
      - ReadWriteOnce
     volumeMode: Block
     Resources:
       Requests:
         storage: 2Gi

   Copy to Clipboard Toggle word wrap

3. 次のコマンドを実行して、ソース PVC と同じ namespace にポリシーを作成します。

   # oc create -f lvms-vol-clone.yaml

   Copy to Clipboard Toggle word wrap

手順

1. 次のコマンドを実行して、PVC のリストを取得します。

   $ oc get pvc

   Copy to Clipboard Toggle word wrap

   出力例

   NAME        STATUS    VOLUME   CAPACITY   ACCESS MODES   STORAGECLASS   AGE
   lvms-test   Pending                                      lvms-vg1       11s

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを実行して、Pending 状態のままになっている PVC に関連するイベントを検査します。

   $ oc describe pvc <pvc_name> 

   1

   Copy to Clipboard Toggle word wrap

   1

   <pvc_name> を PVC の名前に置き換えます。たとえば、lvms-vg1 です。

   出力例

   Type     Reason              Age               From                         Message
   ----     ------              ----              ----                         -------
   Warning  ProvisioningFailed  4s (x2 over 17s)  persistentvolume-controller  storageclass.storage.k8s.io "lvms-vg1" not found

   Copy to Clipboard Toggle word wrap

手順

1. 次のコマンドを実行して、LVMCluster リソースの存在を確認します。

   $ oc get lvmcluster -n openshift-storage

   Copy to Clipboard Toggle word wrap

   出力例

   NAME            AGE
   my-lvmcluster   65m

   Copy to Clipboard Toggle word wrap

2. クラスターに LVMCluster リソースがない場合は、次のコマンドを実行して LVMCluster リソースを作成します。

   $ oc create -n openshift-storage -f <custom_resource> 

   1

   Copy to Clipboard Toggle word wrap

   1

   <custom_resource> を、要件に合わせたカスタムリソース URL またはファイルに置き換えます。

   カスタムリソースの例

   apiVersion: lvm.topolvm.io/v1alpha1
   kind: LVMCluster
   metadata:
     name: my-lvmcluster
   spec:
     storage:
       deviceClasses:
       - name: vg1
         default: true
         thinPoolConfig:
           name: thin-pool-1
           sizePercent: 90
           overprovisionRatio: 10

   Copy to Clipboard Toggle word wrap

3. 次のコマンドを実行して、LVMS のすべての Pod が openshift-storage namespace で Running 状態であることを確認します。

   $ oc get pods -n openshift-storage

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                                  READY   STATUS    RESTARTS      AGE
   lvms-operator-7b9fb858cb-6nsml        3/3     Running   0             70m
   topolvm-controller-5dd9cf78b5-7wwr2   5/5     Running   0             66m
   topolvm-node-dr26h                    4/4     Running   0             66m
   vg-manager-r6zdv                      1/1     Running   0             66m

   Copy to Clipboard Toggle word wrap

   予期される出力は、lvms-operator および vg-manager の 1 つの実行インスタンスです。各ノードには、topolvm-controller および topolvm-node のインスタンスが 1 つ必要です。

   topolvm-node が Init 状態でスタックしている場合は、LVMS が使用できるディスクを見つけることができません。トラブルシューティングに必要な情報を取得するには、次のコマンドを実行して vg-manager Pod のログを確認します。

   $ oc logs -l app.kubernetes.io/component=vg-manager -n openshift-storage

   Copy to Clipboard Toggle word wrap

手順

1. 次のコマンドを実行して、PVC に関連付けられたイベントを検査します。

   $ oc describe pvc <pvc_name> 

   1

   Copy to Clipboard Toggle word wrap

   1

   <pvc_name> を PVC の名前に置き換えます。ディスクまたはボリューム障害のエラーメッセージとその原因の例をいくつか示します。

   • ボリュームの存在を確認できない: ボリュームがすでに存在するかどうかの確認で問題が発生したことを示します。ボリューム検証の失敗は、ネットワーク接続の問題やその他の障害によって発生する可能性があります。
   • バインドボリュームへの失敗: 利用可能な永続ボリューム (PV) が PVC の要件と一致しない場合、ボリュームのバインドに失敗する可能性があります。
   • FailedMount または FailedUnMount: このエラーは、ボリュームをノードにマウントしようとしたとき、またはノードからボリュームをアンマウントしようとしたときの問題を示します。ディスクに障害が発生した場合、Pod が PVC を使用しようとしたときにこのエラーが表示されることがあります。
   • ボリュームはすでに 1 つのノードに排他的に接続されており、別のノードには接続できない: このエラーは、ReadWriteMany アクセスモードをサポートしていないストレージソリューションで発生する可能性があります。

2. 問題が発生しているホストへの直接接続を確立します。
3. ディスクの問題を解決します。

前提条件

1. 論理ボリュームマネージャーストレージ (LVMS) ドライバーを使用して作成された永続ボリュームクレーム (PVC) はすべて削除されました。
2. これらの PVC を使用する Pod は停止されました。

手順

1. 次のコマンドを実行して、openshift-storage namespace に切り替えます。

   $ oc project openshift-storage

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを実行して、Logical Volume のカスタムリソース (CR) が残っていないことを確認します。

   $ oc get logicalvolume

   Copy to Clipboard Toggle word wrap

   出力例

   No resources found

   Copy to Clipboard Toggle word wrap

   1. LogicalVolume CR が残っている場合は、次のコマンドを実行してファイナライザーを削除します。

      $ oc patch logicalvolume <name> -p '{"metadata":{"finalizers":[]}}' --type=merge 

      1

      Copy to Clipboard Toggle word wrap

      1

      <name> を CR の名前に置き換えます。

   2. ファイナライザーを削除した後、次のコマンドを実行して CR を削除します。

      $ oc delete logicalvolume <name> 

      1

      Copy to Clipboard Toggle word wrap

      1

      <name> を CR の名前に置き換えます。

3. 次のコマンドを実行して、LVMVolumeGroup CR が残っていないことを確認します。

   $ oc get lvmvolumegroup

   Copy to Clipboard Toggle word wrap

   出力例

   No resources found

   Copy to Clipboard Toggle word wrap

   1. LVMVolumeGroup CR が残っている場合は、次のコマンドを実行してファイナライザーを削除します。

      $ oc patch lvmvolumegroup <name> -p '{"metadata":{"finalizers":[]}}' --type=merge 

      1

      Copy to Clipboard Toggle word wrap

      1

      <name> を CR の名前に置き換えます。

   2. ファイナライザーを削除した後、次のコマンドを実行して CR を削除します。

      $ oc delete lvmvolumegroup <name> 

      1

      Copy to Clipboard Toggle word wrap

      1

      <name> を CR の名前に置き換えます。

4. 次のコマンドを実行して、LVMVolumeGroupNodeStatus CR を削除します。

   $ oc delete lvmvolumegroupnodestatus --all

   Copy to Clipboard Toggle word wrap

5. 次のコマンドを実行して、LVMCluster CR を削除します。

   $ oc delete lvmcluster --all

   Copy to Clipboard Toggle word wrap