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

5.4.1. Logical Volume Manager Storage のインストール
リンクのコピー

単一ノードの OpenShift クラスターに論理ボリュームマネージャー(LVM)ストレージをインストールし、ワークロード用にストレージを動的にプロビジョニングするように設定できます。

OpenShift Container Platform CLI (oc)、OpenShift Container Platform Web コンソール、または Red Hat Advanced Cluster Management (RHACM)を使用して、シングルノード OpenShift クラスターに LVM ストレージをデプロイできます。

5.4.1.1. LVM Storage をインストールするための前提条件
リンクのコピー

LVM Storage をインストールするための前提条件は次のとおりです。

最低でも 10 ミリの CPU と 100 MiB の RAM があることを確認してください。
すべてのマネージドクラスターに、ストレージのプロビジョニングに使用される専用のディスクがあることを確認してください。LVM Storage は、ファイルシステム署名が含まれていない空のディスクのみを使用します。確実にディスクが空で、ファイルシステム署名が含まれていないようにするには、使用する前にディスクを消去します。
以前の LVM Storage のインストールで設定したストレージデバイスを再利用できるプライベート CI 環境に LVM Storage をインストールする前に、使用されていないディスクが消去されていることを確認してください。LVM Storage をインストールする前にディスクをワイプしないと、ディスクを再利用するのに手動による介入が必要になります。
注記
使用中のディスクは消去できません。
Red Hat Advanced Cluster Management (RHACM) を使用して LVM Storage をインストールする場合は、RHACM が OpenShift Container Platform クラスターにインストールされていることを確認してください。詳細は、RHACM を使用した LVM ストレージのインストールを参照してください。

5.4.1.2. CLI を使用した LVM Storage のインストール
リンクのコピー

クラスター管理者は、OpenShift CLI (oc)を使用して論理ボリュームマネージャー(LVM)ストレージをインストールできます。

前提条件

OpenShift CLI (oc) がインストールされている。
cluster-admin および Operator インストール権限を持つユーザーとして OpenShift Container Platform にログインしている。

手順

YAML ファイルを作成し、namespace を作成する設定を追加します。

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

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

以下のコマンドを実行して namespace を作成します。
```
oc create -f <file_name>
```
```
$ oc create -f <file_name>
```
Copy to Clipboard Toggle word wrap

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

OperatorGroup CR の例

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

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

以下のコマンドを実行して OperatorGroup CR を作成します。
```
oc create -f <file_name>
```
```
$ oc create -f <file_name>
```
Copy to Clipboard Toggle word wrap

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

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

以下のコマンドを実行して Subscription CR を作成します。
```
oc create -f <file_name>
```
```
$ oc create -f <file_name>
```
Copy to Clipboard Toggle word wrap

検証

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

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

$ 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

Name                         Phase
4.13.0-202301261535          Succeeded

Copy to Clipboard

Toggle word wrap

5.4.1.3. Web コンソールを使用した LVM Storage のインストール
リンクのコピー

OpenShift Container Platform Web コンソールを使用して論理ボリュームマネージャー(LVM)ストレージをインストールできます。

前提条件

シングルノード OpenShift クラスターにアクセスできます。
cluster-admin および Operator インストール権限で OpenShift Container Platform にアクセスできる。

手順

OpenShift Container Platform Web コンソールにログインします。
Operators OperatorHub をクリックします。
OperatorHub ページで LVM Storage をクリックします。
Operator Installation ページで次のオプションを設定します。
1. Update Channel を stable-4.14 に設定します。
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 を新しいバージョンに更新するには、クラスター管理者が更新要求を手動で承認する必要があります。
オプション: Enable Operator recommended cluster monitoring on this Namespace チェックボックスを選択します。
Install をクリックします。

検証手順

インストールが成功したことを示す緑色のチェックマークが LVM Storage に表示されていることを確認します。

5.4.1.4. 非接続環境での LVM Storage のインストール
リンクのコピー

切断された環境の OpenShift Container Platform 4.14 に論理ボリュームマネージャー(LVM)ストレージをインストールできます。「関連情報」セクションに、この手順で参照されているすべてのセクションのリンクが記載されています。

前提条件

「非接続インストールミラーリングについて」セクションを確認した。
OpenShift Container Platform イメージリポジトリーにアクセスできる。
ミラーレジストリーを作成した。

手順

「イメージセット設定の作成」手順の手順に従います。LVM ストレージのイメージセット設定を作成するには、次の ImageSetConfiguration オブジェクト設定の例を使用できます。
LVM Storage 用の ImageSetConfiguration ファイルの例
```
kind: ImageSetConfiguration
apiVersion: mirror.openshift.io/v1alpha2
archiveSize: 4 
storageConfig: 
  registry:
    imageURL: example.com/mirror/oc-mirror-metadata 
    skipTLS: false
mirror:
  platform:
    channels:
    - name: stable-4.14 
      type: ocp
    graph: true 
  operators:
  - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.14 
    packages:
    - name: lvms-operator 
      channels:
      - name: stable 
  additionalImages:
  - name: registry.redhat.io/ubi9/ubi:latest 
  helm: {}
```
```
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.14 
```
4
```
      type: ocp
    graph: true 
```
5
```
  operators:
  - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.14 
```
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
イメージセット内の各ファイルの最大サイズをギビバイト単位で設定します。
2
イメージセットを保存する場所を指定します。この場所は、レジストリーまたはローカルディレクトリーにすることができます。
3
レジストリーを使用する場合は、イメージストリームのストレージ URL を指定します。詳細は、イメージストリームの使用を参照してください。
4
OpenShift Container Platform イメージの取得元のチャネルを指定します。
5
OpenShift Update Service (OSUS) グラフイメージを生成するには、このフィールドを true に設定します。詳細は、About the OpenShift Update Service を参照してください。
6
OpenShift Container Platform イメージの取得元の Operator カタログを指定します。
7
イメージセットに含める Operator パッケージを指定します。このフィールドが空の場合、カタログ内のすべてのパッケージが取得されます。
8
イメージセットに含める Operator パッケージのチャネルを指定します。Operator パッケージのデフォルトチャネルは、そのチャネルのバンドルを使用しない場合でも含める必要があります。コマンド $ oc mirror list operators --catalog=<catalog_name> --package=<package_name> を実行すると、デフォルトチャネルを見つけることができます。
9
イメージセットに含める追加のイメージを指定します。
「イメージセットをミラーレジストリーにミラーリングする」セクションの手順に従います。
「イメージレジストリーのリポジトリーミラーリングの設定」セクションの手順に従います。

5.4.1.5. RHACM を使用した LVM Storage のインストール
リンクのコピー

Red Hat Advanced Cluster Management (RHACM)を使用してクラスターに論理ボリュームマネージャー(LVM)ストレージをインストールするには、Policy カスタムリソース(CR)を作成する必要があります。LVM Storage をインストールするクラスターを選択するための基準を設定することもできます。

注記

LVM Storage をインストールするために作成した Policy CR は、Policy CR の作成後にインポートまたは作成したクラスターにも適用されます。

前提条件

cluster-admin および Operator のインストール権限を持つアカウントを使用して、RHACM クラスターにアクセスできる。
各クラスターに、LVM Storage が使用できる専用のディスクがある。
クラスターが RHACM によって管理されている。

手順

OpenShift Container Platform の認証情報を使用して RHACM CLI にログインします。
次のコマンドを実行して、namespace を作成します。
```
oc create ns <namespace>
```
```
$ oc create ns <namespace>
```
Copy to Clipboard Toggle word wrap

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

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

Copy to Clipboard

Toggle word wrap

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

次のコマンドを実行して Policy CR を作成します。
```
oc create -f <file_name> -n <namespace>
```
```
$ oc create -f <file_name> -n <namespace>
```
Copy to Clipboard Toggle word wrap
Policy CR を作成すると、PlacementRule CR で設定された選択基準に一致するクラスターに次のカスタムリソースが作成されます。
- namespace
- OperatorGroup
- Subscription

5.4.2. LVMCluster カスタムリソースについて
リンクのコピー

LVMCluster カスタムリソース(CR)を設定して、次のアクションを実行できます。

永続ボリューム要求 (PVC) のプロビジョニングに使用できる LVM ボリュームグループを作成する。
LVM ボリュームグループに追加するデバイスのリストを設定する。
LVM ボリュームグループを作成するノードを選択するための要件と、ボリュームグループのシンプール設定を設定する。

LVM Storage をインストールした後、LVMCluster カスタムリソース (CR) を作成する必要があります。

LVMCluster CR YAML ファイルの例

apiVersion: lvm.topolvm.io/v1alpha1
kind: LVMCluster
metadata:
  name: my-lvmcluster
spec:
  tolerations:
  - effect: NoSchedule
    key: xyz
    operator: Equal
    value: "true"
  storage:
    deviceClasses:
    - name: vg1
      fstype: ext4 
      default: true
      nodeSelector: 
        nodeSelectorTerms:
        - matchExpressions:
          - key: mykey
            operator: In
            values:
            - ssd
      deviceSelector: 
        paths:
        - /dev/disk/by-path/pci-0000:87:00.0-nvme-1
        - /dev/disk/by-path/pci-0000:88:00.0-nvme-1
        optionalPaths:
        - /dev/disk/by-path/pci-0000:89:00.0-nvme-1
        - /dev/disk/by-path/pci-0000:90:00.0-nvme-1
      thinPoolConfig:
        name: thin-pool-1
        sizePercent: 90 
        overprovisionRatio: 10

apiVersion: lvm.topolvm.io/v1alpha1
kind: LVMCluster
metadata:
  name: my-lvmcluster
spec:
  tolerations:
  - effect: NoSchedule
    key: xyz
    operator: Equal
    value: "true"
  storage:
    deviceClasses:
    - name: vg1
      fstype: ext4

1


      default: true
      nodeSelector:

2


        nodeSelectorTerms:
        - matchExpressions:
          - key: mykey
            operator: In
            values:
            - ssd
      deviceSelector:

3


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

