4.12. ローカルストレージを使用した永続ストレージ

手順

1. 以前に作成したローカルボリュームを編集して、不要なディスクを削除します。

   1. クラスターリソースを編集します。

      $ oc edit localvolume <name> -n openshift-local-storage

   2. devicePaths の下の行に移動し、不要なディスクを表すものを削除します。

2. 作成した永続ボリュームを削除します。

   $ oc delete pv <pv-name>

3. ノード上のディレクトリーと含まれるシンボリックリンクを削除します。

   警告

   以下の手順では、root ユーザーとしてノードにアクセスする必要があります。この手順のステップ以外にノードの状態を変更すると、クラスターが不安定になる可能性があります。

   $ oc debug node/<node-name> -- chroot /host rm -rf /mnt/local-storage/<sc-name> 1

   1

   ローカルボリュームの作成に使用されるストレージクラスの名前。

手順

1. プロジェクトにインストールされているローカルボリュームリソースを削除します (localvolume、localvolumeset、localvolumediscovery等)。

   $ oc delete localvolume --all --all-namespaces
   $ oc delete localvolumeset --all --all-namespaces
   $ oc delete localvolumediscovery --all --all-namespaces

2. Web コンソールからローカルストレージ Operator をアンインストールします。

   1. OpenShift Container Platform Web コンソールにログインします。
   2. Operators Installed Operators に移動します。
   3. Local Storage をフィルターボックスに入力して、ローカルストレージ Operator を見つけます。
   4. ローカルストレージ Operator の末尾にある Options メニュー をクリックします。
   5. Uninstall Operator をクリックします。
   6. 表示されるウィンドウで Remove をクリックします。

3. ローカルストレージ Operator で作成された PV は削除されるまでクラスターに残ります。これらのボリュームが使用されなくなったら、以下のコマンドを実行してこれらのボリュームを削除します。

   $ oc delete pv <pv-name>

4. openshift-local-storage プロジェクトを削除します。

   $ oc delete project openshift-local-storage

手順

1. LVM Storage Operator の namespace を作成します。

   1. 次の YAML を lvms-namespace.yaml ファイルに保存します。

      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

   2. namespace CR を作成します。

      $ oc create -f lvms-namespace.yaml

2. LVM Storage Operator の Operator グループを作成します。

   1. 次の YAML を lvms-operatorgroup.yaml ファイルに保存します。

      apiVersion: operators.coreos.com/v1
      kind: OperatorGroup
      metadata:
        name: openshift-storage-operatorgroup
        namespace: openshift-storage
      spec:
        targetNamespaces:
        - openshift-storage

   2. OperatorGroup CR を作成します。

      $ oc create -f lvms-operatorgroup.yaml

3. LVM Storage Operator にサブスクライブします。

   1. 次の YAML を lvms-sub.yaml ファイルに保存します。

      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

   2. Subscription CR を作成します。

      $ oc create -f lvms-sub.yaml

4. Operator がインストールされていることを確認するには、以下のコマンドを入力します。

   $ oc get csv -n openshift-storage -o custom-columns=Name:.metadata.name,Phase:.status.phase

   出力例

   Name                         Phase
   4.13.0-202301261535          Succeeded

手順

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

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

   1. Channel を stable-4.13 として更新します。
   2. Installation Mode を A specific namespace on the cluster に設定します。
   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. 次のコマンドを実行して、LVM Storage Operator の currentCSV の値を取得します。

   $ oc get subscription.operators.coreos.com lvms-operator -n <namespace> -o yaml | grep currentCSV

   出力例

   currentCSV: lvms-operator.v4.15.3

2. 次のコマンドを実行して、サブスクリプションを削除します。

   $ oc delete subscription.operators.coreos.com lvms-operator -n <namespace>

   出力例

   subscription.operators.coreos.com "lvms-operator" deleted

3. 次のコマンドを実行して、ターゲット namespace 内の LVM Storage Operator の CSV を削除します。

   $ oc delete clusterserviceversion <currentCSV> -n <namespace> 1

   1

   <currentCSV> は、LVM Storage Operator の currentCSV 値に置き換えます。

   出力例

   clusterserviceversion.operators.coreos.com "lvms-operator.v4.15.3" deleted

手順

