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

1. いずれのソリューション (LVM Storage、LSO、HPP) もオブジェクトストレージをサポートしていません。したがって、オブジェクトストレージを使用する場合は、Red Hat OpenShift Data Foundation の MultiClusterGateway などの S3 オブジェクトストレージソリューションが必要です。どのソリューションも、S3 オブジェクトストレージソリューションの基盤となるストレージプロバイダーとして機能します。

1. 分離境界とは、ローカルストレージリソースを使用するさまざまなワークロードまたはアプリケーション間の分離レベルを指します。

1. どのソリューション (LVM Storage、LSO、HPP) にも、ReadWriteOnce (RWO) アクセスモードがあります。RWO アクセスモードでは、同じノード上の複数の Pod からのアクセスが可能になります。

手順

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. namespace を作成するための設定を含む YAML ファイルを作成します。

   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 を作成します。

   $ oc create -f <file_name>

3. OperatorGroup CR YAML ファイルを作成します。

   OperatorGroup CR の例

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

4. 以下のコマンドを実行して OperatorGroup CR を作成します。

   $ oc create -f <file_name>

5. Subscription CR YAML ファイルを作成します。

   Subscription CR の例

   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

6. 以下のコマンドを実行して Subscription CR を作成します。

   $ oc create -f <file_name>

検証

1. LVM Storage がインストールされていることを確認するには、次のコマンドを実行します。

   $ 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. OperatorHub ページで LVM Storage をクリックします。

4. Operator Installation ページで次のオプションを設定します。

   1. Update Channel を stable-4.16 に設定します。
   2. Installation Mode を A specific namespace on the cluster に設定します。
   3. Installed Namespace を Operator recommended namespace openshift-storage に設定します。openshift-storage namespace が存在しない場合は、Operator のインストール中に作成されます。

   4. Update approval で Automatic または Manual を選択します。

      注記

      Automatic (自動) 更新を選択すると、手動による介入なしで、Operator Lifecycle Manager (OLM) によって LVM Storage の実行中のインスタンスが自動的に更新されます。

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

5. オプション: Enable Operator recommended cluster monitoring on this Namespace チェックボックスを選択します。
6. Install をクリックします。

手順

1. 「イメージセット設定の作成」手順の手順に従います。LVM Storage の ImageSetConfiguration カスタムリソース (CR) を作成するには、次の ImageSetConfiguration CR 設定の例を使用できます。

   LVM Storage 用の ImageSetConfiguration CR の例

   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.16 4
         type: ocp
       graph: true 5
     operators:
     - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.16 6
       packages:
       - name: lvms-operator 7
         channels:
         - name: stable 8
     additionalImages:
     - name: registry.redhat.io/ubi9/ubi:latest 9
     helm: {}

   1

   イメージセット内の各ファイルの最大サイズ (GiB 単位) を設定します。

   2

   イメージセットを保存する場所を指定します。この場所は、レジストリーまたはローカルディレクトリーにすることができます。テクノロジープレビューの OCI 機能を使用している場合を除き、storageConfig フィールドを設定する必要があります。

   3

   レジストリーを使用する場合は、イメージストリームのストレージ URL を指定します。詳細は、イメージストリームを使用する理由 を参照してください。

   4

   OpenShift Container Platform イメージの取得元のチャネルを指定します。

   5

   OpenShift Update Service (OSUS) グラフイメージを生成するには、このフィールドを true に設定します。詳細は、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. 「イメージセットをミラーレジストリーにミラーリングする」セクションの手順に従います。
3. 「イメージレジストリーのリポジトリーミラーリングの設定」セクションの手順に従います。

手順

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

2. namespace を作成します。

   $ oc create ns <namespace>