4


        overprovisionRatio: 10

Copy to Clipboard

Toggle word wrap

1 2 3 4: オプションのフィールド

5.4.2.1. LVMCluster CR のフィールドの説明
リンクのコピー

LVMCluster CR のフィールドは、次の表で説明します。

Expand

表5.5 LVMCluster CR のフィールド
フィールド	型	説明
`spec.storage.deviceClasses`	`array`	ローカルストレージデバイスを LVM ボリュームグループに割り当てるための設定を含めます。 LVM Storage は、ユーザーが作成する各デバイスクラスに対してストレージクラスとボリュームスナップショットクラスを作成します。デバイスクラスを追加または削除すると、`topolvm-node` Pod を削除して再作成した後にのみ、更新がクラスターに反映されます。
`deviceClasses.name`	`string`	LVM ボリュームグループ (VG) の名前を指定します。
`deviceClasses.fstype`	`string`	このフィールドは、`ext4` または `xfs` に設定します。デフォルトでは、このフィールドは `xfs` に設定されています。
`deviceClasses.default`	`boolean`	デバイスクラスがデフォルトであることを指定するには、このフィールドを `true` に設定します。それ以外の場合は、`false` に設定できます。設定できるデフォルトのデバイスクラスは 1 つだけです。
`deviceClasses.nodeSelector`	`object`	LVM ボリュームグループを作成するノードを選択するための設定を含めます。このフィールドが空の場合、no-schedule テイントのないすべてのノードが考慮されます。コントロールプレーンノードでは、クラスター内で新しいノードがアクティブになると、LVM Storage が追加のワーカーノードを検出して使用します。
`nodeSelector.nodeSelectorTerms`	`array`	ノードの選択に使用する要件を設定します。
`deviceClasses.deviceSelector`	`object`	LVM ボリュームグループに追加するデバイスへのパスを指定するための設定が含まれています。詳細は、「ボリュームグループへのデバイスの追加について」を参照してください。
`deviceSelector.paths`	`array`	デバイスパスを指定します。このフィールドで指定されたデバイスパスが存在しない場合、`LVMCluster` CR は `Failed` 状態に移行します。
`deviceSelector.optionalPaths`	`array`	オプションのデバイスパスを指定します。このフィールドで指定されているデバイスパスが存在しない場合、LVM ストレージはエラーを発生させずにデバイスを無視します。
`deviceClasses.thinPoolConfig`	`object`	LVM ボリュームグループにシンプールを作成するための設定を含めます。
`thinPoolConfig.name`	`string`	シンプールの名前を指定します。
`thinPoolConfig.sizePercent`	`integer`	シンプールを作成するための LVM ボリュームグループ内の領域の割合を指定します。デフォルトでは、このフィールドは 90 に設定されています。設定できる最小値は 10、最大値は 90 です。
`thinPoolConfig.overprovisionRatio`	`integer`	シンプールで使用可能なストレージに基づいて追加のストレージをプロビジョニングするのに使用する係数を指定します。たとえば、このフィールドが 10 に設定されている場合、シンプールで使用可能なストレージの量の最大 10 倍をプロビジョニングできます。オーバープロビジョニングを無効にするには、このフィールドを 1 に設定します。

5.4.2.2. ボリュームグループへのデバイスの追加について
リンクのコピー

LVMCluster カスタムリソース(CR)の deviceSelector フィールドには、LVM ボリュームグループに追加するデバイスへのパスを指定する設定が含まれます。

デバイスへのパスは、deviceSelector.paths フィールド、deviceSelector.optionalPaths フィールド、またはその両方で指定できます。deviceSelector.paths フィールドと deviceSelector.optionalPaths フィールドの両方でデバイスパスを指定しない場合、LVM ストレージは未使用のデバイスを LVM ボリュームグループに追加します。

警告

/dev/sdX などのシンボリックな命名を使用したディスクの参照は避けることが推奨されます。これらの名前は RHCOS 内での再起動によって変更される可能性があるためです。代わりに、一貫したディスク識別を確保するために、/dev/disk/by-path/ または /dev/disk/by-id/ などの安定した命名スキームを使用する必要があります。

この変更により、モニタリングで各ノードのインストールデバイスに関する情報が収集される場合、既存の自動化ワークフローの調整が必要になる可能性があります。

詳細は、RHEL ドキュメントを参照してください。

LVMCluster CR に deviceSelector フィールドを追加しない場合、デバイスが利用可能になると、LVM Storage は新しいデバイスを自動的に追加します。

LVM ストレージは、デバイスパスが存在する場合にのみ、デバイスを LVM ボリュームグループに追加します。

重要

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

5.4.3. LVMCluster カスタムリソースを作成する方法
リンクのコピー

LVMCluster カスタムリソース (CR) は、OpenShift CLI (oc) または OpenShift Container Platform Web コンソールを使用して作成できます。Red Hat Advanced Cluster Management (RHACM) を使用して LVM Storage をインストールした場合は、RHACM を使用して LVMCluster CR を作成することもできます。

LVMCluster CR を作成すると、LVM Storage によって次のシステム管理 CR が作成されます。

各デバイスクラスの storageClass と volumeSnapshotClass。
注記
LVM Storage は、ストレージクラスとボリュームスナップショットクラスの名前を lvms-<device_class_name> の形式で設定します。<device_class_name> は、LVMCluster CR の deviceClasses.name フィールドの値です。たとえば、deviceClasses.name フィールドが vg1 に設定されている場合、ストレージクラスとボリュームスナップショットクラスの名前は lvms-vg1 になります。
LVMVolumeGroup: この CR は、LVM ボリュームグループによってサポートされる特定のタイプの永続ボリューム (PV) です。複数のノードにわたる個々のボリュームグループを追跡します。
LVMVolumeGroupNodeStatus: この CR は、ノード上のボリュームグループのステータスを追跡します。

5.4.3.1. CLI を使用した LVMCluster CR の作成
リンクのコピー

OpenShift CLI (oc) を使用して、ワーカーノード上に LVMCluster カスタムリソース (CR) を作成できます。

重要

OpenShift Container Platform クラスターでは、LVMCluster カスタムリソース (CR) のインスタンスを 1 つだけ作成できます。

前提条件

OpenShift CLI (oc) がインストールされている。
cluster-admin 権限を持つユーザーとして OpenShift Container Platform にログインしている。
LVM Storage がインストールされている。
クラスターにワーカーノードがインストールされている。
「LVMCluster カスタムリソースについて」セクションを確認した。

手順

LVMCluster カスタムリソース (CR) YAML ファイルを作成します。
LVMCluster CR YAML ファイルの例
```
apiVersion: lvm.topolvm.io/v1alpha1
kind: LVMCluster
metadata:
  name: my-lvmcluster
  namespace: openshift-storage
spec:
# ...
  storage:
    deviceClasses: 
# ...
      nodeSelector: 
# ...
      deviceSelector: 
# ...
      thinPoolConfig: 
# ...
```
```
apiVersion: lvm.topolvm.io/v1alpha1
kind: LVMCluster
metadata:
  name: my-lvmcluster
  namespace: openshift-storage
spec:
# ...
  storage:
    deviceClasses: 
```
1
```
# ...
      nodeSelector: 
```
2
```
# ...
      deviceSelector: 
```
3
```
# ...
      thinPoolConfig: 
```
4
```
# ...
```
Copy to Clipboard Toggle word wrap
1
ローカルストレージデバイスを LVM ボリュームグループに割り当てるための設定を含めます。
2
LVM ボリュームグループを作成するノードを選択するための設定を含めます。このフィールドが空の場合、no-schedule テイントのないすべてのノードが考慮されます。
3
LVM ボリュームグループに追加するデバイスへのパスを指定するための設定が含まれています。
4
LVM ボリュームグループにシンプールを作成するための設定を含めます。
次のコマンドを実行して、LVMCluster CR を作成します。
```
oc create -f <file_name>
```
```
$ oc create -f <file_name>
```
Copy to Clipboard Toggle word wrap
出力例
```
lvmcluster/lvmcluster created
```
```
lvmcluster/lvmcluster created
```
Copy to Clipboard Toggle word wrap

検証

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

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

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

Copy to Clipboard

Toggle word wrap

出力例

{"deviceClassStatuses": 
[
  {
    "name": "vg1",
    "nodeStatus": [ 
        {
            "devices": [ 
                "/dev/nvme0n1",
                "/dev/nvme1n1",
                "/dev/nvme2n1"
            ],
            "node": "kube-node", 
            "status": "Ready" 
        }
    ]
  }
]
"state":"Ready"}

{"deviceClassStatuses":

1


[
  {
    "name": "vg1",
    "nodeStatus": [

2


        {
            "devices": [

3


                "/dev/nvme0n1",
                "/dev/nvme1n1",
                "/dev/nvme2n1"
            ],
            "node": "kube-node",

4


            "status": "Ready"

5


        }
    ]
  }
]
"state":"Ready"}

6

Copy to Clipboard

Toggle word wrap

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

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

Copy to Clipboard

Toggle word wrap

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

oc get storageclass

$ oc get storageclass

Copy to Clipboard

Toggle word wrap

出力例

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

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

Copy to Clipboard

Toggle word wrap

オプション: 各デバイスクラスに対して LVM Storage によって作成されたボリュームスナップショットクラスを表示するには、次のコマンドを実行します。
```
oc get volumesnapshotclass
```
```
$ oc get volumesnapshotclass
```
Copy to Clipboard Toggle word wrap
出力例
```
NAME          DRIVER               DELETIONPOLICY   AGE
lvms-vg1      topolvm.io           Delete           24h
```
```
NAME          DRIVER               DELETIONPOLICY   AGE
lvms-vg1      topolvm.io           Delete           24h
```
Copy to Clipboard Toggle word wrap

5.4.3.2. Web コンソールを使用した LVMCluster CR の作成
リンクのコピー

OpenShift Container Platform Web コンソールを使用して、ワーカーノード上に LVMCluster CR を作成できます。

重要