1. Operators Installed Operators ページから、LVM Storage にスクロールするか、LVM Storage を Filter by name に入力して検索し、クリックします。
2. LVMCluster タブをクリックします。
3. LVMCluster ページの右側で、Actions ドロップダウンメニューから Delete LVMCluster を選択します。
4. Details タブをクリックします。
5. Operator Details ページの右側で、Actions ドロップダウンメニューから Uninstall Operator を選択します。
6. Remove を選択します。LVM Storage は実行を停止し、完全に削除されます。

手順

1. イメージセット設定の作成 手順の手順に従います。LVM Storage の ImageSetConfiguration リソースを作成するには、次のサンプル YAML ファイルを使用できます。

   LVM Storage 用の ImageSetConfiguration ファイルの例

   kind: ImageSetConfiguration
   apiVersion: mirror.openshift.io/v1alpha2
   archiveSize: 4 1
   storageConfig: 2
     registry:
       imageURL: example.com/mirror/oc-mirror-metadata 3
       skipTLS: false
   mirror:
     platform:
       channels:
       - name: stable-4.13 4
         type: ocp
       graph: true 5
     operators:
     - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.13 6
       packages:
       - name: lvms-operator 7
         channels:
         - name: stable 8
     additionalImages:
     - name: registry.redhat.io/ubi9/ubi:latest 9
     helm: {}

   1

   archiveSize を追加して、イメージセット内の各ファイルの最大サイズを GiB 単位で設定します。

   2

   イメージセットのメタデータを保存するバックエンドの場所を設定します。この場所は、レジストリーまたはローカルディレクトリーにすることができます。Technology Preview OCI 機能を使用していない場合は、storageConfig 値を指定する必要があります。

   3

   ストレージバックエンドのレジストリー URL を設定します。

   4

   OpenShift Container Platform イメージを取得するためのチャネルを設定します。

   5

   graph: true を追加して OpenShift Update Service (OSUS) グラフイメージを生成し、Web コンソールを使用する際のクラスター更新エクスペリエンスを向上させます。詳細については、OpenShift Update Service について を参照してください。

   6

   OpenShift Container Platform イメージを取得するための Operator カタログを設定します。

   7

   イメージセットに含める特定の Operator パッケージのみを指定します。カタログ内のすべてのパッケージを取得するには、このフィールドを削除してください。

   8

   イメージセットに含める Operator パッケージの特定のチャネルのみを指定します。そのチャネルでバンドルを使用しない場合も、常に Operator パッケージのデフォルトチャネルを含める必要があります。oc mirror list operators --catalog=<catalog_name> --package=<package_name> コマンドを実行すると、デフォルトチャネルを見つけることができます。

   9

   イメージセットに含める追加のイメージを指定します。

2. Mirroring an image set to a mirror registry セクションの手順に従います。
3. Configuring image registry repository mirroring セクションの手順に従います。

手順

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

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

   # oc create ns lvms-policy-ns

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
                        default: true
                        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

   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

   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. LVM Storage によってプロビジョニングされたすべての永続ボリューム要求 (PVC) とボリュームスナップショットを削除します。
2. LVMCluster リソースを削除して、ディスク上に作成された論理ボリュームマネージャーリソースをクリーンアップします。
3. Operator をアンインストールする追加のポリシーを作成します。

手順

1. OpenShift CLI (oc) で、次のコマンドを使用して、ハブクラスターに LVM Storage をデプロイおよび設定するために作成した RHACM ポリシーを削除します。

   # oc delete -f policy-lvms-operator.yaml -n lvms-policy-ns 1

   1

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