3. Policy CR YAML ファイルを作成します。

   LVM Storage をインストールして設定するための Policy CR の例

   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: 2
               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: 3
               apiVersion: operators.coreos.com/v1
               kind: OperatorGroup
               metadata:
                 name: openshift-storage-operatorgroup
                 namespace: openshift-storage
               spec:
                 targetNamespaces:
                 - openshift-storage
           - complianceType: musthave
             objectDefinition: 4
               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

   1

   PlacementRule.spec.clusterSelector の key フィールドと values フィールドを、LVM Storage をインストールするクラスターに設定されているラベルと一致するように設定します。

   2

   namespace の設定。

   3

   OperatorGroup CR の設定。

   4

   Subscription CR の設定。

4. 次のコマンドを実行して Policy CR を作成します。

   $ oc create -f <file_name> -n <namespace>

   Policy CR を作成すると、PlacementRule CR で設定された選択基準に一致するクラスターに次のカスタムリソースが作成されます。

   • Namespace
   • OperatorGroup
   • Subscription

手順

1. LVMCluster CR YAML ファイルを開きます。

2. 次の例の説明に従って、LVMCluster CR のパラメーターを設定します。

   LVMCluster CR YAML ファイルの例

   apiVersion: lvm.topolvm.io/v1alpha1
   kind: LVMCluster
   metadata:
     name: my-lvmcluster
     namespace: openshift-storage
   spec:
   # ...
     storage:
       deviceClasses:
       - name: vg1  1
         fstype: ext4 2
         default: true
         deviceSelector: 3
   # ...
           forceWipeDevicesAndDestroyAllData: false 4
         thinPoolConfig: 5
   # ...
         nodeSelector: 6
   # ...

   1

   このフィールドは、以前の LVM Storage インストールの VG 名に設定します。

   2

   このフィールドは、ext4 または xfs に設定します。デフォルトでは、このフィールドは xfs に設定されています。

   3

   deviceSelector フィールドに新しいデバイスパスを指定すると、再利用する新しいデバイスを VG に追加できます。新しいデバイスを VG に追加する必要がない場合は、現在の LVM Storage インストールの deviceSelector 設定が以前の LVM Storage インストールの設定と同じであることを確認してください。

   4

   このフィールドを true に設定すると、LVM Storage が VG に追加されたデバイス上のすべてのデータをワイプします。

   5

   再利用する VG の thinPoolConfig 設定を保持するには、現在の LVM Storage インストールの thinPoolConfig 設定が以前の LVM Storage インストールの thinPoolConfig 設定と同じであることを確認してください。保持しない場合は、必要に応じて thinPoolConfig フィールドを設定できます。

   6

   LVM ボリュームグループを作成するノードを選択するための要件を設定します。このフィールドが空の場合、no-schedule テイントのないすべてのノードが考慮されます。

3. LVMCluster CR YAML ファイルを保存します。

手順

1. LVMCluster カスタムリソース (CR) YAML ファイルを作成します。

   LVMCluster CR YAML ファイルの例

   apiVersion: lvm.topolvm.io/v1alpha1
   kind: LVMCluster
   metadata:
     name: my-lvmcluster
     namespace: openshift-storage
   spec:
   # ...
     storage:
       deviceClasses: 1
   # ...
         nodeSelector: 2
   # ...
         deviceSelector: 3
   # ...
         thinPoolConfig: 4
   # ...

   1

   ローカルストレージデバイスを LVM ボリュームグループに割り当てるための設定を含めます。

   2

   LVM ボリュームグループを作成するノードを選択するための設定を含めます。このフィールドが空の場合、no-schedule テイントのないすべてのノードが考慮されます。

   3

   LVM ボリュームグループに追加するデバイスへのパスを指定し、LVM ボリュームグループに追加されたデバイスを強制的にワイプするための設定を含めます。

   4

   LVM ボリュームグループにシンプールを作成するための設定を含めます。このフィールドを除外すると、論理ボリュームはシックプロビジョニングされます。

2. 次のコマンドを実行して、LVMCluster CR を作成します。

   $ oc create -f <file_name>

   出力例

   lvmcluster/lvmcluster created

