第2章 APIService [apiregistration.k8s.io/v1]
- 説明
- APIService は、特定の GroupVersion のサーバーを表します。名前は version.group である必要があります。
- タイプ
-
object
2.1. 仕様
プロパティー | タイプ | 説明 |
---|---|---|
|
| APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。 |
|
| kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できることがあります。これを更新することはできません。CamelCase を使用します。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。 |
| 標準オブジェクトのメタデータ。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。 | |
|
| APIServiceSpec には、サーバーを見つけて通信するための情報が含まれています。証明書の検証を無効にすることはできますが、https のみがサポートされています。 |
|
| APIServiceStatus には、API サーバーに関する派生情報が含まれています |
2.1.1. .spec
- 説明
- APIServiceSpec には、サーバーを見つけて通信するための情報が含まれています。証明書の検証を無効にすることはできますが、https のみがサポートされています。
- タイプ
-
object
- 必須
-
groupPriorityMinimum
-
versionPriority
-
プロパティー | タイプ | 説明 |
---|---|---|
|
| CABundle は、API サーバーのサービング証明書を検証するために使用される PEM エンコードされた CA バンドルです。指定しない場合、apiserver のシステム信頼ルートが使用されます。 |
|
| Group は、このサーバーがホストする API グループ名です。 |
|
| GroupPriorityMinimum は、少なくともこのグループに必要な優先度です。優先度が高いということは、優先度の低いグループよりもグループがクライアントに優先されることを意味します。このグループの他のバージョンでは、グループ全体の優先度が高くなるように、さらに高い GroupPriorityMinimum 値が指定される可能性があることに注意してください。プライマリーソートは GroupPriorityMinimum に基づいており、最大数から最小値 (10 の前に 20) の順に並べられます。二次ソートは、オブジェクトの名前のアルファベット順の比較に基づいています。(v1.foo より前の v1.bar) 次のようなものを推奨します:18000 の* .k8s.io (拡張機能を除く) および PaaS(OpenShift、Deis) は 2000 年代に推奨されます |
|
| InsecureSkipTLSVerify は、このサーバーと通信するときに TLS 証明書の検証を無効にします。これは強く推奨しません。代わりに CABundle を使用する必要があります。 |
|
| ServiceReference は、Service.legacy.k8s.io への参照を保持します |
|
| バージョンは、このサーバーがホストする API バージョンです。たとえば、v1 |
|
| VersionPriority は、グループ内のこの API バージョンの順序を制御します。ゼロより大きくなければなりません。プライマリーソートは VersionPriority に基づいており、最高から最低の順に並べられています (10 の前に 20)。グループ内にあるため、数は少なく、おそらく 10 代になる可能性があります。バージョンの優先度が等しい場合は、バージョン文字列を使用してグループ内の順序を計算します。バージョン文字列が kube-like の場合、辞書式順序で並べられた kube-like ではないバージョン文字列の上に並べ替えられます。Kube のようなバージョンは v で始まり、その後に数字 (メジャーバージョン) が続き、オプションで文字列 alpha または beta と別の数字 (マイナーバージョン) が続きます。これらは、最初に GA > ベータ > アルファ (GA はベータやアルファなどの接尾辞のないバージョン) でソートされ、次にメジャーバージョン、次にマイナーバージョンでソートされます。バージョンのソート済みリストの例: v10、v2、v1、v11beta2、v10beta3、v3beta1、v12alpha1、v11alpha2、foo1、foo10。 |
2.1.2. .spec.service
- 説明
- ServiceReference は、Service.legacy.k8s.io への参照を保持します
- タイプ
-
object
プロパティー | タイプ | 説明 |
---|---|---|
|
| 名前はサービスの名前です |
|
| 名前空間はサービスの名前空間です |
|
|
指定されている場合、Webhook をホストしているサービスのポート。下位互換性のために、デフォルトは 443 です。 |
2.1.3. .status
- 説明
- APIServiceStatus には、API サーバーに関する派生情報が含まれています
- タイプ
-
object
プロパティー | タイプ | 説明 |
---|---|---|
|
| apiService の現在のサービス状態。 |
|
| APIServiceCondition は、特定の時点での APIService の状態を記述します |
2.1.4. .status.conditions
- 説明
- apiService の現在のサービス状態。
- タイプ
-
array
2.1.5. .status.conditions[]
- 説明
- APIServiceCondition は、特定の時点での APIService の状態を記述します
- タイプ
-
object
- 必須
-
type
-
status
-
プロパティー | タイプ | 説明 |
---|---|---|
| 最後にある状態から別の状態に遷移した時間。 | |
|
| 最後にある状態から別の状態に遷移した時間。 |
|
| 条件の最後の遷移の一意の 1 単語の CamelCase 理由。 |
|
| ステータスは、状態のステータスです。True、False、Unknown の場合があります。 |
|
| タイプは条件のタイプです。 |