第4章 ClusterCSIDriver [operator.openshift.io/v1]


説明
ClusterCSIDriver オブジェクトを使用すると、OpenShift にデフォルトでインストールされている CSI ドライバー Operator の管理と設定が可能になります。オブジェクトの名前は、それが動作する CSI ドライバーの名前である必要があります。許可される値のリストは、CSIDriverName タイプを参照してください。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
object
必須
  • spec

4.1. 仕様

プロパティー説明

apiVersion

string

apiVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。

kind

string

kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できる場合があります。これは更新できません。CamelCase を使用します。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。

metadata

ObjectMeta

標準オブジェクトのメタデータ。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。

spec

object

spec は、ユーザーが設定可能な設定値を保持します。

status

object

status クラスターから監視される値を保持します。それらはオーバーライドされない場合があります。

4.1.1. .spec

説明
spec は、ユーザーが設定可能な設定値を保持します。
object
プロパティー説明

driverConfig

object

driverConfig は、プラットフォーム固有のドライバー設定を指定するために使用できます。省略すると、指定なしとみなされ、プラットフォームによって適切なデフォルトが選択されます。これらのデフォルトは時間の経過とともに変更される可能性があります。

logLevel

string

logLevel は、コンポーネント全体のインテントベースのログです。きめ細かい制御はできませんが、Operator がオペランドに対して解釈する必要のある粗いロギングの選択を管理する簡単な方法です。有効な値は、"Normal"、"Debug"、"Trace"、"TraceAll" です。Defaults to "Normal".

managementState

string

managementState は、Operator がコンポーネントを管理する必要があるかどうか、およびその方法を示します

observedConfig

``

observedConfig は、コントローラーがクラスター状態から監視したスパース設定を保持します。Operator のレベルへの入力であるため、仕様に存在します

operatorLogLevel

string

operatorLogLevel は、Operator 自体のインテントベースのログです。きめ細かい制御はできませんが、Operator が自分で解釈しなければならない粗いロギングの選択を管理する簡単な方法です。有効な値は、"Normal"、"Debug"、"Trace"、"TraceAll" です。Defaults to "Normal".

storageClassState

string

StorageClassState は、CSI Operator がストレージクラスを作成および管理する必要があるかどうかを決定します。このフィールドの値が空または Managed の場合、CSI Operator はストレージクラスを継続的に調整し、必要に応じて作成します。このフィールドの値が Unmanaged の場合、CSI Operator は以前に作成されたストレージクラスを調整しません。このフィールド値が Removed の場合、CSI Operator は以前に作成したストレージクラスを削除します。省略すると、ユーザーによる指定なしとみなされ、プラットフォームによって適切なデフォルトが選択されます。デフォルトは、今後変更される可能性があります。現在のデフォルトの動作は Managed です。

unsupportedConfigOverrides

``

unsupportedConfigOverrides は、Operator によって計算された最終設定をオーバーライドします。Red Hat はこのフィールドの使用をサポートしていません。このフィールドを誤って使用すると、予期しない動作が発生したり、他の設定オプションと競合したりする可能性があります。このフィールドを使用する前に、Red Hat サポートに問い合わせてください。このプロパティーを使用すると、クラスターのアップグレードがブロックされます。クラスターをアップグレードする前に、このプロパティーを削除する必要があります。

4.1.2. .spec.driverConfig

説明
driverConfig は、プラットフォーム固有のドライバー設定を指定するために使用できます。省略すると、指定なしとみなされ、プラットフォームによって適切なデフォルトが選択されます。これらのデフォルトは時間の経過とともに変更される可能性があります。
object
必須
  • driverType
プロパティー説明

aws

object

aws は、AWS の CSI ドライバーを設定するために使用します。

azure

object

azure は、Azure の CSI ドライバーを設定するために使用します。

driverType

string

driverType は、driverConfig が適用される CSI ドライバーのタイプを示します。有効な値は、AWS、Azure、GCP、IBMCloud、vSphere です (省略可能)。不明な値は、コンシューマーによって NO-OP として扱われます。

gcp

object

gcp は、GCP の CSI ドライバーを設定するために使用します。

ibmcloud

object

ibmcloud は、IBM の Cloud CSI ドライバーを設定するために使用します。

vSphere

object

vsphere は、vsphere の CSI ドライバーを設定するために使用します。

4.1.3. .spec.driverConfig.aws

説明
aws は、AWS の CSI ドライバーを設定するために使用します。
object
プロパティー説明

efsVolumeMetrics

object

efsVolumeMetrics は、EFS CSI Driver によって使用される、EFS ボリュームからメトリクスを収集するための設定を指定します。

kmsKeyARN

string

kmsKeyARN は、AWS が使用するデフォルトの KMS キーではなく、ユーザー定義の KMS キーを使用してボリュームを暗号化するようにクラスターのデフォルトストレージクラスを設定します。値は、KMS キーの ARN または Alias ARN のいずれかです。

4.1.4. .spec.driverConfig.aws.efsVolumeMetrics