2. LVMCluster リソースを削除するためのポリシーを作成するには、次の YAML を lvms-remove-policy.yaml などの名前でファイルに保存します。これにより、Operator はクラスター上で作成したすべての論理ボリュームマネージャーリソースをクリーンアップできます。

   apiVersion: policy.open-cluster-management.io/v1
   kind: Policy
   metadata:
     name: policy-lvmcluster-delete
     annotations:
       policy.open-cluster-management.io/standards: NIST SP 800-53
       policy.open-cluster-management.io/categories: CM Configuration Management
       policy.open-cluster-management.io/controls: CM-2 Baseline Configuration
   spec:
     remediationAction: enforce
     disabled: false
     policy-templates:
       - objectDefinition:
           apiVersion: policy.open-cluster-management.io/v1
           kind: ConfigurationPolicy
           metadata:
             name: policy-lvmcluster-removal
           spec:
             remediationAction: enforce 1
             severity: low
             object-templates:
               - complianceType: mustnothave
                 objectDefinition:
                   kind: LVMCluster
                   apiVersion: lvm.topolvm.io/v1alpha1
                   metadata:
                     name: my-lvmcluster
                     namespace: openshift-storage 2
   ---
   apiVersion: policy.open-cluster-management.io/v1
   kind: PlacementBinding
   metadata:
     name: binding-policy-lvmcluster-delete
   placementRef:
     apiGroup: apps.open-cluster-management.io
     kind: PlacementRule
     name: placement-policy-lvmcluster-delete
   subjects:
     - apiGroup: policy.open-cluster-management.io
       kind: Policy
       name: policy-lvmcluster-delete
   ---
   apiVersion: apps.open-cluster-management.io/v1
   kind: PlacementRule
   metadata:
     name: placement-policy-lvmcluster-delete
   spec:
     clusterConditions:
       - status: "True"
         type: ManagedClusterConditionAvailable
     clusterSelector:
       matchExpressions:
         - key: mykey
           operator: In
           values:
             - myvalue

   1

   policy-template の spec.remediationAction は、spec.remediationAction の前のパラメーター値によってオーバーライドされます。

   2

   この namespace フィールドには openshift-storage 値が必要です。

3. PlacementRule.spec.clusterSelector フィールドの値を設定して、LVM Storage をアンインストールするクラスターを選択します。

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

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

5. LVMCluster CR が削除されたかどうかを確認するポリシーを作成するには、次の YAML を check-lvms-remove-policy.yaml などの名前でファイルに保存します。

   apiVersion: policy.open-cluster-management.io/v1
   kind: Policy
   metadata:
     name: policy-lvmcluster-inform
     annotations:
       policy.open-cluster-management.io/standards: NIST SP 800-53
       policy.open-cluster-management.io/categories: CM Configuration Management
       policy.open-cluster-management.io/controls: CM-2 Baseline Configuration
   spec:
     remediationAction: inform
     disabled: false
     policy-templates:
       - objectDefinition:
           apiVersion: policy.open-cluster-management.io/v1
           kind: ConfigurationPolicy
           metadata:
             name: policy-lvmcluster-removal-inform
           spec:
             remediationAction: inform 1
             severity: low
             object-templates:
               - complianceType: mustnothave
                 objectDefinition:
                   kind: LVMCluster
                   apiVersion: lvm.topolvm.io/v1alpha1
                   metadata:
                     name: my-lvmcluster
                     namespace: openshift-storage 2
   ---
   apiVersion: policy.open-cluster-management.io/v1
   kind: PlacementBinding
   metadata:
     name: binding-policy-lvmcluster-check
   placementRef:
     apiGroup: apps.open-cluster-management.io
     kind: PlacementRule
     name: placement-policy-lvmcluster-check
   subjects:
     - apiGroup: policy.open-cluster-management.io
       kind: Policy
       name: policy-lvmcluster-inform
   ---
   apiVersion: apps.open-cluster-management.io/v1
   kind: PlacementRule
   metadata:
     name: placement-policy-lvmcluster-check
   spec:
     clusterConditions:
       - status: "True"
         type: ManagedClusterConditionAvailable
     clusterSelector:
       matchExpressions:
         - key: mykey
           operator: In
           values:
             - myvalue

   1

   policy-template の spec.remediationAction は、spec.remediationAction の前のパラメーター値によってオーバーライドされます。

   2

   namespace フィールドには openshift-storage 値が必要です。

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

   # oc create -f check-lvms-remove-policy.yaml -n lvms-policy-ns

7. 次のコマンドを実行して、ポリシーのステータスを確認します。

   # oc get policy -n lvms-policy-ns

   出力例

   NAME                       REMEDIATION ACTION   COMPLIANCE STATE   AGE
   policy-lvmcluster-delete   enforce              Compliant          15m
   policy-lvmcluster-inform   inform               Compliant          15m