OpenShift Container Platform クラスターでは、LVMCluster カスタムリソース (CR) のインスタンスを 1 つだけ作成できます。

前提条件

cluster-admin 権限を使用して OpenShift Container Platform クラスターにアクセスできる。
LVM Storage がインストールされている。
クラスターにワーカーノードがインストールされている。
「LVMCluster カスタムリソースについて」セクションを確認した。

手順

OpenShift Container Platform Web コンソールにログインします。
Operators Installed Operators をクリックします。
openshift-storage namespace で、LVM Storage をクリックします。
Create LVMCluster をクリックし、Form view または YAML view のいずれかを選択します。
LVMCluster CR の必要なパラメーターを設定します。
Create をクリックします。
オプション: LVMCLuster CR を編集する場合は、次の操作を実行します。
1. LVMCluster タブをクリックします。
2. Actions メニューから Edit LVMCluster を選択します。
3. YAML をクリックし、LVMCLuster CR の必要なパラメーターを編集します。
4. Save をクリックします。

検証

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

5.4.3.3. RHACM を使用した LVMCluster CR の作成
リンクのコピー

RHACM を使用して論理ボリュームマネージャー(LVM)ストレージをインストールした後、LVMCluster カスタムリソース(CR)を作成する必要があります。

前提条件

RHACM を使用して LVM Storage をインストールした。
cluster-admin 権限を持つアカウントを使用して RHACM クラスターにアクセスできる。

手順

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

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: 
# ...
            deviceSelector: 
# ...
            thinPoolConfig: 
# ...
            nodeSelector: 
# ...
  remediationAction: enforce
  severity: low

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

Copy to Clipboard

Toggle word wrap

1: ローカルストレージデバイスを LVM ボリュームグループに割り当てるための設定を含めます。
2: LVM ボリュームグループに追加するデバイスへのパスを指定するための設定が含まれています。
3: LVM ボリュームグループにシンプールを作成するための設定を含めます。
4: LVM ボリュームグループを作成するノードを選択するための設定を含めます。このフィールドが空の場合、no-schedule テイントのないすべてのノードが考慮されます。

次のコマンドを実行して、ConfigurationPolicy CR を作成します。
```
oc create -f <file_name> -n <cluster_namespace>
```
```
$ oc create -f <file_name> -n <cluster_namespace> 
```
1
Copy to Clipboard Toggle word wrap
1
LVM Storage がインストールされている OpenShift Container Platform クラスターの namespace。

5.4.4. LVMCluster カスタムリソースを削除する方法
リンクのコピー

LVMCluster カスタムリソース (CR) は、OpenShift CLI (oc) または OpenShift Container Platform Web コンソールを使用して削除できます。Red Hat Advanced Cluster Management (RHACM) を使用して LVM Storage をインストールした場合は、RHACM を使用して LVMCluster CR を削除することもできます。

LVMCluster CR を削除すると、LVM Storage によって次の CR が削除されます。

storageClass
volumeSnapshotClass
LVMVolumeGroup
LVMVolumeGroupNodeStatus

5.4.4.1. CLI を使用した LVMCluster CR の削除
リンクのコピー

OpenShift CLI (oc) を使用して、LVMCluster カスタムリソース (CR) を削除できます。

前提条件

cluster-admin パーミッションを持つユーザーとして OpenShift Container Platform にアクセスできる。
LVM Storage によってプロビジョニングされた永続ボリューム要求 (PVC)、ボリュームスナップショット、およびボリュームクローンが削除されている。これらのリソースを使用しているアプリケーションも削除されている。

手順

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

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

oc delete lvmcluster <lvm_cluster_name> -n openshift-storage

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

Copy to Clipboard

Toggle word wrap

検証

LVMCluster CR が削除されたことを確認するには、次のコマンドを実行します。
```
oc get lvmcluster -n <namespace>
```
```
$ oc get lvmcluster -n <namespace>
```
Copy to Clipboard Toggle word wrap
出力例
```
No resources found in openshift-storage namespace.
```
```
No resources found in openshift-storage namespace.
```
Copy to Clipboard Toggle word wrap

5.4.4.2. Web コンソールを使用した LVMCluster CR の削除
リンクのコピー

OpenShift Container Platform Web コンソールを使用して、LVMCluster カスタムリソース (CR) を削除できます。

前提条件

cluster-admin パーミッションを持つユーザーとして OpenShift Container Platform にアクセスできる。
LVM Storage によってプロビジョニングされた永続ボリューム要求 (PVC)、ボリュームスナップショット、およびボリュームクローンが削除されている。これらのリソースを使用しているアプリケーションも削除されている。

手順

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

検証

LVMCLuster ページで、LVMCluster CR が削除されたことを確認します。

5.4.4.3. RHACM を使用した LVMCluster CR の削除
リンクのコピー

Red Hat Advanced Cluster Management (RHACM)を使用して論理ボリュームマネージャー(LVM)ストレージをインストールした場合は、RHACM を使用して LVMCluster カスタムリソース(CR)を削除できます。

前提条件

cluster-admin 権限を持つユーザーとして RHACM クラスターにアクセスできる。
LVM ストレージによってプロビジョニングされた次のリソースを削除しました。
- 永続ボリューム要求 (PVC)
- ボリュームスナップショット
- ボリュームのクローン
  これらのリソースを使用しているアプリケーションも削除されている。

手順

OpenShift Container Platform の認証情報を使用して RHACM CLI にログインします。
次のコマンドを実行して、LVMCluster CR の ConfigurationPolicy CR を削除します。
```
oc delete -f <file_name> -n <cluster_namespace>
```
```
$ oc delete -f <file_name> -n <cluster_namespace> 
```
1
Copy to Clipboard Toggle word wrap
1
LVM Storage がインストールされている OpenShift Container Platform クラスターの namespace。

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 
          severity: low
          object-templates:
            - complianceType: mustnothave
              objectDefinition:
                kind: LVMCluster
                apiVersion: lvm.topolvm.io/v1alpha1
                metadata:
                  name: my-lvmcluster
                  namespace: openshift-storage 
---
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

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

Copy to Clipboard

Toggle word wrap

1: policy-template の spec.remediationAction は、spec.remediationAction の前のパラメーター値によってオーバーライドされます。
2: この namespace フィールドには openshift-storage 値が必要です。
3: クラスターを選択するための要件を設定します。選択基準に一致するクラスターから LVM Storage がアンインストールされます。

次のコマンドを実行して Policy CR を作成します。
```
oc create -f <file_name> -n <namespace>
```
```
$ oc create -f <file_name> -n <namespace>
```
Copy to Clipboard Toggle word wrap

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 
          severity: low
          object-templates:
            - complianceType: mustnothave
              objectDefinition:
                kind: LVMCluster
                apiVersion: lvm.topolvm.io/v1alpha1
                metadata:
                  name: my-lvmcluster
                  namespace: openshift-storage 
---
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

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

Copy to Clipboard

Toggle word wrap

1: policy-template の spec.remediationAction は、spec.remediationAction の前のパラメーター値によってオーバーライドされます。
2: namespace フィールドには openshift-storage 値が必要です。

次のコマンドを実行して Policy CR を作成します。
```
oc create -f <file_name> -n <namespace>
```
```
$ oc create -f <file_name> -n <namespace>
```
Copy to Clipboard Toggle word wrap

検証

次のコマンドを実行して、Policy CR のステータスを確認します。

oc get policy -n <namespace>

$ oc get policy -n <namespace>

Copy to Clipboard

Toggle word wrap

出力例

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

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

Copy to Clipboard

Toggle word wrap

重要

Policy CR が Compliant 状態である必要があります。

5.4.5. ストレージのプロビジョニング
リンクのコピー

LVMCluster カスタムリソース (CR) を使用して LVM ボリュームグループを作成した後、永続ボリューム要求 (PVC) を作成してストレージをプロビジョニングできます。

PVC を作成するには、PersistentVolumeClaim オブジェクトを作成する必要があります。

前提条件

LVMCluster CR が作成されている。

手順

OpenShift CLI (oc) にログインします。
次のような PersistentVolumeClaim オブジェクトを作成します。
PersistentVolumeClaim オブジェクトの例
```
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: lvm-block-1 
  namespace: default
spec:
  accessModes:
    - ReadWriteOnce
  volumeMode: Block 
  resources:
    requests:
      storage: 10Gi 
  storageClassName: lvms-vg1 
```
```
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: lvm-block-1 
```
1
```
  namespace: default
spec:
  accessModes:
    - ReadWriteOnce
  volumeMode: Block 
```
2
```
  resources:
    requests:
      storage: 10Gi 
```
3
```
  storageClassName: lvms-vg1 
```
4
Copy to Clipboard Toggle word wrap
1
PVC の名前を指定します。
2
ブロック PVC を作成するには、このフィールドを Block に設定します。ファイル PVC を作成するには、このフィールドを Filesystem に設定します。
3
ストレージサイズを指定します。論理ボリュームマネージャー(LVM)ストレージは、1 GiB （ギビバイト）単位で PVC をプロビジョニングします。要求されたストレージは、最も近い GiB に切り上げられます。プロビジョニングできるストレージサイズの合計は、LVM シンプールのサイズとオーバープロビジョニング係数によって制限されます。
4
storageClassName フィールドの値は lvms-<device_class_name> の形式である必要があります。ここで、<device_class_name> は、LVMCluster CR の deviceClasses.name フィールドの値になります。たとえば、deviceClasses.name フィールドが vg1 に設定されている場合、storageClassName フィールドを lvms-vg1 に設定する必要があります。
注記
ストレージクラスの volumeBindingMode フィールドは WaitForFirstConsumer に設定されます。
以下のコマンドを実行して PVC を作成します。
```
oc create -f <file_name> -n <application_namespace>
```
```
$ oc create -f <file_name> -n <application_namespace>
```
Copy to Clipboard Toggle word wrap
注記
作成された PVC は、それらを使用する Pod をデプロイするまで Pending 状態のままになります。

検証

PVC が作成されたことを確認するには、次のコマンドを実行します。