検証

1. LVMCluster CR が Ready 状態であることを確認します。

   $ oc get lvmclusters.lvm.topolvm.io -o jsonpath='{.items[*].status}' -n <namespace>

   出力例

   {"deviceClassStatuses": 1
   [
     {
       "name": "vg1",
       "nodeStatus": [ 2
           {
               "devices": [ 3
                   "/dev/nvme0n1",
                   "/dev/nvme1n1",
                   "/dev/nvme2n1"
               ],
               "node": "kube-node", 4
               "status": "Ready" 5
           }
       ]
     }
   ]
   "state":"Ready"} 6

   1

   デバイスクラスのステータス。

   2

   各ノードの LVM ボリュームグループのステータス。

   3

   LVM ボリュームグループの作成に使用されるデバイスのリスト。

   4

   デバイスクラスが作成されるノード。

   5

   ノード上の LVM ボリュームグループのステータス。

   6

   LVMCluster CR のステータス。

   注記

   LVMCluster CR が Failed 状態の場合、status フィールドに失敗の理由が表示されます。

   失敗の理由を示す status フィールドの例:

   status:
     deviceClassStatuses:
       - name: vg1
         nodeStatus:
           - node: my-node-1.example.com
             reason: no available devices found for volume group
             status: Failed
     state: Failed

2. オプション: 各デバイスクラスに対して LVM Storage によって作成されたストレージクラスを表示するには、次のコマンドを実行します。

   $ oc get storageclass

   出力例

   NAME          PROVISIONER          RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
   lvms-vg1      topolvm.io           Delete          WaitForFirstConsumer   true                   31m

3. オプション: 各デバイスクラスに対して LVM Storage によって作成されたボリュームスナップショットクラスを表示するには、次のコマンドを実行します。

   $ oc get volumesnapshotclass

   出力例

   NAME          DRIVER               DELETIONPOLICY   AGE
   lvms-vg1      topolvm.io           Delete           24h

手順

1. OpenShift Container Platform Web コンソールにログインします。
2. Operators Installed Operators をクリックします。
3. openshift-storage namespace で、LVM Storage をクリックします。
4. Create LVMCluster をクリックし、Form view または YAML view のいずれかを選択します。
5. LVMCluster CR の必要なパラメーターを設定します。
6. Create をクリックします。

7. オプション: LVMCLuster CR を編集する場合は、次の操作を実行します。

   1. LVMCluster タブをクリックします。
   2. Actions メニューから Edit LVMCluster を選択します。
   3. YAML をクリックし、LVMCLuster CR の必要なパラメーターを編集します。
   4. Save をクリックします。

検証

1. LVMCLuster ページで、LVMCluster CR が Ready 状態であることを確認します。
2. オプション: 各デバイスクラスに対して LVM Storage によって作成された使用可能なストレージクラスを表示するには、Storage StorageClasses をクリックします。
3. オプション: 各デバイスクラスに対して LVM Storage によって作成された使用可能なボリュームスナップショットクラスを表示するには、Storage VolumeSnapshotClasses をクリックします。

手順

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

2. LVMCluster CR を作成するための設定を含む ConfigurationPolicy CR YAML ファイルを作成します。

   LVMCluster CR を作成するための ConfigurationPolicy CR YAML ファイルの例

   apiVersion: policy.open-cluster-management.io/v1
   kind: ConfigurationPolicy
   metadata:
     name: lvms
     namespace: openshift-storage
   spec:
     object-templates:
     - complianceType: musthave
       objectDefinition:
         apiVersion: lvm.topolvm.io/v1alpha1
         kind: LVMCluster
         metadata:
           name: my-lvmcluster
           namespace: openshift-storage
         spec:
           storage:
             deviceClasses: 1
   # ...
               deviceSelector: 2
   # ...
               thinPoolConfig: 3
   # ...
               nodeSelector: 4
   # ...
     remediationAction: enforce
     severity: low

   1

   ローカルストレージデバイスを LVM ボリュームグループに割り当てるための設定を含めます。

   2

   LVM ボリュームグループに追加するデバイスへのパスを指定し、LVM ボリュームグループに追加されたデバイスを強制的にワイプするための設定を含めます。

   3

   LVM ボリュームグループにシンプールを作成するための設定を含めます。このフィールドを除外すると、論理ボリュームはシックプロビジョニングされます。

   4

   LVM ボリュームグループを作成するノードを選択するための設定を含めます。このフィールドが空の場合、no-schedule テイントのないすべてのノードが考慮されます。