8. 両方のポリシーに準拠したら、次の YAML を lvms-uninstall-policy.yaml などの名前のファイルに保存して、LVM Storage をアンインストールするポリシーを作成します。

   apiVersion: apps.open-cluster-management.io/v1
   kind: PlacementRule
   metadata:
     name: placement-uninstall-lvms
   spec:
     clusterConditions:
     - status: "True"
       type: ManagedClusterConditionAvailable
     clusterSelector:
       matchExpressions:
       - key: mykey
         operator: In
         values:
         - myvalue
   ---
   apiVersion: policy.open-cluster-management.io/v1
   kind: PlacementBinding
   metadata:
     name: binding-uninstall-lvms
   placementRef:
     apiGroup: apps.open-cluster-management.io
     kind: PlacementRule
     name: placement-uninstall-lvms
   subjects:
   - apiGroup: policy.open-cluster-management.io
     kind: Policy
     name: uninstall-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: uninstall-lvms
   spec:
     disabled: false
     policy-templates:
     - objectDefinition:
         apiVersion: policy.open-cluster-management.io/v1
         kind: ConfigurationPolicy
         metadata:
           name: uninstall-lvms
         spec:
           object-templates:
           - complianceType: mustnothave
             objectDefinition:
               apiVersion: v1
               kind: Namespace
               metadata:
                 name: openshift-storage
           - complianceType: mustnothave
             objectDefinition:
               apiVersion: operators.coreos.com/v1
               kind: OperatorGroup
               metadata:
                 name: openshift-storage-operatorgroup
                 namespace: openshift-storage
               spec:
                 targetNamespaces:
                 - openshift-storage
           - complianceType: mustnothave
             objectDefinition:
               apiVersion: operators.coreos.com/v1alpha1
               kind: Subscription
               metadata:
                 name: lvms-operator
                 namespace: openshift-storage
           remediationAction: enforce
           severity: low
     - objectDefinition:
         apiVersion: policy.open-cluster-management.io/v1
         kind: ConfigurationPolicy
         metadata:
           name: policy-remove-lvms-crds
         spec:
           object-templates:
           - complianceType: mustnothave
             objectDefinition:
               apiVersion: apiextensions.k8s.io/v1
               kind: CustomResourceDefinition
               metadata:
                 name: logicalvolumes.topolvm.io
           - complianceType: mustnothave
             objectDefinition:
               apiVersion: apiextensions.k8s.io/v1
               kind: CustomResourceDefinition
               metadata:
                 name: lvmclusters.lvm.topolvm.io
           - complianceType: mustnothave
             objectDefinition:
               apiVersion: apiextensions.k8s.io/v1
               kind: CustomResourceDefinition
               metadata:
                 name: lvmvolumegroupnodestatuses.lvm.topolvm.io
           - complianceType: mustnothave
             objectDefinition:
               apiVersion: apiextensions.k8s.io/v1
               kind: CustomResourceDefinition
               metadata:
                 name: lvmvolumegroups.lvm.topolvm.io
           remediationAction: enforce
           severity: high

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

   # oc create -f lvms-uninstall-policy.yaml -ns lvms-policy-ns

手順

1. シングルノード OpenShift クラスターの OpenShift Container Platform コンソールにログインします。
2. Operators Installed Operators ページで、openshift-storage namespace の LVM Storage Operator をクリックします。
3. LVMCluster タブをクリックして、クラスターで作成された LVMCluster CR を一覧表示します。
4. Actions ドロップダウンメニューから Edit LVMCluster を選択します。
5. YAML タブをクリックします。

6. LVMCluster CR YAML を編集して、deviceSelector セクションに新しいデバイスパスを追加します。

   注記

   LVMCluster の作成中に deviceSelector フィールドが含まれていない場合、deviceSelector セクションを CR に追加することはできません。LVMCluster を削除してから、新しい CR を作成する必要があります。

   apiVersion: lvm.topolvm.io/v1alpha1
   kind: LVMCluster
   metadata:
     name: my-lvmcluster
   spec:
     storage:
       deviceClasses:
       - name: vg1
         default: true
         deviceSelector:
           paths:
           - /dev/disk/by-path/pci-0000:87:00.0-nvme-1 1
           - /dev/disk/by-path/pci-0000:88:00.0-nvme-1
           - /dev/disk/by-path/pci-0000:89:00.0-nvme-1 2
         thinPoolConfig:
           name: thin-pool-1
           sizePercent: 90
           overprovisionRatio: 10

   1

   パスは、名前 (/dev/sdb) またはパスで追加できます。

   2

   新しいディスクが追加されます。

手順