oc get pvc -n <namespace>

$ oc get pvc -n <namespace>

Copy to Clipboard

Toggle word wrap

出力例

NAME          STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS   AGE
lvm-block-1   Bound    pvc-e90169a8-fd71-4eea-93b8-817155f60e47   1Gi        RWO            lvms-vg1       5s

NAME          STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS   AGE
lvm-block-1   Bound    pvc-e90169a8-fd71-4eea-93b8-817155f60e47   1Gi        RWO            lvms-vg1       5s

Copy to Clipboard

Toggle word wrap

5.4.6. シングルノード OpenShift クラスターのストレージをスケールアップする方法
リンクのコピー

新しいデバイスを既存のノードに追加することで、シングルノード OpenShift クラスターのストレージをスケールアップできます。

シングルノード OpenShift クラスターの既存のノードに新しいデバイスを追加するには、LVMCluster カスタムリソース(CR)の deviceSelector フィールドに新しいデバイスへのパスを追加する必要があります。

重要

LVMCluster CR に deviceSelector フィールドを追加できるのは、LVMCluster CR の作成時にのみです。LVMCluster CR の作成時に deviceSelector フィールドを追加しなかった場合は、LVMCluster CR を削除し、deviceSelector フィールドを含む新しい LVMCluster CR を作成する必要があります。

LVMCluster CR に deviceSelector フィールドを追加しない場合、デバイスが利用可能になると、LVM Storage は新しいデバイスを自動的に追加します。

5.4.6.1. CLI を使用した単一ノード OpenShift クラスターのストレージをスケールアップする
リンクのコピー

OpenShift CLI (oc)を使用して、シングルノード OpenShift クラスターの既存ノードのストレージ容量をスケールアップできます。

前提条件

論理ボリュームマネージャー(LVM)ストレージで使用される、シングルノード OpenShift クラスター上に追加の未使用デバイスがあります。
OpenShift CLI (oc) がインストールされている。
LVMCluster カスタムリソース (CR) が作成されている。

手順

次のコマンドを実行して、LVMCluster CR を編集します。
```
oc edit <lvmcluster_file_name> -n <namespace>
```
```
$ oc edit <lvmcluster_file_name> -n <namespace>
```
Copy to Clipboard Toggle word wrap
deviceSelector フィールドに新しいデバイスへのパスを追加します。
LVMCluster CR の例
```
apiVersion: lvm.topolvm.io/v1alpha1
kind: LVMCluster
metadata:
  name: my-lvmcluster
spec:
  storage:
    deviceClasses:
# ...
      deviceSelector: 
        paths: 
        - /dev/disk/by-path/pci-0000:87:00.0-nvme-1
        - /dev/disk/by-path/pci-0000:88:00.0-nvme-1
        optionalPaths: 
        - /dev/disk/by-path/pci-0000:89:00.0-nvme-1
        - /dev/disk/by-path/pci-0000:90:00.0-nvme-1
# ...
```
```
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
# ...
```
Copy to Clipboard Toggle word wrap
1
論理ボリュームマネージャー(LVM)ボリュームグループに追加するデバイスへのパスを指定する設定が含まれています。デバイスパスは、paths フィールド、optionalPaths フィールド、またはその両方で指定できます。path と optionalPaths の両方でデバイスパスを指定しなかった場合、サポートされている未使用のデバイスが LVM Storage によって LVM ボリュームグループに追加されます。LVM ストレージは、デバイスパスが存在する場合にのみ、デバイスを LVM ボリュームグループに追加します。
2
デバイスパスを指定します。このフィールドで指定されたデバイスパスが存在しない場合、LVMCluster CR は Failed 状態に移行します。
3
オプションのデバイスパスを指定します。このフィールドで指定されたデバイスパスが存在しない場合、LVM ストレージはエラーを発生させずにデバイスを無視します。
重要
デバイスが LVM ボリュームグループに追加された後は、デバイスを削除できません。
LVMCluster CR を保存します。

5.4.6.2. Web コンソールを使用したシングルノード OpenShift クラスターのストレージのスケールアップ
リンクのコピー

OpenShift Container Platform Web コンソールを使用して、シングルノード OpenShift クラスターの既存ノードのストレージ容量をスケールアップできます。

前提条件

論理ボリュームマネージャー(LVM)ストレージで使用される、シングルノード OpenShift クラスター上に追加の未使用デバイスがあります。
LVMCluster カスタムリソース (CR) が作成されている。

手順

OpenShift Container Platform Web コンソールにログインします。
Operators Installed Operators をクリックします。
openshift-storage namespace で LVM Storage をクリックします。
LVMCluster タブをクリックして、クラスター上に作成された LVMCluster CR を表示します。
Actions メニューから Edit LVMCluster を選択します。
YAML タブをクリックします。
LVMCluster CR を編集して、deviceSelector フィールドに新しいデバイスパスを追加します。
LVMCluster CR の例
```
apiVersion: lvm.topolvm.io/v1alpha1
kind: LVMCluster
metadata:
  name: my-lvmcluster
spec:
  storage:
    deviceClasses:
# ...
      deviceSelector: 
        paths: 
        - /dev/disk/by-path/pci-0000:87:00.0-nvme-1
        - /dev/disk/by-path/pci-0000:88:00.0-nvme-1
        optionalPaths: 
        - /dev/disk/by-path/pci-0000:89:00.0-nvme-1
        - /dev/disk/by-path/pci-0000:90:00.0-nvme-1
# ...
```
```
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
# ...
```
Copy to Clipboard Toggle word wrap
1
論理ボリュームマネージャー(LVM)ボリュームグループに追加するデバイスへのパスを指定する設定が含まれています。デバイスパスは、paths フィールド、optionalPaths フィールド、またはその両方で指定できます。path と optionalPaths の両方でデバイスパスを指定しなかった場合、サポートされている未使用のデバイスが LVM Storage によって LVM ボリュームグループに追加されます。LVM ストレージは、デバイスパスが存在する場合にのみ、デバイスを LVM ボリュームグループに追加します。
2
デバイスパスを指定します。このフィールドで指定されたデバイスパスが存在しない場合、LVMCluster CR は Failed 状態に移行します。
3
オプションのデバイスパスを指定します。このフィールドで指定されたデバイスパスが存在しない場合、LVM ストレージはエラーを発生させずにデバイスを無視します。
重要
デバイスが LVM ボリュームグループに追加された後は、デバイスを削除できません。
Save をクリックします。

5.4.6.3. RHACM を使用したシングルノード OpenShift クラスターのストレージをスケールアップする
リンクのコピー

RHACM を使用すると、シングルノード OpenShift クラスター内の既存のノードのストレージ容量をスケールアップできます。

前提条件

cluster-admin 権限を持つアカウントを使用して RHACM クラスターにアクセスできる。
RHACM を使用して LVMCluster カスタムリソース (CR) を作成した。
論理ボリュームマネージャー(LVM)ストレージで使用される、シングルノード OpenShift クラスターごとに、追加の未使用デバイスがあります。

手順

OpenShift Container Platform の認証情報を使用して RHACM CLI にログインします。
次のコマンドを実行して、RHACM を使用して作成した LVMCluster CR を編集します。
```
oc edit -f <file_name> -n <namespace>
```
```
$ oc edit -f <file_name> -n <namespace> 
```
1
Copy to Clipboard Toggle word wrap
1
<file_name> は、LVMCluster CR の名前に置き換えます。

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

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

Copy to Clipboard

Toggle word wrap

1: 論理ボリュームマネージャー(LVM)ボリュームグループに追加するデバイスへのパスを指定する設定が含まれています。デバイスパスは、paths フィールド、optionalPaths フィールド、またはその両方で指定できます。path と optionalPaths の両方でデバイスパスを指定しなかった場合、サポートされている未使用のデバイスが LVM Storage によって LVM ボリュームグループに追加されます。LVM ストレージは、デバイスパスが存在する場合にのみ、デバイスを LVM ボリュームグループに追加します。
2: デバイスパスを指定します。このフィールドで指定されたデバイスパスが存在しない場合、LVMCluster CR は Failed 状態に移行します。
3: オプションのデバイスパスを指定します。このフィールドで指定されたデバイスパスが存在しない場合、LVM ストレージはエラーを発生させずにデバイスを無視します。

重要

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

LVMCluster CR を保存します。

5.4.7. 永続ボリューム要求の拡張
リンクのコピー

クラスターのストレージをスケールアップした後、既存の永続ボリューム要求 (PVC) を拡張できます。

PVC を拡張するには、PVC の requests.storage フィールドを更新する必要があります。

前提条件

動的プロビジョニングを使用している。
PVC に関連付けられた StorageClass オブジェクトには、allowVolumeExpansion フィールドが true に設定されています。

手順

OpenShift CLI (oc) にログインします。
次のコマンドを実行して、spec.resources.requests.storage フィールドの値を現在の値より大きい値に更新します。
```
oc patch pvc <pvc_name> -n <application_namespace> -p \
'{ "spec": { "resources": { "requests": { "storage": "<desired_size>" }}}}' --type=merge
```
```
$ oc patch pvc <pvc_name> -n <application_namespace> -p \
```
1
```
'{ "spec": { "resources": { "requests": { "storage": "<desired_size>" }}}}' --type=merge 
```
2
Copy to Clipboard Toggle word wrap
1
<pvc_name> を、拡張する PVC の名前に置き換えます。
2
<desired_size> を、新しいサイズに置き換えて PVC を拡張します。

検証

サイズ変更が完了したことを確認するには、次のコマンドを実行します。
```
oc get pvc <pvc_name> -n <application_namespace> -o=jsonpath={.status.capacity.storage}
```
```
$ oc get pvc <pvc_name> -n <application_namespace> -o=jsonpath={.status.capacity.storage}
```
Copy to Clipboard Toggle word wrap
Logical Volume Manager (LVM)ストレージは、拡張中に Resizing 条件を PVC に追加します。PVC の拡張後、Resizing 条件を削除します。

