第4章 ClusterCSIDriver [operator.openshift.io/v1]
- 説明
- ClusterCSIDriver オブジェクトを使用すると、OpenShift にデフォルトでインストールされている CSI ドライバー Operator の管理と設定が可能になります。オブジェクトの名前は、それが動作する CSI ドライバーの名前である必要があります。許可される値のリストは、CSIDriverName タイプを参照してください。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
- タイプ
-
object
- 必須
-
spec
-
4.1. 仕様
プロパティー | タイプ | 説明 |
---|---|---|
|
| APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。 |
|
| kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できることがあります。これを更新することはできません。CamelCase を使用します。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。 |
| 標準オブジェクトのメタデータ。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。 | |
|
| spec は、ユーザーが設定可能な設定値を保持します。 |
|
| status クラスターから監視される値を保持します。それらはオーバーライドされない場合があります。 |
4.1.1. .spec
- 説明
- spec は、ユーザーが設定可能な設定値を保持します。
- 型
-
object
プロパティー | タイプ | 説明 |
---|---|---|
|
| driverConfig は、プラットフォーム固有のドライバー設定を指定するために使用できます。省略すると、指定なしとみなされ、プラットフォームによって適切なデフォルトが選択されます。これらのデフォルトは時間の経過とともに変更される可能性があります。 |
|
| logLevel は、コンポーネント全体のインテントベースのログです。きめ細かい制御はできませんが、Operator がオペランドに対して解釈する必要のある粗いロギングの選択を管理する簡単な方法です。有効な値は、"Normal"、"Debug"、"Trace"、"TraceAll" です。Defaults to "Normal". |
|
| managementState は、Operator がコンポーネントを管理する必要があるかどうか、およびその方法を示します |
| `` | observedConfig は、コントローラーがクラスター状態から監視したスパース設定を保持します。Operator のレベルへの入力であるため、仕様に存在します |
|
| operatorLogLevel は、Operator 自体のインテントベースのログです。きめ細かい制御はできませんが、Operator が自分で解釈しなければならない粗いロギングの選択を管理する簡単な方法です。有効な値は、"Normal"、"Debug"、"Trace"、"TraceAll" です。Defaults to "Normal". |
|
| StorageClassState は、CSI Operator がストレージクラスを作成および管理する必要があるかどうかを決定します。このフィールドの値が空または Managed の場合、CSI Operator はストレージクラスを継続的に調整し、必要に応じて作成します。このフィールドの値が Unmanaged の場合、CSI Operator は以前に作成されたストレージクラスを調整しません。このフィールド値が Removed の場合、CSI Operator は以前に作成したストレージクラスを削除します。省略すると、ユーザーによる指定なしとみなされ、プラットフォームによって適切なデフォルトが選択されます。デフォルトは、今後変更される可能性があります。現在のデフォルトの動作は Managed です。 |
| `` | unsupportedConfigOverrides は、Operator によって計算された最終設定をオーバーライドします。Red Hat はこのフィールドの使用をサポートしていません。このフィールドを誤って使用すると、予期しない動作が発生したり、他の設定オプションと競合したりする可能性があります。このフィールドを使用する前に、Red Hat サポートに問い合わせてください。このプロパティーを使用すると、クラスターのアップグレードがブロックされます。クラスターをアップグレードする前に、このプロパティーを削除する必要があります。 |
4.1.2. .spec.driverConfig
- 説明
- driverConfig は、プラットフォーム固有のドライバー設定を指定するために使用できます。省略すると、指定なしとみなされ、プラットフォームによって適切なデフォルトが選択されます。これらのデフォルトは時間の経過とともに変更される可能性があります。
- 型
-
object
- 必須
-
driverType
-
プロパティー | タイプ | 説明 |
---|---|---|
|
| aws は、AWS の CSI ドライバーを設定するために使用します。 |
|
| azure は、Azure の CSI ドライバーを設定するために使用します。 |
|
| driverType は、driverConfig が適用される CSI ドライバーのタイプを示します。有効な値は AWS、Azure、GCP、vSphere で、省略されます。不明な値は、コンシューマーによって NO-OP として扱われます。 |
|
| gcp は、GCP の CSI ドライバーを設定するために使用します。 |
|
| vsphere は、vsphere の CSI ドライバーを設定するために使用します。 |
4.1.3. .spec.driverConfig.aws
- 説明
- aws は、AWS の CSI ドライバーを設定するために使用します。
- 型
-
object
プロパティー | タイプ | 説明 |
---|---|---|
|
| kmsKeyARN は、AWS が使用するデフォルトの KMS キーではなく、ユーザー定義の KMS キーを使用してボリュームを暗号化するようにクラスターのデフォルトストレージクラスを設定します。値は、KMS キーの ARN または Alias ARN のいずれかです。 |
4.1.4. .spec.driverConfig.azure
- 説明
- azure は、Azure の CSI ドライバーを設定するために使用します。
- 型
-
object
プロパティー | タイプ | 説明 |
---|---|---|
|
| diskEncryptionSet は、プラットフォームによって管理されるデフォルトの鍵ではなく、顧客が管理する暗号化セットを使用してボリュームを暗号化するようにクラスターのデフォルトのストレージクラスを設定します。 |
4.1.5. .spec.driverConfig.azure.diskEncryptionSet
- 説明
- diskEncryptionSet は、プラットフォームによって管理されるデフォルトの鍵ではなく、顧客が管理する暗号化セットを使用してボリュームを暗号化するようにクラスターのデフォルトのストレージクラスを設定します。
- 型
-
object
- 必須
-
name
-
resourceGroup
-
subscriptionID
-
プロパティー | タイプ | 説明 |
---|---|---|
|
| name は、デフォルトのストレージクラスに設定されるディスク暗号化セットの名前です。値は、英数字、アンダースコア (_)、ハイフンのみで構成し、80 文字以下の長さにする必要があります。 |
|
| resourceGroup は、ディスク暗号化セットを含む Azure リソースグループを定義します。値は、英数字、アンダースコア (_)、括弧、ハイフン、ピリオドのみで構成する必要があります。末尾をピリオド以外の文字にして、90 文字以下の長さにする必要があります。 |
|
| 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.6. .spec.driverConfig.gcp
- 説明
- gcp は、GCP の CSI ドライバーを設定するために使用します。
- 型
-
object
プロパティー | タイプ | 説明 |
---|---|---|
|
| kmsKey は、GCP によって管理されるデフォルトの鍵ではなく、顧客が提供する暗号鍵を使用してボリュームを暗号化するようにクラスターのデフォルトのストレージクラスを設定します。 |
4.1.7. .spec.driverConfig.gcp.kmsKey
- 説明
- kmsKey は、GCP によって管理されるデフォルトの鍵ではなく、顧客が提供する暗号鍵を使用してボリュームを暗号化するようにクラスターのデフォルトのストレージクラスを設定します。
- 型
-
object
- 必須
-
keyRing
-
name
-
projectID
-
プロパティー | タイプ | 説明 |
---|---|---|
|
| keyRing は、KMS キーが属する KMS キーリングの名前です。値は、既存の KMS キーリングに対応し、英数字、ハイフン (-)、アンダースコア (_) のみで構成され、63 文字以下の長さである必要があります。 |
|
| location は、キーリングが存在する GCP の場所です。値は、既存の GCP の場所、つまり "global" と一致する必要があります。設定されていない場合、デフォルトで global になります。 |
|
| name は、ディスク暗号化に使用する顧客管理の暗号鍵の名前です。値は、既存の KMS キーに対応し、英数字、ハイフン (-)、アンダースコア (_) のみで構成され、63 文字以下の長さである必要があります。 |
|
| projectID は、KMS キーリングが存在するプロジェクトの ID です。6 - 30 文字の小文字、数字、またはハイフンにする必要があります。先頭は文字である必要があります。末尾にハイフンを使用しないでください。 |
4.1.8. .spec.driverConfig.vSphere
- 説明
- vsphere は、vsphere の CSI ドライバーを設定するために使用します。
- 型
-
object
プロパティー | タイプ | 説明 |
---|---|---|
|
| topologyCategories は、hostcluster や datacenter などの vcenter リソースへのタグ付けに使用されるタグカテゴリーを示します。クラスターのインフラストラクチャーオブジェクトにトポロジーがある場合、インフラストラクチャーオブジェクトで指定されている値が使用され、topologyCategories への変更が拒否されます。 |
4.1.9. .status
- 説明
- status クラスターから監視される値を保持します。それらはオーバーライドされない場合があります。
- 型
-
object
プロパティー | タイプ | 説明 |
---|---|---|
|
| conditions は、状態とそのステータスのリストです。 |
|
| OperatorCondition は、標準の状態フィールドです。 |
|
| generations は、項目を調整する必要があるタイミングや、対応が必要な変更が項目に対して行われたタイミングを判断するために使用します。 |
|
| GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。 |
|
| observedGeneration はあなたが扱った最後の世代の変更です |
|
| readyReplicas は、準備ができて目的の状態にあるレプリカの数を示します |
|
| バージョンは、この可用性が適用されるレベルです |
4.1.10. .status.conditions
- 説明
- conditions は、状態とそのステータスのリストです。
- 型
-
array
4.1.11. .status.conditions[]
- 説明
- OperatorCondition は、標準の状態フィールドです。
- 型
-
object
プロパティー | タイプ | 説明 |
---|---|---|
|
| |
|
| |
|
| |
|
| |
|
|
4.1.12. .status.generations
- 説明
- generations は、項目を調整する必要があるタイミングや、対応が必要な変更が項目に対して行われたタイミングを判断するために使用します。
- 型
-
array
4.1.13. .status.generations[]
- 説明
- GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。
- 型
-
object
プロパティー | タイプ | 説明 |
---|---|---|
|
| グループはあなたが追跡しているもののグループです |
|
| ハッシュは、シークレットや設定マップのようにコンテンツに依存する、生成されないリソース用に設定されたオプションのフィールドです。 |
|
| lastGeneration は、関連するワークロードコントローラーの最後の世代です。 |
|
| name は、追跡しているものの名前です |
|
| 名前空間は、追跡しているものがどこにあるかです |
|
| リソースは、追跡しているもののリソースタイプです |