3. 次のコマンドを実行して、ConfigurationPolicy CR を作成します。

   $ oc create -f <file_name> -n <cluster_namespace> 1

   1

   LVM Storage がインストールされている OpenShift Container Platform クラスターの namespace。

手順

1. OpenShift CLI (oc) にログインします。

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

   $ oc delete lvmcluster <lvmclustername> -n openshift-storage

手順

1. OpenShift Container Platform Web コンソールにログインします。
2. Operators Installed Operators をクリックして、インストールされているすべての Operators を表示します。
3. openshift-storage namespace で LVM Storage をクリックします。
4. LVMCluster タブをクリックします。
5. Actions から Delete LVMCluster を選択します。
6. Delete をクリックします。

手順

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

2. LVMCluster CR 用に作成した ConfigurationPolicy CR YAML ファイルを削除します。

   $ oc delete -f <file_name> -n <cluster_namespace> 1

   1

   LVM Storage がインストールされている OpenShift Container Platform クラスターの namespace。

3. LVMCluster CR を削除するための Policy CR YAML ファイルを作成します。

   LVMCluster CR を削除するための Policy CR の例

   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: 3
       matchExpressions:
         - key: mykey
           operator: In
           values:
             - myvalue

   1

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

   2

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

   3

   クラスターを選択するための要件を設定します。選択基準に一致するクラスターから LVM Storage がアンインストールされます。

4. 次のコマンドを実行して Policy CR を作成します。

   $ oc create -f <file_name> -n <namespace>

5. LVMCluster CR が削除されたかどうかを確認するための Policy CR YAML ファイルを作成します。

   LVMCluster CR が削除されたかどうかを確認するための Policy CR の例

   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. 次のコマンドを実行して Policy CR を作成します。

   $ oc create -f <file_name> -n <namespace>

手順

1. 次のコマンドを実行して、LVMCluster CR を編集します。

   $ oc edit <lvmcluster_file_name> -n <namespace>

2. deviceSelector フィールドに新しいデバイスへのパスを追加します。

   LVMCluster CR の例

   apiVersion: lvm.topolvm.io/v1alpha1
   kind: LVMCluster
   metadata:
     name: my-lvmcluster
   spec:
     storage:
       deviceClasses:
   # ...
         deviceSelector: 1
           paths: 2
           - /dev/disk/by-path/pci-0000:87:00.0-nvme-1
           - /dev/disk/by-path/pci-0000:88:00.0-nvme-1
           optionalPaths: 3
           - /dev/disk/by-path/pci-0000:89:00.0-nvme-1
           - /dev/disk/by-path/pci-0000:90:00.0-nvme-1
   # ...

   1

   LVM ボリュームグループに追加するデバイスへのパスを指定するための設定が含まれています。デバイスパスは、paths フィールド、optionalPaths フィールド、またはその両方で指定できます。paths と optionalPaths の両方でデバイスパスを指定しない場合、Logical Volume Manager (LVM) Storage は、サポートされている未使用のデバイスを LVM ボリュームグループに追加します。LVM Storage は、次の条件が満たされている場合にのみ、デバイスを LVM ボリュームグループに追加します。

   • デバイスパスが存在する。
   • デバイスが LVM Storage によってサポートされている。サポートされていないデバイスの詳細は、「LVM ストレージでサポートされていないデバイス」を参照してください。

   2

   デバイスパスを指定します。このフィールドに指定されたデバイスパスが存在しない場合、またはデバイスが LVM Storage でサポートされていない場合、LVMCluster CR が Failed 状態に移行します。

   3

   オプションのデバイスパスを指定します。このフィールドに指定されたデバイスパスが存在しない場合、またはデバイスが LVM Storage によってサポートされていない場合、LVM Storage はエラーを起こすことなくデバイスを無視します。

   重要

   デバイスが LVM ボリュームグループに追加された後は、デバイスを削除できません。