5.4.8. 永続ボリューム要求の削除
リンクのコピー

OpenShift CLI (oc) を使用して、永続ボリューム要求 (PVC) を削除できます。

前提条件

cluster-admin パーミッションを持つユーザーとして OpenShift Container Platform にアクセスできる。

手順

OpenShift CLI (oc) にログインします。
次のコマンドを実行して、PVC を削除します。
```
oc delete pvc <pvc_name> -n <namespace>
```
```
$ oc delete pvc <pvc_name> -n <namespace>
```
Copy to Clipboard Toggle word wrap

検証

PVC が削除されたことを確認するには、次のコマンドを実行します。
```
oc get pvc -n <namespace>
```
```
$ oc get pvc -n <namespace>
```
Copy to Clipboard Toggle word wrap
削除された PVC は、このコマンドの出力には存在しません。

5.4.9. ボリュームスナップショットについて
リンクのコピー

LVM Storage によってプロビジョニングされる永続ボリューム要求 (PVC) のスナップショットを作成できます。

ボリュームスナップショットを使用して、次のアクションを実行できます。

アプリケーションデータをバックアップします。
重要
ボリュームスナップショットは元のデータと同じデバイスにあります。ボリュームスナップショットをバックアップとして使用するには、スナップショットを安全な場所に移動する必要があります。OpenShift API for Data Protection (OADP) のバックアップおよび復元ソリューションを使用できます。OADP の詳細は OADP の機能を参照してください。
ボリュームスナップショットが作成された状態に戻します。

注記

ボリュームクローンのボリュームスナップショットを作成することもできます。

5.4.9.1. ボリュームスナップショットの作成
リンクのコピー

シンプールの利用可能な容量とオーバープロビジョニングの制限に基づいて、ボリュームスナップショットを作成できます。ボリュームスナップショットを作成するには、VolumeSnapshot オブジェクトを作成する必要があります。

前提条件

cluster-admin パーミッションを持つユーザーとして OpenShift Container Platform にアクセスできる。
永続ボリューム要求 (PVC) が Bound 状態であることが確認されている。これは、一貫性のあるスナップショットに必要です。
PVC へのすべての I/O が停止されている。

手順

OpenShift CLI (oc) にログインします。
VolumeSnapshot オブジェクトを作成します。
VolumeSnapshot オブジェクトの例
```
apiVersion: snapshot.storage.k8s.io/v1
kind: VolumeSnapshot
metadata:
  name: lvm-block-1-snap 
spec:
  source:
    persistentVolumeClaimName: lvm-block-1 
  volumeSnapshotClassName: lvms-vg1 
```
```
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
Copy to Clipboard Toggle word wrap
1
ボリュームスナップショットの名前を指定します。
2
ソース PVC の名前を指定します。LVM Storage は、この PVC のスナップショットを作成します。
3
このフィールドをボリュームスナップショットクラスの名前に設定します。
注記
使用可能なボリュームスナップショットクラスのリストを取得するには、次のコマンドを実行します。
$ oc get volumesnapshotclass
Copy to Clipboard Toggle word wrap
次のコマンドを実行して、ソース PVC を作成した namespace にボリュームスナップショットを作成します。
```
oc create -f <file_name> -n <namespace>
```
```
$ oc create -f <file_name> -n <namespace>
```
Copy to Clipboard Toggle word wrap
LVM Storage は、PVC の読み取り専用コピーをボリュームスナップショットとして作成します。

検証

ボリュームスナップショットが作成されたことを確認するには、次のコマンドを実行します。

oc get volumesnapshot -n <namespace>

$ oc get volumesnapshot -n <namespace>

Copy to Clipboard

Toggle word wrap

出力例

NAME               READYTOUSE   SOURCEPVC     SOURCESNAPSHOTCONTENT   RESTORESIZE   SNAPSHOTCLASS   SNAPSHOTCONTENT                                    CREATIONTIME   AGE
lvm-block-1-snap   true         lvms-test-1                           1Gi           lvms-vg1        snapcontent-af409f97-55fc-40cf-975f-71e44fa2ca91   19s            19s

NAME               READYTOUSE   SOURCEPVC     SOURCESNAPSHOTCONTENT   RESTORESIZE   SNAPSHOTCLASS   SNAPSHOTCONTENT                                    CREATIONTIME   AGE
lvm-block-1-snap   true         lvms-test-1                           1Gi           lvms-vg1        snapcontent-af409f97-55fc-40cf-975f-71e44fa2ca91   19s            19s

Copy to Clipboard

Toggle word wrap

作成したボリュームスナップショットの READYTOUSE フィールドの値は true である必要があります。

5.4.9.2. ボリュームスナップショットの復元
リンクのコピー

ボリュームスナップショットを復元するには、dataSource.name フィールドをボリュームスナップショットの名前に設定して、永続ボリューム要求 (PVC) を作成する必要があります。

復元される PVC はボリュームスナップショットおよびソース PVC とは切り離されています。

前提条件

cluster-admin パーミッションを持つユーザーとして OpenShift Container Platform にアクセスできる。
ボリュームスナップショットが作成されている。

手順

OpenShift CLI (oc) にログインします。
ボリュームスナップショットを復元するための設定を使用して PersistentVolumeClaim オブジェクトを作成します。
ボリュームスナップショットを復元するための PersistentVolumeClaim オブジェクトの例
```
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
```
```
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
```
Copy to Clipboard Toggle word wrap
1
PVC のストレージサイズを指定します。要求された PVC のストレージサイズは、復元するボリュームスナップショットのストレージサイズ以上である必要があります。より大きな PVC が必要な場合は、ボリュームスナップショットを復元した後に PVC のサイズを変更することもできます。
2
このフィールドを、復元するボリュームスナップショットのソース PVC の storageClassName フィールドの値に設定します。
3
このフィールドを、復元するボリュームスナップショットの名前に設定します。
次のコマンドを実行して、ボリュームスナップショットを作成した namespace に PVC を作成します。
```
oc create -f <file_name> -n <namespace>
```
```
$ oc create -f <file_name> -n <namespace>
```
Copy to Clipboard Toggle word wrap

検証

ボリュームスナップショットが復元されたことを確認するには、復元された PVC を使用してワークロードを作成してから、以下のコマンドを実行します。

oc get pvc -n <namespace>

$ oc get pvc -n <namespace>

Copy to Clipboard

Toggle word wrap

出力例

NAME                  STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS   AGE
lvm-block-1-restore   Bound    pvc-e90169a8-fd71-4eea-93b8-817155f60e47   1Gi        RWO            lvms-vg1       5s

NAME                  STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS   AGE
lvm-block-1-restore   Bound    pvc-e90169a8-fd71-4eea-93b8-817155f60e47   1Gi        RWO            lvms-vg1       5s

Copy to Clipboard

Toggle word wrap

5.4.9.3. ボリュームスナップショットの削除
リンクのコピー

永続ボリューム要求 (PVC) のボリュームスナップショットを削除できます。

重要

永続ボリューム要求 (PVC) を削除すると、LVM Storage は永続ボリューム要求のみを削除し、永続ボリューム要求のスナップショットは削除しません。

前提条件

cluster-admin パーミッションを持つユーザーとして OpenShift Container Platform にアクセスできる。
削除するボリュームスナップショットが使用されていないことを確認している。

手順

OpenShift CLI (oc) にログインします。
次のコマンドを実行して、ボリュームのスナップショットを削除します。
```
oc delete volumesnapshot <volume_snapshot_name> -n <namespace>
```
```
$ oc delete volumesnapshot <volume_snapshot_name> -n <namespace>
```
Copy to Clipboard Toggle word wrap

検証

ボリュームスナップショットが削除されたことを確認するには、次のコマンドを実行します。
```
oc get volumesnapshot -n <namespace>
```
```
$ oc get volumesnapshot -n <namespace>
```
Copy to Clipboard Toggle word wrap
削除されたボリュームのスナップショットは、このコマンドの出力には存在しません。

5.4.10. ボリュームクローンについて
リンクのコピー

ボリュームクローンは、既存の永続ボリューム要求 (PVC) の複製です。ボリュームクローンを作成して、データのポイントインタイムコピーを作成できます。

5.4.10.1. ボリュームクローンの作成
リンクのコピー

永続ボリューム要求 (PVC) のクローンを作成するには、ソース永続ボリューム要求を作成した namespace に PersistentVolumeClaim オブジェクトを作成する必要があります。

重要

クローン作成された PVC には書き込みアクセス権限があります。

前提条件

ソース PVC が Bound 状態であることが確認されている。これは一貫性のあるクローンに必要です。

手順

OpenShift CLI (oc) にログインします。
PersistentVolumeClaim オブジェクトを作成します。
ボリュームクローンを作成するための PersistentVolumeClaim オブジェクトの例
```
kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: lvm-pvc-clone
spec:
  accessModes:
  - ReadWriteOnce
  storageClassName: lvms-vg1 
  volumeMode: Filesystem 
  dataSource:
    kind: PersistentVolumeClaim
    name: lvm-pvc 
  resources:
    requests:
      storage: 1Gi 
```
```
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
Copy to Clipboard Toggle word wrap
1
このフィールドを、ソース PVC の storageClassName フィールドの値に設定します。
2
このフィールドを、ソース PVC の volumeMode フィールドに設定します。
3
ソース PVC の名前を指定します。
4
クローン作成された PVC のストレージサイズを指定します。クローン作成された PVC のストレージサイズは、ソース PVC のストレージサイズ以上である必要があります。
次のコマンドを実行して、ソース PVC を作成した namespace に PVC を作成します。
```
oc create -f <file_name> -n <namespace>
```
```
$ oc create -f <file_name> -n <namespace>
```
Copy to Clipboard Toggle word wrap

検証

ボリュームクローンが作成されたことを確認するには、クローン作成された PVC を使用してワークロードを作成してから、以下のコマンドを実行します。

oc get pvc -n <namespace>

$ oc get pvc -n <namespace>

Copy to Clipboard

Toggle word wrap

出力例