説明
efsVolumeMetrics は、EFS CSI Driver によって使用される、EFS ボリュームからメトリクスを収集するための設定を指定します。
object
必須
  • state
プロパティー説明

recursiveWalk

object

recursiveWalk は、state が RecursiveWalk に設定されている場合に、AWS EFS CSI Driver でのボリュームメトリクス収集に関する追加設定を提供します。

state

string

state は、AWS EFS CSI Driver のメトリクス収集の状態を定義します。このフィールドは必須であり、Disabled または RecursiveWalk のいずれかの値に設定する必要があります。Disabled にすると、メトリクス収集は実行されません。これはデフォルト値です。RecursiveWalk にすると、AWS EFS CSI Driver がボリュームを再帰的にスキャンしてメトリクスを収集します。このプロセスにより、ボリュームサイズに応じて CPU とメモリーの使用率が高くなる可能性があります。

4.1.5. .spec.driverConfig.aws.efsVolumeMetrics.recursiveWalk

説明
recursiveWalk は、state が RecursiveWalk に設定されている場合に、AWS EFS CSI Driver でのボリュームメトリクス収集に関する追加設定を提供します。
object
プロパティー説明

fsRateLimit

integer

fsRateLimit は、ボリュームメトリクスを処理する際のレート制限を、ファイルシステムごとの goroutine で定義します。省略すると、指定なしとみなされ、プラットフォームによって適切なデフォルトが選択されます。デフォルトは、今後変更される可能性があります。現在のデフォルトは 5 です。有効な範囲は 1 - 100 goroutine です。

refreshPeriodMinutes

integer

refreshPeriodMinutes は、ボリュームメトリクスの更新頻度 (分単位) を指定します。省略すると、指定なしとみなされ、プラットフォームによって適切なデフォルトが選択されます。デフォルトは、今後変更される可能性があります。現在のデフォルトは 240 です。有効な範囲は 1 - 43200 分 (30 日) です。

4.1.6. .spec.driverConfig.azure

説明
azure は、Azure の CSI ドライバーを設定するために使用します。
object
プロパティー説明

diskEncryptionSet

object

diskEncryptionSet は、プラットフォームによって管理されるデフォルトの鍵ではなく、顧客が管理する暗号化セットを使用してボリュームを暗号化するようにクラスターのデフォルトのストレージクラスを設定します。

4.1.7. .spec.driverConfig.azure.diskEncryptionSet

説明
diskEncryptionSet は、プラットフォームによって管理されるデフォルトの鍵ではなく、顧客が管理する暗号化セットを使用してボリュームを暗号化するようにクラスターのデフォルトのストレージクラスを設定します。
object
必須
  • name
  • resourceGroup
  • subscriptionID
プロパティー説明

name

string

name は、デフォルトのストレージクラスに設定されるディスク暗号化セットの名前です。値は、英数字、アンダースコア (_)、ハイフンのみで構成し、80 文字以下の長さにする必要があります。

resourceGroup

string

resourceGroup は、ディスク暗号化セットを含む Azure リソースグループを定義します。値は、英数字、アンダースコア (_)、括弧、ハイフン、ピリオドのみで構成する必要があります。末尾をピリオド以外の文字にして、90 文字以下の長さにする必要があります。

subscriptionID

string

subscriptionID は、ディスク暗号化セットを含む Azure サブスクリプションを定義します。値は次の条件を満たす必要があります。1.128 ビットの数値である必要があります。2. 36 文字 (16 進数の 32 文字とハイフン 4 文字) の長さにする必要があります。3. ハイフン (-) で区切られた 5 つのグループで表す必要があります。4. 最初のグループは 8 文字の長さにする必要があります。5. 2 番目、3 番目、4 番目のグループは 4 文字の長さにする必要があります。6. 5 番目のグループは 12 文字の長さにする必要があります。SubscrionID の例: f2007bbf-f802-4a47-9336-cf7c6b89b378

4.1.8. .spec.driverConfig.gcp

説明
gcp は、GCP の CSI ドライバーを設定するために使用します。
object
プロパティー説明

kmsKey

object

kmsKey は、GCP によって管理されるデフォルトの鍵ではなく、顧客が提供する暗号鍵を使用してボリュームを暗号化するようにクラスターのデフォルトのストレージクラスを設定します。

4.1.9. .spec.driverConfig.gcp.kmsKey

説明
kmsKey は、GCP によって管理されるデフォルトの鍵ではなく、顧客が提供する暗号鍵を使用してボリュームを暗号化するようにクラスターのデフォルトのストレージクラスを設定します。
object
必須
  • keyRing
  • name
  • projectID
プロパティー説明

keyRing

string

keyRing は、KMS キーが属する KMS キーリングの名前です。値は、既存の KMS キーリングに対応し、英数字、ハイフン (-)、アンダースコア (_) のみで構成され、63 文字以下の長さである必要があります。

location

string

location は、キーリングが存在する GCP の場所です。値は、既存の GCP の場所、つまり "global" と一致する必要があります。設定されていない場合、デフォルトで global になります。

