第4章 ClusterCSIDriver [operator.openshift.io/v1]
- Description
- ClusterCSIDriver オブジェクトを使用すると、OpenShift にデフォルトでインストールされている CSI ドライバー Operator の管理と設定が可能になります。オブジェクトの名前は、それが動作する CSI ドライバーの名前である必要があります。許可される値のリストについては、CSIDriverName タイプを参照してください。互換性レベル 1: メジャーリリース内で最低 12 か月または 3 つのマイナーリリース (どちらか長い方) の間安定しています。
- タイプ
-
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
- Description
- spec 設定についてのユーザーが設定できる値を保持します。
- タイプ
-
object
プロパティー | タイプ | 説明 |
---|---|---|
|
| driverConfig を使用して、プラットフォーム固有のドライバー設定を指定できます。これを省略した場合、ユーザーには選択する意図がないことを意味し、プラットフォームが適切なデフォルトを選択します。これらのデフォルトは時間の経過とともに変更される可能性があります。 |
|
| logLevel は、コンポーネント全体のインテントベースのログです。きめ細かい制御はできませんが、Operator がオペランドに対して解釈する必要のある粗いロギングの選択を管理する簡単な方法です。有効な値は、Normal、Debug、Trace、TraceAll です。Defaults to "Normal". |
|
| managementState は、Operator がコンポーネントを管理する必要があるかどうか、およびその方法を示します |
| `` | observedConfig は、コントローラーがクラスター状態から監視したスパース設定を保持します。Operator のレベルへの入力であるため、仕様に存在します |
|
| operatorLogLevel は、オペレーター自体のインテントベースのログです。きめ細かい制御はできませんが、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
-
プロパティー | タイプ | Description |
---|---|---|
|
| AWS は AWS CSI ドライバーの設定に使用されます。 |
|
| Azure は Azure CSI ドライバーを設定するのに使用されます。 |
|
| driverType は、driverConfig が適用される CSI ドライバーのタイプを示します。有効な値は、AWS、Azure、GCP、IBMCloud、vSphere、省略されます。コンシューマーは不明な値を NO-OP として扱う必要があります。 |
|
| GCP は、GCP CSI ドライバーを設定するのに使用されます。 |
|
| ibmcloud は、IBM Cloud 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 文字(32 16 文字と 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
-
プロパティー | タイプ | 説明 |
---|---|---|
|
| キーリングは、KMS キーが属する KMS キー Ring の名前です。この値は既存の KMS キーリングに対応している必要があり、英数字、ハイフン(-)およびアンダースコア(_)のみで設定され、長さは最大 63 文字である必要があります。 |
|
| location は、キー Ring が存在する GCP の場所です。値は既存の GCP の場所またはグローバルと一致する必要があります。設定されていない場合は、デフォルトで global になります。 |
|
| マシンのディスク暗号化に使用されるお客様が管理する暗号化キーの名前。この値は既存の KMS キーに対応している必要があり、英数字、ハイフン(-)およびアンダースコア(_)のみで設定され、長さは最大 63 文字である必要があります。 |
|
| ProjectID は、KMS キー Ring が存在するプロジェクトの ID です。6 から 30 桁の小文字、数字、またはハイフンである必要があります。文字で始める必要があります。末尾のハイフンは禁止されています。 |
4.1.8. .spec.driverConfig.ibmcloud
- 説明
- ibmcloud は、IBM Cloud CSI ドライバーを設定するのに使用されます。
- 型
-
object
- 必須
-
encryptionKeyCRN
-
プロパティー | タイプ | 説明 |
---|---|---|
|
| encryptionKeyCRN は、デフォルトのストレージクラスのボリュームのディスク暗号化に使用する顧客管理のルートキーの IBM Cloud CRN です。 |
4.1.9. .spec.driverConfig.vSphere
- 説明
- vSphere は vsphere CSI ドライバーを設定するのに使用されます。
- 型
-
object
プロパティー | タイプ | 説明 |
---|---|---|
|
| topologyCategories は、hostcluster や datacenter などの vCenter リソースがタグ付けされているタグカテゴリーを示します。クラスター Infrastructure オブジェクトにトポロジーがある場合、Infrastructure オブジェクトで指定された値が使用され、topologyCategories への変更は拒否されます。 |
4.1.10. .status
- Description
- status クラスターから監視される値を保持します。それらはオーバーライドされない場合があります。
- タイプ
-
object
プロパティー | タイプ | 説明 |
---|---|---|
|
| 条件は、条件とそのステータスのリストです |
|
| OperatorCondition は、単なる標準の条件フィールドです。 |
|
| 世代は、アイテムを調整する必要がある場合、または反応が必要な方法で変更された場合を判別するために使用されます。 |
|
| GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。 |
|
| observedGeneration はあなたが扱った最後の世代の変更です |
|
| readyReplicas は、準備ができて目的の状態にあるレプリカの数を示します |
|
| バージョンは、この可用性が適用されるレベルです |
4.1.11. .status.conditions
- Description
- 条件は、条件とそのステータスのリストです
- タイプ
-
array
4.1.12. .status.conditions[]
- Description
- OperatorCondition は、単なる標準の条件フィールドです。
- タイプ
-
object
プロパティー | タイプ | 説明 |
---|---|---|
|
| |
|
| |
|
| |
|
| |
|
|
4.1.13. .status.generations
- Description
- 世代は、アイテムを調整する必要がある場合、または反応が必要な方法で変更された場合を判別するために使用されます。
- タイプ
-
array
4.1.14. .status.generations[]
- Description
- GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。
- タイプ
-
object
プロパティー | タイプ | 説明 |
---|---|---|
|
| グループはあなたが追跡しているもののグループです |
|
| ハッシュは、シークレットや設定マップのようにコンテンツに依存する、生成されないリソース用に設定されたオプションのフィールドです。 |
|
| lastGeneration は、関連するワークロードコントローラーの最後の世代です。 |
|
| name は、追跡しているものの名前です |
|
| 名前空間は、追跡しているものがどこにあるかです |
|
| リソースは、追跡しているもののリソースタイプです |