NAME                STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS   AGE
lvm-block-1-clone   Bound    pvc-e90169a8-fd71-4eea-93b8-817155f60e47   1Gi        RWO            lvms-vg1       5s

NAME                STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS   AGE
lvm-block-1-clone   Bound    pvc-e90169a8-fd71-4eea-93b8-817155f60e47   1Gi        RWO            lvms-vg1       5s

Copy to Clipboard

Toggle word wrap

5.4.10.2. ボリュームクローンの削除
リンクのコピー

ボリュームクローンを削除できます。

重要

永続ボリューム要求 (PVC) を削除すると、LVM Storage はソース永続ボリューム要求のみを削除し、永続ボリューム要求のクローンは削除しません。

前提条件

cluster-admin パーミッションを持つユーザーとして OpenShift Container Platform にアクセスできる。

手順

OpenShift CLI (oc) にログインします。
次のコマンドを実行して、クローン作成された PVC を削除します。
```
oc delete pvc <clone_pvc_name> -n <namespace>
```
```
# oc delete pvc <clone_pvc_name> -n <namespace>
```
Copy to Clipboard Toggle word wrap

検証

ボリュームクローンが削除されたことを確認するには、次のコマンドを実行します。
```
oc get pvc -n <namespace>
```
```
$ oc get pvc -n <namespace>
```
Copy to Clipboard Toggle word wrap
削除されたボリュームクローンは、このコマンドの出力には存在しません。

5.4.11. シングルノード OpenShift クラスターでの LVM ストレージの更新
リンクのコピー

LVM ストレージを更新して、単一ノードの OpenShift バージョンとの互換性を確保できます。

前提条件

単一ノードの OpenShift クラスターを更新している。
以前のバージョンの LVM Storage がインストールされている。
OpenShift CLI (oc) がインストールされている。
cluster-admin 権限を持つアカウントを使用してクラスターにアクセスできる。

手順

OpenShift CLI (oc) にログインします。
次のコマンドを実行して、LVM Storage のインストール時に作成した Subscription カスタムリソース (CR) を更新します。
```
oc patch subscription lvms-operator -n openshift-storage --type merge --patch '{"spec":{"channel":"<update_channel>"}}'
```
```
$ oc patch subscription lvms-operator -n openshift-storage --type merge --patch '{"spec":{"channel":"<update_channel>"}}' 
```
1
Copy to Clipboard Toggle word wrap
1
<update_channel> を、インストールする LVM Storage のバージョンに置き換えます。たとえば、stable-4.19 です。

次のコマンドを実行して、更新イベントを表示し、インストールが完了していることを確認します。

oc get events -n openshift-storage

$ oc get events -n openshift-storage

Copy to Clipboard

Toggle word wrap

出力例

...
8m13s       Normal    RequirementsUnknown   clusterserviceversion/lvms-operator.v4.14   requirements not yet checked
8m11s       Normal    RequirementsNotMet    clusterserviceversion/lvms-operator.v4.14   one or more requirements couldn't be found
7m50s       Normal    AllRequirementsMet    clusterserviceversion/lvms-operator.v4.14   all requirements found, attempting install
7m50s       Normal    InstallSucceeded      clusterserviceversion/lvms-operator.v4.14   waiting for install components to report healthy
7m49s       Normal    InstallWaiting        clusterserviceversion/lvms-operator.v4.14   installing: waiting for deployment lvms-operator to become ready: deployment "lvms-operator" waiting for 1 outdated replica(s) to be terminated
7m39s       Normal    InstallSucceeded      clusterserviceversion/lvms-operator.v4.14   install strategy completed with no errors
...

...
8m13s       Normal    RequirementsUnknown   clusterserviceversion/lvms-operator.v4.14   requirements not yet checked
8m11s       Normal    RequirementsNotMet    clusterserviceversion/lvms-operator.v4.14   one or more requirements couldn't be found
7m50s       Normal    AllRequirementsMet    clusterserviceversion/lvms-operator.v4.14   all requirements found, attempting install
7m50s       Normal    InstallSucceeded      clusterserviceversion/lvms-operator.v4.14   waiting for install components to report healthy
7m49s       Normal    InstallWaiting        clusterserviceversion/lvms-operator.v4.14   installing: waiting for deployment lvms-operator to become ready: deployment "lvms-operator" waiting for 1 outdated replica(s) to be terminated
7m39s       Normal    InstallSucceeded      clusterserviceversion/lvms-operator.v4.14   install strategy completed with no errors
...

Copy to Clipboard

Toggle word wrap

検証

次のコマンドを実行して、LVM Storage のバージョンを確認します。

oc get subscription lvms-operator -n openshift-storage -o jsonpath='{.status.installedCSV}'

$ oc get subscription lvms-operator -n openshift-storage -o jsonpath='{.status.installedCSV}'

Copy to Clipboard

Toggle word wrap

出力例

lvms-operator.v4.14

lvms-operator.v4.14

Copy to Clipboard

Toggle word wrap

5.4.12. LVM Storage の監視
リンクのコピー

クラスターモニタリングを有効にするには、LVM Storage をインストールした namespace に次のラベルを追加する必要があります。

openshift.io/cluster-monitoring=true

openshift.io/cluster-monitoring=true

Copy to Clipboard

Toggle word wrap

重要

RHACM でクラスターモニタリングを有効にする方法の詳細は、可観測性およびカスタムメトリクスの追加を参照してください。

5.4.12.1. メトリクス
リンクのコピー

メトリクスを表示することで、LVM Storage を監視できます。

次の表は、topolvm メトリクスを説明しています。

Expand

表5.6 topolvm メトリクス
アラート	説明
`topolvm_thinpool_data_percent`	LVM シンプールで使用されているデータ領域の割合を示します。
`topolvm_thinpool_metadata_percent`	LVM シンプールで使用されているメタデータ領域の割合を示します。
`topolvm_thinpool_size_bytes`	LVM シンプールのサイズをバイト単位で示します。
`topolvm_volumegroup_available_bytes`	LVM ボリュームグループ内の利用可能な領域をバイト単位で示します。
`topolvm_volumegroup_size_bytes`	LVM ボリュームグループのサイズをバイト単位で示します。
`topolvm_thinpool_overprovisioned_available`	LVM シンプールの利用可能なオーバープロビジョニングサイズをバイト単位で示します。

注記

メトリクスは 10 分ごとに、または変更 (シンプールに新しい論理ボリュームが作成されるなど) があったときに更新されます。

5.4.12.2. アラート
リンクのコピー

シンプールとボリュームグループが最大ストレージ容量に達すると、それ以降の操作は失敗します。これにより、データ損失が発生する可能性があります。

LVM Storage は、シンプールとボリュームグループの使用量が特定の値を超えると、次のアラートを送信します。

Expand

表5.7 LVM Storage アラート
アラート	説明
`VolumeGroupUsageAtThresholdNearFull`	このアラートは、ボリュームグループとシンプールの両方の使用量がノード上で 75% を超えるとトリガーされます。データの削除またはボリュームグループの拡張が必要です。
`VolumeGroupUsageAtThresholdCritical`	このアラートは、ボリュームグループとシンプールの両方の使用量がノード上で 85% を超えるとトリガーされます。この場合、ボリュームグループは、かなりいっぱいになっています。データの削除またはボリュームグループの拡張が必要です。
`ThinPoolDataUsageAtThresholdNearFull`	このアラートは、ボリュームグループのシンプールのデータ使用率がノードで 75% を超えるとトリガーされます。データの削除またはシンプールの拡張が必要です。
`ThinPoolDataUsageAtThresholdCritical`	このアラートは、ボリュームグループ内のシンプールのデータ使用量がノード上で 85% を超えるとトリガーされます。データの削除またはシンプールの拡張が必要です。
`ThinPoolMetaDataUsageAtThresholdNearFull`	このアラートは、ボリュームグループ内のシンプールのメタデータ使用量がノード上で 75% を超えるとトリガーされます。データの削除またはシンプールの拡張が必要です。
`ThinPoolMetaDataUsageAtThresholdCritical`	このアラートは、ボリュームグループ内のシンプールのメタデータ使用量がノード上で 85% を超えるとトリガーされます。データの削除またはシンプールの拡張が必要です。

5.4.13. CLI を使用した LVM Storage のインストール
リンクのコピー

OpenShift CLI (oc) を使用して LVM ストレージをアンインストールできます。

前提条件

cluster-admin 権限を持つユーザーとして oc にログインしている。
LVM Storage によってプロビジョニングされた永続ボリューム要求 (PVC)、ボリュームスナップショット、およびボリュームクローンが削除されている。これらのリソースを使用しているアプリケーションも削除されている。
LVMCluster カスタムリソース (CR) が削除されている。

手順

次のコマンドを実行して、LVM Storage Operator の currentCSV の値を取得します。

oc get subscription.operators.coreos.com lvms-operator -n <namespace> -o yaml | grep 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

currentCSV: lvms-operator.v4.15.3

Copy to Clipboard

Toggle word wrap

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

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

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

Copy to Clipboard

Toggle word wrap

出力例

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

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

Copy to Clipboard

Toggle word wrap

次のコマンドを実行して、ターゲット namespace 内の LVM Storage Operator の CSV を削除します。
```
oc delete clusterserviceversion <currentCSV> -n <namespace>
```
```
$ 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
```
```
clusterserviceversion.operators.coreos.com "lvms-operator.v4.15.3" deleted
```
Copy to Clipboard Toggle word wrap

検証

LVM Storage Operator がアンインストールされたことを確認するには、次のコマンドを実行します。
```
oc get csv -n <namespace>
```
```
$ oc get csv -n <namespace>
```
Copy to Clipboard Toggle word wrap
LVM Storage Operator が正常にアンインストールされた場合、このコマンドの出力には表示されません。

5.4.14. Web コンソールを使用した LVM ストレージのアンインストール
リンクのコピー

OpenShift Container Platform Web コンソールを使用して論理ボリュームマネージャー(LVM)ストレージをアンインストールできます。

前提条件