name

string

name は、ディスク暗号化に使用する顧客管理の暗号鍵の名前です。値は、既存の KMS キーに対応し、英数字、ハイフン (-)、アンダースコア (_) のみで構成され、63 文字以下の長さである必要があります。

projectID

string

projectID は、KMS キーリングが存在するプロジェクトの ID です。6 - 30 文字の小文字、数字、またはハイフンにする必要があります。先頭は文字である必要があります。末尾にハイフンを使用しないでください。

4.1.10. .spec.driverConfig.ibmcloud

説明
ibmcloud は、IBM の Cloud CSI ドライバーを設定するために使用します。
object
必須
  • encryptionKeyCRN
プロパティー説明

encryptionKeyCRN

string

encryptionKeyCRN は、デフォルトストレージクラスのボリュームのディスク暗号化に使用する顧客管理のルートキーの IBM Cloud CRN です。

4.1.11. .spec.driverConfig.vSphere

説明
vsphere は、vsphere の CSI ドライバーを設定するために使用します。
object
プロパティー説明

globalMaxSnapshotsPerBlockVolume

integer

globalMaxSnapshotsPerBlockVolume は、あらゆる種類のデータストアのボリュームに適用されるグローバル設定パラメーターです。省略すると、プラットフォームによってデフォルトが選択されます。デフォルトは、今後変更される可能性があります。現在のデフォルトは 3 です。このパラメーターを使用してスナップショットを無効にすることはできません。スナップショットの数を 3 以上に増やすと、パフォーマンスに悪影響が生じる可能性があります。詳細は、https://kb.vmware.com/s/article/1025279 を参照してください。ボリュームスナップショットに関するドキュメント: https://docs.vmware.com/en/VMware-vSphere-Container-Storage-Plug-in/3.0/vmware-vsphere-csp-getting-started/GUID-E0B41C69-7EEB-450F-A73D-5FD2FF39E891.html

granularMaxSnapshotsPerBlockVolumeInVSAN

integer

granularMaxSnapshotsPerBlockVolumeInVSAN は、vSAN データストア専用の詳細な設定パラメーターです。設定されている場合、GlobalMaxSnapshotsPerBlockVolume がオーバーライドされます。設定されていない場合、グローバル制約にフォールバックします。このパラメーターを使用して VSAN のスナップショットを無効にすることはできません。

granularMaxSnapshotsPerBlockVolumeInVVOL

integer

granularMaxSnapshotsPerBlockVolumeInVVOL は、Virtual Volumes データストア専用の詳細な設定パラメーターです。設定されている場合、GlobalMaxSnapshotsPerBlockVolume がオーバーライドされます。設定されていない場合、グローバル制約にフォールバックします。このパラメーターを使用して VVOL のスナップショットを無効にすることはできません。

topologyCategories

array (string)

topologyCategories は、hostcluster や datacenter などの vcenter リソースへのタグ付けに使用されるタグカテゴリーを示します。クラスターのインフラストラクチャーオブジェクトにトポロジーがある場合、インフラストラクチャーオブジェクトで指定されている値が使用され、topologyCategories への変更が拒否されます。

4.1.12. .status

説明
status クラスターから監視される値を保持します。それらはオーバーライドされない場合があります。
object
プロパティー説明

conditions

array

conditions は、状態とそのステータスのリストです。

conditions[]

object

OperatorCondition は、標準の状態フィールドです。

generations

array

generations は、項目を調整する必要があるタイミングや、対応が必要な変更が項目に対して行われたタイミングを判断するために使用します。

generations[]

object

GenerationStatus は、強制更新に関する決定を行えるように、特定のリソースの生成を追跡します。

observedGeneration

integer

observedGeneration はあなたが扱った最後の世代の変更です

readyReplicas

integer

readyReplicas は、準備ができて目的の状態にあるレプリカの数を示します

version

string

バージョンは、この可用性が適用されるレベルです

4.1.13. .status.conditions

説明
conditions は、状態とそのステータスのリストです。
array

4.1.14. .status.conditions[]

説明
OperatorCondition は、標準の状態フィールドです。
object
必須
  • type
プロパティー説明

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

4.1.15. .status.generations

説明
generations は、項目を調整する必要があるタイミングや、対応が必要な変更が項目に対して行われたタイミングを判断するために使用します。
array

4.1.16. .status.generations[]

説明
GenerationStatus は、強制更新に関する決定を行えるように、特定のリソースの生成を追跡します。
object
プロパティー説明

group

string

group は追跡対象のグループです。

hash

string

hash は、シークレットや configmap など、機密性の高いコンテンツを含む生成されないリソースに設定される任意のフィールドです。

lastGeneration

integer

lastGeneration は関連するワークロードコントローラーの最後の生成です。

name

string

name は追跡対象の名前です。

namespace

string

namespace は追跡対象の場所です。

resource

string

resource は追跡対象のリソースタイプです。

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

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

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat, Inc.