5.4. Logical Volume Manager 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

      Copy to Clipboard Toggle word wrap

   2. Namespace CR を作成します。

      $ oc create -f lvms-namespace.yaml

      Copy to Clipboard Toggle word wrap

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

      Copy to Clipboard Toggle word wrap

   2. OperatorGroup CR を作成します。

      $ oc create -f lvms-operatorgroup.yaml

      Copy to Clipboard Toggle word wrap

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

      Copy to Clipboard Toggle word wrap

   2. Subscription CR を作成します。

      $ oc create -f lvms-sub.yaml

      Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

   出力例

   Name                         Phase
   4.13.0-202301261535          Succeeded

   Copy to Clipboard Toggle word wrap

手順

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

   Copy to Clipboard Toggle word wrap

   出力例

   currentCSV: lvms-operator.v4.15.3

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

   出力例

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

   Copy to Clipboard Toggle word wrap

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

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

   1

   Copy to Clipboard Toggle word wrap

   1

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

   出力例

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

   Copy to Clipboard Toggle word wrap

手順

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: {}

   Copy to Clipboard Toggle word wrap

   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

   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
                        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

   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 CR が存在することを確認します。

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

3. openshift-storage namespace で、次のコマンドを実行して、すべての LVM ストレージ Pod が 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

   このコマンドの出力には、以下の 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

     Copy to Clipboard Toggle word wrap

手順

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

   $ oc describe pvc <pvc_name> 

   1

   Copy to Clipboard Toggle word wrap

   1

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

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

手順

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

   $ oc project openshift-storage

   Copy to Clipboard Toggle word wrap

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

   $ oc get logicalvolume

   Copy to Clipboard Toggle word wrap

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

      $ oc delete logicalvolume <name> 

      1

      Copy to Clipboard Toggle word wrap

      1

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

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

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

      1

      Copy to Clipboard Toggle word wrap

      1

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

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

   $ oc get lvmvolumegroup

   Copy to Clipboard Toggle word wrap

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

      $ oc delete lvmvolumegroup <name> 

      1

      Copy to Clipboard Toggle word wrap

      1

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

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

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

      1

      Copy to Clipboard Toggle word wrap

      1

      <name> を LVMVolumeGroup 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

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

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

      1

      Copy to Clipboard Toggle word wrap

      1

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