cluster-admin 権限を持つユーザーとしてシングルノード OpenShift クラスターにアクセスできます。
LVM Storage によってプロビジョニングされた永続ボリューム要求 (PVC)、ボリュームスナップショット、およびボリュームクローンが削除されている。これらのリソースを使用しているアプリケーションも削除されている。
LVMCluster カスタムリソース (CR) が削除されている。

手順

OpenShift Container Platform Web コンソールにログインします。
Operators Installed Operators をクリックします。
openshift-storage namespace で LVM Storage をクリックします。
Details タブをクリックします。
Actions メニューから、Uninstall Operator をクリックします。
オプション: プロンプトが表示されたら、Delete all operand instances for this operator チェックボックスを選択して、LVM Storage のオペランドインスタンスを削除します。
Uninstall をクリックします。

5.4.15. RHACM を使用してインストールされた LVM Storage のアンインストール
リンクのコピー

RHACM を使用してインストールした論理ボリュームマネージャー(LVM)ストレージをアンインストールするには、LVM ストレージのインストールと設定用に作成した RHACM ポリシー カスタムリソース(CR)を削除する必要があります。

前提条件

cluster-admin 権限を持つユーザーとして RHACM クラスターにアクセスできる。
LVM ストレージによってプロビジョニングされた以下のリソースを削除しました。
- 永続ボリューム要求 (PVC)
- ボリュームスナップショット
- ボリュームのクローン作成
  これらのリソースを使用するアプリケーションも削除している。
RHACM を使用して作成した LVMCluster CR を削除した。

手順

OpenShift CLI (oc) にログインします。
次のコマンドを実行して、LVM ストレージのインストールと設定用に作成した RHACM ポリシー CR を削除します。
```
oc delete -f <policy> -n <namespace>
```
```
$ oc delete -f <policy> -n <namespace> 
```
1
Copy to Clipboard Toggle word wrap
1
<policy> は、Policy CR YAML ファイルの名前に置き換えます。

LVM ストレージをアンインストールする設定で Policy CR YAML ファイルを作成します。

LVM Storage をアンインストールするための Policy CR の例

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

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

Copy to Clipboard

Toggle word wrap

次のコマンドを実行して Policy CR を作成します。
```
oc create -f <policy> -ns <namespace>
```
```
$ oc create -f <policy> -ns <namespace>
```
Copy to Clipboard Toggle word wrap

5.4.16. must-gather を使用したログファイルおよび診断情報のダウンロード
リンクのコピー

LVM Storage が問題を自動的に解決できない場合、must-gather ツールを使用してログファイルと診断情報を収集し、ユーザーまたは Red Hat サポートが問題を確認して解決策を決定できるようにします。

手順

LVM Storage クラスターに接続されているクライアントから must-gather コマンドを実行します。

oc adm must-gather --image=registry.redhat.io/lvms4/lvms-must-gather-rhel9:v4.14 --dest-dir=<directory_name>

$ oc adm must-gather --image=registry.redhat.io/lvms4/lvms-must-gather-rhel9:v4.14 --dest-dir=<directory_name>

Copy to Clipboard

Toggle word wrap

5.4.17. 永続ストレージのトラブルシューティング
リンクのコピー

論理ボリュームマネージャー (LVM) ストレージを使用して永続ストレージを設定するときに、トラブルシューティングが必要ないくつかの問題が発生する可能性があります。

5.4.17.1. 保留状態でスタックしている PVC を調査する
リンクのコピー

永続ボリューム要求 (PVC) は、次の理由により Pending 状態のままになることがあります。

コンピューティングリソースが足りない
ネットワークの問題
ストレージクラスまたはノードセレクターが一致していない
利用可能な永続ボリューム (PV) がない
PV を持つノードが Not Ready 状態にある

前提条件

OpenShift CLI (oc) がインストールされている。
cluster-admin 権限を持つユーザーとして OpenShift CLI (oc) にログインしている。

手順

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

oc get pvc

$ oc get pvc

Copy to Clipboard

Toggle word wrap

出力例

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

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

Copy to Clipboard

Toggle word wrap

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

oc describe pvc <pvc_name>

$ 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

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

5.4.17.2. ストレージクラスがない状態からの回復
リンクのコピー

storage class not found というエラーが発生した場合は、LVMCluster カスタムリソース (CR) をチェックし、すべての論理ボリュームマネージャー (LVM) ストレージ Pod が Running 状態であることを確認します。

前提条件

OpenShift CLI (oc) がインストールされている。
cluster-admin 権限を持つユーザーとして OpenShift CLI (oc) にログインしている。

手順

以下のコマンドを実行して、LVMCluster CR が存在することを確認します。
```
oc get lvmcluster -n openshift-storage
```
```
$ oc get lvmcluster -n openshift-storage
```
Copy to Clipboard Toggle word wrap
出力例
```
NAME            AGE
my-lvmcluster   65m
```
```
NAME            AGE
my-lvmcluster   65m
```
Copy to Clipboard Toggle word wrap
LVMCluster CR が存在しない場合は、LVMCluster CR を作成します。詳細は、「LVMCluster カスタムリソースを作成する方法」を参照してください。

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

oc get pods -n openshift-storage

$ 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

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
```
```
$ oc logs -l app.kubernetes.io/component=vg-manager -n openshift-storage
```
Copy to Clipboard Toggle word wrap

5.4.17.3. ノード障害からの回復
リンクのコピー

クラスター内のノード障害が原因で、永続ボリューム要求 (PVC) が Pending 状態のままになることがあります。

障害が発生したノードを特定するには、topolvm-node Pod の再起動回数を調べることができます。再起動回数の増加は、基礎となるノードに潜在的な問題があることを示しており、さらなる調査とトラブルシューティングが必要になる場合があります。

前提条件

OpenShift CLI (oc) がインストールされている。
cluster-admin 権限を持つユーザーとして OpenShift CLI (oc) にログインしている。

手順

次のコマンドを実行して、topolvm-node Pod インスタンスの再起動回数を調べます。

oc get pods -n openshift-storage

$ 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
topolvm-node-54as8                    4/4     Running   0             66m
topolvm-node-78fft                    4/4     Running   17 (8s ago)   66m
vg-manager-r6zdv                      1/1     Running   0             66m
vg-manager-990ut                      1/1     Running   0             66m
vg-manager-an118                      1/1     Running   0             66m

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
topolvm-node-54as8                    4/4     Running   0             66m
topolvm-node-78fft                    4/4     Running   17 (8s ago)   66m
vg-manager-r6zdv                      1/1     Running   0             66m
vg-manager-990ut                      1/1     Running   0             66m
vg-manager-an118                      1/1     Running   0             66m

Copy to Clipboard

Toggle word wrap

次のステップ

ノードの問題を解決した後も PVC が Pending 状態のままになっている場合は、強制クリーンアップを実行する必要があります。詳細は、「強制クリーンアップの実行」を参照してください。

5.4.17.4. ディスク障害からの回復
リンクのコピー

永続ボリューム要求 (PVC) に関連するイベントの検査中にエラーメッセージが表示された場合は、基になるボリュームまたはディスクに問題がある可能性があります。

ディスクおよびボリュームのプロビジョニングの問題が発生すると、Failed to provision volume with storage class <storage_class_name> などの一般的なエラーメッセージが表示されます。一般的なエラーメッセージの後には、特定のボリューム障害のエラーメッセージが続きます。

以下の表は、ボリューム障害のエラーメッセージを説明しています。

Expand

表5.8 ボリューム障害のエラーメッセージ
Error message	説明
`Failed to check volume existence`	ボリュームがすでに存在するかどうかを確認する際に問題が発生したことを示します。ボリューム検証の失敗は、ネットワーク接続の問題やその他の障害によって発生する可能性があります。
`Failed to bind volume`	使用可能な永続ボリューム (PV) が PVC の要件と一致しない場合、ボリュームのバインドに失敗する可能性があります。
`FailedMount` または `FailedAttachVolume`	このエラーは、ボリュームをノードにマウントしようとしたときに問題が発生したことを示します。ディスクに障害が発生した場合、Pod が PVC を使用しようとしたときにこのエラーが表示されることがあります。
`FailedUnMount`	このエラーは、ノードからボリュームをアンマウントしようとしたときに問題が発生したことを示します。ディスクに障害が発生した場合、Pod が PVC を使用しようとしたときにこのエラーが表示されることがあります。
`Volume is already exclusively attached to one node and cannot be attached to another`	このエラーは、`ReadWriteMany` アクセスモードをサポートしていないストレージソリューションで発生する可能性があります。

前提条件

OpenShift CLI (oc) がインストールされている。
cluster-admin 権限を持つユーザーとして OpenShift CLI (oc) にログインしている。

手順

次のコマンドを実行して、PVC に関連付けられたイベントを検査します。
```
oc describe pvc <pvc_name>
```
```
$ oc describe pvc <pvc_name> 
```
1
Copy to Clipboard Toggle word wrap
1
<pvc_name> を PVC の名前に置き換えます。
問題が発生しているホストへの直接接続を確立します。
ディスクの問題を解決します。

次のステップ

ディスクの問題を解決した後もボリューム障害メッセージが続く場合や再発する場合は、強制クリーンアップを実行する必要があります。詳細は、「強制クリーンアップの実行」を参照してください。

5.4.17.5. 強制クリーンアップの実行
リンクのコピー

トラブルシューティング手順を完了した後もディスクまたはノード関連の問題が解決しない場合は、強制クリーンアップを実行する必要があります。強制クリーンアップは、永続的な問題に対処し、論理ボリュームマネージャー (LVM) ストレージが確実に適切に機能するために使用されます。

前提条件

OpenShift CLI (oc) がインストールされている。
cluster-admin 権限を持つユーザーとして OpenShift CLI (oc) にログインしている。
LVM ストレージを使用して作成されたすべての永続ボリューム要求 (PVC) が削除されている。
LVM ストレージを使用して作成された PVC を使用している Pod を停止している。

手順

次のコマンドを実行して、openshift-storage namespace に切り替えます。
```
oc project openshift-storage
```
```
$ oc project openshift-storage
```
Copy to Clipboard Toggle word wrap
以下のコマンドを実行して、LogicalVolume カスタムリソース (CR) が存在するか確認します。
```
oc get logicalvolume
```
```
$ 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 の名前に置き換えます。
以下のコマンドを実行して、LVMVolumeGroup CR が存在するか確認します。
```
oc get lvmvolumegroup
```
```
$ 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 の名前に置き換えます。
以下のコマンドを実行して、LVMVolumeGroupNodeStatus CR を削除します。
```
oc delete lvmvolumegroupnodestatus --all
```
```
$ oc delete lvmvolumegroupnodestatus --all
```
Copy to Clipboard Toggle word wrap
次のコマンドを実行して、LVMCluster CR を削除します。
```
oc delete lvmcluster --all
```
```
$ 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 の名前に置き換えます。