3. LVMCluster CR を保存します。

手順

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

7. LVMCluster CR を編集して、deviceSelector フィールドに新しいデバイスパスを追加します。

   LVMCluster CR の例

   apiVersion: lvm.topolvm.io/v1alpha1
   kind: LVMCluster
   metadata:
     name: my-lvmcluster
   spec:
     storage:
       deviceClasses:
   # ...
         deviceSelector: 1
           paths: 2
           - /dev/disk/by-path/pci-0000:87:00.0-nvme-1
           - /dev/disk/by-path/pci-0000:88:00.0-nvme-1
           optionalPaths: 3
           - /dev/disk/by-path/pci-0000:89:00.0-nvme-1
           - /dev/disk/by-path/pci-0000:90:00.0-nvme-1
   # ...

   1

   LVM ボリュームグループに追加するデバイスへのパスを指定するための設定が含まれています。デバイスパスは、paths フィールド、optionalPaths フィールド、またはその両方で指定できます。paths と optionalPaths の両方でデバイスパスを指定しない場合、Logical Volume Manager (LVM) Storage は、サポートされている未使用のデバイスを LVM ボリュームグループに追加します。LVM Storage は、次の条件が満たされている場合にのみ、デバイスを LVM ボリュームグループに追加します。

   • デバイスパスが存在する。
   • デバイスが LVM Storage によってサポートされている。サポートされていないデバイスの詳細は、「LVM ストレージでサポートされていないデバイス」を参照してください。

   2

   デバイスパスを指定します。このフィールドに指定されたデバイスパスが存在しない場合、またはデバイスが LVM Storage でサポートされていない場合、LVMCluster CR が Failed 状態に移行します。

   3

   オプションのデバイスパスを指定します。このフィールドに指定されたデバイスパスが存在しない場合、またはデバイスが LVM Storage によってサポートされていない場合、LVM Storage はエラーを起こすことなくデバイスを無視します。

   重要

   デバイスが LVM ボリュームグループに追加された後は、デバイスを削除できません。

8. Save をクリックします。

手順

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

2. 次のコマンドを実行して、RHACM を使用して作成した LVMCluster CR を編集します。

   $ oc edit -f <file_name> -ns <namespace> 1

   1

   <file_name> は、LVMCluster CR の名前に置き換えます。

3. LVMCluster CR で、deviceSelector フィールドに新しいデバイスへのパスを追加します。

   LVMCluster CR の例

   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:
   # ...
                        deviceSelector: 1
                          paths: 2
                          - /dev/disk/by-path/pci-0000:87:00.0-nvme-1
                          optionalPaths: 3
                          - /dev/disk/by-path/pci-0000:89:00.0-nvme-1
   # ...

   1

   LVM ボリュームグループに追加するデバイスへのパスを指定するための設定が含まれています。デバイスパスは、paths フィールド、optionalPaths フィールド、またはその両方で指定できます。paths と optionalPaths の両方でデバイスパスを指定しない場合、Logical Volume Manager (LVM) Storage は、サポートされている未使用のデバイスを LVM ボリュームグループに追加します。LVM Storage は、次の条件が満たされている場合にのみ、デバイスを LVM ボリュームグループに追加します。

   • デバイスパスが存在する。
   • デバイスが LVM Storage によってサポートされている。サポートされていないデバイスの詳細は、「LVM ストレージでサポートされていないデバイス」を参照してください。

   2

   デバイスパスを指定します。このフィールドに指定されたデバイスパスが存在しない場合、またはデバイスが LVM Storage でサポートされていない場合、LVMCluster CR が Failed 状態に移行します。

   3

   オプションのデバイスパスを指定します。このフィールドに指定されたデバイスパスが存在しない場合、またはデバイスが LVM Storage によってサポートされていない場合、LVM Storage はエラーを起こすことなくデバイスを無視します。

   重要

   デバイスが LVM ボリュームグループに追加された後は、デバイスを削除できません。

