5.4.2. LVMCluster カスタムリソースについて

spec.storage.deviceClasses

array

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

LVM Storage は、ユーザーが作成する各デバイスクラスに対してストレージクラスとボリュームスナップショットクラスを作成します。

deviceClasses.name

string

LVM ボリュームグループ (VG) の名前を指定します。

以前のインストールで作成したボリュームグループを再利用するようにこのフィールドを設定することもできます。詳細は、「以前の LVM ストレージインストールからのボリュームグループの再利用」を参照してください。

deviceClasses.fstype

string

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

deviceClasses.default

boolean

デバイスクラスがデフォルトであることを指定するには、このフィールドを true に設定します。それ以外の場合は、false に設定できます。設定できるデフォルトのデバイスクラスは 1 つだけです。

deviceClasses.nodeSelector

object

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

コントロールプレーンノードでは、クラスター内で新しいノードがアクティブになると、LVM Storage が追加のワーカーノードを検出して使用します。

nodeSelector.nodeSelectorTerms

array

ノードの選択に使用する要件を設定します。

deviceClasses.deviceSelector

object

次の操作を実行するための設定を含めます。

詳細は、「ボリュームグループへのデバイスの追加について」を参照してください。

deviceSelector.paths

array

デバイスパスを指定します。

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

deviceSelector.optionalPaths

array

オプションのデバイスパスを指定します。

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

deviceSelector. forceWipeDevicesAndDestroyAllData

boolean

LVM Storage は、ファイルシステム署名が含まれていない空のディスクのみを使用します。確実にディスクが空で、ファイルシステム署名が含まれていないようにするには、使用する前にディスクを消去します。

選択したデバイスを強制的にワイプするには、このフィールドを true に設定します。デフォルトでは、このフィールドは false に設定されています。

次の条件のいずれかが満たされている場合にデバイスをワイプすると、データの整合性が失われる可能性があります。

これらの条件のいずれかに該当する場合は、ディスクを強制的にワイプしないでください。代わりに、ディスクを手動でワイプする必要があります。

deviceClasses.thinPoolConfig

object

LVM ボリュームグループにシンプールを作成するための設定を含めます。

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

シックプロビジョニングされたストレージを使用する場合、次の制限があります。

thinPoolConfig.name

string

シンプールの名前を指定します。

thinPoolConfig.sizePercent

integer

シンプールを作成するための LVM ボリュームグループ内の領域の割合を指定します。

デフォルトでは、このフィールドは 90 に設定されています。設定できる最小値は 10、最大値は 90 です。

thinPoolConfig.overprovisionRatio

integer

シンプールで使用可能なストレージに基づいて追加のストレージをプロビジョニングするのに使用する係数を指定します。

たとえば、このフィールドが 10 に設定されている場合、シンプールで使用可能なストレージの量の最大 10 倍をプロビジョニングできます。このフィールドは、LVM クラスターが作成された後に変更できます。

パラメーターを更新するには、次のいずれかのタスクを実行します。

$ oc edit lvmcluster <lvmcluster_name>

$ oc patch lvmcluster <lvmcluster_name> -p <patch_file.yaml>

オーバープロビジョニングを無効にするには、このフィールドを 1 に設定します。

thinPoolConfig.chunkSize

integer

静的に計算されたチャンクサイズをシンプールに指定します。このフィールドは、ChunkSizeCalculationPolicy フィールドが Static に設定されている場合にのみ使用されます。lvm2 の根本的な制限のため、このフィールドの値は 64 KiB - 1 GiB の範囲で設定する必要があります。

このフィールドを設定せず、ChunkSizeCalculationPolicy フィールドが Static に設定されている場合、デフォルトのチャンクサイズとして 128 KiB が設定されます。

詳細は、「チャンクサイズの概要」を参照してください。

thinPoolConfig.chunkSizeCalculationPolicy

string

基盤となるボリュームグループのチャンクサイズを計算するポリシーを指定します。このフィールドは、Static または Host のいずれかに設定できます。デフォルトでは、このフィールドは Static に設定されています。

このフィールドが Static に設定されている場合、チャンクサイズが chunkSize フィールドの値に設定されます。chunkSize フィールドが設定されていない場合、チャンクサイズは 128 KiB に設定されます。

このフィールドが Host に設定されている場合、チャンクサイズは lvm.conf ファイルの設定に基づいて計算されます。

詳細は、「LVM ストレージで使用するデバイスのサイズを設定する際の制限事項」を参照してください。

thinPoolConfig.metadataSize

integer

シンプールのメタデータサイズを指定します。MetadataSizeCalculationPolicy フィールドが Static に設定されている場合にのみ、このフィールドを設定できます。

このフィールドが設定されておらず、MetadataSizeCalculationPolicy フィールドが Static に設定されている場合は、デフォルトのメタデータサイズが 1 GiB に設定されます。

lvm2 の根本的な制限により、このフィールドの値は 2 MiB - 16 GiB の範囲で設定する必要があります。このフィールドの値は更新時にのみ増やすことができます。

thinPoolConfig.metadataSizeCalculationPolicy

string

基になるボリュームグループのメタデータサイズを計算するポリシーを指定します。このフィールドは、Static または Host のいずれかに設定できます。デフォルトでは、このフィールドは Host に設定されています。

このフィールドが Static に設定されている場合は、メタデータサイズが thinPoolConfig.metadataSize フィールドの値に基づいて計算されます。

このフィールドが Host に設定されている場合は、メタデータのサイズが lvm2 設定に基づいて計算されます。