第5章 ローカルストレージを使用した永続ストレージ
5.1. ローカルストレージの概要 リンクのコピーリンクがクリップボードにコピーされました!
ローカルストレージは、クラスターノードに接続されたディスクに直接アクセスでき、ネットワーク接続ストレージやクラウドベースのストレージよりも低レイテンシーと高スループットを実現します。パフォーマンス重視のワークロード、シングルノードクラスター、またはクラウドストレージインフラストラクチャーのない環境にローカルストレージを使用します。
5.1.1. ローカルストレージオプションの概要 リンクのコピーリンクがクリップボードにコピーされました!
OpenShift Container Platform は、ノードローカルストレージをプロビジョニングするための 3 つのソリューションを提供します。それぞれ、動的プロビジョニングとトポロジー認識のためのさまざまな機能を提供します。ノードローカルストレージは、ワークロードを特定のノードにバインドします。
ローカルストレージをプロビジョニングするには、次のいずれかのソリューションを使用できます。
- HostPath Provisioner (HPP)
- Local Storage Operator (LSO)
- Logical Volume Manager (LVM) Storage
これらのソリューションは、ノードローカルストレージのプロビジョニングのみをサポートします。ワークロードは、ストレージを提供するノードにバインドされます。ノードが使用できなくなると、ワークロードも使用できなくなります。ノード障害が発生したときにワークロードの可用性を維持するには、アクティブまたはパッシブのレプリケーションメカニズムにより、ストレージデータのレプリケーションを確実に実行する必要があります。
5.1.1.1. HostPath Provisioner 機能の概要 リンクのコピーリンクがクリップボードにコピーされました!
HostPath Provisioner (HPP) を使用すると、次の操作を実行できます。
- ローカルストレージをプロビジョニングするために、ホストファイルシステムパスをストレージクラスにマップする。
- ストレージを使用するために、ストレージクラスを静的に作成してノードにファイルシステムパスを設定する。
- ストレージクラスに基づいて永続ボリューム (PV) を静的にプロビジョニングする。
- 基盤となるストレージトポロジーを考慮しながら、ワークロードと PersistentVolumeClaim (PVC) を作成する。
HPP はアップストリームの Kubernetes で利用できます。ただし、アップストリームの Kubernetes から HPP を使用することは推奨しません。
5.1.1.2. Local Storage Operator の機能の概要 リンクのコピーリンクがクリップボードにコピーされました!
Local Storage Operator (LSO) を使用すると、次の操作を実行できます。
- デバイス設定を変更せずに、ストレージデバイス (ディスクまたはパーティション) をストレージクラスに割り当てる。
-
LocalVolumeカスタムリソース (CR) を設定して、PV とストレージクラスを静的にプロビジョニングする。 - 基盤となるストレージトポロジーを考慮しながら、ワークロードと PVC を作成する。
LSO は Red Hat によって開発および提供されています。
5.1.1.3. LVM Storage の機能の概要 リンクのコピーリンクがクリップボードにコピーされました!
Logical Volume Manager (LVM) Storage を使用すると、次の操作を実行できます。
- ストレージデバイス (ディスクまたはパーティション) を lvm2 ボリュームグループとして設定し、ボリュームグループをストレージクラスとして公開する。
- ノードトポロジーを考慮せずに PVC を使用してワークロードを作成し、ストレージを要求する。
LVM Storage は TopoLVM CSI ドライバーを使用して、トポロジー内のノードにストレージスペースを動的に割り当て、PV をプロビジョニングします。
LVM Storage は、Red Hat によって開発および保守されています。LVM Storage に付属する CSI ドライバーは、アップストリームプロジェクトの "topolvm" です。
5.1.2. LVM Storage、LSO、HPP の比較 リンクのコピーリンクがクリップボードにコピーされました!
LVM Storage、Local Storage Operator (LSO)、および HostPath Provisioner (HPP) をストレージタイプ、コア機能、パフォーマンス、および分離ごとに比較し、クラスターに最適なローカルストレージプロビジョニングソリューションを決定します。
5.1.2.1. ストレージタイプおよびファイルシステムのサポートの比較 リンクのコピーリンクがクリップボードにコピーされました!
次の表は、ローカルストレージをプロビジョニングするために LVM Storage、Local Storage Operator (LSO)、および HostPath Provisioner (HPP) によって提供されるストレージタイプおよびファイルシステムのサポートを比較したものです。
| 機能 | LVM Storage | LSO | HPP |
|---|---|---|---|
| ブロックストレージのサポート | はい | はい | いいえ |
| ファイルストレージのサポート | はい | はい | はい |
| オブジェクトストレージのサポート [1] | いいえ | いいえ | いいえ |
| 利用可能なファイルシステム |
|
| ノード上で使用できるマウントされたシステムがすべてサポートされます。 |
-
いずれのソリューション (LVM Storage、LSO、HPP) もオブジェクトストレージをサポートしていません。したがって、オブジェクトストレージを使用する場合は、Red Hat OpenShift Data Foundation の
MultiClusterGatewayなどの S3 オブジェクトストレージソリューションが必要です。どのソリューションも、S3 オブジェクトストレージソリューションの基盤となるストレージプロバイダーとして機能します。
5.1.2.2. コア機能のサポートの比較 リンクのコピーリンクがクリップボードにコピーされました!
次の表は、LVM Storage、Local Storage Operator (LSO)、および HostPath Provisioner (HPP) によるローカルストレージのプロビジョニングに関するコア機能のサポート状況を比較したものです。
| 機能 | LVM Storage | LSO | HPP |
|---|---|---|---|
| 自動ファイルシステムフォーマット設定のサポート | はい | はい | 該当なし |
| 動的プロビジョニングのサポート | はい | いいえ | いいえ |
| ソフトウェア Redundant Array of Independent Disks (RAID) アレイの使用のサポート | はい 4.15 以降でサポートされています。 | はい | はい |
| 透過的なディスク暗号化のサポート | はい 4.16 以降でサポートされています。 | はい | はい |
| ボリュームベースのディスク暗号化のサポート | いいえ | いいえ | いいえ |
| 非接続インストールのサポート | はい | はい | はい |
| PVC 拡張のサポート | はい | いいえ | いいえ |
| ボリュームスナップショットとボリュームクローンのサポート | はい | いいえ | いいえ |
| シンプロビジョニングのサポート | はい デバイスはデフォルトでシンプロビジョニングされます。 | はい シンプロビジョニングされたボリュームを参照するようにデバイスを設定できます。 | はい シンプロビジョニングされたボリュームを参照するパスを設定できます。 |
| 自動ディスク検出とセットアップのサポート | はい
インストール時および実行時に自動ディスク検出を利用できます。既存のストレージクラスのストレージ容量を増やすために、ディスクを | テクノロジープレビュー インストール時に自動ディスク検出を利用できます。 | いいえ |
5.1.2.3. パフォーマンス機能と分離機能の比較 リンクのコピーリンクがクリップボードにコピーされました!
次の表は、ローカルストレージのプロビジョニングにおける LVM Storage、Local Storage Operator (LSO)、および HostPath Provisioner (HPP) のパフォーマンス機能と分離機能を比較したものです。
| 機能 | LVM Storage | LSO | HPP |
|---|---|---|---|
| パフォーマンス | I/O スピードが、同じストレージクラスを使用するすべてのワークロードで共有されます。 ブロックストレージでは直接 I/O 操作が可能です。 シンプロビジョニングがパフォーマンスに影響を与える可能性があります。 | I/O は LSO 設定によって異なります。 ブロックストレージでは直接 I/O 操作が可能です。 | I/O スピードが、同じストレージクラスを使用するすべてのワークロードで共有されます。 基盤となるファイルシステムによる制限が、I/O スピードに影響を与える可能性があります。 |
| 分離境界 [1] | LVM 論理ボリューム (LV) HPP と比較して、より高いレベルの分離を提供します。 | LVM 論理ボリューム (LV) HPP と比較して、より高いレベルの隔離を提供します。 | ファイルシステムパス LSO および LVM Storage と比較して、より低いレベルの分離を提供します。 |
- 分離境界とは、ローカルストレージリソースを使用するさまざまなワークロードまたはアプリケーション間の分離レベルを指します。
5.1.2.4. 追加機能のサポートの比較 リンクのコピーリンクがクリップボードにコピーされました!
次の表は、LVM Storage、Local Storage Operator (LSO)、および HostPath Provisioner (HPP) が提供する、ローカルストレージをプロビジョニングするための追加機能を比較したものです。
| 機能 | LVM Storage | LSO | HPP |
|---|---|---|---|
| 汎用エフェメラルボリュームのサポート | はい | いいえ | いいえ |
| CSI インラインエフェメラルボリュームのサポート | いいえ | いいえ | いいえ |
| ストレージトポロジーのサポート | はい CSI ノードトポロジーのサポート | はい LSO は、ノード toleration を通じてストレージトポロジーの部分的なサポートを提供します。 | いいえ |
|
| いいえ | いいえ | いいえ |
-
どのソリューション (LVM Storage、LSO、HPP) にも、
ReadWriteOnce(RWO) アクセスモードがあります。RWO アクセスモードでは、同じノード上の複数の Pod からのアクセスが可能になります。
5.2. ローカルボリュームを使用した永続ストレージ リンクのコピーリンクがクリップボードにコピーされました!
OpenShift Container Platform は、ローカルボリュームを使用する永続ストレージでプロビジョニングすることが可能です。ローカルの永続ボリュームを使用すると、標準の永続ボリューム要求インターフェイスを使用して、ディスクやパーティションなどのローカルのストレージデバイスにアクセスできます。
5.2.1. Local Storage Operator の概要 リンクのコピーリンクがクリップボードにコピーされました!
ローカルボリュームは、Pod をノードに手動でスケジュールせずに使用できます。ボリュームのノード制約がシステムによって認識されるためです。ただし、ローカルボリュームは、依然として基礎となるノードの可用性に依存しており、すべてのアプリケーションに適している訳ではありません。
ローカルボリュームは、静的に作成された永続ボリュームとしてのみ使用できます。
5.2.2. ローカルストレージ Operator のインストール リンクのコピーリンクがクリップボードにコピーされました!
Local Storage Operator (LSO) をインストールして、クラスター内のローカル永続ストレージボリュームをプロビジョニングおよび管理することができます。
-
openshift-local-storageプロジェクトを作成します。 - CLI または OpenShift Container Platform Web コンソールを使用して LSO をインストールして設定します。
5.2.2.1. Local Storage Operator のローカルプロジェクトの作成 リンクのコピーリンクがクリップボードにコピーされました!
Local Storage Operator (LSO) をインストールして、クラスター内のローカル永続ストレージボリュームをプロビジョニングおよび管理するには、まず openshift-local-storage プロジェクトを作成します。
前提条件
- OpenShift Container Platform Web コンソールまたはコマンドラインインターフェイス (CLI) へのアクセス。
手順
次のコマンドを実行して、
openshift-local-storageプロジェクトを作成します。$ oc adm new-project openshift-local-storageオプション: インフラストラクチャーノードでのローカルストレージの作成を許可します。
ロギングやモニタリングなどのコンポーネントに対応するために、LSO を使用してインフラストラクチャーノードでボリュームを作成する必要がある場合があります。
LSO にワーカーノードだけでなくインフラストラクチャーノードが含まれるように、デフォルトのノードセレクターを調整する必要があります。
LSO がクラスター全体のデフォルトセレクターを継承しないようにするには、次のコマンドを実行します。
$ oc annotate namespace openshift-local-storage openshift.io/node-selector=''オプション: 単一ノードデプロイメントの CPU の管理プールでローカルストレージを実行できるようにします。
シングルノードデプロイメントで LSO を使用し、
managementプールに属する CPU の使用を許可します。この手順は、管理ワークロードパーティショニングを使用する単一ノードインストールで実行します。管理 CPU プールで LSO を実行できるようにするには、次のコマンドを実行します。
$ oc annotate namespace openshift-local-storage workload.openshift.io/allowed='management'
次のステップ
LSO Operator をインストールします。
5.2.2.2. CLI を使用した Local Storage Operator のインストール リンクのコピーリンクがクリップボードにコピーされました!
Local Storage Operator (LSO) をインストールして、コマンドラインインターフェイス (CLI) を使用してクラスター内のローカル永続ストレージボリュームをプロビジョニングおよび管理します。
LSO は、デフォルトでは OpenShift Container Platform にはインストールされていません。以下の手順を使用してこの Operator をインストールし、クラスター内でローカルボリュームを有効にできるように設定します。
前提条件
-
openshift-local-storageプロジェクトにアクセスします。 - OpenShift Container Platform コマンドラインインターフェイス (CLI) へのアクセス:
手順
LSO の Operator グループおよびサブスクリプションを定義するために、オブジェクト YAML ファイル (例:
openshift-local-storage.yaml) を作成します。例: openshift-local-storage.yaml
apiVersion: operators.coreos.com/v1 kind: OperatorGroup metadata: name: local-operator-group namespace: openshift-local-storage spec: targetNamespaces: - openshift-local-storage --- apiVersion: operators.coreos.com/v1alpha1 kind: Subscription metadata: name: local-storage-operator namespace: openshift-local-storage spec: channel: stable installPlanApproval: Automatic name: local-storage-operator source: redhat-operators sourceNamespace: openshift-marketplacespec.installPlanApprovalは、インストールプランのユーザー認可ポリシーです。次のコマンドを実行して、LSO オブジェクトを作成します。
$ oc apply -f openshift-local-storage.yamlOperator Lifecycle Manager (OLM) が LSO を認識するようになりました。Operator の ClusterServiceVersion (CSV) がターゲット namespace に表示され、Operator で指定される API は作成用に利用可能になります。
すべての Pod および LSO が作成されていることを確認して、ローカルストレージのインストールを検証します。
次のコマンドを実行して、必要なすべての Pod が作成されていることを確認します。
$ oc -n openshift-local-storage get pods出力例
NAME READY STATUS RESTARTS AGE local-storage-operator-746bf599c9-vlt5t 1/1 Running 0 19mClusterServiceVersion (CSV) YAML マニフェストをチェックして、LSO が
openshift-local-storageプロジェクトで利用できることを確認します。$ oc get csvs -n openshift-local-storage出力例
NAME DISPLAY VERSION REPLACES PHASE local-storage-operator.4.2.26-202003230335 Local Storage 4.2.26-202003230335 Succeeded
結果
すべてのチェックに合格すると、LSO が正常にインストールされます。
5.2.2.3. OpenShift Container Platform Web コンソールを使用して Local Storage Operator をインストールする リンクのコピーリンクがクリップボードにコピーされました!
OpenShift Container Platform Web コンソールを使用してクラスター内のローカル永続ストレージボリュームをプロビジョニングおよび管理するには、Local Storage Operator (LSO) をインストールします。
LSO は、デフォルトでは OpenShift Container Platform にはインストールされていません。以下の手順を使用してこの Operator をインストールし、クラスター内でローカルボリュームを有効にできるように設定します。
前提条件
-
openshift-local-storageプロジェクトにアクセスします。 - OpenShift Container Platform Web コンソールにアクセスできる。
手順
- OpenShift Container Platform Web コンソールにログインします。
-
Ecosystem
Software Catalog に移動します。 - Local Storage をフィルターボックスに入力して、LSO を見つけます。
- Install をクリックします。
- Install Operator ページで、A specific namespace on the cluster を選択します。ドロップメニューから openshift-local-storage を選択します。
- Update Channel および Approval Strategy の値を必要な値に調整します。
- Install をクリックします。
結果
完了すると、OpenShift Container Platform Web コンソールの Installed Operators セクションに LSO が表示されます。
5.2.3. ローカルストレージ Operator を使用したローカルボリュームのプロビジョニング リンクのコピーリンクがクリップボードにコピーされました!
ローカルボリュームは動的プロビジョニングでは作成できず、Local Storage Operator (LSO) によって静的にプロビジョニングする必要があるため、ノードとデバイスパスを定義する LocalVolume リソースを作成して、永続ストレージ用にローカルボリュームをプロビジョニングします。
前提条件
- LSO がインストールされている。
以下の条件を満たすローカルディスクがある。
- ノードに接続されている。
- マウントされていない。
- パーティションが含まれていない。
手順
ローカルボリュームリソースを作成します。このリソースは、ノードおよびローカルボリュームへのパスを定義する必要があります。
重要-
LocalVolumeオブジェクトを編集しても、既存の永続ボリュームのfsTypeまたはvolumeModeは変更されません。これが破壊的な操作になる可能性があるためです。 - 同じデバイスに別のストレージクラス名を使用しないでください。こうすることで、複数の永続ボリューム (PV) が作成されます。
例: ファイルシステム
apiVersion: "local.storage.openshift.io/v1" kind: "LocalVolume" metadata: name: "local-disks" namespace: "openshift-local-storage" spec: nodeSelector: nodeSelectorTerms: - matchExpressions: - key: kubernetes.io/hostname operator: In values: - ip-10-0-140-183 - ip-10-0-158-139 - ip-10-0-164-33 storageClassDevices: - storageClassName: "local-sc" forceWipeDevicesAndDestroyAllData: false volumeMode: Filesystem fsType: xfs devicePaths: - /path/to/device-
metadata.namespace: LSO がインストールされている namespace を指定します。 -
spec.nodeSelector: (オプション) ローカルストレージボリュームが割り当てられているノードの一覧が含まれるノードセレクター。以下の例では、oc get nodeから取得したノードホスト名を使用します。値が定義されない場合、LSO は利用可能なすべてのノードで一致するディスクの検索を試行します。 -
spec.storageClassDevices.storageClassName: 永続ボリュームオブジェクトを作成するときに使用するストレージクラスの名前を指定します。LSO は、ストレージクラスが存在しない場合に自動的に作成します。このローカルボリュームのセットを一意に識別するストレージクラスを使用するようにしてください。 -
spec.storageClassDevices.forceWipeDevicesAndDestroyAllData: この設定は、パーティションテーブルの署名 (マジックストリング) を削除してディスクを LSO プロビジョニングに使用できるようにする、wipefsを呼び出すかどうかを定義します。署名以外のデータは消去されません。デフォルトは "false" です (wipefsは呼び出されません)。再利用する必要がある以前のデータをディスク上に残す場合、forceWipeDevicesAndDestroyAllDataを "true" に設定すると便利です。このようなシナリオでは、このフィールドを true に設定すると、管理者はディスクを手動で消去する必要がありません。このようなケースには、ノードを複数回再デプロイできるシングルノード OpenShift クラスター環境や、オブジェクトストレージデバイス (OSD) として使用する予定のディスクに以前のデータを残すことができる OpenShift Data Foundation を使用する場合も、これに該当します。 spec.storageClassDevices.volumeMode: ローカルボリュームのタイプを定義するボリュームモード (FilesystemまたはBlock) を指定します。注記raw ブロックボリューム (
volumeMode: Block) はファイルシステムでフォーマットされません。このモードは、Pod で実行しているすべてのアプリケーションが raw ブロックデバイスを使用できる場合にのみ使用します。-
spec.storageClassDevices.fsType: ローカルボリュームの初回マウント時に作成されるファイルシステム。 spec.storageClassDevices.devicePaths: 選択するローカルストレージデバイスのリストを含むパス。この値は、LocalVolumeリソースby-idへの実際のローカルディスクのファイルパス (/dev/disk/by-id/wwnなど) に置き換えます。プロビジョナーが正常にデプロイされると、これらのローカルディスク用に PV が作成されます。注記RHEL KVM を使用して OpenShift Container Platform を実行している場合は、VM ディスクにシリアル番号を割り当てる必要があります。そうしないと、再起動後に VM ディスクを識別できません。
virsh edit <VM>コマンドを使用して、<serial>mydisk</serial>定義を追加できます。例: ブロック
apiVersion: "local.storage.openshift.io/v1" kind: "LocalVolume" metadata: name: "local-disks" namespace: "openshift-local-storage" spec: nodeSelector: nodeSelectorTerms: - matchExpressions: - key: kubernetes.io/hostname operator: In values: - ip-10-0-136-143 - ip-10-0-140-255 - ip-10-0-144-180 storageClassDevices: - storageClassName: "local-sc" forceWipeDevicesAndDestroyAllData: false volumeMode: Block devicePaths: - /path/to/device-
metadata.namespace: LSO がインストールされている namespace を指定します。 -
spec.nodeSelector: (オプション) ローカルストレージボリュームが割り当てられているノードの一覧が含まれるノードセレクター。以下の例では、oc get nodeから取得したノードホスト名を使用します。値が定義されない場合、LSO は利用可能なすべてのノードで一致するディスクの検索を試行します。 -
spec.storageClassDevices.storageClassName: 永続ボリュームオブジェクトを作成するときに使用するストレージクラスの名前を指定します。 -
spec.storageClassDevices.forceWipeDevicesAndDestroyAllData: この設定は、パーティションテーブルの署名 (マジックストリング) を削除してディスクを LSO プロビジョニングに使用できるようにする、wipefsを呼び出すかどうかを定義します。署名以外のデータは消去されません。デフォルトは "false" です (wipefsは呼び出されません)。再利用する必要がある以前のデータをディスク上に残す場合、forceWipeDevicesAndDestroyAllDataを "true" に設定すると便利です。このようなシナリオでは、このフィールドを true に設定すると、管理者はディスクを手動で消去する必要がありません。このようなケースには、ノードを複数回再デプロイできるシングルノード OpenShift クラスター環境や、オブジェクトストレージデバイス (OSD) として使用する予定のディスクに以前のデータを残すことができる OpenShift Data Foundation を使用する場合も、これに該当します。 -
spec.storageClassDevices.volumeMode: ローカルボリュームのタイプを定義するボリュームモード (FilesystemまたはBlock) を指定します。 spec.storageClassDevices.devicePaths: 選択するローカルストレージデバイスのリストを含むパスを指定します。この値は、LocalVolumeリソースby-idへの実際のローカルディスクのファイルパス (dev/disk/by-id/wwnなど) に置き換えます。プロビジョナーが正常にデプロイされると、これらのローカルディスク用に PV が作成されます。注記RHEL KVM を使用して OpenShift Container Platform を実行している場合は、VM ディスクにシリアル番号を割り当てる必要があります。そうしないと、再起動後に VM ディスクを識別できません。
virsh edit <VM>コマンドを使用して、<serial>mydisk</serial>定義を追加できます。
-
OpenShift Container Platform クラスターにローカルボリュームリソースを作成します。作成したばかりのファイルを指定します。
$ oc create -f <local-volume>.yamlプロビジョナーが作成され、対応するデーモンセットが作成されていることを確認します。
$ oc get all -n openshift-local-storage出力例
NAME READY STATUS RESTARTS AGE pod/diskmaker-manager-9wzms 1/1 Running 0 5m43s pod/diskmaker-manager-jgvjp 1/1 Running 0 5m43s pod/diskmaker-manager-tbdsj 1/1 Running 0 5m43s pod/local-storage-operator-7db4bd9f79-t6k87 1/1 Running 0 14m NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE service/local-storage-operator-metrics ClusterIP 172.30.135.36 <none> 8383/TCP,8686/TCP 14m NAME DESIRED CURRENT READY UP-TO-DATE AVAILABLE NODE SELECTOR AGE daemonset.apps/diskmaker-manager 3 3 3 3 3 <none> 5m43s NAME READY UP-TO-DATE AVAILABLE AGE deployment.apps/local-storage-operator 1/1 1 1 14m NAME DESIRED CURRENT READY AGE replicaset.apps/local-storage-operator-7db4bd9f79 1 1 1 14mデーモンセットプロセスの必要な数と現在の数に注意してください。必要な数が
0の場合、これはラベルセレクターが無効であることを示します。次のコマンドを実行して、永続ボリュームが作成されたことを確認します。
$ oc get pv出力例
NAME CAPACITY ACCESS MODES RECLAIM POLICY STATUS CLAIM STORAGECLASS REASON AGE local-pv-1cec77cf 100Gi RWO Delete Available local-sc 88m local-pv-2ef7cd2a 100Gi RWO Delete Available local-sc 82m local-pv-3fa1c73 100Gi RWO Delete Available local-sc 48m
5.2.4. ローカルストレージ Operator のないローカルボリュームのプロビジョニング リンクのコピーリンクがクリップボードにコピーされました!
Local Storage Operator (LSO) を使用せずに、PersistentVolume オブジェクトを定義してローカルボリュームを手動でプロビジョニングします。ただし、このアプローチにはデータ漏洩のリスクが含まれており、Operator はデバイスのライフサイクルを自動化するために推奨されます。
永続ボリューム (PV) の手動プロビジョニングには、永続ボリューム要求 (PVC) が削除された場合、PV の再利用でデータ漏洩が発生するリスクが含まれます。ローカルストレージ Operator は、ローカル PV のプロビジョニング時にデバイスのライフサイクルを自動化するために使用することが推奨されます。
前提条件
- ローカルディスクが OpenShift Container Platform ノードに割り当てられていること。
手順
PV を定義します。
PersistentVolumeオブジェクト定義を使用して、example-pv-filesystem.yamlまたはexample-pv-block.yamlなどのファイルを作成します。このリソースは、ノードおよびローカルボリュームへのパスを定義する必要があります。注記同じデバイスに別のストレージクラス名を使用しないでください。これにより、複数の PV が作成されます。
Example-pv-filesystem.yaml
apiVersion: v1 kind: PersistentVolume metadata: name: example-pv-filesystem spec: capacity: storage: 100Gi volumeMode: Filesystem accessModes: - ReadWriteOnce persistentVolumeReclaimPolicy: Delete storageClassName: local-sc local: path: /dev/xvdf nodeAffinity: required: nodeSelectorTerms: - matchExpressions: - key: kubernetes.io/hostname operator: In values: - example-node-
spec.volumeMode: PV のタイプを定義するボリュームモード (FilesystemまたはBlock)。 -
spec.storageClassName: PV リソースを作成するときに使用するストレージクラスの名前を指定します。この PV のセットを一意に特定するストレージクラスを使用にしてください。 spec.local.path: 選択するローカルストレージデバイスのリスト、またはディレクトリーが含まれるパスを指定します。FilesystemvolumeModeのディレクトリーのみを指定できます。注記raw ブロックボリューム (
volumeMode: block) はファイルシステムでフォーマットされません。このモードは、Pod で実行しているすべてのアプリケーションが raw ブロックデバイスを使用できる場合にのみ使用します。example-pv-block.yaml
apiVersion: v1 kind: PersistentVolume metadata: name: example-pv-block spec: capacity: storage: 100Gi volumeMode: Block accessModes: - ReadWriteOnce persistentVolumeReclaimPolicy: Delete storageClassName: local-sc local: path: /dev/xvdf nodeAffinity: required: nodeSelectorTerms: - matchExpressions: - key: kubernetes.io/hostname operator: In values: - example-node-
spe`c.volumeMode`: PV のタイプを定義するボリュームモード (
FilesystemまたはBlock)。 -
spec.storageClassName: PV リソースを作成するときに使用するストレージクラスの名前を指定します。この PV のセットを一意に特定するストレージクラスを使用するようにしてください。 -
spec.local.path: 選択するローカルストレージデバイスのリストが含まれるパスを指定します。
-
作成したファイルを指定して、次のコマンドを実行して OpenShift Container Platform クラスターに PV リソースを作成します。
$ oc create -f <example-pv>.yamlローカル PV が作成されていることを確認します。
$ oc get pv出力例
NAME CAPACITY ACCESS MODES RECLAIM POLICY STATUS CLAIM STORAGECLASS REASON AGE example-pv-filesystem 100Gi RWO Delete Available local-sc 3m47s example-pv1 1Gi RWO Delete Bound local-storage/pvc1 local-sc 12h example-pv2 1Gi RWO Delete Bound local-storage/pvc2 local-sc 12h example-pv3 1Gi RWO Delete Bound local-storage/pvc3 local-sc 12h
5.2.5. ローカルボリュームの永続ボリューム要求の作成 リンクのコピーリンクがクリップボードにコピーされました!
ローカルボリュームは静的に作成する必要があり、動的プロビジョニングを使用できないため、Pod 内のローカルボリュームにアクセスするための永続ボリューム要求 (PVC) を作成します。
前提条件
- 永続ボリュームがローカルボリュームプロビジョナーを使用して作成されていること。
手順
対応するストレージクラスを使用して PVC を作成します。
kind: PersistentVolumeClaim apiVersion: v1 metadata: name: local-pvc-name spec: accessModes: - ReadWriteOnce volumeMode: Filesystem resources: requests: storage: 100Gi storageClassName: local-sc-
metadata.name: PVC の名前を指定します。 -
spec.volumeMode: PVC のタイプを指定します。デフォルトはFilesystemです。 -
spec.resources.requests.storage: PVC で使用できるストレージ容量を指定します。 -
spec.storageClassName: クレームに必要なストレージクラスの名前を指定します。
-
次のコマンドを実行して、作成したファイルを指定して、PVC を OpenShift Container Platform クラスターに作成します。
$ oc create -f <local-pvc>.yaml
5.2.6. ローカル要求を割り当てます。 リンクのコピーリンクがクリップボードにコピーされました!
ローカルボリュームが永続ボリューム要求 (PVC) にマッピングされたら、Pod 仕様で指定して要求を Pod にアタッチし、ローカルストレージをアプリケーションで使用できるようにします。
前提条件
- 永続ボリューム要求が同じ namespace に存在する。
手順
定義された要求をリソースの仕様に追加します。以下の例では、Pod 内で永続ボリューム要求を宣言します。
apiVersion: v1 kind: Pod spec: # ... containers: volumeMounts: - name: local-disks mountPath: /data volumes: - name: local-disks persistentVolumeClaim: claimName: local-pvc-name # ...-
spec…containers.volumeMounts.name: マウントするボリュームの名前を指定します。 -
spec…containers.volumeMounts.mountPath: ボリュームがマウントされる Pod 内のパスを指定します。コンテナーのルート (/) や、ホストとコンテナーで同じパスにはマウントしないでください。これは、コンテナーに十分な特権が付与されている場合に、ホストシステムを破壊する可能性があります (例: ホストの/dev/ptsファイル)。ホストをマウントするには、/hostを使用するのが安全です。 -
spec…volumes.persistentVolumeClaim.claimName: 使用する既存の永続ボリューム要求の名前を指定します。
-
次のコマンドを実行して、作成したファイルを指定して、OpenShift Container Platform クラスターにリソースを作成します。
$ oc create -f <local-pod>.yaml
5.2.7. 詳細は、ローカルストレージデバイスの自動検出およびプロビジョニングを参照してください。 リンクのコピーリンクがクリップボードにコピーされました!
Local Storage Operator (LSO) を使用してローカルストレージの検出とプロビジョニングを自動化し、デバイスが接続されたベアメタル、VMware vSphere、Amazon Web Services (AWS) インスタンスなど、動的プロビジョニングが利用できない場合のインストールを簡素化します。
自動検出およびプロビジョニングは、テクノロジープレビュー機能としてのみ提供されます。テクノロジープレビュー機能は、Red Hat 製品のサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではないことがあります。Red Hat は、実稼働環境でこれらを使用することを推奨していません。テクノロジープレビュー機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行い、フィードバックを提供していただくことを目的としています。
Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、テクノロジープレビュー機能のサポート範囲 を参照してください。
Red Hat OpenShift Data Foundation をオンプレミスでデプロイするために使用する場合、またはプラットフォームに依存しないデプロイメントで使用する場合、自動検出とプロビジョニングは完全にサポートされます。
ローカルデバイスを自動的に検出し、選択したデバイスのローカルボリュームを自動的にプロビジョニングするには、以下の手順を使用します。
LocalVolumeSet オブジェクトの使用には注意が必要です。ローカルディスクから永続ボリューム (PV) を自動的にプロビジョニングする場合、ローカル PV は一致するすべてのデバイスを要求する可能性があります。LocalVolumeSet オブジェクトを使用している場合、LSO がノードでローカルデバイスを管理する唯一のエンティティーであることを確認します。ノードを複数回ターゲットにする LocalVolumeSet のインスタンスを複数作成することはサポートされていません。
前提条件
- クラスター管理者パーミッションがある。
- LSO がインストールされている。
- ローカルディスクが OpenShift Container Platform ノードに割り当てられていること。
-
OpenShift Container Platform Web コンソールまたは
ocコマンドラインインターフェイス (CLI) へのアクセスがあること。
手順
OpenShift Container Platform Web コンソールからローカルデバイスの自動検出を有効にします。
-
Ecosystem
Installed Operators をクリックします。 -
openshift-local-storagenamespace で Local Storage をクリックします。 - Local Volume Discovery タブをクリックします。
- Create Local Volume Discovery をクリックし、Form view または YAML view のいずれかを選択します。
-
LocalVolumeDiscoveryオブジェクトパラメーターを設定します。 Create をクリックします。
LSO は、
auto-discover-devicesという名前のローカルボリューム検出インスタンスを作成します。
-
Ecosystem
ノードで利用可能なデバイスの連続リストを表示します。
- OpenShift Container Platform Web コンソールにログインします。
-
Compute
Nodes をクリックします。 - 開くノードの名前をクリックします。「Node Details」ページが表示されます。
Disks タブをクリックして、選択したデバイスのリストを表示します。
ローカルディスクを追加または削除しても、デバイスリストの更新が継続的に行われます。名前、ステータス、タイプ、モデル、容量、およびモードでデバイスをフィルターできます。
OpenShift Container Platform Web コンソールから検出されたデバイスのローカルボリュームを自動的にプロビジョニングします。
-
Ecosystem
Installed Operators をクリックし、Operator のリストから Local Storage を選択します。 -
Local Volume Set
Create Local Volume Set をクリックします。 - ボリュームセット名とストレージクラス名を入力します。
All nodes または Select nodes をクリックし、適宜フィルターを適用します。
注記All nodes または Select nodes を使用してフィルターするかどうかにかかわらず、ワーカーノードのみが利用可能になります。
ローカルボリュームセットに適用するディスクタイプ、モード、サイズ、および制限を選択し、Create をクリックします。
メッセージが数分後に表示され、「Operator reconciled successfully」という Operator の調整が正常に行われたことが示唆されます。
-
Ecosystem
または、CLI から検出されたデバイスのローカルボリュームをプロビジョニングします。
以下の例に示されるように、オブジェクト YAML ファイルを作成し、
local-volume-set.yamlなどのローカルボリュームセットを定義します。ローカルボリュームセット YAML ファイルの例
apiVersion: local.storage.openshift.io/v1alpha1 kind: LocalVolumeSet metadata: name: example-autodetect spec: nodeSelector: nodeSelectorTerms: - matchExpressions: - key: kubernetes.io/hostname operator: In values: - worker-0 - worker-1 storageClassName: local-sc volumeMode: Filesystem fsType: ext4 maxDeviceCount: 10 deviceInclusionSpec: deviceTypes: - disk - part deviceMechanicalProperties: - NonRotational minSize: 10G maxSize: 100G models: - SAMSUNG - Crucial_CT525MX3 vendors: - ATA - ST2000LM-
spec.storageClassName: 検出されたデバイスからプロビジョニングされる永続ボリューム用に作成されるストレージクラスを判別します。LSO は、ストレージクラスが存在しない場合に自動的に作成します。このローカルボリュームのセットを一意に識別するストレージクラスを使用するようにしてください。 -
spec.deviceInclusionSpec.deviceTypes: ローカルボリュームセット機能を使用する場合、LSO は論理ボリューム管理 (LVM) デバイスの使用をサポートしません。
-
ローカルボリュームセットオブジェクトを作成します。
$ oc apply -f local-volume-set.yamlローカル永続ボリュームがストレージクラスに基づいて動的にプロビジョニングされていることを確認します。
$ oc get pv出力例
NAME CAPACITY ACCESS MODES RECLAIM POLICY STATUS CLAIM STORAGECLASS REASON AGE local-pv-1cec77cf 100Gi RWO Delete Available local-sc 88m local-pv-2ef7cd2a 100Gi RWO Delete Available local-sc 82m local-pv-3fa1c73 100Gi RWO Delete Available local-sc 48m
次のステップ
結果は、ノードから削除された後に削除されます。シンボリックリンクは手動で削除する必要があります。
5.2.8. ローカルストレージ Operator Pod での toleration の使用 リンクのコピーリンクがクリップボードにコピーされました!
LocalVolume リソースで toleration を設定して、tained ノードで Local Storage Operator (LSO) Pod を実行できるようにします。これにより、通常はすべての Pod をリピードするノードでローカルストレージプロビジョニングが可能になります。
テイントはノードに適用し、それらが一般的なワークロードを実行しないようにすることができます。LSO がテイントのマークが付けられたノードを使用できるようにするには、toleration を Pod または DaemonSet 定義に追加する必要があります。これにより、作成されたリソースをこれらのテイントのマークが付けられたノードで実行できるようになります。
toleration を LocalVolume リソースで LSO Pod に適用し、テイントをノード仕様でノードに適用します。ノードのテイントはノードに対し、テイントを容認しないすべての Pod を拒否するよう指示します。他の Pod にはない特定の taint を使用することで、LSO Pod がそのノードでも実行されるようにできます。
taint および toleration は、key、value、および effect で構成されます。引数として、これは key=value:effect として表現されます。演算子により、これらの 3 つのパラメーターのいずれかを空のままにすることができます。
前提条件
- LSO がインストールされている。
- ローカルディスクがテイントを持つ OpenShift Container Platform ノードに割り当てられている。
- テイントのマークが付けられたノードがローカルストレージのプロビジョニングを行うことが想定されます。
手順
以下の例に示されるように、
Podを定義する YAML ファイルを変更し、LocalVolume仕様を追加します。apiVersion: "local.storage.openshift.io/v1" kind: "LocalVolume" metadata: name: "local-disks" namespace: "openshift-local-storage" spec: tolerations: - key: localstorage operator: Equal value: "localstorage" storageClassDevices: - storageClassName: "local-sc" volumeMode: Block devicePaths: - /dev/xvdg-
spec.tolerations.key: ノードに追加したキーを指定します。 -
spec.tolerations.Operator:キー/値パラメーターの一致を必須とする EqualOperator を指定します。Operator がExistsの場合、システムはキーが存在することを確認し、値を無視します。Operator がEqualの場合、キーと値が一致する必要があります。 -
spec.tolerations.value: taint ノードのローカル値を指定します。 -
spec.storageClassDevices.volumeMode: ローカルボリュームのタイプを定義するボリュームモード (FilesystemまたはBlock) を指定します。 -
spec.storageClassDevices.devicePaths: 選択するローカルストレージデバイスのリストを含むパスを指定します。
-
オプション: テイントのマークが付けられたノードでのみローカル永続ボリュームを作成するには、以下の例のように YAML ファイルを変更し、
LocalVolume仕様を追加します。spec: tolerations: - key: node-role.kubernetes.io/master operator: Exists
結果
定義された toleration は結果として作成されるデーモンセットに渡されます。これにより、diskmaker およびプロビジョナー Pod を指定されたテイントが含まれるノード用に作成できます。
5.2.9. ローカルストレージ Operator メトリクス リンクのコピーリンクがクリップボードにコピーされました!
ストレージ使用率を把握し、プロビジョニングの問題をトラブルシューティングするには、ディスクの検出、永続ボリュームの作成、一致しないディスク、孤立したシンボリックリンクを監視する使用可能なメトリクスを使用して Local Storage Operator (LSO) の操作を追跡します。
OpenShift Container Platform は、LSO の以下のメトリクスを提供します。
-
lso_discovery_disk_count: 各ノードで検出されたデバイスの合計数 -
lso_lvset_provisioned_PV_count:LocalVolumeSetオブジェクトによって作成される PV の合計数 -
lso_lvset_unmatched_disk_count: 条件の不一致により、LSO がプロビジョニング用に選択しなかったディスクの合計数 -
lso_lvset_orphaned_symlink_count:LocalVolumeSetオブジェクト基準に一致しなくなった PV のあるデバイスの数 -
lso_lv_orphaned_symlink_count:LocalVolumeオブジェクト基準に一致しなくなった PV のあるデバイスの数 -
lso_lv_provisioned_PV_count:LocalVolumeのプロビジョニングされた PV の合計数
メトリクスを使用するには、まずメトリクスを有効にする必要があります。詳細は、「Local Storage Operator メトリクスの有効化」を参照してください。
メトリクスの詳細は、「管理者としてメトリクスにアクセスする」を参照してください。
5.2.9.1. Local Storage Operator メトリクスの有効化 リンクのコピーリンクがクリップボードにコピーされました!
Local Storage Operator (LSO) のディスク検出、ボリュームプロビジョニング、およびストレージ使用率を監視するには、Operator namespace でクラスター監視を設定して LSO メトリクスを有効にします。
手順
次のいずれかを実行して、ローカルメトリクスを有効にします。
- Web コンソールのソフトウェアカタログから LSO をインストールする場合は、Enable Operator recommended cluster monitoring on this Namespace チェックボックスを選択します。
次のコマンドを実行して、
openshift.io/cluster-monitoring=trueラベルを Operator namespace に手動で追加します。$ oc label ns/openshift-local-storage openshift.io/cluster-monitoring=true
5.2.10. ローカルストレージ Operator のリソースの削除 リンクのコピーリンクがクリップボードにコピーされました!
場合によっては、不要になったローカルボリューム (LV) とローカルボリュームセット (LVS) を削除するか、Local Storage Operator をアンインストールする必要があります。削除前に永続ボリュームが適切に解放され、バックアップされるようにして、データの損失を防ぎます。
5.2.10.1. ローカルボリュームまたはローカルボリュームセットの削除 リンクのコピーリンクがクリップボードにコピーされました!
不要になったら、バインドされた永続ボリューム (PV) を解放し、LV または LVS を削除し、保持回収ポリシーを使用して PV をクリーンアップして、ローカルボリューム (LV) とローカルボリュームセット (LVS) を削除します。
前提条件
PV は
ReleasedまたはAvailable状態である必要があります。警告使用中の PV を削除すると、データの損失や破損につながる可能性があります。
手順
削除する LV または LVS が所有するバインドされた PV がある場合は、対応する永続ボリューム要求 (PVC) を削除して PV を解放します。
特定の LV または LVS が所有するバインドされた PV を見つけるには、次のコマンドを実行します。
$ oc get pv --selector storage.openshift.com/owner-name=<LV_LVS_name><LV_LVS_name>は LV または LVS の名前です。出力例
NAME CAPACITY ACCESS MODES RECLAIM POLICY STATUS CLAIM STORAGECLASS VOLUMEATTRIBUTESCLASS REASON AGE local-pv-3fa1c73 5Gi RWO Delete Available slow <unset> 28s local-pv-1cec77cf 30Gi RWX Retain Bound openshift/storage my-sc <unset> 168dバインドされた PV のステータスは
Boundとなり、対応する PVC がCLAIM列に表示されます。上記の例では、PVlocal-pv-1cec77cfがバインドされており、その PVC はopenshift/storageです。次のコマンドを実行して、削除する LV または LVS が所有するバインドされた PV の対応する PVC を削除します。
$ oc delete pvc <name>この例では、PVC
openshift/storageを削除します。
該当する次のコマンドを実行して、LV または LVS を削除します。
LV を削除するコマンド:
$ oc delete lv <name>または
LVS を削除するコマンド:
$ oc delete lvs <name>
LV または LVS が所有する PV に
Retain回収ポリシーがある場合は、重要なデータをバックアップしてから PV を削除します。注記Deleteポリシーを持つ PV は、LV または LVS を削除すると自動的に削除されます。Retain回収ポリシーを持つ PV を見つけるには、次のコマンドを実行します。$ oc get pv出力例
NAME CAPACITY ACCESS MODES RECLAIM POLICY STATUS CLAIM STORAGECLASS REASON AGE local-pv-1cec77cf 30Gi RWX Retain Available my-sc 168dこの例では、PV
local-pv-1cec77cfにはRetain回収ポリシーがあり、手動で削除する必要があります。- このボリューム上の重要なデータはすべてバックアップを作成してください。
次のコマンドを実行して PV を削除します。
$ oc delete pv <name>この例では、PV
local-pv-1cec77cfを削除します。
5.2.10.2. ローカルストレージ Operator のアンインストール リンクのコピーリンクがクリップボードにコピーされました!
ローカルストレージ永続ボリューム (PV) が使用されなくなった場合は、すべてのローカルボリュームリソースを削除し、Operator をアンインストールし、残りの PV を削除し、プロジェクトを削除して、Local Storage Operator (LSO) を安全にアンインストールします。
ローカルストレージ PV がまだ使用中の状態で LSO をアンインストールすることは推奨されません。PV は Operator の削除後も残りますが、PV およびローカルストレージリソースを削除せずに Operator がアンインストールされ、再インストールされる場合に予測できない動作が生じる可能性があります。
前提条件
- OpenShift Container Platform Web コンソールにアクセスできる。
手順
次のコマンドを実行して、プロジェクトにインストールされているローカルボリュームリソース (
localvolume、localvolumeset、localvolumediscoveryなど) を削除します。$ oc delete localvolume --all --all-namespaces$ oc delete localvolumeset --all --all-namespaces$ oc delete localvolumediscovery --all --all-namespacesOpenShift Container Platform Web コンソールから LSO をアンインストールします。
- OpenShift Container Platform Web コンソールにログインします。
-
Ecosystem
Installed Operators に移動します。 - Local Storage をフィルターボックスに入力して、LSO を見つけます。
-
LSO の最後にある Options メニュー
をクリックします。
- Uninstall Operator をクリックします。
- 表示されるウィンドウで Remove をクリックします。
LSO によって作成された PV は、削除されるまでクラスターに残ります。これらのボリュームが使用されなくなったら、以下のコマンドを実行してこれらのボリュームを削除します。
$ oc delete pv <pv-name>次のコマンドを実行して、
openshift-local-storageプロジェクトを削除します。$ oc delete project openshift-local-storage
5.3. hostPath を使用した永続ストレージ リンクのコピーリンクがクリップボードにコピーされました!
hostPath ボリュームは、ホストノードのファイルシステムから Pod にファイルまたはディレクトリーをマウントします。hostPath ボリュームは特権 Pod を必要とし、ホストノードのファイルシステムへのアクセスを許可するため、主にテストまたは開発に使用します。
5.3.1. hostPath の概要 リンクのコピーリンクがクリップボードにコピーされました!
hostPath ボリュームは、ホストノードのファイルシステムから Pod にファイルまたはディレクトリーをマウントします。hostPath には特権付き Pod と静的プロビジョニングが必要なため、開発およびテストにのみ推奨されます。
クラスター管理者は、特権付き Pod として実行するように Pod を設定する必要があります。これにより、同じノードの Pod へのアクセスが付与されます。
ほとんどの Pod には hostPath ボリュームは必要ありませんが、アプリケーションが必要とする場合は、テスト用のクイックオプションが提供されます。
実稼働クラスターでは、hostPath を使用しません。代わりにクラスター管理者は、GCE Persistent Disk ボリューム、NFS 共有、Amazon EBS ボリュームなどのネットワークリソースをプロビジョニングします。ネットワークリソースは、ストレージクラスを使用した動的プロビジョニングの設定をサポートします。
hostPath ボリュームは静的にプロビジョニングする必要があります。
コンテナーのルート (/) や、ホストとコンテナーで同じパスにはマウントしないでください。これは、コンテナーに十分な特権が付与されている場合、ホストシステムを破壊する可能性があります。ホストをマウントするには、/host を使用するのが安全です。以下の例では、ホストの / ディレクトリーが /host でコンテナーにマウントされています。
apiVersion: v1
kind: Pod
metadata:
name: test-host-mount
spec:
containers:
- image: registry.access.redhat.com/ubi9/ubi
name: test-container
command: ['sh', '-c', 'sleep 3600']
volumeMounts:
- mountPath: /host
name: host-slash
volumes:
- name: host-slash
hostPath:
path: /
type: ''
5.3.2. hostPath ボリュームの静的なプロビジョニング リンクのコピーリンクがクリップボードにコピーされました!
ホストノードのファイルシステム上のパスにマッピングする永続ボリューム (PV) を作成し、PV にバインドする永続ボリューム要求 (PVC) を作成して、hostPath ボリュームを静的にプロビジョニングします。hostPath ボリュームでは動的プロビジョニングはサポートされていません。
hostPath ボリュームを使用する Pod は、手動の (静的) プロビジョニングで参照される必要があります。
手順
PersistentVolumeオブジェクト定義を含むpv.yamlファイルを作成して、永続ボリューム (PV) を定義します。apiVersion: v1 kind: PersistentVolume metadata: name: task-pv-volume labels: type: local spec: storageClassName: manual capacity: storage: 5Gi accessModes: - ReadWriteOnce persistentVolumeReclaimPolicy: Retain hostPath: path: "/mnt/data"-
metadata.name: ボリュームの名前を指定します。この名前は、永続ボリューム (PV) 要求または Pod がボリュームが識別するために使用されます。 -
spec.storageClassName: ストレージクラスは、永続ボリューム要求 (PVC) 要求を PV にバインドするために使用されます。 -
spec.accessModes: アクセスモードを指定します。ボリュームはシングルノードでread-writeとしてマウントできます。 -
spec.hostPath.path: 設定ファイルでは、ボリュームがクラスターのノードの/mnt/dataにあるように指定します。ホストシステムの破損を避けるため、コンテナーのルート (/) や、ホストとコンテナーで同じになるパスにマウントしないでください。/hostを使用してホストを安全にマウントできます
-
ファイルから PV を作成します。
$ oc create -f pv.yamlPersistentVolumeClaimオブジェクト定義を含むpvc.yamlファイルを作成して PVC を定義します。apiVersion: v1 kind: PersistentVolumeClaim metadata: name: task-pvc-volume spec: accessModes: - ReadWriteOnce resources: requests: storage: 1Gi storageClassName: manualファイルから PVC を作成します。
$ oc create -f pvc.yaml
5.3.3. 特権付き Pod での hostPath 共有のマウント リンクのコピーリンクがクリップボードにコピーされました!
Pod 仕様で既存の永続ボリューム要求 (PVC) を参照して、特権 Pod に hostPath 共有をマウントします。Pod は、ノードのストレージにアクセスするために特権付き Pod として実行される必要があります。ホストシステムが破損しないように、コンテナールートまたはホストに一致するパスにマウントしないでください。
PVC の作成後に、これをアプリケーション内で使用できます。以下の例は、この共有を Pod 内にマウントする方法を示しています。
前提条件
- 基礎となる hostPath 共有にマップされる永続ボリューム要求があること。
手順
既存の永続ボリューム要求をマウントする特権付き Pod を作成します。
apiVersion: v1 kind: Pod metadata: name: pod-name spec: containers: ... securityContext: privileged: true volumeMounts: - mountPath: /data name: hostpath-privileged ... securityContext: {} volumes: - name: hostpath-privileged persistentVolumeClaim: claimName: task-pvc-volume-
metadata.name: Pod の名前を指定します。 -
spec.containers.securityContext.privileged: ノードのストレージにアクセスするには、Pod を特権として実行する必要があります。 -
spec.containers.volumeMounts.mountPath: 特権 Pod 内のホストパス共有をマウントするパス。コンテナーのルート (/) や、ホストとコンテナーで同じパスにはマウントしないでください。これは、コンテナーに十分な特権が付与されている場合に、ホストシステムを破壊する可能性があります (例: ホストの/dev/ptsファイル)。ホストをマウントするには、/hostを使用するのが安全です。 -
spec.volumes.persistentVolumeClaim.claimName: 以前に作成されたPersistentVolumeClaimオブジェクトの名前を指定します。
-
5.4. Logical Volume Manager Storage を使用した永続ストレージ リンクのコピーリンクがクリップボードにコピーされました!
論理ボリュームマネージャー (LVM) ストレージは、TopoLVM CSI ドライバーを介して LVM2 を使用して、リソースが制限されたクラスター上でローカルストレージを動的にプロビジョニングします。LVM ストレージを使用すると、ボリュームグループ、永続ボリューム要求(PVC)、スナップショット、およびクローンを作成できます。
5.4.1. Logical Volume Manager Storage のインストール リンクのコピーリンクがクリップボードにコピーされました!
OpenShift Container Platform クラスターに LVM Storage をインストールし、ワークロードのストレージを動的にプロビジョニングするように設定できます。
LVM Storage は、OpenShift Container Platform CLI (oc)、OpenShift Container Platform Web コンソール、または Red Hat Advanced Cluster Management (RHACM) を使用してインストールできます。
マルチノードクラスターで LVM Storage を使用する場合、LVM Storage はローカルストレージのプロビジョニングのみをサポートします。LVM Storage は、ノード間のストレージデータレプリケーションメカニズムをサポートしていません。単一障害点を回避するために、アクティブまたはパッシブレプリケーションメカニズムを通じてストレージデータを確実にレプリケーションする必要があります。
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 ストレージをインストールし、リソースが限られているクラスターにローカルストレージを動的にプロビジョニングできます。
LVM Storage Operator のデフォルトの namespace は openshift-lvm-storage です。
前提条件
-
OpenShift CLI (
oc) がインストールされている。 -
cluster-adminおよび Operator インストール権限を持つユーザーとして OpenShift Container Platform にログインしている。
手順
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-lvm-storage以下のコマンドを実行して namespace を作成します。
$ oc create -f <file_name>OperatorGroupCR YAML ファイルを作成します。OperatorGroupCR の例apiVersion: operators.coreos.com/v1 kind: OperatorGroup metadata: name: openshift-storage-operatorgroup namespace: openshift-lvm-storage spec: targetNamespaces: - openshift-storage以下のコマンドを実行して
OperatorGroupCR を作成します。$ oc create -f <file_name>SubscriptionCR YAML ファイルを作成します。SubscriptionCR の例apiVersion: operators.coreos.com/v1alpha1 kind: Subscription metadata: name: lvms namespace: openshift-lvm-storage spec: installPlanApproval: Automatic name: lvms-operator source: redhat-operators sourceNamespace: openshift-marketplace以下のコマンドを実行して
SubscriptionCR を作成します。$ oc create -f <file_name>
検証
LVM Storage がインストールされていることを確認するには、次のコマンドを実行します。
$ oc get csv -n openshift-lvm-storage -o custom-columns=Name:.metadata.name,Phase:.status.phase出力例
Name Phase 4.13.0-202301261535 Succeeded
5.4.1.3. Web コンソールを使用した LVM Storage のインストール リンクのコピーリンクがクリップボードにコピーされました!
OpenShift Container Platform Web コンソールから LVM ストレージをインストールし、限られたリソースを持つクラスターにローカルストレージを動的にプロビジョニングします。
LVM Storage Operator のデフォルトの namespace は openshift-lvm-storage です。
前提条件
- クラスターにアクセスできる。
-
cluster-adminおよび Operator インストール権限で OpenShift Container Platform にアクセスできる。
手順
- OpenShift Container Platform Web コンソールにログインします。
-
Ecosystem
Software Catalog をクリックします。 - ソフトウェアカタログページで LVM Storage をクリックします。
Operator Installation ページで次のオプションを設定します。
- stable-4.21 に Channel を更新 します。
- Installation Mode を A specific namespace on the cluster に設定します。
-
Installed Namespace を Operator recommended namespace openshift-storage に設定します。
openshift-lvm-storagenamespace が存在しない場合は、Operator のインストール中に作成されます。 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 のインストール リンクのコピーリンクがクリップボードにコピーされました!
セキュリティーとコンプライアンスのためにネットワーク分離を必要とする業界など、クラスターがインターネットアクセスのない非接続環境で LVM ストレージをインストールします。たとえば、エアギャップネットワーク、高セキュリティー機能、または規制などです。
前提条件
- 非接続インストールのミラーリングについてを読みました。
- OpenShift Container Platform イメージリポジトリーにアクセスできる。
- ミラーレジストリーを作成している(Red Hat Openshift 導入用のミラーレジストリーを使用したミラーレジストリーの作成を参照)。
手順
「イメージセット設定の作成」手順の手順に従います。LVM Storage の
ImageSetConfigurationカスタムリソース (CR) を作成するには、次のImageSetConfigurationCR 設定の例を使用できます。LVM Storage 用の
ImageSetConfigurationCR の例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.21 type: ocp graph: true operators: - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.21 packages: - name: lvms-operator channels: - name: stable additionalImages: - name: registry.redhat.io/ubi9/ubi:latest helm: {}-
archiveSize: イメージセット内の各ファイルの最大サイズ(GiB 単位)を指定します。 -
storageConfig: イメージセットを保存する場所を指定します。この場所は、レジストリーまたはローカルディレクトリーにすることができます。テクノロジープレビューの OCI 機能を使用している場合を除き、storageConfigフィールドを設定する必要があります。 -
storageConfig.registry.imageURL: レジストリーの使用時にイメージストリームのストレージ URL を指定します。詳細は、イメージストリームの使用を参照してください。 -
mirror.platform.name: OpenShift Container Platform イメージを取得するチャネルを指定します。 -
mirror.platform.channels[].name: このフィールドをtrueに設定して、OpenShift Update Service (OSUS)グラフイメージを生成します。詳細は、About the OpenShift Update Service を参照してください。 -
mirror.operators.catalog: OpenShift Container Platform イメージを取得する Operator カタログを指定します。 -
mirror.operators.packages.name: イメージセットに含める Operator パッケージを指定します。このフィールドが空の場合、カタログ内のすべてのパッケージが取得されます。 -
mirror.operators[].packages[].channels.name: イメージセットに含める Operator パッケージのチャネルを指定します。Operator パッケージのデフォルトチャネルは、そのチャネルのバンドルを使用しない場合でも含める必要があります。コマンド$ oc mirror list operators --catalog=<catalog_name> --package=<package_name>を実行すると、デフォルトチャネルを見つけることができます。 -
mirror.additionalImages.name: イメージセットに含める追加のイメージを指定します。
-
- イメージセットをミラーレジストリーにミラーリングする の手順に従います。
- イメージレジストリーリポジトリーのミラーリングの設定の手順に従います。
5.4.1.5. RHACM を使用した LVM Storage のインストール リンクのコピーリンクがクリップボードにコピーされました!
Red Hat Advanced Cluster Management (RHACM)を使用してクラスターに LVM ストレージをインストールするには、Policy カスタムリソース(CR)を作成し、ターゲットクラスターを選択する基準を設定する必要があります。
LVM Storage をインストールするために作成した Policy CR は、Policy CR の作成後にインポートまたは作成したクラスターにも適用されます。
前提条件
-
cluster-adminおよび Operator のインストール権限を持つアカウントを使用して、RHACM クラスターにアクセスできる。 - 各クラスターに、LVM Storage が使用できる専用のディスクがある。
- クラスターが RHACM によって管理されている。
手順
- OpenShift Container Platform の認証情報を使用して RHACM CLI にログインします。
namespace を作成します。
$ oc create ns <namespace>PolicyCR YAML ファイルを作成します。LVM Storage をインストールして設定するための
PolicyCR の例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-lvm-storage - complianceType: musthave objectDefinition: apiVersion: operators.coreos.com/v1 kind: OperatorGroup metadata: name: openshift-storage-operatorgroup namespace: openshift-lvm-storage spec: targetNamespaces: - openshift-lvm-storage - complianceType: musthave objectDefinition: apiVersion: operators.coreos.com/v1alpha1 kind: Subscription metadata: name: lvms namespace: openshift-lvm-storage spec: installPlanApproval: Automatic name: lvms-operator source: redhat-operators sourceNamespace: openshift-marketplace remediationAction: enforce severity: low-
spec.clusterSelector: LVM ストレージをインストールするクラスターで設定されているラベルと一致するように、PlacementRule.spec.clusterSelectorのキーフィールドとvaluesフィールドを設定します。 -
spec.policy-templates[0].objectDefinition[0].spec.object-templates[0].objectDefinition: namespace 設定を指定します。 -
spec.policy-templates[0].objectDefinition[1].spec.object-templates[1].objectDefinition:OperatorGroupCR 設定を指定します。 -
spec.policy-templates[0].objectDefinition.spec.object-templates[2].objectDefinition:SubscriptionCR 設定を指定します。
-
次のコマンドを実行して
PolicyCR を作成します。$ oc create -f <file_name> -n <namespace>PolicyCR を作成すると、PlacementRuleCR で設定された選択基準に一致するクラスターに次のカスタムリソースが作成されます。-
Namespace -
OperatorGroup Subscription注記LVM Storage Operator のデフォルトの namespace は
openshift-lvm-storageです。
-
5.4.2. LVMCluster カスタムリソースについて リンクのコピーリンクがクリップボードにコピーされました!
LVMCluster カスタムリソース(CR)は、LVM Storage デプロイメントの主要な設定であり、ワークロードの要件を満たすボリュームグループ、デバイス、ノード選択、シンプール設定を指定して、クラスター全体でストレージをプロビジョニングする方法を定義します。
次の操作を実行するように 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
forceWipeDevicesAndDestroyAllData: true
thinPoolConfig:
name: thin-pool-1
sizePercent: 90
overprovisionRatio: 10
chunkSize: 128Ki
chunkSizeCalculationPolicy: Static
metadataSize: 1Gi
metadataSizeCalculationPolicy: Host
オプションのフィールドは次のとおりです。fstype、nodeSelector、deviceSelector、sizePercent、chunkSize、chunkSizeCalculationPolicy、metadataSize、metadataSizeCalculationPolicy。
5.4.2.1. LVMCluster CR のフィールドの説明 リンクのコピーリンクがクリップボードにコピーされました!
LVMCluster CR のフィールドは、次の表で説明します。
| フィールド | 型 | 説明 |
|---|---|---|
|
|
| ローカルストレージデバイスを LVM ボリュームグループに割り当てるための設定を含めます。 LVM Storage は、ユーザーが作成する各デバイスクラスに対してストレージクラスとボリュームスナップショットクラスを作成します。 |
|
|
| LVM ボリュームグループ (VG) の名前を指定します。 以前のインストールで作成したボリュームグループを再利用するようにこのフィールドを設定することもできます。詳細は、「以前の LVM Storage インストールからのボリュームグループの再利用」を参照してください。 |
|
|
|
このフィールドは、 |
|
|
|
デバイスクラスがデフォルトであることを指定するには、このフィールドを |
|
|
| LVM ボリュームグループを作成するノードを選択するための設定を含めます。このフィールドが空の場合、no-schedule テイントのないすべてのノードが考慮されます。 コントロールプレーンノードでは、クラスター内で新しいノードがアクティブになると、LVM Storage が追加のワーカーノードを検出して使用します。 |
|
|
| ノードの選択に使用する要件を設定します。 |
|
|
| 次の操作を実行するための設定を含めます。
詳細は、「ボリュームグループへのデバイスの追加について」を参照してください。 |
|
|
| デバイスパスを指定します。
このフィールドに指定されたデバイスパスが存在しない場合、またはデバイスが LVM Storage でサポートされていない場合、 |
|
|
| オプションのデバイスパスを指定します。 このフィールドに指定されたデバイスパスが存在しない場合、またはデバイスが LVM Storage によってサポートされていない場合、LVM Storage はエラーを起こすことなくデバイスを無視します。 |
|
|
| LVM Storage は、ファイルシステム署名が含まれていない空のディスクのみを使用します。確実にディスクが空で、ファイルシステム署名が含まれていないようにするには、使用する前にディスクを消去します。
選択したデバイスを強制的にワイプするには、このフィールドを 警告
このフィールドが 次の条件のいずれかが満たされている場合にデバイスをワイプすると、データの整合性が失われる可能性があります。
これらの条件のいずれかに該当する場合は、ディスクを強制的にワイプしないでください。代わりに、ディスクを手動でワイプする必要があります。 |
|
|
| LVM ボリュームグループにシンプールを作成するための設定を含めます。 このフィールドを除外すると、論理ボリュームはシックプロビジョニングされます。 シックプロビジョニングされたストレージを使用する場合、次の制限があります。
|
|
|
| シンプールの名前を指定します。 |
|
|
| シンプールを作成するための LVM ボリュームグループ内の領域の割合を指定します。 デフォルトでは、このフィールドは 90 に設定されています。設定できる最小値は 10、最大値は 90 です。 |
|
|
| シンプールで使用可能なストレージに基づいて追加のストレージをプロビジョニングするのに使用する係数を指定します。 たとえば、このフィールドが 10 に設定されている場合、シンプールで使用可能なストレージの量の最大 10 倍をプロビジョニングできます。このフィールドは、LVM クラスターが作成された後に変更できます。 パラメーターを更新するには、次のいずれかのタスクを実行します。
$ oc edit lvmcluster <lvmcluster_name>
$ oc patch lvmcluster <lvmcluster_name> -p <patch_file.yaml>
オーバープロビジョニングを無効にするには、このフィールドを 1 に設定します。 |
|
|
|
静的に計算されたチャンクサイズをシンプールに指定します。このフィールドは、
このフィールドを設定せず、 詳細は、「チャンクサイズの概要」を参照してください。 |
|
|
|
基盤となるボリュームグループのチャンクサイズを計算するポリシーを指定します。このフィールドは、
このフィールドが
このフィールドが 詳細は、「LVM Storage で使用するデバイスのサイズを設定する際の制限事項」を参照してください。 |
|
|
|
シンプールのメタデータサイズを指定します。
このフィールドが設定されておらず、
|
|
|
|
基になるボリュームグループのメタデータサイズを計算するポリシーを指定します。このフィールドは、
このフィールドが
このフィールドが |
5.4.2.2. LVM Storage で使用するデバイスのサイズを設定する際の制限事項 リンクのコピーリンクがクリップボードにコピーされました!
デバイスとストレージ操作の互換性を確保するため、LVM Storage におけるサイズ設定の制限事項を確認してください。これらの制約を遵守することで、選択されたデバイスが要求される容量仕様を確実に満たすようになり、プロビジョニングの失敗を防ぐことができます。
LVM Storage を使用してストレージをプロビジョニングする場合、以下の要因により、デバイスのサイズが制限されます。
- プロビジョニングできる合計ストレージサイズは、基礎となる論理ボリュームマネージャー (LVM) シンプールのサイズとオーバープロビジョニング係数によって制限されます。
論理ボリュームのサイズは、物理エクステント (PE) のサイズと論理エクステント (LE) のサイズによって異なります。
- PE および LE のサイズは、物理デバイスおよび論理デバイスの作成時に定義できます。
- デフォルトの PE および LE サイズは 4 MiB です。
- PE のサイズを大きくした場合、LVM の最大サイズは、カーネルの制限とディスク領域によって決定されます。
次の表に、静的設定とホスト設定のチャンクサイズとボリュームサイズの制限を示します。
| パラメーター | 値 |
|---|---|
| チャンクサイズ | 128 KiB |
| 最大ボリュームサイズ | 32 TiB |
| パラメーター | 最小値 | 最大値 |
|---|---|---|
| チャンクサイズ | 64 KiB | 1 GiB |
| ボリュームサイズ | 基盤となる Red Hat Enterprise Linux CoreOS (RHCOS) システムの最小サイズ。 | 基盤となる RHCOS システムの最大サイズ。 |
| パラメーター | 値 |
|---|---|
| チャンクサイズ |
この値は、 |
| 最大ボリュームサイズ | 基盤となる RHCOS システムの最大ボリュームサイズと同じです。 |
| 最小ボリュームサイズ | 基盤となる RHCOS システムの最小ボリュームサイズと同じです。 |
5.4.2.3. ボリュームグループへのデバイスの追加について リンクのコピーリンクがクリップボードにコピーされました!
デバイスを論理ボリュームマネージャー(LVM)ボリュームグループに追加するには、LVMCluster カスタムリソース(CR)の deviceSelector フィールドを使用して、デバイスへのパスを指定します。
デバイスへのパスは、deviceSelector.paths フィールド、deviceSelector.optionalPaths フィールド、またはその両方で指定できます。deviceSelector.paths フィールドと deviceSelector.optionalPaths フィールドのどちらにもデバイスパスを指定しなかった場合、LVM Storage によって、サポートされている未使用のデバイスがボリュームグループ (VG) に追加されます。
/dev/sdX などのシンボリックな命名を使用したディスクの参照は避けることが推奨されます。これらの名前は RHCOS 内での再起動によって変更される可能性があるためです。代わりに、一貫したディスク識別を確保するために、/dev/disk/by-path/ または /dev/disk/by-id/ などの安定した命名スキームを使用する必要があります。
この変更により、モニタリングで各ノードのインストールデバイスに関する情報が収集される場合、既存の自動化ワークフローの調整が必要になる可能性があります。
詳細は RHEL ドキュメント を参照してください。
deviceSelector フィールドに Redundant Array of Independent Disks (RAID) アレイへのパスを追加して、RAID アレイを LVM Storage と統合できます。mdadm ユーティリティーを使用して RAID アレイを作成できます。LVM Storage はソフトウェア RAID の作成をサポートしていません。
RAID アレイは、OpenShift Container Platform のインストール中にのみ作成できます。RAID アレイの作成方法は、以下を参照してください。
- RAID 対応データボリュームの設定
- インストール済みシステムでのソフトウェア RAID の作成
- "Replacing a failed disk in RAID"
- "RAID ディスクの修復"
暗号化されたデバイスをボリュームグループに追加することもできます。OpenShift Container Platform のインストール中に、クラスターノードでディスク暗号化を有効にすることができます。デバイスを暗号化した後、deviceSelector フィールドで LUKS 暗号化デバイスへのパスを指定できます。ディスク暗号化の詳細は、「ディスク暗号化について」および「ディスク暗号化とミラーリングの設定」を参照してください。
VG に追加するデバイスは、LVM Storage でサポートされている必要があります。サポートされていないデバイスの詳細は、「LVM Storage でサポートされていないデバイス」を参照してください。
LVM Storage は、次の条件が満たされた場合にのみ、デバイスを VG に追加します。
- デバイスパスが存在する。
- デバイスが LVM Storage によってサポートされている。
デバイスを VG に追加した後は、そのデバイスを削除することはできません。
LVM Storage は動的デバイス検出をサポートします。LVMCluster CR に deviceSelector フィールドを追加しない場合、デバイスが利用可能になると、LVM Storage は新しいデバイスを自動的に VG に追加します。
以下の理由により、動的デバイス検出を通じてデバイスを VG に追加することは推奨されません。
- VG に追加するつもりのない新しいデバイスを追加すると、LVM Storage は動的デバイス検出を通じてこのデバイスを VG に自動的に追加します。
- LVM Storage が動的デバイス検出を通じて VG にデバイスを追加する場合、LVM Storage はノードからデバイスを削除することを制限しません。VG にすでに追加されているデバイスを削除または更新すると、VG が中断される可能性があります。これにより、データが失われ、手動でのノードの修復が必要になる可能性もあります。
5.4.2.4. ボリュームグループからデバイスとデバイスクラスを削除する方法について リンクのコピーリンクがクリップボードにコピーされました!
LVMCluster CR の deviceSelector フィールドを更新することで、論理ボリュームマネージャー(LVM)ボリュームグループからデバイスおよびデバイスクラスを削除して、ストレージハードウェアの使用を廃止したり、ストレージ設定を再編成したりできます。
5.4.2.4.1. deviceSelector.paths フィールド内のデバイスパスを削除します。 リンクのコピーリンクがクリップボードにコピーされました!
deviceSelector.paths フィールド内のデバイスパスを削除できます。
デバイスパスを削除する前に、以下の条件を満たしていることを確認します。
-
削除しようとしているデバイスは空です。
pvdisplayコマンドを使用すると、LVM で使用されている物理ボリューム (PV) の属性を確認できます。 -
deviceSelector.pathsフィールドには、少なくとも 1 つの追加デバイスが指定されています。
5.4.2.4.2. LVMCluster から deviceClass を削除する リンクのコピーリンクがクリップボードにコピーされました!
LVMCluster リソースから deviceClass オブジェクトを削除することもできます。デバイスクラスの削除に関しては、deviceSelector.paths オブジェクトを削除する必要はありません。
デバイスクラスを削除する前に、以下の条件を満たしていることを確認します。
-
deviceClasses.defaultフィールドはfalseに設定されています。 -
deviceSelector.pathsフィールドで指定されたディスクは空です。 -
storageフィールドには、少なくとも 1 つの追加のデバイスクラスが指定されています。
5.4.2.5. LVM Storage でサポートされないデバイス リンクのコピーリンクがクリップボードにコピーされました!
LVMCluster カスタムリソース(CR)にデバイスパスを追加する場合は、デバイスが LVM ストレージでサポートされていることを確認してください。LVM ストレージは、論理ボリューム管理の複雑さを回避するために、サポートされていないデバイスを除外します。
deviceSelector フィールドでデバイスパスを指定しない場合、LVM Storage はサポート対象の未使用デバイスのみ追加します。
デバイスに関する情報を取得するには、次のコマンドを実行します。
$ lsblk --paths --json -o \
NAME,ROTA,TYPE,SIZE,MODEL,VENDOR,RO,STATE,KNAME,SERIAL,PARTLABEL,FSTYPE
LVM Storage は、次のデバイスをサポートしません。
- 読み取り専用デバイス
-
roパラメーターがtrueに設定されているデバイス。 - 一時停止されたデバイス
-
stateパラメーターがsuspendedに設定されているデバイス。 - ROM デバイス
-
typeパラメーターがromに設定されているデバイス。 - LVM パーティションデバイス
-
typeパラメーターがlvmに設定されているデバイス。 - 無効なパーティションラベルを持つデバイス
-
partlabelパラメーターがbios、boot、またはreservedに設定されているデバイス。 - 無効なファイルシステムを持つデバイス
fstypeパラメーターが、nullまたはLVM2_member以外の値に設定されているデバイス。重要LVM Storage は、そのデバイスに子デバイスが含まれていない場合に限り、
fstypeパラメーターがLVM2_memberに設定されているデバイスをサポートします。- 別のボリュームグループの一部であるデバイス
デバイスのボリュームグループに関する情報を取得するには、次のコマンドを実行します。
$ pvs <device-name><
;device-name>は、デバイス名に置き換えます。- バインドマウントを備えたデバイス
デバイスのマウントポイントを取得するには、次のコマンドを実行します。
$ cat /proc/1/mountinfo | grep <device-name><
;device-name>は、デバイス名に置き換えます。- 子デバイスを含むデバイス
予期しない動作を防ぐために、LVM Storage で使用する前にデバイスをワイプすることが推奨されます。
5.4.3. LVMCluster カスタムリソースを作成する方法 リンクのコピーリンクがクリップボードにコピーされました!
LVMCluster カスタムリソース(CR)を作成し、OpenShift CLI (oc)、OpenShift Container Platform Web コンソール、または Red Hat Advanced Cluster Management (RHACM)を使用して、LVM ストレージデプロイメントを設定し、ワークロードのストレージをプロビジョニングできます。
RHACM を使用して LVMCluster CR を作成する場合は、RHACM を使用して LVM ストレージをインストールする必要があります。
LVMCluster CR は、LVM Storage Operator をインストールしたのと同じ namespace (デフォルトでは openshift-storage) に作成する必要があります。
LVMCluster CR を作成すると、LVM ストレージは次のシステム管理 CR を作成します。
各デバイスクラスの
storageClassとvolumeSnapshotClass。注記LVM Storage は、ストレージクラスとボリュームスナップショットクラスの名前を
lvms-<device_class_name>の形式で設定します。<device_class_name>は、LVMClusterCR のdeviceClasses.nameフィールドの値です。たとえば、deviceClasses.nameフィールドが vg1 に設定されている場合、ストレージクラスとボリュームスナップショットクラスの名前はlvms-vg1になります。-
LVMVolumeGroup: この CR は、LVM ボリュームグループによってサポートされる特定のタイプの永続ボリューム (PV) です。複数のノードにわたる個々のボリュームグループを追跡します。 -
LVMVolumeGroupNodeStatus: この CR は、ノード上のボリュームグループのステータスを追跡します。
5.4.3.1. 以前の LVM Storage インストールからのボリュームグループを再利用する リンクのコピーリンクがクリップボードにコピーされました!
以前の LVM ストレージインストールから既存のボリュームグループ(VG)を再利用して、既存のストレージ設定を保持し、LVM ストレージを再インストールまたはアップグレード時に VG を再作成しないようにすることができます。
VG のみを再利用できますが、VG に関連付けられた論理ボリュームは使用できません。
この手順は、LVMCluster カスタムリソース (CR) の作成中にのみ実行できます。
前提条件
- 再利用する VG が破損していない。
-
再利用する VG に
lvmsタグが付いている。LVM オブジェクトにタグを追加する方法は、「LVM オブジェクトのタグによるグループ化」を参照してください。
手順
-
LVMClusterCR YAML ファイルを開きます。 次の例の説明に従って、
LVMClusterCR のパラメーターを設定します。LVMClusterCR YAML ファイルの例apiVersion: lvm.topolvm.io/v1alpha1 kind: LVMCluster metadata: name: my-lvmcluster spec: # ... storage: deviceClasses: - name: vg1 fstype: ext4 default: true deviceSelector: # ... forceWipeDevicesAndDestroyAllData: false thinPoolConfig: # ... nodeSelector: # ...-
spec.storage.deviceClasses.name: 以前の LVM ストレージインストールからの VG の名前を指定します。 -
spec.storage.deviceClasses.fstype: このフィールドをext4またはxfsに設定します。デフォルトでは、このフィールドはxfsに設定されています。 -
spec.storage.deviceClasses.name.: deviceSelector フィールドに新しいデバイスパスを指定することで、再利用する VG に新しいデバイスを追加できます。新しいデバイスを VG に追加する必要がない場合は、現在の LVM Storage インストールのdeviceSelectordeviceSelector設定が以前の LVM Storage インストールの設定と同じであることを確認してください。 -
spec…forceWipeDevicesAndDestroyAllData: このフィールドをtrueに設定すると、LVM ストレージは VG に追加されたデバイス上のすべてのデータを消去します。 -
spec….thinPoolConfig: 再利用する VG のthinPoolConfig設定を保持するには、現在の LVM ストレージインストールのthinPoolConfig設定が以前の LVM ストレージインストールの thinPoolConfig 設定と同じであることを確認します。保持しない場合は、必要に応じてthinPoolConfigフィールドを設定できます。 -
spec…nodeSelector: LVM ボリュームグループを作成するノードを選択するための要件を設定します。このフィールドが空の場合、no-schedule テイントのないすべてのノードが考慮されます。
-
-
LVMClusterCR YAML ファイルを保存します。
検証
ボリュームグループに含まれているデバイスを表示するには、次のコマンドを実行します。
$ pvs -S vgname=<vg_name>
<vg_name> は、ボリュームグループの名前に置き換えます。
5.4.3.2. 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 ファイルを作成します。LVMClusterCR YAML ファイルの例apiVersion: lvm.topolvm.io/v1alpha1 kind: LVMCluster metadata: name: my-lvmcluster namespace: openshift-lvm-storage spec: # ... storage: deviceClasses: # ... nodeSelector: # ... deviceSelector: # ... thinPoolConfig: # ...-
spec.storage.deviceClasses: ローカルストレージデバイスを LVM ボリュームグループに割り当てるための設定を指定します。 -
spec…nodeSelector: LVM ボリュームグループを作成するノードを選択する設定を指定します。このフィールドが空の場合、no-schedule テイントのないすべてのノードが考慮されます。 -
spec…deviceSelector: LVM ボリュームグループに追加するデバイスへのパスを指定し、LVM ボリュームグループに追加されたデバイスを強制的にワイプするための設定を指定します。 -
spec…thinPoolConfig: LVM ボリュームグループにシンプールを作成する設定を指定します。このフィールドを除外すると、論理ボリュームはシックプロビジョニングされます。
-
次のコマンドを実行して、
LVMClusterCR を作成します。$ oc create -f <file_name>出力例
lvmcluster/lvmcluster created
検証
次のコマンドを実行して、
LVMClusterCR がReady状態であることを確認します。$ oc get lvmclusters.lvm.topolvm.io -o jsonpath='{.items[*].status}' -n <namespace>出力例
{"deviceClassStatuses": [ { "name": "vg1", "nodeStatus": [ { "devices": [ "/dev/nvme0n1", "/dev/nvme1n1", "/dev/nvme2n1" ], "node": "kube-node", "status": "Ready" } ] } ] "state":"Ready"}-
deviceClassStatuses: デバイスクラスのステータスを指定します。 -
nodeStatus: 各ノードの LVM ボリュームグループのステータスを指定します。 -
devices: LVM ボリュームグループの作成に使用されるデバイスのリストを指定します。 -
node: デバイスクラスが作成されるノードを指定します。 -
status: ノード上の LVM ボリュームグループのステータスを指定します。 state:LVMClusterCR のステータスを指定します。注記LVMClusterCR がFailed状態の場合、statusフィールドに失敗の理由が表示されます。ステータスフィールドの例と、失敗の理由は次のとおりです。status: deviceClassStatuses: - name: vg1 nodeStatus: - node: my-node-1.example.com reason: no available devices found for volume group status: Failed state: Failed
-
各デバイスクラスに対して LVM ストレージによって作成されたストレージクラスを表示するには、次のコマンドを実行します。
$ oc get storageclass出力例
NAME PROVISIONER RECLAIMPOLICY VOLUMEBINDINGMODE ALLOWVOLUMEEXPANSION AGE lvms-vg1 topolvm.io Delete WaitForFirstConsumer true 31m各デバイスクラスに対して LVM ストレージによって作成されたボリュームスナップショットクラスを表示するには、以下のコマンドを実行します。
$ oc get volumesnapshotclass出力例
NAME DRIVER DELETIONPOLICY AGE lvms-vg1 topolvm.io Delete 24h
5.4.3.3. 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 コンソールにログインします。
-
Ecosystem
Installed Operators をクリックします。 -
openshift-lvm-storagenamespace で、LVM Storage をクリックします。 - Create LVMCluster をクリックし、Form view または YAML view のいずれかを選択します。
-
LVMClusterCR の必要なパラメーターを設定します。 - Create をクリックします。
オプション:
LVMCLusterCR を編集する場合は、次の操作を実行します。- LVMCluster タブをクリックします。
- Actions メニューから Edit LVMCluster を選択します。
-
YAML をクリックし、
LVMCLusterCR の必要なパラメーターを編集します。 - Save をクリックします。
検証
-
LVMCLuster ページで、
LVMClusterCR がReady状態であることを確認します。 -
オプション: 各デバイスクラスに対して LVM Storage によって作成された使用可能なストレージクラスを表示するには、Storage
StorageClasses をクリックします。 -
オプション: 各デバイスクラスに対して LVM Storage によって作成された使用可能なボリュームスナップショットクラスを表示するには、Storage
VolumeSnapshotClasses をクリックします。
5.4.3.4. RHACM を使用した LVMCluster CR の作成 リンクのコピーリンクがクリップボードにコピーされました!
RHACM を使用して論理ボリュームマネージャー(LVM)ストレージをインストールした後、LVMCluster カスタムリソース(CR)を作成してストレージデプロイメントを設定し、デバイスとボリュームグループを指定し、ワークロードのストレージをプロビジョニングします。
前提条件
- RHACM を使用して LVM Storage をインストールした。
-
cluster-admin権限を持つアカウントを使用して RHACM クラスターにアクセスできる。 - 「LVMCluster カスタムリソースについて」セクションを確認した。
手順
- OpenShift Container Platform の認証情報を使用して RHACM CLI にログインします。
LVMClusterCR を作成するための設定を含むConfigurationPolicyCR YAML ファイルを作成します。LVMClusterCR を作成するためのConfigurationPolicyCR YAML ファイルの例apiVersion: policy.open-cluster-management.io/v1 kind: ConfigurationPolicy metadata: name: lvms namespace: openshift-lvm-storage spec: object-templates: - complianceType: musthave objectDefinition: apiVersion: lvm.topolvm.io/v1alpha1 kind: LVMCluster metadata: name: my-lvmcluster namespace: openshift-lvm-storage spec: storage: deviceClasses: # ... deviceSelector: # ... thinPoolConfig: # ... nodeSelector: # ... remediationAction: enforce severity: low-
spec.object-templates.objectDefinition.spec.storage.deviceClasses: ローカルストレージデバイスを LVM ボリュームグループに割り当てる設定を指定します。 -
spec…deviceSelector: LVM ボリュームグループに追加するデバイスへのパスを指定し、LVM ボリュームグループに追加されたデバイスを強制的にワイプする設定が含まれます。 -
spec…thinPoolConfig: LVM ボリュームグループにシンプールを作成する設定が含まれます。このフィールドを除外すると、論理ボリュームはシックプロビジョニングされます。 -
spec…nodeSelector: LVM ボリュームグループを作成するノードを選択する設定が含まれます。このフィールドが空の場合、no-schedule テイントのないすべてのノードが考慮されます。
-
次のコマンドを実行して、
ConfigurationPolicyCR を作成します。$ oc create -f <file_name> -n <cluster_namespace><cluster_namespace> は、LVM ストレージがインストールされている OpenShift Container Platform クラスターの namespace です。
5.4.4. LVMCluster カスタムリソースを削除する方法 リンクのコピーリンクがクリップボードにコピーされました!
LVM ストレージの使用を停止するとき、または OpenShift CLI (oc)、OpenShift Container Platform Web コンソール、または Red Hat Advanced Cluster Management (RHACM)を使用してストレージを再設定するときに、LVMCluster カスタムリソース(CR)を削除します。
RHACM を使用して LVMCluster CR を削除するには、RHACM を使用して LVM ストレージをインストールする必要があります。
LVMCluster CR を削除した後、LVM ストレージは次の CR を削除します。
-
storageClass -
volumeSnapshotClass -
LVMVolumeGroup -
LVMVolumeGroupNodeStatus
5.4.4.1. CLI を使用した LVMCluster CR の削除 リンクのコピーリンクがクリップボードにコピーされました!
LVM ストレージの使用を停止するとき、または OpenShift CLI (oc)を使用してストレージを再設定するときに、LVMCluster カスタムリソース(CR)を削除できます。
前提条件
-
cluster-adminパーミッションを持つユーザーとして OpenShift Container Platform にアクセスできる。 - LVM Storage によってプロビジョニングされた永続ボリューム要求 (PVC)、ボリュームスナップショット、およびボリュームクローンが削除されている。これらのリソースを使用しているアプリケーションも削除されている。
手順
-
OpenShift CLI (
oc) にログインします。 次のコマンドを実行して、
LVMClusterCR を削除します。$ oc delete lvmcluster <lvm_cluster_name> -n <namespace>
検証
LVMClusterCR が削除されたことを確認するには、次のコマンドを実行します。$ oc get lvmcluster -n <namespace>出力例
No resources found in openshift-lvm-storage namespace.
5.4.4.2. Web コンソールを使用した LVMCluster CR の削除 リンクのコピーリンクがクリップボードにコピーされました!
LVM ストレージの使用を停止するとき、または OpenShift Container Platform Web コンソールを使用してストレージを再設定するときに、LVMCluster カスタムリソース(CR)を削除できます。
前提条件
-
cluster-adminパーミッションを持つユーザーとして OpenShift Container Platform にアクセスできる。 - LVM Storage によってプロビジョニングされた永続ボリューム要求 (PVC)、ボリュームスナップショット、およびボリュームクローンが削除されている。これらのリソースを使用しているアプリケーションも削除されている。
手順
- OpenShift Container Platform Web コンソールにログインします。
-
Ecosystem
Installed Operators をクリックして、インストールされているすべての Operators を表示します。 -
openshift-lvm-storagenamespace で LVM Storage をクリックします。 - LVMCluster タブをクリックします。
- Actions から Delete LVMCluster を選択します。
- Delete をクリックします。
検証
-
LVMCLusterページで、LVMClusterCR が削除されたことを確認します。
5.4.4.3. RHACM を使用した LVMCluster CR の削除 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat Advanced Cluster Management (RHACM)を使用して、LVM ストレージの使用を停止するか、ストレージを再設定するときに LVMCluster カスタムリソース(CR)を削除できます。
Red Hat Advanced Cluster Management (RHACM)を使用して LVM ストレージをインストールした場合は、RHACM を使用してのみ LVMCluster CR を削除できます。
前提条件
-
cluster-admin権限を持つユーザーとして RHACM クラスターにアクセスできる。 - LVM Storage によってプロビジョニングされた永続ボリューム要求 (PVC)、ボリュームスナップショット、およびボリュームクローンが削除されている。これらのリソースを使用しているアプリケーションも削除されている。
手順
- OpenShift Container Platform の認証情報を使用して RHACM CLI にログインします。
LVMClusterCR 用に作成したConfigurationPolicyCR YAML ファイルを削除します。$ oc delete -f <file_name> -n <cluster_namespace><cluster_namespace> は、LVM ストレージがインストールされている OpenShift Container Platform クラスターの namespace です。LVMClusterCR を削除するためのPolicyCR YAML ファイルを作成します。LVMClusterCR を削除するためのPolicyCR の例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-lvm-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-
spec.policy-templates.spec.remediationAction: このフィールドは、spec.remediationActionの前のパラメーター値によって上書きされます。 -
spec.policy-templates.objectDefinition.spec.objectDefinition.metadata.namespace: このnamespaceフィールドにはopenshift-lvm-storage値が必要です。 -
spec.clusterSelector: クラスターを選択できるように要件を設定します。選択基準に一致するクラスターから LVM Storage がアンインストールされます。
-
次のコマンドを実行して
PolicyCR を作成します。$ oc create -f <file_name> -n <namespace>LVMClusterCR が削除されたかどうかを確認するためのPolicyCR YAML ファイルを作成します。LVMClusterCR が削除されたかどうかを確認するためのPolicyCR の例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-lvm-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-
spec.policy-templates.objectDefinition.spec.remediationAction: このフィールドは、spec.remediationActionの前のパラメーター値によってオーバーライドされます。 -
spec.policy-templates.objectDefinition.spec.object-templates.objectDefinition.metadata.namespace: このnamespaceフィールドにはopenshift-lvm-storage値が必要です。
-
次のコマンドを実行して
PolicyCR を作成します。$ oc create -f <file_name> -n <namespace>
検証
次のコマンドを実行して、
PolicyCR のステータスを確認します。$ oc get policy -n <namespace>出力例
NAME REMEDIATION ACTION COMPLIANCE STATE AGE policy-lvmcluster-delete enforce Compliant 15m policy-lvmcluster-inform inform Compliant 15m重要PolicyCR がCompliant状態である必要があります。
5.4.5. LVM ストレージを使用したストレージのプロビジョニング リンクのコピーリンクがクリップボードにコピーされました!
LVMCluster カスタムリソース(CR)を使用して LVM ボリュームグループを作成したら、ボリュームグループからローカルストレージを動的に割り当てる 永続ボリューム要求(PVC)を作成することにより、ワークロードにストレージをプロビジョニングできます。
以下は、各ファイルシステムタイプに対して要求できる最小ストレージサイズです。
-
block: 8 MiB -
xfs: 300 MiB -
ext4: 32 MiB
PVC を作成するには、PersistentVolumeClaim オブジェクトを作成する必要があります。
前提条件
-
LVMClusterCR が作成されている。
手順
-
OpenShift CLI (
oc) にログインします。 PersistentVolumeClaimオブジェクトを作成します。PersistentVolumeClaimオブジェクトの例apiVersion: v1 kind: PersistentVolumeClaim metadata: name: lvm-block-1 namespace: default spec: accessModes: - ReadWriteOnce volumeMode: Filesystem resources: requests: storage: 10Gi limits: storage: 20Gi storageClassName: lvms-vg1-
metadata.name: PVC の名前を指定します。 -
spec.volumeMode: ファイル PVC を作成するには、このフィールドをFilesystemに設定します。ブロック PVC を作成するには、このフィールドをBlockに設定します。 -
spec.resources.requests.storage: ストレージサイズを指定します。値が最小ストレージサイズより小さい場合、要求されるストレージサイズは最小ストレージサイズに切り上げられます。プロビジョニングできる合計ストレージサイズは、Logical Volume Manager (LVM) シンプールのサイズとオーバープロビジョニング係数によって制限されます。 -
spec.resources.limits.storage: (オプション)ストレージの制限を指定します。このフィールドには、最小ストレージサイズ以上の値を設定します。それ以外の場合、PVC の作成はエラーが発生して失敗します。 spec.storageClassName:storageClassNameフィールドの値は、lvms-<device_class_name> 形式である必要があります。<device_class_name> は、LVMClusterCR のdeviceClasses.nameフィールドの値になります。たとえば、
deviceClasses.nameフィールドがvg1に設定されている場合、storageClassNameフィールドをlvms-vg1に設定する必要があります。注記ストレージクラスの
volumeBindingModeフィールドはWaitForFirstConsumerに設定されます。
-
以下のコマンドを実行して PVC を作成します。
# oc create -f <file_name> -n <application_namespace>注記作成された PVC は、それらを使用する Pod をデプロイするまで
Pending状態のままになります。
検証
PVC が作成されたことを確認するには、次のコマンドを実行します。
$ oc get pvc -n <namespace>出力例
NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS AGE lvm-block-1 Bound pvc-e90169a8-fd71-4eea-93b8-817155f60e47 1Gi RWO lvms-vg1 5s
5.4.6. クラスターのストレージをスケールアップする方法 リンクのコピーリンクがクリップボードにコピーされました!
領域不足または新規アプリケーションの追加、または OpenShift CLI (oc)を使用して新規デバイスまたはワーカーノードを追加することにより、ワーカーノードのストレージ容量をスケールアップします。
OpenShift Container Platform は、ベアメタル user-provisioned infrastructure 上のクラスターの追加のワーカーノードをサポートします。
Logical Volume Manager (LVM) Storage は、ノードがアクティブになると、追加のワーカーノードを検出して使用します。
クラスター上の既存のワーカーノードに新しいデバイスを追加するには、LVMCluster カスタムリソース (CR) の deviceSelector フィールドに新しいデバイスへのパスを追加する必要があります。
LVMCluster CR に deviceSelector フィールドを追加できるのは、LVMCluster CR の作成時にのみです。LVMCluster CR の作成時に deviceSelector フィールドを追加しなかった場合は、LVMCluster CR を削除し、deviceSelector フィールドを含む新しい LVMCluster CR を作成する必要があります。
LVMCluster CR に deviceSelector フィールドを追加しない場合、デバイスが利用可能になると、LVM Storage は新しいデバイスを自動的に追加します。
LVM Storage は、サポートされるデバイスのみを追加します。サポートされていないデバイスの詳細は、「LVM Storage でサポートされていないデバイス」を参照してください。
5.4.6.1. CLI を使用したクラスターのストレージのスケールアップ リンクのコピーリンクがクリップボードにコピーされました!
領域不足または新規アプリケーションの追加、または OpenShift CLI (oc)を使用して新規デバイスまたはワーカーノードを追加することにより、ワーカーノードのストレージ容量をスケールアップします。
前提条件
- 各クラスターには、Logical Volume Manager (LVM) Storage で使用される追加の未使用デバイスがある。
-
OpenShift CLI (
oc) がインストールされている。 -
LVMClusterカスタムリソース (CR) が作成されている。
手順
次のコマンドを実行して、
LVMClusterCR を編集します。$ oc edit <lvmcluster_file_name> -n <namespace>deviceSelectorフィールドに新しいデバイスへのパスを追加します。LVMClusterCR の例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 # ...spec…deviceSelector: LVM ボリュームグループに追加するデバイスへのパスを指定する設定が含まれます。デバイスパスは、pathsフィールド、optionalPathsフィールド、またはその両方で指定できます。pathsとoptionalPathsの両方でデバイスパスを指定しない場合、Logical Volume Manager (LVM) Storage は、サポートされている未使用のデバイスを LVM ボリュームグループに追加します。LVM Storage は、次の条件が満たされている場合にのみ、デバイスを LVM ボリュームグループに追加します。- デバイスパスが存在する。
- デバイスが LVM Storage によってサポートされている。サポートされていないデバイスの詳細は、「LVM Storage でサポートされていないデバイス」を参照してください。
-
spec…deviceSelector.paths: デバイスパスを指定します。このフィールドに指定されたデバイスパスが存在しない場合、またはデバイスが LVM Storage でサポートされていない場合、LVMClusterCR がFailed状態に移行します。 spec…deviceSelector.optionalPaths: オプションのデバイスパスを指定します。このフィールドに指定されたデバイスパスが存在しない場合、またはデバイスが LVM Storage によってサポートされていない場合、LVM Storage はエラーを起こすことなくデバイスを無視します。重要デバイスが LVM ボリュームグループに追加された後は、デバイスを削除できません。
-
LVMClusterCR を保存します。
5.4.6.2. Web コンソールを使用したクラスターのストレージのスケールアップ リンクのコピーリンクがクリップボードにコピーされました!
領域不足または新規アプリケーションの追加、または OpenShift Container Platform Web コンソールを使用して新規デバイスまたはワーカーノードを追加してクラスター容量を拡張する場合に、ワーカーノードのストレージ容量をスケールアップします。
前提条件
- 各クラスターには、Logical Volume Manager (LVM) Storage で使用される追加の未使用デバイスがある。
-
LVMClusterカスタムリソース (CR) が作成されている。
手順
- OpenShift Container Platform Web コンソールにログインします。
-
Ecosystem
Installed Operators をクリックします。 -
openshift-lvm-storagenamespace で LVM Storage をクリックします。 -
LVMCluster タブをクリックして、クラスター上に作成された
LVMClusterCR を表示します。 - Actions メニューから Edit LVMCluster を選択します。
- YAML タブをクリックします。
LVMClusterCR を編集して、deviceSelectorフィールドに新しいデバイスパスを追加します。LVMClusterCR の例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 # ...spec…deviceSelector: LVM ボリュームグループに追加するデバイスへのパスを指定する設定が含まれます。デバイスパスは、pathsフィールド、optionalPathsフィールド、またはその両方で指定できます。pathsとoptionalPathsの両方でデバイスパスを指定しない場合、Logical Volume Manager (LVM) Storage は、サポートされている未使用のデバイスを LVM ボリュームグループに追加します。LVM Storage は、次の条件が満たされている場合にのみ、デバイスを LVM ボリュームグループに追加します。- デバイスパスが存在する。
- デバイスが LVM Storage によってサポートされている。サポートされていないデバイスの詳細は、「LVM Storage でサポートされていないデバイス」を参照してください。
-
spec…deviceSelector.paths: デバイスパスを指定します。このフィールドに指定されたデバイスパスが存在しない場合、またはデバイスが LVM Storage でサポートされていない場合、LVMClusterCR がFailed状態に移行します。 spec…deviceSelector.optionalPaths: オプションのデバイスパスを指定します。このフィールドに指定されたデバイスパスが存在しない場合、またはデバイスが LVM Storage によってサポートされていない場合、LVM Storage はエラーを起こすことなくデバイスを無視します。重要デバイスが LVM ボリュームグループに追加された後は、デバイスを削除できません。
- Save をクリックします。
5.4.6.3. RHACM を使用したクラスターのストレージのスケールアップ リンクのコピーリンクがクリップボードにコピーされました!
領域不足の実行、新規アプリケーションの追加、またはクラスター容量の拡張時にワーカーノードのストレージ容量をスケールアップして、RHACM を使用して新しいデバイスまたはワーカーノードを追加します。
前提条件
-
cluster-admin権限を持つアカウントを使用して RHACM クラスターにアクセスできる。 -
RHACM を使用して
LVMClusterカスタムリソース (CR) を作成した。 - 各クラスターには、Logical Volume Manager (LVM) Storage で使用される追加の未使用デバイスがある。
手順
- OpenShift Container Platform の認証情報を使用して RHACM CLI にログインします。
次のコマンドを実行して、RHACM を使用して作成した
LVMClusterCR を編集します。$ oc edit -f <file_name> -n <namespace><file_name>は、LVMClusterCR の名前に置き換えます。LVMClusterCR で、deviceSelectorフィールドに新しいデバイスへのパスを追加します。LVMClusterCR の例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-lvm-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 # ...deviceSelector: LVM ボリュームグループに追加するデバイスへのパスを指定する設定が含まれます。デバイスパスは、pathsフィールド、optionalPathsフィールド、またはその両方で指定できます。pathsとoptionalPathsの両方でデバイスパスを指定しない場合、Logical Volume Manager (LVM) Storage は、サポートされている未使用のデバイスを LVM ボリュームグループに追加します。LVM Storage は、次の条件が満たされている場合にのみ、デバイスを LVM ボリュームグループに追加します。- デバイスパスが存在する。
- デバイスが LVM Storage によってサポートされている。サポートされていないデバイスの詳細は、「LVM Storage でサポートされていないデバイス」を参照してください。
-
paths: デバイスパスを指定します。このフィールドに指定されたデバイスパスが存在しない場合、またはデバイスが LVM Storage でサポートされていない場合、LVMClusterCR がFailed状態に移行します。 optionalPaths: オプションのデバイスパスを指定します。このフィールドに指定されたデバイスパスが存在しない場合、またはデバイスが LVM Storage によってサポートされていない場合、LVM Storage はエラーを起こすことなくデバイスを無視します。重要デバイスが LVM ボリュームグループに追加された後は、デバイスを削除できません。
-
LVMClusterCR を保存します。
5.4.7. 永続ボリューム要求の拡張 リンクのコピーリンクがクリップボードにコピーされました!
クラスターストレージをスケールアップした後、既存の永続ボリューム要求(PVC)を拡張し、PVC の storage フィールドを更新してそれらの ストレージ 容量を増やすことができます。
前提条件
- 動的プロビジョニングを使用している。
-
PVC に関連付けられた
StorageClassオブジェクトには、allowVolumeExpansionフィールドがtrueに設定されています。
手順
-
OpenShift CLI (
oc) にログインします。 次のコマンドを実行して、
spec.resources.requests.storageフィールドの値を現在の値より大きい値に更新します。$ oc patch pvc <pvc_name> -n <application_namespace> \ --type=merge -p \ '{ "spec": { "resources": { "requests": { "storage": "<desired_size>" }}}}'-
<pvc_name>を、拡張する PVC の名前に置き換えます。 -
<desired_size>を、新しいサイズに置き換えて PVC を拡張します。
-
検証
サイズ変更が完了したことを確認するには、次のコマンドを実行します。
$ oc get pvc <pvc_name> -n <application_namespace> -o=jsonpath={.status.capacity.storage}LVM Storage は、拡張中に PVC に
Resizing条件を追加します。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>
検証
PVC が削除されたことを確認するには、次のコマンドを実行します。
$ oc get pvc -n <namespace>削除された PVC は、このコマンドの出力には存在しません。
5.4.9. ボリュームスナップショットについて リンクのコピーリンクがクリップボードにコピーされました!
LVM ストレージによってプロビジョニングされた永続ボリューム要求(PVC)のボリュームスナップショットを作成してアプリケーションデータのバックアップを作成したり、以前の状態に戻したりしてデータ保護とリカバリー機能を提供します。
ボリュームスナップショットを使用して、次のアクションを実行できます。
アプリケーションデータをバックアップします。
重要ボリュームスナップショットは元のデータと同じデバイスにあります。ボリュームスナップショットをバックアップとして使用するには、スナップショットをセキュアな場所に移動する必要があります。OpenShift API for Data Protection (OADP) のバックアップおよび復元ソリューションを使用できます。OADP の詳細は、「OADP の機能」を参照してください。
- ボリュームスナップショットが作成された状態に戻します。
ボリュームクローンのボリュームスナップショットを作成することもできます。
5.4.9.1. マルチノードトポロジーでボリュームスナップショットを作成する場合の制限事項 リンクのコピーリンクがクリップボードにコピーされました!
LVM Storage には、マルチノードトポロジーでのボリュームスナップショットの作成に関して、次の制限があります。
- ボリュームスナップショットの作成は、LVM シンプール機能に基づいています。
- ボリュームスナップショットを作成した後、元のデータソースをさらに更新するために、ノードには追加のストレージ領域が必要です。
- ボリュームスナップショットは、元のデータソースをデプロイしたノード上でのみ作成できます。
- スナップショットデータを使用する PVC に依存する Pod は、元のデータソースをデプロイしたノードでのみスケジュールできます。
5.4.9.2. ボリュームスナップショットの作成 リンクのコピーリンクがクリップボードにコピーされました!
ボリュームスナップショットを作成して、利用可能なシンプールの容量とオーバープロビジョニングの制限に基づいて、VolumeSnapshot オブジェクトを作成して、データバックアップまたはリカバリーの目的で永続ボリューム要求(PVC)のポイントインタイムコピーをキャプチャーします。
ボリュームスナップショットを作成するには、VolumeSnapshotClass オブジェクトを作成する必要があります。
前提条件
-
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-
metadata.name: ボリュームスナップショットの名前を指定します。 -
spec.source.persistentVolumeClaimName: ソース PVC の名前を指定します。LVM Storage は、この PVC のスナップショットを作成します。 spec.volumeSnapshotClassName: ボリュームスナップショットクラスの名前を指定します。注記使用可能なボリュームスナップショットクラスのリストを取得するには、次のコマンドを実行します。
$ oc get volumesnapshotclass
-
次のコマンドを実行して、ソース PVC を作成した namespace にボリュームスナップショットを作成します。
$ oc create -f <file_name> -n <namespace>LVM Storage は、PVC の読み取り専用コピーをボリュームスナップショットとして作成します。
検証
ボリュームスナップショットが作成されたことを確認するには、次のコマンドを実行します。
$ oc get volumesnapshot -n <namespace>出力例
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作成したボリュームスナップショットの
READYTOUSEフィールドの値はtrueである必要があります。
5.4.9.3. ボリュームスナップショットの復元 リンクのコピーリンクがクリップボードにコピーされました!
スナップショットを参照する永続ボリューム要求(PVC)を作成し、元のスナップショットおよびソース PVC とは別の独立したコピーを作成することにより、ボリュームスナップショットを復元し、以前の時点からのデータを復元します。
ボリュームスナップショットを復元するには、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-
spec.Resources.Requests.storage: 復元された PVC のストレージサイズを指定します。要求された PVC のストレージサイズは、復元するボリュームスナップショットのストレージサイズ以上である必要があります。より大きな PVC が必要な場合は、ボリュームスナップショットを復元した後に PVC のサイズを変更することもできます。 -
spec.storageClassName: このフィールドを、復元するボリュームスナップショットのソース PVC のstorageClassNameフィールドの値に設定します。 -
spec.dataSource.name: このフィールドを、復元するボリュームスナップショットの名前に設定します。
-
次のコマンドを実行して、ボリュームスナップショットを作成した namespace に PVC を作成します。
$ oc create -f <file_name> -n <namespace>
検証
ボリュームスナップショットが復元されたことを確認するには、次のコマンドを実行します。
$ oc get pvc -n <namespace>出力例
NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS AGE lvm-block-1-restore Bound pvc-e90169a8-fd71-4eea-93b8-817155f60e47 1Gi RWO lvms-vg1 5s
5.4.9.4. ボリュームスナップショットの削除 リンクのコピーリンクがクリップボードにコピーされました!
ソースの永続ボリューム要求(PVC)を削除するときにスナップショットが自動的に削除されないため、ストレージリソースを解放し、孤立したスナップショットを防ぐためにボリュームスナップショットを削除します。
永続ボリューム要求 (PVC) を削除すると、LVM Storage は永続ボリューム要求のみを削除し、永続ボリューム要求のスナップショットは削除しません。
前提条件
-
cluster-adminパーミッションを持つユーザーとして OpenShift Container Platform にアクセスできる。 - 削除するボリュームスナップショットが使用されていないことを確認している。
手順
-
OpenShift CLI (
oc) にログインします。 次のコマンドを実行して、ボリュームのスナップショットを削除します。
$ oc delete volumesnapshot <volume_snapshot_name> -n <namespace>
検証
ボリュームスナップショットが削除されたことを確認するには、次のコマンドを実行します。
$ oc get volumesnapshot -n <namespace>削除されたボリュームのスナップショットは、このコマンドの出力には存在しません。
5.4.10. ボリュームクローンについて リンクのコピーリンクがクリップボードにコピーされました!
ボリュームクローンは、既存の永続ボリューム要求(PVC)の複製です。これは、スナップショットよりも効率的に、データのポイントインタイムコピーを作成するもので、テストや開発、またはアプリケーションデータの独立したコピーの作成に役立ちます。
5.4.10.1. マルチノードトポロジーでボリュームクローンを作成する場合の制限事項 リンクのコピーリンクがクリップボードにコピーされました!
LVM Storage には、マルチノードトポロジーでのボリュームクローンの作成に関して、次の制限があります。
- ボリュームクローンの作成は、LVM シンプール機能に基づいています。
- ボリュームクローンを作成した後、元のデータソースをさらに更新するには、ノードに追加のストレージが必要です。
- ボリュームクローンは、元のデータソースをデプロイしたノード上でのみ作成できます。
- クローンデータを使用する PVC に依存する Pod は、元のデータソースをデプロイしたノード上でのみスケジュールできます。
5.4.10.2. ボリュームクローンの作成 リンクのコピーリンクがクリップボードにコピーされました!
ソース PVC を参照する Persistent Volume Claim (永続ボリューム要求、PVC)オブジェクトを作成して、テスト、開発、または独立した書き込み可能コピーの作成用に、重複した永続ボリューム要求(PVC)データに対してボリュームのクローンを作成します。
ソース 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-
spec.storageClassName: このフィールドをソース PVC のstorageClassNameフィールドの値に設定します。 -
spec.volumeMode: このフィールドをソース PVC のvolumeModeフィールドに設定します。 -
spec.dataSource.name: ソース PVC の名前を指定します。 -
spec.resources.requests.storage: クローン作成された PVC のストレージサイズを指定します。クローン作成された PVC のストレージサイズは、ソース PVC のストレージサイズ以上である必要があります。
-
次のコマンドを実行して、ソース PVC を作成した namespace に PVC を作成します。
$ oc create -f <file_name> -n <namespace>
検証
ボリュームクローンが作成されたことを確認するには、次のコマンドを実行します。
$ oc get pvc -n <namespace>出力例
NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS AGE lvm-block-1-clone Bound pvc-e90169a8-fd71-4eea-93b8-817155f60e47 1Gi RWO lvms-vg1 5s
5.4.10.3. ボリュームクローンの削除 リンクのコピーリンクがクリップボードにコピーされました!
ソースの永続ボリューム要求(PVC)を削除するときに LVM ストレージはクローンを自動的に削除しないため、ストレージリソースを解放するためにボリュームのクローンを削除する必要がなくなったらボリュームのクローンを削除します。
永続ボリューム要求 (PVC) を削除すると、LVM Storage はソース永続ボリューム要求のみを削除し、永続ボリューム要求のクローンは削除しません。
前提条件
-
cluster-adminパーミッションを持つユーザーとして OpenShift Container Platform にアクセスできる。
手順
-
OpenShift CLI (
oc) にログインします。 次のコマンドを実行して、クローン作成された PVC を削除します。
$ oc delete pvc <clone_pvc_name> -n <namespace>
検証
ボリュームクローンが削除されたことを確認するには、次のコマンドを実行します。
$ oc get pvc -n <namespace>削除されたボリュームクローンは、このコマンドの出力には存在しません。
5.4.11. LVM Storage の更新 リンクのコピーリンクがクリップボードにコピーされました!
クラスターのアップグレード後に OpenShift Container Platform バージョンとの互換性を確保するために LVM ストレージを更新できます。
LVM Storage Operator のデフォルトの namespace は openshift-lvm-storage です。
前提条件
- OpenShift Container Platform クラスターが更新されている。
- 以前のバージョンの LVM Storage がインストールされている。
-
OpenShift CLI (
oc) がインストールされている。 -
cluster-adminパーミッションを持つアカウントを使用してクラスターにアクセスできる。
手順
-
OpenShift CLI (
oc) にログインします。 次のコマンドを実行して、LVM Storage のインストール時に作成した
Subscriptionカスタムリソース (CR) を更新します。$ oc patch subscription lvms-operator -n openshift-lvm-storage --type merge --patch '{"spec":{"channel":"<update_channel>"}}'<update_channel>を、インストールする LVM Storage のバージョンに置き換えます。たとえば、stable-4.21です。次のコマンドを実行して、更新イベントを表示し、インストールが完了していることを確認します。
$ oc get events -n openshift-lvm-storage出力例
... 8m13s Normal RequirementsUnknown clusterserviceversion/lvms-operator.v4.21 requirements not yet checked 8m11s Normal RequirementsNotMet clusterserviceversion/lvms-operator.v4.21 one or more requirements couldn't be found 7m50s Normal AllRequirementsMet clusterserviceversion/lvms-operator.v4.21 all requirements found, attempting install 7m50s Normal InstallSucceeded clusterserviceversion/lvms-operator.v4.21 waiting for install components to report healthy 7m49s Normal InstallWaiting clusterserviceversion/lvms-operator.v4.21 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.21 install strategy completed with no errors ...
検証
次のコマンドを実行して、LVM Storage のバージョンを確認します。
$ oc get subscription lvms-operator -n openshift-lvm-storage -o jsonpath='{.status.installedCSV}'出力例
lvms-operator.v4.21
5.4.12. LVM Storage の監視 リンクのコピーリンクがクリップボードにコピーされました!
名前空間ラベルを使用してクラスター監視を有効にし、メトリクスを表示して、シンプールとボリュームグループの容量が重要なしきい値に達したときにアラートを受信し、データの損失を防ぎます。
クラスター監視を有効にするには、LVM ストレージをインストールした namespace にラベルを追加する必要があります。
RHACM でクラスターモニタリングを有効にする方法は、Observability およびカスタムメトリクスの追加を参照してください。
手順
- クラスター監視を有効にするには、LVM ストレージをインストールした namespace に次のラベルを追加します。
openshift.io/cluster-monitoring=true
5.4.13. メトリクスおよびアラートの概要 リンクのコピーリンクがクリップボードにコピーされました!
LVM ストレージメトリクスを使用してシンプールとボリュームグループの使用状況を監視し、ストレージ操作が失敗する前に修正を起こす前に、75%(ほぼ満杯)および 85%(クリティカル)の容量のしきい値でアラートを受信できます。
5.4.13.1. Metrics リンクのコピーリンクがクリップボードにコピーされました!
メトリクスを表示することで、LVM Storage を監視できます。
次の表は、topolvm メトリクスを説明しています。
| Alert | 説明 |
|---|---|
|
| LVM シンプールで使用されているデータ領域の割合を示します。 |
|
| LVM シンプールで使用されているメタデータ領域の割合を示します。 |
|
| LVM シンプールのサイズをバイト単位で示します。 |
|
| LVM ボリュームグループ内の利用可能な領域をバイト単位で示します。 |
|
| LVM ボリュームグループのサイズをバイト単位で示します。 |
|
| LVM シンプールの利用可能なオーバープロビジョニングサイズをバイト単位で示します。 |
メトリクスは 10 分ごとに、または変更 (シンプールに新しい論理ボリュームが作成されるなど) があったときに更新されます。
5.4.13.2. アラート リンクのコピーリンクがクリップボードにコピーされました!
シンプールとボリュームグループが最大ストレージ容量に達すると、それ以降の操作は失敗します。これにより、データ損失が発生する可能性があります。
LVM Storage は、シンプールとボリュームグループの使用量が特定の値を超えると、次のアラートを送信します。
| Alert | 説明 |
|---|---|
|
| このアラートは、ボリュームグループとシンプールの両方の使用量がノード上で 75% を超えるとトリガーされます。データの削除またはボリュームグループの拡張が必要です。 |
|
| このアラートは、ボリュームグループとシンプールの両方の使用量がノード上で 85% を超えるとトリガーされます。この場合、ボリュームグループは、かなりいっぱいになっています。データの削除またはボリュームグループの拡張が必要です。 |
|
| このアラートは、ボリュームグループ内のシンプールのデータ使用量がノード上で 75% を超えるとトリガーされます。データの削除またはシンプールの拡張が必要です。 |
|
| このアラートは、ボリュームグループ内のシンプールのデータ使用量がノード上で 85% を超えるとトリガーされます。データの削除またはシンプールの拡張が必要です。 |
|
| このアラートは、ボリュームグループ内のシンプールのメタデータ使用量がノード上で 75% を超えるとトリガーされます。データの削除またはシンプールの拡張が必要です。 |
|
| このアラートは、ボリュームグループ内のシンプールのメタデータ使用量がノード上で 85% を超えるとトリガーされます。データの削除またはシンプールの拡張が必要です。 |
5.4.14. CLI を使用した LVM Storage のインストール リンクのコピーリンクがクリップボードにコピーされました!
LVM ストレージは、不要になった場合や、プロビジョニングされたすべてのストレージリソースを削除した後に OpenShift CLI (oc)を使用して、別のストレージソリューションにアップグレードする前にアンインストールします。
前提条件
-
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出力例
currentCSV: lvms-operator.v4.15.3次のコマンドを実行してサブスクリプションを削除します。
$ oc delete subscription.operators.coreos.com lvms-operator -n <namespace>出力例
subscription.operators.coreos.com "lvms-operator" deleted次のコマンドを実行して、ターゲット namespace 内の LVM Storage Operator の CSV を削除します。
$ oc delete clusterserviceversion <currentCSV> -n <namespace><currentCSV>は、LVM Storage Operator のcurrentCSV値に置き換えます。出力例
clusterserviceversion.operators.coreos.com "lvms-operator.v4.15.3" deleted
検証
LVM Storage Operator がアンインストールされたことを確認するには、次のコマンドを実行します。
$ oc get csv -n <namespace>LVM Storage Operator が正常にアンインストールされた場合、このコマンドの出力には表示されません。
5.4.15. Web コンソールを使用した LVM Storage のアンインストール リンクのコピーリンクがクリップボードにコピーされました!
LVM ストレージは、不要になった場合や、プロビジョニングされたすべてのストレージリソースを削除した後に OpenShift Container Platform Web コンソールを使用して別のストレージソリューションにアップグレードする前にアンインストールします。
前提条件
-
cluster-adminパーミッションを持つユーザーとして OpenShift Container Platform にアクセスできる。 - LVM Storage によってプロビジョニングされた永続ボリューム要求 (PVC)、ボリュームスナップショット、およびボリュームクローンが削除されている。これらのリソースを使用しているアプリケーションも削除されている。
-
LVMClusterカスタムリソース (CR) が削除されている。
手順
- OpenShift Container Platform Web コンソールにログインします。
-
Ecosystem
Installed Operators をクリックします。 -
openshift-lvm-storagenamespace で LVM Storage をクリックします。 - Details タブをクリックします。
- Actions メニューから、Uninstall Operator を選択します。
- オプション: プロンプトが表示されたら、Delete all operand instances for this operator チェックボックスを選択して、LVM Storage のオペランドインスタンスを削除します。
- Uninstall をクリックします。
5.4.16. RHACM を使用してインストールされた LVM Storage のアンインストール リンクのコピーリンクがクリップボードにコピーされました!
不要になった場合や、別のストレージソリューションに切り替える前に、RHACM を使用してインストールした LVM ストレージをアンインストールするには、プロビジョニングされたすべてのストレージリソースを削除した後に、インストール用に作成した RHACM ポリシー カスタムリソース(CR)を削除します。
前提条件
-
cluster-admin権限を持つユーザーとして RHACM クラスターにアクセスできる。 - LVM Storage によってプロビジョニングされた永続ボリューム要求 (PVC)、ボリュームスナップショット、およびボリュームクローンが削除されている。これらのリソースを使用しているアプリケーションも削除されている。
-
RHACM を使用して作成した
LVMClusterCR を削除した。
手順
-
OpenShift CLI (
oc) にログインします。 次のコマンドを使用して、LVM Storage のインストールと設定用に作成した RHACM
PolicyCR を削除します。$ oc delete -f <policy> -n <namespace><policy>は、PolicyCR YAML ファイルの名前に置き換えます。LVM Storage をアンインストールするための設定を含む
PolicyCR YAML ファイルを作成します。LVM Storage をアンインストールするための
PolicyCR の例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-lvm-storage - complianceType: mustnothave objectDefinition: apiVersion: operators.coreos.com/v1 kind: OperatorGroup metadata: name: openshift-storage-operatorgroup namespace: openshift-lvm-storage spec: targetNamespaces: - openshift-lvm-storage - complianceType: mustnothave objectDefinition: apiVersion: operators.coreos.com/v1alpha1 kind: Subscription metadata: name: lvms-operator namespace: openshift-lvm-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次のコマンドを実行して
PolicyCR を作成します。$ oc create -f <policy> -ns <namespace>
5.4.17. must-gather を使用したログファイルおよび診断情報のダウンロード リンクのコピーリンクがクリップボードにコピーされました!
must-gather ツールを使用して、LVM ストレージが問題を自動的に解決できない場合にログファイルと診断情報を収集します。お客様または Red Hat サポートが収集したデータを確認して問題のトラブルシューティングを行うことができます。
手順
LVM Storage クラスターに接続されているクライアントから
must-gatherコマンドを実行します。$ oc adm must-gather --image=registry.redhat.io/lvms4/lvms-must-gather-rhel9:v4.21 --dest-dir=<directory_name>
5.4.18. 永続ストレージのトラブルシューティング リンクのコピーリンクがクリップボードにコピーされました!
永続ストレージの問題が、永続ボリューム要求(PVC)が保留中の状態、欠落しているコンポーネント、またはノードおよびディスク障害などで論理ボリュームマネージャー(LVM)ストレージで発生する場合は、ログを確認して影響を受けるリソースを回復することで、問題を診断および解決できます。
5.4.18.1. 保留状態でスタックしている PVC を調査する リンクのコピーリンクがクリップボードにコピーされました!
Pending 状態でスタックした Persistent Volume Claim (永続ボリューム要求、PVC)を調査し、リソース不足、ネットワークの問題、ストレージクラスが一致していないか、または永続ボリューム(PV)が利用できない原因であるかを判別します。
永続ボリューム要求 (PVC) は、次の理由により Pending 状態のままになることがあります。
- コンピューティングリソースが足りない
- ネットワークの問題
- ストレージクラスまたはノードセレクターが一致していない
- 利用可能な永続ボリューム (PV) がない
-
PV を持つノードが
Not Ready状態にある
前提条件
-
OpenShift CLI (
oc) がインストールされている。 -
cluster-admin権限を持つユーザーとして OpenShift CLI (oc) にログインしている。
手順
次のコマンドを実行して、PVC のリストを取得します。
$ oc get pvc出力例
NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS AGE lvms-test Pending lvms-vg1 11s次のコマンドを実行して、
Pending状態のままになっている PVC に関連するイベントを検査します。$ oc describe pvc <pvc_name><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
5.4.18.2. ストレージクラスがない状態からの回復 リンクのコピーリンクがクリップボードにコピーされました!
LVMCluster カスタムリソース(CR)が存在し、すべての論理ボリュームマネージャー(LVM)ストレージ Pod が実行されていることを確認し、設定の問題を特定するためにログを確認して、ストレージクラス not found エラーを解決します。
前提条件
-
OpenShift CLI (
oc) がインストールされている。 -
cluster-admin権限を持つユーザーとして OpenShift CLI (oc) にログインしている。
手順
以下のコマンドを実行して、
LVMClusterCR が存在することを確認します。$ oc get lvmcluster -n <namespace>出力例
NAME AGE my-lvmcluster 65m-
LVMClusterCR が存在しない場合は、LVMClusterCR を作成します。詳細は、「LVMCluster カスタムリソースを作成する方法」を参照してください。 Operator がインストールされている namespace で、次のコマンドを実行して、すべての LVM ストレージ Pod が
Running状態であることを確認します。$ oc get pods -n <namespace>出力例
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-managerPod が停止する場合は、LVM Storage が使用できるディスクが見つからないことが原因です。この問題のトラブルシューティングに必要な情報を取得するには、以下のコマンドを実行してvg-managerPod のログを確認します。$ oc logs -l app.kubernetes.io/component=vg-manager -n <namespace>
-
5.4.18.3. ノード障害からの回復 リンクのコピーリンクがクリップボードにコピーされました!
障害の発生したノードを特定すると、topolvm-node Pod の再起動回数を調べることで永続ボリューム要求(PVC)が保留状態のままになります。これは、調査が必要な基礎となるノードの問題を示します。
前提条件
-
OpenShift CLI (
oc) がインストールされている。 -
cluster-admin権限を持つユーザーとして OpenShift CLI (oc) にログインしている。
手順
次のコマンドを実行して、
topolvm-nodePod インスタンスの再起動回数を調べます。$ oc get pods -n <namespace>出力例
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
次のステップ
ノードの問題を解決した後も PVC が Pending 状態のままになっている場合は、強制クリーンアップを実行する必要があります。詳細は、「強制クリーンアップの実行」を参照してください。
5.4.18.4. ディスク障害からの回復 リンクのコピーリンクがクリップボードにコピーされました!
Persistent Volume Claim (永続ボリューム要求、PVC)イベントを確認して特定のエラーメッセージを特定し、ディスクおよびボリュームのプロビジョニングの失敗を診断して解決し、影響を受けるホストに接続して基礎となるディスクの問題を修正します。
ディスクおよびボリュームのプロビジョニングの問題が発生すると、Failed to provision volume with storage class <storage_class_name> などの一般的なエラーメッセージが表示されます。一般的なエラーメッセージの後には、特定のボリューム障害のエラーメッセージが続きます。
以下の表は、ボリューム障害のエラーメッセージを説明しています。
| エラーメッセージ | 説明 |
|---|---|
|
| ボリュームがすでに存在するかどうかを確認する際に問題が発生したことを示します。ボリューム検証の失敗は、ネットワーク接続の問題やその他の障害によって発生する可能性があります。 |
|
| 使用可能な永続ボリューム (PV) が PVC の要件と一致しない場合、ボリュームのバインドに失敗する可能性があります。 |
|
| このエラーは、ボリュームをノードにマウントしようとしたときに問題が発生したことを示します。ディスクに障害が発生した場合、Pod が PVC を使用しようとしたときにこのエラーが表示されることがあります。 |
|
| このエラーは、ノードからボリュームをアンマウントしようとしたときに問題が発生したことを示します。ディスクに障害が発生した場合、Pod が PVC を使用しようとしたときにこのエラーが表示されることがあります。 |
|
|
このエラーは、 |
前提条件
-
OpenShift CLI (
oc) がインストールされている。 -
cluster-admin権限を持つユーザーとして OpenShift CLI (oc) にログインしている。
手順
次のコマンドを実行して、PVC に関連付けられたイベントを検査します。
$ oc describe pvc <pvc_name><pvc_name>を PVC の名前に置き換えます。- 問題が発生しているホストへの直接接続を確立します。
- ディスクの問題を解決します。
次のステップ
ディスクの問題を解決した後もボリューム障害メッセージが続く場合や再発する場合は、強制クリーンアップを実行する必要があります。詳細は、「強制クリーンアップの実行」を参照してください。
5.4.18.5. 強制クリーンアップの実行 リンクのコピーリンクがクリップボードにコピーされました!
適切なストレージ機能を復元するために、ディスクまたはノード関連の問題が標準のトラブルシューティング後に継続するときに、すべての論理ボリュームマネージャー(LVM)ストレージカスタムリソース(CR)を削除することで、強制的なクリーンアップを実行します。
トラブルシューティング手順を完了した後もディスクまたはノード関連の問題が解決しない場合は、強制クリーンアップを実行する必要があります。強制的なクリーンアップは、永続的な問題に対応し、LVM ストレージが正しく機能していることを確認するために使用されます。
前提条件
-
OpenShift CLI (
oc) がインストールされている。 -
cluster-admin権限を持つユーザーとして OpenShift CLI (oc) にログインしている。 - LVM Storage を使用して作成されたすべての永続ボリューム要求 (PVC) が削除されている。
- LVM Storage を使用して作成された PVC を使用している Pod を停止している。
手順
次のコマンドを実行して、LVM Storage Operator をインストールした namespace に切り替えます。
$ oc project <namespace>次のコマンドを実行して、
LogicalVolumeカスタムリソースが存在するかどうかを確認します。$ oc get logicalvolumeLogicalVolumeCR が存在する場合は、以下のコマンドを実行して削除します。$ oc delete logicalvolume <name><name>をLogicalVolumeCR の名前に置き換えます。LogicalVolumeCR を削除した後、以下のコマンドを実行してファイナライザーを削除します。$ oc patch logicalvolume <name> -p '{"metadata":{"finalizers":[]}}' --type=merge<name>をLogicalVolumeCR の名前に置き換えます。
以下のコマンドを実行して、
LVMVolumeGroupCR が存在するか確認します。$ oc get lvmvolumegroupLVMVolumeGroupCR が存在する場合は、以下のコマンドを実行して削除します。$ oc delete lvmvolumegroup <name><name>をLVMVolumeGroupCR の名前に置き換えます。LVMVolumeGroupCR を削除した後、以下のコマンドを実行してファイナライザーを削除します。$ oc patch lvmvolumegroup <name> -p '{"metadata":{"finalizers":[]}}' --type=merge<name>をLVMVolumeGroupCR の名前に置き換えます。
以下のコマンドを実行して、
LVMVolumeGroupNodeStatusCR を削除します。$ oc delete lvmvolumegroupnodestatus --all次のコマンドを実行して、
LVMClusterCR を削除します。$ oc delete lvmcluster --allLVMClusterCR を削除した後、以下のコマンドを実行してファイナライザーを削除します。$ oc patch lvmcluster <name> -p '{"metadata":{"finalizers":[]}}' --type=merge<name>をLVMClusterCR の名前に置き換えます。