5.4.1. Logical Volume Manager Storage のインストールリンクのコピーリンクがクリップボードにコピーされました!

5.4.1.1. LVM Storage をインストールするための前提条件リンクのコピーリンクがクリップボードにコピーされました!

5.4.1.2. CLI を使用した LVM Storage のインストールリンクのコピーリンクがクリップボードにコピーされました!

5.4.1.3. Web コンソールを使用した LVM Storage のインストールリンクのコピーリンクがクリップボードにコピーされました!

5.4.1.4. 非接続環境での LVM Storage のインストールリンクのコピーリンクがクリップボードにコピーされました!

5.4.1.5. RHACM を使用した LVM Storage のインストールリンクのコピーリンクがクリップボードにコピーされました!

5.4.2. LVMCluster カスタムリソースについてリンクのコピーリンクがクリップボードにコピーされました!

5.4.2.1. LVMCluster CR のフィールドの説明リンクのコピーリンクがクリップボードにコピーされました!

5.4.2.2. ボリュームグループへのデバイスの追加についてリンクのコピーリンクがクリップボードにコピーされました!

5.4.3. LVMCluster カスタムリソースを作成する方法リンクのコピーリンクがクリップボードにコピーされました!

5.4.3.1. CLI を使用した LVMCluster CR の作成リンクのコピーリンクがクリップボードにコピーされました!

5.4.3.2. Web コンソールを使用した LVMCluster CR の作成リンクのコピーリンクがクリップボードにコピーされました!

5.4.3.3. RHACM を使用した LVMCluster CR の作成リンクのコピーリンクがクリップボードにコピーされました!

5.4.4. LVMCluster カスタムリソースを削除する方法リンクのコピーリンクがクリップボードにコピーされました!

5.4.4.1. CLI を使用した LVMCluster CR の削除リンクのコピーリンクがクリップボードにコピーされました!

5.4.4.2. Web コンソールを使用した LVMCluster CR の削除リンクのコピーリンクがクリップボードにコピーされました!

5.4.4.3. RHACM を使用した LVMCluster CR の削除リンクのコピーリンクがクリップボードにコピーされました!

5.4.5. ストレージのプロビジョニングリンクのコピーリンクがクリップボードにコピーされました!

5.4.6. シングルノード OpenShift クラスターのストレージをスケールアップする方法リンクのコピーリンクがクリップボードにコピーされました!

5.4.6.1. CLI を使用した単一ノード OpenShift クラスターのストレージをスケールアップするリンクのコピーリンクがクリップボードにコピーされました!

5.4.6.2. Web コンソールを使用したシングルノード OpenShift クラスターのストレージのスケールアップリンクのコピーリンクがクリップボードにコピーされました!

5.4.6.3. RHACM を使用したシングルノード OpenShift クラスターのストレージをスケールアップするリンクのコピーリンクがクリップボードにコピーされました!

5.4.7. 永続ボリューム要求の拡張リンクのコピーリンクがクリップボードにコピーされました!

5.4.8. 永続ボリューム要求の削除リンクのコピーリンクがクリップボードにコピーされました!

5.4.9. ボリュームスナップショットについてリンクのコピーリンクがクリップボードにコピーされました!

5.4.9.1. ボリュームスナップショットの作成リンクのコピーリンクがクリップボードにコピーされました!

5.4.9.2. ボリュームスナップショットの復元リンクのコピーリンクがクリップボードにコピーされました!

5.4.9.3. ボリュームスナップショットの削除リンクのコピーリンクがクリップボードにコピーされました!

5.4.10. ボリュームクローンについてリンクのコピーリンクがクリップボードにコピーされました!

5.4.10.1. ボリュームクローンの作成リンクのコピーリンクがクリップボードにコピーされました!

5.4.10.2. ボリュームクローンの削除リンクのコピーリンクがクリップボードにコピーされました!

5.4.11. シングルノード OpenShift クラスターでの LVM ストレージの更新リンクのコピーリンクがクリップボードにコピーされました!

5.4.12. LVM Storage の監視リンクのコピーリンクがクリップボードにコピーされました!

5.4.12.1. メトリクスリンクのコピーリンクがクリップボードにコピーされました!

5.4.12.2. アラートリンクのコピーリンクがクリップボードにコピーされました!

5.4.13. CLI を使用した LVM Storage のインストールリンクのコピーリンクがクリップボードにコピーされました!

5.4.14. Web コンソールを使用した LVM ストレージのアンインストールリンクのコピーリンクがクリップボードにコピーされました!

5.4.15. RHACM を使用してインストールされた LVM Storage のアンインストールリンクのコピーリンクがクリップボードにコピーされました!

5.4.16. must-gather を使用したログファイルおよび診断情報のダウンロードリンクのコピーリンクがクリップボードにコピーされました!

5.4.17. 永続ストレージのトラブルシューティングリンクのコピーリンクがクリップボードにコピーされました!

5.4.17.1. 保留状態でスタックしている PVC を調査するリンクのコピーリンクがクリップボードにコピーされました!

5.4.17.2. ストレージクラスがない状態からの回復リンクのコピーリンクがクリップボードにコピーされました!

5.4.17.3. ノード障害からの回復リンクのコピーリンクがクリップボードにコピーされました!

5.4.17.4. ディスク障害からの回復リンクのコピーリンクがクリップボードにコピーされました!

5.4.17.5. 強制クリーンアップの実行リンクのコピーリンクがクリップボードにコピーされました!

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

5.4.1. Logical Volume Manager Storage のインストール
リンクのコピー

5.4.1.1. LVM Storage をインストールするための前提条件
リンクのコピー

5.4.1.2. CLI を使用した LVM Storage のインストール
リンクのコピー

5.4.1.3. Web コンソールを使用した LVM Storage のインストール
リンクのコピー

5.4.1.4. 非接続環境での LVM Storage のインストール
リンクのコピー

5.4.1.5. RHACM を使用した LVM Storage のインストール
リンクのコピー

5.4.2. LVMCluster カスタムリソースについて
リンクのコピー

5.4.2.1. LVMCluster CR のフィールドの説明
リンクのコピー

5.4.2.2. ボリュームグループへのデバイスの追加について
リンクのコピー

5.4.3. LVMCluster カスタムリソースを作成する方法
リンクのコピー

5.4.3.1. CLI を使用した LVMCluster CR の作成
リンクのコピー

5.4.3.2. Web コンソールを使用した LVMCluster CR の作成
リンクのコピー

5.4.3.3. RHACM を使用した LVMCluster CR の作成
リンクのコピー

5.4.4. LVMCluster カスタムリソースを削除する方法
リンクのコピー

5.4.4.1. CLI を使用した LVMCluster CR の削除
リンクのコピー

5.4.4.2. Web コンソールを使用した LVMCluster CR の削除
リンクのコピー

5.4.4.3. RHACM を使用した LVMCluster CR の削除
リンクのコピー

5.4.5. ストレージのプロビジョニング
リンクのコピー

5.4.6. シングルノード OpenShift クラスターのストレージをスケールアップする方法
リンクのコピー

5.4.6.1. CLI を使用した単一ノード OpenShift クラスターのストレージをスケールアップする
リンクのコピー

5.4.6.2. Web コンソールを使用したシングルノード OpenShift クラスターのストレージのスケールアップ
リンクのコピー

5.4.6.3. RHACM を使用したシングルノード OpenShift クラスターのストレージをスケールアップする
リンクのコピー

5.4.7. 永続ボリューム要求の拡張
リンクのコピー

5.4.8. 永続ボリューム要求の削除
リンクのコピー

5.4.9. ボリュームスナップショットについて
リンクのコピー

5.4.9.1. ボリュームスナップショットの作成
リンクのコピー

5.4.9.2. ボリュームスナップショットの復元
リンクのコピー

5.4.9.3. ボリュームスナップショットの削除
リンクのコピー

5.4.10. ボリュームクローンについて
リンクのコピー

5.4.10.1. ボリュームクローンの作成
リンクのコピー

5.4.10.2. ボリュームクローンの削除
リンクのコピー

5.4.11. シングルノード OpenShift クラスターでの LVM ストレージの更新
リンクのコピー

5.4.12. LVM Storage の監視
リンクのコピー

5.4.12.1. メトリクス
リンクのコピー

5.4.12.2. アラート
リンクのコピー

5.4.13. CLI を使用した LVM Storage のインストール
リンクのコピー

5.4.14. Web コンソールを使用した LVM ストレージのアンインストール
リンクのコピー

5.4.15. RHACM を使用してインストールされた LVM Storage のアンインストール
リンクのコピー

5.4.16. must-gather を使用したログファイルおよび診断情報のダウンロード
リンクのコピー

5.4.17. 永続ストレージのトラブルシューティング
リンクのコピー

5.4.17.1. 保留状態でスタックしている PVC を調査する
リンクのコピー

5.4.17.2. ストレージクラスがない状態からの回復
リンクのコピー

5.4.17.3. ノード障害からの回復
リンクのコピー

5.4.17.4. ディスク障害からの回復
リンクのコピー

5.4.17.5. 強制クリーンアップの実行
リンクのコピー