Operator API


OpenShift Container Platform 4.16

Operator API のリファレンスガイド

Red Hat OpenShift Documentation Team

概要

このドキュメントでは、OpenShift Container Platform の Operator API のオブジェクトとその詳細な仕様を説明します。

第1章 Operator API

1.1. Authentication [operator.openshift.io/v1]

説明
認証は、認証を管理するように Operator を設定するための情報を提供します。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object

1.2. CloudCredential [operator.openshift.io/v1]

説明
CloudCredential は、CredentialsRequests を管理するように Operator を設定する手段を提供します。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object

1.3. ClusterCSIDriver [operator.openshift.io/v1]

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

1.4. Console [operator.openshift.io/v1]

説明
コンソールは、コンソールを管理するように Operator を設定する手段を提供します。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object

1.5. Config [operator.openshift.io/v1]

説明
Config は、クラスター上に他のコンポーネントの初期設定を作成する役割を担う config Operator の動作を指定します。この Operator は、AWS および Azure クラウドをベースとしたクラスターのクラウド設定のインストール、移行、または同期も処理します。互換性レベル 1: メジャーリリース内で最低 12 カ月間、または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
object

1.6. Config [imageregistry.operator.openshift.io/v1]

説明
Config は、レジストリー Operator によって管理されるレジストリーインスタンスの設定オブジェクトです。互換性レベル 1: メジャーリリース内で最低 12 カ月間、または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
object

1.7. Config [samples.operator.openshift.io/v1]

説明
Config には、Samples Operator の設定と詳細な条件ステータスが含まれています。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object

1.8. CSISnapshotController [operator.openshift.io/v1]

説明
CSISnapshotController は、CSI スナップショットを管理するように Operator を設定する手段を提供します。cluster は正規名です。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object

1.9. DNS [operator.openshift.io/v1]

説明
DNS は CoreDNS コンポーネントを管理し、クラスター内の Pod およびサービスの名前解決サービスを提供します。これは、DNS ベースのサービス検出仕様 (https://github.com/kubernetes/dns/blob/master/docs/specification.md) をサポートしています。詳細: https://kubernetes.io/docs/tasks/administer-cluster/coredns 互換性レベル 1: メジャーリリース内で最低 12 カ月間、または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
object

1.10. DNSRecord [ingress.operator.openshift.io/v1]

説明
DNSRecord は、dns.config.openshift.io/cluster.spec.publicZone および.spec.privateZone によって定義されたゾーンで管理される DNS レコードです。このリソースのクラスター管理操作はサポートされていません。このリソースは、OpenShift Operator の内部通信専用です。DNSManagementPolicy が "Unmanaged" の場合、Operator はクラウドプロバイダー上の DNS レコードの管理を担当しません。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object

1.11. Etcd [operator.openshift.io/v1]

説明
Etcd は、etcd を管理するように Operator を設定するための情報を提供します。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object

1.12. ImageContentSourcePolicy [operator.openshift.io/v1alpha1]

説明
ImageContentSourcePolicy は、レジストリーミラールールの処理方法に関するクラスター全体の情報を保持します。複数のポリシーが定義されている場合、動作の結果は各フィールドで定義されます。互換性レベル 4: 互換性は提供されていません。API は、理由を問わずいつでも変更できます。これらの機能は、長期サポートを必要とするアプリケーションで使用することはできません。
object

1.13. ImagePruner [imageregistry.operator.openshift.io/v1]

説明
ImagePruner は、レジストリー Operator によって管理されるイメージレジストリープルーナーの設定オブジェクトです。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object

1.14. IngressController [operator.openshift.io/v1]

説明
IngressController は、クラスターの管理された入力コントローラーを説明します。コントローラーは、OpenShift Route および Kubernetes Ingress リソースにサービスを提供できます。IngressController が作成されると、新しい ingres コントローラーの配置が作成され、外部トラフィックが Ingress または Route リソースを公開するサービスに到達できるようになります。このリソースを更新すると、新しい ingres コントローラーのリビジョンが公開される可能性があるため、一般向けのネットワーク接続が中断される可能性があります。https://kubernetes.io/docs/concepts/services-networking/ingress-controllers 可能な限り、プラットフォームの適切なデフォルトが使用されます。詳細は、各フィールドを参照してください。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object

1.15. InsightsOperator [operator.openshift.io/v1]

説明
InsightsOperator は、Insights Operator に関するクラスター全体の情報を保持します。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object

1.16. KubeAPIServer [operator.openshift.io/v1]

説明
KubeAPIServer は、kube-apiserver を管理するための Operator を設定するための情報を提供します。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object

1.17. KubeControllerManager [operator.openshift.io/v1]

説明
KubeControllerManager は、kube-controller-manager を管理するように Operator を設定するための情報を提供します。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object

1.18. KubeScheduler [operator.openshift.io/v1]

説明
KubeScheduler は、スケジューラーを管理する Operator を設定するための情報を提供します。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object

1.19. KubeStorageVersionMigrator [operator.openshift.io/v1]

説明
KubeStorageVersionMigrator は、kube-storage-version-migrator を管理するように Operator を設定するための情報を提供します。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object

1.20. MachineConfiguration [operator.openshift.io/v1]

説明
MachineConfiguration は、マシン設定を管理する Operator を設定するための情報を提供します。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object

1.21. Network [operator.openshift.io/v1]

説明
ネットワークは、クラスターの目的のネットワーク設定を表します。これは、cluster-network-operator によって消費されます。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object

1.22. OpenShiftAPIServer [operator.openshift.io/v1]

説明
OpenShiftAPIServer は、openshift-apiserver を管理するための Operator を設定するための情報を提供します。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object

1.23. OpenShiftControllerManager [operator.openshift.io/v1]

説明
OpenShiftControllerManager は、openshift-controller-manager を管理するように Operator を設定するための情報を提供します。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object

1.24. OperatorPKI [network.operator.openshift.io/v1]

説明

OperatorPKI は、単純な認証局です。これは外部での使用を目的としたものではなく、ネットワーク Operator の内部で使用されます。CNO は、CA とその CA によって署名された証明書を作成します。証明書では、ClientAuth と ServerAuth の両方の拡張使用が有効になっています。

More specifically, given an OperatorPKI with <name>, the CNO will manage:
  • 次の 2 つのデータキーを持つ <name>-ca という名前の Secret:
  • tls.key - 秘密鍵
  • tls.crt - CA 証明書
  • 次の 1 つのデータキーを持つ <name>-ca という名前の ConfigMap:
  • cabundle.crt - CA 証明書
  • 次の 2 つのデータキーを持つ <name>-cert という名前の Secret:
  • tls.key - 秘密鍵
  • tls.crt - CA によって署名された証明書

CA 証明書の有効期間は 10 年で、9 年後にローテーションされます。ターゲット証明書の有効期間は 6 カ月で、3 カ月後にローテーションされます。

CA 証明書の CommonName は、"<namespace>_<name>-ca@<timestamp>" になります。<timestamp> は最後のローテーション時間です。

object

1.25. ServiceCA [operator.openshift.io/v1]

説明
ServiceCA は、サービス証明書コントローラーを管理するように Operator を設定するための情報を提供します。互換性レベル 1: メジャーリリース内で最低 12 か月または 3 つのマイナーリリース (いずれか長い方) の間安定しています。
object

1.26. Storage [operator.openshift.io/v1]

説明
ストレージは、クラスターストレージ Operator を管理するように Operator を設定する手段を提供します。cluster は正規名です。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object

第2章 Authentication [operator.openshift.io/v1]

説明
認証は、認証を管理するように Operator を設定するための情報を提供します。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object
必須
  • spec

2.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

 

status

object

 

2.1.1. .spec

説明
タイプ
object
プロパティータイプ説明

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".

unsupportedConfigOverrides

``

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

2.1.2. .status

説明
タイプ
object
プロパティータイプ説明

conditions

array

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

conditions[]

object

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

generations

array

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

generations[]

object

GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。

oauthAPIServer

object

OAuthAPIServer は、oauth-apiserver にのみ固有のステータスを保持します

observedGeneration

integer

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

readyReplicas

integer

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

version

string

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

2.1.3. .status.conditions

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

2.1.4. .status.conditions[]

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

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

2.1.5. .status.generations

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

2.1.6. .status.generations[]

説明
GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。
object
プロパティータイプ説明

group

string

グループはあなたが追跡しているもののグループです

ハッシュ

string

ハッシュは、シークレットや設定マップのようにコンテンツに依存する、生成されないリソース用に設定されたオプションのフィールドです。

lastGeneration

integer

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

name

string

name は、追跡しているものの名前です

namespace

string

名前空間は、追跡しているものがどこにあるかです

resource

string

リソースは、追跡しているもののリソースタイプです

2.1.7. .status.oauthAPIServer

説明
OAuthAPIServer は、oauth-apiserver にのみ固有のステータスを保持します
object
プロパティータイプ説明

latestAvailableRevision

integer

LatestAvailableRevision は、encryption-config などの改訂されたシークレットの接尾辞として使用される最新の改訂です。新しいリビジョンにより、Pod が新たにデプロイされます。

2.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/operator.openshift.io/v1/authentications

    • DELETE: 認証のコレクションを削除します
    • GET: 種類が Authentication のオブジェクトをリスト表示します。
    • POST: 認証を作成します
  • /apis/operator.openshift.io/v1/authentications/{name}

    • 削除: 認証を削除します
    • GET: 指定された認証を読み取ります
    • PATCH: 指定された認証を部分的に更新します
    • PUT: 指定された認証を置き換えます
  • /apis/operator.openshift.io/v1/authentications/{name}/status

    • GET: 指定された認証のステータスを読み取ります
    • PATCH: 指定された認証のステータスを部分的に更新します
    • PUT: 指定された認証のステータスを置き換えます

2.2.1. /apis/operator.openshift.io/v1/authentications

HTTP メソッド
DELETE
説明
認証のコレクションを削除する
表2.1 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類が Authentication のオブジェクトをリスト表示します。
表2.2 HTTP 応答
HTTP コード応答本文

200 - OK

AuthenticationList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
認証の作成
表2.3 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表2.4 本文パラメーター
パラメータータイプ説明

body

Authentication スキーマ

 
表2.5 HTTP 応答
HTTP コード応答本文

200 - OK

Authentication スキーマ

201 - Created

Authentication スキーマ

202 - Accepted

Authentication スキーマ

401 - Unauthorized

空白

2.2.2. /apis/operator.openshift.io/v1/authentications/{name}

表2.6 グローバルパスパラメーター
パラメータータイプ説明

name

string

認証の名前

HTTP メソッド
DELETE
説明
認証の削除
表2.7 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表2.8 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定された認証を読み取る
表2.9 HTTP 応答
HTTP コード応答本文

200 - OK

Authentication スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された認証を部分的に更新します
表2.10 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表2.11 HTTP 応答
HTTP コード応答本文

200 - OK

Authentication スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された認証を置き換えます
表2.12 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表2.13 本文パラメーター
パラメータータイプ説明

body

Authentication スキーマ

 
表2.14 HTTP 応答
HTTP コード応答本文

200 - OK

Authentication スキーマ

201 - Created

Authentication スキーマ

401 - Unauthorized

空白

2.2.3. /apis/operator.openshift.io/v1/authentications/{name}/status

表2.15 グローバルパスパラメーター
パラメータータイプ説明

name

string

認証の名前

HTTP メソッド
GET
説明
指定された認証のステータスを読み取ります
表2.16 HTTP 応答
HTTP コード応答本文

200 - OK

Authentication スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された認証のステータスを部分的に更新します
表2.17 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表2.18 HTTP 応答
HTTP コード応答本文

200 - OK

Authentication スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された認証のステータスを置き換えます
表2.19 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表2.20 本文パラメーター
パラメータータイプ説明

body

Authentication スキーマ

 
表2.21 HTTP 応答
HTTP コード応答本文

200 - OK

Authentication スキーマ

201 - Created

Authentication スキーマ

401 - Unauthorized

空白

第3章 CloudCredential [operator.openshift.io/v1]

説明
CloudCredential は、CredentialsRequests を管理するように Operator を設定する手段を提供します。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object
必須
  • spec

3.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

CloudCredentialSpec は、cloud-credential-operator の望ましい動作の仕様です。

status

object

CloudCredentialStatus は、cloud-credential-operator の監視ステータスを定義します。

3.1.1. .spec

説明
CloudCredentialSpec は、cloud-credential-operator の望ましい動作の仕様です。
object
プロパティータイプ説明

credentialsMode

string

CredentialsMode を使用すると、ルートクラウドのクレデンシャル機能を動的に決定しようとしてはならず、指定されたモードで実行する必要があることを CCO に通知できます。また、必要に応じて、Operator を "手動" モードにすることもできます。フィールドをデフォルトモードのままにすると、CCO が実行され、クラスターのクラウドクレデンシャルが (サポートされているクラウド/プラットフォームで) 機能について動的にプローブされます。サポートされているモード: AWS/Azure/GCP の場合は、"" (デフォルト)、"Mint"、"Passthrough"、"Manual" です。その他のプラットフォームでは、"Passthrough" での実行のみがサポートされているため、値を設定しないでください。

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".

unsupportedConfigOverrides

``

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

3.1.2. .status

説明
CloudCredentialStatus は、cloud-credential-operator の監視ステータスを定義します。
object
プロパティータイプ説明

conditions

array

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

conditions[]

object

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

generations

array

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

generations[]

object

GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。

observedGeneration

integer

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

readyReplicas

integer

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

version

string

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

3.1.3. .status.conditions

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

3.1.4. .status.conditions[]

説明
OperatorCondition は、標準の状態フィールドです。
object
プロパティータイプ説明

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

3.1.5. .status.generations

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

3.1.6. .status.generations[]

説明
GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。
object
プロパティータイプ説明

group

string

グループはあなたが追跡しているもののグループです

ハッシュ

string

ハッシュは、シークレットや設定マップのようにコンテンツに依存する、生成されないリソース用に設定されたオプションのフィールドです。

lastGeneration

integer

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

name

string

name は、追跡しているものの名前です

namespace

string

名前空間は、追跡しているものがどこにあるかです

resource

string

リソースは、追跡しているもののリソースタイプです

3.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/operator.openshift.io/v1/cloudcredentials

    • 削除:CloudCredential のコレクションを削除します
    • GET: 種類 CloudCredential のオブジェクトをリスト表示します
    • POST:CloudCredential を作成します
  • /apis/operator.openshift.io/v1/cloudcredentials/{name}

    • 削除:CloudCredential を削除します
    • GET: 指定された CloudCredential を読み取ります
    • PATCH: 指定された CloudCredential を部分的に更新します
    • PUT: 指定された CloudCredential を置き換えます
  • /apis/operator.openshift.io/v1/cloudcredentials/{name}/status

    • GET: 指定された CloudCredential のステータスを読み取ります
    • PATCH: 指定された CloudCredential のステータスを部分的に更新します
    • PUT: 指定された CloudCredential のステータスを置き換えます

3.2.1. /apis/operator.openshift.io/v1/cloudcredentials

HTTP メソッド
DELETE
説明
CloudCredential のコレクションを削除します
表3.1 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類が CloudCredential のオブジェクトをリスト表示します。
表3.2 HTTP 応答
HTTP コード応答本文

200 - OK

CloudCredentialList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
CloudCredential を作成します
表3.3 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表3.4 本文パラメーター
パラメータータイプ説明

body

CloudCredential スキーマ

 
表3.5 HTTP 応答
HTTP コード応答本文

200 - OK

CloudCredential スキーマ

201 - Created

CloudCredential スキーマ

202 - Accepted

CloudCredential スキーマ

401 - Unauthorized

空白

3.2.2. /apis/operator.openshift.io/v1/cloudcredentials/{name}

表3.6 グローバルパスパラメーター
パラメータータイプ説明

name

string

CloudCredential の名前

HTTP メソッド
DELETE
説明
CloudCredential を削除します
表3.7 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表3.8 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定された CloudCredential を読み取ります
表3.9 HTTP 応答
HTTP コード応答本文

200 - OK

CloudCredential スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された CloudCredential を部分的に更新します
表3.10 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表3.11 HTTP 応答
HTTP コード応答本文

200 - OK

CloudCredential スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された CloudCredential を置き換えます
表3.12 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表3.13 本文パラメーター
パラメータータイプ説明

body

CloudCredential スキーマ

 
表3.14 HTTP 応答
HTTP コード応答本文

200 - OK

CloudCredential スキーマ

201 - Created

CloudCredential スキーマ

401 - Unauthorized

空白

3.2.3. /apis/operator.openshift.io/v1/cloudcredentials/{name}/status

表3.15 グローバルパスパラメーター
パラメータータイプ説明

name

string

CloudCredential の名前

HTTP メソッド
GET
説明
指定された CloudCredential のステータスを読み取ります
表3.16 HTTP 応答
HTTP コード応答本文

200 - OK

CloudCredential スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された CloudCredential のステータスを部分的に更新します
表3.17 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表3.18 HTTP 応答
HTTP コード応答本文

200 - OK

CloudCredential スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された CloudCredential のステータスを置き換えます
表3.19 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表3.20 本文パラメーター
パラメータータイプ説明

body

CloudCredential スキーマ

 
表3.21 HTTP 応答
HTTP コード応答本文

200 - OK

CloudCredential スキーマ

201 - Created

CloudCredential スキーマ

401 - Unauthorized

空白

第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
プロパティータイプ説明

kmsKeyARN

string

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

4.1.4. .spec.driverConfig.azure

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

diskEncryptionSet

object

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

4.1.5. .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.6. .spec.driverConfig.gcp

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

kmsKey

object

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

4.1.7. .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.8. .spec.driverConfig.ibmcloud

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

encryptionKeyCRN

string

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

4.1.9. .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.10. .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.11. .status.conditions

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

4.1.12. .status.conditions[]

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

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

4.1.13. .status.generations

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

4.1.14. .status.generations[]

説明
GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。
object
プロパティータイプ説明

group

string

グループはあなたが追跡しているもののグループです

ハッシュ

string

ハッシュは、シークレットや設定マップのようにコンテンツに依存する、生成されないリソース用に設定されたオプションのフィールドです。

lastGeneration

integer

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

name

string

name は、追跡しているものの名前です

namespace

string

名前空間は、追跡しているものがどこにあるかです

resource

string

リソースは、追跡しているもののリソースタイプです

4.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/operator.openshift.io/v1/clustercsidrivers

    • DELETE:ClusterCSIDriver のコレクションを削除します
    • GET: 種類 ClusterCSIDriver のオブジェクトをリスト表示します
    • POST:ClusterCSIDriver を作成します
  • /apis/operator.openshift.io/v1/clustercsidrivers/{name}

    • 削除:ClusterCSIDriver を削除します
    • GET: 指定された ClusterCSIDriver を読み取ります
    • PATCH: 指定された ClusterCSIDriver を部分的に更新します
    • PUT: 指定された ClusterCSIDriver を置き換えます
  • /apis/operator.openshift.io/v1/clustercsidrivers/{name}/status

    • GET: 指定された ClusterCSIDriver のステータスを読み取ります
    • PATCH: 指定された ClusterCSIDriver のステータスを部分的に更新します
    • PUT: 指定された ClusterCSIDriver のステータスを置き換えます

4.2.1. /apis/operator.openshift.io/v1/clustercsidrivers

HTTP メソッド
DELETE
説明
ClusterCSIDriver のコレクションを削除します
表4.1 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類が ClusterCSIDriver のオブジェクトをリスト表示します。
表4.2 HTTP 応答
HTTP コード応答本文

200 - OK

ClusterCSIDriverList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
ClusterCSIDriver を作成します
表4.3 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表4.4 本文パラメーター
パラメータータイプ説明

body

ClusterCSIDriver スキーマ

 
表4.5 HTTP 応答
HTTP コード応答本文

200 - OK

ClusterCSIDriver スキーマ

201 - Created

ClusterCSIDriver スキーマ

202 - Accepted

ClusterCSIDriver スキーマ

401 - Unauthorized

空白

4.2.2. /apis/operator.openshift.io/v1/clustercsidrivers/{name}

表4.6 グローバルパスパラメーター
パラメータータイプ説明

name

string

ClusterCSIDriver の名前

HTTP メソッド
DELETE
説明
ClusterCSIDriver を削除します
表4.7 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表4.8 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定された ClusterCSIDriver を読み取ります
表4.9 HTTP 応答
HTTP コード応答本文

200 - OK

ClusterCSIDriver スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された ClusterCSIDriver を部分的に更新します
表4.10 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表4.11 HTTP 応答
HTTP コード応答本文

200 - OK

ClusterCSIDriver スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された ClusterCSIDriver を置き換えます
表4.12 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表4.13 本文パラメーター
パラメータータイプ説明

body

ClusterCSIDriver スキーマ

 
表4.14 HTTP 応答
HTTP コード応答本文

200 - OK

ClusterCSIDriver スキーマ

201 - Created

ClusterCSIDriver スキーマ

401 - Unauthorized

空白

4.2.3. /apis/operator.openshift.io/v1/clustercsidrivers/{name}/status

表4.15 グローバルパスパラメーター
パラメータータイプ説明

name

string

ClusterCSIDriver の名前

HTTP メソッド
GET
説明
指定された ClusterCSIDriver のステータスを読み取ります
表4.16 HTTP 応答
HTTP コード応答本文

200 - OK

ClusterCSIDriver スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された ClusterCSIDriver のステータスを部分的に更新します
表4.17 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表4.18 HTTP 応答
HTTP コード応答本文

200 - OK

ClusterCSIDriver スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された ClusterCSIDriver のステータスを置き換えます
表4.19 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表4.20 本文パラメーター
パラメータータイプ説明

body

ClusterCSIDriver スキーマ

 
表4.21 HTTP 応答
HTTP コード応答本文

200 - OK

ClusterCSIDriver スキーマ

201 - Created

ClusterCSIDriver スキーマ

401 - Unauthorized

空白

第5章 Console [operator.openshift.io/v1]

説明
コンソールは、コンソールを管理するように Operator を設定する手段を提供します。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object
必須
  • spec

5.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

ConsoleSpec は、コンソールの望ましい動作の仕様です。

status

object

ConsoleStatus は、コンソールの監視ステータスを定義します。

5.1.1. .spec

説明
ConsoleSpec は、コンソールの望ましい動作の仕様です。
object
プロパティータイプ説明

カスタマイズ

object

customization は、必要に応じて少数のカスタマイズオプションを Web コンソールに提供するために使用します。

ingress

object

ingress を使用すると、コンソールの代替 Ingress を設定できます。このフィールドは、Ingress 機能がなく、ルートにアクセスできないクラスターを対象としています。

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".

plugins

array (string)

plugins は、有効なコンソールプラグイン名のリストを定義します。

providers

object

プロバイダーには、特定のサービスプロバイダーを使用するための設定が含まれています。

route

object

ルートには、サービング証明書を含むホスト名とシークレット参照が含まれています。カスタムルートが指定されている場合、指定されたホスト名で新しいルートが作成され、その下でコンソールを使用できます。カスタムホスト名がクラスターのデフォルトのルーティング接尾辞を使用する場合、サービング証明書のシークレット指定は必要ありません。カスタムホスト名が任意のドメインを指している場合は、手動の DNS 設定手順が必要です。カスタムルートが削除された場合、コンソールのデフォルトのホスト名を予約するために、デフォルトのコンソールルートが維持されます。指定しない場合、デフォルトルートが使用されます。非推奨

unsupportedConfigOverrides

``

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

5.1.2. .spec.customization

説明
customization は、必要に応じて少数のカスタマイズオプションを Web コンソールに提供するために使用します。
object
プロパティータイプ説明

addPage

object

addPage を使用すると、開発者の観点から追加ページのアクションをカスタマイズできます。

brand

string

ブランドは Web コンソールのデフォルトのブランドであり、ブランドフィールドを指定することで上書きできます。特定のブランドオプションの限られたセットがあります。このフィールドは、ロゴなどのコンソールの要素を制御します。値が無効な場合、コンソールのロールアウトが妨げられます。

customLogoFile

object

customLogoFile は、マストヘッドおよびアバウトダイアログのデフォルトの OpenShift ロゴを置き換えます。これは、openshift-config 名前空間の ConfigMap への参照です。これは、'oc create configmap custom-logo --from-file=/path/to/file -n openshift-config' のようなコマンドで作成できます。ConfigMap サイズの制約により、イメージサイズは 1MB 未満である必要があります。コンソールが正しい MIME タイプでファイルを提供できるように、ConfigMap キーにはファイル拡張子を含める必要があります。推奨されるロゴの仕様: 寸法: 最大高さ 68px、最大幅 200pxSVG 形式を推奨

customProductName

string

customProductName は、通常の OpenShift 製品名の代わりに、ページタイトル、ロゴの代替テキスト、およびバージョン情報ダイアログに表示される名前です。

developerCatalog

object

developerCatalog を使用すると、表示する開発者カタログのカテゴリー (フィルター) とタイプ (サブカタログ) を設定できます。

documentationBaseURL

string

外部ドキュメントへの documentationBaseURL リンクは、Web コンソールのさまざまなセクションに表示されます。documentationBaseURL を指定すると、デフォルトのドキュメント URL が上書きされます。値が無効な場合、コンソールのロールアウトが妨げられます。

perspectives

array

perspectives を使用すると、ユーザーがパースペクティブスイッチャードロップダウンで表示できるパースペクティブを有効/無効にすることができます。

perspectives[]

object

Perspective は、クラスター管理者が表示/非表示にする必要があるパースペクティブスイッチャードロップダウンのパースペクティブを定義します。

projectAccess

object

projectAccess を使用すると、開発者パースペクティブのプロジェクトアクセスページで利用可能な ClusterRoles のリストをカスタマイズできます。このページは、プロジェクト管理者が他のユーザーにロールを指定したり、プロジェクト内のアクセスを制限したりするために使用できます。設定されている場合、リストはデフォルトの ClusterRole オプションに置き換わります。

quickStarts

object

quickStarts を使用すると、コンソールで使用可能な ConsoleQuickStart リソースをカスタマイズできます。

5.1.3. .spec.customization.addPage

説明
addPage を使用すると、開発者の観点から追加ページのアクションをカスタマイズできます。
object
プロパティータイプ説明

disabledActions

array (string)

disabledActions は、ユーザーに表示されないアクションのリストです。リスト内の各アクションは、その ID で表されます。

5.1.4. .spec.customization.customLogoFile

説明
customLogoFile は、マストヘッドおよびアバウトダイアログのデフォルトの OpenShift ロゴを置き換えます。これは、openshift-config 名前空間の ConfigMap への参照です。これは、'oc create configmap custom-logo --from-file=/path/to/file -n openshift-config' のようなコマンドで作成できます。ConfigMap サイズの制約により、イメージサイズは 1MB 未満である必要があります。コンソールが正しい MIME タイプでファイルを提供できるように、ConfigMap キーにはファイル拡張子を含める必要があります。推奨されるロゴの仕様: 寸法: 最大高さ 68px、最大幅 200pxSVG 形式を推奨
object
プロパティータイプ説明

key

string

キーを使用すると、設定マップ内の特定のキー/値を指すことができます。これは、論理ファイルの参照に役立ちます。

name

string

 

5.1.5. .spec.customization.developerCatalog

説明
developerCatalog を使用すると、表示する開発者カタログのカテゴリー (フィルター) とタイプ (サブカタログ) を設定できます。
object
プロパティータイプ説明

categories

array

開発者カタログに表示されているカテゴリー。

categories[]

object

開発者コンソールカタログの DeveloperConsoleCatalogCategory。

types

object

types を使用すると、開発者カタログでユーザーが表示できるサブカタログタイプを有効または無効にすることができます。省略すると、すべてのサブカタログタイプが表示されます。

5.1.6. .spec.customization.developerCatalog.categories

説明
開発者カタログに表示されているカテゴリー。
array

5.1.7. .spec.customization.developerCatalog.categories[]

説明
開発者コンソールカタログの DeveloperConsoleCatalogCategory。
object
必須
  • id
  • ラベル
プロパティータイプ説明

id

string

ID は、コンソールでディープリンクを有効にするために URL で使用される識別子です。ID は必須であり、1〜32 の URL セーフ (AZ、az、0〜9、-、および _) 文字が必要です。

ラベル

string

label は、カテゴリー表示ラベルを定義します。必須であり、1〜64 文字である必要があります。

subcategories

array

サブカテゴリーは、子カテゴリーのリストを定義します。

subcategories[]

object

DeveloperConsoleCatalogCategoryMeta は、開発者カタログカテゴリーの主要な識別子です。

tags

array (string)

タグは、カテゴリーに一致する文字列のリストです。選択したカテゴリーには、カテゴリーとアイテムの間に少なくとも 1 つの重複するタグがあるすべてのアイテムが表示されます。

5.1.8. .spec.customization.developerCatalog.categories[].subcategories

説明
サブカテゴリーは、子カテゴリーのリストを定義します。
array

5.1.9. .spec.customization.developerCatalog.categories[].subcategories[]

説明
DeveloperConsoleCatalogCategoryMeta は、開発者カタログカテゴリーの主要な識別子です。
object
必須
  • id
  • ラベル
プロパティータイプ説明

id

string

ID は、コンソールでディープリンクを有効にするために URL で使用される識別子です。ID は必須であり、1〜32 の URL セーフ (AZ、az、0〜9、-、および _) 文字が必要です。

ラベル

string

label は、カテゴリー表示ラベルを定義します。必須であり、1〜64 文字である必要があります。

tags

array (string)

タグは、カテゴリーに一致する文字列のリストです。選択したカテゴリーには、カテゴリーとアイテムの間に少なくとも 1 つの重複するタグがあるすべてのアイテムが表示されます。

5.1.10. .spec.customization.developerCatalog.types

説明
types を使用すると、開発者カタログでユーザーが表示できるサブカタログタイプを有効または無効にすることができます。省略すると、すべてのサブカタログタイプが表示されます。
object
必須
  • state
プロパティータイプ説明

disabled

array (string)

disabled は、ユーザーに表示されない開発者カタログのタイプ (サブカタログ ID) のリストです。タイプ (サブカタログ) は、コンソールプラグインを介して追加されます。使用可能なタイプ (サブカタログ ID) は、コンソールのクラスター設定ページ、またはコンソールで YAML を編集するときに使用できます。たとえば、"Devfile"、"HelmChart"、"BuilderImage" です。リストが空の場合、または使用可能なサブカタログタイプがすべて追加されている場合は、開発者カタログ全体が非表示になります。

enabled

array (string)

enabled は、ユーザーに表示される開発者カタログのタイプ (サブカタログ ID) のリストです。タイプ (サブカタログ) は、コンソールプラグインを介して追加されます。使用可能なタイプ (サブカタログ ID) は、コンソールのクラスター設定ページ、またはコンソールで YAML を編集するときに使用できます。たとえば、"Devfile"、"HelmChart"、"BuilderImage" です。リストが空でない場合、新しいタイプはリストに追加されるまでユーザーに表示されません。リストが空の場合、開発者カタログ全体が表示されます。

state

string

state は、カタログタイプのリストを有効にするか無効にするかを定義します。

5.1.11. .spec.customization.perspectives

説明
perspectives を使用すると、ユーザーがパースペクティブスイッチャードロップダウンで表示できるパースペクティブを有効/無効にすることができます。
array

5.1.12. .spec.customization.perspectives[]

説明
Perspective は、クラスター管理者が表示/非表示にする必要があるパースペクティブスイッチャードロップダウンのパースペクティブを定義します。
object
必須
  • id
  • visibility
プロパティータイプ説明

id

string

id は、パースペクティブの ID を定義します。たとえば、"dev"、"admin" です。利用可能なパースペクティブ ID は、yaml エディターの横にあるコードスニペットセクションにあります。不正確または不明な ID は無視されます。

pinnedResources

array

pinnedResources は、ユーザーが固定されたリソースを自分でカスタマイズしていない場合に、パースペクティブナビゲーションでユーザーに表示されるデフォルトの固定されたリソースのリストを定義します。利用可能な Kubernetes リソースのリストは、kubectl api-resources を介して読み取ることができます。また、コンソールが提供する設定 UI と YAML スニペットに、ナビゲーションに固定できる利用可能なリソースがリスト表示されます。不正確または不明なリソースは無視されます。

pinnedResources[]

object

PinnedResourceReference には、リソースのグループ、バージョン、タイプを含めます。

visibility

object

visibility は、パースペクティブの状態と、アクセスレビューチェック (そのパースペクティブに必要な場合) を定義します。

5.1.13. .spec.customization.perspectives[].pinnedResources

説明
pinnedResources は、ユーザーが固定されたリソースを自分でカスタマイズしていない場合に、パースペクティブナビゲーションでユーザーに表示されるデフォルトの固定されたリソースのリストを定義します。利用可能な Kubernetes リソースのリストは、kubectl api-resources を介して読み取ることができます。また、コンソールが提供する設定 UI と YAML スニペットに、ナビゲーションに固定できる利用可能なリソースがリスト表示されます。不正確または不明なリソースは無視されます。
array

5.1.14. .spec.customization.perspectives[].pinnedResources[]

説明
PinnedResourceReference には、リソースのグループ、バージョン、タイプを含めます。
object
必須
  • group
  • resource
  • version
プロパティータイプ説明

group

string

group は、リソースの API グループです。コアグループの場合は、空の文字列を入力します。この値は、小文字の英数字、ハイフン、ピリオドのみで構成する必要があります。たとえば、""、"apps"、"build.openshift.io" です。

resource

string

resource は、参照されるタイプです。通常、リソースの種類の複数形を小文字で表記したものです。この値は、小文字の英数字とハイフンのみで構成する必要があります。たとえば、"deployments"、"deploymentconfigs"、"pods" です。

version

string

version は、リソースの API バージョンです。この値は小文字の英数字のみで構成する必要があります。たとえば、"v1"、"v1beta1" です。

5.1.15. .spec.customization.perspectives[].visibility

説明
visibility は、パースペクティブの状態と、アクセスレビューチェック (そのパースペクティブに必要な場合) を定義します。
object
必須
  • state
プロパティータイプ説明

accessReview

object

accessReview は、必要なアクセスレビューチェックと不足しているアクセスレビューチェックを定義します。

state

string

state は、パースペクティブが有効か無効か、またはアクセスレビューチェックが必要かどうかを定義します。

5.1.16. .spec.customization.perspectives[].visibility.accessReview

説明
accessReview は、必要なアクセスレビューチェックと不足しているアクセスレビューチェックを定義します。
object
プロパティータイプ説明

missing

array

missing は、権限チェックのリストを定義します。1 つ以上のチェックが失敗した場合にのみ、パースペクティブが表示されます。省略すると、アクセスレビューがスキップされ、必要なアクセスレビューのリストの設定によって要求されない限り、パースペクティブは表示されません。

missing[]

object

ResourceAttributes には、Authorizer インターフェイスへのリソース要求に使用できる許可属性が含まれています

required

array

required は、権限チェックのリストを定義します。すべてのチェックが成功した場合にのみ、パースペクティブが表示されます。省略すると、アクセスレビューがスキップされ、不足しているアクセスレビューのリストの設定によって要求されない限り、パースペクティブは表示されません。

required[]

object

ResourceAttributes には、Authorizer インターフェイスへのリソース要求に使用できる許可属性が含まれています

5.1.17. .spec.customization.perspectives[].visibility.accessReview.missing

説明
missing は、権限チェックのリストを定義します。1 つ以上のチェックが失敗した場合にのみ、パースペクティブが表示されます。省略すると、アクセスレビューがスキップされ、必要なアクセスレビューのリストの設定によって要求されない限り、パースペクティブは表示されません。
array

5.1.18. .spec.customization.perspectives[].visibility.accessReview.missing[]

説明
ResourceAttributes には、Authorizer インターフェイスへのリソース要求に使用できる許可属性が含まれています
タイプ
object
プロパティータイプ説明

group

string

グループは、リソースの API グループです。"*" はすべてを意味します。

name

string

名前は、"取得" のために要求されているリソース、または "削除" のために削除されているリソースの名前です。"" (空) はすべてを意味します。

namespace

string

namespace は、要求されているアクションの namespace です。現在、名前空間なしとすべての名前空間の区別はありません ""(空) は LocalSubjectAccessReviews のデフォルトです ""(空) はクラスタースコープのリソースでは空です ""(空) は SubjectAccessReview からの名前空間スコープのリソースの " すべて " を意味します SelfSubjectAccessReview

resource

string

リソースは、既存のリソースタイプの 1 つです。"*" はすべてを意味します。

subresource

string

サブリソースは、既存のリソースタイプの 1 つです。"" は何もないことを意味します。

verb

string

動詞は、get、list、watch、create、update、delete、proxy などの kubernetes リソース API 動詞です。"*" はすべてを意味します。

version

string

バージョンは、リソースの API バージョンです。"*" はすべてを意味します。

5.1.19. .spec.customization.perspectives[].visibility.accessReview.required

説明
required は、権限チェックのリストを定義します。すべてのチェックが成功した場合にのみ、パースペクティブが表示されます。省略すると、アクセスレビューがスキップされ、不足しているアクセスレビューのリストの設定によって要求されない限り、パースペクティブは表示されません。
array

5.1.20. .spec.customization.perspectives[].visibility.accessReview.required[]

説明
ResourceAttributes には、Authorizer インターフェイスへのリソース要求に使用できる許可属性が含まれています
タイプ
object
プロパティータイプ説明

group

string

グループは、リソースの API グループです。"*" はすべてを意味します。

name

string

名前は、"取得" のために要求されているリソース、または "削除" のために削除されているリソースの名前です。"" (空) はすべてを意味します。

namespace

string

namespace は、要求されているアクションの namespace です。現在、名前空間なしとすべての名前空間の区別はありません ""(空) は LocalSubjectAccessReviews のデフォルトです ""(空) はクラスタースコープのリソースでは空です ""(空) は SubjectAccessReview からの名前空間スコープのリソースの " すべて " を意味します SelfSubjectAccessReview

resource

string

リソースは、既存のリソースタイプの 1 つです。"*" はすべてを意味します。

subresource

string

サブリソースは、既存のリソースタイプの 1 つです。"" は何もないことを意味します。

verb

string

動詞は、get、list、watch、create、update、delete、proxy などの kubernetes リソース API 動詞です。"*" はすべてを意味します。

version

string

バージョンは、リソースの API バージョンです。"*" はすべてを意味します。

5.1.21. .spec.customization.projectAccess

説明
projectAccess を使用すると、開発者パースペクティブのプロジェクトアクセスページで利用可能な ClusterRoles のリストをカスタマイズできます。このページは、プロジェクト管理者が他のユーザーにロールを指定したり、プロジェクト内のアクセスを制限したりするために使用できます。設定されている場合、リストはデフォルトの ClusterRole オプションに置き換わります。
object
プロパティータイプ説明

availableClusterRoles

array (string)

availableClusterRoles は、プロジェクトアクセスタブを介してユーザーに割り当てることができる ClusterRole 名のリストです。

5.1.22. .spec.customization.quickStarts

説明
quickStarts を使用すると、コンソールで使用可能な ConsoleQuickStart リソースをカスタマイズできます。
object
プロパティータイプ説明

disabled

array (string)

無効は、ユーザーに表示されない ConsoleQuickStart リソース名のリストです。

5.1.23. .spec.ingress

説明
ingress を使用すると、コンソールの代替 Ingress を設定できます。このフィールドは、Ingress 機能がなく、ルートにアクセスできないクラスターを対象としています。
object
プロパティータイプ説明

clientDownloadsURL

string

clientDownloadsURL は、クライアントバイナリーをダウンロードするためのアドレスとして使用される URL です。指定されていない場合、ダウンロードルートのホスト名が使用されます。このフィールドは、Ingress 機能がなく、ルートにアクセスできないクラスターに必要です。この URL はコンソール Operator によって監視されます。URL に長期間アクセスできない場合、コンソール Operator がデグレード状態になる可能性があります。HTTPS スキームを使用する必要があります。

consoleURL

string

consoleURL は、ベースコンソールアドレスとして使用される URL です。指定されていない場合、コンソールルートのホスト名が使用されます。このフィールドは、Ingress 機能がなく、ルートにアクセスできないクラスターに必要です。この URL に適切な Ingress が設定されていることを確認してください。この URL はコンソール Operator によって監視されます。URL に長期間アクセスできない場合、コンソール Operator がデグレード状態になる可能性があります。HTTPS スキームを使用する必要があります。

5.1.24. .spec.providers

説明
プロバイダーには、特定のサービスプロバイダーを使用するための設定が含まれています。
object
プロパティータイプ説明

statuspage

object

statuspage には、ステータス情報を提供する statuspage.io ページの ID が含まれています。

5.1.25. .spec.providers.statuspage

説明
statuspage には、ステータス情報を提供する statuspage.io ページの ID が含まれています。
object
プロパティータイプ説明

pageID

string

pageID は、Statuspage によってページに割り当てられた一意の ID です。これは公開ページである必要があります。

5.1.26. .spec.route

説明
ルートには、サービング証明書を含むホスト名とシークレット参照が含まれています。カスタムルートが指定されている場合、指定されたホスト名で新しいルートが作成され、その下でコンソールを使用できます。カスタムホスト名がクラスターのデフォルトのルーティング接尾辞を使用する場合、サービング証明書のシークレット指定は必要ありません。カスタムホスト名が任意のドメインを指している場合は、手動の DNS 設定手順が必要です。カスタムルートが削除された場合、コンソールのデフォルトのホスト名を予約するために、デフォルトのコンソールルートが維持されます。指定しない場合、デフォルトルートが使用されます。非推奨
object
プロパティータイプ説明

hostname

string

ホスト名は、コンソールを使用できる目的のカスタムドメインです。

secret

object

シークレットは、カスタム証明書とキーを含み、クラスター管理者が手動で作成する必要がある openshift-config 名前空間のシークレットを指します。参照シークレットには、次のキーと値のペアが含まれている必要があります。-"tls.crt"- カスタム証明書を指定します -"tls.key"- カスタム証明書の秘密キーを指定しますカスタムホスト名がクラスターのデフォルトのルーティング接尾辞を使用する場合、サービング証明書のシークレット仕様は必要ありません。

5.1.27. .spec.route.secret

説明
シークレットは、カスタム証明書とキーを含み、クラスター管理者が手動で作成する必要がある openshift-config 名前空間のシークレットを指します。参照シークレットには、次のキーと値のペアが含まれている必要があります。-"tls.crt"- カスタム証明書を指定します -"tls.key"- カスタム証明書の秘密キーを指定しますカスタムホスト名がクラスターのデフォルトのルーティング接尾辞を使用する場合、サービング証明書のシークレット仕様は必要ありません。
object
必須
  • name
プロパティータイプ説明

name

string

name は、参照されるシークレットの metadata.name です。

5.1.28. .status

説明
ConsoleStatus は、コンソールの監視ステータスを定義します。
object
プロパティータイプ説明

conditions

array

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

conditions[]

object

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

generations

array

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

generations[]

object

GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。

observedGeneration

integer

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

readyReplicas

integer

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

version

string

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

5.1.29. .status.conditions

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

5.1.30. .status.conditions[]

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

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

5.1.31. .status.generations

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

5.1.32. .status.generations[]

説明
GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。
object
プロパティータイプ説明

group

string

グループはあなたが追跡しているもののグループです

ハッシュ

string

ハッシュは、シークレットや設定マップのようにコンテンツに依存する、生成されないリソース用に設定されたオプションのフィールドです。

lastGeneration

integer

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

name

string

name は、追跡しているものの名前です

namespace

string

名前空間は、追跡しているものがどこにあるかです

resource

string

リソースは、追跡しているもののリソースタイプです

5.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/operator.openshift.io/v1/consoles

    • 削除: コンソールのコレクションを削除します
    • GET: 種類のコンソールのオブジェクトをリスト表示します
    • POST: コンソールを作成します
  • /apis/operator.openshift.io/v1/consoles/{name}

    • 削除: コンソールを削除します
    • GET: 指定されたコンソールを読み取ります
    • PATCH: 指定されたコンソールを部分的に更新します
    • PUT: 指定されたコンソールを交換します
  • /apis/operator.openshift.io/v1/consoles/{name}/status

    • GET: 指定されたコンソールのステータスを読み取ります
    • PATCH: 指定されたコンソールのステータスを部分的に更新します
    • PUT: 指定されたコンソールのステータスを置き換えます

5.2.1. /apis/operator.openshift.io/v1/consoles

HTTP メソッド
DELETE
説明
コンソールのコレクションを削除する
表5.1 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類のオブジェクトをリスト表示するコンソール
表5.2 HTTP 応答
HTTP コード応答本文

200 - OK

ConsoleList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
コンソールを作成する
表5.3 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表5.4 本文パラメーター
パラメータータイプ説明

body

Console スキーマ

 
表5.5 HTTP 応答
HTTP コード応答本文

200 - OK

Console スキーマ

201 - Created

Console スキーマ

202 - Accepted

Console スキーマ

401 - Unauthorized

空白

5.2.2. /apis/operator.openshift.io/v1/consoles/{name}

表5.6 グローバルパスパラメーター
パラメータータイプ説明

name

string

コンソールの名前

HTTP メソッド
DELETE
説明
コンソールを削除する
表5.7 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表5.8 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定されたコンソールを読む
表5.9 HTTP 応答
HTTP コード応答本文

200 - OK

Console スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定されたコンソールを部分的に更新します
表5.10 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表5.11 HTTP 応答
HTTP コード応答本文

200 - OK

Console スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定されたコンソールを交換してください
表5.12 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表5.13 本文パラメーター
パラメータータイプ説明

body

Console スキーマ

 
表5.14 HTTP 応答
HTTP コード応答本文

200 - OK

Console スキーマ

201 - Created

Console スキーマ

401 - Unauthorized

空白

5.2.3. /apis/operator.openshift.io/v1/consoles/{name}/status

表5.15 グローバルパスパラメーター
パラメータータイプ説明

name

string

コンソールの名前

HTTP メソッド
GET
説明
指定されたコンソールのステータスを読み取ります
表5.16 HTTP 応答
HTTP コード応答本文

200 - OK

Console スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定されたコンソールのステータスを部分的に更新します
表5.17 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表5.18 HTTP 応答
HTTP コード応答本文

200 - OK

Console スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定されたコンソールのステータスを置き換えます
表5.19 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表5.20 本文パラメーター
パラメータータイプ説明

body

Console スキーマ

 
表5.21 HTTP 応答
HTTP コード応答本文

200 - OK

Console スキーマ

201 - Created

Console スキーマ

401 - Unauthorized

空白

第6章 Config [operator.openshift.io/v1]

説明
Config は、クラスター上に他のコンポーネントの初期設定を作成する役割を担う config Operator の動作を指定します。この Operator は、AWS および Azure クラウドをベースとしたクラスターのクラウド設定のインストール、移行、または同期も処理します。互換性レベル 1: メジャーリリース内で最低 12 カ月間、または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
object
必須
  • spec

6.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 は、Config Operator の望ましい動作の仕様です。

status

object

status は、Config Operator の監視ステータスを定義します。

6.1.1. .spec

説明
spec は、Config Operator の望ましい動作の仕様です。
object
プロパティータイプ説明

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".

unsupportedConfigOverrides

``

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

6.1.2. .status

説明
status は、Config Operator の監視ステータスを定義します。
object
プロパティータイプ説明

conditions

array

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

conditions[]

object

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

generations

array

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

generations[]

object

GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。

observedGeneration

integer

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

readyReplicas

integer

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

version

string

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

6.1.3. .status.conditions

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

6.1.4. .status.conditions[]

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

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

6.1.5. .status.generations

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

6.1.6. .status.generations[]

説明
GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。
object
プロパティータイプ説明

group

string

グループはあなたが追跡しているもののグループです

ハッシュ

string

ハッシュは、シークレットや設定マップのようにコンテンツに依存する、生成されないリソース用に設定されたオプションのフィールドです。

lastGeneration

integer

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

name

string

name は、追跡しているものの名前です

namespace

string

名前空間は、追跡しているものがどこにあるかです

resource

string

リソースは、追跡しているもののリソースタイプです

6.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/operator.openshift.io/v1/configs

    • DELETE: 設定のコレクションを削除します
    • GET: 種類のオブジェクトをリスト表示する Config
    • POST: 設定を作成します
  • /apis/operator.openshift.io/v1/configs/{name}

    • 削除: 設定を削除します
    • GET: 指定された設定を読み取ります
    • PATCH: 指定された設定を部分的に更新します
    • PUT: 指定された設定を置き換えます
  • /apis/operator.openshift.io/v1/configs/{name}/status

    • GET: 指定された設定のステータスを読み取ります
    • PATCH: 指定された設定のステータスを部分的に更新します
    • PUT: 指定された設定のステータスを置き換えます

6.2.1. /apis/operator.openshift.io/v1/configs

HTTP メソッド
DELETE
説明
Config のコレクションを削除します
表6.1 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類のオブジェクトをリスト表示する Config
表6.2 HTTP 応答
HTTP コード応答本文

200 - OK

ConfigList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
設定を作成する
表6.3 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表6.4 本文パラメーター
パラメータータイプ説明

body

Config スキーマ

 
表6.5 HTTP 応答
HTTP コード応答本文

200 - OK

Config スキーマ

201 - Created

Config スキーマ

202 - Accepted

Config スキーマ

401 - Unauthorized

空白

6.2.2. /apis/operator.openshift.io/v1/configs/{name}

表6.6 グローバルパスパラメーター
パラメータータイプ説明

name

string

設定の名前

HTTP メソッド
DELETE
説明
設定を削除する
表6.7 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表6.8 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定された設定を読み取ります
表6.9 HTTP 応答
HTTP コード応答本文

200 - OK

Config スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された設定を部分的に更新します
表6.10 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表6.11 HTTP 応答
HTTP コード応答本文

200 - OK

Config スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された設定を置き換えます
表6.12 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表6.13 本文パラメーター
パラメータータイプ説明

body

Config スキーマ

 
表6.14 HTTP 応答
HTTP コード応答本文

200 - OK

Config スキーマ

201 - Created

Config スキーマ

401 - Unauthorized

空白

6.2.3. /apis/operator.openshift.io/v1/configs/{name}/status

表6.15 グローバルパスパラメーター
パラメータータイプ説明

name

string

設定の名前

HTTP メソッド
GET
説明
指定された設定のステータスを読み取ります
表6.16 HTTP 応答
HTTP コード応答本文

200 - OK

Config スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された設定のステータスを部分的に更新します
表6.17 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表6.18 HTTP 応答
HTTP コード応答本文

200 - OK

Config スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された設定のステータスを置き換えます
表6.19 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表6.20 本文パラメーター
パラメータータイプ説明

body

Config スキーマ

 
表6.21 HTTP 応答
HTTP コード応答本文

200 - OK

Config スキーマ

201 - Created

Config スキーマ

401 - Unauthorized

空白

第7章 Config [imageregistry.operator.openshift.io/v1]

説明
Config は、レジストリー Operator によって管理されるレジストリーインスタンスの設定オブジェクトです。互換性レベル 1: メジャーリリース内で最低 12 カ月間、または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
object
必須
  • metadata
  • spec

7.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

ImageRegistrySpec は、実行中のレジストリーの仕様を定義します。

status

object

ImageRegistryStatus は、イメージレジストリーの動作ステータスを報告します。

7.1.1. .spec

説明
ImageRegistrySpec は、実行中のレジストリーの仕様を定義します。
object
必須
  • replicas
プロパティータイプ説明

affinity

object

アフィニティーは、イメージレジストリー Pod のノードアフィニティースケジューリングルールのグループです。

defaultRoute

boolean

defaultRoute は、デフォルトで生成されたホスト名を使用して、レジストリーの外部向けルートを作成する必要があるかどうかを示します。

disableRedirect

boolean

disableRedirect は、バックエンドにリダイレクトするのではなく、レジストリーを介してすべてのデータをルーティングするかどうかを制御します。

httpSecret

string

httpSecret は、レジストリーがアップロードを保護するために必要な値であり、デフォルトで生成されます。

logLevel

string

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

logging

integer

ロギングは非推奨です。代わりに logLevel を使用してください。

managementState

string

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

nodeSelector

object (string)

nodeSelector は、レジストリー Pod のノード選択制約を定義します。

observedConfig

``

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

operatorLogLevel

string

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

proxy

object

proxy は、マスター API、アップストリームレジストリーなどを呼び出すときに使用されるプロキシーを定義します。

readOnly

boolean

readOnly は、レジストリーインスタンスが新しいイメージのプッシュや既存のイメージの削除を拒否するかどうかを指定します。

replicas

integer

レプリカは、実行するレジストリーインスタンスの数を決定します。

requests

object

指定されたレジストリーインスタンスが追加リソースをキューに入れる前に処理する並列要求の数を制御します。

resources

object

resources は、レジストリー Pod のリソースリクエストと制限を定義します。

rolloutStrategy

string

rolloutStrategy は、イメージレジストリーデプロイメントのロールアウト戦略を定義します。

routes

array

ルートは、レジストリー用に作成する必要がある追加の外部向けルートを定義します。

routes[]

object

ImageRegistryConfigRoute は、イメージレジストリーへの外部ルートアクセスに関する情報を保持します。

storage

object

レジストリーストレージを設定するためのストレージの詳細 (S3 バケット座標など)。

tolerations

array

tolerations は、レジストリー Pod の許容値を定義します。

tolerations[]

object

この toleration が割り当てられる Pod は、マッチング Operator <operator> を使用してトリプル <key,value,effect> と一致するテイントを許容します。

topologySpreadConstraints

array

topologySpreadConstraints は、一致する Pod を特定のトポロジー内でどのように分散するかを指定します。

topologySpreadConstraints[]

object

topologySpreadConstraint は、指定されたトポロジー間で一致する Pod を分散する方法を指定します。

unsupportedConfigOverrides

``

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

7.1.2. .spec.affinity

説明
アフィニティーは、イメージレジストリー Pod のノードアフィニティースケジューリングルールのグループです。
object
プロパティータイプ説明

nodeAffinity

object

Pod のノードアフィニティースケジューリングルールを説明します。

podAffinity

object

Pod アフィニティースケジューリングルールを説明します (たとえば、この Pod を他の Pod と同じノード、ゾーンなどに配置します)。

podAntiAffinity

object

Pod の非アフィニティースケジューリングルールを説明します (たとえば、この Pod を他の Pod と同じノード、ゾーンなどに配置しないでください)。

7.1.3. .spec.affinity.nodeAffinity

説明
Pod のノードアフィニティースケジューリングルールを説明します。
object
プロパティータイプ説明

preferredDuringSchedulingIgnoredDuringExecution

array

スケジューラーは、このフィールドで指定されたアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アフィニティー式など) を満たすノードごとに、このフィールドの要素を反復処理して合計を計算します。ノードが対応する matchExpressions と一致する場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。

preferredDuringSchedulingIgnoredDuringExecution[]

object

空の優先スケジューリング用語は、暗黙の重み 0 を持つすべてのオブジェクトに一致します (つまり、操作なしです)。null の優先スケジューリング用語は、オブジェクトに一致しません (つまり、no-op でもあります)。

requiredDuringSchedulingIgnoredDuringExecution

object

このフィールドで指定されたアフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定されたアフィニティー要件が Pod 実行中のある時点で満たされない場合 (更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。

7.1.4. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution

説明
スケジューラーは、このフィールドで指定されたアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アフィニティー式など) を満たすノードごとに、このフィールドの要素を反復処理して合計を計算します。ノードが対応する matchExpressions と一致する場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。
タイプ
array

7.1.5. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[]

説明
空の優先スケジューリング用語は、暗黙の重み 0 を持つすべてのオブジェクトに一致します (つまり、操作なしです)。null の優先スケジューリング用語は、オブジェクトに一致しません (つまり、no-op でもあります)。
タイプ
object
必須
  • preference
  • weight
プロパティータイプ説明

preference

object

対応する重みに関連付けられたノードセレクター用語。

weight

integer

対応する nodeSelectorTerm の一致に関連する重み (1〜100 の範囲)。

7.1.6. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference

説明
対応する重みに関連付けられたノードセレクター用語。
object
プロパティータイプ説明

matchExpressions

array

ノードのラベルごとのノードセレクター要件のリスト。

matchExpressions[]

object

ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchFields

array

ノードのフィールドごとのノードセレクター要件のリスト。

matchFields[]

object

ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

7.1.7. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchExpressions

説明
ノードのラベルごとのノードセレクター要件のリスト。
タイプ
array

7.1.8. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchExpressions[]

説明
ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

セレクターが適用されるラベルキー。

operator

string

キーと値のセットの関係を表します。有効な Operator は、In、NotIn、Exists、DoesNotExist です。Gt、および Lt。

array (string)

文字列値の配列。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。Operator が Gt または Lt の場合、values 配列には、整数として解釈される単一の要素が必要です。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

7.1.9. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchFields

説明
ノードのフィールドごとのノードセレクター要件のリスト。
タイプ
array

7.1.10. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchFields[]

説明
ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

セレクターが適用されるラベルキー。

operator

string

キーと値のセットの関係を表します。有効な Operator は、In、NotIn、Exists、DoesNotExist です。Gt、および Lt。

array (string)

文字列値の配列。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。Operator が Gt または Lt の場合、values 配列には、整数として解釈される単一の要素が必要です。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

7.1.11. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution

説明
このフィールドで指定されたアフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定されたアフィニティー要件が Pod 実行中のある時点で満たされない場合 (更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。
object
必須
  • nodeSelectorTerms
プロパティータイプ説明

nodeSelectorTerms

array

必須。ノードセレクター用語のリスト。用語は OR されています。

nodeSelectorTerms[]

object

null または空のノードセレクター用語はオブジェクトに一致しません。これらの要件は AND で結合されます。TopologySelectorTerm タイプは、NodeSelectorTerm のサブセットを実装します。

7.1.12. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms

説明
必須。ノードセレクター用語のリスト。用語は OR されています。
タイプ
array

7.1.13. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[]

説明
null または空のノードセレクター用語はオブジェクトに一致しません。これらの要件は AND で結合されます。TopologySelectorTerm タイプは、NodeSelectorTerm のサブセットを実装します。
タイプ
object
プロパティータイプ説明

matchExpressions

array

ノードのラベルごとのノードセレクター要件のリスト。

matchExpressions[]

object

ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchFields

array

ノードのフィールドごとのノードセレクター要件のリスト。

matchFields[]

object

ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

7.1.14. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchExpressions

説明
ノードのラベルごとのノードセレクター要件のリスト。
タイプ
array

7.1.15. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchExpressions[]

説明
ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

セレクターが適用されるラベルキー。

operator

string

キーと値のセットの関係を表します。有効な Operator は、In、NotIn、Exists、DoesNotExist です。Gt、および Lt。

array (string)

文字列値の配列。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。Operator が Gt または Lt の場合、values 配列には、整数として解釈される単一の要素が必要です。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

7.1.16. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchFields

説明
ノードのフィールドごとのノードセレクター要件のリスト。
タイプ
array

7.1.17. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchFields[]

説明
ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

セレクターが適用されるラベルキー。

operator

string

キーと値のセットの関係を表します。有効な Operator は、In、NotIn、Exists、DoesNotExist です。Gt、および Lt。

array (string)

文字列値の配列。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。Operator が Gt または Lt の場合、values 配列には、整数として解釈される単一の要素が必要です。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

7.1.18. .spec.affinity.podAffinity

説明
Pod アフィニティースケジューリングルールを説明します (たとえば、この Pod を他の Pod と同じノード、ゾーンなどに配置します)。
object
プロパティータイプ説明

preferredDuringSchedulingIgnoredDuringExecution

array

スケジューラーは、このフィールドで指定されたアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アフィニティー式など) を満たすノードごとに、このフィールドの要素を反復処理して合計を計算します。ノードに対応する podAffinityTerm に一致する Pod がある場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。

preferredDuringSchedulingIgnoredDuringExecution[]

object

一致したすべての WeightedPodAffinityTerm フィールドの重みがノードごとに追加され、最も優先されるノードが検索されます。

requiredDuringSchedulingIgnoredDuringExecution

array

このフィールドで指定されたアフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定されたアフィニティー要件が Pod 実行中のある時点で満たされない場合 (Pod ラベルの更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。複数の要素がある場合、各 podAffinityTerm に対応するノードのリストが交差します。つまり、すべての用語が満たされる必要があります。

requiredDuringSchedulingIgnoredDuringExecution[]

object

この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。ここで、同じ場所は次のように定義されます。キー <topologyKey> のラベルの値が、Pod のセットの Pod が実行されているノードの値と一致するノードで実行されている

7.1.19. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution

説明
スケジューラーは、このフィールドで指定されたアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アフィニティー式など) を満たすノードごとに、このフィールドの要素を反復処理して合計を計算します。ノードに対応する podAffinityTerm に一致する Pod がある場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。
タイプ
array

7.1.20. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[]

説明
一致したすべての WeightedPodAffinityTerm フィールドの重みがノードごとに追加され、最も優先されるノードが検索されます。
タイプ
object
必須
  • podAffinityTerm
  • weight
プロパティータイプ説明

podAffinityTerm

object

必須。対応する重みに関連付けられた Pod アフィニティー用語。

weight

integer

対応する podAffinityTerm の一致に関連する重み (1〜100 の範囲)。

7.1.21. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm

説明
必須。対応する重みに関連付けられた Pod アフィニティー用語。
object
必須
  • topologyKey
プロパティータイプ説明

labelSelector

object

リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。

matchLabelKeys

array (string)

MatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは key in (value) として labelSelector にマージされ、着信 Pod の Pod アフィニティー (アンチアフィニティー) として考慮される既存の Pod のグループを選択します。受信 Pod ラベルに存在しないキーは無視されます。デフォルト値は空です。同じキーが MatchLabelKeys と LabelSelector の両方に存在することはできません。また、labelSelector が設定されていない場合、matchLabelKeys は設定できません。これはアルファフィールドであり、MatchLabelKeysInPodAffinity フィーチャーゲートを有効にする必要があります。

mismatchLabelKeys

array (string)

MismatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは key notin (value) として labelSelector にマージされ、着信 Pod の Pod アフィニティー (アンチアフィニティー) として考慮される既存の Pod のグループを選択します。受信 Pod ラベルに存在しないキーは無視されます。デフォルト値は空です。mismatchLabelKeys と labelSelector の両方に同じキーが存在することは禁止されています。また、labelSelector が設定されていない場合、mismatchLabelKeys は設定できません。これはアルファフィールドであり、MatchLabelKeysInPodAffinity フィーチャーゲートを有効にする必要があります。

namespaceSelector

object

用語が適用される名前空間のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての名前空間に一致します。

namespace

array (string)

namespaces は、用語が適用される名前空間名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび nullnamespaceSelector は、"この Pod の namespace" を意味します

topologyKey

string

この Pod は、指定された名前空間の labelSelector と一致する Pod と同じ場所に配置 (アフィニティー) するか、同じ場所に配置しない (アンチアフィニティー) 必要があります。ここで、同じ場所に配置されるのは、キー topologyKey を持つラベルの値を持つノードで実行されるものとして定義されます。選択した Pod のいずれかが実行されているノードのノードと一致します。空の topologyKey は許可されていません。

7.1.22. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector

説明
リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。
object
プロパティータイプ説明

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

7.1.23. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector.matchExpressions

説明
matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
array

7.1.24. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector.matchExpressions[]

説明
ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

7.1.25. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector

説明
用語が適用される名前空間のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての名前空間に一致します。
object
プロパティータイプ説明

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

7.1.26. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector.matchExpressions

説明
matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
array

7.1.27. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector.matchExpressions[]

説明
ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

7.1.28. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution

説明
このフィールドで指定されたアフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定されたアフィニティー要件が Pod 実行中のある時点で満たされない場合 (Pod ラベルの更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。複数の要素がある場合、各 podAffinityTerm に対応するノードのリストが交差します。つまり、すべての用語が満たされる必要があります。
タイプ
array

7.1.29. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[]

説明
この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。ここで、同じ場所は次のように定義されます。キー <topologyKey> のラベルの値が、Pod のセットの Pod が実行されているノードの値と一致するノードで実行されている
タイプ
object
必須
  • topologyKey
プロパティータイプ説明

labelSelector

object

リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。

matchLabelKeys

array (string)

MatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは key in (value) として labelSelector にマージされ、着信 Pod の Pod アフィニティー (アンチアフィニティー) として考慮される既存の Pod のグループを選択します。受信 Pod ラベルに存在しないキーは無視されます。デフォルト値は空です。同じキーが MatchLabelKeys と LabelSelector の両方に存在することはできません。また、labelSelector が設定されていない場合、matchLabelKeys は設定できません。これはアルファフィールドであり、MatchLabelKeysInPodAffinity フィーチャーゲートを有効にする必要があります。

mismatchLabelKeys

array (string)

MismatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは key notin (value) として labelSelector にマージされ、着信 Pod の Pod アフィニティー (アンチアフィニティー) として考慮される既存の Pod のグループを選択します。受信 Pod ラベルに存在しないキーは無視されます。デフォルト値は空です。mismatchLabelKeys と labelSelector の両方に同じキーが存在することは禁止されています。また、labelSelector が設定されていない場合、mismatchLabelKeys は設定できません。これはアルファフィールドであり、MatchLabelKeysInPodAffinity フィーチャーゲートを有効にする必要があります。

namespaceSelector

object

用語が適用される名前空間のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての名前空間に一致します。

namespace

array (string)

namespaces は、用語が適用される名前空間名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび nullnamespaceSelector は、"この Pod の namespace" を意味します

topologyKey

string

この Pod は、指定された名前空間の labelSelector と一致する Pod と同じ場所に配置 (アフィニティー) するか、同じ場所に配置しない (アンチアフィニティー) 必要があります。ここで、同じ場所に配置されるのは、キー topologyKey を持つラベルの値を持つノードで実行されるものとして定義されます。選択した Pod のいずれかが実行されているノードのノードと一致します。空の topologyKey は許可されていません。

7.1.30. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector

説明
リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。
object
プロパティータイプ説明

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

7.1.31. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector.matchExpressions

説明
matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
array

7.1.32. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector.matchExpressions[]

説明
ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

7.1.33. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector

説明
用語が適用される名前空間のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての名前空間に一致します。
object
プロパティータイプ説明

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

7.1.34. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector.matchExpressions

説明
matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
array

7.1.35. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector.matchExpressions[]

説明
ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

7.1.36. .spec.affinity.podAntiAffinity

説明
Pod の非アフィニティースケジューリングルールを説明します (たとえば、この Pod を他の Pod と同じノード、ゾーンなどに配置しないでください)。
object
プロパティータイプ説明

preferredDuringSchedulingIgnoredDuringExecution

array

スケジューラーは、このフィールドで指定されたアンチアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アンチアフィニティー式など) を満たすノードごとに、の要素を反復処理して合計を計算します。このフィールドと、対応する podAffinityTerm に一致する Pod がノードにある場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。

preferredDuringSchedulingIgnoredDuringExecution[]

object

一致したすべての WeightedPodAffinityTerm フィールドの重みがノードごとに追加され、最も優先されるノードが検索されます。

requiredDuringSchedulingIgnoredDuringExecution

array

このフィールドで指定されたアンチアフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定されたアンチアフィニティー要件が Pod 実行中のある時点で満たされない場合 (Pod ラベルの更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。複数の要素がある場合、各 podAffinityTerm に対応するノードのリストが交差します。つまり、すべての用語が満たされる必要があります。

requiredDuringSchedulingIgnoredDuringExecution[]

object

この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。ここで、同じ場所は次のように定義されます。キー <topologyKey> のラベルの値が、Pod のセットの Pod が実行されているノードの値と一致するノードで実行されている

7.1.37. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution

説明
スケジューラーは、このフィールドで指定されたアンチアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アンチアフィニティー式など) を満たすノードごとに、の要素を反復処理して合計を計算します。このフィールドと、対応する podAffinityTerm に一致する Pod がノードにある場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。
タイプ
array

7.1.38. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[]

説明
一致したすべての WeightedPodAffinityTerm フィールドの重みがノードごとに追加され、最も優先されるノードが検索されます。
タイプ
object
必須
  • podAffinityTerm
  • weight
プロパティータイプ説明

podAffinityTerm

object

必須。対応する重みに関連付けられた Pod アフィニティー用語。

weight

integer

対応する podAffinityTerm の一致に関連する重み (1〜100 の範囲)。

7.1.39. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm

説明
必須。対応する重みに関連付けられた Pod アフィニティー用語。
object
必須
  • topologyKey
プロパティータイプ説明

labelSelector

object

リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。

matchLabelKeys

array (string)

MatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは key in (value) として labelSelector にマージされ、着信 Pod の Pod アフィニティー (アンチアフィニティー) として考慮される既存の Pod のグループを選択します。受信 Pod ラベルに存在しないキーは無視されます。デフォルト値は空です。同じキーが MatchLabelKeys と LabelSelector の両方に存在することはできません。また、labelSelector が設定されていない場合、matchLabelKeys は設定できません。これはアルファフィールドであり、MatchLabelKeysInPodAffinity フィーチャーゲートを有効にする必要があります。

mismatchLabelKeys

array (string)

MismatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは key notin (value) として labelSelector にマージされ、着信 Pod の Pod アフィニティー (アンチアフィニティー) として考慮される既存の Pod のグループを選択します。受信 Pod ラベルに存在しないキーは無視されます。デフォルト値は空です。mismatchLabelKeys と labelSelector の両方に同じキーが存在することは禁止されています。また、labelSelector が設定されていない場合、mismatchLabelKeys は設定できません。これはアルファフィールドであり、MatchLabelKeysInPodAffinity フィーチャーゲートを有効にする必要があります。

namespaceSelector

object

用語が適用される名前空間のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての名前空間に一致します。

namespace

array (string)

namespaces は、用語が適用される名前空間名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび nullnamespaceSelector は、"この Pod の namespace" を意味します

topologyKey

string

この Pod は、指定された名前空間の labelSelector と一致する Pod と同じ場所に配置 (アフィニティー) するか、同じ場所に配置しない (アンチアフィニティー) 必要があります。ここで、同じ場所に配置されるのは、キー topologyKey を持つラベルの値を持つノードで実行されるものとして定義されます。選択した Pod のいずれかが実行されているノードのノードと一致します。空の topologyKey は許可されていません。

7.1.40. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector

説明
リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。
object
プロパティータイプ説明

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

7.1.41. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector.matchExpressions

説明
matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
array

7.1.42. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector.matchExpressions[]

説明
ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

7.1.43. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector

説明
用語が適用される名前空間のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての名前空間に一致します。
object
プロパティータイプ説明

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

7.1.44. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector.matchExpressions

説明
matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
array

7.1.45. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector.matchExpressions[]

説明
ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

7.1.46. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution

説明
このフィールドで指定されたアンチアフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定されたアンチアフィニティー要件が Pod 実行中のある時点で満たされない場合 (Pod ラベルの更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。複数の要素がある場合、各 podAffinityTerm に対応するノードのリストが交差します。つまり、すべての用語が満たされる必要があります。
タイプ
array

7.1.47. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[]

説明
この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。ここで、同じ場所は次のように定義されます。キー <topologyKey> のラベルの値が、Pod のセットの Pod が実行されているノードの値と一致するノードで実行されている
タイプ
object
必須
  • topologyKey
プロパティータイプ説明

labelSelector

object

リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。

matchLabelKeys

array (string)

MatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは key in (value) として labelSelector にマージされ、着信 Pod の Pod アフィニティー (アンチアフィニティー) として考慮される既存の Pod のグループを選択します。受信 Pod ラベルに存在しないキーは無視されます。デフォルト値は空です。同じキーが MatchLabelKeys と LabelSelector の両方に存在することはできません。また、labelSelector が設定されていない場合、matchLabelKeys は設定できません。これはアルファフィールドであり、MatchLabelKeysInPodAffinity フィーチャーゲートを有効にする必要があります。

mismatchLabelKeys

array (string)

MismatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは key notin (value) として labelSelector にマージされ、着信 Pod の Pod アフィニティー (アンチアフィニティー) として考慮される既存の Pod のグループを選択します。受信 Pod ラベルに存在しないキーは無視されます。デフォルト値は空です。mismatchLabelKeys と labelSelector の両方に同じキーが存在することは禁止されています。また、labelSelector が設定されていない場合、mismatchLabelKeys は設定できません。これはアルファフィールドであり、MatchLabelKeysInPodAffinity フィーチャーゲートを有効にする必要があります。

namespaceSelector

object

用語が適用される名前空間のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての名前空間に一致します。

namespace

array (string)

namespaces は、用語が適用される名前空間名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび nullnamespaceSelector は、"この Pod の namespace" を意味します

topologyKey

string

この Pod は、指定された名前空間の labelSelector と一致する Pod と同じ場所に配置 (アフィニティー) するか、同じ場所に配置しない (アンチアフィニティー) 必要があります。ここで、同じ場所に配置されるのは、キー topologyKey を持つラベルの値を持つノードで実行されるものとして定義されます。選択した Pod のいずれかが実行されているノードのノードと一致します。空の topologyKey は許可されていません。

7.1.48. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector

説明
リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。
object
プロパティータイプ説明

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

7.1.49. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector.matchExpressions

説明
matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
array

7.1.50. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector.matchExpressions[]

説明
ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

7.1.51. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector

説明
用語が適用される名前空間のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての名前空間に一致します。
object
プロパティータイプ説明

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

7.1.52. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector.matchExpressions

説明
matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
array

7.1.53. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector.matchExpressions[]

説明
ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

7.1.54. .spec.proxy

説明
proxy は、マスター API、アップストリームレジストリーなどを呼び出すときに使用されるプロキシーを定義します。
object
プロパティータイプ説明

http

string

http は、HTTP エンドポイントにアクセスするときにイメージレジストリーによって使用されるプロキシーを定義します。

https

string

https は、HTTPS エンドポイントにアクセスするときにイメージレジストリーによって使用されるプロキシーを定義します。

noProxy

string

noProxy は、プロキシーを通過してはならないホスト名のコンマ区切りリストを定義します。

7.1.55. .spec.requests

説明
指定されたレジストリーインスタンスが追加リソースをキューに入れる前に処理する並列要求の数を制御します。
object
プロパティータイプ説明

read

object

read は、イメージレジストリーの読み取りの制限を定義します。

write

object

write は、イメージレジストリーの書き込みの制限を定義します。

7.1.56. .spec.requests.read

説明
read は、イメージレジストリーの読み取りの制限を定義します。
object
プロパティータイプ説明

maxInQueue

integer

maxInQueue は、キューに入れられた API リクエストの最大数をレジストリーに設定します。

maxRunning

integer

maxRunning は、飛行中の API リクエストの最大数をレジストリーに設定します。

maxWaitInQueue

string

maxWaitInQueue は、リクエストが拒否される前にキューで待機できる最大時間を設定します。

7.1.57. .spec.requests.write

説明
write は、イメージレジストリーの書き込みの制限を定義します。
object
プロパティータイプ説明

maxInQueue

integer

maxInQueue は、キューに入れられた API リクエストの最大数をレジストリーに設定します。

maxRunning

integer

maxRunning は、飛行中の API リクエストの最大数をレジストリーに設定します。

maxWaitInQueue

string

maxWaitInQueue は、リクエストが拒否される前にキューで待機できる最大時間を設定します。

7.1.58. .spec.resources

説明
resources は、レジストリー Pod のリソースリクエストと制限を定義します。
object
プロパティータイプ説明

claims

array

Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。このフィールドは不変です。これはコンテナーにのみ設定できます。

claims[]

object

ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。

limits

integer-or-string

limits は、許可されるコンピュートリソースの最大量を示します。詳細: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

requests

integer-or-string

requests は、必要なコンピュートリソースの最小量を示します。コンテナーについて Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

7.1.59. .spec.resources.claims

説明
Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。このフィールドは不変です。これはコンテナーにのみ設定できます。
タイプ
array

7.1.60. .spec.resources.claims[]

説明
ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。
タイプ
object
必須
  • name
プロパティータイプ説明

name

string

Name must match the name of one entry in pod.spec.resourceClaims of the Pod where this field is used.これにより、そのリソースがコンテナー内で利用可能になります。

7.1.61. .spec.routes

説明
ルートは、レジストリー用に作成する必要がある追加の外部向けルートを定義します。
array

7.1.62. .spec.routes[]

説明
ImageRegistryConfigRoute は、イメージレジストリーへの外部ルートアクセスに関する情報を保持します。
object
必須
  • name
プロパティータイプ説明

hostname

string

ルートのホスト名。

name

string

作成するルートの名前。

secretName

string

secretName は、ルートで使用される証明書を含むシークレットを指します。

7.1.63. .spec.storage

説明
レジストリーストレージを設定するためのストレージの詳細 (S3 バケット座標など)。
object
プロパティータイプ説明

azure

object

azure は、Azure Blob Storage を使用する設定を表します。

emptyDir

object

emptyDir は、Pod のホストノード上のエフェメラルストレージを表します。警告: このストレージは複数のレプリカで使用することはできず、本番環境での使用には適していません。Pod が何らかの理由でノードから削除されると、emptyDir のデータは完全に削除されます。

gcs

object

gcs は、Google Cloud Storage を使用する設定を表します。

ibmcos

object

ibmcos は、IBM Cloud Object Storage を使用する設定を表します。

managementState

string

managementState は、Operator が基礎となるストレージ装置を管理しているかどうかを示します。マネージドの場合、この Operator が削除されると、Operator はストレージを削除します。

oss

object

Oss は、Alibaba Cloud Object Storage Service を使用する設定を表します。

pvc

object

pvc は、PersistentVolumeClaim を使用する設定を表します。

s3

object

s3 は、Amazon Simple Storage Service を使用する設定を表します。

swift

object

swift は、OpenStack Object Storage を使用する設定を表します。

7.1.64. .spec.storage.azure

説明
azure は、Azure Blob Storage を使用する設定を表します。
object
プロパティータイプ説明

accountName

string

accountName は、レジストリーで使用されるアカウントを定義します。

cloudName

string

cloudName は、レジストリーで使用される Azure クラウド環境の名前です。空の場合、Operator はインフラストラクチャーオブジェクトに基づいて設定します。

container

string

コンテナーは、レジストリーで使用される Azure のコンテナーを定義します。

networkAccess

object

networkAccess は、ストレージアカウントのネットワークアクセスプロパティーを定義します。デフォルトのタイプは External です。

7.1.65. .spec.storage.azure.networkAccess

説明
networkAccess は、ストレージアカウントのネットワークアクセスプロパティーを定義します。デフォルトのタイプは External です。
object
プロパティータイプ説明

internal

object

internal は、プライベートエンドポイントを設定し、それをストレージアカウントに接続してプライベートにするための vnet 名とサブネット名を定義します。type: Internal および internal が設定されていない場合、Image Registry Operator が vnet 名とサブネット名を検出し、プライベートエンドポイント名を生成します。

type

string

type は、ストレージアカウントに使用するネットワークアクセスレベルです。type: Internal の場合、ストレージアカウントがプライベートになります。type: External の場合、ストレージアカウントがパブリックにアクセス可能になります。Internal ストレージアカウントは、クラスターの vnet 内でのみ公開されます。External ストレージアカウントは、インターネット上で公開されます。type: Internal を使用する場合、vnetName、subNetName、privateEndpointName を必要に応じて指定できます。指定されていない場合、Image Registry Operator が vnet とサブネット名を検出し、privateEndpointName を生成します。デフォルトは "External" です。

7.1.66. .spec.storage.azure.networkAccess.internal

説明
internal は、プライベートエンドポイントを設定し、それをストレージアカウントに接続してプライベートにするための vnet 名とサブネット名を定義します。type: Internal および internal が設定されていない場合、Image Registry Operator が vnet 名とサブネット名を検出し、プライベートエンドポイント名を生成します。
object
プロパティータイプ説明

networkResourceGroupName

string

networkResourceGroupName は、クラスターの vnet とサブネットが存在するリソースグループ名です。省略すると、レジストリー Operator が (インフラストラクチャーステータス内の) クラスターリソースグループを使用します。install-config.yaml に networkResourceGroupName を設定すると、その値が自動的に使用されます (publish:Internal で設定されたクラスターの場合)。vnet とサブネットの両方が同じリソースグループ内にある必要があることに注意してください。1 - 90 文字の長さで、英数字、ハイフン (-)、ピリオド (.)、アンダースコア (_) のみで構成する必要があります。末尾をピリオドにすることはできません。

privateEndpointName

string

privateEndpointName は、レジストリーのプライベートエンドポイントの名前です。指定すると、レジストリーでこの名前がストレージアカウント用に作成するプライベートエンドポイントの名前として使用されます。省略すると、レジストリーによって名前が生成されます。2 - 64 文字の長さで、英数字、ハイフン (-)、ピリオド (.)、アンダースコア (_) のみで構成する必要があります。先頭を英数字に、末尾を英数字またはアンダースコアにする必要があります。

subnetName

string

subnetName は、レジストリーが動作するサブネットの名前です。省略した場合、レジストリー Operator が、vnet リソース内の kubernetes.io_cluster.<cluster-id> タグを使用してこれを検出および設定し、リストされているサブネットの 1 つを使用します。ネットワークセキュリティーグループを使用してサブネットを保護する高度なクラスターネットワーク設定では、指定する subnetName が Azure Storage サービスにアクセスできることを確認する必要があります。1 - 80 文字の長さで、英数字、ハイフン (-)、ピリオド (.)、アンダースコア (_) のみで構成する必要があります。

vnetName

string

vnetName は、レジストリーが動作する vnet の名前です。省略した場合、レジストリー Operator が、vnet リソース内の kubernetes.io_cluster.<cluster-id> タグを使用してこれを検出および設定します。このタグはインストーラーによって自動的に設定されます。通常、これはクラスターと同じ vnet になります。高度なクラスターネットワーク設定では、指定する vnetName が、イメージレジストリー Pod が実行されているノードの vnet であることを確認する必要があります。2 - 64 文字の長さで、英数字、ハイフン (-)、ピリオド (.)、アンダースコア (_) のみで構成する必要があります。先頭を英数字に、末尾を英数字またはアンダースコアにする必要があります。

7.1.67. .spec.storage.emptyDir

説明
emptyDir は、Pod のホストノード上のエフェメラルストレージを表します。警告: このストレージは複数のレプリカで使用することはできず、本番環境での使用には適していません。Pod が何らかの理由でノードから削除されると、emptyDir のデータは完全に削除されます。
object

7.1.68. .spec.storage.gcs

説明
gcs は、Google Cloud Storage を使用する設定を表します。
object
プロパティータイプ説明

bucket

string

バケットは、レジストリーのデータを保存するバケット名です。オプションで、提供されていない場合は生成されます。

keyID

string

keyID は、暗号化に使用する KMS キー ID です。オプションで、バケットは GCP でデフォルトで暗号化されます。これにより、カスタム暗号化キーを使用できます。

projectID

string

projectID は、このバケットが関連付けられる必要がある GCP プロジェクトのプロジェクト ID です。

region

string

リージョンは、バケットが存在する GCS の場所です。オプションで、インストールされている GCS リージョンに基づいて設定されます。

7.1.69. .spec.storage.ibmcos

説明
ibmcos は、IBM Cloud Object Storage を使用する設定を表します。
object
プロパティータイプ説明

bucket

string

バケットは、レジストリーのデータを保存するバケット名です。オプションで、提供されていない場合は生成されます。

location

string

location は、バケットが存在する IBM Cloud の場所です。オプションで、インストールされている IBM Cloud の場所に基づいて設定されます。

resourceGroupName

string

resourceGroupName は、このバケットとそのサービスインスタンスが関連付けられている IBM Cloud リソースグループの名前です。オプションで、インストールされている IBM Cloud リソースグループに基づいて設定されます。

resourceKeyCRN

string

resourceKeyCRN は、サービスインスタンス用に作成された IBM Cloud リソースキーの CRN です。一般にサービスクレデンシャルと呼ばれ、HMAC タイプのクレデンシャルが含まれている必要があります。オプションで、提供されていない場合は計算されます。

serviceInstanceCRN

string

serviceInstanceCRN は、このバケットが関連付けられている IBM Cloud Object Storage サービスインスタンスの CRN です。オプションで、提供されていない場合は計算されます。

7.1.70. .spec.storage.oss

説明
Oss は、Alibaba Cloud Object Storage Service を使用する設定を表します。
object
プロパティータイプ説明

bucket

string

Bucket は、レジストリーのデータを保存するバケット名です。バケットの命名の詳細は、[公式ドキュメント](https://www.alibabacloud.com/help/doc-detail/257087.htm) で確認できます。値が空の場合、指定なしとみなされ、プラットフォームによってデフォルトが選択されます。デフォルトは、今後変更される可能性があります。現在、デフォルトは <clusterid>-image-registry-<リージョン>-<ランダムな 27 文字の文字列> という形式で自動生成されます。

encryption

object

Encryption は、サーバー側でデータを暗号化するかどうかを指定します。詳細は、[公式ドキュメント] (https://www.alibabacloud.com/help/doc-detail/117914.htm) を参照してください。

endpointAccessibility

string

EndpointAccessibility は、レジストリーが OSS VPC 内部エンドポイントを使用するかどうかを指定します。値が空の場合、指定なしとみなされ、プラットフォームによってデフォルトが選択されます。デフォルトは、今後変更される可能性があります。現在、デフォルトは Internal です。

region

string

Region は、バケットが存在する Alibaba Cloud リージョンです。リージョンのリストは、[公式ドキュメント](https://www.alibabacloud.com/help/doc-detail/31837.html) を参照してください。値が空の場合、指定なしとみなされ、プラットフォームによってデフォルトが選択されます。デフォルトは、今後変更される可能性があります。現在、デフォルトはインストールされている Alibaba Cloud リージョンに基づいています。

7.1.71. .spec.storage.oss.encryption

説明
Encryption は、サーバー側でデータを暗号化するかどうかを指定します。詳細は、[公式ドキュメント] (https://www.alibabacloud.com/help/doc-detail/117914.htm) を参照してください。
object
プロパティータイプ説明

kms

object

KMS (キー管理サービス) は、KMS KeyID の構造体を保持する暗号化タイプです。

method

string

Method は、利用可能なさまざまな暗号化モードを定義します。値が空の場合、指定なしとみなされ、プラットフォームによってデフォルトが選択されます。デフォルトは、今後変更される可能性があります。現在、デフォルトは AES256 です。

7.1.72. .spec.storage.oss.encryption.kms

説明
KMS (キー管理サービス) は、KMS KeyID の構造体を保持する暗号化タイプです。
object
必須
  • keyID
プロパティータイプ説明

keyID

string

KeyID は、KMS の暗号鍵 ID を保持します。

7.1.73. .spec.storage.pvc

説明
pvc は、PersistentVolumeClaim を使用する設定を表します。
object
プロパティータイプ説明

claim

string

クレームは、使用される永続ボリュームクレームの名前を定義します。

7.1.74. .spec.storage.s3

説明
s3 は、Amazon Simple Storage Service を使用する設定を表します。
object
プロパティータイプ説明

bucket

string

バケットは、レジストリーのデータを保存するバケット名です。オプションで、提供されていない場合は生成されます。

cloudFront

object

cloudFront は Amazon Cloudfront をレジストリーでストレージミドルウェアとして設定します。

encrypt

boolean

encrypt は、イメージが暗号化された形式で保存されるかどうかを指定します。オプションで、デフォルトは false です。

keyID

string

keyID は、暗号化に使用する KMS キー ID です。オプションで、暗号化は true である必要があります。そうでない場合、このパラメーターは無視されます。

region

string

リージョンはバケットが存在する AWS リージョンです。オプションで、インストールされている AWS リージョンに基づいて設定されます。

regionEndpoint

string

regionEndpoint は、S3 互換のストレージサービスのエンドポイントです。スキームを含む有効な URL である必要があります (例: https://s3.example.com)。オプションで、提供される地域に基づくデフォルト。

trustedCA

object

trustedCA は、CA バンドルを含む config map への参照です。イメージレジストリーとその Operator が、このバンドルの証明書を使用して S3 サーバー証明書を検証します。trustedCA によって参照される config map の namespace は、"openshift-config" です。config map 内のバンドルのキーは、"ca-bundle.crt" です。

virtualHostedStyle

boolean

virtualHostedStyle を使用すると、カスタムの RegionEndpoint オプションで S3 仮想ホストスタイルバケットパスを使用できます。デフォルトは false です。

7.1.75. .spec.storage.s3.cloudFront

説明
cloudFront は Amazon Cloudfront をレジストリーでストレージミドルウェアとして設定します。
object
必須
  • baseURL
  • keypairID
  • privateKey
プロパティータイプ説明

baseURL

string

baseURL には、Cloudfront が提供される SCHEME://HOST[/PATH] が含まれています。

duration

string

duration は、Cloudfront セッションの継続時間です。

keypairID

string

keypairID は、AWS が提供するキーペア ID です。

privateKey

object

privateKey は、AWS が提供する秘密鍵を含むシークレットを指します。

7.1.76. .spec.storage.s3.cloudFront.privateKey

説明
privateKey は、AWS が提供する秘密鍵を含むシークレットを指します。
object
必須
  • key
プロパティータイプ説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

任意

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

7.1.77. .spec.storage.s3.trustedCA

説明
trustedCA は、CA バンドルを含む config map への参照です。イメージレジストリーとその Operator が、このバンドルの証明書を使用して S3 サーバー証明書を検証します。trustedCA によって参照される config map の namespace は、"openshift-config" です。config map 内のバンドルのキーは、"ca-bundle.crt" です。
object
プロパティータイプ説明

name

string

name は、参照される config map の metadata.name です。このフィールドは、標準の config map の命名制限に準拠する必要があります。名前は、英数字、ハイフン (-)、ピリオド (.) のみで構成する必要があります。最大長は 253 文字です。このフィールドが指定されていないか、空の文字列である場合、デフォルトのトラストバンドルが使用されます。

7.1.78. .spec.storage.swift

説明
swift は、OpenStack Object Storage を使用する設定を表します。
object
プロパティータイプ説明

authURL

string

authURL は、認証トークンを取得するための URL を定義します。

authVersion

string

authVersion は、OpenStack Auth のバージョンを指定します。

container

string

container は、レジストリーのデータを格納する Swift コンテナーの名前を定義します。

domain

string

domain は、Identityv3API の Openstack のドメイン名を指定します。

domainID

string

domainID は、Identityv3API の Openstack のドメイン ID を指定します。

regionName

string

regionName は、コンテナーが存在する Openstack のリージョンを定義します。

tenant

string

テナントは、レジストリーが使用する Openstack テナント名を定義します。

tenantID

string

テナントは、レジストリーが使用する Openstack テナント ID を定義します。

7.1.79. .spec.tolerations

説明
tolerations は、レジストリー Pod の許容値を定義します。
array

7.1.80. .spec.tolerations[]

説明
この toleration が割り当てられる Pod は、マッチング Operator <operator> を使用してトリプル <key,value,effect> と一致するテイントを許容します。
タイプ
object
プロパティータイプ説明

effect

string

effect は、照合するテイントの効果を示します。空の場合は、すべてのテイント効果に一致します。指定されている場合、許可される値は NoSchedule、PreferNoSchedule、および NoExecute です。

key

string

key は toleration が適用されるテイントキーです。空の場合は、すべてのテイントキーに一致します。キーが空の場合、Operator は Exists である必要があります。この組み合わせは、すべての値とすべてのキーに一致することを意味します。

operator

string

Operator はキーと値の関係を表します。有効な Operator は Exists および Equal です。デフォルトは Equal です。Exists は、値のワイルドカードと同等であるため、Pod は特定のカテゴリーのすべてのテイントに耐えることができます。

tolerationSeconds

integer

tolerationSeconds は、toleration (effect は NoExecute でなければならず、NoExecute 以外の場合このフィールドは無視されます) がテイントを許容する期間を表します。デフォルトでは設定されていません。つまり、テイントを永久に許容します (エビクトしないでください)。ゼロ値と負の値は、システムによって 0 (すぐにエビクト) として扱われます。

value

string

value は、toleration が一致するテイントの値です。Operator が Exists の場合、値は空である必要があります。それ以外の場合は、通常の文字列のみになります。

7.1.81. .spec.topologySpreadConstraints

説明
topologySpreadConstraints は、一致する Pod を特定のトポロジー内でどのように分散するかを指定します。
array

7.1.82. .spec.topologySpreadConstraints[]

説明
topologySpreadConstraint は、指定されたトポロジー間で一致する Pod を分散する方法を指定します。
タイプ
object
必須
  • maxSkew
  • topologyKey
  • whenUnsatisfiable
プロパティータイプ説明

labelSelector

object

LabelSelector は、一致する Pod を見つけるために使用されます。このラベルセレクターに一致する Pod は、対応するトポロジードメイン内の Pod の数を決定するためにカウントされます。

matchLabelKeys

array (string)

MatchLabelKeys は、分散を計算する Pod を選択するための Pod ラベルキーのセットです。このようなキーは受信 Pod のラベルから値を検索するために使用され、このキーと値のラベルは labelSelector と AND 演算されて、受信 Pod の分散が計算される既存の Pod のグループを選択します。同じキーが MatchLabelKeys と LabelSelector の両方に存在することはできません。LabelSelector が設定されていないと、MatchLabelKeys は設定できません。受信 Pod ラベルに存在しないキーは無視されます。null または空のリストは、labelSelector とのみ一致することを意味します。これはベータフィールドであり、MatchLabelKeysInPodTopologySpread フィーチャーゲートを有効にする必要があります (デフォルトで有効)。

maxSkew

integer

MaxSkew は、Pod が不均一に分布している可能性の程度を表します。whenUnsatisfiable = DoNotSchedule の場合、これは、ターゲットトポロジー内の一致する Pod の数とグローバル最小値との間の最大許容差です。グローバル最小値は、適格なドメイン内で一致する Pod の最小数です。または、適格なドメインの数が MinDomains 未満の場合はゼロになります。たとえば、3 ゾーンクラスターでは、MaxSkew が 1 に設定され、同じ labelSelector を持つ Pod は 2/2/1 に分散されます。この場合、グローバル最小値は 1 です。| zone1 | zone2 | zone3 | | P P | P P | P | - MaxSkew が 1 の場合、受信 Pod は 2/2/2 になるように zone 3 にのみスケジュールできます。これを zone1(zone2) にスケジュールすると、zone1(zone2) の ActualSkew(3-1) が MaxSkew(1) に違反します。- MaxSkew が 2 の場合、受信 Pod を任意のゾーンにスケジュールできます。whenUnsatisfiable = ScheduleAnyway の場合、それを満たすトポロジーに高い優先順位を与えるために使用されます。必須フィールドです。デフォルト値は 1 で、0 は許可されていません。

minDomains

integer

MinDomains は、対象となるドメインの最小数を示します。トポロジーキーが一致する適格なドメインの数が minDomains より少ない場合、Pod Topology Spread は "グローバル最小値" を 0 として扱い、スキューの計算が実行されます。また、トポロジーキーが一致する適格なドメインの数が minDomains の数以上の場合、この値はスケジュールに影響しません。その結果、対象となるドメインの数が minDomains より少ない場合、スケジューラーはそれらのドメインに対して maxSkew を超える Pod をスケジュールしません。値が nil の場合、制約は MinDomains が 1 と等しいかのように動作します。有効な値は 0 より大きい整数です。値が nil でない場合、WhenUnsatisfiable は DoNotSchedule でなければなりません。たとえば、3 ゾーンクラスターの場合、MaxSkew は 2 に設定され、MinDomains は 5 に設定され、同じ labelSelector を持つ Pod は 2/2/2 に分散されます ( | zone1 | zone2 | zone3 | | P P | P | P | P P | P P | P P | P |)。ドメインの数は 5 (MinDomains 未満) であるため、"global minimum" は 0 として扱われます。このような場合、同じ labelSelector を持つ新しい Pod をスケジュールすることはできません。新しい Pod が 3 つのゾーンのいずれかにスケジュールされている場合、スキューは 3(3 - 0) と計算され、MaxSkew に違反するためです。これはベータフィールドであり、MinDomainsInPodTopologySpread フィーチャーゲートを有効にする必要があります (デフォルトで有効)。

nodeAffinityPolicy

string

nodeAffinityPolicy は、Pod トポロジーの分散スキューを計算するときに Pod の nodeAffinity/nodeSelector をどのように扱うかを示します。オプションは - Honor: nodeAffinity/nodeSelector に一致するノードのみが計算に含まれます。- Ignore: nodeAffinity/nodeSelector は無視されます。すべてのノードが計算に含まれます。この値が nil の場合、この動作は Honor ポリシーと同じです。これは、NodeInclusionPolicyInPodTopologySpread 機能フラグによってデフォルトで有効になるベータレベルの機能です。

nodeTaintsPolicy

string

NodeTaintsPolicy は、Pod トポロジースプレッドスキューを計算するときにノードのテイントを処理する方法を示します。オプション: - Honor: テイントのないノードと、受信 Pod が許容範囲でテイントがあるノードが含まれます。- Ignore: ノードのテイントは無視されます。すべてのノードが含まれます。この値が nil の場合、この動作は Ignore ポリシーと同じです。これは、NodeInclusionPolicyInPodTopologySpread 機能フラグによってデフォルトで有効になるベータレベルの機能です。

topologyKey

string

TopologyKey は、ノードラベルのキーです。このキーと同じ値のラベルを持つノードは、同じトポロジーにあると見なされます。各 <key, value> を "バケット" と見なし、バランスの取れた数の Pod を各バケットに配置しようとします。ドメインをトポロジーの特定のインスタンスとして定義します。また、ノードが nodeAffinityPolicy および nodeTaintsPolicy の要件を満たすドメインとして、適格なドメインを定義します。たとえば、TopologyKey が "kubernetes.io/hostname" の場合、各ノードはそのトポロジーのドメインです。また、TopologyKey が "topology.kubernetes.io/zone" の場合は、各ゾーンがそのトポロジーのドメインになります。必須フィールドです。

whenUnsatisfiable

string

WhenUnsatisfiable は、スプレッドの制約を満たさない場合に Pod を処理する方法を示します。-DoNotSchedule (デフォルト) は、スケジューラーにスケジュールしないように指示します。--ScheduleAnyway は、任意の場所で Pod をスケジュールするようにスケジューラーに指示しますが、スキューを減らすのに役立つトポロジーに高い優先順位を与えます。受信 Pod に対する制約は、対象となる Pod へのノード割り当て候補すべてがトポロジーの一部の "MaxSkew" に違反する場合に、"Unsatisfiable" とみなされます。たとえば、3 ゾーンクラスターでは、MaxSkew は 1 に設定され、labelSelector が同じ Pod は 3/1/1 ( | zone1 | zone2 | zone3 | | P P P | P | P |) に分散されます。WhenUnsatisfiable が DoNotSchedule に設定されている場合、zone2(zone3) の ActualSkew(2-1) が MaxSkew(1) を満たすため、受信 Pod は zone2(zone3) にのみスケジュールして 3/2/1(3/1/2) になります。つまり、クラスターは依然として不均衡である可能性がありますが、スケジューラーによってクラスターが さらに 不均衡になることはありません。必須フィールドです。

7.1.83. .spec.topologySpreadConstraints[].labelSelector

説明
LabelSelector は、一致する Pod を見つけるために使用されます。このラベルセレクターに一致する Pod は、対応するトポロジードメイン内の Pod の数を決定するためにカウントされます。
object
プロパティータイプ説明

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

7.1.84. .spec.topologySpreadConstraints[].labelSelector.matchExpressions

説明
matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
array

7.1.85. .spec.topologySpreadConstraints[].labelSelector.matchExpressions[]

説明
ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

7.1.86. .status

説明
ImageRegistryStatus は、イメージレジストリーの動作ステータスを報告します。
object
必須
  • storage
  • storageManaged
プロパティータイプ説明

conditions

array

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

conditions[]

object

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

generations

array

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

generations[]

object

GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。

observedGeneration

integer

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

readyReplicas

integer

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

storage

object

storage は、レジストリーの現在適用されているストレージ設定を示します。

storageManaged

boolean

storageManaged は非推奨です。Storage.managementState を参照してください

version

string

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

7.1.87. .status.conditions

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

7.1.88. .status.conditions[]

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

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

7.1.89. .status.generations

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

7.1.90. .status.generations[]

説明
GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。
object
プロパティータイプ説明

group

string

グループはあなたが追跡しているもののグループです

ハッシュ

string

ハッシュは、シークレットや設定マップのようにコンテンツに依存する、生成されないリソース用に設定されたオプションのフィールドです。

lastGeneration

integer

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

name

string

name は、追跡しているものの名前です

namespace

string

名前空間は、追跡しているものがどこにあるかです

resource

string

リソースは、追跡しているもののリソースタイプです

7.1.91. .status.storage

説明
storage は、レジストリーの現在適用されているストレージ設定を示します。
object
プロパティータイプ説明

azure

object

azure は、Azure Blob Storage を使用する設定を表します。

emptyDir

object

emptyDir は、Pod のホストノード上のエフェメラルストレージを表します。警告: このストレージは複数のレプリカで使用することはできず、本番環境での使用には適していません。Pod が何らかの理由でノードから削除されると、emptyDir のデータは完全に削除されます。

gcs

object

gcs は、Google Cloud Storage を使用する設定を表します。

ibmcos

object

ibmcos は、IBM Cloud Object Storage を使用する設定を表します。

managementState

string

managementState は、Operator が基礎となるストレージ装置を管理しているかどうかを示します。マネージドの場合、この Operator が削除されると、Operator はストレージを削除します。

oss

object

Oss は、Alibaba Cloud Object Storage Service を使用する設定を表します。

pvc

object

pvc は、PersistentVolumeClaim を使用する設定を表します。

s3

object

s3 は、Amazon Simple Storage Service を使用する設定を表します。

swift

object

swift は、OpenStack Object Storage を使用する設定を表します。

7.1.92. .status.storage.azure

説明
azure は、Azure Blob Storage を使用する設定を表します。
object
プロパティータイプ説明

accountName

string

accountName は、レジストリーで使用されるアカウントを定義します。

cloudName

string

cloudName は、レジストリーで使用される Azure クラウド環境の名前です。空の場合、Operator はインフラストラクチャーオブジェクトに基づいて設定します。

container

string

コンテナーは、レジストリーで使用される Azure のコンテナーを定義します。

networkAccess

object

networkAccess は、ストレージアカウントのネットワークアクセスプロパティーを定義します。デフォルトのタイプは External です。

7.1.93. .status.storage.azure.networkAccess

説明
networkAccess は、ストレージアカウントのネットワークアクセスプロパティーを定義します。デフォルトのタイプは External です。
object
プロパティータイプ説明

internal

object

internal は、プライベートエンドポイントを設定し、それをストレージアカウントに接続してプライベートにするための vnet 名とサブネット名を定義します。type: Internal および internal が設定されていない場合、Image Registry Operator が vnet 名とサブネット名を検出し、プライベートエンドポイント名を生成します。

type

string

type は、ストレージアカウントに使用するネットワークアクセスレベルです。type: Internal の場合、ストレージアカウントがプライベートになります。type: External の場合、ストレージアカウントがパブリックにアクセス可能になります。Internal ストレージアカウントは、クラスターの vnet 内でのみ公開されます。External ストレージアカウントは、インターネット上で公開されます。type: Internal を使用する場合、vnetName、subNetName、privateEndpointName を必要に応じて指定できます。指定されていない場合、Image Registry Operator が vnet とサブネット名を検出し、privateEndpointName を生成します。デフォルトは "External" です。

7.1.94. .status.storage.azure.networkAccess.internal

説明
internal は、プライベートエンドポイントを設定し、それをストレージアカウントに接続してプライベートにするための vnet 名とサブネット名を定義します。type: Internal および internal が設定されていない場合、Image Registry Operator が vnet 名とサブネット名を検出し、プライベートエンドポイント名を生成します。
object
プロパティータイプ説明

networkResourceGroupName

string

networkResourceGroupName は、クラスターの vnet とサブネットが存在するリソースグループ名です。省略すると、レジストリー Operator が (インフラストラクチャーステータス内の) クラスターリソースグループを使用します。install-config.yaml に networkResourceGroupName を設定すると、その値が自動的に使用されます (publish:Internal で設定されたクラスターの場合)。vnet とサブネットの両方が同じリソースグループ内にある必要があることに注意してください。1 - 90 文字の長さで、英数字、ハイフン (-)、ピリオド (.)、アンダースコア (_) のみで構成する必要があります。末尾をピリオドにすることはできません。

privateEndpointName

string

privateEndpointName は、レジストリーのプライベートエンドポイントの名前です。指定すると、レジストリーでこの名前がストレージアカウント用に作成するプライベートエンドポイントの名前として使用されます。省略すると、レジストリーによって名前が生成されます。2 - 64 文字の長さで、英数字、ハイフン (-)、ピリオド (.)、アンダースコア (_) のみで構成する必要があります。先頭を英数字に、末尾を英数字またはアンダースコアにする必要があります。

subnetName

string

subnetName は、レジストリーが動作するサブネットの名前です。省略した場合、レジストリー Operator が、vnet リソース内の kubernetes.io_cluster.<cluster-id> タグを使用してこれを検出および設定し、リストされているサブネットの 1 つを使用します。ネットワークセキュリティーグループを使用してサブネットを保護する高度なクラスターネットワーク設定では、指定する subnetName が Azure Storage サービスにアクセスできることを確認する必要があります。1 - 80 文字の長さで、英数字、ハイフン (-)、ピリオド (.)、アンダースコア (_) のみで構成する必要があります。

vnetName

string

vnetName は、レジストリーが動作する vnet の名前です。省略した場合、レジストリー Operator が、vnet リソース内の kubernetes.io_cluster.<cluster-id> タグを使用してこれを検出および設定します。このタグはインストーラーによって自動的に設定されます。通常、これはクラスターと同じ vnet になります。高度なクラスターネットワーク設定では、指定する vnetName が、イメージレジストリー Pod が実行されているノードの vnet であることを確認する必要があります。2 - 64 文字の長さで、英数字、ハイフン (-)、ピリオド (.)、アンダースコア (_) のみで構成する必要があります。先頭を英数字に、末尾を英数字またはアンダースコアにする必要があります。

7.1.95. .status.storage.emptyDir

説明
emptyDir は、Pod のホストノード上のエフェメラルストレージを表します。警告: このストレージは複数のレプリカで使用することはできず、本番環境での使用には適していません。Pod が何らかの理由でノードから削除されると、emptyDir のデータは完全に削除されます。
object

7.1.96. .status.storage.gcs

説明
gcs は、Google Cloud Storage を使用する設定を表します。
object
プロパティータイプ説明

bucket

string

バケットは、レジストリーのデータを保存するバケット名です。オプションで、提供されていない場合は生成されます。

keyID

string

keyID は、暗号化に使用する KMS キー ID です。オプションで、バケットは GCP でデフォルトで暗号化されます。これにより、カスタム暗号化キーを使用できます。

projectID

string

projectID は、このバケットが関連付けられる必要がある GCP プロジェクトのプロジェクト ID です。

region

string

リージョンは、バケットが存在する GCS の場所です。オプションで、インストールされている GCS リージョンに基づいて設定されます。

7.1.97. .status.storage.ibmcos

説明
ibmcos は、IBM Cloud Object Storage を使用する設定を表します。
object
プロパティータイプ説明

bucket

string

バケットは、レジストリーのデータを保存するバケット名です。オプションで、提供されていない場合は生成されます。

location

string

location は、バケットが存在する IBM Cloud の場所です。オプションで、インストールされている IBM Cloud の場所に基づいて設定されます。

resourceGroupName

string

resourceGroupName は、このバケットとそのサービスインスタンスが関連付けられている IBM Cloud リソースグループの名前です。オプションで、インストールされている IBM Cloud リソースグループに基づいて設定されます。

resourceKeyCRN

string

resourceKeyCRN は、サービスインスタンス用に作成された IBM Cloud リソースキーの CRN です。一般にサービスクレデンシャルと呼ばれ、HMAC タイプのクレデンシャルが含まれている必要があります。オプションで、提供されていない場合は計算されます。

serviceInstanceCRN

string

serviceInstanceCRN は、このバケットが関連付けられている IBM Cloud Object Storage サービスインスタンスの CRN です。オプションで、提供されていない場合は計算されます。

7.1.98. .status.storage.oss

説明
Oss は、Alibaba Cloud Object Storage Service を使用する設定を表します。
object
プロパティータイプ説明

bucket

string

Bucket は、レジストリーのデータを保存するバケット名です。バケットの命名の詳細は、[公式ドキュメント](https://www.alibabacloud.com/help/doc-detail/257087.htm) で確認できます。値が空の場合、指定なしとみなされ、プラットフォームによってデフォルトが選択されます。デフォルトは、今後変更される可能性があります。現在、デフォルトは <clusterid>-image-registry-<リージョン>-<ランダムな 27 文字の文字列> という形式で自動生成されます。

encryption

object

Encryption は、サーバー側でデータを暗号化するかどうかを指定します。詳細は、[公式ドキュメント] (https://www.alibabacloud.com/help/doc-detail/117914.htm) を参照してください。

endpointAccessibility

string

EndpointAccessibility は、レジストリーが OSS VPC 内部エンドポイントを使用するかどうかを指定します。値が空の場合、指定なしとみなされ、プラットフォームによってデフォルトが選択されます。デフォルトは、今後変更される可能性があります。現在、デフォルトは Internal です。

region

string

Region は、バケットが存在する Alibaba Cloud リージョンです。リージョンのリストは、[公式ドキュメント](https://www.alibabacloud.com/help/doc-detail/31837.html) を参照してください。値が空の場合、指定なしとみなされ、プラットフォームによってデフォルトが選択されます。デフォルトは、今後変更される可能性があります。現在、デフォルトはインストールされている Alibaba Cloud リージョンに基づいています。

7.1.99. .status.storage.oss.encryption

説明
Encryption は、サーバー側でデータを暗号化するかどうかを指定します。詳細は、[公式ドキュメント] (https://www.alibabacloud.com/help/doc-detail/117914.htm) を参照してください。
object
プロパティータイプ説明

kms

object

KMS (キー管理サービス) は、KMS KeyID の構造体を保持する暗号化タイプです。

method

string

Method は、利用可能なさまざまな暗号化モードを定義します。値が空の場合、指定なしとみなされ、プラットフォームによってデフォルトが選択されます。デフォルトは、今後変更される可能性があります。現在、デフォルトは AES256 です。

7.1.100. .status.storage.oss.encryption.kms

説明
KMS (キー管理サービス) は、KMS KeyID の構造体を保持する暗号化タイプです。
object
必須
  • keyID
プロパティータイプ説明

keyID

string

KeyID は、KMS の暗号鍵 ID を保持します。

7.1.101. .status.storage.pvc

説明
pvc は、PersistentVolumeClaim を使用する設定を表します。
object
プロパティータイプ説明

claim

string

クレームは、使用される永続ボリュームクレームの名前を定義します。

7.1.102. .status.storage.s3

説明
s3 は、Amazon Simple Storage Service を使用する設定を表します。
object
プロパティータイプ説明

bucket

string

バケットは、レジストリーのデータを保存するバケット名です。オプションで、提供されていない場合は生成されます。

cloudFront

object

cloudFront は Amazon Cloudfront をレジストリーでストレージミドルウェアとして設定します。

encrypt

boolean

encrypt は、イメージが暗号化された形式で保存されるかどうかを指定します。オプションで、デフォルトは false です。

keyID

string

keyID は、暗号化に使用する KMS キー ID です。オプションで、暗号化は true である必要があります。そうでない場合、このパラメーターは無視されます。

region

string

リージョンはバケットが存在する AWS リージョンです。オプションで、インストールされている AWS リージョンに基づいて設定されます。

regionEndpoint

string

regionEndpoint は、S3 互換のストレージサービスのエンドポイントです。スキームを含む有効な URL である必要があります (例: https://s3.example.com)。オプションで、提供される地域に基づくデフォルト。

trustedCA

object

trustedCA は、CA バンドルを含む config map への参照です。イメージレジストリーとその Operator が、このバンドルの証明書を使用して S3 サーバー証明書を検証します。trustedCA によって参照される config map の namespace は、"openshift-config" です。config map 内のバンドルのキーは、"ca-bundle.crt" です。

virtualHostedStyle

boolean

virtualHostedStyle を使用すると、カスタムの RegionEndpoint オプションで S3 仮想ホストスタイルバケットパスを使用できます。デフォルトは false です。

7.1.103. .status.storage.s3.cloudFront

説明
cloudFront は Amazon Cloudfront をレジストリーでストレージミドルウェアとして設定します。
object
必須
  • baseURL
  • keypairID
  • privateKey
プロパティータイプ説明

baseURL

string

baseURL には、Cloudfront が提供される SCHEME://HOST[/PATH] が含まれています。

duration

string

duration は、Cloudfront セッションの継続時間です。

keypairID

string

keypairID は、AWS が提供するキーペア ID です。

privateKey

object

privateKey は、AWS が提供する秘密鍵を含むシークレットを指します。

7.1.104. .status.storage.s3.cloudFront.privateKey

説明
privateKey は、AWS が提供する秘密鍵を含むシークレットを指します。
object
必須
  • key
プロパティータイプ説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

任意

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

7.1.105. .status.storage.s3.trustedCA

説明
trustedCA は、CA バンドルを含む config map への参照です。イメージレジストリーとその Operator が、このバンドルの証明書を使用して S3 サーバー証明書を検証します。trustedCA によって参照される config map の namespace は、"openshift-config" です。config map 内のバンドルのキーは、"ca-bundle.crt" です。
object
プロパティータイプ説明

name

string

name は、参照される config map の metadata.name です。このフィールドは、標準の config map の命名制限に準拠する必要があります。名前は、英数字、ハイフン (-)、ピリオド (.) のみで構成する必要があります。最大長は 253 文字です。このフィールドが指定されていないか、空の文字列である場合、デフォルトのトラストバンドルが使用されます。

7.1.106. .status.storage.swift

説明
swift は、OpenStack Object Storage を使用する設定を表します。
object
プロパティータイプ説明

authURL

string

authURL は、認証トークンを取得するための URL を定義します。

authVersion

string

authVersion は、OpenStack Auth のバージョンを指定します。

container

string

container は、レジストリーのデータを格納する Swift コンテナーの名前を定義します。

domain

string

domain は、Identityv3API の Openstack のドメイン名を指定します。

domainID

string

domainID は、Identityv3API の Openstack のドメイン ID を指定します。

regionName

string

regionName は、コンテナーが存在する Openstack のリージョンを定義します。

tenant

string

テナントは、レジストリーが使用する Openstack テナント名を定義します。

tenantID

string

テナントは、レジストリーが使用する Openstack テナント ID を定義します。

7.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/imageregistry.operator.openshift.io/v1/configs

    • DELETE: 設定のコレクションを削除します
    • GET: 種類のオブジェクトをリスト表示する Config
    • POST: 設定を作成します
  • /apis/imageregistry.operator.openshift.io/v1/configs/{name}

    • 削除: 設定を削除します
    • GET: 指定された設定を読み取ります
    • PATCH: 指定された設定を部分的に更新します
    • PUT: 指定された設定を置き換えます
  • /apis/imageregistry.operator.openshift.io/v1/configs/{name}/status

    • GET: 指定された設定のステータスを読み取ります
    • PATCH: 指定された設定のステータスを部分的に更新します
    • PUT: 指定された設定のステータスを置き換えます

7.2.1. /apis/imageregistry.operator.openshift.io/v1/configs

HTTP メソッド
DELETE
説明
Config のコレクションを削除します
表7.1 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類のオブジェクトをリスト表示する Config
表7.2 HTTP 応答
HTTP コード応答本文

200 - OK

ConfigList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
設定を作成する
表7.3 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表7.4 本文パラメーター
パラメータータイプ説明

body

Config スキーマ

 
表7.5 HTTP 応答
HTTP コード応答本文

200 - OK

Config スキーマ

201 - Created

Config スキーマ

202 - Accepted

Config スキーマ

401 - Unauthorized

空白

7.2.2. /apis/imageregistry.operator.openshift.io/v1/configs/{name}

表7.6 グローバルパスパラメーター
パラメータータイプ説明

name

string

設定の名前

HTTP メソッド
DELETE
説明
設定を削除する
表7.7 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表7.8 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定された設定を読み取ります
表7.9 HTTP 応答
HTTP コード応答本文

200 - OK

Config スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された設定を部分的に更新します
表7.10 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表7.11 HTTP 応答
HTTP コード応答本文

200 - OK

Config スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された設定を置き換えます
表7.12 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表7.13 本文パラメーター
パラメータータイプ説明

body

Config スキーマ

 
表7.14 HTTP 応答
HTTP コード応答本文

200 - OK

Config スキーマ

201 - Created

Config スキーマ

401 - Unauthorized

空白

7.2.3. /apis/imageregistry.operator.openshift.io/v1/configs/{name}/status

表7.15 グローバルパスパラメーター
パラメータータイプ説明

name

string

設定の名前

HTTP メソッド
GET
説明
指定された設定のステータスを読み取ります
表7.16 HTTP 応答
HTTP コード応答本文

200 - OK

Config スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された設定のステータスを部分的に更新します
表7.17 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表7.18 HTTP 応答
HTTP コード応答本文

200 - OK

Config スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された設定のステータスを置き換えます
表7.19 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表7.20 本文パラメーター
パラメータータイプ説明

body

Config スキーマ

 
表7.21 HTTP 応答
HTTP コード応答本文

200 - OK

Config スキーマ

201 - Created

Config スキーマ

401 - Unauthorized

空白

第8章 Config [samples.operator.openshift.io/v1]

説明
Config には、Samples Operator の設定と詳細な条件ステータスが含まれています。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object
必須
  • metadata
  • spec

8.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

ConfigSpec には、Samples Operator に必要な設定と状態が含まれており、openshift 名前空間で作成/更新するイメージストリームとテンプレートに関するさまざまな動作を制御します。

status

object

ConfigStatus には、実際の設定と、サンプル Operator の状態を説明するさまざまな詳細が含まれています。

8.1.1. .spec

説明
ConfigSpec には、Samples Operator に必要な設定と状態が含まれており、openshift 名前空間で作成/更新するイメージストリームとテンプレートに関するさまざまな動作を制御します。
object
プロパティータイプ説明

architectures

array (string)

アーキテクチャーは、インストールするハードウェアアーキテクチャーを決定します。現在サポートされている選択肢は、x86_64、ppc64le、および s390x のみです。

managementState

string

managementState は、すべての Operator にとって最上位のオン/オフタイプのスイッチです。"マネージド" の場合、この Operator は設定を処理し、それに応じてサンプルを操作します。"アンマネージド" 場合、この Operator は、監視しているリソースの更新を無視します。"削除済み" の場合、Config オブジェクトが削除された場合と同じように反応します。つまり、管理する ImageStream またはテンプレート (スキップされたリストを尊重する) とレジストリーシークレットが、Operator の名前空間の ConfigMap とともに削除されます。これは、サンプルの操作に使用された最後の設定を表します。

samplesRegistry

string

samplesRegistry を使用すると、ImageStreams がイメージコンテンツのためにアクセスするレジストリーを指定できます。この github リポジトリーにプルされる https://github.com/openshift/library のコンテンツのデフォルトですが、ocp コンテンツのみのプルに基づいて、通常はデフォルトで registry.redhat.io になります。

skippedImagestreams

array (string)

skippedImagestreams は、作成/更新してはならないイメージストリームの名前を指定します。管理者はこれを使用して、不要なコンテンツを削除できるようにすることができます。コンテンツを手動で削除する必要がありますが、Operator はここにリストされているものを再作成 (または更新) しません。

skippedTemplates

array (string)

skippedTemplates は、作成/更新してはならないテンプレートの名前を指定します。管理者はこれを使用して、不要なコンテンツを削除できるようにすることができます。コンテンツを手動で削除する必要がありますが、Operator はここにリストされているものを再作成 (または更新) しません。

8.1.2. .status

説明
ConfigStatus には、実際の設定と、サンプル Operator の状態を説明するさまざまな詳細が含まれています。
object
プロパティータイプ説明

architectures

array (string)

アーキテクチャーは、インストールするハードウェアアーキテクチャーを決定します。ここで、x86_64 と ppc64le がサポートされている選択肢です。

conditions

array

条件は、サンプルイメージストリームとテンプレートの利用可能なメンテナンスステータスを表します。

conditions[]

object

ConfigCondition は、エントリーが処理されるときに Config のさまざまな条件をキャプチャします。

managementState

string

managementState は、Operator のオン/オフスイッチの現在の動作ステータスを反映します。この Operator は、Operator をオンに戻していることを確認する一環として、ManagementState を比較します (つまり、以前は "アンマネージド" の場合は "マネージド")。

samplesRegistry

string

samplesRegistry を使用すると、ImageStreams がイメージコンテンツのためにアクセスするレジストリーを指定できます。この github リポジトリーにプルされる https://github.com/openshift/library のコンテンツのデフォルトですが、ocp コンテンツのみのプルに基づいて、通常はデフォルトで registry.redhat.io になります。

skippedImagestreams

array (string)

skippedImagestreams は、作成/更新してはならないイメージストリームの名前を指定します。管理者はこれを使用して、不要なコンテンツを削除できるようにすることができます。コンテンツを手動で削除する必要がありますが、Operator はここにリストされているものを再作成 (または更新) しません。

skippedTemplates

array (string)

skippedTemplates は、作成/更新してはならないテンプレートの名前を指定します。管理者はこれを使用して、不要なコンテンツを削除できるようにすることができます。コンテンツを手動で削除する必要がありますが、Operator はここにリストされているものを再作成 (または更新) しません。

version

string

version は、最後に正常に処理されたときの Operator のペイロードベースのバージョンインジケーターの値です。

8.1.3. .status.conditions

説明
条件は、サンプルイメージストリームとテンプレートの利用可能なメンテナンスステータスを表します。
array

8.1.4. .status.conditions[]

説明
ConfigCondition は、エントリーが処理されるときに Config のさまざまな条件をキャプチャします。
object
必須
  • status
  • type
プロパティータイプ説明

lastTransitionTime

string

lastTransitionTime は、ある状態から別の状態に最後に遷移した時間です。

lastUpdateTime

string

lastUpdateTime は、この条件が最後に更新された時刻です。

message

string

message は、遷移の詳細を示す人が判読できるメッセージです。

reason

string

理由は、条件の最後の遷移を引き起こしたものです。

status

string

条件のステータス、True、False、Unknown のいずれか。

type

string

状態のタイプ。

8.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/samples.operator.openshift.io/v1/configs

    • DELETE: 設定のコレクションを削除します
    • GET: 種類のオブジェクトをリスト表示する Config
    • POST: 設定を作成します
  • /apis/samples.operator.openshift.io/v1/configs/{name}

    • 削除: 設定を削除します
    • GET: 指定された設定を読み取ります
    • PATCH: 指定された設定を部分的に更新します
    • PUT: 指定された設定を置き換えます
  • /apis/samples.operator.openshift.io/v1/configs/{name}/status

    • GET: 指定された設定のステータスを読み取ります
    • PATCH: 指定された設定のステータスを部分的に更新します
    • PUT: 指定された設定のステータスを置き換えます

8.2.1. /apis/samples.operator.openshift.io/v1/configs

HTTP メソッド
DELETE
説明
Config のコレクションを削除します
表8.1 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類のオブジェクトをリスト表示する Config
表8.2 HTTP 応答
HTTP コード応答本文

200 - OK

ConfigList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
設定を作成する
表8.3 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表8.4 本文パラメーター
パラメータータイプ説明

body

Config スキーマ

 
表8.5 HTTP 応答
HTTP コード応答本文

200 - OK

Config スキーマ

201 - Created

Config スキーマ

202 - Accepted

Config スキーマ

401 - Unauthorized

空白

8.2.2. /apis/samples.operator.openshift.io/v1/configs/{name}

表8.6 グローバルパスパラメーター
パラメータータイプ説明

name

string

設定の名前

HTTP メソッド
DELETE
説明
設定を削除する
表8.7 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表8.8 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定された設定を読み取ります
表8.9 HTTP 応答
HTTP コード応答本文

200 - OK

Config スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された設定を部分的に更新します
表8.10 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表8.11 HTTP 応答
HTTP コード応答本文

200 - OK

Config スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された設定を置き換えます
表8.12 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表8.13 本文パラメーター
パラメータータイプ説明

body

Config スキーマ

 
表8.14 HTTP 応答
HTTP コード応答本文

200 - OK

Config スキーマ

201 - Created

Config スキーマ

401 - Unauthorized

空白

8.2.3. /apis/samples.operator.openshift.io/v1/configs/{name}/status

表8.15 グローバルパスパラメーター
パラメータータイプ説明

name

string

設定の名前

HTTP メソッド
GET
説明
指定された設定のステータスを読み取ります
表8.16 HTTP 応答
HTTP コード応答本文

200 - OK

Config スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された設定のステータスを部分的に更新します
表8.17 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表8.18 HTTP 応答
HTTP コード応答本文

200 - OK

Config スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された設定のステータスを置き換えます
表8.19 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表8.20 本文パラメーター
パラメータータイプ説明

body

Config スキーマ

 
表8.21 HTTP 応答
HTTP コード応答本文

200 - OK

Config スキーマ

201 - Created

Config スキーマ

401 - Unauthorized

空白

第9章 CSISnapshotController [operator.openshift.io/v1]

説明
CSISnapshotController は、CSI スナップショットを管理するように Operator を設定する手段を提供します。cluster は正規名です。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object
必須
  • spec

9.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 クラスターから監視される値を保持します。それらはオーバーライドされない場合があります。

9.1.1. .spec

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

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".

unsupportedConfigOverrides

``

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

9.1.2. .status

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

conditions

array

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

conditions[]

object

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

generations

array

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

generations[]

object

GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。

observedGeneration

integer

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

readyReplicas

integer

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

version

string

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

9.1.3. .status.conditions

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

9.1.4. .status.conditions[]

説明
OperatorCondition は、標準の状態フィールドです。
object
プロパティータイプ説明

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

9.1.5. .status.generations

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

9.1.6. .status.generations[]

説明
GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。
object
プロパティータイプ説明

group

string

グループはあなたが追跡しているもののグループです

ハッシュ

string

ハッシュは、シークレットや設定マップのようにコンテンツに依存する、生成されないリソース用に設定されたオプションのフィールドです。

lastGeneration

integer

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

name

string

name は、追跡しているものの名前です

namespace

string

名前空間は、追跡しているものがどこにあるかです

resource

string

リソースは、追跡しているもののリソースタイプです

9.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/operator.openshift.io/v1/csisnapshotcontrollers

    • DELETE:CSISnapshotController のコレクションを削除します
    • GET: 種類 CSISnapshotController のオブジェクトをリスト表示します
    • POST:CSISnapshotController を作成します
  • /apis/operator.openshift.io/v1/csisnapshotcontrollers/{name}

    • 削除:CSISnapshotController を削除します
    • GET: 指定された CSISnapshotController を読み取ります
    • PATCH: 指定された CSISnapshotController を部分的に更新します
    • PUT: 指定された CSISnapshotController を置き換えます
  • /apis/operator.openshift.io/v1/csisnapshotcontrollers/{name}/status

    • GET: 指定された CSISnapshotController のステータスを読み取ります
    • PATCH: 指定された CSISnapshotController のステータスを部分的に更新します
    • PUT: 指定された CSISnapshotController のステータスを置き換えます

9.2.1. /apis/operator.openshift.io/v1/csisnapshotcontrollers

HTTP メソッド
DELETE
説明
CSISnapshotController のコレクションを削除します
表9.1 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類 CSISnapshotController のオブジェクトをリスト表示します
表9.2 HTTP 応答
HTTP コード応答本文

200 - OK

CSISnapshotControllerList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
CSISnapshotController を作成します
表9.3 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表9.4 本文パラメーター
パラメータータイプ説明

body

CSISnapshotController スキーマ

 
表9.5 HTTP 応答
HTTP コード応答本文

200 - OK

CSISnapshotController スキーマ

201 - Created

CSISnapshotController スキーマ

202 - Accepted

CSISnapshotController スキーマ

401 - Unauthorized

空白

9.2.2. /apis/operator.openshift.io/v1/csisnapshotcontrollers/{name}

表9.6 グローバルパスパラメーター
パラメータータイプ説明

name

string

CSISnapshotController の名前

HTTP メソッド
DELETE
説明
CSISnapshotController を削除します
表9.7 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表9.8 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定された CSISnapshotController を読み取ります
表9.9 HTTP 応答
HTTP コード応答本文

200 - OK

CSISnapshotController スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された CSISnapshotController を部分的に更新します
表9.10 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表9.11 HTTP 応答
HTTP コード応答本文

200 - OK

CSISnapshotController スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された CSISnapshotController を置き換えます
表9.12 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表9.13 本文パラメーター
パラメータータイプ説明

body

CSISnapshotController スキーマ

 
表9.14 HTTP 応答
HTTP コード応答本文

200 - OK

CSISnapshotController スキーマ

201 - Created

CSISnapshotController スキーマ

401 - Unauthorized

空白

9.2.3. /apis/operator.openshift.io/v1/csisnapshotcontrollers/{name}/status

表9.15 グローバルパスパラメーター
パラメータータイプ説明

name

string

CSISnapshotController の名前

HTTP メソッド
GET
説明
指定された CSISnapshotController のステータスを読み取ります
表9.16 HTTP 応答
HTTP コード応答本文

200 - OK

CSISnapshotController スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された CSISnapshotController のステータスを部分的に更新します
表9.17 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表9.18 HTTP 応答
HTTP コード応答本文

200 - OK

CSISnapshotController スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された CSISnapshotController のステータスを置き換えます
表9.19 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表9.20 本文パラメーター
パラメータータイプ説明

body

CSISnapshotController スキーマ

 
表9.21 HTTP 応答
HTTP コード応答本文

200 - OK

CSISnapshotController スキーマ

201 - Created

CSISnapshotController スキーマ

401 - Unauthorized

空白

第10章 DNS [operator.openshift.io/v1]

説明
DNS は CoreDNS コンポーネントを管理し、クラスター内の Pod およびサービスの名前解決サービスを提供します。これは、DNS ベースのサービス検出仕様 (https://github.com/kubernetes/dns/blob/master/docs/specification.md) をサポートしています。詳細: https://kubernetes.io/docs/tasks/administer-cluster/coredns 互換性レベル 1: メジャーリリース内で最低 12 カ月間、または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
object

10.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 は、DNS の望ましい動作の仕様です。

status

object

status は、DNS の最後に観察されたステータスです。

10.1.1. .spec

説明
spec は、DNS の望ましい動作の仕様です。
object
プロパティータイプ説明

cache

object

cache は、Corefile にリストされているすべてのサーバーブロックに適用されるキャッシュ設定を表します。このフィールドでは、クラスター管理者が必要に応じて以下を設定できます。* positiveTTL: これは肯定応答をキャッシュする期間です。* negativeTTL: これは否定応答をキャッシュする期間です。これが設定されていない場合、OpenShift はデフォルト値を使用してポジティブキャッシュとネガティブキャッシュを設定します。デフォルト値は変更される可能性があります。執筆時点では、デフォルトの positiveTTL は 900 秒、デフォルトの negativeTTL は 30 秒です。または、お使いの OpenShift バージョンの Corefile に記載されているとおりです。

logLevel

string

logLevel は、CoreDNS に必要なログの詳細度を表します。次のいずれかの値を指定できます。* Normal: アップストリームリゾルバーからのエラーをログに記録します。* Debug: エラー、NXDOMAIN 応答、および NODATA 応答をログに記録します。* Trace: エラーとすべての応答をログに記録します。logLevel: Trace を設定すると、非常に詳細なログが生成されます。有効な値は、"Normal"、"Debug"、"Trace" です。Defaults to "Normal".

managementState

string

managementState は、DNS Operator がクラスター DNS を管理する必要があるかどうかを示します

nodePlacement

object

nodePlacement は、DNS Pod のスケジューリングを明示的に制御します。一般に、すべてのノードで DNS Pod を実行すると、ネットワークを介して別のノードの DNS Pod に移動するのではなく、常にローカル DNS Pod によって DNS クエリーが処理されるようになります。ただし、セキュリティーポリシーでは、DNS Pod の配置を特定のノードに制限する必要がある場合があります。たとえば、セキュリティーポリシーで、任意のノード上の Pod が API と通信することを禁止している場合、ノードセレクターを指定して、DNS Pod を API との通信が許可されているノードに制限できます。逆に、特定のテイントのあるノードで DNS Pod を実行する必要がある場合は、そのテイントに対して許容範囲を指定できます。設定されていない場合、デフォルトが使用されます。詳細は、nodePlacement を参照してください。

operatorLogLevel

string

operatorLogLevel は、DNS Operator のログレベルを制御します。有効な値は、"Normal"、"Debug"、"Trace" です。デフォルトは "Normal" です。operatorLogLevel: Trace を設定すると、非常に詳細なログが生成されます。

servers

array

servers は、クラスタードメインのスコープ外にある 1 つ以上のサブドメインに名前クエリーの委譲を提供する DNS リゾルバーのリストです。servers に複数のサーバーが含まれている場合は、最長後方一致を使用してサーバーが決定されます。たとえば、2 つのサーバーがあり、1 つは "foo.com" 用、もう 1 つは "a.foo.com" 用で、名前クエリーが "www.a.foo.com" 用である場合、そのクエリーはゾーンが "a.foo.com" のサーバーにルーティングされます。このフィールドが nil の場合、サーバーは作成されません。

servers[]

object

Server は、CoreDNS のインスタンスごとに実行されるサーバーのスキーマを定義します。

upstreamResolvers

object

upstreamResolvers は、デフォルト (".") サーバーの場合に、CoreDNS が DNS メッセージをアップストリームリゾルバーにプロキシーするように設定するためのスキーマを定義します。このフィールドが指定されていない場合、使用されるアップストリームはデフォルトで/etc/resolv.conf になり、ポリシーは "sequential" になります。

10.1.2. .spec.cache

説明
cache は、Corefile にリストされているすべてのサーバーブロックに適用されるキャッシュ設定を表します。このフィールドでは、クラスター管理者が必要に応じて以下を設定できます。* positiveTTL: これは肯定応答をキャッシュする期間です。* negativeTTL: これは否定応答をキャッシュする期間です。これが設定されていない場合、OpenShift はデフォルト値を使用してポジティブキャッシュとネガティブキャッシュを設定します。デフォルト値は変更される可能性があります。執筆時点では、デフォルトの positiveTTL は 900 秒、デフォルトの negativeTTL は 30 秒です。または、お使いの OpenShift バージョンの Corefile に記載されているとおりです。
object
プロパティータイプ説明

negativeTTL

string

negativeTTL は任意であり、否定応答をキャッシュする時間を指定します。設定する場合、1s (1 秒) 以上の値にする必要があります。理論上の最大値は数年です。このフィールドには、符号なしの 10 進数の期間文字列を指定する必要があります。それぞれの数字に少数 (任意) と単位の接尾辞を付けます。たとえば、"100s"、"1m30s"、"12h30m10s" です。秒の小数点以下の値は、最も近い秒に切り捨てられます。設定した値が 1 秒未満の場合、デフォルト値が使用されます。設定されていない場合、値は 0 秒になり、OpenShift の各バージョンの Corefile に特に記載がない限り、OpenShift はデフォルト値の 30 秒を使用します。デフォルト値の 30 秒は変更される可能性があります。

positiveTTL

string

positiveTTL は任意であり、肯定応答をキャッシュする時間を指定します。設定する場合、1s (1 秒) 以上の値にする必要があります。理論上の最大値は数年です。このフィールドには、符号なしの 10 進数の期間文字列を指定する必要があります。それぞれの数字に少数 (任意) と単位の接尾辞を付けます。たとえば、"100s"、"1m30s"、"12h30m10s" です。秒の小数点以下の値は、最も近い秒に切り捨てられます。設定した値が 1 秒未満の場合、デフォルト値が使用されます。設定されていない場合、値は 0 秒になり、OpenShift の各バージョンの Corefile に特に記載がない限り、OpenShift はデフォルト値の 900 秒を使用します。デフォルト値の 900 秒は変更される可能性があります。

10.1.3. .spec.nodePlacement

説明
nodePlacement は、DNS Pod のスケジューリングを明示的に制御します。一般に、すべてのノードで DNS Pod を実行すると、ネットワークを介して別のノードの DNS Pod に移動するのではなく、常にローカル DNS Pod によって DNS クエリーが処理されるようになります。ただし、セキュリティーポリシーでは、DNS Pod の配置を特定のノードに制限する必要がある場合があります。たとえば、セキュリティーポリシーで、任意のノード上の Pod が API と通信することを禁止している場合、ノードセレクターを指定して、DNS Pod を API との通信が許可されているノードに制限できます。逆に、特定のテイントのあるノードで DNS Pod を実行する必要がある場合は、そのテイントに対して許容範囲を指定できます。設定されていない場合、デフォルトが使用されます。詳細は、nodePlacement を参照してください。
object
プロパティータイプ説明

nodeSelector

object (string)

nodeSelector は、DNS Pod に適用されるノードセレクターです。空の場合、デフォルトが使用されます。現在は次のとおりです。kubernetes.io/os:linux このデフォルトは変更される可能性があります。設定されている場合、指定されたセレクターが使用され、デフォルトが置き換えられます。

tolerations

array

tolerations は、DNS Pod に適用される許容範囲のリストです。空の場合、DNS Operator は "node-role.kubernetes.io/master" taint の許容範囲を設定します。このデフォルトは変更される可能性があります。"node-role.kubernetes.io/master" テイントの許容値を含めずに許容値を指定すると、すべてのワーカーノードが使用できなくなった場合に停止につながる可能性があるため、リスクが伴う可能性があります。デーモンコントローラーにもいくつかの許容値が追加されていることに注意してください。https://kubernetes.io/docs/concepts/scheduling-eviction/taint-and-toleration/ を参照してください

tolerations[]

object

この toleration が割り当てられる Pod は、マッチング Operator <operator> を使用してトリプル <key,value,effect> と一致するテイントを許容します。

10.1.4. .spec.nodePlacement.tolerations

説明
tolerations は、DNS Pod に適用される許容範囲のリストです。空の場合、DNS Operator は "node-role.kubernetes.io/master" taint の許容範囲を設定します。このデフォルトは変更される可能性があります。"node-role.kubernetes.io/master" テイントの許容値を含めずに許容値を指定すると、すべてのワーカーノードが使用できなくなった場合に停止につながる可能性があるため、リスクが伴う可能性があります。デーモンコントローラーにもいくつかの許容値が追加されていることに注意してください。https://kubernetes.io/docs/concepts/scheduling-eviction/taint-and-toleration/ を参照してください
array

10.1.5. .spec.nodePlacement.tolerations[]

説明
この toleration が割り当てられる Pod は、マッチング Operator <operator> を使用してトリプル <key,value,effect> と一致するテイントを許容します。
タイプ
object
プロパティータイプ説明

effect

string

effect は、照合するテイントの効果を示します。空の場合は、すべてのテイント効果に一致します。指定されている場合、許可される値は NoSchedule、PreferNoSchedule、および NoExecute です。

key

string

key は toleration が適用されるテイントキーです。空の場合は、すべてのテイントキーに一致します。キーが空の場合、Operator は Exists である必要があります。この組み合わせは、すべての値とすべてのキーに一致することを意味します。

operator

string

Operator はキーと値の関係を表します。有効な Operator は Exists および Equal です。デフォルトは Equal です。Exists は、値のワイルドカードと同等であるため、Pod は特定のカテゴリーのすべてのテイントに耐えることができます。

tolerationSeconds

integer

tolerationSeconds は、toleration (effect は NoExecute でなければならず、NoExecute 以外の場合このフィールドは無視されます) がテイントを許容する期間を表します。デフォルトでは設定されていません。つまり、テイントを永久に許容します (エビクトしないでください)。ゼロ値と負の値は、システムによって 0 (すぐにエビクト) として扱われます。

value

string

value は、toleration が一致するテイントの値です。Operator が Exists の場合、値は空である必要があります。それ以外の場合は、通常の文字列のみになります。

10.1.6. .spec.servers

説明
servers は、クラスタードメインのスコープ外にある 1 つ以上のサブドメインに名前クエリーの委譲を提供する DNS リゾルバーのリストです。servers に複数のサーバーが含まれている場合は、最長後方一致を使用してサーバーが決定されます。たとえば、2 つのサーバーがあり、1 つは "foo.com" 用、もう 1 つは "a.foo.com" 用で、名前クエリーが "www.a.foo.com" 用である場合、そのクエリーはゾーンが "a.foo.com" のサーバーにルーティングされます。このフィールドが nil の場合、サーバーは作成されません。
array

10.1.7. .spec.servers[]

説明
Server は、CoreDNS のインスタンスごとに実行されるサーバーのスキーマを定義します。
object
プロパティータイプ説明

forwardPlugin

object

forwardPlugin は、DNS メッセージをアップストリームリゾルバーにプロキシーするように CoreDNS を設定するためのスキーマを定義します。

name

string

name は必須であり、サーバーの一意の名前を指定します。名前は、rfc6335 のサービス名構文に準拠している必要があります。

zones

array (string)

zones は必須であり、サーバーが権限を持つサブドメインを指定します。ゾーンは、サブドメインの rfc1123 定義に準拠している必要があります。クラスタードメイン (つまり、"cluster.local") の指定は無効です。

10.1.8. .spec.servers[].forwardPlugin

説明
forwardPlugin は、DNS メッセージをアップストリームリゾルバーにプロキシーするように CoreDNS を設定するためのスキーマを定義します。
object
プロパティータイプ説明

policy

string

policy は、アップストリームサーバーをクエリーのために選択する順序を決定するために使用します。次のいずれかの値を指定できます。* "Random": クエリーごとにランダムなアップストリームサーバーを選択します。* "RoundRobin": ラウンドロビンの順序でアップストリームサーバーを選択し、新しいクエリーごとに次のサーバーに移動します。* "Sequential": 新しいクエリーごとに最初のサーバーから始めて、応答が得られるまでアップストリームサーバーに順番にクエリーを試行します。デフォルト値は "Random" です。

protocolStrategy

string

protocolStrategy は、アップストリーム DNS 要求に使用するプロトコルを指定します。protocolStrategy の有効な値は "TCP" です (省略可能)。省略すると、指定なしとみなされ、プラットフォームによって適切なデフォルトが選択されます。デフォルトは、今後変更される可能性があります。現在のデフォルトでは、元のクライアント要求のプロトコルが使用されます。"TCP" に設定すると、クライアント要求が UDP を使用する場合でも、すべてのアップストリーム DNS 要求に対して TCP が必ず使用されます。"TCP" は、非準拠のアップストリームリゾルバーなどによって発生する UDP 固有の問題には役立ちます。ただし、消費される帯域幅が増加したり、DNS 応答時間が長くなったりする可能性があります。protocolStrategy は、CoreDNS がアップストリームリゾルバーに対して行う DNS 要求のプロトコルにのみ影響することに注意してください。クライアントと CoreDNS 間の DNS 要求のプロトコルには影響しません。

transportConfig

object

transportConfig は、DNS 要求をアップストリームリゾルバーに転送するときに使用するトランスポートタイプ、サーバー名、およびオプションのカスタム CA または CA バンドルを設定するために使用します。デフォルト値は "" (空) です。デフォルト値の場合、DNS 要求をアップストリームリゾルバーに転送するときに標準のクリアテキスト接続が使用されます。

upstreams

array (string)

upstreams は、ゾーンのサブドメインの名前クエリーを転送するリゾルバーのリストです。CoreDNS の各インスタンスは、アップストリームのヘルスチェックを実行します。正常なアップストリームが交換中にエラーを返すと、アップストリームの別のリゾルバーが試行されます。アップストリームは、ポリシーで指定された順序で選択されます。各アップストリームは、アップストリームが 53 以外のポートでリッスンしている場合、IP アドレスまたは IP: ポートで表されます。ForwardPlugin ごとに最大 15 個のアップストリームが許可されます。

10.1.9. .spec.servers[].forwardPlugin.transportConfig

説明
transportConfig は、DNS 要求をアップストリームリゾルバーに転送するときに使用するトランスポートタイプ、サーバー名、およびオプションのカスタム CA または CA バンドルを設定するために使用します。デフォルト値は "" (空) です。デフォルト値の場合、DNS 要求をアップストリームリゾルバーに転送するときに標準のクリアテキスト接続が使用されます。
object
プロパティータイプ説明

tls

object

tls には、トランスポートが "TLS" に設定されているときに使用する追加の設定オプションを含めます。

transport

string

transport を使用すると、クラスター管理者はクラスターの DNS とアップストリームリゾルバー間の DNS-over-TLS 接続の使用を選択できます。CABundle を設定せずにこのレベルで TLS をトランスポートとして設定すると、システム証明書がアップストリームリゾルバーのサービス証明書の検証に使用されます。可能な値: "" (空) - 明示的な指定なしとみなされ、プラットフォームによってデフォルトが選択されます。デフォルトは、今後変更される可能性があります。現在のデフォルトは "Cleartext" です。"Cleartext" - クラスター管理者が指定するクリアテキストオプション。この値を指定しても、得られる機能は空の値と同じですが、クラスター管理者がトランスポートについてより明示的に指定する場合や、"TLS" から "Cleartext" に明示的に切り替える場合に役立つことがあります。"TLS" - DNS クエリーを TLS 接続経由で送信する必要があることを示します。トランスポートを TLS に設定した場合、ServerName も設定する必要があります。アップストリーム IP にポートが含まれていない場合、RFC 7858 セクション 3.1 (https://datatracker.ietf.org/doc/html/rfc7858#section-3.1) に従って、デフォルトでポート 853 が試行されます。

10.1.10. .spec.servers[].forwardPlugin.transportConfig.tls

説明
tls には、トランスポートが "TLS" に設定されているときに使用する追加の設定オプションを含めます。
object
必須
  • serverName
プロパティータイプ説明

caBundle

object

caBundle は、1 つの CA 証明書か CA バンドルを含んでいる必要がある ConfigMap を参照します。これを使用すると、クラスター管理者は、アップストリームリゾルバーの証明書を検証するための独自の CA または CA バンドルを指定できます。1. configmap には ca-bundle.crt キーが含まれている必要があります。2. 値は PEM でエンコードされた CA 証明書または CA バンドルである必要があります。3. 管理者は、openshift-config namespace にこの configmap を作成する必要があります。4. アップストリームサーバー証明書には、ServerName と一致するサブジェクト代替名 (SAN) が含まれている必要があります。

serverName

string

serverName は、DNS クエリーを転送するときに接続するアップストリームサーバーです。これは、トランスポートが "TLS" に設定されている場合に必要です。ServerName は、RFC 1123 の DNS 命名規則に基づいて検証され、アップストリームリゾルバーにインストールされている TLS 証明書と一致する必要があります。

10.1.11. .spec.servers[].forwardPlugin.transportConfig.tls.caBundle

説明
caBundle は、1 つの CA 証明書か CA バンドルを含んでいる必要がある ConfigMap を参照します。これを使用すると、クラスター管理者は、アップストリームリゾルバーの証明書を検証するための独自の CA または CA バンドルを指定できます。1. configmap には ca-bundle.crt キーが含まれている必要があります。2. 値は PEM でエンコードされた CA 証明書または CA バンドルである必要があります。3. 管理者は、openshift-config namespace にこの configmap を作成する必要があります。4. アップストリームサーバー証明書には、ServerName と一致するサブジェクト代替名 (SAN) が含まれている必要があります。
object
必須
  • name
プロパティータイプ説明

name

string

name は、参照される config map の metadata.name です

10.1.12. .spec.upstreamResolvers

説明
upstreamResolvers は、デフォルト (".") サーバーの場合に、CoreDNS が DNS メッセージをアップストリームリゾルバーにプロキシーするように設定するためのスキーマを定義します。このフィールドが指定されていない場合、使用されるアップストリームはデフォルトで/etc/resolv.conf になり、ポリシーは "sequential" になります。
object
プロパティータイプ説明

policy

string

Policy は、アップストリームサーバーをクエリーのために選択する順序を決定するために使用します。次のいずれかの値を指定できます。* "Random": クエリーごとにランダムなアップストリームサーバーを選択します。* "RoundRobin": ラウンドロビンの順序でアップストリームサーバーを選択し、新しいクエリーごとに次のサーバーに移動します。* "Sequential": 新しいクエリーごとに最初のサーバーから始めて、応答が得られるまでアップストリームサーバーに順番にクエリーを試行します。デフォルト値は "Sequential" です。

protocolStrategy

string

protocolStrategy は、アップストリーム DNS 要求に使用するプロトコルを指定します。protocolStrategy の有効な値は "TCP" です (省略可能)。省略すると、指定なしとみなされ、プラットフォームによって適切なデフォルトが選択されます。デフォルトは、今後変更される可能性があります。現在のデフォルトでは、元のクライアント要求のプロトコルが使用されます。"TCP" に設定すると、クライアント要求が UDP を使用する場合でも、すべてのアップストリーム DNS 要求に対して TCP が必ず使用されます。"TCP" は、非準拠のアップストリームリゾルバーなどによって発生する UDP 固有の問題には役立ちます。ただし、消費される帯域幅が増加したり、DNS 応答時間が長くなったりする可能性があります。protocolStrategy は、CoreDNS がアップストリームリゾルバーに対して行う DNS 要求のプロトコルにのみ影響することに注意してください。クライアントと CoreDNS 間の DNS 要求のプロトコルには影響しません。

transportConfig

object

transportConfig は、DNS 要求をアップストリームリゾルバーに転送するときに使用するトランスポートタイプ、サーバー名、およびオプションのカスタム CA または CA バンドルを設定するために使用します。デフォルト値は "" (空) です。デフォルト値の場合、DNS 要求をアップストリームリゾルバーに転送するときに標準のクリアテキスト接続が使用されます。

upstreams

array

Upstreams は、"."ドメインの名前クエリーを転送するリゾルバーのリストです。CoreDNS の各インスタンスは、アップストリームのヘルスチェックを実行します。正常なアップストリームが交換中にエラーを返すと、アップストリームの別のリゾルバーが試行されます。アップストリームは、ポリシーで指定された順序で選択されます。ForwardPlugin ごとに最大 15 個のアップストリームが許可されます。アップストリームが指定されていない場合は、デフォルトで /etc/resolv.conf が使用されます。

upstreams[]

object

アップストリームは、SystemResolvConf タイプか Network タイプのどちらかです。- アップストリームが SystemResolvConf タイプの場合、追加のフィールドは必要ありません。アップストリームは /etc/resolv.conf を使用するように設定されます。- アップストリームが Network タイプの場合、アップストリームが 53 以外のポートでリッスンするのであれば、NetworkResolver フィールドを IP アドレスまたは IP:port で定義する必要があります。

10.1.13. .spec.upstreamResolvers.transportConfig

説明
transportConfig は、DNS 要求をアップストリームリゾルバーに転送するときに使用するトランスポートタイプ、サーバー名、およびオプションのカスタム CA または CA バンドルを設定するために使用します。デフォルト値は "" (空) です。デフォルト値の場合、DNS 要求をアップストリームリゾルバーに転送するときに標準のクリアテキスト接続が使用されます。
object
プロパティータイプ説明

tls

object

tls には、トランスポートが "TLS" に設定されているときに使用する追加の設定オプションを含めます。

transport

string

transport を使用すると、クラスター管理者はクラスターの DNS とアップストリームリゾルバー間の DNS-over-TLS 接続の使用を選択できます。CABundle を設定せずにこのレベルで TLS をトランスポートとして設定すると、システム証明書がアップストリームリゾルバーのサービス証明書の検証に使用されます。可能な値: "" (空) - 明示的な指定なしとみなされ、プラットフォームによってデフォルトが選択されます。デフォルトは、今後変更される可能性があります。現在のデフォルトは "Cleartext" です。"Cleartext" - クラスター管理者が指定するクリアテキストオプション。この値を指定しても、得られる機能は空の値と同じですが、クラスター管理者がトランスポートについてより明示的に指定する場合や、"TLS" から "Cleartext" に明示的に切り替える場合に役立つことがあります。"TLS" - DNS クエリーを TLS 接続経由で送信する必要があることを示します。トランスポートを TLS に設定した場合、ServerName も設定する必要があります。アップストリーム IP にポートが含まれていない場合、RFC 7858 セクション 3.1 (https://datatracker.ietf.org/doc/html/rfc7858#section-3.1) に従って、デフォルトでポート 853 が試行されます。

10.1.14. .spec.upstreamResolvers.transportConfig.tls

説明
tls には、トランスポートが "TLS" に設定されているときに使用する追加の設定オプションを含めます。
object
必須
  • serverName
プロパティータイプ説明

caBundle

object

caBundle は、1 つの CA 証明書か CA バンドルを含んでいる必要がある ConfigMap を参照します。これを使用すると、クラスター管理者は、アップストリームリゾルバーの証明書を検証するための独自の CA または CA バンドルを指定できます。1. configmap には ca-bundle.crt キーが含まれている必要があります。2. 値は PEM でエンコードされた CA 証明書または CA バンドルである必要があります。3. 管理者は、openshift-config namespace にこの configmap を作成する必要があります。4. アップストリームサーバー証明書には、ServerName と一致するサブジェクト代替名 (SAN) が含まれている必要があります。

serverName

string

serverName は、DNS クエリーを転送するときに接続するアップストリームサーバーです。これは、トランスポートが "TLS" に設定されている場合に必要です。ServerName は、RFC 1123 の DNS 命名規則に基づいて検証され、アップストリームリゾルバーにインストールされている TLS 証明書と一致する必要があります。

10.1.15. .spec.upstreamResolvers.transportConfig.tls.caBundle

説明
caBundle は、1 つの CA 証明書か CA バンドルを含んでいる必要がある ConfigMap を参照します。これを使用すると、クラスター管理者は、アップストリームリゾルバーの証明書を検証するための独自の CA または CA バンドルを指定できます。1. configmap には ca-bundle.crt キーが含まれている必要があります。2. 値は PEM でエンコードされた CA 証明書または CA バンドルである必要があります。3. 管理者は、openshift-config namespace にこの configmap を作成する必要があります。4. アップストリームサーバー証明書には、ServerName と一致するサブジェクト代替名 (SAN) が含まれている必要があります。
object
必須
  • name
プロパティータイプ説明

name

string

name は、参照される config map の metadata.name です

10.1.16. .spec.upstreamResolvers.upstreams

説明
Upstreams は、"."ドメインの名前クエリーを転送するリゾルバーのリストです。CoreDNS の各インスタンスは、アップストリームのヘルスチェックを実行します。正常なアップストリームが交換中にエラーを返すと、アップストリームの別のリゾルバーが試行されます。アップストリームは、ポリシーで指定された順序で選択されます。ForwardPlugin ごとに最大 15 個のアップストリームが許可されます。アップストリームが指定されていない場合は、デフォルトで /etc/resolv.conf が使用されます。
array

10.1.17. .spec.upstreamResolvers.upstreams[]

説明
アップストリームは、SystemResolvConf タイプか Network タイプのどちらかです。- アップストリームが SystemResolvConf タイプの場合、追加のフィールドは必要ありません。アップストリームは /etc/resolv.conf を使用するように設定されます。- アップストリームが Network タイプの場合、アップストリームが 53 以外のポートでリッスンするのであれば、NetworkResolver フィールドを IP アドレスまたは IP:port で定義する必要があります。
object
必須
  • type
プロパティータイプ説明

address

string

Address は、Type が Network に設定されている場合に定義する必要があります。それ以外の場合は無視されます。有効な IPv4 または IPv6 アドレスである必要があります。

port

integer

Port は、Type が Network に設定されている場合に定義する必要があります。それ以外の場合は無視されます。ポートは 65535 までである必要があります。

type

string

Type は、このアップストリームに IP/IP:port リゾルバーを含めるか、ローカルの /etc/resolv.conf を含めるかを定義します。Type には、2 つの値 (SystemResolvConf または Network) を指定できます。* SystemResolvConf を使用する場合、アップストリーム構造に追加のフィールドを定義する必要はありません。/etc/resolv.conf が使用されます。* Network を使用する場合、アップストリーム構造に少なくともアドレスが含まれている必要があります。

10.1.18. .status

説明
status は、DNS の最後に観察されたステータスです。
object
必須
  • clusterDomain
  • clusterIP
プロパティータイプ説明

clusterDomain

string

clusterDomain は、DNS サービスのローカルクラスター DNS ドメイン接尾辞です。これは、RFC 1034 のセクション 3.5 (https://tools.ietf.org/html/rfc1034#section-3.5) で定義されているサブドメインです。たとえば、"cluster.local" です。 詳細: https://kubernetes.io/docs/concepts/services-networking/dns-pod-service

clusterIP

string

clusterIP は、この DNS を利用できるようにするためのサービス IP です。デフォルトの DNS の場合、これは、デフォルトの ClusterFirst DNS ポリシーを使用している Pod のデフォルトのネームサーバーとして使用されている既知の IP です。一般に、この IP は、Pod の spec.dnsConfig.nameservers リストで指定するか、クラスター内から名前解決を実行するときに明示的に使用できます。例: dig foo.com @<service IP> 詳細: https://kubernetes.io/docs/concepts/services-networking/service/#virtual-ips-and-service-proxies

conditions

array

条件は、クラスター上の DNS の状態に関する情報を提供します。サポートされている DNS 条件は次のとおりです。*使用可能 - 次の条件が満たされた場合に真になります。*DNS コントローラーデーモンセットが使用可能です。- これらの条件のいずれかが満たされていない場合は False。

conditions[]

object

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

10.1.19. .status.conditions

説明
条件は、クラスター上の DNS の状態に関する情報を提供します。サポートされている DNS 条件は次のとおりです。*使用可能 - 次の条件が満たされた場合に真になります。*DNS コントローラーデーモンセットが使用可能です。- これらの条件のいずれかが満たされていない場合は False。
array

10.1.20. .status.conditions[]

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

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

10.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/operator.openshift.io/v1/dnses

    • DELETE: DNS のコレクションを削除します
    • GET: 種類 DNS のオブジェクトをリスト表示します
    • POST: DNS を作成します
  • /apis/operator.openshift.io/v1/dnses/{name}

    • DELETE: DNS を削除します
    • GET: 指定された DNS を読み取ります
    • PATCH: 指定された DNS を部分的に更新します
    • PUT: 指定された DNS を置き換えます
  • /apis/operator.openshift.io/v1/dnses/{name}/status

    • GET: 指定された DNS のステータスを読み取ります
    • PATCH: 指定された DNS のステータスを部分的に更新します
    • PUT: 指定された DNS のステータスを置き換えます

10.2.1. /apis/operator.openshift.io/v1/dnses

HTTP メソッド
DELETE
説明
DNS のコレクションを削除する
表10.1 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類が DNS のオブジェクトをリスト表示します。
表10.2 HTTP 応答
HTTP コード応答本文

200 - OK

DNSList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
DNS を作成する
表10.3 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表10.4 本文パラメーター
パラメータータイプ説明

body

DNS スキーマ

 
表10.5 HTTP 応答
HTTP コード応答本文

200 - OK

DNS スキーマ

201 - Created

DNS スキーマ

202 - Accepted

DNS スキーマ

401 - Unauthorized

空白

10.2.2. /apis/operator.openshift.io/v1/dnses/{name}

表10.6 グローバルパスパラメーター
パラメータータイプ説明

name

string

DNS の名前

HTTP メソッド
DELETE
説明
DNS を削除する
表10.7 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表10.8 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定された DNS を読み取る
表10.9 HTTP 応答
HTTP コード応答本文

200 - OK

DNS スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された DNS を部分的に更新します
表10.10 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表10.11 HTTP 応答
HTTP コード応答本文

200 - OK

DNS スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された DNS を置き換えます
表10.12 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表10.13 本文パラメーター
パラメータータイプ説明

body

DNS スキーマ

 
表10.14 HTTP 応答
HTTP コード応答本文

200 - OK

DNS スキーマ

201 - Created

DNS スキーマ

401 - Unauthorized

空白

10.2.3. /apis/operator.openshift.io/v1/dnses/{name}/status

表10.15 グローバルパスパラメーター
パラメータータイプ説明

name

string

DNS の名前

HTTP メソッド
GET
説明
指定された DNS のステータスを読み取る
表10.16 HTTP 応答
HTTP コード応答本文

200 - OK

DNS スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された DNS のステータスを部分的に更新します
表10.17 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表10.18 HTTP 応答
HTTP コード応答本文

200 - OK

DNS スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された DNS のステータスを置き換えます
表10.19 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表10.20 本文パラメーター
パラメータータイプ説明

body

DNS スキーマ

 
表10.21 HTTP 応答
HTTP コード応答本文

200 - OK

DNS スキーマ

201 - Created

DNS スキーマ

401 - Unauthorized

空白

第11章 DNSRecord [ingress.operator.openshift.io/v1]

説明
DNSRecord は、dns.config.openshift.io/cluster.spec.publicZone および.spec.privateZone によって定義されたゾーンで管理される DNS レコードです。このリソースのクラスター管理操作はサポートされていません。このリソースは、OpenShift Operator の内部通信専用です。DNSManagementPolicy が "Unmanaged" の場合、Operator はクラウドプロバイダー上の DNS レコードの管理を担当しません。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object

11.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 は、dnsRecord の望ましい動作の仕様です。

status

object

status は、dnsRecord の最後に観察されたステータスです。

11.1.1. .spec

説明
spec は、dnsRecord の望ましい動作の仕様です。
object
必須
  • dnsManagementPolicy
  • dnsName
  • recordTTL
  • recordType
  • ターゲット
プロパティータイプ説明

dnsManagementPolicy

string

dnsManagementPolicy は、DNS レコードに適用されている現在のポリシーを示します。ポリシーが "Unmanaged" に設定されているレコードは、Ingress Operator によって無視されます。この場合、クラウドプロバイダー上の DNS レコードは、Operator によって管理されません。外部で管理されるため、"Published" ステータス状態が "Unknown" ステータスに更新されます。クラウドプロバイダー上の既存のレコードは、クラスター管理者の判断で削除できます。このフィールドのデフォルトは Managed です。有効な値は "Managed" と "Unmanaged" です。

dnsName

string

dnsName は、DNS レコードのホスト名です

recordTTL

integer

recordTTL は、秒単位のレコード TTL です。ゼロの場合、デフォルトは 30 です。RecordTTL は、AWS リージョンのエイリアスターゲットでは使用されませんが、AWS API コントラクトに従って、CNAME ターゲットで使用されます。

recordType

string

recordType は DNS レコードタイプです。たとえば、"A" または "CNAME"。

targets

array (string)

ターゲットはレコードターゲットです。

11.1.2. .status

説明
status は、dnsRecord の最後に観察されたステータスです。
object
プロパティータイプ説明

observedGeneration

integer

observedGeneration は、最近観察された DNSRecord の世代です。DNSRecord が更新されると、コントローラーは各マネージドゾーンの対応するレコードを更新します。特定のゾーンの更新が失敗した場合、その失敗はゾーンのステータス条件に記録されるため、コントローラーはその特定のゾーンの更新を再試行する必要があると判断できます。

zones

array

ゾーンは、各ゾーンのレコードのステータスです。

zones[]

object

DNSZoneStatus は、特定のゾーン内のレコードのステータスです。

11.1.3. .status.zones

説明
ゾーンは、各ゾーンのレコードのステータスです。
array

11.1.4. .status.zones[]

説明
DNSZoneStatus は、特定のゾーン内のレコードのステータスです。
object
プロパティータイプ説明

conditions

array

conditions は、ゾーン内のレコードに関連する状態です。レコードの公開が成功すると、"Published" 状態のステータスが "True" に設定されます。失敗すると、"False" に設定され、失敗の原因を説明する理由とメッセージが提供されます。

conditions[]

object

DNSZoneCondition は、単なる標準の条件フィールドです。

dnsZone

object

dnsZone は、レコードが公開されるゾーンです。

11.1.5. .status.zones[].conditions

説明
conditions は、ゾーン内のレコードに関連する状態です。レコードの公開が成功すると、"Published" 状態のステータスが "True" に設定されます。失敗すると、"False" に設定され、失敗の原因を説明する理由とメッセージが提供されます。
array

11.1.6. .status.zones[].conditions[]

説明
DNSZoneCondition は、単なる標準の条件フィールドです。
object
必須
  • status
  • type
プロパティータイプ説明

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

11.1.7. .status.zones[].dnsZone

説明
dnsZone は、レコードが公開されるゾーンです。
object
プロパティータイプ説明

id

string

AWS では [1] で ID を id としてゾーンを取得でき、Azure では [2] で ID をあらかじめ決められた名前として取得でき、GCP では [3] で ID をあらかじめ決められた名前としてゾーンを取得できるようになっています。[1]: https://docs.aws.amazon.com/cli/latest/reference/route53/get-hosted-zone.html#options [2]: https://docs.microsoft.com/en-us/cli/azure/network/dns/zone?view=azure-cli-latest#az-network-dns-zone-show [3]: https://cloud.google.com/dns/docs/reference/v1/managedZones/get

tags

object (string)

タグを使用して DNS ホストゾーンを照会することができます。AWS では、resourcegroupstaggingapi [1] を使用して、Tags タグフィルターとして使用してゾーンを取得できます [1]: https://docs.aws.amazon.com/cli/latest/reference/resourcegroupstaggingapi/get-resources.html#options

11.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/ingress.operator.openshift.io/v1/dnsrecords

    • GET: 種類 DNSRecord のオブジェクトをリスト表示します
  • /apis/ingress.operator.openshift.io/v1/namespaces/{namespace}/dnsrecords

    • DELETE:DNSRecord のコレクションを削除します
    • GET: 種類 DNSRecord のオブジェクトをリスト表示します
    • POST:DNSRecord を作成します
  • /apis/ingress.operator.openshift.io/v1/namespaces/{namespace}/dnsrecords/{name}

    • 削除:DNS レコードを削除します
    • GET: 指定された DNSRecord を読み取ります
    • PATCH: 指定された DNSRecord を部分的に更新します
    • PUT: 指定された DNSRecord を置き換えます
  • /apis/ingress.operator.openshift.io/v1/namespaces/{namespace}/dnsrecords/{name}/status

    • GET: 指定された DNSRecord のステータスを読み取ります
    • PATCH: 指定された DNSRecord のステータスを部分的に更新します
    • PUT: 指定された DNSRecord のステータスを置き換えます

11.2.1. /apis/ingress.operator.openshift.io/v1/dnsrecords

HTTP メソッド
GET
説明
種類が DNSRecord のオブジェクトをリスト表示します。
表11.1 HTTP 応答
HTTP コード応答本文

200 - OK

DNSRecordList スキーマ

401 - Unauthorized

空白

11.2.2. /apis/ingress.operator.openshift.io/v1/namespaces/{namespace}/dnsrecords

HTTP メソッド
DELETE
説明
DNSRecord のコレクションを削除します
表11.2 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類が DNSRecord のオブジェクトをリスト表示します。
表11.3 HTTP 応答
HTTP コード応答本文

200 - OK

DNSRecordList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
DNSRecord を作成する
表11.4 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表11.5 本文パラメーター
パラメータータイプ説明

body

DNSRecord スキーマ

 
表11.6 HTTP 応答
HTTP コード応答本文

200 - OK

DNSRecord スキーマ

201 - Created

DNSRecord スキーマ

202 - Accepted

DNSRecord スキーマ

401 - Unauthorized

空白

11.2.3. /apis/ingress.operator.openshift.io/v1/namespaces/{namespace}/dnsrecords/{name}

表11.7 グローバルパスパラメーター
パラメータータイプ説明

name

string

DNSRecord の名前

HTTP メソッド
DELETE
説明
DNSRecord を削除します
表11.8 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表11.9 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定された DNSRecord を読み取ります
表11.10 HTTP 応答
HTTP コード応答本文

200 - OK

DNSRecord スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された DNSRecord を部分的に更新します
表11.11 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表11.12 HTTP 応答
HTTP コード応答本文

200 - OK

DNSRecord スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された DNSRecord を置き換えます
表11.13 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表11.14 本文パラメーター
パラメータータイプ説明

body

DNSRecord スキーマ

 
表11.15 HTTP 応答
HTTP コード応答本文

200 - OK

DNSRecord スキーマ

201 - Created

DNSRecord スキーマ

401 - Unauthorized

空白

11.2.4. /apis/ingress.operator.openshift.io/v1/namespaces/{namespace}/dnsrecords/{name}/status

表11.16 グローバルパスパラメーター
パラメータータイプ説明

name

string

DNSRecord の名前

HTTP メソッド
GET
説明
指定された DNSRecord のステータスを読み取ります
表11.17 HTTP 応答
HTTP コード応答本文

200 - OK

DNSRecord スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された DNSRecord のステータスを部分的に更新します
表11.18 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表11.19 HTTP 応答
HTTP コード応答本文

200 - OK

DNSRecord スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された DNSRecord のステータスを置き換えます
表11.20 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表11.21 本文パラメーター
パラメータータイプ説明

body

DNSRecord スキーマ

 
表11.22 HTTP 応答
HTTP コード応答本文

200 - OK

DNSRecord スキーマ

201 - Created

DNSRecord スキーマ

401 - Unauthorized

空白

第12章 Etcd [operator.openshift.io/v1]

説明
Etcd は、etcd を管理するように Operator を設定するための情報を提供します。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object
必須
  • spec

12.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

 

status

object

 

12.1.1. .spec

説明
タイプ
object
プロパティータイプ説明

controlPlaneHardwareSpeed

string

HardwareSpeed を使用すると、ハートビート間隔とリーダー選出タイムアウトのレイテンシーパラメーターを設定する etcd チューニングプロファイルを変更して、クラスターで許容される etcd メンバー間のラウンドトリップ時間を延長できます。有効な値は、""、"Standard"、"Slower" です。"" の場合、指定なしとみなされ、プラットフォームによって適切なデフォルトが選択されます。デフォルトは、予告なく変更される可能性があります。

failedRevisionLimit

integer

failedRevisionLimit は、ディスク上に保持するために失敗した静的 Pod インストーラーリビジョンの数であり、API では -1 =無制限、0 または未設定= 5(デフォルト)

forceRedeploymentReason

string

forceRedeploymentReason を使用すると、一意の文字列を指定して、オペランドの再デプロイを強制できます。これにより、以前に失敗したデプロイメントを開始するメカニズムが提供され、同じ設定で再度失敗するのではなく、今回は機能すると思われる理由が提供されます。

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".

succeededRevisionLimit

integer

successedRevisionLimit は、ディスク上に保持する成功した静的 Pod インストーラーリビジョンの数であり、API では -1 =無制限、0 または未設定= 5(デフォルト)

unsupportedConfigOverrides

``

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

12.1.2. .status

説明
タイプ
object
プロパティータイプ説明

conditions

array

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

conditions[]

object

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

controlPlaneHardwareSpeed

string

ControlPlaneHardwareSpeed は、有効なハードウェア速度許容レベルを宣言します。

generations

array

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

generations[]

object

GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。

latestAvailableRevision

integer

latestAvailableRevision は、最新のデプロイメントの deploymentID です。

latestAvailableRevisionReason

string

latestAvailableRevisionReason は、最新のデプロイメントの詳細な理由を説明します

nodeStatuses

array

nodeStatuses は、個々のノード全体のデプロイメント値とエラーを追跡します

nodeStatuses[]

object

NodeStatus は、この Operator によって管理される特定のノードの現在の状態に関する情報を提供します。

observedGeneration

integer

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

readyReplicas

integer

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

version

string

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

12.1.3. .status.conditions

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

12.1.4. .status.conditions[]

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

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

12.1.5. .status.generations

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

12.1.6. .status.generations[]

説明
GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。
object
プロパティータイプ説明

group

string

グループはあなたが追跡しているもののグループです

ハッシュ

string

ハッシュは、シークレットや設定マップのようにコンテンツに依存する、生成されないリソース用に設定されたオプションのフィールドです。

lastGeneration

integer

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

name

string

name は、追跡しているものの名前です

namespace

string

名前空間は、追跡しているものがどこにあるかです

resource

string

リソースは、追跡しているもののリソースタイプです

12.1.7. .status.nodeStatuses

説明
nodeStatuses は、個々のノード全体のデプロイメント値とエラーを追跡します
array

12.1.8. .status.nodeStatuses[]

説明
NodeStatus は、この Operator によって管理される特定のノードの現在の状態に関する情報を提供します。
object
必須
  • nodeName
プロパティータイプ説明

currentRevision

integer

currentRevision は、最近成功したデプロイメントの生成です

lastFailedCount

integer

lastFailedCount は、最後に失敗したリビジョンのインストーラー Pod が失敗した頻度です。

lastFailedReason

string

lastFailedReason は、機械で読み取り可能な障害理由文字列です。

lastFailedRevision

integer

lastFailedRevision は、デプロイを試みて失敗したデプロイメントの世代です。

lastFailedRevisionErrors

array (string)

lastFailedRevisionErrors は、lastFailedRevision で参照されているデプロイメントの失敗時に人間が読み取れるエラーのリストです。

lastFailedTime

string

lastFailedTime は、最後に失敗したリビジョンが最後に失敗した時刻です。

lastFallbackCount

integer

lastFallbackCount は、前のリビジョンへのフォールバックが発生した頻度です。

nodeName

string

nodeName はノードの名前です

targetRevision

integer

targetRevision は、適用しようとしているデプロイメントの世代です

12.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/operator.openshift.io/v1/etcds

    • 削除:Etcd のコレクションを削除します
    • GET: 種類 Etcd のオブジェクトをリスト表示します
    • POST:Etcd を作成する
  • /apis/operator.openshift.io/v1/etcds/{name}

    • 削除:Etcd を削除します
    • GET: 指定された Etcd を読み取ります
    • PATCH: 指定された Etcd を部分的に更新します
    • PUT: 指定された Etcd を置き換えます
  • /apis/operator.openshift.io/v1/etcds/{name}/status

    • GET: 指定された Etcd のステータスを読み取ります
    • PATCH: 指定された Etcd のステータスを部分的に更新します
    • PUT: 指定された Etcd のステータスを置き換えます

12.2.1. /apis/operator.openshift.io/v1/etcds

HTTP メソッド
DELETE
説明
Etcd のコレクションを削除する
表12.1 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類 Etcd のオブジェクトをリスト表示します
表12.2 HTTP 応答
HTTP コード応答本文

200 - OK

EtcdList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
Etcd を作成する
表12.3 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表12.4 本文パラメーター
パラメータータイプ説明

body

Etcd スキーマ

 
表12.5 HTTP 応答
HTTP コード応答本文

200 - OK

Etcd スキーマ

201 - Created

Etcd スキーマ

202 - Accepted

Etcd スキーマ

401 - Unauthorized

空白

12.2.2. /apis/operator.openshift.io/v1/etcds/{name}

表12.6 グローバルパスパラメーター
パラメータータイプ説明

name

string

Etcd の名前

HTTP メソッド
DELETE
説明
Etcd を削除する
表12.7 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表12.8 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定された Etcd を読む
表12.9 HTTP 応答
HTTP コード応答本文

200 - OK

Etcd スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された Etcd を部分的に更新します
表12.10 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表12.11 HTTP 応答
HTTP コード応答本文

200 - OK

Etcd スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された Etcd を交換してください
表12.12 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表12.13 本文パラメーター
パラメータータイプ説明

body

Etcd スキーマ

 
表12.14 HTTP 応答
HTTP コード応答本文

200 - OK

Etcd スキーマ

201 - Created

Etcd スキーマ

401 - Unauthorized

空白

12.2.3. /apis/operator.openshift.io/v1/etcds/{name}/status

表12.15 グローバルパスパラメーター
パラメータータイプ説明

name

string

Etcd の名前

HTTP メソッド
GET
説明
指定された Etcd のステータスを読み取ります
表12.16 HTTP 応答
HTTP コード応答本文

200 - OK

Etcd スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された Etcd のステータスを部分的に更新します
表12.17 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表12.18 HTTP 応答
HTTP コード応答本文

200 - OK

Etcd スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された Etcd のステータスを置き換えます
表12.19 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表12.20 本文パラメーター
パラメータータイプ説明

body

Etcd スキーマ

 
表12.21 HTTP 応答
HTTP コード応答本文

200 - OK

Etcd スキーマ

201 - Created

Etcd スキーマ

401 - Unauthorized

空白

第13章 ImageContentSourcePolicy [operator.openshift.io/v1alpha1]

説明
ImageContentSourcePolicy は、レジストリーミラールールの処理方法に関するクラスター全体の情報を保持します。複数のポリシーが定義されている場合、動作の結果は各フィールドで定義されます。互換性レベル 4: 互換性は提供されていません。API は、理由を問わずいつでも変更できます。これらの機能は、長期サポートを必要とするアプリケーションで使用することはできません。
object
必須
  • spec

13.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 は、ユーザーが設定可能な設定値を保持します。

13.1.1. .spec

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

repositoryDigestMirrors

array

repositoryDigestMirrors を使用すると、Pod 内のイメージダイジェストによって参照されるイメージを、ミラーリングされた代替のリポジトリーの場所から取得できます。Pod に提供されるイメージプル仕様は、RepositoryDigestMirrors で説明されているソースの場所と比較され、管理者が潜在的に高速なミラーを選択できるように、指定されたリポジトリーではなく、リスト内の任意のミラーからイメージをプルダウンできます。イメージダイジェストを持つイメージプル仕様にのみ、この動作が適用されます。タグは、プル仕様で指定されたリポジトリーから引き続きプルされます。各 “ソース” リポジトリーは独立して扱われます。異なる “ソース” リポジトリーの設定は相互作用しません。同じ “ソース” リポジトリーに対して複数のポリシーが定義されている場合、定義されたミラーのセットは一緒にマージされ、可能であればミラーの相対的な順序が維持されます。たとえば、ポリシー A にミラー a、b、c があり、ポリシー B にミラー c、d、e がある場合、ミラーは a、b、c、d、e の順序で使用されます。ミラーエントリーの順序が競合する場合 (たとえば a, bb, a) 設定は拒否されませんが、結果の順序は指定されていません。

repositoryDigestMirrors[]

object

RepositoryDigestMirrors は、レジストリー設定で mirros を処理する方法に関するクラスター全体の情報を保持します。注: ミラーは、ダイジェストによって参照されるイメージをプルする場合にのみ機能します。

13.1.2. .spec.repositoryDigestMirrors

説明
repositoryDigestMirrors を使用すると、Pod 内のイメージダイジェストによって参照されるイメージを、ミラーリングされた代替のリポジトリーの場所から取得できます。Pod に提供されるイメージプル仕様は、RepositoryDigestMirrors で説明されているソースの場所と比較され、管理者が潜在的に高速なミラーを選択できるように、指定されたリポジトリーではなく、リスト内の任意のミラーからイメージをプルダウンできます。イメージダイジェストを持つイメージプル仕様にのみ、この動作が適用されます。タグは、プル仕様で指定されたリポジトリーから引き続きプルされます。各 “ソース” リポジトリーは独立して扱われます。異なる “ソース” リポジトリーの設定は相互作用しません。同じ “ソース” リポジトリーに対して複数のポリシーが定義されている場合、定義されたミラーのセットは一緒にマージされ、可能であればミラーの相対的な順序が維持されます。たとえば、ポリシー A にミラー a、b、c があり、ポリシー B にミラー c、d、e がある場合、ミラーは a、b、c、d、e の順序で使用されます。ミラーエントリーの順序が競合する場合 (たとえば a, bb, a) 設定は拒否されませんが、結果の順序は指定されていません。
array

13.1.3. .spec.repositoryDigestMirrors[]

説明
RepositoryDigestMirrors は、レジストリー設定で mirros を処理する方法に関するクラスター全体の情報を保持します。注: ミラーは、ダイジェストによって参照されるイメージをプルする場合にのみ機能します。
object
必須
  • source
プロパティータイプ説明

mirrors

array (string)

同じイメージが含まれる可能性のあるリポジトリーを 1 つ以上指定します。このリスト内のミラーの順序はユーザーの希望する優先度として扱われますが、ソースはデフォルトですべてのミラーよりも低い優先度と見なされます。他の repositoryDigestMirrors オブジェクトを含む (ただしこれらに限定されない) 他のクラスター設定は、ミラーが接続される正確な順序に影響を与える可能性があります。

source

string

source は、たとえばイメージプル仕様でユーザーが参照するリポジトリーです。

13.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/operator.openshift.io/v1alpha1/imagecontentsourcepolicies

    • DELETE:ImageContentSourcePolicy のコレクションを削除します
    • GET: 種類のオブジェクトをリスト表示する ImageContentSourcePolicy
    • POST:ImageContentSourcePolicy を作成します
  • /apis/operator.openshift.io/v1alpha1/imagecontentsourcepolicies/{name}

    • 削除:ImageContentSourcePolicy を削除します
    • GET: 指定された ImageContentSourcePolicy を読み取ります
    • PATCH: 指定された ImageContentSourcePolicy を部分的に更新します
    • PUT: 指定された ImageContentSourcePolicy を置き換えます
  • /apis/operator.openshift.io/v1alpha1/imagecontentsourcepolicies/{name}/status

    • GET: 指定された ImageContentSourcePolicy のステータスを読み取ります
    • PATCH: 指定された ImageContentSourcePolicy のステータスを部分的に更新します
    • PUT: 指定された ImageContentSourcePolicy のステータスを置き換えます

13.2.1. /apis/operator.openshift.io/v1alpha1/imagecontentsourcepolicies

HTTP メソッド
DELETE
説明
ImageContentSourcePolicy のコレクションを削除します
表13.1 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類のオブジェクトをリスト表示する ImageContentSourcePolicy
表13.2 HTTP 応答
HTTP コード応答本文

200 - OK

ImageContentSourcePolicyList schema

401 - Unauthorized

空白

HTTP メソッド
POST
説明
ImageContentSourcePolicy を作成します
表13.3 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表13.4 本文パラメーター
パラメータータイプ説明

body

ImageContentSourcePolicy スキーマ

 
表13.5 HTTP 応答
HTTP コード応答本文

200 - OK

ImageContentSourcePolicy スキーマ

201 - Created

ImageContentSourcePolicy スキーマ

202 - Accepted

ImageContentSourcePolicy スキーマ

401 - Unauthorized

空白

13.2.2. /apis/operator.openshift.io/v1alpha1/imagecontentsourcepolicies/{name}

表13.6 グローバルパスパラメーター
パラメータータイプ説明

name

string

ImageContentSourcePolicy の名前

HTTP メソッド
DELETE
説明
ImageContentSourcePolicy を削除します
表13.7 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表13.8 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定された ImageContentSourcePolicy を読み取ります
表13.9 HTTP 応答
HTTP コード応答本文

200 - OK

ImageContentSourcePolicy スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された ImageContentSourcePolicy を部分的に更新します
表13.10 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表13.11 HTTP 応答
HTTP コード応答本文

200 - OK

ImageContentSourcePolicy スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された ImageContentSourcePolicy を置き換えます
表13.12 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表13.13 本文パラメーター
パラメータータイプ説明

body

ImageContentSourcePolicy スキーマ

 
表13.14 HTTP 応答
HTTP コード応答本文

200 - OK

ImageContentSourcePolicy スキーマ

201 - Created

ImageContentSourcePolicy スキーマ

401 - Unauthorized

空白

13.2.3. /apis/operator.openshift.io/v1alpha1/imagecontentsourcepolicies/{name}/status

表13.15 グローバルパスパラメーター
パラメータータイプ説明

name

string

ImageContentSourcePolicy の名前

HTTP メソッド
GET
説明
指定された ImageContentSourcePolicy のステータスを読み取ります
表13.16 HTTP 応答
HTTP コード応答本文

200 - OK

ImageContentSourcePolicy スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された ImageContentSourcePolicy のステータスを部分的に更新します
表13.17 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表13.18 HTTP 応答
HTTP コード応答本文

200 - OK

ImageContentSourcePolicy スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された ImageContentSourcePolicy のステータスを置き換えます
表13.19 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表13.20 本文パラメーター
パラメータータイプ説明

body

ImageContentSourcePolicy スキーマ

 
表13.21 HTTP 応答
HTTP コード応答本文

200 - OK

ImageContentSourcePolicy スキーマ

201 - Created

ImageContentSourcePolicy スキーマ

401 - Unauthorized

空白

第14章 ImagePruner [imageregistry.operator.openshift.io/v1]

説明
ImagePruner は、レジストリー Operator によって管理されるイメージレジストリープルーナーの設定オブジェクトです。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object
必須
  • metadata
  • spec

14.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

ImagePrunerSpec は、実行中のイメージ剪定ばさみの仕様を定義します。

status

object

ImagePrunerStatus は、イメージプルーナーの動作ステータスを報告します。

14.1.1. .spec

説明
ImagePrunerSpec は、実行中のイメージ剪定ばさみの仕様を定義します。
object
プロパティータイプ説明

affinity

object

アフィニティーは、イメージ剪定ばさみ Pod のノードアフィニティースケジューリングルールのグループです。

failedJobsHistoryLimit

integer

failedJobsHistoryLimit は、保持する失敗したイメージプルーナージョブの数を指定します。設定されていない場合は、デフォルトで 3 に設定されます。

ignoreInvalidImageReferences

boolean

ignoreInvalidImageReferences は、イメージ参照の解析中にプルーナーがエラーを無視できるかどうかを示します。

keepTagRevisions

integer

keepTagRevisions は、保持されるイメージストリーム内のタグのイメージリビジョンの数を指定します。デフォルトは 3 です。

keepYoungerThan

integer

keepYoungerThan は、プルーニングの候補と見なされるイメージとそのリファラーの最小年齢をナノ秒単位で指定します。非推奨: このフィールドは非推奨になり、keepYoungerThanDuration が優先されます。両方が設定されている場合、このフィールドは無視され、keepYoungerThanDuration が優先されます。

keepYoungerThanDuration

string

keepYoungerThanDuration は、プルーニングの候補と見なされるイメージとそのリファラーの最小年齢を指定します。デフォルトは 60m (60 分) です。

logLevel

string

logLevel は、プルーナージョブのログ出力のレベルを設定します。有効な値は、"Normal"、"Debug"、"Trace"、"TraceAll" です。Defaults to "Normal".

nodeSelector

object (string)

nodeSelector は、イメージ剪定ばさみ Pod のノード選択制約を定義します。

resources

object

resources は、イメージ剪定ばさみ Pod のリソース要求と制限を定義します。

スケジュール

string

スケジュールは、標準の cronjob 構文を使用してジョブを実行するタイミングを指定します (https://wikipedia.org/wiki/Cron)。デフォルトは 0 0 * * * です。

successfulJobsHistoryLimit

integer

successfulJobsHistoryLimit は、保持する成功したイメージプルーナージョブの数を指定します。設定されていない場合は、デフォルトで 3 に設定されます。

suspend

boolean

suspend は、この cron ジョブの後続の実行を一時停止するかどうかを指定します。デフォルトは false です。

tolerations

array

tolerations は、イメージ剪定ばさみ Pod のノード許容値を定義します。

tolerations[]

object

この toleration が割り当てられる Pod は、マッチング Operator <operator> を使用してトリプル <key,value,effect> と一致するテイントを許容します。

14.1.2. .spec.affinity

説明
アフィニティーは、イメージ剪定ばさみ Pod のノードアフィニティースケジューリングルールのグループです。
object
プロパティータイプ説明

nodeAffinity

object

Pod のノードアフィニティースケジューリングルールを説明します。

podAffinity

object

Pod アフィニティースケジューリングルールを説明します (たとえば、この Pod を他の Pod と同じノード、ゾーンなどに配置します)。

podAntiAffinity

object

Pod の非アフィニティースケジューリングルールを説明します (たとえば、この Pod を他の Pod と同じノード、ゾーンなどに配置しないでください)。

14.1.3. .spec.affinity.nodeAffinity

説明
Pod のノードアフィニティースケジューリングルールを説明します。
object
プロパティータイプ説明

preferredDuringSchedulingIgnoredDuringExecution

array

スケジューラーは、このフィールドで指定されたアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アフィニティー式など) を満たすノードごとに、このフィールドの要素を反復処理して合計を計算します。ノードが対応する matchExpressions と一致する場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。

preferredDuringSchedulingIgnoredDuringExecution[]

object

空の優先スケジューリング用語は、暗黙の重み 0 を持つすべてのオブジェクトに一致します (つまり、操作なしです)。null の優先スケジューリング用語は、オブジェクトに一致しません (つまり、no-op でもあります)。

requiredDuringSchedulingIgnoredDuringExecution

object

このフィールドで指定されたアフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定されたアフィニティー要件が Pod 実行中のある時点で満たされない場合 (更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。

14.1.4. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution

説明
スケジューラーは、このフィールドで指定されたアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アフィニティー式など) を満たすノードごとに、このフィールドの要素を反復処理して合計を計算します。ノードが対応する matchExpressions と一致する場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。
タイプ
array

14.1.5. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[]

説明
空の優先スケジューリング用語は、暗黙の重み 0 を持つすべてのオブジェクトに一致します (つまり、操作なしです)。null の優先スケジューリング用語は、オブジェクトに一致しません (つまり、no-op でもあります)。
タイプ
object
必須
  • preference
  • weight
プロパティータイプ説明

preference

object

対応する重みに関連付けられたノードセレクター用語。

weight

integer

対応する nodeSelectorTerm の一致に関連する重み (1〜100 の範囲)。

14.1.6. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference

説明
対応する重みに関連付けられたノードセレクター用語。
object
プロパティータイプ説明

matchExpressions

array

ノードのラベルごとのノードセレクター要件のリスト。

matchExpressions[]

object

ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchFields

array

ノードのフィールドごとのノードセレクター要件のリスト。

matchFields[]

object

ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

14.1.7. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchExpressions

説明
ノードのラベルごとのノードセレクター要件のリスト。
タイプ
array

14.1.8. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchExpressions[]

説明
ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

セレクターが適用されるラベルキー。

operator

string

キーと値のセットの関係を表します。有効な Operator は、In、NotIn、Exists、DoesNotExist です。Gt、および Lt。

array (string)

文字列値の配列。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。Operator が Gt または Lt の場合、values 配列には、整数として解釈される単一の要素が必要です。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

14.1.9. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchFields

説明
ノードのフィールドごとのノードセレクター要件のリスト。
タイプ
array

14.1.10. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchFields[]

説明
ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

セレクターが適用されるラベルキー。

operator

string

キーと値のセットの関係を表します。有効な Operator は、In、NotIn、Exists、DoesNotExist です。Gt、および Lt。

array (string)

文字列値の配列。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。Operator が Gt または Lt の場合、values 配列には、整数として解釈される単一の要素が必要です。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

14.1.11. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution

説明
このフィールドで指定されたアフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定されたアフィニティー要件が Pod 実行中のある時点で満たされない場合 (更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。
object
必須
  • nodeSelectorTerms
プロパティータイプ説明

nodeSelectorTerms

array

必須。ノードセレクター用語のリスト。用語は OR されています。

nodeSelectorTerms[]

object

null または空のノードセレクター用語はオブジェクトに一致しません。これらの要件は AND で結合されます。TopologySelectorTerm タイプは、NodeSelectorTerm のサブセットを実装します。

14.1.12. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms

説明
必須。ノードセレクター用語のリスト。用語は OR されています。
タイプ
array

14.1.13. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[]

説明
null または空のノードセレクター用語はオブジェクトに一致しません。これらの要件は AND で結合されます。TopologySelectorTerm タイプは、NodeSelectorTerm のサブセットを実装します。
タイプ
object
プロパティータイプ説明

matchExpressions

array

ノードのラベルごとのノードセレクター要件のリスト。

matchExpressions[]

object

ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchFields

array

ノードのフィールドごとのノードセレクター要件のリスト。

matchFields[]

object

ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

14.1.14. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchExpressions

説明
ノードのラベルごとのノードセレクター要件のリスト。
タイプ
array

14.1.15. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchExpressions[]

説明
ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

セレクターが適用されるラベルキー。

operator

string

キーと値のセットの関係を表します。有効な Operator は、In、NotIn、Exists、DoesNotExist です。Gt、および Lt。

array (string)

文字列値の配列。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。Operator が Gt または Lt の場合、values 配列には、整数として解釈される単一の要素が必要です。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

14.1.16. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchFields

説明
ノードのフィールドごとのノードセレクター要件のリスト。
タイプ
array

14.1.17. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchFields[]

説明
ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

セレクターが適用されるラベルキー。

operator

string

キーと値のセットの関係を表します。有効な Operator は、In、NotIn、Exists、DoesNotExist です。Gt、および Lt。

array (string)

文字列値の配列。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。Operator が Gt または Lt の場合、values 配列には、整数として解釈される単一の要素が必要です。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

14.1.18. .spec.affinity.podAffinity

説明
Pod アフィニティースケジューリングルールを説明します (たとえば、この Pod を他の Pod と同じノード、ゾーンなどに配置します)。
object
プロパティータイプ説明

preferredDuringSchedulingIgnoredDuringExecution

array

スケジューラーは、このフィールドで指定されたアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アフィニティー式など) を満たすノードごとに、このフィールドの要素を反復処理して合計を計算します。ノードに対応する podAffinityTerm に一致する Pod がある場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。

preferredDuringSchedulingIgnoredDuringExecution[]

object

一致したすべての WeightedPodAffinityTerm フィールドの重みがノードごとに追加され、最も優先されるノードが検索されます。

requiredDuringSchedulingIgnoredDuringExecution

array

このフィールドで指定されたアフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定されたアフィニティー要件が Pod 実行中のある時点で満たされない場合 (Pod ラベルの更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。複数の要素がある場合、各 podAffinityTerm に対応するノードのリストが交差します。つまり、すべての用語が満たされる必要があります。

requiredDuringSchedulingIgnoredDuringExecution[]

object

この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。ここで、同じ場所は次のように定義されます。キー <topologyKey> のラベルの値が、Pod のセットの Pod が実行されているノードの値と一致するノードで実行されている

14.1.19. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution

説明
スケジューラーは、このフィールドで指定されたアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アフィニティー式など) を満たすノードごとに、このフィールドの要素を反復処理して合計を計算します。ノードに対応する podAffinityTerm に一致する Pod がある場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。
タイプ
array

14.1.20. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[]

説明
一致したすべての WeightedPodAffinityTerm フィールドの重みがノードごとに追加され、最も優先されるノードが検索されます。
タイプ
object
必須
  • podAffinityTerm
  • weight
プロパティータイプ説明

podAffinityTerm

object

必須。対応する重みに関連付けられた Pod アフィニティー用語。

weight

integer

対応する podAffinityTerm の一致に関連する重み (1〜100 の範囲)。

14.1.21. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm

説明
必須。対応する重みに関連付けられた Pod アフィニティー用語。
object
必須
  • topologyKey
プロパティータイプ説明

labelSelector

object

リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。

matchLabelKeys

array (string)

MatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは key in (value) として labelSelector にマージされ、着信 Pod の Pod アフィニティー (アンチアフィニティー) として考慮される既存の Pod のグループを選択します。受信 Pod ラベルに存在しないキーは無視されます。デフォルト値は空です。同じキーが MatchLabelKeys と LabelSelector の両方に存在することはできません。また、labelSelector が設定されていない場合、matchLabelKeys は設定できません。これはアルファフィールドであり、MatchLabelKeysInPodAffinity フィーチャーゲートを有効にする必要があります。

mismatchLabelKeys

array (string)

MismatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは key notin (value) として labelSelector にマージされ、着信 Pod の Pod アフィニティー (アンチアフィニティー) として考慮される既存の Pod のグループを選択します。受信 Pod ラベルに存在しないキーは無視されます。デフォルト値は空です。mismatchLabelKeys と labelSelector の両方に同じキーが存在することは禁止されています。また、labelSelector が設定されていない場合、mismatchLabelKeys は設定できません。これはアルファフィールドであり、MatchLabelKeysInPodAffinity フィーチャーゲートを有効にする必要があります。

namespaceSelector

object

用語が適用される名前空間のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての名前空間に一致します。

namespace

array (string)

namespaces は、用語が適用される名前空間名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび nullnamespaceSelector は、"この Pod の namespace" を意味します

topologyKey

string

この Pod は、指定された名前空間の labelSelector と一致する Pod と同じ場所に配置 (アフィニティー) するか、同じ場所に配置しない (アンチアフィニティー) 必要があります。ここで、同じ場所に配置されるのは、キー topologyKey を持つラベルの値を持つノードで実行されるものとして定義されます。選択した Pod のいずれかが実行されているノードのノードと一致します。空の topologyKey は許可されていません。

14.1.22. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector

説明
リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。
object
プロパティータイプ説明

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

14.1.23. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector.matchExpressions

説明
matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
array

14.1.24. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector.matchExpressions[]

説明
ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

14.1.25. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector

説明
用語が適用される名前空間のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての名前空間に一致します。
object
プロパティータイプ説明

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

14.1.26. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector.matchExpressions

説明
matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
array

14.1.27. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector.matchExpressions[]

説明
ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

14.1.28. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution

説明
このフィールドで指定されたアフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定されたアフィニティー要件が Pod 実行中のある時点で満たされない場合 (Pod ラベルの更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。複数の要素がある場合、各 podAffinityTerm に対応するノードのリストが交差します。つまり、すべての用語が満たされる必要があります。
タイプ
array

14.1.29. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[]

説明
この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。ここで、同じ場所は次のように定義されます。キー <topologyKey> のラベルの値が、Pod のセットの Pod が実行されているノードの値と一致するノードで実行されている
タイプ
object
必須
  • topologyKey
プロパティータイプ説明

labelSelector

object

リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。

matchLabelKeys

array (string)

MatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは key in (value) として labelSelector にマージされ、着信 Pod の Pod アフィニティー (アンチアフィニティー) として考慮される既存の Pod のグループを選択します。受信 Pod ラベルに存在しないキーは無視されます。デフォルト値は空です。同じキーが MatchLabelKeys と LabelSelector の両方に存在することはできません。また、labelSelector が設定されていない場合、matchLabelKeys は設定できません。これはアルファフィールドであり、MatchLabelKeysInPodAffinity フィーチャーゲートを有効にする必要があります。

mismatchLabelKeys

array (string)

MismatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは key notin (value) として labelSelector にマージされ、着信 Pod の Pod アフィニティー (アンチアフィニティー) として考慮される既存の Pod のグループを選択します。受信 Pod ラベルに存在しないキーは無視されます。デフォルト値は空です。mismatchLabelKeys と labelSelector の両方に同じキーが存在することは禁止されています。また、labelSelector が設定されていない場合、mismatchLabelKeys は設定できません。これはアルファフィールドであり、MatchLabelKeysInPodAffinity フィーチャーゲートを有効にする必要があります。

namespaceSelector

object

用語が適用される名前空間のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての名前空間に一致します。

namespace

array (string)

namespaces は、用語が適用される名前空間名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび nullnamespaceSelector は、"この Pod の namespace" を意味します

topologyKey

string

この Pod は、指定された名前空間の labelSelector と一致する Pod と同じ場所に配置 (アフィニティー) するか、同じ場所に配置しない (アンチアフィニティー) 必要があります。ここで、同じ場所に配置されるのは、キー topologyKey を持つラベルの値を持つノードで実行されるものとして定義されます。選択した Pod のいずれかが実行されているノードのノードと一致します。空の topologyKey は許可されていません。

14.1.30. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector

説明
リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。
object
プロパティータイプ説明

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

14.1.31. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector.matchExpressions

説明
matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
array

14.1.32. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector.matchExpressions[]

説明
ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

14.1.33. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector

説明
用語が適用される名前空間のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての名前空間に一致します。
object
プロパティータイプ説明

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

14.1.34. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector.matchExpressions

説明
matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
array

14.1.35. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector.matchExpressions[]

説明
ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

14.1.36. .spec.affinity.podAntiAffinity

説明
Pod の非アフィニティースケジューリングルールを説明します (たとえば、この Pod を他の Pod と同じノード、ゾーンなどに配置しないでください)。
object
プロパティータイプ説明

preferredDuringSchedulingIgnoredDuringExecution

array

スケジューラーは、このフィールドで指定されたアンチアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アンチアフィニティー式など) を満たすノードごとに、の要素を反復処理して合計を計算します。このフィールドと、対応する podAffinityTerm に一致する Pod がノードにある場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。

preferredDuringSchedulingIgnoredDuringExecution[]

object

一致したすべての WeightedPodAffinityTerm フィールドの重みがノードごとに追加され、最も優先されるノードが検索されます。

requiredDuringSchedulingIgnoredDuringExecution

array

このフィールドで指定されたアンチアフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定されたアンチアフィニティー要件が Pod 実行中のある時点で満たされない場合 (Pod ラベルの更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。複数の要素がある場合、各 podAffinityTerm に対応するノードのリストが交差します。つまり、すべての用語が満たされる必要があります。

requiredDuringSchedulingIgnoredDuringExecution[]

object

この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。ここで、同じ場所は次のように定義されます。キー <topologyKey> のラベルの値が、Pod のセットの Pod が実行されているノードの値と一致するノードで実行されている

14.1.37. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution

説明
スケジューラーは、このフィールドで指定されたアンチアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アンチアフィニティー式など) を満たすノードごとに、の要素を反復処理して合計を計算します。このフィールドと、対応する podAffinityTerm に一致する Pod がノードにある場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。
タイプ
array

14.1.38. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[]

説明
一致したすべての WeightedPodAffinityTerm フィールドの重みがノードごとに追加され、最も優先されるノードが検索されます。
タイプ
object
必須
  • podAffinityTerm
  • weight
プロパティータイプ説明

podAffinityTerm

object

必須。対応する重みに関連付けられた Pod アフィニティー用語。

weight

integer

対応する podAffinityTerm の一致に関連する重み (1〜100 の範囲)。

14.1.39. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm

説明
必須。対応する重みに関連付けられた Pod アフィニティー用語。
object
必須
  • topologyKey
プロパティータイプ説明

labelSelector

object

リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。

matchLabelKeys

array (string)

MatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは key in (value) として labelSelector にマージされ、着信 Pod の Pod アフィニティー (アンチアフィニティー) として考慮される既存の Pod のグループを選択します。受信 Pod ラベルに存在しないキーは無視されます。デフォルト値は空です。同じキーが MatchLabelKeys と LabelSelector の両方に存在することはできません。また、labelSelector が設定されていない場合、matchLabelKeys は設定できません。これはアルファフィールドであり、MatchLabelKeysInPodAffinity フィーチャーゲートを有効にする必要があります。

mismatchLabelKeys

array (string)

MismatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは key notin (value) として labelSelector にマージされ、着信 Pod の Pod アフィニティー (アンチアフィニティー) として考慮される既存の Pod のグループを選択します。受信 Pod ラベルに存在しないキーは無視されます。デフォルト値は空です。mismatchLabelKeys と labelSelector の両方に同じキーが存在することは禁止されています。また、labelSelector が設定されていない場合、mismatchLabelKeys は設定できません。これはアルファフィールドであり、MatchLabelKeysInPodAffinity フィーチャーゲートを有効にする必要があります。

namespaceSelector

object

用語が適用される名前空間のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての名前空間に一致します。

namespace

array (string)

namespaces は、用語が適用される名前空間名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび nullnamespaceSelector は、"この Pod の namespace" を意味します

topologyKey

string

この Pod は、指定された名前空間の labelSelector と一致する Pod と同じ場所に配置 (アフィニティー) するか、同じ場所に配置しない (アンチアフィニティー) 必要があります。ここで、同じ場所に配置されるのは、キー topologyKey を持つラベルの値を持つノードで実行されるものとして定義されます。選択した Pod のいずれかが実行されているノードのノードと一致します。空の topologyKey は許可されていません。

14.1.40. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector

説明
リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。
object
プロパティータイプ説明

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

14.1.41. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector.matchExpressions

説明
matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
array

14.1.42. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector.matchExpressions[]

説明
ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

14.1.43. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector

説明
用語が適用される名前空間のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての名前空間に一致します。
object
プロパティータイプ説明

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

14.1.44. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector.matchExpressions

説明
matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
array

14.1.45. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector.matchExpressions[]

説明
ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

14.1.46. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution

説明
このフィールドで指定されたアンチアフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定されたアンチアフィニティー要件が Pod 実行中のある時点で満たされない場合 (Pod ラベルの更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。複数の要素がある場合、各 podAffinityTerm に対応するノードのリストが交差します。つまり、すべての用語が満たされる必要があります。
タイプ
array

14.1.47. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[]

説明
この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。ここで、同じ場所は次のように定義されます。キー <topologyKey> のラベルの値が、Pod のセットの Pod が実行されているノードの値と一致するノードで実行されている
タイプ
object
必須
  • topologyKey
プロパティータイプ説明

labelSelector

object

リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。

matchLabelKeys

array (string)

MatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは key in (value) として labelSelector にマージされ、着信 Pod の Pod アフィニティー (アンチアフィニティー) として考慮される既存の Pod のグループを選択します。受信 Pod ラベルに存在しないキーは無視されます。デフォルト値は空です。同じキーが MatchLabelKeys と LabelSelector の両方に存在することはできません。また、labelSelector が設定されていない場合、matchLabelKeys は設定できません。これはアルファフィールドであり、MatchLabelKeysInPodAffinity フィーチャーゲートを有効にする必要があります。

mismatchLabelKeys

array (string)

MismatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは key notin (value) として labelSelector にマージされ、着信 Pod の Pod アフィニティー (アンチアフィニティー) として考慮される既存の Pod のグループを選択します。受信 Pod ラベルに存在しないキーは無視されます。デフォルト値は空です。mismatchLabelKeys と labelSelector の両方に同じキーが存在することは禁止されています。また、labelSelector が設定されていない場合、mismatchLabelKeys は設定できません。これはアルファフィールドであり、MatchLabelKeysInPodAffinity フィーチャーゲートを有効にする必要があります。

namespaceSelector

object

用語が適用される名前空間のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての名前空間に一致します。

namespace

array (string)

namespaces は、用語が適用される名前空間名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび nullnamespaceSelector は、"この Pod の namespace" を意味します

topologyKey

string

この Pod は、指定された名前空間の labelSelector と一致する Pod と同じ場所に配置 (アフィニティー) するか、同じ場所に配置しない (アンチアフィニティー) 必要があります。ここで、同じ場所に配置されるのは、キー topologyKey を持つラベルの値を持つノードで実行されるものとして定義されます。選択した Pod のいずれかが実行されているノードのノードと一致します。空の topologyKey は許可されていません。

14.1.48. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector

説明
リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。
object
プロパティータイプ説明

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

14.1.49. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector.matchExpressions

説明
matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
array

14.1.50. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector.matchExpressions[]

説明
ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

14.1.51. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector

説明
用語が適用される名前空間のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての名前空間に一致します。
object
プロパティータイプ説明

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

14.1.52. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector.matchExpressions

説明
matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
array

14.1.53. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector.matchExpressions[]

説明
ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

14.1.54. .spec.resources

説明
resources は、イメージ剪定ばさみ Pod のリソース要求と制限を定義します。
object
プロパティータイプ説明

claims

array

Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。このフィールドは不変です。これはコンテナーにのみ設定できます。

claims[]

object

ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。

limits

integer-or-string

limits は、許可されるコンピュートリソースの最大量を示します。詳細: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

requests

integer-or-string

requests は、必要なコンピュートリソースの最小量を示します。コンテナーについて Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

14.1.55. .spec.resources.claims

説明
Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。このフィールドは不変です。これはコンテナーにのみ設定できます。
タイプ
array

14.1.56. .spec.resources.claims[]

説明
ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。
タイプ
object
必須
  • name
プロパティータイプ説明

name

string

Name must match the name of one entry in pod.spec.resourceClaims of the Pod where this field is used.これにより、そのリソースがコンテナー内で利用可能になります。

14.1.57. .spec.tolerations

説明
tolerations は、イメージ剪定ばさみ Pod のノード許容値を定義します。
array

14.1.58. .spec.tolerations[]

説明
この toleration が割り当てられる Pod は、マッチング Operator <operator> を使用してトリプル <key,value,effect> と一致するテイントを許容します。
タイプ
object
プロパティータイプ説明

effect

string

effect は、照合するテイントの効果を示します。空の場合は、すべてのテイント効果に一致します。指定されている場合、許可される値は NoSchedule、PreferNoSchedule、および NoExecute です。

key

string

key は toleration が適用されるテイントキーです。空の場合は、すべてのテイントキーに一致します。キーが空の場合、Operator は Exists である必要があります。この組み合わせは、すべての値とすべてのキーに一致することを意味します。

operator

string

Operator はキーと値の関係を表します。有効な Operator は Exists および Equal です。デフォルトは Equal です。Exists は、値のワイルドカードと同等であるため、Pod は特定のカテゴリーのすべてのテイントに耐えることができます。

tolerationSeconds

integer

tolerationSeconds は、toleration (effect は NoExecute でなければならず、NoExecute 以外の場合このフィールドは無視されます) がテイントを許容する期間を表します。デフォルトでは設定されていません。つまり、テイントを永久に許容します (エビクトしないでください)。ゼロ値と負の値は、システムによって 0 (すぐにエビクト) として扱われます。

value

string

value は、toleration が一致するテイントの値です。Operator が Exists の場合、値は空である必要があります。それ以外の場合は、通常の文字列のみになります。

14.1.59. .status

説明
ImagePrunerStatus は、イメージプルーナーの動作ステータスを報告します。
object
プロパティータイプ説明

conditions

array

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

conditions[]

object

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

observedGeneration

integer

observedGeneration は、適用された最後の世代の変更です。

14.1.60. .status.conditions

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

14.1.61. .status.conditions[]

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

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

14.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/imageregistry.operator.openshift.io/v1/imagepruners

    • DELETE:ImagePruner のコレクションを削除します
    • GET: 種類が ImagePruner のオブジェクトをリスト表示します。
    • POST:ImagePruner を作成します
  • /apis/imageregistry.operator.openshift.io/v1/imagepruners/{name}

    • 削除:ImagePruner を削除します
    • GET: 指定された ImagePruner を読み取ります
    • PATCH: 指定された ImagePruner を部分的に更新します
    • PUT: 指定された ImagePruner を置き換えます
  • /apis/imageregistry.operator.openshift.io/v1/imagepruners/{name}/status

    • GET: 指定された ImagePruner のステータスを読み取ります
    • PATCH: 指定された ImagePruner のステータスを部分的に更新します
    • PUT: 指定された ImagePruner のステータスを置き換えます

14.2.1. /apis/imageregistry.operator.openshift.io/v1/imagepruners

HTTP メソッド
DELETE
説明
ImagePruner のコレクションを削除します
表14.1 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類のオブジェクトをリスト表示する ImagePruner
表14.2 HTTP 応答
HTTP コード応答本文

200 - OK

ImagePrunerList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
ImagePruner を作成する
表14.3 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表14.4 本文パラメーター
パラメータータイプ説明

body

ImagePruner スキーマ

 
表14.5 HTTP 応答
HTTP コード応答本文

200 - OK

ImagePruner スキーマ

201 - Created

ImagePruner スキーマ

202 - Accepted

ImagePruner スキーマ

401 - Unauthorized

空白

14.2.2. /apis/imageregistry.operator.openshift.io/v1/imagepruners/{name}

表14.6 グローバルパスパラメーター
パラメータータイプ説明

name

string

ImagePruner の名前

HTTP メソッド
DELETE
説明
ImagePruner を削除します
表14.7 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表14.8 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定された ImagePruner を読み取ります
表14.9 HTTP 応答
HTTP コード応答本文

200 - OK

ImagePruner スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された ImagePruner を部分的に更新します
表14.10 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表14.11 HTTP 応答
HTTP コード応答本文

200 - OK

ImagePruner スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された ImagePruner を置き換えます
表14.12 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表14.13 本文パラメーター
パラメータータイプ説明

body

ImagePruner スキーマ

 
表14.14 HTTP 応答
HTTP コード応答本文

200 - OK

ImagePruner スキーマ

201 - Created

ImagePruner スキーマ

401 - Unauthorized

空白

14.2.3. /apis/imageregistry.operator.openshift.io/v1/imagepruners/{name}/status

表14.15 グローバルパスパラメーター
パラメータータイプ説明

name

string

ImagePruner の名前

HTTP メソッド
GET
説明
指定された ImagePruner のステータスを読み取ります
表14.16 HTTP 応答
HTTP コード応答本文

200 - OK

ImagePruner スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された ImagePruner のステータスを部分的に更新します
表14.17 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表14.18 HTTP 応答
HTTP コード応答本文

200 - OK

ImagePruner スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された ImagePruner のステータスを置き換えます
表14.19 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表14.20 本文パラメーター
パラメータータイプ説明

body

ImagePruner スキーマ

 
表14.21 HTTP 応答
HTTP コード応答本文

200 - OK

ImagePruner スキーマ

201 - Created

ImagePruner スキーマ

401 - Unauthorized

空白

第15章 IngressController [operator.openshift.io/v1]

説明
IngressController は、クラスターの管理された入力コントローラーを説明します。コントローラーは、OpenShift Route および Kubernetes Ingress リソースにサービスを提供できます。IngressController が作成されると、新しい ingres コントローラーの配置が作成され、外部トラフィックが Ingress または Route リソースを公開するサービスに到達できるようになります。このリソースを更新すると、新しい ingres コントローラーのリビジョンが公開される可能性があるため、一般向けのネットワーク接続が中断される可能性があります。https://kubernetes.io/docs/concepts/services-networking/ingress-controllers 可能な限り、プラットフォームの適切なデフォルトが使用されます。詳細は、各フィールドを参照してください。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object

15.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 は、IngressController の望ましい動作の仕様です。

status

object

status は、IngressController の最後に観察されたステータスです。

15.1.1. .spec

説明
spec は、IngressController の望ましい動作の仕様です。
object
プロパティータイプ説明

clientTLS

object

clientTLS は、クライアント証明書を要求および検証するための設定を指定します。これを使用して、エッジで終了したルートと再暗号化ルートの相互 TLS を有効にすることができます。

defaultCertificate

object

defaultCertificate は、入力コントローラーによって提供されるデフォルトの証明書を含むシークレットへの参照です。Routes が自身の証明書を指定しない場合、defaultCertificate が使用される。シークレットには、次のキーとデータが含まれている必要があります。tls.crt: 証明書ファイルの内容 tls.key: キーファイルの内容設定されていない場合、ワイルドカード証明書が自動的に生成されて使用されます。この証明書は、ingress コントローラードメイン (およびサブドメイン) に対して有効であり、生成された証明書の CA は、クラスターのトラストストアに自動的に統合されます。ワイルドカード証明書が複数の HTTP/2 対応ルート (ALPN を意味する) によって使用および共有されている場合、クライアント (つまり、特にブラウザー) は自由に開いている接続を再利用できます。これは、クライアントが別のルートへの接続を再利用できることを意味し、それは失敗する可能性があります。この動作は、一般に接続合体として知られています。使用中の証明書 (生成されたものかユーザー指定されたものかを問わず) は、OpenShift の組み込み OAuth サーバーと自動的に統合されます。

domain

string

ドメインは、入力コントローラーによって提供される DNS 名であり、複数の機能を設定するために使用されます。* LoadBalancerService エンドポイント公開戦略の場合、ドメインは DNS レコードを設定するために使用されます。endpointPublishingStrategy を参照してください。* 生成されたデフォルト証明書を使用する場合、証明書はドメインとそのサブドメインに対して有効です。defaultCertificate を参照してください。*値は個々のルートステータスに公開されるため、エンドユーザーは外部 DNS レコードをターゲットにする場所を知ることができます。ドメインはすべての IngressController 間で一意である必要があり、更新できません。空の場合、デフォルトは ingress.config.openshift.io/cluster.spec.domain になります。

endpointPublishingStrategy

object

endpointPublishingStrategy は、入力コントローラーのエンドポイントを他のネットワークに公開したり、ロードバランサーの統合を有効にしたりするために使用されます。設定されていない場合、infrastructure.config.openshift.io/cluster の .status.platform に基づくデフォルトが使用されます。AWS: LoadBalancerService (External スコープ)、Azure: LoadBalancerService (External スコープ)、GCP: LoadBalancerService (External スコープ)、IBMCloud: LoadBalancerService (External スコープ)、AlibabaCloud: LoadBalancerService (External スコープ)、Libvirt: HostNetwork、その他のプラットフォームタイプ (None を含む) では、デフォルトで HostNetwork になります。endpointPublishingStrategy は更新できません。

httpCompression

object

httpCompression は、HTTP トラフィック圧縮のポリシーを定義します。デフォルトでは、HTTP 圧縮はありません。

httpEmptyRequestsPolicy

string

httpEmptyRequestsPolicy は、リクエストを受信する前に接続がタイムアウトした場合の HTTP 接続の処理方法を記述します。このフィールドに使用できる値は "Respond" および "Ignore" です。このフィールドが "Respond" に設定されている場合、ingress コントローラーは HTTP 400 または 408 応答を送信し、接続をログに記録し (アクセスログが有効な場合)、適切なメトリックで接続をカウントします。フィールドが "Ignore" に設定されている場合、Ingress コントローラーは応答を送信せずに接続を閉じると、接続をログに記録するか、メトリックを増分します。デフォルト値は "Respond" です。通常、これらの接続はロードバランサーのヘルスプローブまたは Web ブラウザーの投機的接続 ("事前接続") からのものであり、無視しても問題ありません。ただし、これらの要求はネットワークエラーが原因である可能性もあるため、このフィールドを "Ignore" に設定すると、問題の検出と診断が妨げられる可能性があります。さらに、これらの要求はポートスキャンによって引き起こされる可能性があります。その場合、空の要求をログに記録すると、侵入の試みを検出するのに役立つ場合があります。

httpErrorCodePages

object

httpErrorCodePages は、カスタムエラーページを含む設定マップを指定します。管理者は、openshift-config namespace にこの configmap を作成する必要があります。この設定マップには、"error-page-<error code>.http" の形式のキーが必要です。ここで、<error code> は HTTP エラーコードです。たとえば、"error-page-503.http" は、HTTP503 応答のエラーページを定義します。現在、カスタマイズできるのは 503 および 404 応答のエラーページのみです。configmap の各値は、HTTP ヘッダーを含む完全な応答である必要があります。例 -https://raw.githubusercontent.com/openshift/router/fadab45747a9b30cc3f0a4b41ad2871f95827a93/images/router/haproxy/conf/error-page-503.http (このフィールドが空の場合、入力コントローラーはデフォルトのエラーページを使用します)。

httpHeaders

object

httpHeaders は、HTTP ヘッダーのポリシーを定義します。このフィールドが空の場合、デフォルト値が使用されます。

logging

object

ロギングは、何をどこに記録するかについてパラメーターを定義します。このフィールドが空の場合、操作ログは有効になりますが、アクセスログは無効になります。

namespaceSelector

object

namespaceSelector は、Ingress コントローラーによって提供される namespace セットをフィルターするために使用されます。これはシャードの実装に役立ちます。設定されていない場合、デフォルトはフィルタリングなしです。

nodePlacement

object

nodePlacement は、Ingress コントローラーのスケジュールに対する明示的な制御を有効にします。設定されていない場合、デフォルトが使用されます。詳細は、NodePlacement を参照してください。

replicas

integer

replicas は Ingress コントローラーレプリカの必要な数です。設定されていない場合、クラスターの config.openshift.io/v1/ingresses ステータスの defaultPlacement フィールドの値によってデフォルトが決まります。replicas の値は、Infrastructure CR 内の選択されるフィールドの値に基づいて設定されます。defaultPlacement が ControlPlane に設定されている場合、選択されるフィールドは controlPlaneTopology になります。Workers に設定されている場合、選択されるフィールドは、infrastructureTopology になります。選択されるフィールドの値が SingleReplica か HighlyAvailable かに基づいて、レプリカはそれぞれ 1 または 2 に設定されます。これらのデフォルトは変更される可能性があります。

routeAdmission

object

routeAdmission は、新しいルートクレームを処理するためのポリシーを定義します (たとえば、名前空間全体でクレームを許可または拒否します)。空の場合、デフォルトが適用されます。デフォルトの詳細は、特定の routeAdmission フィールドを参照してください。

routeSelector

object

routeSelector は、Ingress コントローラーによって提供される Routes のセットをフィルターするために使用されます。これはシャードの実装に役立ちます。設定されていない場合、デフォルトはフィルタリングなしです。

tlsSecurityProfile

object

tlsSecurityProfile は、Ingress コントローラーの TLS 接続の設定を指定します。設定されていない場合、デフォルトは apiservers.config.openshift.io/cluster リソースに基づいています。Old、Intermediate、および Modern のプロファイルタイプを使用する場合、有効なプロファイル設定はリリース間で変更される可能性があります。たとえば、リリース X.Y.Z にデプロイされた Intermediate プロファイルを使用する仕様がある場合、リリース X.Y.Z+1 へのアップグレードにより、新規のプロファイル設定が Ingress コントローラーに適用され、ロールアウトが生じる可能性があります。

tuningOptions

object

tuningOptions は、入力コントローラー Pod のパフォーマンスを調整するためのパラメーターを定義します。すべてのフィールドはオプションであり、設定されていない場合はそれぞれのデフォルトを使用します。詳細は、特定の tuningOptions フィールドを参照してください。通常、tuningOptions 内でフィールドを設定することは推奨しません。デフォルト値は、ほとんどの設定に適しています。

unsupportedConfigOverrides

``

unsupportedConfigOverrides を使用すると、サポートされていない設定オプションを指定できます。その使用はサポートされていません。

15.1.2. .spec.clientTLS

説明
clientTLS は、クライアント証明書を要求および検証するための設定を指定します。これを使用して、エッジで終了したルートと再暗号化ルートの相互 TLS を有効にすることができます。
object
必須
  • clientCA
  • clientCertificatePolicy
プロパティータイプ説明

allowedSubjectPatterns

array (string)

allowedSubjectPatterns は、リクエストをフィルタリングするために有効なクライアント証明書の識別名と照合する必要がある正規表現のリストを指定します。正規表現は PCRE 構文を使用する必要があります。このリストが空の場合、フィルタリングは実行されません。リストが空でない場合は、少なくとも 1 つのパターンがクライアント証明書の識別名と一致する必要があります。一致しない場合、入力コントローラーは証明書を拒否して接続を拒否します。

clientCA

object

clientCA は、クライアントの証明書を検証するために使用する必要がある PEM でエンコードされた CA 証明書バンドルを含む設定マップを指定します。管理者は、openshift-config namespace にこの configmap を作成する必要があります。

clientCertificatePolicy

string

clientCertificatePolicy は、入力コントローラーがクライアントに証明書の提供を要求するかどうかを指定します。このフィールドは、"Required" または "Optional" の値を受け入れます。入力コントローラーは、クライアント証明書でエッジが終了し、TLS ルートを再暗号化することのみをチェックすることに注意してください。クリアテキスト HTTP またはパススルー TLS ルートの証明書をチェックすることはできません。

15.1.3. .spec.clientTLS.clientCA

説明
clientCA は、クライアントの証明書を検証するために使用する必要がある PEM でエンコードされた CA 証明書バンドルを含む設定マップを指定します。管理者は、openshift-config namespace にこの configmap を作成する必要があります。
object
必須
  • name
プロパティータイプ説明

name

string

name は、参照される config map の metadata.name です

15.1.4. .spec.defaultCertificate

説明
defaultCertificate は、入力コントローラーによって提供されるデフォルトの証明書を含むシークレットへの参照です。Routes が自身の証明書を指定しない場合、defaultCertificate が使用される。シークレットには、次のキーとデータが含まれている必要があります。tls.crt: 証明書ファイルの内容 tls.key: キーファイルの内容設定されていない場合、ワイルドカード証明書が自動的に生成されて使用されます。この証明書は、ingress コントローラードメイン (およびサブドメイン) に対して有効であり、生成された証明書の CA は、クラスターのトラストストアに自動的に統合されます。ワイルドカード証明書が複数の HTTP/2 対応ルート (ALPN を意味する) によって使用および共有されている場合、クライアント (つまり、特にブラウザー) は自由に開いている接続を再利用できます。これは、クライアントが別のルートへの接続を再利用できることを意味し、それは失敗する可能性があります。この動作は、一般に接続合体として知られています。使用中の証明書 (生成されたものかユーザー指定されたものかを問わず) は、OpenShift の組み込み OAuth サーバーと自動的に統合されます。
object
プロパティータイプ説明

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

15.1.5. .spec.endpointPublishingStrategy

説明
endpointPublishingStrategy は、入力コントローラーのエンドポイントを他のネットワークに公開したり、ロードバランサーの統合を有効にしたりするために使用されます。設定されていない場合、infrastructure.config.openshift.io/cluster の .status.platform に基づくデフォルトが使用されます。AWS: LoadBalancerService (External スコープ)、Azure: LoadBalancerService (External スコープ)、GCP: LoadBalancerService (External スコープ)、IBMCloud: LoadBalancerService (External スコープ)、AlibabaCloud: LoadBalancerService (External スコープ)、Libvirt: HostNetwork、その他のプラットフォームタイプ (None を含む) では、デフォルトで HostNetwork になります。endpointPublishingStrategy は更新できません。
object
必須
  • type
プロパティータイプ説明

hostNetwork

object

hostNetwork は、HostNetwork エンドポイント公開戦略のパラメーターを保持します。タイプが HostNetwork の場合にのみ存在します。

loadBalancer

object

loadBalancer は、ロードバランサーのパラメーターを保持します。タイプが LoadBalancerService の場合にのみ存在します。

nodePort

object

nodePort は、NodePortService エンドポイント公開戦略のパラメーターを保持します。タイプが NodePortService の場合にのみ存在します。

プライベート

object

private は、プライベートエンドポイント公開戦略のパラメーターを保持します。タイプがプライベートの場合にのみ存在します。

type

string

type は、使用する公開戦略です。有効な値は次のとおりです。* LoadBalancerService Publishes は Kubernetes LoadBalancer Service サービスを使用して入力コントローラーを公開します。この設定では、Ingress コントローラーのデプロイメントはコンテナーのネットワークを使用します。LoadBalancer サービスは、デプロイメントを公開するために作成されます。https://kubernetes.io/docs/concepts/services-networking/service/#loadbalancer を参照してください。ドメインが設定されている場合、ワイルドカード DNS レコードは、LoadBalancer サービスの外部名を指すように管理されます。DNS レコードは、dns.config.openshift.io/cluster.spec.publicZone および.spec.privateZone で定義された DNS ゾーンでのみ管理されます。ワイルドカード DNS 管理は現在、AWS、Azure、および GCP プラットフォームでのみサポートされています。* HostNetwork は、入力コントローラーがデプロイされているノードポートに入力コントローラーを公開します。この設定では、入力コントローラーのデプロイメントは、ノードポート 80 および 443 にバインドされたホストネットワークを使用します。ユーザーは、ノードポートを介して入力コントローラーを公開するように外部ロードバランサーを設定する必要があります。*プライベート入力コントローラーを公開しません。この設定では、入力コントローラーのデプロイメントはコンテナーネットワークを使用し、明示的に公開されません。ユーザーは、入力コントローラーを手動で公開する必要があります。* NodePortService は、Kubernetes NodePort サービスを使用して入力コントローラーを公開します。この設定では、Ingress コントローラーのデプロイメントはコンテナーのネットワークを使用します。デプロイメントを公開するために NodePort Service が作成されます。特定のノードポートは、OpenShift によって動的に割り当てられます。ただし、静的ポート割り当てをサポートするために、マネージド NodePort サービスのノードポートフィールドへのユーザーの変更は保持されます。

15.1.6. .spec.endpointPublishingStrategy.hostNetwork

説明
hostNetwork は、HostNetwork エンドポイント公開戦略のパラメーターを保持します。タイプが HostNetwork の場合にのみ存在します。
object
プロパティータイプ説明

httpPort

integer

httpPort は、HTTP リクエストをリッスンするために使用するホスト上のポートです。ポート 80 がすでに使用されている場合は、このフィールドを設定する必要があります。値がクラスターの NodePort 範囲と重ならないようにしてください。値が 0 の場合、または指定されていない場合は、デフォルトで 80 になります。

httpsPort

integer

httpsPort は、HTTPS リクエストをリッスンするために使用するホスト上のポートです。ポート 443 がすでに使用されている場合は、このフィールドを設定する必要があります。値がクラスターの NodePort 範囲と重ならないようにしてください。値が 0 の場合、または指定されていない場合は、デフォルトで 443 になります。

protocol

string

プロトコルは、IngressController が着信接続でプレーン TCP を使用することを期待するかどうか、または IngressController が PROXY プロトコルを期待するかどうかを指定します。PROXY プロトコルは、クライアント接続を IngressController に転送するときに、それらの接続の送信元アドレスを通信するためにそれをサポートするロードバランサーで使用できます。PROXY プロトコルを使用すると、IngressController は、HTTP ヘッダーとログでロードバランサーのアドレスを報告する代わりに、これらの送信元アドレスを報告できます。IngressController で PROXY プロトコルを有効にすると、PROXY プロトコルを使用して接続を IngressController に転送するロードバランサーを使用していない場合、接続が失敗することに注意してください。PROXY プロトコルの詳細は、http://www.haproxy.org/download/2.2/doc/proxy-protocol.txt を参照してください。このフィールドには、次の値が有効です。*空の文字列。* "TCP".* "PROXY".空の文字列はデフォルトを指定します。これは PROXY プロトコルなしの TCP です。デフォルトは変更される可能性があることに注意してください。

statsPort

integer

statsPort は、ルーターからの統計情報を公開するホスト上のポートです。値がクラスターの NodePort 範囲と重ならないようにしてください。この IngressController に接続を転送するように外部ロードバランサーが設定されている場合、ロードバランサーはヘルスチェックにこのポートを使用する必要があります。ロードバランサーは、特定のノード上のこのポートにパス /healthz/ready を使用して HTTP プローブを送信し、Ingress Controller がノード上でトラフィックを受信する準備ができているかどうかを確認できます。適切に動作させるために、ヘルスチェックによって準備完了が報告されるまで、ロードバランサーからノードにトラフィックを転送しないでください。ロードバランサーは、/healthz/ready が準備完了ではないことを報告し始めてから 45 秒以内にリクエストの転送を停止する必要があります。5 - 10 秒ごとにプローブし、タイムアウトを 5 秒に設定し、正常または異常を判定するしきい値として、成功または失敗したリクエストの数を 2 つに設定してください。これらは十分にテストされた値です。値が 0 の場合、または指定されていない場合は、デフォルトで 1936 になります。

15.1.7. .spec.endpointPublishingStrategy.loadBalancer

説明
loadBalancer は、ロードバランサーのパラメーターを保持します。タイプが LoadBalancerService の場合にのみ存在します。
object
必須
  • dnsManagementPolicy
  • scope
プロパティータイプ説明

allowedSourceRanges

``

allowedSourceRanges は、ロードバランサーへのアクセスを制限する IP アドレス範囲の許可リストを指定します。各範囲は CIDR 表記を使用して指定する必要があります (例: "10.0.0.0/8" または "fd00::/8")。範囲を指定しないと、IPv4 の場合は "0.0.0.0/0"、IPv6 の場合は "::/0" がデフォルトで使用され、すべての送信元アドレスが許可されます。allowedSourceRanges フィールドがない以前のバージョンの OpenShift からの移行を容易にするために、"openshift-ingress" namespace の "router-<ingresscontroller name>" サービスに service.beta.kubernetes.io/load-balancer-source-ranges アノテーションを設定できます。このアノテーションは、OpenShift 4.12 で allowedSourceRanges が空の場合に有効になります。

dnsManagementPolicy

string

dnsManagementPolicy は、ロードバランサーサービスに関連付けられたワイルドカード DNS レコードのライフサイクルを Ingress Operator によって管理するかどうかを示します。デフォルトは Managed です。有効な値は Managed と Unmanaged です。

providerParameters

object

providerParameters は、基盤となるインフラストラクチャープロバイダーに固有の必要なロードバランサー情報を保持します。空の場合、デフォルトが適用されます。デフォルトの詳細は、特定の providerParameters フィールドを参照してください。

scope

string

scope は、ロードバランサーが公開されるスコープを示します。可能な値は "External" と "Internal" です。

15.1.8. .spec.endpointPublishingStrategy.loadBalancer.providerParameters

説明
providerParameters は、基盤となるインフラストラクチャープロバイダーに固有の必要なロードバランサー情報を保持します。空の場合、デフォルトが適用されます。デフォルトの詳細は、特定の providerParameters フィールドを参照してください。
object
必須
  • type
プロパティータイプ説明

aws

object

aws は、AWS のロードバランサーに固有の設定を指定します。空の場合、デフォルトが適用されます。デフォルトの詳細は、特定の aws フィールドを参照してください。

gcp

object

gcp は、GCP のロードバランサーに固有の設定を指定します。空の場合、デフォルトが適用されます。デフォルトの詳細は、特定の gcp フィールドを参照してください。

ibm

object

ibm は、IBM Cloud のロードバランサーに固有の設定を指定します。空の場合、デフォルトが適用されます。デフォルトの詳細は、特定の ibm フィールドを参照してください。

type

string

type は、ロードバランサーの基盤となるインフラストラクチャープロバイダーです。許可される値は、"AWS"、"Azure"、"BareMetal"、"GCP"、"IBM"、"Nutanix"、"OpenStack"、および "VSphere" です。

15.1.9. .spec.endpointPublishingStrategy.loadBalancer.providerParameters.aws

説明
aws は、AWS のロードバランサーに固有の設定を指定します。空の場合、デフォルトが適用されます。デフォルトの詳細は、特定の aws フィールドを参照してください。
object
必須
  • type
プロパティー説明

classicLoadBalancer

object

classicLoadBalancerParameters は、AWS クラシックロードバランサーの設定パラメーターを保持します。タイプがクラシックの場合にのみ表示されます。

networkLoadBalancer

object

networkLoadBalancerParameters は、AWS ネットワークロードバランサーの設定パラメーターを保持します。タイプが NLB の場合にのみ存在します。

type

string

type は、イングレスコントローラー用にインスタンス化する AWS ロードバランサーのタイプです。有効な値は次のとおりです。*"Classic": トランスポート層 (TCP/SSL) またはアプリケーション層 (HTTP/HTTPS) のいずれかでルーティングを決定するクラシックロードバランサー。詳細は、以下を参照して ください。https://docs.aws.amazon.com/AmazonECS/latest/developerguide/load-balancer-types.html#clb * "NLB": トランスポートでルーティングを決定するネットワークロードバランサーレイヤー (TCP/SSL)。詳細は、https://docs.aws.amazon.com/AmazonECS/latest/developerguide/load-balancer-types.html#nlb を参照してください。

15.1.10. .spec.endpointPublishingStrategy.loadBalancer.providerParameters.aws.classicLoadBalancer

説明
classicLoadBalancerParameters は、AWS クラシックロードバランサーの設定パラメーターを保持します。タイプがクラシックの場合にのみ表示されます。
object
プロパティー説明

connectionIdleTimeout

string

connectionIdleTimeout は、ロードバランサーが接続を閉じるまでに接続がアイドル状態になることができる最大時間を指定します。値は時間間隔の値として解析可能である必要があります。https://pkg.go.dev/time#ParseDuration を参照してください。値が nil またはゼロの場合、指定なしとみなされ、デフォルト値が使用されます。このフィールドのデフォルト値は 60s です。このデフォルトは変更される可能性があります。

15.1.11. .spec.endpointPublishingStrategy.loadBalancer.providerParameters.aws.networkLoadBalancer

説明
networkLoadBalancerParameters は、AWS ネットワークロードバランサーの設定パラメーターを保持します。タイプが NLB の場合にのみ存在します。
object

15.1.12. .spec.endpointPublishingStrategy.loadBalancer.providerParameters.gcp

説明
gcp は、GCP のロードバランサーに固有の設定を指定します。空の場合、デフォルトが適用されます。デフォルトの詳細は、特定の gcp フィールドを参照してください。
object
プロパティー説明

clientAccess

string

clientAccess は、内部ロードバランサーのクライアントアクセスがどのように制限されるかを記述します。有効な値は次のとおりです。* "Global": グローバルクライアントアクセスで内部ロードバランサーを指定すると、VPC 内の任意のリージョンのクライアントがロードバランサーと通信できるようになります。https://cloud.google.com/kubernetes-engine/docs/how-to/internal-load-balancing#global_access * "Local": ローカルクライアントアクセスで内部ロードバランサーを指定すると、同じリージョン内のクライアントのみが意味されます (および VPC)GCP ロードバランサーはロードバランサーと通信できます。これがデフォルトの動作であることに注意してください。https://cloud.google.com/load-balancing/docs/internal#client_access

15.1.13. .spec.endpointPublishingStrategy.loadBalancer.providerParameters.ibm

説明
ibm は、IBM Cloud のロードバランサーに固有の設定を指定します。空の場合、デフォルトが適用されます。デフォルトの詳細は、特定の ibm フィールドを参照してください。
object
プロパティー説明

protocol

string

protocol は、ロードバランサーが PROXY プロトコルを使用して IngressController に接続を転送するかどうかを指定します。https://cloud.ibm.com/docs/containers?topic=containers-vpc-lbaas の「service.kubernetes.io/ibm-load-balancer-cloud-provider-enable-features: "proxy-protocol"」を参照してください。サポートされるロードバランサーで PROXY プロトコルを使用すると、クライアント接続を IngressController に転送するときに、クライアント接続のソースアドレスを伝達できます。PROXY プロトコルを使用すると、IngressController は、HTTP ヘッダーとログでロードバランサーのアドレスを報告する代わりに、これらの送信元アドレスを報告できます。IngressController で PROXY プロトコルを有効にすると、PROXY プロトコルを使用して接続を IngressController に転送するロードバランサーを使用していない場合、接続が失敗することに注意してください。PROXY プロトコルの詳細は、http://www.haproxy.org/download/2.2/doc/proxy-protocol.txt を参照してください。protocol の有効な値は、TCP、PROXY です (省略可能)。省略すると、指定なしとみなされ、プラットフォームによって適切なデフォルトが選択されます。デフォルトは、今後変更される可能性があります。現在のデフォルトは、PROXY プロトコルが有効でない TCP です。

15.1.14. .spec.endpointPublishingStrategy.nodePort

説明
nodePort は、NodePortService エンドポイント公開戦略のパラメーターを保持します。タイプが NodePortService の場合にのみ存在します。
object
プロパティー説明

protocol

string

プロトコルは、IngressController が着信接続でプレーン TCP を使用することを期待するかどうか、または IngressController が PROXY プロトコルを期待するかどうかを指定します。PROXY プロトコルは、クライアント接続を IngressController に転送するときに、それらの接続の送信元アドレスを通信するためにそれをサポートするロードバランサーで使用できます。PROXY プロトコルを使用すると、IngressController は、HTTP ヘッダーとログでロードバランサーのアドレスを報告する代わりに、これらの送信元アドレスを報告できます。IngressController で PROXY プロトコルを有効にすると、PROXY プロトコルを使用して接続を IngressController に転送するロードバランサーを使用していない場合、接続が失敗することに注意してください。PROXY プロトコルの詳細は、http://www.haproxy.org/download/2.2/doc/proxy-protocol.txt を参照してください。このフィールドには、次の値が有効です。*空の文字列。* "TCP".* "PROXY".空の文字列はデフォルトを指定します。これは PROXY プロトコルなしの TCP です。デフォルトは変更される可能性があることに注意してください。

15.1.15. .spec.endpointPublishingStrategy.private

説明
private は、プライベートエンドポイント公開戦略のパラメーターを保持します。タイプがプライベートの場合にのみ存在します。
object
プロパティー説明

protocol

string

プロトコルは、IngressController が着信接続でプレーン TCP を使用することを期待するかどうか、または IngressController が PROXY プロトコルを期待するかどうかを指定します。PROXY プロトコルは、クライアント接続を IngressController に転送するときに、それらの接続の送信元アドレスを通信するためにそれをサポートするロードバランサーで使用できます。PROXY プロトコルを使用すると、IngressController は、HTTP ヘッダーとログでロードバランサーのアドレスを報告する代わりに、これらの送信元アドレスを報告できます。IngressController で PROXY プロトコルを有効にすると、PROXY プロトコルを使用して接続を IngressController に転送するロードバランサーを使用していない場合、接続が失敗することに注意してください。PROXY プロトコルの詳細は、http://www.haproxy.org/download/2.2/doc/proxy-protocol.txt を参照してください。このフィールドには、次の値が有効です。*空の文字列。* "TCP".* "PROXY".空の文字列はデフォルトを指定します。これは PROXY プロトコルなしの TCP です。デフォルトは変更される可能性があることに注意してください。

15.1.16. .spec.httpCompression

説明
httpCompression は、HTTP トラフィック圧縮のポリシーを定義します。デフォルトでは、HTTP 圧縮はありません。
object
プロパティー説明

mimeTypes

array (string)

mimeTypes は、圧縮を適用する必要のある MIME タイプのリストです。このリストは空にすることもできます。その場合、Ingress Controller は圧縮を適用しません。注記: すべての MIME タイプが圧縮の恩恵を受けるわけではありませんが、それでも指示があれば、HAProxy がリソースを使用して圧縮を試みます。一般的に、テキスト (html、css、js など) 形式は、圧縮の恩恵を受けます。しかし、すでに圧縮されている形式 (イメージ、オーディオ、ビデオなど) は、再度圧縮するのにかかる時間と CPU の割に、あまり恩恵がありません。https://joehonton.medium.com/the-gzip-penalty-d31bd697f1a2 を参照してください。

15.1.17. .spec.httpErrorCodePages

説明
httpErrorCodePages は、カスタムエラーページを含む設定マップを指定します。管理者は、openshift-config namespace にこの configmap を作成する必要があります。この設定マップには、"error-page-<error code>.http" の形式のキーが必要です。ここで、<error code> は HTTP エラーコードです。たとえば、"error-page-503.http" は、HTTP503 応答のエラーページを定義します。現在、カスタマイズできるのは 503 および 404 応答のエラーページのみです。configmap の各値は、HTTP ヘッダーを含む完全な応答である必要があります。例 -https://raw.githubusercontent.com/openshift/router/fadab45747a9b30cc3f0a4b41ad2871f95827a93/images/router/haproxy/conf/error-page-503.http (このフィールドが空の場合、入力コントローラーはデフォルトのエラーページを使用します)。
object
必須
  • name
プロパティー説明

name

string

name は、参照される config map の metadata.name です

15.1.18. .spec.httpHeaders

説明
httpHeaders は、HTTP ヘッダーのポリシーを定義します。このフィールドが空の場合、デフォルト値が使用されます。
object
プロパティー説明

actions

object

actions は、ヘッダーとその値を変更するためのオプションを指定します。このオプションは、クリアテキスト HTTP 接続と、入力コントローラーが暗号化を終了するセキュア HTTP 接続 (つまり、エッジ終了または再暗号化接続) にのみ適用されることに注意してください。TLS パススルー接続の場合、ヘッダーを変更することはできません。HSTS (Strict-Transport-Security) ヘッダーの設定は、actions 経由ではサポートされていません。Strict-Transport-Security は、必ず "haproxy.router.openshift.io/hsts_header" ルートアノテーションを使用して、Ingress.Spec.RequiredHSTSPolicies で指定されたポリシーに従って設定する必要があります。ここで定義したアクションは、cache-control、spec.clientTLS、spec.httpHeaders.forwardedHeaderPolicy、spec.httpHeaders.uniqueId、spec.httpHeaders.headerNameCaseAdjustments など、他のフィールドに関連するアクションの後に適用されます。HTTP リクエストヘッダーの場合、ルートの spec.httpHeaders.actions で指定されたアクションは、IngressController の spec.httpHeaders.actions フィールドで指定されたアクションの後に実行されます。HTTP レスポンスヘッダーの場合、IngressController の spec.httpHeaders.actions で指定されたアクションは、ルートの spec.httpHeaders.actions フィールドで指定されたアクションの後に実行されます。この API を使用して設定されたヘッダーを、アクセスログで使用するために取得することはできません。ヘッダー名 Strict-Transport-Security、Proxy、Host、Cookie、Set-Cookie は予約されており、この API 経由で変更することはできません。動的な値を補間した に追加されたすべてのヘッダーの合計サイズが、IngressController の spec.tuningOptions.headerBufferMaxRewriteBytes の値を超えてはならないことに注意してください。詳細は、該当する API フィールドのドキュメントを参照してください。

forwardedHeaderPolicy

string

forwardedHeaderPolicy は、IngressController が Forwarded、X-Forwarded-For、X-Forwarded-Host、X-Forwarded-Port、X-Forwarded-Proto、および X-Forwarded-Proto-Version HTTP ヘッダーをいつどのように設定するかを指定します。値は次のいずれかになります。*"Append" は、IngressController がヘッダーを追加し、既存のヘッダーを保持することを指定します。* "Replace" は、IngressController がヘッダーを設定し、既存の Forwarded または X-Forwarded-*ヘッダーを置き換えることを指定します。* "IfNone"。ヘッダーがまだ設定されていない場合、IngressController がヘッダーを設定することを指定します。* "Never"。IngressController がヘッダーを設定せず、既存のヘッダーを保持することを指定します。デフォルトでは、ポリシーは "Append" です。

headerNameCaseAdjustments

``

headerNameCaseAdjustments は、HTTP ヘッダー名に適用できる大文字小文字の調整を指定します。それぞれの調整は、必要な大文字化を指定して HTTP ヘッダー名として指定されます。たとえば、"X-Forwarded-For" を指定すると、指定された大文字化を有効にするために "x-forwarded-for" HTTP ヘッダーを調整する必要があることを示唆できます。これらの調整は、クリアテキスト、edge-terminated、および re-encrypt ルートにのみ適用され、HTTP/1 を使用する場合にのみ適用されます。要求ヘッダーの場合、これらの調整は haproxy.router.openshift.io/h1-adjust-case=true アノテーションを持つルートについてのみ適用されます。応答ヘッダーの場合、これらの調整はすべての HTTP 応答に適用されます。このフィールドが空の場合、要求ヘッダーは調整されません。

uniqueId

object

uniqueId は、入力コントローラーが着信 HTTP 要求に挿入する必要があるカスタム HTTP ヘッダーの設定を記述します。通常、このヘッダーは、HTTP リクエストに固有の値を持つように設定されます。ヘッダーは、アプリケーションで使用したり、アクセスログに含めたりして、個々の HTTP リクエストのトレースを容易にすることができます。このフィールドが空の場合、そのようなヘッダーはリクエストに挿入されません。

15.1.19. .spec.httpHeaders.actions

説明
actions は、ヘッダーとその値を変更するためのオプションを指定します。このオプションは、クリアテキスト HTTP 接続と、入力コントローラーが暗号化を終了するセキュア HTTP 接続 (つまり、エッジ終了または再暗号化接続) にのみ適用されることに注意してください。TLS パススルー接続の場合、ヘッダーを変更することはできません。HSTS (Strict-Transport-Security) ヘッダーの設定は、actions 経由ではサポートされていません。Strict-Transport-Security は、必ず "haproxy.router.openshift.io/hsts_header" ルートアノテーションを使用して、Ingress.Spec.RequiredHSTSPolicies で指定されたポリシーに従って設定する必要があります。ここで定義したアクションは、cache-control、spec.clientTLS、spec.httpHeaders.forwardedHeaderPolicy、spec.httpHeaders.uniqueId、spec.httpHeaders.headerNameCaseAdjustments など、他のフィールドに関連するアクションの後に適用されます。HTTP リクエストヘッダーの場合、ルートの spec.httpHeaders.actions で指定されたアクションは、IngressController の spec.httpHeaders.actions フィールドで指定されたアクションの後に実行されます。HTTP レスポンスヘッダーの場合、IngressController の spec.httpHeaders.actions で指定されたアクションは、ルートの spec.httpHeaders.actions フィールドで指定されたアクションの後に実行されます。この API を使用して設定されたヘッダーを、アクセスログで使用するために取得することはできません。ヘッダー名 Strict-Transport-Security、Proxy、Host、Cookie、Set-Cookie は予約されており、この API 経由で変更することはできません。動的な値を補間した に追加されたすべてのヘッダーの合計サイズが、IngressController の spec.tuningOptions.headerBufferMaxRewriteBytes の値を超えてはならないことに注意してください。詳細は、該当する API フィールドのドキュメントを参照してください。
object
プロパティー説明

request

array

request は、変更する HTTP リクエストヘッダーのリストです。ここで定義したアクションにより、Ingress Controller を通過するすべてのリクエストのリクエストヘッダーが変更されます。このアクションは、すべてのルート、つまりクラスター内で定義された Ingress Controller によって処理されるすべての接続に適用されます。リクエストヘッダーの IngressController アクションは、ルートアクションの前に実行されます。現在、actions では、Set または Delete をヘッダー値として定義できます。アクションは、このリストで定義した順序で適用されます。最大 20 個のリクエストヘッダーアクションを設定できます。使用できるサンプルフェッチャーは、"req.hdr" と "ssl_c_der" です。使用できるコンバーターは、"lower" と "base64" です。ヘッダー値の例は、"%[req.hdr(X-target),lower]"、"%{+Q}[ssl_c_der,base64]" などです。

request[]

object

IngressControllerHTTPHeader は、HTTP ヘッダーを設定または削除するための設定を指定します。

response

array

response は、変更する HTTP レスポンスヘッダーのリストです。ここで定義したアクションにより、Ingress Controller を通過するすべてのリクエストのレスポンスヘッダーが変更されます。このアクションは、すべてのルート、つまりクラスター内で定義された Ingress Controller によって処理されるすべての接続に適用されます。レスポンスヘッダーの IngressController アクションは、ルートアクションの後に実行されます。現在、actions では、Set または Delete をヘッダー値として定義できます。アクションは、このリストで定義した順序で適用されます。最大 20 個のレスポンスヘッダーアクションを設定できます。使用できるサンプルフェッチャーは、"res.hdr" と "ssl_c_der" です。使用できるコンバーターは、"lower" と "base64" です。ヘッダー値の例は、"%[res.hdr(X-target),lower]"、"%{+Q}[ssl_c_der,base64]" などです。

response[]

object

IngressControllerHTTPHeader は、HTTP ヘッダーを設定または削除するための設定を指定します。

15.1.20. .spec.httpHeaders.actions.request

説明
request は、変更する HTTP リクエストヘッダーのリストです。ここで定義したアクションにより、Ingress Controller を通過するすべてのリクエストのリクエストヘッダーが変更されます。このアクションは、すべてのルート、つまりクラスター内で定義された Ingress Controller によって処理されるすべての接続に適用されます。リクエストヘッダーの IngressController アクションは、ルートアクションの前に実行されます。現在、actions では、Set または Delete をヘッダー値として定義できます。アクションは、このリストで定義した順序で適用されます。最大 20 個のリクエストヘッダーアクションを設定できます。使用できるサンプルフェッチャーは、"req.hdr" と "ssl_c_der" です。使用できるコンバーターは、"lower" と "base64" です。ヘッダー値の例は、"%[req.hdr(X-target),lower]"、"%{+Q}[ssl_c_der,base64]" などです。
array

15.1.21. .spec.httpHeaders.actions.request[]

説明
IngressControllerHTTPHeader は、HTTP ヘッダーを設定または削除するための設定を指定します。
object
必須
  • action
  • name
プロパティー説明

action

object

action は、ヘッダーの設定や削除など、ヘッダーに対して実行するアクションを指定します。

name

string

name は、アクション実行対象のヘッダーの名前を指定します。値は、RFC 2616 セクション 4.2 で定義されている有効な HTTP ヘッダー名である必要があります。名前は、英数字と特殊文字 "-!#$%&'*+.^_`" のみで構成する必要があります。ヘッダー名 Strict-Transport-Security、Proxy、Host、Cookie、Set-Cookie は予約されており、この API 経由で変更することはできません。255 文字以内の長さである必要があります。ヘッダー名は一意である必要があります。

15.1.22. .spec.httpHeaders.actions.request[].action

説明
action は、ヘッダーの設定や削除など、ヘッダーに対して実行するアクションを指定します。
object
必須
  • type
プロパティー説明

set

object

set は、HTTP ヘッダーの設定方法を指定します。このフィールドは、type が Set の場合は必須です。それ以外の場合は禁止されます。

type

string

type は、ヘッダーに適用するアクションのタイプを定義します。使用できる値は、Set または Delete です。Set を使用すると、HTTP リクエストヘッダーとレスポンスヘッダーを設定できます。Delete を使用すると、HTTP リクエストヘッダーとレスポンスヘッダーを削除できます。

15.1.23. .spec.httpHeaders.actions.request[].action.set

説明
set は、HTTP ヘッダーの設定方法を指定します。このフィールドは、type が Set の場合は必須です。それ以外の場合は禁止されます。
object
必須
  • value
プロパティー説明

value

string

value は、ヘッダー値を指定します。動的な値を追加できます。値は、http://cbonte.github.io/haproxy-dconv/2.6/configuration.html#8.2.6 で定義されている HAProxy 形式の文字列として解釈され、HAProxy の %[] 構文を使用できます。または、https://datatracker.ietf.org/doc/html/rfc7230#section-3.2 で定義されている有効な HTTP ヘッダー値である必要があります。このフィールドの値は、16384 文字以内の長さにする必要があります。動的な値を補間した に追加されたすべてのヘッダーの合計サイズが、IngressController の spec.tuningOptions.headerBufferMaxRewriteBytes の値を超えてはならないことに注意してください。

15.1.24. .spec.httpHeaders.actions.response

説明
response は、変更する HTTP レスポンスヘッダーのリストです。ここで定義したアクションにより、Ingress Controller を通過するすべてのリクエストのレスポンスヘッダーが変更されます。このアクションは、すべてのルート、つまりクラスター内で定義された Ingress Controller によって処理されるすべての接続に適用されます。レスポンスヘッダーの IngressController アクションは、ルートアクションの後に実行されます。現在、actions では、Set または Delete をヘッダー値として定義できます。アクションは、このリストで定義した順序で適用されます。最大 20 個のレスポンスヘッダーアクションを設定できます。使用できるサンプルフェッチャーは、"res.hdr" と "ssl_c_der" です。使用できるコンバーターは、"lower" と "base64" です。ヘッダー値の例は、"%[res.hdr(X-target),lower]"、"%{+Q}[ssl_c_der,base64]" などです。
array

15.1.25. .spec.httpHeaders.actions.response[]

説明
IngressControllerHTTPHeader は、HTTP ヘッダーを設定または削除するための設定を指定します。
object
必須
  • action
  • name
プロパティータイプ説明

action

object

action は、ヘッダーの設定や削除など、ヘッダーに対して実行するアクションを指定します。

name

string

name は、アクション実行対象のヘッダーの名前を指定します。値は、RFC 2616 セクション 4.2 で定義されている有効な HTTP ヘッダー名である必要があります。名前は、英数字と特殊文字 "-!#$%&'*+.^_`" のみで構成する必要があります。ヘッダー名 Strict-Transport-Security、Proxy、Host、Cookie、Set-Cookie は予約されており、この API 経由で変更することはできません。255 文字以内の長さである必要があります。ヘッダー名は一意である必要があります。

15.1.26. .spec.httpHeaders.actions.response[].action

説明
action は、ヘッダーの設定や削除など、ヘッダーに対して実行するアクションを指定します。
object
必須
  • type
プロパティータイプ説明

set

object

set は、HTTP ヘッダーの設定方法を指定します。このフィールドは、type が Set の場合は必須です。それ以外の場合は禁止されます。

type

string

type は、ヘッダーに適用するアクションのタイプを定義します。使用できる値は、Set または Delete です。Set を使用すると、HTTP リクエストヘッダーとレスポンスヘッダーを設定できます。Delete を使用すると、HTTP リクエストヘッダーとレスポンスヘッダーを削除できます。

15.1.27. .spec.httpHeaders.actions.response[].action.set

説明
set は、HTTP ヘッダーの設定方法を指定します。このフィールドは、type が Set の場合は必須です。それ以外の場合は禁止されます。
object
必須
  • value
プロパティータイプ説明

value

string

value は、ヘッダー値を指定します。動的な値を追加できます。値は、http://cbonte.github.io/haproxy-dconv/2.6/configuration.html#8.2.6 で定義されている HAProxy 形式の文字列として解釈され、HAProxy の %[] 構文を使用できます。または、https://datatracker.ietf.org/doc/html/rfc7230#section-3.2 で定義されている有効な HTTP ヘッダー値である必要があります。このフィールドの値は、16384 文字以内の長さにする必要があります。動的な値を補間した に追加されたすべてのヘッダーの合計サイズが、IngressController の spec.tuningOptions.headerBufferMaxRewriteBytes の値を超えてはならないことに注意してください。

15.1.28. .spec.httpHeaders.uniqueId

説明
uniqueId は、入力コントローラーが着信 HTTP 要求に挿入する必要があるカスタム HTTP ヘッダーの設定を記述します。通常、このヘッダーは、HTTP リクエストに固有の値を持つように設定されます。ヘッダーは、アプリケーションで使用したり、アクセスログに含めたりして、個々の HTTP リクエストのトレースを容易にすることができます。このフィールドが空の場合、そのようなヘッダーはリクエストに挿入されません。
object
プロパティータイプ説明

format

string

format は、挿入された HTTP ヘッダーの値の形式を指定します。名前を指定しない限り、このフィールドは効果がありません。HAProxy ベースの入力コントローラーの実装の場合、この形式は HTTP ログ形式と同じ構文を使用します。フィールドが空の場合、デフォルト値は "%{+X}o\\ %ci:%cp_%fi:%fp_%Ts_%rt:%pid" です。対応する HAProxy のドキュメント (http://cbonte.github.io/haproxy-dconv/2.0/configuration.html#8.2.3) を参照してください。

name

string

name は、入力コントローラーが HTTP 要求に挿入する HTTP ヘッダーの名前 (たとえば、"unique-id") を指定します。フィールドの値は、RFC2616 セクション 4.2 で定義されている有効な HTTP ヘッダー名である必要があります。フィールドが空の場合、ヘッダーは挿入されません。

15.1.29. .spec.logging

説明
ロギングは、何をどこに記録するかについてパラメーターを定義します。このフィールドが空の場合、操作ログは有効になりますが、アクセスログは無効になります。
object
プロパティー説明

access

object

アクセスは、クライアント要求をログに記録する方法を記述します。このフィールドが空の場合、アクセスロギングは無効になります。

15.1.30. .spec.logging.access

説明
アクセスは、クライアント要求をログに記録する方法を記述します。このフィールドが空の場合、アクセスロギングは無効になります。
object
必須
  • destination
プロパティー説明

destination

object

宛先はアクセスログの移動先です。

httpCaptureCookies

``

httpCaptureCookies は、アクセスログにキャプチャする必要がある HTTP Cookie を指定します。このフィールドが空の場合、Cookie はキャプチャされません。

httpCaptureHeaders

object

httpCaptureHeaders は、アクセスログにキャプチャする必要がある HTTP ヘッダーを定義します。このフィールドが空の場合、ヘッダーはキャプチャされません。このオプションは、クリアテキスト HTTP 接続と、入力コントローラーが暗号化を終了するセキュア HTTP 接続 (つまり、エッジ終了または再暗号化接続) にのみ適用されることに注意してください。TLS パススルー接続のヘッダーをキャプチャすることはできません。

httpLogFormat

string

httpLogFormat は、HTTP 要求のログメッセージの形式を指定します。このフィールドが空の場合、ログメッセージは実装のデフォルト HTTP ログ形式を使用します。HAProxy のデフォルトの HTTP ログ形式は、HAProxy のドキュメントを参照して ください。http://cbonte.github.io/haproxy-dconv/2.0/configuration.html#8.2.3 この形式は、クリアテキスト HTTP 接続とセキュア HTTP 接続にのみ適用されることに注意してください。入力コントローラーが暗号化を終了する (つまり、接続をエッジで終了または再暗号化する) 対象。TLS パススルー接続のログ形式には影響しません。

logEmptyRequests

string

logEmptyRequests は、要求を受信しない接続をログに記録する方法を指定します。通常、これらの空のリクエストは、ロードバランサーのヘルスプローブまたは Web ブラウザーの投機的接続 ("事前接続") から送信されます。この場合、これらのリクエストをログに記録することは望ましくない場合があります。ただし、これらの要求はネットワークエラーによっても発生する可能性があります。その場合、空の要求をログに記録すると、エラーの診断に役立つ場合があります。さらに、これらの要求はポートスキャンによって引き起こされる可能性があります。その場合、空の要求をログに記録すると、侵入の試みを検出するのに役立つ場合があります。このフィールドに使用できる値は "Log" および "Ignore" です。デフォルト値は "Log" です。

15.1.31. .spec.logging.access.destination

説明
宛先はアクセスログの移動先です。
object
必須
  • type
プロパティー説明

container

object

コンテナーは、コンテナーのロギング先のパラメーターを保持します。タイプがコンテナーの場合にのみ存在します。

syslog

object

syslog は、syslog エンドポイントのパラメーターを保持します。タイプが Syslog の場合にのみ存在します。

type

string

type はログの宛先のタイプです。次のいずれかである必要があります。*コンテナー入力 Operator は、入力コントローラー Pod で "logs" という名前のサイドカーコンテナーを設定し、サイドカーにログを書き込むように入力コントローラーを設定します。その後、ログはコンテナーログとして利用できます。管理者がこのコンテナーからログを読み取るカスタムロギングソリューションを設定することが予想されます。コンテナーログを使用するということは、ログの割合がコンテナーランタイムまたはカスタムログソリューションの容量を超えると、ログがドロップされる可能性があるということに注意してください。*Syslog ログは syslog エンドポイントに送信されます。管理者は、Syslog メッセージを受信できるエンドポイントを指定する必要があります。管理者がカスタム Syslog インスタンスを設定していることが予想されます。

15.1.32. .spec.logging.access.destination.container

説明
コンテナーは、コンテナーのロギング先のパラメーターを保持します。タイプがコンテナーの場合にのみ存在します。
object
プロパティー説明

maxLength

integer

maxLength は、ログメッセージの最大長です。有効な値は 480 から 8192 までの範囲の整数です。省略した場合のデフォルト値は 1024 です。

15.1.33. .spec.logging.access.destination.syslog

説明
syslog は、syslog エンドポイントのパラメーターを保持します。タイプが Syslog の場合にのみ存在します。
object
必須
  • address
  • port
プロパティー説明

address

string

address は、ログメッセージを受信する syslog エンドポイントの IP アドレスです。

facility

string

facility はログメッセージの syslog ファシリティーを指定します。このフィールドが空の場合、ファシリティーは "local1" になります。

maxLength

integer

maxLength は、ログメッセージの最大長です。有効な値は 480 から 4096 までの範囲の整数です。省略した場合のデフォルト値は 1024 です。

port

integer

port は、ログメッセージを受信する syslog エンドポイントの UDP ポート番号です。

15.1.34. .spec.logging.access.httpCaptureHeaders

説明
httpCaptureHeaders は、アクセスログにキャプチャする必要がある HTTP ヘッダーを定義します。このフィールドが空の場合、ヘッダーはキャプチャされません。このオプションは、クリアテキスト HTTP 接続と、入力コントローラーが暗号化を終了するセキュア HTTP 接続 (つまり、エッジ終了または再暗号化接続) にのみ適用されることに注意してください。TLS パススルー接続のヘッダーをキャプチャすることはできません。
object
プロパティー説明

request

``

request は、キャプチャする HTTP リクエストヘッダーを指定します。このフィールドが空の場合、要求ヘッダーは調整されません。

response

``

response は、キャプチャする HTTP 応答ヘッダーを指定します。このフィールドが空の場合、応答ヘッダーはキャプチャされません。

15.1.35. .spec.namespaceSelector

説明
namespaceSelector は、Ingress コントローラーによって提供される namespace セットをフィルターするために使用されます。これはシャードの実装に役立ちます。設定されていない場合、デフォルトはフィルタリングなしです。
object
プロパティー説明

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

15.1.36. .spec.namespaceSelector.matchExpressions

説明
matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
array

15.1.37. .spec.namespaceSelector.matchExpressions[]

説明
ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
object
必須
  • key
  • operator
プロパティー説明

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

15.1.38. .spec.nodePlacement

説明
nodePlacement は、Ingress コントローラーのスケジュールに対する明示的な制御を有効にします。設定されていない場合、デフォルトが使用されます。詳細は、NodePlacement を参照してください。
object
プロパティー説明

nodeSelector

object

nodeSelector は、入力コントローラーのデプロイメントに適用されるノードセレクターです。設定されている場合、指定されたセレクターが使用され、デフォルトが置き換えられます。設定されていない場合、クラスターの config.openshift.io/v1/ingresses ステータスの defaultPlacement フィールドの値によってデフォルトが決まります。defaultPlacement が Workers の場合、デフォルトは kubernetes.io/os: linux node-role.kubernetes.io/worker: '' です。defaultPlacement が ControlPlane の場合、デフォルトは kubernetes.io/os: linux node-role.kubernetes.io/master: '' です。これらのデフォルトは変更される可能性があります。nodeSelector.matchExpressions の使用はサポートされていないことに注意してください。nodeSelector.matchLabels のみ使用できます。これは Kubernetes API の制限です。Pod 仕様では、ノードセレクターに複雑な式を使用することはできません。

tolerations

array

tolerations は、入力コントローラーのデプロイメントに適用される許容値のリストです。デフォルトは空のリストです。See https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/

tolerations[]

object

この toleration が割り当てられる Pod は、マッチング Operator <operator> を使用してトリプル <key,value,effect> と一致する taint を許容します。

15.1.39. .spec.nodePlacement.nodeSelector

説明
nodeSelector は、入力コントローラーのデプロイメントに適用されるノードセレクターです。設定されている場合、指定されたセレクターが使用され、デフォルトが置き換えられます。設定されていない場合、クラスターの config.openshift.io/v1/ingresses ステータスの defaultPlacement フィールドの値によってデフォルトが決まります。defaultPlacement が Workers の場合、デフォルトは kubernetes.io/os: linux node-role.kubernetes.io/worker: '' です。defaultPlacement が ControlPlane の場合、デフォルトは kubernetes.io/os: linux node-role.kubernetes.io/master: '' です。これらのデフォルトは変更される可能性があります。nodeSelector.matchExpressions の使用はサポートされていないことに注意してください。nodeSelector.matchLabels のみ使用できます。これは Kubernetes API の制限です。Pod 仕様では、ノードセレクターに複雑な式を使用することはできません。
object
プロパティー説明

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

15.1.40. .spec.nodePlacement.nodeSelector.matchExpressions

説明
matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
array

15.1.41. .spec.nodePlacement.nodeSelector.matchExpressions[]

説明
ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
object
必須
  • key
  • operator
プロパティー説明

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

15.1.42. .spec.nodePlacement.tolerations

説明
tolerations は、入力コントローラーのデプロイメントに適用される許容値のリストです。デフォルトは空のリストです。See https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/
array

15.1.43. .spec.nodePlacement.tolerations[]

説明
この toleration が割り当てられる Pod は、マッチング Operator <operator> を使用してトリプル <key,value,effect> と一致する taint を許容します。
object
プロパティー説明

effect

string

effect は、照合するテイントの効果を示します。空の場合は、すべてのテイント効果に一致します。指定されている場合、許可される値は NoSchedule、PreferNoSchedule、および NoExecute です。

key

string

key は toleration が適用されるテイントキーです。空の場合は、すべてのテイントキーに一致します。キーが空の場合、Operator は Exists である必要があります。この組み合わせは、すべての値とすべてのキーに一致することを意味します。

operator

string

Operator はキーと値の関係を表します。有効な Operator は Exists および Equal です。デフォルトは Equal です。Exists は、値のワイルドカードと同等であるため、Pod は特定のカテゴリーのすべてのテイントに耐えることができます。

tolerationSeconds

integer

tolerationSeconds は、toleration (effect は NoExecute でなければならず、NoExecute 以外の場合このフィールドは無視されます) が taint を許容する期間を表します。デフォルトでは設定されていません。つまり、テイントを永久に許容します (エビクトしないでください)。ゼロ値と負の値は、システムによって 0 (すぐにエビクト) として扱われます。

value

string

value は、toleration が一致するテイントの値です。Operator が Exists の場合、値は空である必要があります。それ以外の場合は、通常の文字列のみになります。

15.1.44. .spec.routeAdmission

説明
routeAdmission は、新しいルートクレームを処理するためのポリシーを定義します (たとえば、名前空間全体でクレームを許可または拒否します)。空の場合、デフォルトが適用されます。デフォルトの詳細は、特定の routeAdmission フィールドを参照してください。
object
プロパティー説明

namespaceOwnership

string

namespaceOwnership は、namespace 間でホスト名の要求を処理する方法を記述します。値は次のいずれかである必要があります。- 厳密: 異なる名前空間のルートが同じホストを要求することを許可しない。--InterNamespaceAllowed: ルートが名前空間間で同じホスト名の異なるパスを要求できるようにします。空の場合、デフォルトは Strict です。

wildcardPolicy

string

wildcardPolicy は、入力コントローラーに対してワイルドカードポリシーを使用したルートを処理する方法を説明します。WildcardPolicy は、ルートのワイルドカードポリシーに基づいて、入力コントローラーによって公開されるルート [1] の使用を制御します。[1] https://github.com/openshift/api/blob/master/route/v1/types.go 注記:WildcardPolicy を WildcardsAllowed から WildcardsDisallowed に更新すると、サブドメインのワイルドカードポリシーを持つ許可されたルートが機能しなくなります。これらのルートは、ingress コントローラーによって再許可されるために、ワイルドカードポリシーなしに更新する必要があります。WildcardPolicy は、WildcardsAllowed および WildcardsDisallowed の値をサポートします。空の場合、デフォルトは "WildcardsDisallowed" です。

15.1.45. .spec.routeSelector

説明
routeSelector は、Ingress コントローラーによって提供される Routes のセットをフィルターするために使用されます。これはシャードの実装に役立ちます。設定されていない場合、デフォルトはフィルタリングなしです。
object
プロパティー説明

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

15.1.46. .spec.routeSelector.matchExpressions

説明
matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
array

15.1.47. .spec.routeSelector.matchExpressions[]

説明
ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
object
必須
  • key
  • operator
プロパティー説明

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

15.1.48. .spec.tlsSecurityProfile

説明
tlsSecurityProfile は、Ingress コントローラーの TLS 接続の設定を指定します。設定されていない場合、デフォルトは apiservers.config.openshift.io/cluster リソースに基づいています。Old、Intermediate、および Modern のプロファイルタイプを使用する場合、有効なプロファイル設定はリリース間で変更される可能性があります。たとえば、リリース X.Y.Z にデプロイされた Intermediate プロファイルを使用する仕様がある場合、リリース X.Y.Z+1 へのアップグレードにより、新規のプロファイル設定が Ingress コントローラーに適用され、ロールアウトが生じる可能性があります。
object
プロパティー説明

custom

``

custom は、ユーザー定義の TLS セキュリティープロファイルです。無効な設定は壊滅的である可能性があるため、カスタムプロファイルの使用には細心の注意を払ってください。カスタムプロファイルの例は次のようになります。暗号: - ECDHE-ECDSA-CHACHA20-POLY1305 - ECDHE-RSA-CHACHA20-POLY1305 - ECDHE-RSA-AES128-GCM-SHA256 - ECDHE-ECDSA-AES128-GCM-SHA256 minTLSVersion: VersionTLS11

intermediate

``

intermediate は、https://wiki.mozilla.org/Security/Server_Side_TLS#Intermediate_compatibility_.28recommended.29 に基づく TLS セキュリティープロファイルであり、次のようになります (yaml)。暗号: - TLS_AES_128_GCM_SHA256 - TLS_AES_256_GCM_SHA384 - TLS_CHACHA20_POLY1305_SHA256 - ECDHE-ECDSA-AES128-GCM-SHA256 - ECDHE-RSA-AES128-GCM-SHA256 - ECDHE-ECDSA-AES256-GCM-SHA384 - ECDHE-RSA-AES256-GCM-SHA384 - ECDHE-ECDSA-CHACHA20-POLY1305 - ECDHE-RSA-CHACHA20-POLY1305 - DHE-RSA-AES128-GCM-SHA256 - DHE-RSA-AES256-GCM-SHA384 minTLSVersion: VersionTLS12

modern

``

modern は、https://wiki.mozilla.org/Security/Server_Side_TLS#Modern_compatibility に基づく TLS セキュリティープロファイルであり、次のようになります (yaml): 暗号: - TLS_AES_128_GCM_SHA256 - TLS_AES_256_GCM_SHA384 - TLS_CHACHA20_POLY1305_SHA256 minTLSVersion: VersionTLS13

old

``

old は https://wiki.mozilla.org/Security/Server_Side_TLS#Old_backward_compatibility に基づくセキュリティープロファイルであり、次のようになります (yaml)。暗号: - TLS_AES_128_GCM_SHA256 - TLS_AES_256_GCM_SHA384 - TLS_CHACHA20_POLY1305_SHA256 - ECDHE-ECDSA-AES128-GCM-SHA256 - ECDHE-RSA-AES128-GCM-SHA256 - ECDHE-ECDSA-AES256-GCM-SHA384 - ECDHE-RSA-AES256-GCM-SHA384 - ECDHE-ECDSA-CHACHA20-POLY1305 - ECDHE-RSA-CHACHA20-POLY1305 - DHE-RSA-AES128-GCM-SHA256 - DHE-RSA-AES256-GCM-SHA384 - DHE-RSA-CHACHA20-POLY1305 - ECDHE-ECDSA-AES128-SHA256 - ECDHE-RSA-AES128-SHA256 - ECDHE-ECDSA-AES128-SHA - ECDHE-RSA-AES128-SHA - ECDHE-ECDSA-AES256-SHA384 - ECDHE-RSA-AES256-SHA384 - ECDHE-ECDSA-AES256-SHA - ECDHE-RSA-AES256-SHA - DHE-RSA-AES128-SHA256 - DHE-RSA-AES256-SHA256 - AES128-GCM-SHA256 - AES256-GCM-SHA384 - AES128-SHA256 - AES256-SHA256 - AES128-SHA - AES256-SHA - DES-CBC3-SHA minTLSVersion: VersionTLS10

type

string

タイプは、Old、Intermediate、Modern、または Custom のいずれかです。カスタムは、個々の TLS セキュリティープロファイルパラメーターを指定する機能を提供します。Old、Intermediate、Modern は、以下に基づく TLS セキュリティープロファイルです https://wiki.mozilla.org/Security/Server_Side_TLS#Recommended_configurations プロファイルはインテントベースであるため、新しい暗号が開発され、既存の暗号が安全ではありません。プロセスで使用できる暗号の正確さに応じて、リストが削減される場合があります。Modern プロファイルは、一般的なソフトウェアライブラリーでまだ十分に採用されていないため、現在サポートされていないことに注意してください。

15.1.49. .spec.tuningOptions

説明
tuningOptions は、入力コントローラー Pod のパフォーマンスを調整するためのパラメーターを定義します。すべてのフィールドはオプションであり、設定されていない場合はそれぞれのデフォルトを使用します。詳細は、特定の tuningOptions フィールドを参照してください。通常、tuningOptions 内でフィールドを設定することは推奨しません。デフォルト値は、ほとんどの設定に適しています。
object
プロパティー説明

clientFinTimeout

string

clientFinTimeout は、サーバー/バックエンドが接続を閉じることに対するクライアントの応答を待機している間、接続が開いたままになる時間を定義します。未設定の場合、デフォルトのタイムアウトは 1s です。

clientTimeout

string

clientTimeout は、クライアントの応答を待機している間、接続が開いたままになる時間を定義します。未設定の場合、デフォルトのタイムアウトは 30s です。

connectTimeout

string

ConnectTimeout は、サーバー/バックエンドへの接続試行が成功するまで待機する最大時間を定義します。このフィールドには、符号なしの 10 進数の期間文字列を指定する必要があります。それぞれの数字に少数 (任意) と単位の接尾辞を付けます。たとえば、"300ms"、"1.5h"、"2h45m" です。有効な時間単位は、"ns"、"us" (または "µs" U+00B5 か "μs" U+03BC)、"ms"、"s"、"m"、"h" です。省略すると、ユーザーによる指定なしとみなされ、プラットフォームによって適切なデフォルトが選択されます。このデフォルトは、今後変更される可能性があります。現在のデフォルトは 5s です。

headerBufferBytes

integer

headerBufferBytes は、IngressController 接続セッション用に予約する必要のあるメモリーの量 (バイト単位) を示します。IngressController (https://tools.ietf.org/html/rfc7540) で HTTP/2 が有効になっている場合、この値は少なくとも 16384 である必要があることに注意してください。このフィールドが空の場合、IngressController はデフォルト値の 32768 バイトを使用します。小さすぎる headerBufferBytes 値は IngressController を壊す可能性があり、大きすぎる headerBufferBytes 値は、IngressController が必要以上に多くのメモリーを使用する可能性があるため、このフィールドの設定は一般に推奨されません。

headerBufferMaxRewriteBytes

integer

headerBufferMaxRewriteBytes は、IngressController の接続セッションにおいて、HTTP ヘッダの書き換えと追加のために headerBufferBytes から確保すべきメモリー量 (バイト数) を記述します。着信 HTTP リクエストは (headerBufferBytes --headerBufferMaxRewriteBytes) バイトに制限されることに注意してください。つまり、headerBufferBytes は headerBufferMaxRewriteBytes より大きくなければなりません。このフィールドが空の場合、IngressController はデフォルト値の 8192 バイトを使用します。小さすぎる headerBufferMaxRewriteBytes 値は IngressController を壊す可能性があり、大きすぎる headerBufferMaxRewriteBytes 値は、IngressController が必要以上に大量のメモリーを使用する可能性があるため、このフィールドの設定は一般に推奨されません。

healthCheckInterval

string

healthCheckInterval は、ルーターに設定されたバックエンドに対する次回のヘルスチェックまでの間にルーターがどれだけの時間待機するかを定義します。この値は、すべてのルートのデフォルトとしてグローバルに適用されますが、ルートアノテーション "router.openshift.io/haproxy.health.check.interval" によってルートごとにオーバーライドされる場合があります。符号なしの 10 進数の期間文字列を指定する必要があります。それぞれの数字に少数 (任意) と単位の接尾辞を付けます。たとえば、"300ms"、"1.5h"、"2h45m" です。有効な時間単位は、"ns"、"us" (または "µs" U+00B5 か "μs" U+03BC)、"ms"、"s"、"m"、"h" です。これを 5 秒未満に設定すると、TCP ヘルスチェックが頻繁に行われ、SYN パケットストームが発生するため、過剰なトラフィックが発生する可能性があります。一方、この値を高く設定しすぎると、バックエンドサーバーが利用できないにもかかわらず、そのことがまだ検出されていないために、レイテンシーが増加する可能性があります。healthCheckInterval が空またはゼロの場合、指定なしとみなされ、IngressController によってデフォルトが選択されます。デフォルトは、今後変更される可能性があります。現在、デフォルトの healthCheckInterval 値は 5s です。現在、許容最小値は 1s、許容最大値は 2147483647ms (24.85 日) です。どちらも今後変更される可能性があります。

maxConnections

integer

maxConnections は、HAProxy プロセスごとに確立できる同時接続の最大数を定義します。この値を増やすと、各 Ingress Controller Pod がより多くの接続を処理できるようになりますが、消費されるシステムリソースが増えます。許可される値は、空、0、-1、および 2000 - 2000000 の範囲です。このフィールドが空または 0 の場合、IngressController はデフォルト値の 50000 を使用します。ただし、デフォルトは今後のリリースで変更される可能性があります。値が -1 の場合、実行中のコンテナーで使用可能な ulimits に基づいて、HAProxy が最大値を動的に計算します。-1 (自動) を選択すると、大きな値 (OpenShift 4.10 以上のクラスターでは約 520000) が計算されます。そのため、各 HAProxy プロセスで、現在のデフォルトの 50000 と比較して大量のメモリーが使用されます。現在のオペレーティングシステムの制限より大きい値を設定すると、HAProxy プロセスが起動しなくなります。個別の値 (例: 750000) を選択しても、ルーター Pod が新しいノードに移行されたときに、その新しいノードに同じ ulimits が設定されているとは限りません。このような場合、Pod は起動に失敗します。異なる ulimits が設定されたノード (異なる tuned プロファイルなど) があり、個別の値を選択する場合は、-1 を使用して、実行時に値を動的に計算するようにすることを推奨します。メトリクス 'container_memory_working_set_bytes{container="router",namespace="openshift-ingress"}' を使用すると、ルーターコンテナーのメモリー使用量を監視できます。メトリクス 'container_memory_working_set_bytes{container="router",namespace="openshift-ingress"}/container_processes{container="router",namespace="openshift-ingress"}' を使用すると、ルーターコンテナー内の個々の HAProxy プロセスのメモリー使用量を監視できます。

reloadInterval

string

reloadInterval は、新しい変更を適用するために、ルーターに許可するリロードの最小間隔を定義します。この値を増やすと、状況に応じて HAProxy プロセスの蓄積を防ぐことができます。この間隔を長くすると、ラウンドロビン分散アルゴリズムを使用するときに、バックエンドのサーバーの負荷の不均衡を軽減することもできます。または、この値を減らすと、HAProxy の設定の更新がより早く有効になるため、レイテンシーが短縮される可能性があります。値は時間間隔の値である必要があります。https://pkg.go.dev/time#ParseDuration を参照してください。現在、許容最小値は 1s、許容最大値は 120s です。許容最小値と許容最大値は、OpenShift の今後のバージョンで変更される可能性があります。この範囲外の期間を指定しても、reloadInterval の値は制限され、拒否されないことに注意してください (たとえば、120 秒を超える期間は 120 秒に制限されます。IngressController はその使用できない値を拒否せず、デフォルト値に置き換えます)。reloadInterval の値が 0 の場合、IngressController はデフォルトを選択します。デフォルトは現在 5s ですが、予告なく変更される可能性があります。このフィールドには、符号なしの 10 進数の期間文字列を指定する必要があります。それぞれの数字に少数 (任意) と単位の接尾辞を付けます。たとえば、"300ms"、"1.5h"、"2h45m" です。有効な時間単位は、"ns"、"us" (または "µs" U+00B5 か "μs" U+03BC)、"ms"、"s"、"m"、"h" です。注記: デフォルトの 5 秒よりも大幅に大きい値を設定すると、ルートとそのエンドポイントへの更新の監視にレイテンシーが発生する可能性があります。HAProxy の設定のリロード頻度が下がり、新しく作成されたルートが次回のリロードまで提供されなくなります。

serverFinTimeout

string

serverFinTimeout は、接続を閉じるクライアントへのサーバー/バックエンドの応答を待機している間、接続が開いたままになる時間を定義します。未設定の場合、デフォルトのタイムアウトは 1s です。

serverTimeout

string

serverTimeout は、サーバー/バックエンドの応答を待機している間、接続が開いたままになる時間を定義します。未設定の場合、デフォルトのタイムアウトは 30s です。

threadCount

integer

threadCount は、HAProxy プロセスごとに作成されるスレッドの数を定義します。より多くのスレッドを作成すると、使用されるシステムリソースを増やすことで、各 Ingress コントローラー Pod がより多くの接続を処理できるようになります。HAProxy は現在、最大 64 のスレッドをサポートしています。このフィールドが空の場合、IngressController はデフォルト値を使用します。現在のデフォルトは 4 スレッドですが、これは将来のリリースで変更される可能性があります。通常、このフィールドを設定することは推奨しません。HAProxy スレッドの数を増やすと、入力コントローラー Pod は負荷がかかった状態でより多くの CPU 時間を利用できるようになり、設定が高すぎると他の Pod が不足する可能性があります。スレッドの数を減らすと、Ingress コントローラーのパフォーマンスが低下する可能性があります。

tlsInspectDelay

string

tlsInspectDelay は、一致するルートを見つけるためにルーターがデータを保持できる期間を定義します。これを短く設定しすぎると、より一致する証明書を使用できる場合でも、ルーターがエッジ終端または再暗号化ルートのデフォルト証明書にフォールバックする可能性があります。未設定の場合、デフォルトの検査遅延は 5s です。

tunnelTimeout

string

tunnelTimeout は、トンネルがアイドル状態のときにトンネル接続 (WebSocket を含む) が開いたままになる時間を定義します。未設定の場合、デフォルトのタイムアウトは 1h です。

15.1.50. .status

説明
status は、IngressController の最後に観察されたステータスです。
object
プロパティー説明

availableReplicas

integer

availableReplicas は、入力コントローラーのデプロイメントに応じて監視された使用可能なレプリカの数です。

conditions

array

conditions は、状態とそのステータスのリストです使用可能とは、入力コントローラーのデプロイメントが使用可能であり、ルートと入力リソースにサービスを提供していることを意味します (つまり、.status.availableReplicas は.spec.replicas と同じです)。他の入力コントローラーの機能のステータスを示す追加の条件があります。*LoadBalancerManaged- 次の条件が満たされた場合に真になります。*エンドポイント公開戦略にはサービ出力ドバランサーが必要です。- これらの条件のいずれかが満たされていない場合は False。*LoadBalancerReady- 次の条件が満たされた場合に真になります。*ロードバランサーが管理されている。*ロードバランサーの準備ができました。- これらの条件のいずれかが満たされていない場合は False。*DNSManaged- 次の条件が満たされた場合に真。*エンドポイント公開戦略とプラットフォームは DNS をサポートします。*入力コントローラードメインが設定されています。*dns.config.openshift.io/cluster は DNS ゾーンを設定します。- これらの条件のいずれかが満たされていない場合は False。*DNSReady- 次の条件が満たされた場合に真。*DNS が管理されている。*DNS レコードは正常に作成されました。- これらの条件のいずれかが満たされていない場合は False。

conditions[]

object

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

domain

string

domain は、実際に使用されているドメインです。

endpointPublishingStrategy

object

endpointPublishingStrategy は、実際に使用されている戦略です。

namespaceSelector

object

namespaceSelector は、実際に使用されている namespaceSelector です。

observedGeneration

integer

observedGeneration は、観察された最新の世代です。

routeSelector

object

routeSelector は、実際に使用されている routeSelector です。

selector

string

セレクターは、IngressController に対応するイングレスコントローラー Pod 用の文字列形式のラベルセレクターです。一致する Pod の数は、availableReplicas の値と同じである必要があります。

tlsProfile

object

tlsProfile は、有効な TLS 接続設定です。

15.1.51. .status.conditions

説明
conditions は、状態とそのステータスのリストです使用可能とは、入力コントローラーのデプロイメントが使用可能であり、ルートと入力リソースにサービスを提供していることを意味します (つまり、.status.availableReplicas は.spec.replicas と同じです)。他の入力コントローラーの機能のステータスを示す追加の条件があります。*LoadBalancerManaged- 次の条件が満たされた場合に真になります。*エンドポイント公開戦略にはサービ出力ドバランサーが必要です。- これらの条件のいずれかが満たされていない場合は False。*LoadBalancerReady- 次の条件が満たされた場合に真になります。*ロードバランサーが管理されている。*ロードバランサーの準備ができました。- これらの条件のいずれかが満たされていない場合は False。*DNSManaged- 次の条件が満たされた場合に真。*エンドポイント公開戦略とプラットフォームは DNS をサポートします。*入力コントローラードメインが設定されています。*dns.config.openshift.io/cluster は DNS ゾーンを設定します。- これらの条件のいずれかが満たされていない場合は False。*DNSReady- 次の条件が満たされた場合に真。*DNS が管理されている。*DNS レコードは正常に作成されました。- これらの条件のいずれかが満たされていない場合は False。
array

15.1.52. .status.conditions[]

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

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

15.1.53. .status.endpointPublishingStrategy

説明
endpointPublishingStrategy は、実際に使用されている戦略です。
object
必須
  • type
プロパティー説明

hostNetwork

object

hostNetwork は、HostNetwork エンドポイント公開戦略のパラメーターを保持します。タイプが HostNetwork の場合にのみ存在します。

loadBalancer

object

loadBalancer は、ロードバランサーのパラメーターを保持します。タイプが LoadBalancerService の場合にのみ存在します。

nodePort

object

nodePort は、NodePortService エンドポイント公開戦略のパラメーターを保持します。タイプが NodePortService の場合にのみ存在します。

プライベート

object

private は、プライベートエンドポイント公開戦略のパラメーターを保持します。タイプがプライベートの場合にのみ存在します。

type

string

type は、使用する公開戦略です。有効な値は次のとおりです。* LoadBalancerService Publishes は Kubernetes LoadBalancer Service サービスを使用して入力コントローラーを公開します。この設定では、Ingress コントローラーのデプロイメントはコンテナーのネットワークを使用します。LoadBalancer サービスは、デプロイメントを公開するために作成されます。https://kubernetes.io/docs/concepts/services-networking/service/#loadbalancer を参照してください。ドメインが設定されている場合、ワイルドカード DNS レコードは、LoadBalancer サービスの外部名を指すように管理されます。DNS レコードは、dns.config.openshift.io/cluster.spec.publicZone および.spec.privateZone で定義された DNS ゾーンでのみ管理されます。ワイルドカード DNS 管理は現在、AWS、Azure、および GCP プラットフォームでのみサポートされています。* HostNetwork は、入力コントローラーがデプロイされているノードポートに入力コントローラーを公開します。この設定では、入力コントローラーのデプロイメントは、ノードポート 80 および 443 にバインドされたホストネットワークを使用します。ユーザーは、ノードポートを介して入力コントローラーを公開するように外部ロードバランサーを設定する必要があります。*プライベート入力コントローラーを公開しません。この設定では、入力コントローラーのデプロイメントはコンテナーネットワークを使用し、明示的に公開されません。ユーザーは、入力コントローラーを手動で公開する必要があります。* NodePortService は、Kubernetes NodePort サービスを使用して入力コントローラーを公開します。この設定では、Ingress コントローラーのデプロイメントはコンテナーのネットワークを使用します。デプロイメントを公開するために NodePort Service が作成されます。特定のノードポートは、OpenShift によって動的に割り当てられます。ただし、静的ポート割り当てをサポートするために、マネージド NodePort サービスのノードポートフィールドへのユーザーの変更は保持されます。

15.1.54. .status.endpointPublishingStrategy.hostNetwork

説明
hostNetwork は、HostNetwork エンドポイント公開戦略のパラメーターを保持します。タイプが HostNetwork の場合にのみ存在します。
object
プロパティー説明

httpPort

integer

httpPort は、HTTP リクエストをリッスンするために使用するホスト上のポートです。ポート 80 がすでに使用されている場合は、このフィールドを設定する必要があります。値がクラスターの NodePort 範囲と重ならないようにしてください。値が 0 の場合、または指定されていない場合は、デフォルトで 80 になります。

httpsPort

integer

httpsPort は、HTTPS リクエストをリッスンするために使用するホスト上のポートです。ポート 443 がすでに使用されている場合は、このフィールドを設定する必要があります。値がクラスターの NodePort 範囲と重ならないようにしてください。値が 0 の場合、または指定されていない場合は、デフォルトで 443 になります。

protocol

string

プロトコルは、IngressController が着信接続でプレーン TCP を使用することを期待するかどうか、または IngressController が PROXY プロトコルを期待するかどうかを指定します。PROXY プロトコルは、クライアント接続を IngressController に転送するときに、それらの接続の送信元アドレスを通信するためにそれをサポートするロードバランサーで使用できます。PROXY プロトコルを使用すると、IngressController は、HTTP ヘッダーとログでロードバランサーのアドレスを報告する代わりに、これらの送信元アドレスを報告できます。IngressController で PROXY プロトコルを有効にすると、PROXY プロトコルを使用して接続を IngressController に転送するロードバランサーを使用していない場合、接続が失敗することに注意してください。PROXY プロトコルの詳細は、http://www.haproxy.org/download/2.2/doc/proxy-protocol.txt を参照してください。このフィールドには、次の値が有効です。*空の文字列。* "TCP".* "PROXY".空の文字列はデフォルトを指定します。これは PROXY プロトコルなしの TCP です。デフォルトは変更される可能性があることに注意してください。

statsPort

integer

statsPort は、ルーターからの統計情報を公開するホスト上のポートです。値がクラスターの NodePort 範囲と重ならないようにしてください。この IngressController に接続を転送するように外部ロードバランサーが設定されている場合、ロードバランサーはヘルスチェックにこのポートを使用する必要があります。ロードバランサーは、特定のノード上のこのポートにパス /healthz/ready を使用して HTTP プローブを送信し、Ingress Controller がノード上でトラフィックを受信する準備ができているかどうかを確認できます。適切に動作させるために、ヘルスチェックによって準備完了が報告されるまで、ロードバランサーからノードにトラフィックを転送しないでください。ロードバランサーは、/healthz/ready が準備完了ではないことを報告し始めてから 45 秒以内にリクエストの転送を停止する必要があります。5 - 10 秒ごとにプローブし、タイムアウトを 5 秒に設定し、正常または異常を判定するしきい値として、成功または失敗したリクエストの数を 2 つに設定してください。これらは十分にテストされた値です。値が 0 の場合、または指定されていない場合は、デフォルトで 1936 になります。

15.1.55. .status.endpointPublishingStrategy.loadBalancer

説明
loadBalancer は、ロードバランサーのパラメーターを保持します。タイプが LoadBalancerService の場合にのみ存在します。
object
必須
  • dnsManagementPolicy
  • scope
プロパティー説明

allowedSourceRanges

``

allowedSourceRanges は、ロードバランサーへのアクセスを制限する IP アドレス範囲の許可リストを指定します。各範囲は CIDR 表記を使用して指定する必要があります (例: "10.0.0.0/8" または "fd00::/8")。範囲を指定しないと、IPv4 の場合は "0.0.0.0/0"、IPv6 の場合は "::/0" がデフォルトで使用され、すべての送信元アドレスが許可されます。allowedSourceRanges フィールドがない以前のバージョンの OpenShift からの移行を容易にするために、"openshift-ingress" namespace の "router-<ingresscontroller name>" サービスに service.beta.kubernetes.io/load-balancer-source-ranges アノテーションを設定できます。このアノテーションは、OpenShift 4.12 で allowedSourceRanges が空の場合に有効になります。

dnsManagementPolicy

string

dnsManagementPolicy は、ロードバランサーサービスに関連付けられたワイルドカード DNS レコードのライフサイクルを Ingress Operator によって管理するかどうかを示します。デフォルトは Managed です。有効な値は Managed と Unmanaged です。

providerParameters

object

providerParameters は、基盤となるインフラストラクチャープロバイダーに固有の必要なロードバランサー情報を保持します。空の場合、デフォルトが適用されます。デフォルトの詳細は、特定の providerParameters フィールドを参照してください。

scope

string

scope は、ロードバランサーが公開されるスコープを示します。可能な値は "External" と "Internal" です。

15.1.56. .status.endpointPublishingStrategy.loadBalancer.providerParameters

説明
providerParameters は、基盤となるインフラストラクチャープロバイダーに固有の必要なロードバランサー情報を保持します。空の場合、デフォルトが適用されます。デフォルトの詳細は、特定の providerParameters フィールドを参照してください。
object
必須
  • type
プロパティー説明

aws

object

aws は、AWS のロードバランサーに固有の設定を指定します。空の場合、デフォルトが適用されます。デフォルトの詳細は、特定の aws フィールドを参照してください。

gcp

object

gcp は、GCP のロードバランサーに固有の設定を指定します。空の場合、デフォルトが適用されます。デフォルトの詳細は、特定の gcp フィールドを参照してください。

ibm

object

ibm は、IBM Cloud のロードバランサーに固有の設定を指定します。空の場合、デフォルトが適用されます。デフォルトの詳細は、特定の ibm フィールドを参照してください。

type

string

type は、ロードバランサーの基盤となるインフラストラクチャープロバイダーです。許可される値は、"AWS"、"Azure"、"BareMetal"、"GCP"、"IBM"、"Nutanix"、"OpenStack"、および "VSphere" です。

15.1.57. .status.endpointPublishingStrategy.loadBalancer.providerParameters.aws

説明
aws は、AWS のロードバランサーに固有の設定を指定します。空の場合、デフォルトが適用されます。デフォルトの詳細は、特定の aws フィールドを参照してください。
object
必須
  • type
プロパティー説明

classicLoadBalancer

object

classicLoadBalancerParameters は、AWS クラシックロードバランサーの設定パラメーターを保持します。タイプがクラシックの場合にのみ表示されます。

networkLoadBalancer

object

networkLoadBalancerParameters は、AWS ネットワークロードバランサーの設定パラメーターを保持します。タイプが NLB の場合にのみ存在します。

type

string

type は、イングレスコントローラー用にインスタンス化する AWS ロードバランサーのタイプです。有効な値は次のとおりです。*"Classic": トランスポート層 (TCP/SSL) またはアプリケーション層 (HTTP/HTTPS) のいずれかでルーティングを決定するクラシックロードバランサー。詳細は、以下を参照して ください。https://docs.aws.amazon.com/AmazonECS/latest/developerguide/load-balancer-types.html#clb * "NLB": トランスポートでルーティングを決定するネットワークロードバランサーレイヤー (TCP/SSL)。詳細は、https://docs.aws.amazon.com/AmazonECS/latest/developerguide/load-balancer-types.html#nlb を参照してください。

15.1.58. .status.endpointPublishingStrategy.loadBalancer.providerParameters.aws.classicLoadBalancer

説明
classicLoadBalancerParameters は、AWS クラシックロードバランサーの設定パラメーターを保持します。タイプがクラシックの場合にのみ表示されます。
object
プロパティー説明

connectionIdleTimeout

string

connectionIdleTimeout は、ロードバランサーが接続を閉じるまでに接続がアイドル状態になることができる最大時間を指定します。値は時間間隔の値として解析可能である必要があります。https://pkg.go.dev/time#ParseDuration を参照してください。値が nil またはゼロの場合、指定なしとみなされ、デフォルト値が使用されます。このフィールドのデフォルト値は 60s です。このデフォルトは変更される可能性があります。

15.1.59. .status.endpointPublishingStrategy.loadBalancer.providerParameters.aws.networkLoadBalancer

説明
networkLoadBalancerParameters は、AWS ネットワークロードバランサーの設定パラメーターを保持します。タイプが NLB の場合にのみ存在します。
object

15.1.60. .status.endpointPublishingStrategy.loadBalancer.providerParameters.gcp

説明
gcp は、GCP のロードバランサーに固有の設定を指定します。空の場合、デフォルトが適用されます。デフォルトの詳細は、特定の gcp フィールドを参照してください。
object
プロパティー説明

clientAccess

string

clientAccess は、内部ロードバランサーのクライアントアクセスがどのように制限されるかを記述します。有効な値は次のとおりです。* "Global": グローバルクライアントアクセスで内部ロードバランサーを指定すると、VPC 内の任意のリージョンのクライアントがロードバランサーと通信できるようになります。https://cloud.google.com/kubernetes-engine/docs/how-to/internal-load-balancing#global_access * "Local": ローカルクライアントアクセスで内部ロードバランサーを指定すると、同じリージョン内のクライアントのみが意味されます (および VPC)GCP ロードバランサーはロードバランサーと通信できます。これがデフォルトの動作であることに注意してください。https://cloud.google.com/load-balancing/docs/internal#client_access

15.1.61. .status.endpointPublishingStrategy.loadBalancer.providerParameters.ibm

説明
ibm は、IBM Cloud のロードバランサーに固有の設定を指定します。空の場合、デフォルトが適用されます。デフォルトの詳細は、特定の ibm フィールドを参照してください。
object
プロパティー説明

protocol

string

protocol は、ロードバランサーが PROXY プロトコルを使用して IngressController に接続を転送するかどうかを指定します。https://cloud.ibm.com/docs/containers?topic=containers-vpc-lbaas の「service.kubernetes.io/ibm-load-balancer-cloud-provider-enable-features: "proxy-protocol"」を参照してください。サポートされるロードバランサーで PROXY プロトコルを使用すると、クライアント接続を IngressController に転送するときに、クライアント接続のソースアドレスを伝達できます。PROXY プロトコルを使用すると、IngressController は、HTTP ヘッダーとログでロードバランサーのアドレスを報告する代わりに、これらの送信元アドレスを報告できます。IngressController で PROXY プロトコルを有効にすると、PROXY プロトコルを使用して接続を IngressController に転送するロードバランサーを使用していない場合、接続が失敗することに注意してください。PROXY プロトコルの詳細は、http://www.haproxy.org/download/2.2/doc/proxy-protocol.txt を参照してください。protocol の有効な値は、TCP、PROXY です (省略可能)。省略すると、指定なしとみなされ、プラットフォームによって適切なデフォルトが選択されます。デフォルトは、今後変更される可能性があります。現在のデフォルトは、PROXY プロトコルが有効でない TCP です。

15.1.62. .status.endpointPublishingStrategy.nodePort

説明
nodePort は、NodePortService エンドポイント公開戦略のパラメーターを保持します。タイプが NodePortService の場合にのみ存在します。
object
プロパティー説明

protocol

string

プロトコルは、IngressController が着信接続でプレーン TCP を使用することを期待するかどうか、または IngressController が PROXY プロトコルを期待するかどうかを指定します。PROXY プロトコルは、クライアント接続を IngressController に転送するときに、それらの接続の送信元アドレスを通信するためにそれをサポートするロードバランサーで使用できます。PROXY プロトコルを使用すると、IngressController は、HTTP ヘッダーとログでロードバランサーのアドレスを報告する代わりに、これらの送信元アドレスを報告できます。IngressController で PROXY プロトコルを有効にすると、PROXY プロトコルを使用して接続を IngressController に転送するロードバランサーを使用していない場合、接続が失敗することに注意してください。PROXY プロトコルの詳細は、http://www.haproxy.org/download/2.2/doc/proxy-protocol.txt を参照してください。このフィールドには、次の値が有効です。*空の文字列。* "TCP".* "PROXY".空の文字列はデフォルトを指定します。これは PROXY プロトコルなしの TCP です。デフォルトは変更される可能性があることに注意してください。

15.1.63. .status.endpointPublishingStrategy.private

説明
private は、プライベートエンドポイント公開戦略のパラメーターを保持します。タイプがプライベートの場合にのみ存在します。
object
プロパティー説明

protocol

string

プロトコルは、IngressController が着信接続でプレーン TCP を使用することを期待するかどうか、または IngressController が PROXY プロトコルを期待するかどうかを指定します。PROXY プロトコルは、クライアント接続を IngressController に転送するときに、それらの接続の送信元アドレスを通信するためにそれをサポートするロードバランサーで使用できます。PROXY プロトコルを使用すると、IngressController は、HTTP ヘッダーとログでロードバランサーのアドレスを報告する代わりに、これらの送信元アドレスを報告できます。IngressController で PROXY プロトコルを有効にすると、PROXY プロトコルを使用して接続を IngressController に転送するロードバランサーを使用していない場合、接続が失敗することに注意してください。PROXY プロトコルの詳細は、http://www.haproxy.org/download/2.2/doc/proxy-protocol.txt を参照してください。このフィールドには、次の値が有効です。*空の文字列。* "TCP".* "PROXY".空の文字列はデフォルトを指定します。これは PROXY プロトコルなしの TCP です。デフォルトは変更される可能性があることに注意してください。

15.1.64. .status.namespaceSelector

説明
namespaceSelector は、実際に使用されている namespaceSelector です。
object
プロパティー説明

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

15.1.65. .status.namespaceSelector.matchExpressions

説明
matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
array

15.1.66. .status.namespaceSelector.matchExpressions[]

説明
ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
object
必須
  • key
  • operator
プロパティータイプ説明

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

15.1.67. .status.routeSelector

説明
routeSelector は、実際に使用されている routeSelector です。
object
プロパティー説明

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

15.1.68. .status.routeSelector.matchExpressions

説明
matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
array

15.1.69. .status.routeSelector.matchExpressions[]

説明
ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
object
必須
  • key
  • operator
プロパティー説明

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

15.1.70. .status.tlsProfile

説明
tlsProfile は、有効な TLS 接続設定です。
object
プロパティー説明

暗号化

array (string)

暗号は、TLS ハンドシェイク中にネゴシエートされる暗号アルゴリズムを指定するために使用されます。Operator は、オペランドがサポートしていないエントリーを削除できます。たとえば、DES-CBC3-SHA(yaml) を使用するには: 暗号:-DES-CBC3-SHA

minTLSVersion

string

minTLSVersion は、TLS ハンドシェイク中にネゴシエートされる TLS プロトコルの最小バージョンを指定するために使用されます。たとえば、TLS バージョン 1.1、1.2、1.3 (yaml) を使用する場合、minTLSVersion: VersionTLS11 を指定します。注記: 現在、許可されている最高の minTLSVersion は、VersionTLS12 です。

15.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/operator.openshift.io/v1/ingresscontrollers

    • GET: 種類が IngressController のオブジェクトをリスト表示します。
  • /apis/operator.openshift.io/v1/namespaces/{namespace}/ingresscontrollers

    • DELETE:IngressController のコレクションを削除します
    • GET: 種類が IngressController のオブジェクトをリスト表示します。
    • POST:IngressController を作成します
  • /apis/operator.openshift.io/v1/namespaces/{namespace}/ingresscontrollers/{name}

    • 削除:IngressController を削除します
    • GET: 指定された IngressController を読み取ります
    • PATCH: 指定された IngressController を部分的に更新します
    • PUT: 指定された IngressController を置き換えます
  • /apis/operator.openshift.io/v1/namespaces/{namespace}/ingresscontrollers/{name}/scale

    • GET: 指定された IngressController のスケールを読み取ります
    • PATCH: 指定された IngressController のスケールを部分的に更新します
    • PUT: 指定された IngressController のスケールを置き換えます
  • /apis/operator.openshift.io/v1/namespaces/{namespace}/ingresscontrollers/{name}/status

    • GET: 指定された IngressController のステータスを読み取ります
    • PATCH: 指定された IngressController のステータスを部分的に更新します
    • PUT: 指定された IngressController のステータスを置き換えます

15.2.1. /apis/operator.openshift.io/v1/ingresscontrollers

HTTP メソッド
GET
説明
種類が IngressController のオブジェクトをリスト表示します
表15.1 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

IngressControllerList スキーマ

401 - Unauthorized

空白

15.2.2. /apis/operator.openshift.io/v1/namespaces/{namespace}/ingresscontrollers

HTTP メソッド
DELETE
説明
IngressController のコレクションを削除します
表15.2 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類が IngressController のオブジェクトをリスト表示します
表15.3 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

IngressControllerList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
IngressController を作成します
表15.4 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表15.5 本文パラメーター
パラメーター説明

body

IngressController スキーマ

 
表15.6 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

IngressController スキーマ

201 - Created

IngressController スキーマ

202 - Accepted

IngressController スキーマ

401 - Unauthorized

空白

15.2.3. /apis/operator.openshift.io/v1/namespaces/{namespace}/ingresscontrollers/{name}

表15.7 グローバルパスパラメーター
パラメーター説明

name

string

IngressController の名前

HTTP メソッド
DELETE
説明
IngressController を削除します
表15.8 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表15.9 HTTP レスポンス
HTTP コードレスポンスのボディー

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定された IngressController を読み取ります
表15.10 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

IngressController スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された IngressController を部分的に更新します
表15.11 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表15.12 HTTP レスポンス
HTTP コードレスポンスのボディー

200 - OK

IngressController スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された IngressController を置き換えます
表15.13 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表15.14 本文パラメーター
パラメーター説明

body

IngressController スキーマ

 
表15.15 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

IngressController スキーマ

201 - Created

IngressController スキーマ

401 - Unauthorized

空白

15.2.4. /apis/operator.openshift.io/v1/namespaces/{namespace}/ingresscontrollers/{name}/scale

表15.16 グローバルパスパラメーター
パラメーター説明

name

string

IngressController の名前

HTTP メソッド
GET
説明
指定された IngressController のスケールを読み取ります
表15.17 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

スケーリング スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された IngressController のスケールを部分的に更新します
表15.18 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表15.19 HTTP レスポンス
HTTP コードレスポンスのボディー

200 - OK

スケーリング スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された IngressController のスケールを置き換えます
表15.20 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表15.21 本文パラメーター
パラメーター説明

body

スケーリング スキーマ

 
表15.22 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

スケーリング スキーマ

201 - Created

スケーリング スキーマ

401 - Unauthorized

空白

15.2.5. /apis/operator.openshift.io/v1/namespaces/{namespace}/ingresscontrollers/{name}/status

表15.23 グローバルパスパラメーター
パラメーター説明

name

string

IngressController の名前

HTTP メソッド
GET
説明
指定された IngressController のステータスを読み取ります
表15.24 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

IngressController スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された IngressController のステータスを部分的に更新します
表15.25 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表15.26 HTTP レスポンス
HTTP コードレスポンスのボディー

200 - OK

IngressController スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された IngressController のステータスを置き換えます
表15.27 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表15.28 本文パラメーター
パラメーター説明

body

IngressController スキーマ

 
表15.29 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

IngressController スキーマ

201 - Created

IngressController スキーマ

401 - Unauthorized

空白

第16章 InsightsOperator [operator.openshift.io/v1]

説明
InsightsOperator は、Insights Operator に関するクラスター全体の情報を保持します。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
object
必須
  • spec

16.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 は、Insights の望ましい動作の仕様です。

status

object

ステータスは、Insights Operator の最新のステータスです。

16.1.1. .spec

説明
spec は、Insights の望ましい動作の仕様です。
object
プロパティータイプ説明

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".

unsupportedConfigOverrides

``

unsupportedConfigOverrides は、以前に設定されたオプションをオーバーライドするスパース設定を保持します。オーバーライドするフィールドである必要があるだけで、次の順序でオーバーレイされます。1.ハードコードされたデフォルト 2.observedConfig 3. unsupportedConfigOverrides

16.1.2. .status

説明
ステータスは、Insights Operator の最新のステータスです。
object
プロパティータイプ説明

conditions

array

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

conditions[]

object

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

gatherStatus

object

gatherStatus は、最後の Insights データ収集に関する基本情報を提供します。省略された場合、データ収集はまだ行われていません。

generations

array

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

generations[]

object

GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。

insightsReport

object

insightsReport は、一般的な Insights の分析結果を提供します。省略された場合、データ収集はまだ行われていません。

observedGeneration

integer

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

readyReplicas

integer

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

version

string

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

16.1.3. .status.conditions

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

16.1.4. .status.conditions[]

説明
OperatorCondition は、標準の状態フィールドです。
object
プロパティータイプ説明

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

16.1.5. .status.gatherStatus

説明
gatherStatus は、最後の Insights データ収集に関する基本情報を提供します。省略された場合、データ収集はまだ行われていません。
object
プロパティータイプ説明

gatherers

array

gatherers は、最後の収集のアクティブなギャザラー (およびそのステータス) のリストです。

gatherers[]

object

gathererStatus は、特定のデータギャザラーに関する情報を表します。

lastGatherDuration

string

lastGatherDuration は、最後の収集イベント中にすべての収集を処理するのにかかった合計時間です。

lastGatherTime

string

lastGatherTime は、Insights のデータ収集が最後に終了した時刻です。空の値は、データがまだ収集されていないことを意味します。

16.1.6. .status.gatherStatus.gatherers

説明
gatherers は、最後の収集のアクティブなギャザラー (およびそのステータス) のリストです。
array

16.1.7. .status.gatherStatus.gatherers[]

説明
gathererStatus は、特定のデータギャザラーに関する情報を表します。
object
必須
  • conditions
  • lastGatherDuration
  • name
プロパティータイプ説明

conditions

array

conditions は、各ギャザラーのステータスの詳細を示します。

conditions[]

object

条件には、この API リソースの現在の状態の 1 つの側面の詳細が含まれています。--- この構造体は、フィールドパスの .status.conditions で配列として直接使用することを目的としています。たとえば、次のように入力します。FooStatus struct{ // Represents the observations of a foo’s current state. // Known .status.conditions.type are: "Available", "Progressing", and "Degraded" // +patchMergeKey=type // +patchStrategy=merge // +listType=map // +listMapKey=type Conditions []metav1.Condition json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type" protobuf:"bytes,1,rep,name=conditions" // other fields }

lastGatherDuration

string

lastGatherDuration は、収集に費やされた時間を表します。

name

string

name は、ギャザラーの名前です。

16.1.8. .status.gatherStatus.gatherers[].conditions

説明
conditions は、各ギャザラーのステータスの詳細を示します。
array

16.1.9. .status.gatherStatus.gatherers[].conditions[]

説明
条件には、この API リソースの現在の状態の 1 つの側面の詳細が含まれています。--- この構造体は、フィールドパスの .status.conditions で配列として直接使用することを目的としています。たとえば、次のように入力します。FooStatus struct{ // Represents the observations of a foo’s current state. // Known .status.conditions.type are: "Available", "Progressing", and "Degraded" // +patchMergeKey=type // +patchStrategy=merge // +listType=map // +listMapKey=type Conditions []metav1.Condition json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type" protobuf:"bytes,1,rep,name=conditions" // other fields }
object
必須
  • lastTransitionTime
  • message
  • reason
  • status
  • type
プロパティータイプ説明

lastTransitionTime

string

lastTransitionTime は、ある状態から別の状態に最後に遷移した時間です。これは、基本的な条件が変更された時点となります。不明な場合には、API フィールドが変更された時点を使用することも可能です。

message

string

message は、遷移の詳細を示す人が判読できるメッセージです。空の文字列の場合もあります。

observedGeneration

integer

observedGeneration は、それをベースに条件が設定された .metadata.generation を表します。たとえば、.metadata.generation が現在 12 で、.status.conditions[x].observedGeneration が 9 の場合、インスタンスの現在の状態に対して条件が古くなっています。

reason

string

reason には、条件の最後の遷移の理由を示すプログラムによる識別子が含まれます。特定の条件タイプのプロデューサーは、このフィールドの期待値と意味、および値が保証された API と見なされるかどうかを定義できます。値は CamelCase 文字列である必要があります。このフィールドには空白を指定できません。

status

string

条件のステータス、True、False、Unknown のいずれか。

type

string

CamelCase または foo.example.com/CamelCase の条件のタイプ。--- 多くの.condition.type 値は、Available などのリソース全体で一貫していますが、任意の条件が役立つ可能性があるため (.node.status.conditions を参照)、競合を解消する機能が重要です。一致する正規表現は (dns1123SubdomainFmt/)?(qualifiedNameFmt) です。

16.1.10. .status.generations

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

16.1.11. .status.generations[]

説明
GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。
object
プロパティータイプ説明

group

string

グループはあなたが追跡しているもののグループです

ハッシュ

string

ハッシュは、シークレットや設定マップのようにコンテンツに依存する、生成されないリソース用に設定されたオプションのフィールドです。

lastGeneration

integer

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

name

string

name は、追跡しているものの名前です

namespace

string

名前空間は、追跡しているものがどこにあるかです

resource

string

リソースは、追跡しているもののリソースタイプです

16.1.12. .status.insightsReport

説明
insightsReport は、一般的な Insights の分析結果を提供します。省略された場合、データ収集はまだ行われていません。
object
プロパティータイプ説明

downloadedAt

string

downloadedAt は、最後の Insights レポートがダウンロードされた時刻です。空の値は、Insights レポートがまだダウンロードされていないことを意味し、通常は非接続のクラスター (または Insights のデータ収集が無効なクラスター) で見られます。

healthChecks

array

healthChecks は、クラスター内のアクティブな Insights ヘルスチェックに関する基本情報を提供します。

healthChecks[]

object

healthCheck は、Insights ヘルスチェックの属性を表します。

16.1.13. .status.insightsReport.healthChecks

説明
healthChecks は、クラスター内のアクティブな Insights ヘルスチェックに関する基本情報を提供します。
array

16.1.14. .status.insightsReport.healthChecks[]

説明
healthCheck は、Insights ヘルスチェックの属性を表します。
object
必須
  • advisorURI
  • description
  • state
  • totalRisk
プロパティータイプ説明

advisorURI

string

advisorURI は、Insights Advisor への URL リンクを提供します。

description

string

description は、ヘルスチェックの基本的な説明を提供します。

state

string

state は、ヘルスチェックの現在の状態を示します。ヘルスチェックはデフォルトで有効になっていますが、ユーザーは Insights アドバイザーユーザーインターフェイスで無効にすることができます。

totalRisk

integer

ヘルスチェックの totalRisk。検出された問題によってもたらされる総リスクを示します。影響と確率を組み合わせたものです。値は 1 から 4 までで、数値が大きいほど問題の重要度が高くなります。

16.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/operator.openshift.io/v1/insightsoperators

    • DELETE: InsightsOperator のコレクションを削除します。
    • GET: 種類が InsightsOperator のオブジェクトをリスト表示します。
    • POST: InsightsOperator を作成します。
  • /apis/operator.openshift.io/v1/insightsoperators/{name}

    • DELETE: InsightsOperator を削除します。
    • GET: 指定された InsightsOperator を読み取ります。
    • PATCH: 指定された InsightsOperator を部分的に更新します。
    • PUT: 指定された InsightsOperator を置き換えます。
  • /apis/operator.openshift.io/v1/insightsoperators/{name}/scale

    • GET: 指定された InsightsOperator のスケールを読み取ります。
    • PATCH: 指定された InsightsOperator のスケールを部分的に更新します。
    • PUT: 指定された InsightsOperator のスケールを置き換えます。
  • /apis/operator.openshift.io/v1/insightsoperators/{name}/status

    • GET: 指定された InsightsOperator のステータスを読み取ります。
    • PATCH: 指定された InsightsOperator のステータスを部分的に更新します。
    • PUT: 指定された InsightsOperator のステータスを置き換えます。

16.2.1. /apis/operator.openshift.io/v1/insightsoperators

HTTP メソッド
DELETE
説明
InsightsOperator のコレクションを削除します。
表16.1 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類が InsightsOperator のオブジェクトをリスト表示します。
表16.2 HTTP 応答
HTTP コード応答本文

200 - OK

InsightsOperatorList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
InsightsOperator を作成します。
表16.3 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表16.4 本文パラメーター
パラメータータイプ説明

body

InsightsOperator スキーマ

 
表16.5 HTTP 応答
HTTP コード応答本文

200 - OK

InsightsOperator スキーマ

201 - Created

InsightsOperator スキーマ

202 - Accepted

InsightsOperator スキーマ

401 - Unauthorized

空白

16.2.2. /apis/operator.openshift.io/v1/insightsoperators/{name}

表16.6 グローバルパスパラメーター
パラメータータイプ説明

name

string

InsightsOperator の名前

HTTP メソッド
DELETE
説明
InsightsOperator を削除します。
表16.7 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表16.8 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定された InsightsOperator を読み取ります。
表16.9 HTTP 応答
HTTP コード応答本文

200 - OK

InsightsOperator スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された InsightsOperator を部分的に更新します。
表16.10 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表16.11 HTTP 応答
HTTP コード応答本文

200 - OK

InsightsOperator スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された InsightsOperator を置き換えます。
表16.12 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表16.13 本文パラメーター
パラメータータイプ説明

body

InsightsOperator スキーマ

 
表16.14 HTTP 応答
HTTP コード応答本文

200 - OK

InsightsOperator スキーマ

201 - Created

InsightsOperator スキーマ

401 - Unauthorized

空白

16.2.3. /apis/operator.openshift.io/v1/insightsoperators/{name}/scale

表16.15 グローバルパスパラメーター
パラメータータイプ説明

name

string

InsightsOperator の名前

HTTP メソッド
GET
説明
指定された InsightsOperator のスケールを読み取ります。
表16.16 HTTP 応答
HTTP コード応答本文

200 - OK

Scale スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された InsightsOperator のスケールを部分的に更新します。
表16.17 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表16.18 HTTP 応答
HTTP コード応答本文

200 - OK

Scale スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された InsightsOperator のスケールを置き換えます。
表16.19 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表16.20 本文パラメーター
パラメータータイプ説明

body

Scale スキーマ

 
表16.21 HTTP 応答
HTTP コード応答本文

200 - OK

Scale スキーマ

201 - Created

Scale スキーマ

401 - Unauthorized

空白

16.2.4. /apis/operator.openshift.io/v1/insightsoperators/{name}/status

表16.22 グローバルパスパラメーター
パラメータータイプ説明

name

string

InsightsOperator の名前

HTTP メソッド
GET
説明
指定された InsightsOperator のステータスを読み取ります。
表16.23 HTTP 応答
HTTP コード応答本文

200 - OK

InsightsOperator スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された InsightsOperator のステータスを部分的に更新します。
表16.24 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表16.25 HTTP 応答
HTTP コード応答本文

200 - OK

InsightsOperator スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された InsightsOperator のステータスを置き換えます。
表16.26 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表16.27 本文パラメーター
パラメータータイプ説明

body

InsightsOperator スキーマ

 
表16.28 HTTP 応答
HTTP コード応答本文

200 - OK

InsightsOperator スキーマ

201 - Created

InsightsOperator スキーマ

401 - Unauthorized

空白

第17章 KubeAPIServer [operator.openshift.io/v1]

説明
KubeAPIServer は、kube-apiserver を管理するための Operator を設定するための情報を提供します。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object
必須
  • spec

17.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 は、Kubernetes API サーバーの望ましい動作の仕様です。

status

object

status は、Kubernetes API サーバーの最後に観察されたステータスです

17.1.1. .spec

説明
spec は、Kubernetes API サーバーの望ましい動作の仕様です。
object
プロパティータイプ説明

failedRevisionLimit

integer

failedRevisionLimit は、ディスク上に保持するために失敗した静的 Pod インストーラーリビジョンの数であり、API では -1 =無制限、0 または未設定= 5(デフォルト)

forceRedeploymentReason

string

forceRedeploymentReason を使用すると、一意の文字列を指定して、オペランドの再デプロイを強制できます。これにより、以前に失敗したデプロイメントを開始するメカニズムが提供され、同じ設定で再度失敗するのではなく、今回は機能すると思われる理由が提供されます。

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".

succeededRevisionLimit

integer

successedRevisionLimit は、ディスク上に保持する成功した静的 Pod インストーラーリビジョンの数であり、API では -1 =無制限、0 または未設定= 5(デフォルト)

unsupportedConfigOverrides

``

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

17.1.2. .status

説明
status は、Kubernetes API サーバーの最後に観察されたステータスです
object
プロパティータイプ説明

conditions

array

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

conditions[]

object

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

generations

array

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

generations[]

object

GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。

latestAvailableRevision

integer

latestAvailableRevision は、最新のデプロイメントの deploymentID です。

latestAvailableRevisionReason

string

latestAvailableRevisionReason は、最新のデプロイメントの詳細な理由を説明します

nodeStatuses

array

nodeStatuses は、個々のノード全体のデプロイメント値とエラーを追跡します

nodeStatuses[]

object

NodeStatus は、この Operator によって管理される特定のノードの現在の状態に関する情報を提供します。

observedGeneration

integer

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

readyReplicas

integer

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

serviceAccountIssuers

array

serviceAccountIssuers は、使用されたサービスアカウント発行者の履歴を追跡します。有効期限のない項目は、現在使用されているサービスアカウントの発行者を表します。その他の項目は、以前使用され、現在も信頼されているサービスアカウント発行者を表します。項目のデフォルトの有効期限は、プラットフォームによって設定され、デフォルトでは 24 時間です。参照: https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/#service-account-token-volume-projection

serviceAccountIssuers[]

object

 

version

string

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

17.1.3. .status.conditions

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

17.1.4. .status.conditions[]

説明
OperatorCondition は、標準の状態フィールドです。
object
プロパティータイプ説明

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

17.1.5. .status.generations

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

17.1.6. .status.generations[]

説明
GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。
object
プロパティータイプ説明

group

string

グループはあなたが追跡しているもののグループです

ハッシュ

string

ハッシュは、シークレットや設定マップのようにコンテンツに依存する、生成されないリソース用に設定されたオプションのフィールドです。

lastGeneration

integer

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

name

string

name は、追跡しているものの名前です

namespace

string

名前空間は、追跡しているものがどこにあるかです

resource

string

リソースは、追跡しているもののリソースタイプです

17.1.7. .status.nodeStatuses

説明
nodeStatuses は、個々のノード全体のデプロイメント値とエラーを追跡します
array

17.1.8. .status.nodeStatuses[]

説明
NodeStatus は、この Operator によって管理される特定のノードの現在の状態に関する情報を提供します。
object
プロパティータイプ説明

currentRevision

integer

currentRevision は、最近成功したデプロイメントの生成です

lastFailedCount

integer

lastFailedCount は、最後に失敗したリビジョンのインストーラー Pod が失敗した頻度です。

lastFailedReason

string

lastFailedReason は、機械で読み取り可能な障害理由文字列です。

lastFailedRevision

integer

lastFailedRevision は、デプロイを試みて失敗したデプロイメントの世代です。

lastFailedRevisionErrors

array (string)

lastFailedRevisionErrors は、lastFailedRevision で参照されているデプロイメントの失敗時に人間が読み取れるエラーのリストです。

lastFailedTime

string

lastFailedTime は、最後に失敗したリビジョンが最後に失敗した時刻です。

lastFallbackCount

integer

lastFallbackCount は、前のリビジョンへのフォールバックが発生した頻度です。

nodeName

string

nodeName はノードの名前です

targetRevision

integer

targetRevision は、適用しようとしているデプロイメントの世代です

17.1.9. .status.serviceAccountIssuers

説明
serviceAccountIssuers は、使用されたサービスアカウント発行者の履歴を追跡します。有効期限のない項目は、現在使用されているサービスアカウントの発行者を表します。その他の項目は、以前使用され、現在も信頼されているサービスアカウント発行者を表します。項目のデフォルトの有効期限は、プラットフォームによって設定され、デフォルトでは 24 時間です。参照: https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/#service-account-token-volume-projection
array

17.1.10. .status.serviceAccountIssuers[]

説明
タイプ
object
プロパティータイプ説明

expirationTime

string

expirationTime は、このサービスアカウント発行者がプルーニングされ、信頼できるサービスアカウント発行者のリストから削除されるまでの時間です。

name

string

name は、サービスアカウント発行者の名前です ---

17.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/operator.openshift.io/v1/kubeapiservers

    • DELETE:KubeAPIServer のコレクションを削除します
    • GET: 種類が KubeAPIServer のオブジェクトをリスト表示します。
    • POST:KubeAPIServer を作成します
  • /apis/operator.openshift.io/v1/kubeapiservers/{name}

    • 削除:KubeAPIServer を削除します
    • GET: 指定された KubeAPIServer を読み取ります
    • PATCH: 指定された KubeAPIServer を部分的に更新します
    • PUT: 指定された KubeAPIServer を置き換えます
  • /apis/operator.openshift.io/v1/kubeapiservers/{name}/status

    • GET: 指定された KubeAPIServer のステータスを読み取ります
    • PATCH: 指定された KubeAPIServer のステータスを部分的に更新します
    • PUT: 指定された KubeAPIServer のステータスを置き換えます

17.2.1. /apis/operator.openshift.io/v1/kubeapiservers

HTTP メソッド
DELETE
説明
KubeAPIServer のコレクションを削除します
表17.1 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類が KubeAPIServer のオブジェクトをリスト表示します。
表17.2 HTTP 応答
HTTP コード応答本文

200 - OK

KubeAPIServerList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
KubeAPIServer を作成します
表17.3 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表17.4 本文パラメーター
パラメータータイプ説明

body

KubeAPIServer スキーマ

 
表17.5 HTTP 応答
HTTP コード応答本文

200 - OK

KubeAPIServer スキーマ

201 - Created

KubeAPIServer スキーマ

202 - Accepted

KubeAPIServer スキーマ

401 - Unauthorized

空白

17.2.2. /apis/operator.openshift.io/v1/kubeapiservers/{name}

表17.6 グローバルパスパラメーター
パラメータータイプ説明

name

string

KubeAPIServer の名前

HTTP メソッド
DELETE
説明
KubeAPIServer を削除します
表17.7 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表17.8 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定された KubeAPIServer を読み取ります
表17.9 HTTP 応答
HTTP コード応答本文

200 - OK

KubeAPIServer スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された KubeAPIServer を部分的に更新します
表17.10 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表17.11 HTTP 応答
HTTP コード応答本文

200 - OK

KubeAPIServer スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された KubeAPIServer を置き換えます
表17.12 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表17.13 本文パラメーター
パラメータータイプ説明

body

KubeAPIServer スキーマ

 
表17.14 HTTP 応答
HTTP コード応答本文

200 - OK

KubeAPIServer スキーマ

201 - Created

KubeAPIServer スキーマ

401 - Unauthorized

空白

17.2.3. /apis/operator.openshift.io/v1/kubeapiservers/{name}/status

表17.15 グローバルパスパラメーター
パラメータータイプ説明

name

string

KubeAPIServer の名前

HTTP メソッド
GET
説明
指定された KubeAPIServer のステータスを読み取ります
表17.16 HTTP 応答
HTTP コード応答本文

200 - OK

KubeAPIServer スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された KubeAPIServer のステータスを部分的に更新します
表17.17 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表17.18 HTTP 応答
HTTP コード応答本文

200 - OK

KubeAPIServer スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された KubeAPIServer のステータスを置き換えます
表17.19 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表17.20 本文パラメーター
パラメータータイプ説明

body

KubeAPIServer スキーマ

 
表17.21 HTTP 応答
HTTP コード応答本文

200 - OK

KubeAPIServer スキーマ

201 - Created

KubeAPIServer スキーマ

401 - Unauthorized

空白

第18章 KubeControllerManager [operator.openshift.io/v1]

説明
KubeControllerManager は、kube-controller-manager を管理するように Operator を設定するための情報を提供します。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object
必須
  • spec

18.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 は、Kubernetes Controller Manager の望ましい動作の仕様です。

status

object

status は、Kubernetes Controller Manager の最後に観察されたステータスです

18.1.1. .spec

説明
spec は、Kubernetes Controller Manager の望ましい動作の仕様です。
object
プロパティータイプ説明

failedRevisionLimit

integer

failedRevisionLimit は、ディスク上に保持するために失敗した静的 Pod インストーラーリビジョンの数であり、API では -1 =無制限、0 または未設定= 5(デフォルト)

forceRedeploymentReason

string

forceRedeploymentReason を使用すると、一意の文字列を指定して、オペランドの再デプロイを強制できます。これにより、以前に失敗したデプロイメントを開始するメカニズムが提供され、同じ設定で再度失敗するのではなく、今回は機能すると思われる理由が提供されます。

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".

succeededRevisionLimit

integer

successedRevisionLimit は、ディスク上に保持する成功した静的 Pod インストーラーリビジョンの数であり、API では -1 =無制限、0 または未設定= 5(デフォルト)

unsupportedConfigOverrides

``

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

useMoreSecureServiceCA

boolean

useMoreSecureServiceCA は、SA トークンボリュームで提供される service-ca.crt に、サービス提供証明書を検証するのに十分な証明書のみを含める必要があることを示します。true に設定すると、false に設定することはできません。誰かがそれを false に戻す方法を見つけたとしても、以前に存在していた service-ca.crt ファイルには、より安全なコンテンツしか含まれていません。

18.1.2. .status

説明
status は、Kubernetes Controller Manager の最後に観察されたステータスです
object
プロパティータイプ説明

conditions

array

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

conditions[]

object

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

generations

array

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

generations[]

object

GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。

latestAvailableRevision

integer

latestAvailableRevision は、最新のデプロイメントの deploymentID です。

latestAvailableRevisionReason

string

latestAvailableRevisionReason は、最新のデプロイメントの詳細な理由を説明します

nodeStatuses

array

nodeStatuses は、個々のノード全体のデプロイメント値とエラーを追跡します

nodeStatuses[]

object

NodeStatus は、この Operator によって管理される特定のノードの現在の状態に関する情報を提供します。

observedGeneration

integer

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

readyReplicas

integer

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

version

string

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

18.1.3. .status.conditions

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

18.1.4. .status.conditions[]

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

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

18.1.5. .status.generations

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

18.1.6. .status.generations[]

説明
GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。
object
プロパティータイプ説明

group

string

グループはあなたが追跡しているもののグループです

ハッシュ

string

ハッシュは、シークレットや設定マップのようにコンテンツに依存する、生成されないリソース用に設定されたオプションのフィールドです。

lastGeneration

integer

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

name

string

name は、追跡しているものの名前です

namespace

string

名前空間は、追跡しているものがどこにあるかです

resource

string

リソースは、追跡しているもののリソースタイプです

18.1.7. .status.nodeStatuses

説明
nodeStatuses は、個々のノード全体のデプロイメント値とエラーを追跡します
array

18.1.8. .status.nodeStatuses[]

説明
NodeStatus は、この Operator によって管理される特定のノードの現在の状態に関する情報を提供します。
object
必須
  • nodeName
プロパティータイプ説明

currentRevision

integer

currentRevision は、最近成功したデプロイメントの生成です

lastFailedCount

integer

lastFailedCount は、最後に失敗したリビジョンのインストーラー Pod が失敗した頻度です。

lastFailedReason

string

lastFailedReason は、機械で読み取り可能な障害理由文字列です。

lastFailedRevision

integer

lastFailedRevision は、デプロイを試みて失敗したデプロイメントの世代です。

lastFailedRevisionErrors

array (string)

lastFailedRevisionErrors は、lastFailedRevision で参照されているデプロイメントの失敗時に人間が読み取れるエラーのリストです。

lastFailedTime

string

lastFailedTime は、最後に失敗したリビジョンが最後に失敗した時刻です。

lastFallbackCount

integer

lastFallbackCount は、前のリビジョンへのフォールバックが発生した頻度です。

nodeName

string

nodeName はノードの名前です

targetRevision

integer

targetRevision は、適用しようとしているデプロイメントの世代です

18.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/operator.openshift.io/v1/kubecontrollermanagers

    • DELETE:KubeControllerManager のコレクションを削除します
    • GET: 種類 KubeControllerManager のオブジェクトをリスト表示します
    • POST:KubeControllerManager を作成します
  • /apis/operator.openshift.io/v1/kubecontrollermanagers/{name}

    • 削除:KubeControllerManager を削除します
    • GET: 指定された KubeControllerManager を読み取ります
    • PATCH: 指定された KubeControllerManager を部分的に更新します
    • PUT: 指定された KubeControllerManager を置き換えます
  • /apis/operator.openshift.io/v1/kubecontrollermanagers/{name}/status

    • GET: 指定された KubeControllerManager のステータスを読み取ります
    • PATCH: 指定された KubeControllerManager のステータスを部分的に更新します
    • PUT: 指定された KubeControllerManager のステータスを置き換えます

18.2.1. /apis/operator.openshift.io/v1/kubecontrollermanagers

HTTP メソッド
DELETE
説明
KubeControllerManager のコレクションを削除します
表18.1 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類が KubeControllerManager のオブジェクトをリスト表示します。
表18.2 HTTP 応答
HTTP コード応答本文

200 - OK

KubeControllerManagerList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
KubeControllerManager を作成します
表18.3 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表18.4 本文パラメーター
パラメータータイプ説明

body

KubeControllerManager スキーマ

 
表18.5 HTTP 応答
HTTP コード応答本文

200 - OK

KubeControllerManager スキーマ

201 - Created

KubeControllerManager スキーマ

202 - Accepted

KubeControllerManager スキーマ

401 - Unauthorized

空白

18.2.2. /apis/operator.openshift.io/v1/kubecontrollermanagers/{name}

表18.6 グローバルパスパラメーター
パラメータータイプ説明

name

string

KubeControllerManager の名前

HTTP メソッド
DELETE
説明
KubeControllerManager を削除します
表18.7 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表18.8 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定された KubeControllerManager を読み取ります
表18.9 HTTP 応答
HTTP コード応答本文

200 - OK

KubeControllerManager スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された KubeControllerManager を部分的に更新します
表18.10 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表18.11 HTTP 応答
HTTP コード応答本文

200 - OK

KubeControllerManager スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された KubeControllerManager を置き換えます
表18.12 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表18.13 本文パラメーター
パラメータータイプ説明

body

KubeControllerManager スキーマ

 
表18.14 HTTP 応答
HTTP コード応答本文

200 - OK

KubeControllerManager スキーマ

201 - Created

KubeControllerManager スキーマ

401 - Unauthorized

空白

18.2.3. /apis/operator.openshift.io/v1/kubecontrollermanagers/{name}/status

表18.15 グローバルパスパラメーター
パラメータータイプ説明

name

string

KubeControllerManager の名前

HTTP メソッド
GET
説明
指定された KubeControllerManager のステータスを読み取ります
表18.16 HTTP 応答
HTTP コード応答本文

200 - OK

KubeControllerManager スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された KubeControllerManager のステータスを部分的に更新します
表18.17 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表18.18 HTTP 応答
HTTP コード応答本文

200 - OK

KubeControllerManager スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された KubeControllerManager のステータスを置き換えます
表18.19 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表18.20 本文パラメーター
パラメータータイプ説明

body

KubeControllerManager スキーマ

 
表18.21 HTTP 応答
HTTP コード応答本文

200 - OK

KubeControllerManager スキーマ

201 - Created

KubeControllerManager スキーマ

401 - Unauthorized

空白

第19章 KubeScheduler [operator.openshift.io/v1]

説明
KubeScheduler は、スケジューラーを管理する Operator を設定するための情報を提供します。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object
必須
  • spec

19.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 は、Kubernetes スケジューラーの望ましい動作の仕様です。

status

object

status は、Kubernetes スケジューラーの最後に観察されたステータスです

19.1.1. .spec

説明
spec は、Kubernetes スケジューラーの望ましい動作の仕様です。
object
プロパティータイプ説明

failedRevisionLimit

integer

failedRevisionLimit は、ディスク上に保持するために失敗した静的 Pod インストーラーリビジョンの数であり、API では -1 =無制限、0 または未設定= 5(デフォルト)

forceRedeploymentReason

string

forceRedeploymentReason を使用すると、一意の文字列を指定して、オペランドの再デプロイを強制できます。これにより、以前に失敗したデプロイメントを開始するメカニズムが提供され、同じ設定で再度失敗するのではなく、今回は機能すると思われる理由が提供されます。

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".

succeededRevisionLimit

integer

successedRevisionLimit は、ディスク上に保持する成功した静的 Pod インストーラーリビジョンの数であり、API では -1 =無制限、0 または未設定= 5(デフォルト)

unsupportedConfigOverrides

``

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

19.1.2. .status

説明
status は、Kubernetes スケジューラーの最後に観察されたステータスです
object
プロパティータイプ説明

conditions

array

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

conditions[]

object

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

generations

array

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

generations[]

object

GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。

latestAvailableRevision

integer

latestAvailableRevision は、最新のデプロイメントの deploymentID です。

latestAvailableRevisionReason

string

latestAvailableRevisionReason は、最新のデプロイメントの詳細な理由を説明します

nodeStatuses

array

nodeStatuses は、個々のノード全体のデプロイメント値とエラーを追跡します

nodeStatuses[]

object

NodeStatus は、この Operator によって管理される特定のノードの現在の状態に関する情報を提供します。

observedGeneration

integer

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

readyReplicas

integer

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

version

string

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

19.1.3. .status.conditions

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

19.1.4. .status.conditions[]

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

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

19.1.5. .status.generations

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

19.1.6. .status.generations[]

説明
GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。
object
プロパティー説明

group

string

グループはあなたが追跡しているもののグループです

ハッシュ

string

ハッシュは、シークレットや設定マップのようにコンテンツに依存する、生成されないリソース用に設定されたオプションのフィールドです。

lastGeneration

integer

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

name

string

name は、追跡しているものの名前です

namespace

string

名前空間は、追跡しているものがどこにあるかです

resource

string

リソースは、追跡しているもののリソースタイプです

19.1.7. .status.nodeStatuses

説明
nodeStatuses は、個々のノード全体のデプロイメント値とエラーを追跡します
array

19.1.8. .status.nodeStatuses[]

説明
NodeStatus は、この Operator によって管理される特定のノードの現在の状態に関する情報を提供します。
object
プロパティー説明

currentRevision

integer

currentRevision は、最近成功したデプロイメントの生成です

lastFailedCount

integer

lastFailedCount は、最後に失敗したリビジョンのインストーラー Pod が失敗した頻度です。

lastFailedReason

string

lastFailedReason は、機械で読み取り可能な障害理由文字列です。

lastFailedRevision

integer

lastFailedRevision は、デプロイを試みて失敗したデプロイメントの世代です。

lastFailedRevisionErrors

array (string)

lastFailedRevisionErrors は、lastFailedRevision で参照されているデプロイメントの失敗時に人間が読み取れるエラーのリストです。

lastFailedTime

string

lastFailedTime は、最後に失敗したリビジョンが最後に失敗した時刻です。

lastFallbackCount

integer

lastFallbackCount は、前のリビジョンへのフォールバックが発生した頻度です。

nodeName

string

nodeName はノードの名前です

targetRevision

integer

targetRevision は、適用しようとしているデプロイメントの世代です

19.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/operator.openshift.io/v1/kubeschedulers

    • 削除:KubeScheduler のコレクションを削除します
    • GET: 種類が KubeScheduler のオブジェクトをリスト表示します。
    • POST:KubeScheduler を作成します
  • /apis/operator.openshift.io/v1/kubeschedulers/{name}

    • 削除:KubeScheduler を削除します
    • GET: 指定された KubeScheduler を読み取ります
    • PATCH: 指定された KubeScheduler を部分的に更新します
    • PUT: 指定された KubeScheduler を交換してください
  • /apis/operator.openshift.io/v1/kubeschedulers/{name}/status

    • GET: 指定された KubeScheduler のステータスを読み取ります
    • PATCH: 指定された KubeScheduler のステータスを部分的に更新します
    • PUT: 指定された KubeScheduler のステータスを置き換えます

19.2.1. /apis/operator.openshift.io/v1/kubeschedulers

HTTP メソッド
DELETE
説明
KubeScheduler のコレクションを削除します
表19.1 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類が KubeScheduler のオブジェクトをリスト表示します。
表19.2 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

KubeSchedulerList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
KubeScheduler を作成する
表19.3 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表19.4 本文パラメーター
パラメーター説明

body

KubeScheduler スキーマ

 
表19.5 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

KubeScheduler スキーマ

201 - Created

KubeScheduler スキーマ

202 - Accepted

KubeScheduler スキーマ

401 - Unauthorized

空白

19.2.2. /apis/operator.openshift.io/v1/kubeschedulers/{name}

表19.6 グローバルパスパラメーター
パラメーター説明

name

string

KubeScheduler の名前

HTTP メソッド
DELETE
説明
KubeScheduler を削除する
表19.7 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表19.8 HTTP レスポンス
HTTP コードレスポンスのボディー

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定された KubeScheduler を読む
表19.9 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

KubeScheduler スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された KubeScheduler を部分的に更新します
表19.10 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表19.11 HTTP レスポンス
HTTP コードレスポンスのボディー

200 - OK

KubeScheduler スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された KubeScheduler を交換してください
表19.12 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表19.13 本文パラメーター
パラメーター説明

body

KubeScheduler スキーマ

 
表19.14 HTTP 応答
HTTP コード応答本文

200 - OK

KubeScheduler スキーマ

201 - Created

KubeScheduler スキーマ

401 - Unauthorized

空白

19.2.3. /apis/operator.openshift.io/v1/kubeschedulers/{name}/status

表19.15 グローバルパスパラメーター
パラメータータイプ説明

name

string

KubeScheduler の名前

HTTP メソッド
GET
説明
指定された KubeScheduler のステータスを読み取ります
表19.16 HTTP 応答
HTTP コード応答本文

200 - OK

KubeScheduler スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された KubeScheduler のステータスを部分的に更新します
表19.17 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表19.18 HTTP 応答
HTTP コード応答本文

200 - OK

KubeScheduler スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された KubeScheduler のステータスを置き換えます
表19.19 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表19.20 本文パラメーター
パラメータータイプ説明

body

KubeScheduler スキーマ

 
表19.21 HTTP 応答
HTTP コード応答本文

200 - OK

KubeScheduler スキーマ

201 - Created

KubeScheduler スキーマ

401 - Unauthorized

空白

第20章 KubeStorageVersionMigrator [operator.openshift.io/v1]

説明
KubeStorageVersionMigrator は、kube-storage-version-migrator を管理するように Operator を設定するための情報を提供します。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object
必須
  • spec

20.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

 

status

object

 

20.1.1. .spec

説明
タイプ
object
プロパティータイプ説明

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".

unsupportedConfigOverrides

``

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

20.1.2. .status

説明
タイプ
object
プロパティータイプ説明

conditions

array

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

conditions[]

object

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

generations

array

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

generations[]

object

GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。

observedGeneration

integer

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

readyReplicas

integer

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

version

string

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

20.1.3. .status.conditions

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

20.1.4. .status.conditions[]

説明
OperatorCondition は、標準の状態フィールドです。
object
プロパティータイプ説明

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

20.1.5. .status.generations

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

20.1.6. .status.generations[]

説明
GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。
object
プロパティータイプ説明

group

string

グループはあなたが追跡しているもののグループです

ハッシュ

string

ハッシュは、シークレットや設定マップのようにコンテンツに依存する、生成されないリソース用に設定されたオプションのフィールドです。

lastGeneration

integer

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

name

string

name は、追跡しているものの名前です

namespace

string

名前空間は、追跡しているものがどこにあるかです

resource

string

リソースは、追跡しているもののリソースタイプです

20.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/operator.openshift.io/v1/kubestorageversionmigrators

    • DELETE:KubeStorageVersionMigrator のコレクションを削除します
    • GET: 種類のオブジェクトをリスト表示します KubeStorageVersionMigrator
    • POST:KubeStorageVersionMigrator を作成します
  • /apis/operator.openshift.io/v1/kubestorageversionmigrators/{name}

    • DELETE: delete a KubeStorageVersionMigrator
    • GET: 指定された KubeStorageVersionMigrator を読み取ります
    • PATCH: 指定された KubeStorageVersionMigrator を部分的に更新します
    • PUT: 指定された KubeStorageVersionMigrator を置き換えます
  • /apis/operator.openshift.io/v1/kubestorageversionmigrators/{name}/status

    • GET: 指定された KubeStorageVersionMigrator のステータスを読み取ります
    • PATCH: 指定された KubeStorageVersionMigrator のステータスを部分的に更新します
    • PUT: 指定された KubeStorageVersionMigrator のステータスを置き換えます

20.2.1. /apis/operator.openshift.io/v1/kubestorageversionmigrators

HTTP メソッド
DELETE
説明
KubeStorageVersionMigrator のコレクションを削除します
表20.1 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類のオブジェクトをリスト表示する KubeStorageVersionMigrator
表20.2 HTTP 応答
HTTP コード応答本文

200 - OK

KubeStorageVersionMigratorList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
create a KubeStorageVersionMigrator
表20.3 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表20.4 本文パラメーター
パラメーター説明

body

KubeStorageVersionMigrator スキーマ

 
表20.5 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

KubeStorageVersionMigrator スキーマ

201 - Created

KubeStorageVersionMigrator スキーマ

202 - Accepted

KubeStorageVersionMigrator スキーマ

401 - Unauthorized

空白

20.2.2. /apis/operator.openshift.io/v1/kubestorageversionmigrators/{name}

表20.6 グローバルパスパラメーター
パラメーター説明

name

string

KubeStorageVersionMigrator の名前

HTTP メソッド
DELETE
説明
delete a KubeStorageVersionMigrator
表20.7 クエリーパラメーター
パラメーター説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表20.8 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定された KubeStorageVersionMigrator を読み取ります
表20.9 HTTP 応答
HTTP コード応答本文

200 - OK

KubeStorageVersionMigrator スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された KubeStorageVersionMigrator を部分的に更新します
表20.10 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表20.11 HTTP レスポンス
HTTP コードレスポンスのボディー

200 - OK

KubeStorageVersionMigrator スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された KubeStorageVersionMigrator を置き換えます
表20.12 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表20.13 本文パラメーター
パラメーター説明

body

KubeStorageVersionMigrator スキーマ

 
表20.14 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

KubeStorageVersionMigrator スキーマ

201 - Created

KubeStorageVersionMigrator スキーマ

401 - Unauthorized

空白

20.2.3. /apis/operator.openshift.io/v1/kubestorageversionmigrators/{name}/status

表20.15 グローバルパスパラメーター
パラメーター説明

name

string

KubeStorageVersionMigrator の名前

HTTP メソッド
GET
説明
指定された KubeStorageVersionMigrator のステータスを読み取ります
表20.16 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

KubeStorageVersionMigrator スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された KubeStorageVersionMigrator のステータスを部分的に更新します
表20.17 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表20.18 HTTP レスポンス
HTTP コードレスポンスのボディー

200 - OK

KubeStorageVersionMigrator スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された KubeStorageVersionMigrator のステータスを置き換えます
表20.19 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表20.20 本文パラメーター
パラメーター説明

body

KubeStorageVersionMigrator スキーマ

 
表20.21 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

KubeStorageVersionMigrator スキーマ

201 - Created

KubeStorageVersionMigrator スキーマ

401 - Unauthorized

空白

第21章 MachineConfiguration [operator.openshift.io/v1]

説明
MachineConfiguration は、マシン設定を管理する Operator を設定するための情報を提供します。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object
必須
  • spec

21.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 は、Machine Config Operator の望ましい動作の仕様です。

status

object

status は、Machine Config Operator の最新のステータスです。

21.1.1. .spec

説明
spec は、Machine Config Operator の望ましい動作の仕様です。
object
プロパティータイプ説明

failedRevisionLimit

integer

failedRevisionLimit は、ディスク上に保持するために失敗した静的 Pod インストーラーリビジョンの数であり、API では -1 =無制限、0 または未設定= 5(デフォルト)

forceRedeploymentReason

string

forceRedeploymentReason を使用すると、一意の文字列を指定して、オペランドの再デプロイを強制できます。これにより、以前に失敗したデプロイメントを開始するメカニズムが提供され、同じ設定で再度失敗するのではなく、今回は機能すると思われる理由が提供されます。

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".

succeededRevisionLimit

integer

successedRevisionLimit は、ディスク上に保持する成功した静的 Pod インストーラーリビジョンの数であり、API では -1 =無制限、0 または未設定= 5(デフォルト)

unsupportedConfigOverrides

``

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

21.1.2. .status

説明
status は、Machine Config Operator の最新のステータスです。
object
プロパティータイプ説明

conditions

array

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

conditions[]

object

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

generations

array

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

generations[]

object

GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。

latestAvailableRevision

integer

latestAvailableRevision は、最新のデプロイメントの deploymentID です。

latestAvailableRevisionReason

string

latestAvailableRevisionReason は、最新のデプロイメントの詳細な理由を説明します

nodeStatuses

array

nodeStatuses は、個々のノード全体のデプロイメント値とエラーを追跡します

nodeStatuses[]

object

NodeStatus は、この Operator によって管理される特定のノードの現在の状態に関する情報を提供します。

observedGeneration

integer

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

readyReplicas

integer

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

version

string

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

21.1.3. .status.conditions

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

21.1.4. .status.conditions[]

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

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

21.1.5. .status.generations

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

21.1.6. .status.generations[]

説明
GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。
object
プロパティー説明

group

string

グループはあなたが追跡しているもののグループです

ハッシュ

string

ハッシュは、シークレットや設定マップのようにコンテンツに依存する、生成されないリソース用に設定されたオプションのフィールドです。

lastGeneration

integer

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

name

string

name は、追跡しているものの名前です

namespace

string

名前空間は、追跡しているものがどこにあるかです

resource

string

リソースは、追跡しているもののリソースタイプです

21.1.7. .status.nodeStatuses

説明
nodeStatuses は、個々のノード全体のデプロイメント値とエラーを追跡します
array

21.1.8. .status.nodeStatuses[]

説明
NodeStatus は、この Operator によって管理される特定のノードの現在の状態に関する情報を提供します。
object
必須
  • nodeName
プロパティー説明

currentRevision

integer

currentRevision は、最近成功したデプロイメントの生成です

lastFailedCount

integer

lastFailedCount は、最後に失敗したリビジョンのインストーラー Pod が失敗した頻度です。

lastFailedReason

string

lastFailedReason は、機械で読み取り可能な障害理由文字列です。

lastFailedRevision

integer

lastFailedRevision は、デプロイを試みて失敗したデプロイメントの世代です。

lastFailedRevisionErrors

array (string)

lastFailedRevisionErrors は、lastFailedRevision で参照されているデプロイメントの失敗時に人間が読み取れるエラーのリストです。

lastFailedTime

string

lastFailedTime は、最後に失敗したリビジョンが最後に失敗した時刻です。

lastFallbackCount

integer

lastFallbackCount は、前のリビジョンへのフォールバックが発生した頻度です。

nodeName

string

nodeName はノードの名前です

targetRevision

integer

targetRevision は、適用しようとしているデプロイメントの世代です

21.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/operator.openshift.io/v1/machineconfigurations

    • DELETE: MachineConfiguration のコレクションを削除します。
    • GET: MachineConfiguration のオブジェクトをリスト表示します。
    • POST: MachineConfiguration を作成します。
  • /apis/operator.openshift.io/v1/machineconfigurations/{name}

    • DELETE: MachineConfiguration を削除します。
    • GET: 指定された MachineConfiguration を読み取ります。
    • PATCH: 指定された MachineConfiguration を部分的に更新します。
    • PUT: 指定された MachineConfiguration を置き換えます。
  • /apis/operator.openshift.io/v1/machineconfigurations/{name}/status

    • GET: 指定された MachineConfiguration のステータスを読み取ります。
    • PATCH: 指定された MachineConfiguration のステータスを部分的に更新します。
    • PUT: 指定された MachineConfiguration のステータスを置き換えます。

21.2.1. /apis/operator.openshift.io/v1/machineconfigurations

HTTP メソッド
DELETE
説明
MachineConfiguration のコレクションを削除します。
表21.1 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類が MachineConfiguration のオブジェクトをリスト表示します。
表21.2 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

MachineConfigurationList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
MachineConfiguration を作成します。
表21.3 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表21.4 本文パラメーター
パラメーター説明

body

MachineConfiguration スキーマ

 
表21.5 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

MachineConfiguration スキーマ

201 - Created

MachineConfiguration スキーマ

202 - Accepted

MachineConfiguration スキーマ

401 - Unauthorized

空白

21.2.2. /apis/operator.openshift.io/v1/machineconfigurations/{name}

表21.6 グローバルパスパラメーター
パラメーター説明

name

string

MachineConfiguration の名前

HTTP メソッド
DELETE
説明
MachineConfiguration を削除します。
表21.7 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表21.8 HTTP レスポンス
HTTP コードレスポンスのボディー

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定された MachineConfiguration を読み取ります。
表21.9 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

MachineConfiguration スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された MachineConfiguration を部分的に更新します。
表21.10 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表21.11 HTTP レスポンス
HTTP コードレスポンスのボディー

200 - OK

MachineConfiguration スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された MachineConfiguration を置き換えます。
表21.12 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表21.13 本文パラメーター
パラメーター説明

body

MachineConfiguration スキーマ

 
表21.14 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

MachineConfiguration スキーマ

201 - Created

MachineConfiguration スキーマ

401 - Unauthorized

空白

21.2.3. /apis/operator.openshift.io/v1/machineconfigurations/{name}/status

表21.15 グローバルパスパラメーター
パラメーター説明

name

string

MachineConfiguration の名前

HTTP メソッド
GET
説明
指定された MachineConfiguration のステータスを読み取ります。
表21.16 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

MachineConfiguration スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された MachineConfiguration のステータスを部分的に更新します。
表21.17 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表21.18 HTTP レスポンス
HTTP コードレスポンスのボディー

200 - OK

MachineConfiguration スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された MachineConfiguration のステータスを置き換えます。
表21.19 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表21.20 本文パラメーター
パラメーター説明

body

MachineConfiguration スキーマ

 
表21.21 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

MachineConfiguration スキーマ

201 - Created

MachineConfiguration スキーマ

401 - Unauthorized

空白

第22章 Network [operator.openshift.io/v1]

説明
ネットワークは、クラスターの目的のネットワーク設定を表します。これは、cluster-network-operator によって消費されます。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
object

22.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

NetworkSpec は、最上位のネットワーク設定オブジェクトです。

status

object

NetworkStatus は、詳細な Operator ステータスであり、Networkclusteroperator オブジェクトまで抽出されます。

22.1.1. .spec

説明
NetworkSpec は、最上位のネットワーク設定オブジェクトです。
object
プロパティータイプ説明

additionalNetworks

array

additionalNetworks は、複数のネットワークが有効になっている場合に Pod で使用できるようにする追加のネットワークのリストです。

additionalNetworks[]

object

AdditionalNetworkDefinition は、使用可能であるがデフォルトでは作成されない追加のネットワークを設定します。代わりに、Pod は名前でそれらを要求する必要があります。タイプは、タイプに一致する 1 つの "Config" とともに指定する必要があります。

clusterNetwork

array

clusterNetwork は、Pod IP に使用する IP アドレスプールです。OpenShift SDN などの一部のネットワークプロバイダーは、複数の ClusterNetwork をサポートしています。他の人は 1 つだけをサポートします。これは、cluster-cidr と同等です。

clusterNetwork[]

object

ClusterNetworkEntry は、PodIP を割り当てるためのサブネットです。ノードがクラスターに参加すると、サイズ HostPrefix (CIDR 表記) のネットワークが割り当てられます。HostPrefix フィールドがプラグインで使用されていない場合は、未設定のままにしておくことができます。すべてのネットワークプロバイダーが複数の ClusterNetworks をサポートしているわけではありません

defaultNetwork

object

defaultNetwork は、すべての Pod が受信する "デフォルト" ネットワークです。

deployKubeProxy

boolean

deployKubeProxy は、スタンドアロンの kube-proxy を Operator がデプロイするかどうかを指定します。一部のネットワークプロバイダーには、kube-proxy または同様の機能が含まれています。設定されていない場合、プラグインは正しい値を選択しようとします。これは、OpenShift SDN および ovn-kubernetes が使用されている場合は false であり、それ以外の場合は true です。

disableMultiNetwork

boolean

disableMultiNetwork は、複数の Pod ネットワークのサポートを無効にするかどうかを指定します。設定されていない場合、このプロパティーはデフォルトで 'false' になり、複数のネットワークサポートが有効になります。

disableNetworkDiagnostics

boolean

disableNetworkDiagnostics は、テスト Pod からすべてのノード、apiserver、および LB への PodNetworkConnectivityCheckCR を無効にするかどうかを指定します。設定されていない場合、このプロパティーはデフォルトで 'false' になり、ネットワーク診断が有効になります。これを 'true' に設定すると、チェックを実行する Pod の追加の負荷が軽減されます。

exportNetworkFlows

object

exportNetworkFlows は、プロトコル NetFlow、SFlow、または IPFIX を使用して、Pod ネットワークからのネットワークフローメタデータのエクスポートを有効にし、設定します。現在、OVN-Kubernetes プラグインでのみサポートされています。設定されていない場合、フローはどのコレクターにもエクスポートされません。

kubeProxyConfig

object

kubeProxyConfig を使用すると、必要なプロキシー設定を設定できます。指定しない場合、適切なデフォルトが OpenShift によって直接選択されます。すべてのネットワークプロバイダーによって消費されるわけではありません - 現在は openshift-sdn のみです。

logLevel

string

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

managementState

string

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

migration

object

migration は、クラスターネットワークの移行を有効化および設定します。移行手順では、ネットワークタイプと MTU を変更できます。

observedConfig

``

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

operatorLogLevel

string

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

serviceNetwork

array (string)

serviceNetwork は、サービス IP に使用する IP アドレスプールです。現在、既存のすべてのネットワークプロバイダーは、ここでは 1 つの値のみをサポートしていますが、これは拡張を可能にする配列です。

unsupportedConfigOverrides

``

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

useMultiNetworkPolicy

boolean

useMultiNetworkPolicy は、Multus CNI によって作成された追加のネットワークで MultiNetworkPolicy オブジェクトを使用できるようにするコントローラーを有効にします。MultiNetworkPolicy は NetworkPolicy オブジェクトに似ていますが、NetworkPolicy オブジェクトはプライマリーインターフェイスにのみ適用されます。MultiNetworkPolicy を使用すると、Pod がセカンダリーインターフェイスを介して受信できるトラフィックを制御できます。設定されていない場合、このプロパティーはデフォルトで 'false' になり、MultiNetworkPolicy オブジェクトは無視されます。'disableMultiNetwork' が 'true' の場合、このフィールドの値は無視されます。

22.1.2. .spec.additionalNetworks

説明
additionalNetworks は、複数のネットワークが有効になっている場合に Pod で使用できるようにする追加のネットワークのリストです。
array

22.1.3. .spec.additionalNetworks[]

説明
AdditionalNetworkDefinition は、使用可能であるがデフォルトでは作成されない追加のネットワークを設定します。代わりに、Pod は名前でそれらを要求する必要があります。タイプは、タイプに一致する 1 つの "Config" とともに指定する必要があります。
object
プロパティータイプ説明

name

string

name はネットワークの名前です。これは、結果の CRD に入力されます。これは一意である必要があります。

namespace

string

名前空間は、ネットワークの名前空間です。これは、結果の CRD に入力されます。指定されていない場合、ネットワークはデフォルトの名前空間で作成されます。

rawCNIConfig

string

rawCNIConfig は、NetworkAttachmentDefinition CRD で作成する生の CNI 設定 json です。

simpleMacvlanConfig

object

SimpleMacvlanConfig は、type:NetworkTypeSimpleMacvlan の場合に macvlan インターフェイスを設定します。

type

string

type は、ネットワークのタイプです。サポートされる値は、NetworkTypeRaw、NetworkTypeSimpleMacvlan です。

22.1.4. .spec.additionalNetworks[].simpleMacvlanConfig

説明
SimpleMacvlanConfig は、type:NetworkTypeSimpleMacvlan の場合に macvlan インターフェイスを設定します。
object
プロパティータイプ説明

ipamConfig

object

IPAMConfig は、IPAM モジュールが IP アドレス管理 (IPAM) に使用されるように設定します。

master

string

master は、macvlan インターフェイスを作成するためのホストインターフェイスです。指定しない場合、デフォルトルートインターフェイスになります

mode

string

mode は macvlan モードです:bridge、private、vepa、passthru。デフォルトはブリッジです

mtu

integer

mtu は、macvlan インターフェイスに使用する mtu です。設定されていない場合、ホストのカーネルが値を選択します。

22.1.5. .spec.additionalNetworks[].simpleMacvlanConfig.ipamConfig

説明
IPAMConfig は、IPAM モジュールが IP アドレス管理 (IPAM) に使用されるように設定します。
object
プロパティータイプ説明

staticIPAMConfig

object

StaticIPAMConfig は、type:IPAMTypeStatic の場合に静的 IP アドレスを設定します。

type

string

タイプは、IP アドレス管理 (IPAM) に使用される IPAM モジュールのタイプです。サポートされている値は、IPAMTypeDHCP、IPAMTypeStatic です。

22.1.6. .spec.additionalNetworks[].simpleMacvlanConfig.ipamConfig.staticIPAMConfig

説明
StaticIPAMConfig は、type:IPAMTypeStatic の場合に静的 IP アドレスを設定します。
object
プロパティータイプ説明

addresses

array

アドレスは、インターフェイスの IP アドレスを設定します

addresses[]

object

StaticIPAMAddresses は、静的 IPAM アドレスの IP アドレスとゲートウェイを提供します

dns

object

DNS はインターフェイスの DNS を設定します

routes

array

ルートは、インターフェイスの IP ルートを設定します

routes[]

object

StaticIPAMRoutes は、静的 IPAM ルートの宛先/ゲートウェイペアを提供します

22.1.7. .spec.additionalNetworks[].simpleMacvlanConfig.ipamConfig.staticIPAMConfig.addresses

説明
アドレスは、インターフェイスの IP アドレスを設定します
array

22.1.8. .spec.additionalNetworks[].simpleMacvlanConfig.ipamConfig.staticIPAMConfig.addresses[]

説明
StaticIPAMAddresses は、静的 IPAM アドレスの IP アドレスとゲートウェイを提供します
object
プロパティータイプ説明

address

string

アドレスは CIDR 形式の IP アドレスです

gateway

string

ゲートウェイは、ゲートウェイとして指定するサブネット内の IP です

22.1.9. .spec.additionalNetworks[].simpleMacvlanConfig.ipamConfig.staticIPAMConfig.dns

説明
DNS はインターフェイスの DNS を設定します
object
プロパティータイプ説明

domain

string

ドメインは、短いホスト名検索に使用されるローカルドメインのドメイン名を設定します

nameservers

array (string)

Nameservers は IP ルックアップ用の DNS サーバーを指します

search

array (string)

検索は、短いホスト名ルックアップ用に優先順位の高い検索ドメインを設定します

22.1.10. .spec.additionalNetworks[].simpleMacvlanConfig.ipamConfig.staticIPAMConfig.routes

説明
ルートは、インターフェイスの IP ルートを設定します
array

22.1.11. .spec.additionalNetworks[].simpleMacvlanConfig.ipamConfig.staticIPAMConfig.routes[]

説明
StaticIPAMRoutes は、静的 IPAM ルートの宛先/ゲートウェイペアを提供します
object
プロパティータイプ説明

destination

string

宛先は IP ルートの宛先を指します

gateway

string

ゲートウェイはルートのネクストホップ IP アドレスです。設定されていない場合、デフォルトゲートウェイが想定されます (CNI プラグインによって決定されます)。

22.1.12. .spec.clusterNetwork

説明
clusterNetwork は、Pod IP に使用する IP アドレスプールです。OpenShift SDN などの一部のネットワークプロバイダーは、複数の ClusterNetwork をサポートしています。他の人は 1 つだけをサポートします。これは、cluster-cidr と同等です。
array

22.1.13. .spec.clusterNetwork[]

説明
ClusterNetworkEntry は、PodIP を割り当てるためのサブネットです。ノードがクラスターに参加すると、サイズ HostPrefix (CIDR 表記) のネットワークが割り当てられます。HostPrefix フィールドがプラグインで使用されていない場合は、未設定のままにしておくことができます。すべてのネットワークプロバイダーが複数の ClusterNetworks をサポートしているわけではありません
object
プロパティー説明

cidr

string

 

hostPrefix

integer

 

22.1.14. .spec.defaultNetwork

説明
defaultNetwork は、すべての Pod が受信する "デフォルト" ネットワークです。
object
プロパティー説明

openshiftSDNConfig

object

openShiftSDNConfig は、openshift-sdn プラグインを設定します

ovnKubernetesConfig

object

ovnKubernetesConfig は、ovn-kubernetes プラグインを設定します。

type

string

type は、ネットワークのタイプです。NetworkTypeRaw を除くすべての NetworkTypes がサポートされています

22.1.15. .spec.defaultNetwork.openshiftSDNConfig

説明
openShiftSDNConfig は、openshift-sdn プラグインを設定します
object
プロパティー説明

enableUnidling

boolean

enableUnidling は、サービスプロキシーがサービスのアイドリングとアンアイドリングをサポートするかどうかを制御します。デフォルトでは、アイドル解除が有効になっています。

mode

string

モードは、"Multitenant"、"Subnet"、または "NetworkPolicy" のいずれかです。

mtu

integer

mtu は、トンネルインターフェイスに使用する mtu です。設定されていない場合、デフォルトは 1450 です。これは、マシンのアップリンクより 50 バイト小さくする必要があります。

useExternalOpenvswitch

boolean

useExternalOpenvswitch は、Operator が OVS DaemonSet 自体をデプロイするか、他の誰かが OVS を開始することを期待するかを制御するために使用されます。4.6 以降、OVS は常にシステムサービスとして実行され、このフラグは無視されます。非推奨:4.6 の時点で機能していません

vxlanPort

integer

vxlanPort は、すべての vxlan パケットに使用するポートです。デフォルトでは 4789 です。

22.1.16. .spec.defaultNetwork.ovnKubernetesConfig

説明
ovnKubernetesConfig は、ovn-kubernetes プラグインを設定します。
object
プロパティー説明

egressIPConfig

object

egressIPConfig は、EgressIP オプションの設定を保持します。

gatewayConfig

object

gatewayConfig は、ノードゲートウェイオプションの設定を保持します。

genevePort

integer

ジュネーブポートは、ジュネーブカプセル化で使用される UDP ポートです。デフォルトは 6081 です。

hybridOverlayConfig

object

HybridOverlayConfig は、OVN を使用していないピア用に追加のオーバーレイネットワークを設定します。

ipsecConfig

object

ipsecConfig は、クラスター内の Pod ネットワーク上の Pod の IPsec を有効にして設定します。

ipv4

object

ipv4 を使用すると、IPv4 接続の IP 設定を指定できます。省略すると、指定なしとみなされ、デフォルトの設定が使用されます。デフォルト値の詳細は、ipv4 内の個々のフィールドを確認してください。

ipv6

object

ipv6 を使用すると、IPv6 接続の IP 設定を設定できます。省略すると、指定なしとみなされ、デフォルトの設定が使用されます。デフォルト値の詳細は、ipv4 内の個々のフィールドを確認してください。

mtu

integer

mtu は、トンネルインターフェイスに使用する MTU です。これは、アップリンク mtu よりも 100 バイト小さくする必要があります。デフォルトは 1400 です。

policyAuditConfig

object

policyAuditConfig は、ネットワークポリシー監査イベントの設定です。設定されていない場合、報告されたデフォルトが使用されます。

v4InternalSubnet

string

v4InternalSubnet は、デフォルトのサブネットがすでに ovn-kubernetes 以外のものによって使用されている場合に、ovn-kubernetes によって内部的に使用される v4 サブネットです。OpenShift またはノードネットワークによって使用されている他のサブネットと重複することはできません。サブネットのサイズは、ノード数より大きくする必要があります。インストール後は値を変更できません。デフォルトは 100.64.0.0/16 です。

v6InternalSubnet

string

v6InternalSubnet は、デフォルトのサブネットがすでに ovn-kubernetes 以外のものによって使用されている場合に、ovn-kubernetes によって内部的に使用される v6 サブネットです。OpenShift またはノードネットワークによって使用されている他のサブネットと重複することはできません。サブネットのサイズは、ノード数より大きくする必要があります。インストール後は値を変更できません。デフォルトは fd98::/48 です。

22.1.17. .spec.defaultNetwork.ovnKubernetesConfig.egressIPConfig

説明
egressIPConfig は、EgressIP オプションの設定を保持します。
object
プロパティー説明

reachabilityTotalTimeoutSeconds

integer

reachabilityTotalTimeout は、EgressIP ノードの到達可能性チェックの合計タイムアウトを秒単位で設定します。このタイムアウト内に EgressIP ノードに到達できない場合、ノードはダウンしていると宣言されます。大きな値を設定すると、EgressIP 機能がノードの変更に反応するのが遅くなる可能性があります。特に、実際に問題が発生して到達できない EgressIP ノードに対する反応が遅くなる可能性があります。省略すると、ユーザーによる指定なしとみなされ、プラットフォームによって適切なデフォルトが選択されます。デフォルトは、今後変更される可能性があります。現在のデフォルトは 1 秒です。値が 0 の場合、EgressIP ノードの到達可能性チェックは無効になります。

22.1.18. .spec.defaultNetwork.ovnKubernetesConfig.gatewayConfig

説明
gatewayConfig は、ノードゲートウェイオプションの設定を保持します。
object
プロパティー説明

ipForwarding

string

IPForwarding は、OVN-Kubernetes 管理インターフェイス (br-ex など) 上のすべてのトラフィックの IP 転送を制御します。デフォルトでは、これは Restricted に設定されており、Kubernetes 関連のトラフィックは適切に転送されますが、その他の IP トラフィックは OCP ノードによってルーティングされません。ホストが OVN-Kubernetes 管理インターフェイス間でトラフィックを転送できるようにする場合は、このフィールドを "Global" に設定します。サポートされている値は "Restricted" と "Global" です。

ipv4

object

ipv4 を使用すると、IPv4 接続の IP 設定を指定できます。省略すると、指定なしとみなされ、デフォルトの設定が使用されます。デフォルト値の詳細は、ipv4 内の個々のメンバーフィールドを確認してください。

ipv6

object

ipv6 を使用すると、IPv6 接続の IP 設定を設定できます。省略すると、指定なしとみなされ、デフォルトの設定が使用されます。デフォルト値の詳細は、ipv6 内の個々のメンバーフィールドを確認してください。

routingViaHost

boolean

RoutingViaHost を使用すると、Pod の Egress トラフィックが ovn-k8s-mp0 管理ポート経由でホストに出てから送信されるようになります。これが設定されていない場合、トラフィックはホストスタックに達することなく、常に OVN から外部に直接出力されます。これを true に設定すると、ハードウェアオフロードがサポートされなくなります。GatewayConfig が指定されている場合、デフォルトは false です。

22.1.19. .spec.defaultNetwork.ovnKubernetesConfig.gatewayConfig.ipv4

説明
ipv4 を使用すると、IPv4 接続の IP 設定を指定できます。省略すると、指定なしとみなされ、デフォルトの設定が使用されます。デフォルト値の詳細は、ipv4 内の個々のメンバーフィールドを確認してください。
object
プロパティー説明

internalMasqueradeSubnet

string

internalMasqueradeSubnet には、ホストからサービスへのトラフィックを有効にするために ovn-kubernetes によって内部的に使用される IPV4 CIDR 形式のマスカレードアドレスが格納されます。このアドレスと共有ゲートウェイブリッジインターフェイスを使用してクラスター内の各ホストが設定されます。値はインストール後に変更できます。選択したサブネットが、OVN-Kubernetes に指定された他のネットワークや、ホストで使用される他のネットワークと重複しないようにしてください。さらに、サブネットは 6 つの IP (最大接頭辞長 /29) を収容できる大きさである必要があります。省略すると、指定なしとみなされ、プラットフォームによって適切なデフォルトが選択されます。デフォルトは、今後変更される可能性があります。現在のデフォルトのサブネットは 169.254.169.0/29 です。値は適切な IPV4 CIDR 形式である必要がありま。

22.1.20. .spec.defaultNetwork.ovnKubernetesConfig.gatewayConfig.ipv6

説明
ipv6 を使用すると、IPv6 接続の IP 設定を設定できます。省略すると、指定なしとみなされ、デフォルトの設定が使用されます。デフォルト値の詳細は、ipv6 内の個々のメンバーフィールドを確認してください。
object
プロパティー説明

internalMasqueradeSubnet

string

internalMasqueradeSubnet には、ホストからサービスへのトラフィックを有効にするために ovn-kubernetes によって内部的に使用される IPV6 CIDR 形式のマスカレードアドレスが格納されます。このアドレスと共有ゲートウェイブリッジインターフェイスを使用してクラスター内の各ホストが設定されます。値はインストール後に変更できます。選択したサブネットが、OVN-Kubernetes に指定された他のネットワークや、ホストで使用される他のネットワークと重複しないようにしてください。さらに、サブネットは 6 つの IP (最大接頭辞長 /125) を収容できる大きさである必要があります。省略すると、指定なしとみなされ、プラットフォームによって適切なデフォルトが選択されます。デフォルトは、今後変更される可能性があります。現在のデフォルトのサブネットは fd69::/125 です。IPV6 デュアルアドレスは許可されていないことに注意してください。

22.1.21. .spec.defaultNetwork.ovnKubernetesConfig.hybridOverlayConfig

説明
HybridOverlayConfig は、OVN を使用していないピア用に追加のオーバーレイネットワークを設定します。
object
プロパティー説明

hybridClusterNetwork

array

HybridClusterNetwork は、追加のオーバーレイネットワーク上のノードに与えられるネットワークスペースを定義します。

hybridClusterNetwork[]

object

ClusterNetworkEntry は、PodIP を割り当てるためのサブネットです。ノードがクラスターに参加すると、サイズ HostPrefix (CIDR 表記) のネットワークが割り当てられます。HostPrefix フィールドがプラグインで使用されていない場合は、未設定のままにしておくことができます。すべてのネットワークプロバイダーが複数の ClusterNetworks をサポートしているわけではありません

hybridOverlayVXLANPort

integer

HybridOverlayVXLANPort は、追加のオーバーレイネットワークで使用される VXLAN ポート番号を定義します。デフォルトは 4789 です。

22.1.22. .spec.defaultNetwork.ovnKubernetesConfig.hybridOverlayConfig.hybridClusterNetwork

説明
HybridClusterNetwork は、追加のオーバーレイネットワーク上のノードに与えられるネットワークスペースを定義します。
array

22.1.23. .spec.defaultNetwork.ovnKubernetesConfig.hybridOverlayConfig.hybridClusterNetwork[]

説明
ClusterNetworkEntry は、PodIP を割り当てるためのサブネットです。ノードがクラスターに参加すると、サイズ HostPrefix (CIDR 表記) のネットワークが割り当てられます。HostPrefix フィールドがプラグインで使用されていない場合は、未設定のままにしておくことができます。すべてのネットワークプロバイダーが複数の ClusterNetworks をサポートしているわけではありません
object
プロパティータイプ説明

cidr

string

 

hostPrefix

integer

 

22.1.24. .spec.defaultNetwork.ovnKubernetesConfig.ipsecConfig

説明
ipsecConfig は、クラスター内の Pod ネットワーク上の Pod の IPsec を有効にして設定します。
object
プロパティータイプ説明

mode

string

mode は、プラットフォーム内の ipsec 設定の動作を定義します。有効な値は、DisabledExternal、および Full です。'Disabled' の場合、ipsec はノードレベルで有効になりません。'External' の場合、ipsec はノードレベルで有効になりますが、ユーザーがセキュアな通信パラメーターを設定する必要があります。このモードはセキュアな外部通信用であり、k8s-nmstate Operator を使用して設定できます。'Full' の場合、ipsec はノードレベルで設定され、クラスター内の Pod 間のセキュアな通信が設定されます。Full の場合に、外部 (クラスター) エンティティー (ストレージアレイなど) との通信に ipsec が必要なときは、それをユーザーが設定する必要があることに注意してください。

22.1.25. .spec.defaultNetwork.ovnKubernetesConfig.ipv4

説明
ipv4 を使用すると、IPv4 接続の IP 設定を指定できます。省略すると、指定なしとみなされ、デフォルトの設定が使用されます。デフォルト値の詳細は、ipv4 内の個々のフィールドを確認してください。
object
プロパティー説明

internalJoinSubnet

string

internalJoinSubnet は、デフォルトのサブネットがすでに ovn-kubernetes 以外のものによって使用されている場合に、ovn-kubernetes によって内部的に使用される v4 サブネットです。OpenShift またはノードネットワークによって使用されている他のサブネットと重複することはできません。サブネットのサイズは、ノード数より大きくする必要があります。インストール後は値を変更できません。現在のデフォルト値は 100.64.0.0/16 です。サブネットは、クラスター内のノードごとに 1 つの IP を収容できる大きさである必要があります。値は適切な IPV4 CIDR 形式である必要があります。

internalTransitSwitchSubnet

string

internalTransitSwitchSubnet は、OVN-Kubernetes によって内部的に使用される IPV4 CIDR 形式の v4 サブネットです。これは、各ノードのクラスタールーターを接続して east west トラフィックを可能にする OVN Interconnect アーキテクチャーの分散トランジットスイッチに使用されます。選択したサブネットが、OVN-Kubernetes に指定された他のネットワークや、ホストで使用される他のネットワークと重複しないようにしてください。インストール後は値を変更できません。省略すると、指定なしとみなされ、プラットフォームによって適切なデフォルトが選択されます。デフォルトは、今後変更される可能性があります。現在のデフォルトのサブネットは 100.88.0.0/16 です。サブネットは、クラスター内のノードごとに 1 つの IP を収容できる大きさである必要があります。値は適切な IPV4 CIDR 形式である必要があります。

22.1.26. .spec.defaultNetwork.ovnKubernetesConfig.ipv6

説明
ipv6 を使用すると、IPv6 接続の IP 設定を設定できます。省略すると、指定なしとみなされ、デフォルトの設定が使用されます。デフォルト値の詳細は、ipv4 内の個々のフィールドを確認してください。
object
プロパティー説明

internalJoinSubnet

string

internalJoinSubnet は、デフォルトのサブネットがすでに ovn-kubernetes 以外のものによって使用されている場合に、ovn-kubernetes によって内部的に使用される v6 サブネットです。OpenShift またはノードネットワークによって使用されている他のサブネットと重複することはできません。サブネットのサイズは、ノード数より大きくする必要があります。インストール後は値を変更できません。サブネットは、クラスター内のノードごとに 1 つの IP を収容できる大きさである必要があります。現在のデフォルト値は fd98::/48 です。値は適切な IPV6 CIDR 形式である必要があります。IPV6 デュアルアドレスは許可されていないことに注意してください。

internalTransitSwitchSubnet

string

internalTransitSwitchSubnet は、OVN-Kubernetes によって内部的に使用される IPV4 CIDR 形式の v4 サブネットです。これは、各ノードのクラスタールーターを接続して east west トラフィックを可能にする OVN Interconnect アーキテクチャーの分散トランジットスイッチに使用されます。選択したサブネットが、OVN-Kubernetes に指定された他のネットワークや、ホストで使用される他のネットワークと重複しないようにしてください。インストール後は値を変更できません。省略すると、指定なしとみなされ、プラットフォームによって適切なデフォルトが選択されます。デフォルトは、今後変更される可能性があります。サブネットは、クラスター内のノードごとに 1 つの IP を収容できる大きさである必要があります。現在のデフォルトのサブネットは fd97::/64 です。値は適切な IPV6 CIDR 形式である必要があります。IPV6 デュアルアドレスは許可されていないことに注意してください。

22.1.27. .spec.defaultNetwork.ovnKubernetesConfig.policyAuditConfig

説明
policyAuditConfig は、ネットワークポリシー監査イベントの設定です。設定されていない場合、報告されたデフォルトが使用されます。
object
プロパティー説明

destination

string

destination は、ポリシーログメッセージの場所です。この設定に関係なく、永続ログは常に/var/log/ovn/のホストにダンプされますが、さらに、syslog 出力は次のように設定できます。有効な値は次のとおりです。- "libc"→ホストノードの journdald プロセスの libc syslog() 関数を使用する場合 - "udp:host:port" → UDP 経由で syslog を送信する場合 - "unix:file"→UNIX ドメインソケットを使用する場合直接 - "null" → syslog に記録されたすべてのメッセージを破棄するデフォルトは "null" です

maxFileSize

integer

maxFilesSize は、ローテーションが発生する前に ACL_audit ログファイルが到達できる最大サイズです。単位は MB で、デフォルトは 50MB です。

maxLogFiles

integer

maxLogFiles は、存在できる ACL_audit ログファイルの最大数を指定します。

rateLimit

integer

rateLimit は、ノードごとに 1 秒あたりに生成されるメッセージのおおよその最大数です。設定を解除すると、デフォルトの 20 msg/sec が使用されます。

syslogFacility

string

syslogFacility 生成されたメッセージ ("kern" など) 用の RFC5424 機能。デフォルトは "local0" です

22.1.28. .spec.exportNetworkFlows

説明
exportNetworkFlows は、プロトコル NetFlow、SFlow、または IPFIX を使用して、Pod ネットワークからのネットワークフローメタデータのエクスポートを有効にし、設定します。現在、OVN-Kubernetes プラグインでのみサポートされています。設定されていない場合、フローはどのコレクターにもエクスポートされません。
object
プロパティー説明

ipfix

object

ipfix は IPFIX 設定を定義します。

netFlow

object

netFlow は、NetFlow 設定を定義します。

sFlow

object

sFlow は SFlow 設定を定義します。

22.1.29. .spec.exportNetworkFlows.ipfix

説明
ipfix は IPFIX 設定を定義します。
object
プロパティー説明

コレクター

array (string)

ipfixCollectors は、最大 10 個の項目を持つ ip:port としてフォーマットされた文字列のリストです。

22.1.30. .spec.exportNetworkFlows.netFlow

説明
netFlow は、NetFlow 設定を定義します。
object
プロパティー説明

コレクター

array (string)

netFlow は、OVS からエクスポートされたフローデータを消費する NetFlow コレクターを定義します。これは、最大 10 個の項目を持つ ip:port としてフォーマットされた文字列のリストです。

22.1.31. .spec.exportNetworkFlows.sFlow

説明
sFlow は SFlow 設定を定義します。
object
プロパティー説明

コレクター

array (string)

sFlowCollectors は、最大 10 個のアイテムを含む ip:port としてフォーマットされた文字列のリストです。

22.1.32. .spec.kubeProxyConfig

説明
kubeProxyConfig を使用すると、必要なプロキシー設定を設定できます。指定しない場合、適切なデフォルトが OpenShift によって直接選択されます。すべてのネットワークプロバイダーによって消費されるわけではありません - 現在は openshift-sdn のみです。
object
プロパティー説明

bindAddress

string

デフォルトで 0.0.0.0 に "バインド" するアドレス

iptablesSyncPeriod

string

内部 kube-proxy パラメーター。OCP の古いリリースでは、パフォーマンス上の理由から大規模なクラスターでこれを調整する必要がある場合がありましたが、これは不要になり、デフォルト値から変更する理由はありません。デフォルト:30 秒

proxyArguments

object

kubeproxy プロセスに渡す追加の引数

proxyArguments{}

array (string)

ProxyArgumentList は、kubeproxy プロセスに渡す引数のリストです。

22.1.33. .spec.kubeProxyConfig.proxyArguments

説明
kubeproxy プロセスに渡す追加の引数
object

22.1.34. .spec.migration

説明
migration は、クラスターネットワークの移行を有効化および設定します。移行手順では、ネットワークタイプと MTU を変更できます。
object
プロパティー説明

features

object

features には、機能移行設定を含めます。クラスターのデフォルトネットワークプロバイダーを変更するときに機能設定を移行するには、これを設定します。設定されていない場合、デフォルトの操作では、サポートされている機能のすべての設定が移行されます。

mode

string

mode は、ネットワーク移行のモードを示します。サポートされている値は、"Live" および "Offline" です (省略可能)。"Live" 移行操作では、各ノードの CNI が 1 つずつ移行されるため、サービスの中断が発生しません。ネットワークの移行中もクラスターネットワークが通常どおり動作します。"Offline" 移行操作では、サービスが中断されます。"Offline" 移行時にはノードの再起動が 2 回必要です。ネットワークの移行中はクラスターネットワークが正常に動作しません。省略すると、指定なしとみなされ、プラットフォームによって適切なデフォルトが選択されます。デフォルトは、今後変更される可能性があります。現在のデフォルト値は "Offline" です。

mtu

object

mtu には、MTU 移行設定を含めます。デフォルトネットワークの MTU 値の変更を許可するには、これを設定します。設定されていない場合、デフォルトネットワークの MTU を変更する操作が拒否されます。

networkType

string

networkType は、ネットワーク移行のターゲットタイプです。デフォルトのネットワークの変更を許可するには、これをターゲットネットワークタイプに設定します。設定されていない場合、クラスターのデフォルトネットワークプラグインを変更する操作が拒否されます。サポートされている値は OpenShiftSDN、OVNKubernetes です。

22.1.35. .spec.migration.features

説明
features には、機能移行設定を含めます。クラスターのデフォルトネットワークプロバイダーを変更するときに機能設定を移行するには、これを設定します。設定されていない場合、デフォルトの操作では、サポートされている機能のすべての設定が移行されます。
object
プロパティー説明

egressFirewall

boolean

egressFirewall は、クラスターのデフォルトネットワークプロバイダーを変更するときに、Egress ファイアウォール設定を自動的に移行するかどうかを指定します。設定されていない場合、このプロパティーはデフォルトで 'true' に設定され、Egress ファイアウォールの設定が移行されます。

egressIP

boolean

egressIP は、クラスターのデフォルトネットワークプロバイダーを変更するときに、Egress IP 設定を自動的に移行するかどうかを指定します。設定されていない場合、このプロパティーはデフォルトで 'true' に設定され、Egress IP 設定が移行されます。

multicast

boolean

multicast は、クラスターのデフォルトネットワークプロバイダーを変更するときに、マルチキャスト設定を自動的に移行するかどうかを指定します。設定されていない場合、このプロパティーはデフォルトで 'true' に設定され、マルチキャスト設定が移行されます。

22.1.36. .spec.migration.mtu

説明
mtu には、MTU 移行設定を含めます。デフォルトネットワークの MTU 値の変更を許可するには、これを設定します。設定されていない場合、デフォルトネットワークの MTU を変更する操作が拒否されます。
object
プロパティー説明

machine

object

machine には、マシンのアップリンクの MTU 移行設定を含めます。現在のアップリンク MTU がすでにデフォルトのネットワーク MTU に対応している場合を除き、デフォルトのネットワーク MTU とともに移行する必要があります。

network

object

network には、デフォルトネットワークの MTU 移行に関する情報を含めます。マシンのアップリンク MTU よりも MTU 値が適切な最小オフセット分だけ低い場合にのみ、移行が許可されます。

22.1.37. .spec.migration.mtu.machine

説明
machine には、マシンのアップリンクの MTU 移行設定を含めます。現在のアップリンク MTU がすでにデフォルトのネットワーク MTU に対応している場合を除き、デフォルトのネットワーク MTU とともに移行する必要があります。
object
プロパティー説明

from

integer

from は移行元の MTU です。

to

integer

to は移行先の MTU です。

22.1.38. .spec.migration.mtu.network

説明
network には、デフォルトネットワークの MTU 移行に関する情報を含めます。マシンのアップリンク MTU よりも MTU 値が適切な最小オフセット分だけ低い場合にのみ、移行が許可されます。
object
プロパティー説明

from

integer

from は移行元の MTU です。

to

integer

to は移行先の MTU です。

22.1.39. .status

説明
NetworkStatus は、詳細な Operator ステータスであり、Networkclusteroperator オブジェクトまで抽出されます。
object
プロパティー説明

conditions

array

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

conditions[]

object

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

generations

array

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

generations[]

object

GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。

observedGeneration

integer

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

readyReplicas

integer

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

version

string

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

22.1.40. .status.conditions

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

22.1.41. .status.conditions[]

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

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

22.1.42. .status.generations

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

22.1.43. .status.generations[]

説明
GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。
object
プロパティー説明

group

string

グループはあなたが追跡しているもののグループです

ハッシュ

string

ハッシュは、シークレットや設定マップのようにコンテンツに依存する、生成されないリソース用に設定されたオプションのフィールドです。

lastGeneration

integer

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

name

string

name は、追跡しているものの名前です

namespace

string

名前空間は、追跡しているものがどこにあるかです

resource

string

リソースは、追跡しているもののリソースタイプです

22.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/operator.openshift.io/v1/networks

    • 削除: ネットワークのコレクションを削除します
    • GET: 種類が Network のオブジェクトをリスト表示します。
    • POST: ネットワークを作成する
  • /apis/operator.openshift.io/v1/networks/{name}

    • 削除: ネットワークを削除します
    • GET: 指定されたネットワークを読み取ります
    • PATCH: 指定されたネットワークを部分的に更新します
    • PUT: 指定されたネットワークを置き換えます

22.2.1. /apis/operator.openshift.io/v1/networks

HTTP メソッド
DELETE
説明
ネットワークのコレクションを削除する
表22.1 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類が Network のオブジェクトをリスト表示します。
表22.2 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

NetworkList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
ネットワークの作成
表22.3 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表22.4 本文パラメーター
パラメーター説明

body

Network スキーマ

 
表22.5 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

Network スキーマ

201 - Created

Network スキーマ

202 - Accepted

Network スキーマ

401 - Unauthorized

空白

22.2.2. /apis/operator.openshift.io/v1/networks/{name}

表22.6 グローバルパスパラメーター
パラメーター説明

name

string

ネットワークの名前

HTTP メソッド
DELETE
説明
ネットワークの削除
表22.7 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表22.8 HTTP レスポンス
HTTP コードレスポンスのボディー

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定されたネットワークを読み取る
表22.9 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

Network スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定されたネットワークを部分的に更新します
表22.10 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表22.11 HTTP 応答
HTTP コード応答本文

200 - OK

Network スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定されたネットワークを交換してください
表22.12 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表22.13 本文パラメーター
パラメータータイプ説明

body

Network スキーマ

 
表22.14 HTTP 応答
HTTP コード応答本文

200 - OK

Network スキーマ

201 - Created

Network スキーマ

401 - Unauthorized

空白

第23章 OpenShiftAPIServer [operator.openshift.io/v1]

説明
OpenShiftAPIServer は、openshift-apiserver を管理するための Operator を設定するための情報を提供します。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object
必須
  • spec

23.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 は、OpenShift API サーバーの望ましい動作の仕様です。

status

object

status は、OpenShift API サーバーの監視対象ステータスを定義します。

23.1.1. .spec

説明
spec は、OpenShift API サーバーの望ましい動作の仕様です。
object
プロパティータイプ説明

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".

unsupportedConfigOverrides

``

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

23.1.2. .status

説明
status は、OpenShift API サーバーの監視対象ステータスを定義します。
object
プロパティータイプ説明

conditions

array

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

conditions[]

object

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

generations

array

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

generations[]

object

GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。

latestAvailableRevision

integer

latestAvailableRevision は、encryption-config などの改訂されたシークレットの接尾辞として使用される最新の改訂です。新しいリビジョンにより、Pod が新たにデプロイされます。

observedGeneration

integer

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

readyReplicas

integer

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

version

string

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

23.1.3. .status.conditions

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

23.1.4. .status.conditions[]

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

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

23.1.5. .status.generations

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

23.1.6. .status.generations[]

説明
GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。
object
プロパティータイプ説明

group

string

グループはあなたが追跡しているもののグループです

ハッシュ

string

ハッシュは、シークレットや設定マップのようにコンテンツに依存する、生成されないリソース用に設定されたオプションのフィールドです。

lastGeneration

integer

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

name

string

name は、追跡しているものの名前です

namespace

string

名前空間は、追跡しているものがどこにあるかです

resource

string

リソースは、追跡しているもののリソースタイプです

23.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/operator.openshift.io/v1/openshiftapiservers

    • DELETE:OpenShiftAPIServer のコレクションを削除します
    • GET: 種類の OpenShiftAPIServer のオブジェクトをリスト表示します
    • POST:OpenShiftAPIServer を作成します
  • /apis/operator.openshift.io/v1/openshiftapiservers/{name}

    • 削除:OpenShiftAPIServer を削除します
    • GET: 指定された OpenShiftAPIServer を読み取ります
    • PATCH: 指定された OpenShiftAPIServer を部分的に更新します
    • PUT: 指定された OpenShiftAPIServer を置き換えます
  • /apis/operator.openshift.io/v1/openshiftapiservers/{name}/status

    • GET: 指定された OpenShiftAPIServer のステータスを読み取ります
    • PATCH: 指定された OpenShiftAPIServer のステータスを部分的に更新します
    • PUT: 指定された OpenShiftAPIServer のステータスを置き換えます

23.2.1. /apis/operator.openshift.io/v1/openshiftapiservers

HTTP メソッド
DELETE
説明
OpenShiftAPIServer のコレクションを削除します
表23.1 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類が OpenShiftAPIServer のオブジェクトをリスト表示します。
表23.2 HTTP 応答
HTTP コード応答本文

200 - OK

OpenShiftAPIServerList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
OpenShiftAPIServer を作成します
表23.3 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表23.4 本文パラメーター
パラメータータイプ説明

body

OpenShiftAPIServer スキーマ

 
表23.5 HTTP 応答
HTTP コード応答本文

200 - OK

OpenShiftAPIServer スキーマ

201 - Created

OpenShiftAPIServer スキーマ

202 - Accepted

OpenShiftAPIServer スキーマ

401 - Unauthorized

空白

23.2.2. /apis/operator.openshift.io/v1/openshiftapiservers/{name}

表23.6 グローバルパスパラメーター
パラメータータイプ説明

name

string

OpenShiftAPIServer の名前

HTTP メソッド
DELETE
説明
OpenShiftAPIServer を削除します
表23.7 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表23.8 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定された OpenShiftAPIServer を読み取ります
表23.9 HTTP 応答
HTTP コード応答本文

200 - OK

OpenShiftAPIServer スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された OpenShiftAPIServer を部分的に更新します
表23.10 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表23.11 HTTP 応答
HTTP コード応答本文

200 - OK

OpenShiftAPIServer スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された OpenShiftAPIServer を置き換えます
表23.12 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表23.13 本文パラメーター
パラメータータイプ説明

body

OpenShiftAPIServer スキーマ

 
表23.14 HTTP 応答
HTTP コード応答本文

200 - OK

OpenShiftAPIServer スキーマ

201 - Created

OpenShiftAPIServer スキーマ

401 - Unauthorized

空白

23.2.3. /apis/operator.openshift.io/v1/openshiftapiservers/{name}/status

表23.15 グローバルパスパラメーター
パラメータータイプ説明

name

string

OpenShiftAPIServer の名前

HTTP メソッド
GET
説明
指定された OpenShiftAPIServer のステータスを読み取ります
表23.16 HTTP 応答
HTTP コード応答本文

200 - OK

OpenShiftAPIServer スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された OpenShiftAPIServer のステータスを部分的に更新します
表23.17 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表23.18 HTTP 応答
HTTP コード応答本文

200 - OK

OpenShiftAPIServer スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された OpenShiftAPIServer のステータスを置き換えます
表23.19 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表23.20 本文パラメーター
パラメーター説明

body

OpenShiftAPIServer スキーマ

 
表23.21 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

OpenShiftAPIServer スキーマ

201 - Created

OpenShiftAPIServer スキーマ

401 - Unauthorized

空白

第24章 OpenShiftControllerManager [operator.openshift.io/v1]

説明
OpenShiftControllerManager は、openshift-controller-manager を管理するように Operator を設定するための情報を提供します。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
object
必須
  • spec

24.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

 

status

object

 

24.1.1. .spec

説明
タイプ
object
プロパティータイプ説明

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".

unsupportedConfigOverrides

``

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

24.1.2. .status

説明
タイプ
object
プロパティータイプ説明

conditions

array

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

conditions[]

object

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

generations

array

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

generations[]

object

GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。

observedGeneration

integer

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

readyReplicas

integer

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

version

string

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

24.1.3. .status.conditions

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

24.1.4. .status.conditions[]

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

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

24.1.5. .status.generations

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

24.1.6. .status.generations[]

説明
GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。
object
プロパティー説明

group

string

グループはあなたが追跡しているもののグループです

ハッシュ

string

ハッシュは、シークレットや設定マップのようにコンテンツに依存する、生成されないリソース用に設定されたオプションのフィールドです。

lastGeneration

integer

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

name

string

name は、追跡しているものの名前です

namespace

string

名前空間は、追跡しているものがどこにあるかです

resource

string

リソースは、追跡しているもののリソースタイプです

24.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/operator.openshift.io/v1/openshiftcontrollermanagers

    • DELETE:OpenShiftControllerManager のコレクションを削除します
    • GET: 種類のオブジェクトをリスト表示する OpenShiftControllerManager
    • POST:OpenShiftControllerManager を作成します
  • /apis/operator.openshift.io/v1/openshiftcontrollermanagers/{name}

    • 削除:OpenShiftControllerManager を削除します
    • GET: 指定された OpenShiftControllerManager を読み取ります
    • PATCH: 指定された OpenShiftControllerManager を部分的に更新します
    • PUT: 指定された OpenShiftControllerManager を置き換えます
  • /apis/operator.openshift.io/v1/openshiftcontrollermanagers/{name}/status

    • GET: 指定された OpenShiftControllerManager のステータスを読み取ります
    • PATCH: 指定された OpenShiftControllerManager のステータスを部分的に更新します
    • PUT: 指定された OpenShiftControllerManager のステータスを置き換えます

24.2.1. /apis/operator.openshift.io/v1/openshiftcontrollermanagers

HTTP メソッド
DELETE
説明
OpenShiftControllerManager のコレクションを削除します
表24.1 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類が OpenShiftControllerManager のオブジェクトをリスト表示します。
表24.2 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

OpenShiftControllerManagerList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
OpenShiftControllerManager を作成します
表24.3 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表24.4 本文パラメーター
パラメーター説明

body

OpenShiftControllerManager スキーマ

 
表24.5 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

OpenShiftControllerManager スキーマ

201 - Created

OpenShiftControllerManager スキーマ

202 - Accepted

OpenShiftControllerManager スキーマ

401 - Unauthorized

空白

24.2.2. /apis/operator.openshift.io/v1/openshiftcontrollermanagers/{name}

表24.6 グローバルパスパラメーター
パラメーター説明

name

string

OpenShiftControllerManager の名前

HTTP メソッド
DELETE
説明
OpenShiftControllerManager を削除します
表24.7 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表24.8 HTTP レスポンス
HTTP コードレスポンスのボディー

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定された OpenShiftControllerManager を読み取ります
表24.9 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

OpenShiftControllerManager スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された OpenShiftControllerManager を部分的に更新します
表24.10 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表24.11 HTTP レスポンス
HTTP コードレスポンスのボディー

200 - OK

OpenShiftControllerManager スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された OpenShiftControllerManager を置き換えます
表24.12 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表24.13 本文パラメーター
パラメーター説明

body

OpenShiftControllerManager スキーマ

 
表24.14 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

OpenShiftControllerManager スキーマ

201 - Created

OpenShiftControllerManager スキーマ

401 - Unauthorized

空白

24.2.3. /apis/operator.openshift.io/v1/openshiftcontrollermanagers/{name}/status

表24.15 グローバルパスパラメーター
パラメーター説明

name

string

OpenShiftControllerManager の名前

HTTP メソッド
GET
説明
指定された OpenShiftControllerManager のステータスを読み取ります
表24.16 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

OpenShiftControllerManager スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された OpenShiftControllerManager のステータスを部分的に更新します
表24.17 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表24.18 HTTP レスポンス
HTTP コードレスポンスのボディー

200 - OK

OpenShiftControllerManager スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された OpenShiftControllerManager のステータスを置き換えます
表24.19 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表24.20 本文パラメーター
パラメーター説明

body

OpenShiftControllerManager スキーマ

 
表24.21 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

OpenShiftControllerManager スキーマ

201 - Created

OpenShiftControllerManager スキーマ

401 - Unauthorized

空白

第25章 OperatorPKI [network.operator.openshift.io/v1]

説明

OperatorPKI は、単純な認証局です。これは外部での使用を目的としたものではなく、ネットワーク Operator の内部で使用されます。CNO は、CA とその CA によって署名された証明書を作成します。証明書では、ClientAuth と ServerAuth の両方の拡張使用が有効になっています。

More specifically, given an OperatorPKI with <name>, the CNO will manage:
  • 次の 2 つのデータキーを持つ <name>-ca という名前の Secret:
  • tls.key - 秘密鍵
  • tls.crt - CA 証明書
  • 次の 1 つのデータキーを持つ <name>-ca という名前の ConfigMap:
  • cabundle.crt - CA 証明書
  • 次の 2 つのデータキーを持つ <name>-cert という名前の Secret:
  • tls.key - 秘密鍵
  • tls.crt - CA によって署名された証明書

CA 証明書の有効期間は 10 年で、9 年後にローテーションされます。ターゲット証明書の有効期間は 6 カ月で、3 カ月後にローテーションされます。

CA 証明書の CommonName は、"<namespace>_<name>-ca@<timestamp>" になります。<timestamp> は最後のローテーション時間です。

object
必須
  • spec

25.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

OperatorPKISpec は、PKI 設定です。

status

object

OperatorPKIStatus は実装されていません。

25.1.1. .spec

説明
OperatorPKISpec は、PKI 設定です。
object
必須
  • targetCert
プロパティー説明

targetCert

object

targetCert は、CA によって署名された証明書を設定します。ClientAuth と ServerAuth の両方が有効になります

25.1.2. .spec.targetCert

説明
targetCert は、CA によって署名された証明書を設定します。ClientAuth と ServerAuth の両方が有効になります
object
必須
  • commonName
プロパティー説明

commonName

string

commonName は、証明書の CN の値です

25.1.3. .status

説明
OperatorPKIStatus は実装されていません。
object

25.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/network.operator.openshift.io/v1/operatorpkis

    • GET: 種類 OperatorPKI のオブジェクトをリスト表示します
  • /apis/network.operator.openshift.io/v1/namespaces/{namespace}/operatorpkis

    • DELETE:OperatorPKI のコレクションを削除します
    • GET: 種類 OperatorPKI のオブジェクトをリスト表示します
    • POST:OperatorPKI を作成します
  • /apis/network.operator.openshift.io/v1/namespaces/{namespace}/operatorpkis/{name}

    • 削除:OperatorPKI を削除します
    • GET: 指定された OperatorPKI を読み取ります
    • PATCH: 指定された OperatorPKI を部分的に更新します
    • PUT: 指定された OperatorPKI を置き換えます

25.2.1. /apis/network.operator.openshift.io/v1/operatorpkis

HTTP メソッド
GET
説明
種類のオブジェクトをリスト表示する OperatorPKI
表25.1 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

OperatorPKIList スキーマ

401 - Unauthorized

空白

25.2.2. /apis/network.operator.openshift.io/v1/namespaces/{namespace}/operatorpkis

HTTP メソッド
DELETE
説明
OperatorPKI のコレクションを削除します
表25.2 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類のオブジェクトをリスト表示する OperatorPKI
表25.3 HTTP 応答
HTTP コード応答本文

200 - OK

OperatorPKIList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
OperatorPKI を作成する
表25.4 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表25.5 本文パラメーター
パラメータータイプ説明

body

OperatorPKI スキーマ

 
表25.6 HTTP 応答
HTTP コード応答本文

200 - OK

OperatorPKI スキーマ

201 - Created

OperatorPKI スキーマ

202 - Accepted

OperatorPKI スキーマ

401 - Unauthorized

空白

25.2.3. /apis/network.operator.openshift.io/v1/namespaces/{namespace}/operatorpkis/{name}

表25.7 グローバルパスパラメーター
パラメータータイプ説明

name

string

OperatorPKI の名前

HTTP メソッド
DELETE
説明
OperatorPKI を削除します
表25.8 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表25.9 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定された OperatorPKI を読み取ります
表25.10 HTTP 応答
HTTP コード応答本文

200 - OK

OperatorPKI スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された OperatorPKI を部分的に更新します
表25.11 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表25.12 HTTP 応答
HTTP コード応答本文

200 - OK

OperatorPKI スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された OperatorPKI を置き換えます
表25.13 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表25.14 本文パラメーター
パラメータータイプ説明

body

OperatorPKI スキーマ

 
表25.15 HTTP 応答
HTTP コード応答本文

200 - OK

OperatorPKI スキーマ

201 - Created

OperatorPKI スキーマ

401 - Unauthorized

空白

第26章 ServiceCA [operator.openshift.io/v1]

説明
ServiceCA は、サービス証明書コントローラーを管理するように Operator を設定するための情報を提供します。互換性レベル 1: メジャーリリース内で最低 12 か月または 3 つのマイナーリリース (いずれか長い方) の間安定しています。
object
必須
  • spec

26.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 クラスターから監視される値を保持します。それらはオーバーライドされない場合があります。

26.1.1. .spec

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

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".

unsupportedConfigOverrides

``

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

26.1.2. .status

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

conditions

array

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

conditions[]

object

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

generations

array

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

generations[]

object

GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。

observedGeneration

integer

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

readyReplicas

integer

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

version

string

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

26.1.3. .status.conditions

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

26.1.4. .status.conditions[]

説明
OperatorCondition は、標準の状態フィールドです。
object
プロパティータイプ説明

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

26.1.5. .status.generations

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

26.1.6. .status.generations[]

説明
GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。
object
プロパティー説明

group

string

グループはあなたが追跡しているもののグループです

ハッシュ

string

ハッシュは、シークレットや設定マップのようにコンテンツに依存する、生成されないリソース用に設定されたオプションのフィールドです。

lastGeneration

integer

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

name

string

name は、追跡しているものの名前です

namespace

string

名前空間は、追跡しているものがどこにあるかです

resource

string

リソースは、追跡しているもののリソースタイプです

26.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/operator.openshift.io/v1/servicecas

    • DELETE:ServiceCA のコレクションを削除します
    • GET: 種類 ServiceCA のオブジェクトをリスト表示します
    • POST:ServiceCA を作成します
  • /apis/operator.openshift.io/v1/servicecas/{name}

    • 削除:ServiceCA を削除します
    • GET: 指定された ServiceCA を読み取ります
    • PATCH: 指定された ServiceCA を部分的に更新します
    • PUT: 指定された ServiceCA を置き換えます
  • /apis/operator.openshift.io/v1/servicecas/{name}/status

    • GET: 指定された ServiceCA のステータスを読み取ります
    • PATCH: 指定された ServiceCA のステータスを部分的に更新します
    • PUT: 指定された ServiceCA のステータスを置き換えます

26.2.1. /apis/operator.openshift.io/v1/servicecas

HTTP メソッド
DELETE
説明
ServiceCA のコレクションを削除します
表26.1 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類 ServiceCA のオブジェクトをリスト表示します
表26.2 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

ServiceCAList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
ServiceCA を作成する
表26.3 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表26.4 本文パラメーター
パラメーター説明

body

ServiceCA スキーマ

 
表26.5 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

ServiceCA スキーマ

201 - Created

ServiceCA スキーマ

202 - Accepted

ServiceCA スキーマ

401 - Unauthorized

空白

26.2.2. /apis/operator.openshift.io/v1/servicecas/{name}

表26.6 グローバルパスパラメーター
パラメーター説明

name

string

ServiceCA の名前

HTTP メソッド
DELETE
説明
ServiceCA を削除します
表26.7 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表26.8 HTTP レスポンス
HTTP コードレスポンスのボディー

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定された ServiceCA を読み取ります
表26.9 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

ServiceCA スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された ServiceCA を部分的に更新します
表26.10 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表26.11 HTTP レスポンス
HTTP コードレスポンスのボディー

200 - OK

ServiceCA スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された ServiceCA を置き換えます
表26.12 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表26.13 本文パラメーター
パラメーター説明

body

ServiceCA スキーマ

 
表26.14 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

ServiceCA スキーマ

201 - Created

ServiceCA スキーマ

401 - Unauthorized

空白

26.2.3. /apis/operator.openshift.io/v1/servicecas/{name}/status

表26.15 グローバルパスパラメーター
パラメーター説明

name

string

ServiceCA の名前

HTTP メソッド
GET
説明
指定された ServiceCA のステータスを読み取ります
表26.16 HTTP 応答
HTTP コード応答本文

200 - OK

ServiceCA スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された ServiceCA のステータスを部分的に更新します
表26.17 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表26.18 HTTP 応答
HTTP コード応答本文

200 - OK

ServiceCA スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された ServiceCA のステータスを置き換えます
表26.19 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表26.20 本文パラメーター
パラメータータイプ説明

body

ServiceCA スキーマ

 
表26.21 HTTP 応答
HTTP コード応答本文

200 - OK

ServiceCA スキーマ

201 - Created

ServiceCA スキーマ

401 - Unauthorized

空白

第27章 Storage [operator.openshift.io/v1]

説明
ストレージは、クラスターストレージ Operator を管理するように Operator を設定する手段を提供します。cluster は正規名です。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
タイプ
object
必須
  • spec

27.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 クラスターから監視される値を保持します。それらはオーバーライドされない場合があります。

27.1.1. .spec

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

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".

unsupportedConfigOverrides

``

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

vsphereStorageDriver

string

VSphereStorageDriver は、VSphere クラスターで使用するストレージドライバーを示します。このフィールドを CSIWithMigrationDriver に設定すると、変更できなくなります。これが空の場合、プラットフォームによって適切なデフォルトが選択されます。デフォルトは、今後予告なく変更される可能性があります。現在のデフォルトは CSIWithMigrationDriver であり、変更することはできません。非推奨: このフィールドは今後のリリースで削除される予定です。

27.1.2. .status

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

conditions

array

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

conditions[]

object

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

generations

array

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

generations[]

object

GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。

observedGeneration

integer

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

readyReplicas

integer

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

version

string

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

27.1.3. .status.conditions

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

27.1.4. .status.conditions[]

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

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

27.1.5. .status.generations

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

27.1.6. .status.generations[]

説明
GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。
object
プロパティータイプ説明

group

string

グループはあなたが追跡しているもののグループです

ハッシュ

string

ハッシュは、シークレットや設定マップのようにコンテンツに依存する、生成されないリソース用に設定されたオプションのフィールドです。

lastGeneration

integer

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

name

string

name は、追跡しているものの名前です

namespace

string

名前空間は、追跡しているものがどこにあるかです

resource

string

リソースは、追跡しているもののリソースタイプです

27.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/operator.openshift.io/v1/storages

    • DELETE: ストレージのコレクションを削除します
    • GET: 種類のストレージのオブジェクトをリスト表示します
    • POST: ストレージを作成します
  • /apis/operator.openshift.io/v1/storages/{name}

    • 削除: ストレージを削除します
    • GET: 指定されたストレージを読み取ります
    • PATCH: 指定されたストレージを部分的に更新します
    • PUT: 指定されたストレージを交換します
  • /apis/operator.openshift.io/v1/storages/{name}/status

    • GET: 指定されたストレージのステータスを読み取ります
    • PATCH: 指定されたストレージのステータスを部分的に更新します
    • PUT: 指定されたストレージのステータスを置き換えます

27.2.1. /apis/operator.openshift.io/v1/storages

HTTP メソッド
DELETE
説明
ストレージのコレクションを削除します
表27.1 HTTP 応答
HTTP コード応答本文

200 - OK

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類が Storage のオブジェクトをリスト表示します。
表27.2 HTTP 応答
HTTP コード応答本文

200 - OK

StorageList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
ストレージを作成する
表27.3 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表27.4 本文パラメーター
パラメータータイプ説明

body

Storage スキーマ

 
表27.5 HTTP 応答
HTTP コード応答本文

200 - OK

Storage スキーマ

201 - Created

Storage スキーマ

202 - Accepted

Storage スキーマ

401 - Unauthorized

空白

27.2.2. /apis/operator.openshift.io/v1/storages/{name}

表27.6 グローバルパスパラメーター
パラメータータイプ説明

name

string

ストレージの名前。

HTTP メソッド
DELETE
説明
ストレージを削除する
表27.7 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表27.8 HTTP レスポンス
HTTP コードレスポンスのボディー

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定されたストレージを読み取ります
表27.9 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

Storage スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定されたストレージを部分的に更新します
表27.10 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表27.11 HTTP レスポンス
HTTP コードレスポンスのボディー

200 - OK

Storage スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定されたストレージを交換してください
表27.12 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表27.13 本文パラメーター
パラメーター説明

body

Storage スキーマ

 
表27.14 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

Storage スキーマ

201 - Created

Storage スキーマ

401 - Unauthorized

空白

27.2.3. /apis/operator.openshift.io/v1/storages/{name}/status

表27.15 グローバルパスパラメーター
パラメーター説明

name

string

ストレージの名前。

HTTP メソッド
GET
説明
指定されたストレージのステータスを読み取ります
表27.16 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

Storage スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定されたストレージのステータスを部分的に更新します
表27.17 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表27.18 HTTP レスポンス
HTTP コードレスポンスのボディー

200 - OK

Storage スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定されたストレージのステータスを置き換えます
表27.19 クエリーパラメーター
パラメーター説明

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表27.20 本文パラメーター
パラメーター説明

body

Storage スキーマ

 
表27.21 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

Storage スキーマ

201 - Created

Storage スキーマ

401 - Unauthorized

空白

Legal Notice

Copyright © 2024 Red Hat, Inc.

OpenShift documentation is licensed under the Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0).

Modified versions must remove all Red Hat trademarks.

Portions adapted from https://github.com/kubernetes-incubator/service-catalog/ with modifications by Red Hat.

Red Hat, Red Hat Enterprise Linux, the Red Hat logo, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.

Linux® is the registered trademark of Linus Torvalds in the United States and other countries.

Java® is a registered trademark of Oracle and/or its affiliates.

XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.

MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.

Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.

The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation’s permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.

All other trademarks are the property of their respective owners.

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

© 2024 Red Hat, Inc.