1. OpenShift Container Platform の認証情報を使用して RHACM CLI にログインします。
2. 追加するディスクを見つけます。追加するディスクは、既存のディスクのデバイス名およびパスと一致するようにする必要があります。

3. シングルノード OpenShift クラスターに容量を追加するには、既存のポリシー YAML の deviceSelector セクション (policy-lvms-operator.yaml など) を編集します。

   注記

   LVMCluster の作成中に deviceSelector フィールドが含まれていない場合、deviceSelector セクションを CR に追加することはできません。LVMCluster を削除してから、新しい CR から再作成する必要があります。

   apiVersion: apps.open-cluster-management.io/v1
   kind: PlacementRule
   metadata:
     name: placement-install-lvms
   spec:
     clusterConditions:
     - status: "True"
       type: ManagedClusterConditionAvailable
     clusterSelector:
       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
                        default: true
                        deviceSelector:
                          paths:
                          - /dev/disk/by-path/pci-0000:87:00.0-nvme-1
                          - /dev/disk/by-path/pci-0000:88:00.0-nvme-1
                          - /dev/disk/by-path/pci-0000:89:00.0-nvme-1 # new disk is added
                        thinPoolConfig:
                          name: thin-pool-1
                          sizePercent: 90
                          overprovisionRatio: 10
                        nodeSelector:
                          nodeSelectorTerms:
                          - matchExpressions:
                              - key: app
                                operator: In
                                values:
                                - test1
           remediationAction: enforce
           severity: low

4. 以下のコマンドを実行してポリシーを編集します。

   # oc edit -f policy-lvms-operator.yaml -ns lvms-policy-ns 1

   1

   policy-lvms-operator.yaml は既存のポリシーの名前です。

   これは、LVMCluster CR で指定された新しいディスクを使用してストレージをプロビジョニングします。

手順

1. 次のコマンドを実行して、目的の PVC リソースの .spec.resources.requests.storage フィールドを新しいサイズに変更します。

   oc patch <pvc_name> -n <application_namespace> -p '{ "spec": { "resources": { "requests": { "storage": "<desired_size>" }}}}'

2. PVC の status.conditions フィールドを監視し、サイズ変更が完了したかどうかを確認します。OpenShift Container Platform は、拡張中に Resizing 条件を PVC に追加します。これは、拡張の完了後、削除されます。

手順

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

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

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

手順

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

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

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

手順

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

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

   注記

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

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

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

手順

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

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

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

手順

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

   $ oc get pvc

   出力例

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

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

   $ oc describe pvc <pvc_name> 1

   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

手順

1. 以下のコマンドを実行して、LVMCluster CR が存在することを確認します。

   $ oc get lvmcluster -n openshift-storage

   出力例

   NAME            AGE
   my-lvmcluster   65m

2. LVMCluster CR が存在しない場合は、LVMCluster CR を作成します。詳細は、シングルノード OpenShift ワーカーノードでの論理ボリュームマネージャークラスターの作成を参照してください。

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

   $ oc get pods -n openshift-storage

   出力例

   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

   このコマンドの出力には、以下の Pod の実行中のインスタンスが含まれている必要があります。

   • lvms-operator
   • vg-manager
   • topolvm-controller

   • topolvm-node

     topolvm-node Pod が Init 状態のままになっている場合は、LVM ストレージが使用できるディスクが見つからないことが原因です。この問題のトラブルシューティングに必要な情報を取得するには、以下のコマンドを実行して vg-manager Pod のログを確認します。

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

手順

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

   $ oc describe pvc <pvc_name> 1

   1

   <pvc_name> を PVC の名前に置き換えます。

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

手順

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

   $ oc project openshift-storage

2. 以下のコマンドを実行して、LogicalVolume カスタムリソース (CR) が存在するか確認します。

   $ oc get logicalvolume

   1. LogicalVolume CR が存在する場合は、以下のコマンドを実行して削除します。

      $ oc delete logicalvolume <name> 1

      1

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

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

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

      1

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

3. 以下のコマンドを実行して、LVMVolumeGroup CR が存在するか確認します。

   $ oc get lvmvolumegroup

   1. LVMVolumeGroup CR が存在する場合は、以下のコマンドを実行して削除します。

      $ oc delete lvmvolumegroup <name> 1

      1

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

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

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

      1

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

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

   $ oc delete lvmvolumegroupnodestatus --all

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

   $ oc delete lvmcluster --all

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

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

      1

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