4. LVMCluster CR を保存します。

手順

1. OpenShift CLI (oc) にログインします。

2. VolumeSnapshot オブジェクトを作成します。

   VolumeSnapshot オブジェクトの例

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

   1

   ボリュームスナップショットの名前を指定します。

   2

   ソース PVC の名前を指定します。LVM Storage は、この PVC のスナップショットを作成します。

   3

   このフィールドをボリュームスナップショットクラスの名前に設定します。

   注記

   使用可能なボリュームスナップショットクラスのリストを取得するには、次のコマンドを実行します。

   $ oc get volumesnapshotclass

3. 次のコマンドを実行して、ソース PVC を作成した namespace にボリュームスナップショットを作成します。

   $ oc create -f <file_name> -n <namespace>

   LVM Storage は、PVC の読み取り専用コピーをボリュームスナップショットとして作成します。

手順

1. OpenShift CLI (oc) にログインします。

2. ボリュームスナップショットを復元するための設定を使用して PersistentVolumeClaim オブジェクトを作成します。

   ボリュームスナップショットを復元するための PersistentVolumeClaim オブジェクトの例

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

   1

   復元された PVC のストレージサイズを指定します。要求された PVC のストレージサイズは、復元するボリュームスナップショットのストレージサイズ以上である必要があります。より大きな PVC が必要な場合は、ボリュームスナップショットを復元した後に PVC のサイズを変更することもできます。

   2

   このフィールドを、復元するボリュームスナップショットのソース PVC の storageClassName フィールドの値に設定します。

   3

   このフィールドを、復元するボリュームスナップショットの名前に設定します。

3. 次のコマンドを実行して、ボリュームスナップショットを作成した namespace に PVC を作成します。

   $ oc create -f <file_name> -n <namespace>

手順

1. OpenShift CLI (oc) にログインします。

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

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

手順

1. OpenShift CLI (oc) にログインします。

2. PersistentVolumeClaim オブジェクトを作成します。

   ボリュームクローンを作成するための PersistentVolumeClaim オブジェクトの例

   kind: PersistentVolumeClaim
   apiVersion: v1
   metadata:
     name: lvm-pvc-clone
   spec:
     accessModes:
     - ReadWriteOnce
     storageClassName: lvms-vg1 1
     volumeMode: Filesystem 2
     dataSource:
       kind: PersistentVolumeClaim
       name: lvm-pvc 3
     resources:
       requests:
         storage: 1Gi 4

   1

   このフィールドを、ソース PVC の storageClassName フィールドの値に設定します。

   2

   このフィールドを、ソース PVC の volumeMode フィールドに設定します。

   3

   ソース PVC の名前を指定します。

   4

   クローン作成された PVC のストレージサイズを指定します。クローン作成された PVC のストレージサイズは、ソース PVC のストレージサイズ以上である必要があります。

3. 次のコマンドを実行して、ソース PVC を作成した namespace に PVC を作成します。

   $ oc create -f <file_name> -n <namespace>

手順

1. OpenShift CLI (oc) にログインします。

2. 次のコマンドを実行して、クローン作成された PVC を削除します。

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

手順

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 を作成します。詳細は、「LVMCluster カスタムリソースを作成する方法」を参照してください。

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

     設定ファイルの読み込み中に vg-manager Pod が停止する場合は、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 の名前に置き換えます。