ワークロード API
ワークロード API のリファレンスガイド
概要
第1章 ワークロード API リンクのコピーリンクがクリップボードにコピーされました!
1.1. BuildConfig [build.openshift.io/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
ビルド設定は、新しいコンテナーイメージのビルドプロセスを定義します。Dockerfile を使用したコンテナーイメージのビルド、特別に用意したベースイメージを使用し、実行可能なソースコードを受け付ける Source-to-Image ビルド、そして任意のコンテナーイメージをベースとして実行し、ビルドパラメーターを受け付けるカスタムビルドの 3 種類が可能となります。ビルドはクラスター上で実行され、完了すると、"output" セクションで指定されたコンテナーイメージレジストリーにプッシュされます。ビルドは、Webhook を介して、ベースイメージが変更されたとき、またはユーザーが手動で新しいビルドの作成を要求したときにトリガーできます。
ビルド設定によって作成された各ビルドには番号が付けられ、その親設定を参照します。複数のビルドを一度にトリガーできます。"output" が設定されていないビルドを使用して、コードをテストしたり、検証ビルドを実行したりできます。
互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
- 型
-
object
1.2. Build [build.openshift.io/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
ビルドは、新しいデプロイ可能なイメージを生成するために必要な入力、実行のステータス、およびビルドを実行した Pod への参照をカプセル化します。
互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
- 型
-
object
1.3. BuildLog [build.openshift.io/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
BuildLog は、ビルドログリダイレクターに関連付けられた (未使用の) リソースです。
互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
- 型
-
object
1.4. BuildRequest [build.openshift.io/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
BuildRequest は、ビルドジェネレーターにパラメーターを渡すのに使用されるリソースです。
互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
- 型
-
object
1.5. CronJob [batch/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- CronJob は、単一の cron ジョブの設定を表します。
- 型
-
object
1.6. DaemonSet [apps/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DaemonSet は、デーモンセットの設定を表します。
- 型
-
object
1.7. Deployment [apps/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- デプロイメントにより、Pod と ReplicaSets の宣言型更新が可能になります。
- 型
-
object
1.8. DeploymentConfig [apps.openshift.io/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
Deployment Configs は、Pod のテンプレートを定義し、新しいイメージのデプロイまたは設定の変更を管理します。単一のデプロイメント設定は通常、単一のマイクロサービスに類似しています。完全な再起動、カスタマイズ可能なローリング更新、完全にカスタム化された動作、デプロイメント前およびデプロイメント後のフックなど、さまざまなデプロイメントパターンをサポートできます。個々のデプロイメントは、レプリケーションコントローラーとして表されます。
デプロイメントは、その設定が変更されたとき、またはイメージストリーム内のタグが変更されたときに "トリガー" されます。トリガーを無効にして、デプロイメントを手動で制御できるようにすることができます。"strategy" は、デプロイメントの実行方法を決定し、いつでも変更できます。
latestVersion
フィールドは、何らかの方法で新しいデプロイメントがトリガーされたときに更新されます。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。非推奨: Pod の宣言的更新には、デプロイメントまたはその他の手段を使用してください。
- 型
-
object
1.9. DeploymentConfigRollback [apps.openshift.io/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
DeploymentConfigRollback は、ロールバック生成への入力を提供します。
互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
- 型
-
object
1.10. DeploymentLog [apps.openshift.io/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
DeploymentLog は、デプロイメントのログを表します
互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
- 型
-
object
1.11. DeploymentRequest [apps.openshift.io/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
DeploymentRequest は、新しいデプロイメントのデプロイメント設定へのリクエストです。
互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
- 型
-
object
1.12. Job [batch/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Job は、単一の Job の設定を表します。
- 型
-
object
1.13. Pod [v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod は、ホスト上で実行できるコンテナーのコレクションです。このリソースはクライアントによって作成され、ホストにスケジュールされます。
- 型
-
object
1.14. ReplicationController [v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ReplicationController は、レプリケーションコントローラーの設定を表します。
- 型
-
object
1.15. ReplicaSet [apps/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ReplicaSet は、指定された数の Pod レプリカが常に実行されていることを確認します。
- 型
-
object
1.16. StatefulSet [apps/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
StatefulSet は、一貫した ID を持つ Pod のセットを表します。ID は次のように定義されます。- ネットワーク: 単一の安定した DNS およびホスト名。- ストレージ: 要求された数の VolumeClaim。
StatefulSet は、特定のネットワーク ID が常に同じストレージ ID にマップされることを保証します。
- 型
-
object
第2章 BuildConfig [build.openshift.io/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
ビルド設定は、新しいコンテナーイメージのビルドプロセスを定義します。Dockerfile を使用したコンテナーイメージのビルド、特別に用意したベースイメージを使用し、実行可能なソースコードを受け付ける Source-to-Image ビルド、そして任意のコンテナーイメージをベースとして実行し、ビルドパラメーターを受け付けるカスタムビルドの 3 種類が可能となります。ビルドはクラスター上で実行され、完了すると、"output" セクションで指定されたコンテナーイメージレジストリーにプッシュされます。ビルドは、Webhook を介して、ベースイメージが変更されたとき、またはユーザーが手動で新しいビルドの作成を要求したときにトリガーできます。
ビルド設定によって作成された各ビルドには番号が付けられ、その親設定を参照します。複数のビルドを一度にトリガーできます。"output" が設定されていないビルドを使用して、コードをテストしたり、検証ビルドを実行したりできます。
互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
- 型
-
object
- 必須
-
spec
-
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 を参照してください。 |
| metadata は標準オブジェクトのメタデータです。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。 | |
|
| BuildConfigSpec は、ビルドがいつどのように作成されるかを記述します |
|
| BuildConfigStatus には、ビルド設定オブジェクトの現在の状態が含まれます。 |
2.1.1. .spec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildConfigSpec は、ビルドがいつどのように作成されるかを記述します
- 型
-
object
- 必須
-
strategy
-
プロパティー | 型 | 説明 |
---|---|---|
|
| completeDeadlineSeconds は、ビルド Pod がシステムでスケジュールされた時間から数えて、システムがアクティブにビルドを終了しようとする前に、ノードでビルドがアクティブになる可能性がある秒単位の任意の期間です。値は正の整数でなければなりません |
|
| failedBuildsHistoryLimit は、保持するために失敗した古いビルドの数です。BuildConfig が作成されると、この値が設定されていない限り、最近失敗した 5 つのビルドが保持されます。BuildConfig の作成後に削除すると、失敗したビルドはすべて保持されます。 |
|
| mountTrustedCA バインドは、クラスターのプロキシー設定で定義されているように、クラスターの信頼できる認証局をビルドにマウントします。これにより、プライベートアーティファクトリーポジトリーや HTTPS プロキシーなど、カスタム PKI 認証局により署名されたビルド信頼コンポーネント内のプロセスが可能になります。
このフィールドを true に設定すると、ビルド内の |
|
| nodeSelector は、ビルド Pod がノードに収まるようにするために true である必要があるセレクターです。nil の場合は、クラスターのデフォルトのビルドの nodeselector 値をオーバーライドできます。空のマップまたは任意の値のマップに設定されている場合、デフォルトのビルドの nodeselector 値は無視されます。 |
|
| BuildOutput は、ビルドストラテジーへの入力であり、ストラテジーが生成する必要のあるコンテナーイメージを記述します。 |
|
| BuildPostCommitSpec は、ビルドポストコミットフック仕様を保持します。フックは、イメージの最後のレイヤーがコミットされた直後、イメージがレジストリーにプッシュされる前に、ビルド出力イメージを実行している一時コンテナーでコマンドを実行します。コマンドは、現在の作業ディレクトリー ($ PWD) をイメージの WORKDIR に設定して実行されます。 フックの実行が失敗すると、ビルドは失敗としてマークされます。スクリプトまたはコマンドがゼロ以外の終了コードを返す場合、または一時コンテナーの開始に関連するその他のエラーがある場合は失敗します。
フックを設定するには、5 つの異なる方法があります。例として、以下のすべての形式は同等であり、 1.シェルスクリプト: "postCommit": { "script": "rake test --verbose", } 上記は、以下と同等の便利な形式です。 "postCommit": { "command": ["/bin/sh", "-ic"], "args": ["rake test --verbose"] } 2.イメージエントリーポイントとしてのコマンド: "postCommit": { "commit": ["rake", "test", "--verbose"] } Docker (https://docs.docker.com/engine/reference/builder/#entrypoint) に記載されているように、コマンドは exec 形式のイメージエントリーポイントをオーバーライドします。 3.デフォルトのエントリーポイントに引数を渡します。 "postCommit": { "args": ["rake", "test", "--verbose"] } この形式は、イメージエントリーポイントが引数を処理できる場合にのみ役立ちます。 4.引数を指定したシェルスクリプト: "postCommit": { "script": "rake test $1", "args": ["--verbose"] } このフォームは、引数を渡す必要があるが、シェルスクリプトで正しく引用するのが困難な場合に有益です。上記のスクリプトでは、$0 は "/bin/sh" で、$1、$2 などは Args の位置引数となります。 5.引数のあるコマンド: "postCommit": { "command": ["rake", "test"], "args": ["--verbose"] } この形式は、Command スライスに引数を追加するのと同じです。 スクリプトとコマンドの両方を同時に提供することは無効です。どのフィールドも指定されていないと、フックは実行されません。 |
| resources は、ビルドを実行するためのリソース要件を計算します。 | |
|
| SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です |
|
| RunPolicy は、このビルド設定から作成された新しいビルドの実行がどのようにスケジュールされるかを記述します。これは任意です。指定されていない場合は、デフォルトで "Serial" になります。 |
|
| serviceAccount は、このビルドで作成された Pod を実行するのに使用する ServiceAccount の名前です。Pod は、ServiceAccount によって参照されるシークレットを使用できます。 |
|
| BuildSource は、ビルドに使用される SCM です。 |
|
| BuildStrategy には、ビルドを実行する方法の詳細が含まれています。 |
|
| successfulBuildsHistoryLimit は、保持する古い成功したビルドの数です。BuildConfig が作成されると、この値が設定されていない限り、最近成功した 5 つのビルドが保持されます。BuildConfig の作成後に削除すると、成功したすべてのビルドが保持されます。 |
|
| トリガーは、BuildConfig から新しいビルドを起動する方法を決定します。トリガーが定義されていない場合、新しいビルドは、明示的なクライアントビルドの作成の結果としてのみ発生します。 |
|
| BuildTriggerPolicy は、新しいビルドをもたらす単一のトリガーのポリシーを記述します。 |
2.1.2. .spec.output リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildOutput は、ビルドストラテジーへの入力であり、ストラテジーが生成する必要のあるコンテナーイメージを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| imageLabels は、結果として生成されるイメージに適用されるラベルのリストを定義します。同じ名前のラベルが複数ある場合は、リストの最後のラベルが使用されます。 |
|
| ImageLabel は、結果のイメージに適用されるラベルを表します。 |
| PushSecret は、認証が有効な Docker レジストリー (または Docker Hub) への Docker プッシュを実行するための認証を設定するために使用される Secret の名前です。 | |
| このビルドの出力をプッシュする任意の場所を定義します。種類は 'ImageStreamTag' または 'DockerImage' のいずれかである必要があります。この値は、プッシュ先のコンテナーイメージリポジトリーを検索するのに使用されます。ImageStreamTag の場合は、Namespace が指定されていない限り、ImageStreamTag はビルドの namespace で検索されます。 |
2.1.3. .spec.output.imageLabels リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- imageLabels は、結果として生成されるイメージに適用されるラベルのリストを定義します。同じ名前のラベルが複数ある場合は、リストの最後のラベルが使用されます。
- 型
-
array
2.1.4. .spec.output.imageLabels[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ImageLabel は、結果のイメージに適用されるラベルを表します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、ラベルの名前を定義します。ゼロ以外の長さを持つ必要があります。 |
|
| 値は、ラベルのリテラル値を定義します。 |
2.1.5. .spec.postCommit リンクのコピーリンクがクリップボードにコピーされました!
- 説明
BuildPostCommitSpec は、ビルドポストコミットフック仕様を保持します。フックは、イメージの最後のレイヤーがコミットされた直後、イメージがレジストリーにプッシュされる前に、ビルド出力イメージを実行している一時コンテナーでコマンドを実行します。コマンドは、現在の作業ディレクトリー ($ PWD) をイメージの WORKDIR に設定して実行されます。
フックの実行が失敗すると、ビルドは失敗としてマークされます。スクリプトまたはコマンドがゼロ以外の終了コードを返す場合、または一時コンテナーの開始に関連するその他のエラーがある場合は失敗します。
フックを設定するには、5 つの異なる方法があります。例として、以下のすべての形式は同等であり、
rake test --verbose
を実行します。シェルスクリプト:
"postCommit": { "script": "rake test --verbose", }
"postCommit": { "script": "rake test --verbose", }
Copy to Clipboard Copied! Toggle word wrap Toggle overflow The above is a convenient form which is equivalent to:
The above is a convenient form which is equivalent to:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow "postCommit": { "command": ["/bin/sh", "-ic"], "args": ["rake test --verbose"] }
"postCommit": { "command": ["/bin/sh", "-ic"], "args": ["rake test --verbose"] }
Copy to Clipboard Copied! Toggle word wrap Toggle overflow イメージエントリーポイントとしてのコマンド:
"postCommit": { "commit": ["rake", "test", "--verbose"] }
"postCommit": { "commit": ["rake", "test", "--verbose"] }
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Command overrides the image entrypoint in the exec form, as documented in Docker: https://docs.docker.com/engine/reference/builder/#entrypoint.
Command overrides the image entrypoint in the exec form, as documented in Docker: https://docs.docker.com/engine/reference/builder/#entrypoint.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow デフォルトのエントリーポイントに引数を渡します。
"postCommit": { "args": ["rake", "test", "--verbose"] }
"postCommit": { "args": ["rake", "test", "--verbose"] }
Copy to Clipboard Copied! Toggle word wrap Toggle overflow This form is only useful if the image entrypoint can handle arguments.
This form is only useful if the image entrypoint can handle arguments.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 引数を指定したシェルスクリプト:
"postCommit": { "script": "rake test $1", "args": ["--verbose"] }
"postCommit": { "script": "rake test $1", "args": ["--verbose"] }
Copy to Clipboard Copied! Toggle word wrap Toggle overflow This form is useful if you need to pass arguments that would otherwise be hard to quote properly in the shell script. In the script, $0 will be "/bin/sh" and $1, $2, etc, are the positional arguments from Args.
This form is useful if you need to pass arguments that would otherwise be hard to quote properly in the shell script. In the script, $0 will be "/bin/sh" and $1, $2, etc, are the positional arguments from Args.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 引数のあるコマンド:
"postCommit": { "command": ["rake", "test"], "args": ["--verbose"] }
"postCommit": { "command": ["rake", "test"], "args": ["--verbose"] }
Copy to Clipboard Copied! Toggle word wrap Toggle overflow This form is equivalent to appending the arguments to the Command slice.
This form is equivalent to appending the arguments to the Command slice.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
スクリプトとコマンドの両方を同時に提供することは無効です。どのフィールドも指定されていないと、フックは実行されません。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| args は、Command、Script、またはコンテナーイメージのデフォルトのエントリーポイントのいずれかに提供される引数のリストです。引数は、実行するコマンドの直後に配置されます。 |
|
|
command は実行するコマンドです。スクリプトでは指定できない場合があります。これは、イメージに |
|
|
script は、 |
2.1.6. .spec.revision リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| GitSourceRevision は、ビルド用の git ソースからのコミット情報です。 |
|
| ビルドソースのタイプ。'Source'、'Dockerfile'、'Binary'、または 'Images' のいずれかになります。 |
2.1.7. .spec.revision.git リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GitSourceRevision は、ビルド用の git ソースからのコミット情報です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
| commit は、特定のコミットを識別するコミットハッシュです。 |
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
| メッセージは特定のコミットの説明です |
2.1.8. .spec.revision.git.author リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ソース管理ユーザーの電子メール |
|
| ソース管理ユーザーの名前 |
2.1.9. .spec.revision.git.committer リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ソース管理ユーザーの電子メール |
|
| ソース管理ユーザーの名前 |
2.1.10. .spec.source リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildSource は、ビルドに使用される SCM です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| BinaryBuildSource は、Docker および Source ビルドストラテジーに使用されるバイナリーファイルを記述します。ファイルは抽出され、ビルドソースとして使用されます。 |
|
| configMaps は、ビルドに使用される configMap とその宛先のリストを表します。 |
|
| ConfigMapBuildSource は、ビルド時にのみ使用される configmap とその宛先ディレクトリーを記述します。ここで参照されている configmap の内容は、マウントする代わりに宛先ディレクトリーにコピーされます。 |
|
| contextDir は、アプリケーションのソースコードが存在するサブディレクトリーを指定します。これにより、リポジトリーのルート以外のディレクトリーにビルド可能なソースを含めることができます。 |
|
| dockerfile は、ビルドする必要のある Dockerfile の生のコンテンツです。このオプションを指定すると、戦略ベースイメージに基づいて FROM が変更され、戦略環境からの追加の ENV スタンザが FROM から、残りの Dockerfile スタンザの間に追加されます。Dockerfile ソースタイプは、git などの他のオプションとともに使用できます。その場合、Git リポジトリーでは、コンテキストディレクトリーで固有の Dockerfile が置き換えられます。 |
|
| GitBuildSource は、Git SCM のパラメーターを定義します |
|
| images は、ビルドのソースを提供するのに使用される一連のイメージを記述します |
|
| ImageSource は、イメージから抽出されるか、マルチステージビルド中に使用されるビルドソースを記述するのに使用されます。タイプ ImageStreamTag、ImageStreamImage、または DockerImage の参照を使用できます。プルシークレットを指定して、外部レジストリーからイメージをプルするか、内部レジストリーからプルする場合はデフォルトのサービスアカウントシークレットを上書きできます。イメージソースを使用して、イメージからコンテンツを抽出し、リポジトリーソースと一緒にビルドコンテキストに配置するか、マルチステージコンテナーイメージのビルド中に直接使用して、リポジトリーソースのコンテンツを上書きせずにコンテンツをコピーできるようにします。('paths' および 'as' フィールドを参照してください)。 |
|
| secrets は、ビルドにのみ使用されるシークレットとその宛先のリストを表します。 |
|
| SecretBuildSource は、ビルド時にのみ使用されるシークレットとその宛先ディレクトリーを記述します。ここで参照されているシークレットの内容は、マウントする代わりに宛先ディレクトリーにコピーされます。 |
| sourceSecret は、プライベートリポジトリーのクローンを作成するための認証を設定するのに使用される Secret の名前です。シークレットには、リモートリポジトリーの有効な認証情報が含まれています。ここで、データのキーは使用される認証方法を表し、値は base64 でエンコードされた認証情報です。サポートされている認証方法は ssh-privatekey です。 | |
|
| 受け入れるビルド入力のタイプ |
2.1.11. .spec.source.binary リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BinaryBuildSource は、Docker および Source ビルドストラテジーに使用されるバイナリーファイルを記述します。ファイルは抽出され、ビルドソースとして使用されます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
|
asFile は、提供されたバイナリー入力がビルド入力内の単一ファイルと見なされる必要があることを示します。たとえば、"webapp.war" を指定すると、提供されたバイナリーがビルダーの |
2.1.12. .spec.source.configMaps リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- configMaps は、ビルドに使用される configMap とその宛先のリストを表します。
- 型
-
array
2.1.13. .spec.source.configMaps[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ConfigMapBuildSource は、ビルド時にのみ使用される configmap とその宛先ディレクトリーを記述します。ここで参照されている configmap の内容は、マウントする代わりに宛先ディレクトリーにコピーされます。
- 型
-
object
- 必須
-
configMap
-
プロパティー | 型 | 説明 |
---|---|---|
| configMap は、ビルドで使用する既存の configmap への参照です。 | |
|
| destinationDir は、ビルド時に configmap のファイルを使用できるディレクトリーです。ソースビルド戦略の場合、これらはアセンブルスクリプトが実行されるコンテナーに挿入されます。コンテナーイメージのビルド戦略では、これらは Dockerfile が配置されているビルドディレクトリーにコピーされるため、ユーザーはコンテナーイメージのビルド中にそれらを追加またはコピーできます。 |
2.1.14. .spec.source.git リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GitBuildSource は、Git SCM のパラメーターを定義します
- 型
-
object
- 必須
-
uri
-
プロパティー | 型 | 説明 |
---|---|---|
|
| httpProxy は、http 経由で git リポジトリーに到達するのに使用されるプロキシーです。 |
|
| httpsProxy は、https 経由で git リポジトリーに到達するのに使用されるプロキシーです。 |
|
| noProxy は、プロキシーを使用してはならないドメインのリストです。 |
|
| ref は、ビルドするブランチ/タグ/参照です。 |
|
| uri は、ビルドされるソースを指します。ソースの構造は、実行するビルドのタイプによって異なります |
2.1.15. .spec.source.images リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- images は、ビルドのソースを提供するのに使用される一連のイメージを記述します
- 型
-
array
2.1.16. .spec.source.images[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ImageSource は、イメージから抽出されるか、マルチステージビルド中に使用されるビルドソースを記述するのに使用されます。タイプ ImageStreamTag、ImageStreamImage、または DockerImage の参照を使用できます。プルシークレットを指定して、外部レジストリーからイメージをプルするか、内部レジストリーからプルする場合はデフォルトのサービスアカウントシークレットを上書きできます。イメージソースを使用して、イメージからコンテンツを抽出し、リポジトリーソースと一緒にビルドコンテキストに配置するか、マルチステージコンテナーイメージのビルド中に直接使用して、リポジトリーソースのコンテンツを上書きせずにコンテンツをコピーできるようにします。('paths' および 'as' フィールドを参照してください)。
- 型
-
object
- 必須
-
from
-
プロパティー | 型 | 説明 |
---|---|---|
|
| マルチステージコンテナーイメージのビルド中にこのソースが代わりに使用されるイメージ名のリスト。たとえば、"COPY --from=nginx:latest" を使用する Dockerfile は、直接プルを試みる前に、このフィールドに "nginx:latest" が含まれるイメージソースを最初にチェックします。Dockerfile がイメージソースを参照していない場合、それは無視されます。このフィールドとパスの両方を設定できます。その場合、コンテンツは 2 回使用されます。 |
| from は、ソースをコピーする ImageStreamTag、ImageStreamImage、または DockerImage への参照です。 | |
|
| パスは、イメージからコピーするソースパスおよび宛先パスのリストです。このコンテンツは、ビルドを開始する前にビルドコンテキストにコピーされます。パスが設定されていない場合、ビルドコンテキストは変更されません。 |
|
| ImageSourcePath は、ビルドディレクトリー内のソースイメージとその宛先からコピーされるパスを記述します。 |
| pullSecret は、レジストリーからイメージをプルするのに使用されるシークレットへの参照です。イメージが OpenShift レジストリーからプルされる場合は、このフィールドを設定する必要がありません。 |
2.1.17. .spec.source.images[].paths リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- パスは、イメージからコピーするソースパスおよび宛先パスのリストです。このコンテンツは、ビルドを開始する前にビルドコンテキストにコピーされます。パスが設定されていない場合、ビルドコンテキストは変更されません。
- 型
-
array
2.1.18. .spec.source.images[].paths[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ImageSourcePath は、ビルドディレクトリー内のソースイメージとその宛先からコピーされるパスを記述します。
- 型
-
object
- 必須
-
sourcePath
-
destinationDir
-
プロパティー | 型 | 説明 |
---|---|---|
|
| destinationDir は、イメージからコピーされたファイルが配置されるビルドディレクトリー内の相対ディレクトリーです。 |
|
| sourcePath は、ビルドディレクトリーにコピーするイメージ内のファイルまたはディレクトリーの絶対パスです。ソースパスの末尾は /. であり、ディレクトリーのコンテンツがコピーされますが、ディレクトリー自体は宛先で作成されません。 |
2.1.19. .spec.source.secrets リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- secrets は、ビルドにのみ使用されるシークレットとその宛先のリストを表します。
- 型
-
array
2.1.20. .spec.source.secrets[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SecretBuildSource は、ビルド時にのみ使用されるシークレットとその宛先ディレクトリーを記述します。ここで参照されているシークレットの内容は、マウントする代わりに宛先ディレクトリーにコピーされます。
- 型
-
object
- 必須
-
secret
-
プロパティー | 型 | 説明 |
---|---|---|
|
| destinationDir は、ビルド時にシークレットのファイルを使用できるディレクトリーです。ソースビルド戦略の場合、これらはアセンブルスクリプトが実行されるコンテナーに挿入されます。その後、スクリプトが終了すると、挿入されたすべてのファイルの長さがゼロに切り捨てられます。コンテナーイメージのビルド戦略では、これらは Dockerfile が配置されているビルドディレクトリーにコピーされるため、ユーザーはコンテナーイメージのビルド中にそれらを追加またはコピーできます。 |
| secret は、ビルドで使用する既存のシークレットへの参照です。 |
2.1.21. .spec.strategy リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildStrategy には、ビルドを実行する方法の詳細が含まれています。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| CustomBuildStrategy は、カスタムビルドに固有の入力パラメーターを定義します。 |
|
| DockerBuildStrategy は、コンテナーイメージビルドに固有の入力パラメーターを定義します。 |
|
| JenkinsPipelineBuildStrategy は、Jenkins Pipeline ビルドに固有のパラメーターを保持します。非推奨: OpenShift Pipelines を使用する |
|
| SourceBuildStrategy は、ソースビルドに固有の入力パラメーターを定義します。 |
|
| タイプはビルド戦略の一種です。 |
2.1.22. .spec.strategy.customStrategy リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- CustomBuildStrategy は、カスタムビルドに固有の入力パラメーターを定義します。
- 型
-
object
- 必須
-
from
-
プロパティー | 型 | 説明 |
---|---|---|
|
| buildAPIVersion は、シリアル化されてカスタムビルダーに渡される Build オブジェクトに対して要求された API バージョンです。 |
| env には、ビルダーコンテナーに渡す追加の環境変数が含まれています。 | |
|
| exposeDockerSocket を使用すると、コンテナー内から Docker コマンドを実行 (およびコンテナーイメージをビルド) できます。 |
|
| forcePull は、コントローラーがビルド Pod を設定して、ビルダーのイメージを常にプルするか、ローカルに存在しない場合にのみプルするかを記述します。 |
| from は、コンテナーイメージのプル元となる DockerImage、ImageStreamTag、または ImageStreamImage への参照です。 | |
| pullSecret は、プライベート Docker レジストリーからコンテナーイメージをプルするための認証を設定するために使用される Secret の名前です。 | |
|
| secrets は、ビルド Pod に含まれる追加のシークレットのリストです |
|
| SecretSpec は、ビルド Pod とそれに対応するマウントポイントに含まれるシークレットを指定します |
2.1.23. .spec.strategy.customStrategy.secrets リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- secrets は、ビルド Pod に含まれる追加のシークレットのリストです
- 型
-
array
2.1.24. .spec.strategy.customStrategy.secrets[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SecretSpec は、ビルド Pod とそれに対応するマウントポイントに含まれるシークレットを指定します
- 型
-
object
- 必須
-
secretSource
-
mountPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| mountPath は、シークレットをマウントするパスです。 |
| secretSource はシークレットへの参照です |
2.1.25. .spec.strategy.dockerStrategy リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DockerBuildStrategy は、コンテナーイメージビルドに固有の入力パラメーターを定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
| buildArgs には、Dockerfile で解決されるビルド引数が含まれています。詳細は、https://docs.docker.com/engine/reference/builder/#/arg を参照してください。注意: 'name' フィールドおよび 'value' フィールドのみがサポートされます。'valueFrom' フィールドの設定は無視されます。 | |
|
|
dockerfilePath は、コンテキストのルート (contextDir) を基準にした、コンテナーイメージの構築に使用される Dockerfile のパスです。設定されていない場合は、デフォルトで |
| env には、ビルダーコンテナーに渡す追加の環境変数が含まれています。 | |
|
| forcePull は、ビルダーがビルドする前にレジストリーからイメージをプルする必要があるかどうかを記述します。 |
| from は、ビルド用の Dockerfile 内の FROM イメージをオーバーライドする DockerImage、ImageStreamTag、または ImageStreamImage への参照です。Dockerfile がマルチステージビルドを使用する場合、これはファイルの最後の FROM ディレクティブのイメージを置き換えます。 | |
|
| imageOptimizationPolicy は、イメージを構築するときにシステムが使用できる最適化を記述して、イメージの構築に費やされる最終的なサイズまたは時間を削減します。デフォルトのポリシーは 'None' です。これは、最終的なビルドイメージがコンテナーイメージビルド API によって作成されたイメージと同等になることを意味します。実験的なポリシー 'SkipLayers' は、各イメージステップの間に新しいレイヤーをコミットすることを回避し、Dockerfile が 'None' ポリシーとの互換性を提供できない場合は失敗します。追加の実験的なポリシー 'SkipLayersAndWarn' は 'SkipLayers' と同じですが、互換性を維持できない場合は単に警告します。 |
|
| noCache が true に設定されている場合、コンテナーイメージのビルドは --no-cache=true フラグを指定して実行する必要があることを示します |
| pullSecret は、プライベート Docker レジストリーからコンテナーイメージをプルするための認証を設定するために使用される Secret の名前です。 | |
|
| ボリュームは、ビルドのランタイム環境にマウントできる入力ボリュームのリストです。ビルドでサポートされているのは、Kubernetes Volume ソースのサブセットのみです。詳細: https://kubernetes.io/docs/concepts/storage/volumes |
|
| BuildVolume は、buildah のランタイム環境にマウントできるように、Pod をビルドするのに使用できるようになるボリュームを記述します。Kubernetes ボリュームソースのサブセットのみがサポートされています。 |
2.1.26. .spec.strategy.dockerStrategy.volumes リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ボリュームは、ビルドのランタイム環境にマウントできる入力ボリュームのリストです。ビルドでサポートされているのは、Kubernetes Volume ソースのサブセットのみです。詳細: https://kubernetes.io/docs/concepts/storage/volumes
- 型
-
array
2.1.27. .spec.strategy.dockerStrategy.volumes[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildVolume は、buildah のランタイム環境にマウントできるように、Pod をビルドするのに使用できるようになるボリュームを記述します。Kubernetes ボリュームソースのサブセットのみがサポートされています。
- 型
-
object
- 必須
-
name
-
source
-
mounts
-
プロパティー | 型 | 説明 |
---|---|---|
|
| mounts は、イメージビルドコンテナー内のボリュームの場所を表します |
|
| BuildVolumeMount は、buildah のランタイム環境内でのボリュームのマウントを説明します。 |
|
| name は、この BuildVolume の一意の識別子です。Kubernetes DNS ラベル標準に準拠し、Pod 内で一意である必要があります。名前が、ビルドコントローラーにより追加された名前と競合するとビルドが失敗し、エラーの原因となった名前の詳細を示すエラーメッセージが表示されます。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| BuildVolumeSource は、マウントするボリュームのソースを表します。サポートされているタイプの 1 つだけを常に指定できます。 |
2.1.28. .spec.strategy.dockerStrategy.volumes[].mounts リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- mounts は、イメージビルドコンテナー内のボリュームの場所を表します
- 型
-
array
2.1.29. .spec.strategy.dockerStrategy.volumes[].mounts[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildVolumeMount は、buildah のランタイム環境内でのボリュームのマウントを説明します。
- 型
-
object
- 必須
-
destinationPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| destinationPath は、ボリュームをマウントする必要がある buildah ランタイム環境内のパスです。ビルドイメージ内の一時マウントとバッキングボリュームは両方とも読み取り専用でマウントされます。絶対パスである必要があり、'..' または ':' を含めることはできません。また、ビルダープロセスにより生成された宛先パスと競合してはなりません。このパスが、ビルドコントローラーにより追加されたパスと競合すると、ビルドが失敗し、エラーの原因となったパスの詳細を示すエラーメッセージが表示されます。 |
2.1.30. .spec.strategy.dockerStrategy.volumes[].source リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildVolumeSource は、マウントするボリュームのソースを表します。サポートされているタイプの 1 つだけを常に指定できます。
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
| configMap は、このボリュームに入力する必要がある ConfigMap を表します | |
| csi は、このケイパビリティーをサポートする外部 CSI ドライバーが提供する一時ストレージを表します。 | |
| secret は、このボリュームに入力する必要がある Secret を表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#secret | |
|
| type は、ボリュームソースの BuildVolumeSourceType です。Type は、入力されたボリュームソースと一致する必要があります。有効なタイプは、Secret、ConfigMap です。 |
2.1.31. .spec.strategy.jenkinsPipelineStrategy リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- JenkinsPipelineBuildStrategy は、Jenkins Pipeline ビルドに固有のパラメーターを保持します。非推奨: OpenShift Pipelines を使用する
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
| env には、ビルドパイプラインに渡す追加の環境変数が含まれています。 | |
|
| Jenkinsfile は、Jenkins パイプラインビルドを定義する Jenkinsfile の任意の raw コンテンツを定義します。 |
|
| JenkinsfilePath は、コンテキストのルート (contextDir) を基準にしてパイプラインを設定するのに使用される Jenkinsfile の任意のパスです。JenkinsfilePath と Jenkinsfile の両方が指定されていない場合、これはデフォルトで、指定された contextDir のルートにある Jenkinsfile になります。 |
2.1.32. .spec.strategy.sourceStrategy リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceBuildStrategy は、ソースビルドに固有の入力パラメーターを定義します。
- 型
-
object
- 必須
-
from
-
プロパティー | 型 | 説明 |
---|---|---|
| env には、ビルダーコンテナーに渡す追加の環境変数が含まれています。 | |
|
| forcePull は、ビルダーがビルドする前にレジストリーからイメージをプルする必要があるかどうかを記述します。 |
| from は、コンテナーイメージのプル元となる DockerImage、ImageStreamTag、または ImageStreamImage への参照です。 | |
|
| 増分フラグは、true の場合、ソースビルドに増分ビルドを強制します。 |
| pullSecret は、プライベート Docker レジストリーからコンテナーイメージをプルするための認証を設定するために使用される Secret の名前です。 | |
|
| Source はソーススクリプトの場所です |
|
| ボリュームは、ビルドのランタイム環境にマウントできる入力ボリュームのリストです。ビルドでサポートされているのは、Kubernetes Volume ソースのサブセットのみです。詳細: https://kubernetes.io/docs/concepts/storage/volumes |
|
| BuildVolume は、buildah のランタイム環境にマウントできるように、Pod をビルドするのに使用できるようになるボリュームを記述します。Kubernetes ボリュームソースのサブセットのみがサポートされています。 |
2.1.33. .spec.strategy.sourceStrategy.volumes リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ボリュームは、ビルドのランタイム環境にマウントできる入力ボリュームのリストです。ビルドでサポートされているのは、Kubernetes Volume ソースのサブセットのみです。詳細: https://kubernetes.io/docs/concepts/storage/volumes
- 型
-
array
2.1.34. .spec.strategy.sourceStrategy.volumes[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildVolume は、buildah のランタイム環境にマウントできるように、Pod をビルドするのに使用できるようになるボリュームを記述します。Kubernetes ボリュームソースのサブセットのみがサポートされています。
- 型
-
object
- 必須
-
name
-
source
-
mounts
-
プロパティー | 型 | 説明 |
---|---|---|
|
| mounts は、イメージビルドコンテナー内のボリュームの場所を表します |
|
| BuildVolumeMount は、buildah のランタイム環境内でのボリュームのマウントを説明します。 |
|
| name は、この BuildVolume の一意の識別子です。Kubernetes DNS ラベル標準に準拠し、Pod 内で一意である必要があります。名前が、ビルドコントローラーにより追加された名前と競合するとビルドが失敗し、エラーの原因となった名前の詳細を示すエラーメッセージが表示されます。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| BuildVolumeSource は、マウントするボリュームのソースを表します。サポートされているタイプの 1 つだけを常に指定できます。 |
2.1.35. .spec.strategy.sourceStrategy.volumes[].mounts リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- mounts は、イメージビルドコンテナー内のボリュームの場所を表します
- 型
-
array
2.1.36. .spec.strategy.sourceStrategy.volumes[].mounts[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildVolumeMount は、buildah のランタイム環境内でのボリュームのマウントを説明します。
- 型
-
object
- 必須
-
destinationPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| destinationPath は、ボリュームをマウントする必要がある buildah ランタイム環境内のパスです。ビルドイメージ内の一時マウントとバッキングボリュームは両方とも読み取り専用でマウントされます。絶対パスである必要があり、'..' または ':' を含めることはできません。また、ビルダープロセスにより生成された宛先パスと競合してはなりません。このパスが、ビルドコントローラーにより追加されたパスと競合すると、ビルドが失敗し、エラーの原因となったパスの詳細を示すエラーメッセージが表示されます。 |
2.1.37. .spec.strategy.sourceStrategy.volumes[].source リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildVolumeSource は、マウントするボリュームのソースを表します。サポートされているタイプの 1 つだけを常に指定できます。
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
| configMap は、このボリュームに入力する必要がある ConfigMap を表します | |
| csi は、このケイパビリティーをサポートする外部 CSI ドライバーが提供する一時ストレージを表します。 | |
| secret は、このボリュームに入力する必要がある Secret を表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#secret | |
|
| type は、ボリュームソースの BuildVolumeSourceType です。Type は、入力されたボリュームソースと一致する必要があります。有効なタイプは、Secret、ConfigMap です。 |
2.1.38. .spec.triggers リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- トリガーは、BuildConfig から新しいビルドを起動する方法を決定します。トリガーが定義されていない場合、新しいビルドは、明示的なクライアントビルドの作成の結果としてのみ発生します。
- 型
-
array
2.1.39. .spec.triggers[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildTriggerPolicy は、新しいビルドをもたらす単一のトリガーのポリシーを記述します。
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| WebHookTrigger は、Webhook タイプの投稿を使用して呼び出されるトリガーです。 |
|
| WebHookTrigger は、Webhook タイプの投稿を使用して呼び出されるトリガーです。 |
|
| WebHookTrigger は、Webhook タイプの投稿を使用して呼び出されるトリガーです。 |
|
| WebHookTrigger は、Webhook タイプの投稿を使用して呼び出されるトリガーです。 |
|
| ImageChangeTrigger を使用すると、ImageStream が変更されたときにビルドをトリガーできます |
|
| type は、ビルドトリガーのタイプです。有効な値は以下のとおりです。 - GitHub GitHubWebHookBuildTriggerType は、GitHub Webhook 呼び出しでビルドを起動するトリガーを表します - Generic GenericWebHookBuildTriggerType は、汎用 Webhook 呼び出しでビルドを起動するトリガーを表します - GitLab GitLabWebHookBuildTriggerType は、GitLab Webhook 呼び出しでビルドを起動するトリガーを表します - Bitbucket BitbucketWebHookBuildTriggerType は、Bitbucket Webhook 呼び出しでビルドを起動するトリガーを表します - ImageChange ImageChangeBuildTriggerType は、新しいバージョンのイメージの可用性に基づいてビルドを起動するトリガーを表します - ConfigChange ConfigChangeBuildTriggerType は、最初のビルド設定の作成時にビルドをトリガーします。警告: 将来、動作が変更され、設定の変更時にビルドがトリガーされます |
2.1.40. .spec.triggers[].bitbucket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- WebHookTrigger は、Webhook タイプの投稿を使用して呼び出されるトリガーです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| allowEnv は、Webhook が環境変数を設定できるかどうかを判別します。GenericWebHook に対してのみ true に設定できます。 |
|
| リクエストの検証に使用されるシークレット。非推奨: 代わりに SecretReference を使用してください。 |
|
| SecretLocalReference には、使用されているローカルシークレットを指す情報が含まれています |
2.1.41. .spec.triggers[].bitbucket.secretReference リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SecretLocalReference には、使用されているローカルシークレットを指す情報が含まれています
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| Name は、参照されている同じ namespace 内のリソースの名前です。 |
2.1.42. .spec.triggers[].generic リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- WebHookTrigger は、Webhook タイプの投稿を使用して呼び出されるトリガーです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| allowEnv は、Webhook が環境変数を設定できるかどうかを判別します。GenericWebHook に対してのみ true に設定できます。 |
|
| リクエストの検証に使用されるシークレット。非推奨: 代わりに SecretReference を使用してください。 |
|
| SecretLocalReference には、使用されているローカルシークレットを指す情報が含まれています |
2.1.43. .spec.triggers[].generic.secretReference リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SecretLocalReference には、使用されているローカルシークレットを指す情報が含まれています
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| Name は、参照されている同じ namespace 内のリソースの名前です。 |
2.1.44. .spec.triggers[].github リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- WebHookTrigger は、Webhook タイプの投稿を使用して呼び出されるトリガーです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| allowEnv は、Webhook が環境変数を設定できるかどうかを判別します。GenericWebHook に対してのみ true に設定できます。 |
|
| リクエストの検証に使用されるシークレット。非推奨: 代わりに SecretReference を使用してください。 |
|
| SecretLocalReference には、使用されているローカルシークレットを指す情報が含まれています |
2.1.45. .spec.triggers[].github.secretReference リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SecretLocalReference には、使用されているローカルシークレットを指す情報が含まれています
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| Name は、参照されている同じ namespace 内のリソースの名前です。 |
2.1.46. .spec.triggers[].gitlab リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- WebHookTrigger は、Webhook タイプの投稿を使用して呼び出されるトリガーです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| allowEnv は、Webhook が環境変数を設定できるかどうかを判別します。GenericWebHook に対してのみ true に設定できます。 |
|
| リクエストの検証に使用されるシークレット。非推奨: 代わりに SecretReference を使用してください。 |
|
| SecretLocalReference には、使用されているローカルシークレットを指す情報が含まれています |
2.1.47. .spec.triggers[].gitlab.secretReference リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SecretLocalReference には、使用されているローカルシークレットを指す情報が含まれています
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| Name は、参照されている同じ namespace 内のリソースの名前です。 |
2.1.48. .spec.triggers[].imageChange リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ImageChangeTrigger を使用すると、ImageStream が変更されたときにビルドをトリガーできます
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
| from は、更新時にビルドをトリガーする ImageStreamTag への参照です。これはオプションです。From が指定されていない場合は、ビルドストラテジーの From イメージが使用されます。ビルド設定では、From 参照が空の ImageChangeTrigger を 1 つだけ許可します。 | |
|
| lastTriggeredImageID は、ビルド用に最後に使用されたイメージ ID を保存するために ImageChangeController によって内部的に使用されます。このフィールドは非推奨であり、将来のリリースで削除される予定です。非推奨 |
|
| このトリガーが一時的に無効になっている場合、paused は true です。任意。 |
2.1.49. .status リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildConfigStatus には、ビルド設定オブジェクトの現在の状態が含まれます。
- 型
-
object
- 必須
-
lastVersion
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ImageChangeTriggers は、BuildConfigSpec で指定された ImageChangeTrigger のランタイム状態をキャプチャーします。これには、OpenShift APIServer によって lastTriggeredImageID に対して調整された値が含まれます。この配列には、仕様のイメージ変更トリガーごとに 1 つのエントリーがあります。各トリガーステータスは、トリガーのソースとして機能する ImageStreamTag を参照します。 |
|
| ImageChangeTriggerStatus は、BuildConfigSpec.Triggers 構造体で指定された関連する ImageChangeTrigger ポリシーの最新の解決済みステータスを追跡します。 |
|
| lastVersion は、最後にトリガーされたビルドの数を通知するのに使用されます。 |
2.1.50. .status.imageChangeTriggers リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ImageChangeTriggers は、BuildConfigSpec で指定された ImageChangeTrigger のランタイム状態をキャプチャーします。これには、OpenShift APIServer によって lastTriggeredImageID に対して調整された値が含まれます。この配列には、仕様のイメージ変更トリガーごとに 1 つのエントリーがあります。各トリガーステータスは、トリガーのソースとして機能する ImageStreamTag を参照します。
- 型
-
array
2.1.51. .status.imageChangeTriggers[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ImageChangeTriggerStatus は、BuildConfigSpec.Triggers 構造体で指定された関連する ImageChangeTrigger ポリシーの最新の解決済みステータスを追跡します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ImageStreamTagReference は、namespace および名前によりイメージ変更トリガーの ImageStreamTag を参照します。 |
| time | lastTriggerTime は、この特定の ImageStreamTag が Build の開始をトリガーした最後の時間です。このフィールドは、このトリガーが具体的に Build を開始したときにのみ更新されます。 |
|
| lastTriggeredImageID は、この BuildConfig のビルドが開始したときの ImageStreamTag の sha/id を表します。lastTriggeredImageID は、この ImageStreamTag が Build が開始される理由ではない場合でも、この BuildConfig のビルドが開始されるたびに更新されます。 |
2.1.52. .status.imageChangeTriggers[].from リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ImageStreamTagReference は、namespace および名前によりイメージ変更トリガーの ImageStreamTag を参照します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、ImageChangeTrigger の ImageStreamTag の名前です。 |
|
| namespace は、ImageChangeTrigger の ImageStreamTag が配置されている namespace です。 |
2.2. API エンドポイント リンクのコピーリンクがクリップボードにコピーされました!
以下の API エンドポイントを利用できます。
/apis/build.openshift.io/v1/buildconfigs
-
GET
: BuildConfig 種類のオブジェクトをリスト表示または監視する
-
/apis/build.openshift.io/v1/watch/buildconfigs
-
GET
: BuildConfig のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
-
/apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs
-
DELETE
: BuildConfig のコレクションを削除する -
GET
: BuildConfig 種類のオブジェクトをリスト表示または監視する -
POST
: BuildConfig を作成する
-
/apis/build.openshift.io/v1/watch/namespaces/{namespace}/buildconfigs
-
GET
: BuildConfig のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
-
/apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs/{name}
-
DELETE
: BuildConfig を削除する -
GET
: 指定された BuildConfig を読み取る -
PATCH
: 指定された BuildConfig を部分的に更新します -
PUT
: 指定された BuildConfig を置き換える
-
/apis/build.openshift.io/v1/watch/namespaces/{namespace}/buildconfigs/{name}
-
GET
: BuildConfig 種類のオブジェクトへの変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用し、'fieldSelector' パラメーターで単一の項目にフィルター処理します。
-
2.2.1. /apis/build.openshift.io/v1/buildconfigs リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- BuildConfig 種類のオブジェクトをリスト表示または監視する
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
2.2.2. /apis/build.openshift.io/v1/watch/buildconfigs リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- BuildConfig のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
2.2.3. /apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
DELETE
- 説明
- BuildConfig のコレクションを削除する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
GET
- 説明
- BuildConfig 種類のオブジェクトをリスト表示または監視する
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
POST
- 説明
- BuildConfig を作成する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
202 - Accepted |
|
401 - Unauthorized | 空白 |
2.2.4. /apis/build.openshift.io/v1/watch/namespaces/{namespace}/buildconfigs リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- BuildConfig のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
2.2.5. /apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs/{name} リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| BuildConfig の名前 |
- HTTP メソッド
-
DELETE
- 説明
- BuildConfig を削除する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
202 - Accepted |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
GET
- 説明
- 指定された BuildConfig を読み取る
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PATCH
- 説明
- 指定された BuildConfig を部分的に更新します。
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PUT
- 説明
- 指定された BuildConfig を置き換える
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
2.2.6. /apis/build.openshift.io/v1/watch/namespaces/{namespace}/buildconfigs/{name} リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| BuildConfig の名前 |
- HTTP メソッド
-
GET
- 説明
- BuildConfig 種類のオブジェクトへの変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用し、'fieldSelector' パラメーターで単一の項目にフィルター処理します。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
第3章 Build [build.openshift.io/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
ビルドは、新しいデプロイ可能なイメージを生成するために必要な入力、実行のステータス、およびビルドを実行した Pod への参照をカプセル化します。
互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
- 型
-
object
3.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 を参照してください。 |
| metadata は標準オブジェクトのメタデータです。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。 | |
|
| BuildSpec には、ビルドを表すための情報と、ビルドに関する追加情報があります |
|
| BuildStatus には、ビルドのステータスが含まれる |
3.1.1. .spec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildSpec には、ビルドを表すための情報と、ビルドに関する追加情報があります
- 型
-
object
- 必須
-
strategy
-
プロパティー | 型 | 説明 |
---|---|---|
|
| completeDeadlineSeconds は、ビルド Pod がシステムでスケジュールされた時間から数えて、システムがアクティブにビルドを終了しようとする前に、ノードでビルドがアクティブになる可能性がある秒単位の任意の期間です。値は正の整数でなければなりません |
|
| mountTrustedCA バインドは、クラスターのプロキシー設定で定義されているように、クラスターの信頼できる認証局をビルドにマウントします。これにより、プライベートアーティファクトリーポジトリーや HTTPS プロキシーなど、カスタム PKI 認証局により署名されたビルド信頼コンポーネント内のプロセスが可能になります。
このフィールドを true に設定すると、ビルド内の |
|
| nodeSelector は、ビルド Pod がノードに収まるようにするために true である必要があるセレクターです。nil の場合は、クラスターのデフォルトのビルドの nodeselector 値をオーバーライドできます。空のマップまたは任意の値のマップに設定されている場合、デフォルトのビルドの nodeselector 値は無視されます。 |
|
| BuildOutput は、ビルドストラテジーへの入力であり、ストラテジーが生成する必要のあるコンテナーイメージを記述します。 |
|
| BuildPostCommitSpec は、ビルドポストコミットフック仕様を保持します。フックは、イメージの最後のレイヤーがコミットされた直後、イメージがレジストリーにプッシュされる前に、ビルド出力イメージを実行している一時コンテナーでコマンドを実行します。コマンドは、現在の作業ディレクトリー ($ PWD) をイメージの WORKDIR に設定して実行されます。 フックの実行が失敗すると、ビルドは失敗としてマークされます。スクリプトまたはコマンドがゼロ以外の終了コードを返す場合、または一時コンテナーの開始に関連するその他のエラーがある場合は失敗します。
フックを設定するには、5 つの異なる方法があります。例として、以下のすべての形式は同等であり、 1.シェルスクリプト: "postCommit": { "script": "rake test --verbose", } 上記は、以下と同等の便利な形式です。 "postCommit": { "command": ["/bin/sh", "-ic"], "args": ["rake test --verbose"] } 2.イメージエントリーポイントとしてのコマンド: "postCommit": { "commit": ["rake", "test", "--verbose"] } Docker (https://docs.docker.com/engine/reference/builder/#entrypoint) に記載されているように、コマンドは exec 形式のイメージエントリーポイントをオーバーライドします。 3.デフォルトのエントリーポイントに引数を渡します。 "postCommit": { "args": ["rake", "test", "--verbose"] } この形式は、イメージエントリーポイントが引数を処理できる場合にのみ役立ちます。 4.引数を指定したシェルスクリプト: "postCommit": { "script": "rake test $1", "args": ["--verbose"] } このフォームは、引数を渡す必要があるが、シェルスクリプトで正しく引用するのが困難な場合に有益です。上記のスクリプトでは、$0 は "/bin/sh" で、$1、$2 などは Args の位置引数となります。 5.引数のあるコマンド: "postCommit": { "command": ["rake", "test"], "args": ["--verbose"] } この形式は、Command スライスに引数を追加するのと同じです。 スクリプトとコマンドの両方を同時に提供することは無効です。どのフィールドも指定されていないと、フックは実行されません。 |
| resources は、ビルドを実行するためのリソース要件を計算します。 | |
|
| SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です |
|
| serviceAccount は、このビルドで作成された Pod を実行するのに使用する ServiceAccount の名前です。Pod は、ServiceAccount によって参照されるシークレットを使用できます。 |
|
| BuildSource は、ビルドに使用される SCM です。 |
|
| BuildStrategy には、ビルドを実行する方法の詳細が含まれています。 |
|
| triggeredBy は、ビルド設定の最新の更新を開始したトリガーを記述し、そのトリガーに関する情報を含みます。 |
|
| BuildTriggerCause は、トリガーされたビルドに関する情報を保持します。これは、oc describe の各ビルドおよびビルド設定のビルドトリガーデータを表示するのに使用されます。また、ビルド設定の最新の更新につながったトリガーを説明するためにも使用されます。 |
3.1.2. .spec.output リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildOutput は、ビルドストラテジーへの入力であり、ストラテジーが生成する必要のあるコンテナーイメージを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| imageLabels は、結果として生成されるイメージに適用されるラベルのリストを定義します。同じ名前のラベルが複数ある場合は、リストの最後のラベルが使用されます。 |
|
| ImageLabel は、結果のイメージに適用されるラベルを表します。 |
| PushSecret は、認証が有効な Docker レジストリー (または Docker Hub) への Docker プッシュを実行するための認証を設定するために使用される Secret の名前です。 | |
| このビルドの出力をプッシュする任意の場所を定義します。種類は 'ImageStreamTag' または 'DockerImage' のいずれかである必要があります。この値は、プッシュ先のコンテナーイメージリポジトリーを検索するのに使用されます。ImageStreamTag の場合は、Namespace が指定されていない限り、ImageStreamTag はビルドの namespace で検索されます。 |
3.1.3. .spec.output.imageLabels リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- imageLabels は、結果として生成されるイメージに適用されるラベルのリストを定義します。同じ名前のラベルが複数ある場合は、リストの最後のラベルが使用されます。
- 型
-
array
3.1.4. .spec.output.imageLabels[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ImageLabel は、結果のイメージに適用されるラベルを表します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、ラベルの名前を定義します。ゼロ以外の長さを持つ必要があります。 |
|
| 値は、ラベルのリテラル値を定義します。 |
3.1.5. .spec.postCommit リンクのコピーリンクがクリップボードにコピーされました!
- 説明
BuildPostCommitSpec は、ビルドポストコミットフック仕様を保持します。フックは、イメージの最後のレイヤーがコミットされた直後、イメージがレジストリーにプッシュされる前に、ビルド出力イメージを実行している一時コンテナーでコマンドを実行します。コマンドは、現在の作業ディレクトリー ($ PWD) をイメージの WORKDIR に設定して実行されます。
フックの実行が失敗すると、ビルドは失敗としてマークされます。スクリプトまたはコマンドがゼロ以外の終了コードを返す場合、または一時コンテナーの開始に関連するその他のエラーがある場合は失敗します。
フックを設定するには、5 つの異なる方法があります。例として、以下のすべての形式は同等であり、
rake test --verbose
を実行します。シェルスクリプト:
"postCommit": { "script": "rake test --verbose", }
"postCommit": { "script": "rake test --verbose", }
Copy to Clipboard Copied! Toggle word wrap Toggle overflow The above is a convenient form which is equivalent to:
The above is a convenient form which is equivalent to:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow "postCommit": { "command": ["/bin/sh", "-ic"], "args": ["rake test --verbose"] }
"postCommit": { "command": ["/bin/sh", "-ic"], "args": ["rake test --verbose"] }
Copy to Clipboard Copied! Toggle word wrap Toggle overflow イメージエントリーポイントとしてのコマンド:
"postCommit": { "commit": ["rake", "test", "--verbose"] }
"postCommit": { "commit": ["rake", "test", "--verbose"] }
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Command overrides the image entrypoint in the exec form, as documented in Docker: https://docs.docker.com/engine/reference/builder/#entrypoint.
Command overrides the image entrypoint in the exec form, as documented in Docker: https://docs.docker.com/engine/reference/builder/#entrypoint.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow デフォルトのエントリーポイントに引数を渡します。
"postCommit": { "args": ["rake", "test", "--verbose"] }
"postCommit": { "args": ["rake", "test", "--verbose"] }
Copy to Clipboard Copied! Toggle word wrap Toggle overflow This form is only useful if the image entrypoint can handle arguments.
This form is only useful if the image entrypoint can handle arguments.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 引数を指定したシェルスクリプト:
"postCommit": { "script": "rake test $1", "args": ["--verbose"] }
"postCommit": { "script": "rake test $1", "args": ["--verbose"] }
Copy to Clipboard Copied! Toggle word wrap Toggle overflow This form is useful if you need to pass arguments that would otherwise be hard to quote properly in the shell script. In the script, $0 will be "/bin/sh" and $1, $2, etc, are the positional arguments from Args.
This form is useful if you need to pass arguments that would otherwise be hard to quote properly in the shell script. In the script, $0 will be "/bin/sh" and $1, $2, etc, are the positional arguments from Args.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 引数のあるコマンド:
"postCommit": { "command": ["rake", "test"], "args": ["--verbose"] }
"postCommit": { "command": ["rake", "test"], "args": ["--verbose"] }
Copy to Clipboard Copied! Toggle word wrap Toggle overflow This form is equivalent to appending the arguments to the Command slice.
This form is equivalent to appending the arguments to the Command slice.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
スクリプトとコマンドの両方を同時に提供することは無効です。どのフィールドも指定されていないと、フックは実行されません。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| args は、Command、Script、またはコンテナーイメージのデフォルトのエントリーポイントのいずれかに提供される引数のリストです。引数は、実行するコマンドの直後に配置されます。 |
|
|
command は実行するコマンドです。スクリプトでは指定できない場合があります。これは、イメージに |
|
|
script は、 |
3.1.6. .spec.revision リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| GitSourceRevision は、ビルド用の git ソースからのコミット情報です。 |
|
| ビルドソースのタイプ。'Source'、'Dockerfile'、'Binary'、または 'Images' のいずれかになります。 |
3.1.7. .spec.revision.git リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GitSourceRevision は、ビルド用の git ソースからのコミット情報です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
| commit は、特定のコミットを識別するコミットハッシュです。 |
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
| メッセージは特定のコミットの説明です |
3.1.8. .spec.revision.git.author リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ソース管理ユーザーの電子メール |
|
| ソース管理ユーザーの名前 |
3.1.9. .spec.revision.git.committer リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ソース管理ユーザーの電子メール |
|
| ソース管理ユーザーの名前 |
3.1.10. .spec.source リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildSource は、ビルドに使用される SCM です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| BinaryBuildSource は、Docker および Source ビルドストラテジーに使用されるバイナリーファイルを記述します。ファイルは抽出され、ビルドソースとして使用されます。 |
|
| configMaps は、ビルドに使用される configMap とその宛先のリストを表します。 |
|
| ConfigMapBuildSource は、ビルド時にのみ使用される configmap とその宛先ディレクトリーを記述します。ここで参照されている configmap の内容は、マウントする代わりに宛先ディレクトリーにコピーされます。 |
|
| contextDir は、アプリケーションのソースコードが存在するサブディレクトリーを指定します。これにより、リポジトリーのルート以外のディレクトリーにビルド可能なソースを含めることができます。 |
|
| dockerfile は、ビルドする必要のある Dockerfile の生のコンテンツです。このオプションを指定すると、戦略ベースイメージに基づいて FROM が変更され、戦略環境からの追加の ENV スタンザが FROM から、残りの Dockerfile スタンザの間に追加されます。Dockerfile ソースタイプは、git などの他のオプションとともに使用できます。その場合、Git リポジトリーでは、コンテキストディレクトリーで固有の Dockerfile が置き換えられます。 |
|
| GitBuildSource は、Git SCM のパラメーターを定義します |
|
| images は、ビルドのソースを提供するのに使用される一連のイメージを記述します |
|
| ImageSource は、イメージから抽出されるか、マルチステージビルド中に使用されるビルドソースを記述するのに使用されます。タイプ ImageStreamTag、ImageStreamImage、または DockerImage の参照を使用できます。プルシークレットを指定して、外部レジストリーからイメージをプルするか、内部レジストリーからプルする場合はデフォルトのサービスアカウントシークレットを上書きできます。イメージソースを使用して、イメージからコンテンツを抽出し、リポジトリーソースと一緒にビルドコンテキストに配置するか、マルチステージコンテナーイメージのビルド中に直接使用して、リポジトリーソースのコンテンツを上書きせずにコンテンツをコピーできるようにします。('paths' および 'as' フィールドを参照してください)。 |
|
| secrets は、ビルドにのみ使用されるシークレットとその宛先のリストを表します。 |
|
| SecretBuildSource は、ビルド時にのみ使用されるシークレットとその宛先ディレクトリーを記述します。ここで参照されているシークレットの内容は、マウントする代わりに宛先ディレクトリーにコピーされます。 |
| sourceSecret は、プライベートリポジトリーのクローンを作成するための認証を設定するのに使用される Secret の名前です。シークレットには、リモートリポジトリーの有効な認証情報が含まれています。ここで、データのキーは使用される認証方法を表し、値は base64 でエンコードされた認証情報です。サポートされている認証方法は ssh-privatekey です。 | |
|
| 受け入れるビルド入力のタイプ |
3.1.11. .spec.source.binary リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BinaryBuildSource は、Docker および Source ビルドストラテジーに使用されるバイナリーファイルを記述します。ファイルは抽出され、ビルドソースとして使用されます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
|
asFile は、提供されたバイナリー入力がビルド入力内の単一ファイルと見なされる必要があることを示します。たとえば、"webapp.war" を指定すると、提供されたバイナリーがビルダーの |
3.1.12. .spec.source.configMaps リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- configMaps は、ビルドに使用される configMap とその宛先のリストを表します。
- 型
-
array
3.1.13. .spec.source.configMaps[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ConfigMapBuildSource は、ビルド時にのみ使用される configmap とその宛先ディレクトリーを記述します。ここで参照されている configmap の内容は、マウントする代わりに宛先ディレクトリーにコピーされます。
- 型
-
object
- 必須
-
configMap
-
プロパティー | 型 | 説明 |
---|---|---|
| configMap は、ビルドで使用する既存の configmap への参照です。 | |
|
| destinationDir は、ビルド時に configmap のファイルを使用できるディレクトリーです。ソースビルド戦略の場合、これらはアセンブルスクリプトが実行されるコンテナーに挿入されます。コンテナーイメージのビルド戦略では、これらは Dockerfile が配置されているビルドディレクトリーにコピーされるため、ユーザーはコンテナーイメージのビルド中にそれらを追加またはコピーできます。 |
3.1.14. .spec.source.git リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GitBuildSource は、Git SCM のパラメーターを定義します
- 型
-
object
- 必須
-
uri
-
プロパティー | 型 | 説明 |
---|---|---|
|
| httpProxy は、http 経由で git リポジトリーに到達するのに使用されるプロキシーです。 |
|
| httpsProxy は、https 経由で git リポジトリーに到達するのに使用されるプロキシーです。 |
|
| noProxy は、プロキシーを使用してはならないドメインのリストです。 |
|
| ref は、ビルドするブランチ/タグ/参照です。 |
|
| uri は、ビルドされるソースを指します。ソースの構造は、実行するビルドのタイプによって異なります |
3.1.15. .spec.source.images リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- images は、ビルドのソースを提供するのに使用される一連のイメージを記述します
- 型
-
array
3.1.16. .spec.source.images[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ImageSource は、イメージから抽出されるか、マルチステージビルド中に使用されるビルドソースを記述するのに使用されます。タイプ ImageStreamTag、ImageStreamImage、または DockerImage の参照を使用できます。プルシークレットを指定して、外部レジストリーからイメージをプルするか、内部レジストリーからプルする場合はデフォルトのサービスアカウントシークレットを上書きできます。イメージソースを使用して、イメージからコンテンツを抽出し、リポジトリーソースと一緒にビルドコンテキストに配置するか、マルチステージコンテナーイメージのビルド中に直接使用して、リポジトリーソースのコンテンツを上書きせずにコンテンツをコピーできるようにします。('paths' および 'as' フィールドを参照してください)。
- 型
-
object
- 必須
-
from
-
プロパティー | 型 | 説明 |
---|---|---|
|
| マルチステージコンテナーイメージのビルド中にこのソースが代わりに使用されるイメージ名のリスト。たとえば、"COPY --from=nginx:latest" を使用する Dockerfile は、直接プルを試みる前に、このフィールドに "nginx:latest" が含まれるイメージソースを最初にチェックします。Dockerfile がイメージソースを参照していない場合、それは無視されます。このフィールドとパスの両方を設定できます。その場合、コンテンツは 2 回使用されます。 |
| from は、ソースをコピーする ImageStreamTag、ImageStreamImage、または DockerImage への参照です。 | |
|
| パスは、イメージからコピーするソースパスおよび宛先パスのリストです。このコンテンツは、ビルドを開始する前にビルドコンテキストにコピーされます。パスが設定されていない場合、ビルドコンテキストは変更されません。 |
|
| ImageSourcePath は、ビルドディレクトリー内のソースイメージとその宛先からコピーされるパスを記述します。 |
| pullSecret は、レジストリーからイメージをプルするのに使用されるシークレットへの参照です。イメージが OpenShift レジストリーからプルされる場合は、このフィールドを設定する必要がありません。 |
3.1.17. .spec.source.images[].paths リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- パスは、イメージからコピーするソースパスおよび宛先パスのリストです。このコンテンツは、ビルドを開始する前にビルドコンテキストにコピーされます。パスが設定されていない場合、ビルドコンテキストは変更されません。
- 型
-
array
3.1.18. .spec.source.images[].paths[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ImageSourcePath は、ビルドディレクトリー内のソースイメージとその宛先からコピーされるパスを記述します。
- 型
-
object
- 必須
-
sourcePath
-
destinationDir
-
プロパティー | 型 | 説明 |
---|---|---|
|
| destinationDir は、イメージからコピーされたファイルが配置されるビルドディレクトリー内の相対ディレクトリーです。 |
|
| sourcePath は、ビルドディレクトリーにコピーするイメージ内のファイルまたはディレクトリーの絶対パスです。ソースパスの末尾は /. であり、ディレクトリーのコンテンツがコピーされますが、ディレクトリー自体は宛先で作成されません。 |
3.1.19. .spec.source.secrets リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- secrets は、ビルドにのみ使用されるシークレットとその宛先のリストを表します。
- 型
-
array
3.1.20. .spec.source.secrets[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SecretBuildSource は、ビルド時にのみ使用されるシークレットとその宛先ディレクトリーを記述します。ここで参照されているシークレットの内容は、マウントする代わりに宛先ディレクトリーにコピーされます。
- 型
-
object
- 必須
-
secret
-
プロパティー | 型 | 説明 |
---|---|---|
|
| destinationDir は、ビルド時にシークレットのファイルを使用できるディレクトリーです。ソースビルド戦略の場合、これらはアセンブルスクリプトが実行されるコンテナーに挿入されます。その後、スクリプトが終了すると、挿入されたすべてのファイルの長さがゼロに切り捨てられます。コンテナーイメージのビルド戦略では、これらは Dockerfile が配置されているビルドディレクトリーにコピーされるため、ユーザーはコンテナーイメージのビルド中にそれらを追加またはコピーできます。 |
| secret は、ビルドで使用する既存のシークレットへの参照です。 |
3.1.21. .spec.strategy リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildStrategy には、ビルドを実行する方法の詳細が含まれています。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| CustomBuildStrategy は、カスタムビルドに固有の入力パラメーターを定義します。 |
|
| DockerBuildStrategy は、コンテナーイメージビルドに固有の入力パラメーターを定義します。 |
|
| JenkinsPipelineBuildStrategy は、Jenkins Pipeline ビルドに固有のパラメーターを保持します。非推奨: OpenShift Pipelines を使用する |
|
| SourceBuildStrategy は、ソースビルドに固有の入力パラメーターを定義します。 |
|
| タイプはビルド戦略の一種です。 |
3.1.22. .spec.strategy.customStrategy リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- CustomBuildStrategy は、カスタムビルドに固有の入力パラメーターを定義します。
- 型
-
object
- 必須
-
from
-
プロパティー | 型 | 説明 |
---|---|---|
|
| buildAPIVersion は、シリアル化されてカスタムビルダーに渡される Build オブジェクトに対して要求された API バージョンです。 |
| env には、ビルダーコンテナーに渡す追加の環境変数が含まれています。 | |
|
| exposeDockerSocket を使用すると、コンテナー内から Docker コマンドを実行 (およびコンテナーイメージをビルド) できます。 |
|
| forcePull は、コントローラーがビルド Pod を設定して、ビルダーのイメージを常にプルするか、ローカルに存在しない場合にのみプルするかを記述します。 |
| from は、コンテナーイメージのプル元となる DockerImage、ImageStreamTag、または ImageStreamImage への参照です。 | |
| pullSecret は、プライベート Docker レジストリーからコンテナーイメージをプルするための認証を設定するために使用される Secret の名前です。 | |
|
| secrets は、ビルド Pod に含まれる追加のシークレットのリストです |
|
| SecretSpec は、ビルド Pod とそれに対応するマウントポイントに含まれるシークレットを指定します |
3.1.23. .spec.strategy.customStrategy.secrets リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- secrets は、ビルド Pod に含まれる追加のシークレットのリストです
- 型
-
array
3.1.24. .spec.strategy.customStrategy.secrets[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SecretSpec は、ビルド Pod とそれに対応するマウントポイントに含まれるシークレットを指定します
- 型
-
object
- 必須
-
secretSource
-
mountPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| mountPath は、シークレットをマウントするパスです。 |
| secretSource はシークレットへの参照です |
3.1.25. .spec.strategy.dockerStrategy リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DockerBuildStrategy は、コンテナーイメージビルドに固有の入力パラメーターを定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
| buildArgs には、Dockerfile で解決されるビルド引数が含まれています。詳細は、https://docs.docker.com/engine/reference/builder/#/arg を参照してください。注意: 'name' フィールドおよび 'value' フィールドのみがサポートされます。'valueFrom' フィールドの設定は無視されます。 | |
|
|
dockerfilePath は、コンテキストのルート (contextDir) を基準にした、コンテナーイメージの構築に使用される Dockerfile のパスです。設定されていない場合は、デフォルトで |
| env には、ビルダーコンテナーに渡す追加の環境変数が含まれています。 | |
|
| forcePull は、ビルダーがビルドする前にレジストリーからイメージをプルする必要があるかどうかを記述します。 |
| from は、ビルド用の Dockerfile 内の FROM イメージをオーバーライドする DockerImage、ImageStreamTag、または ImageStreamImage への参照です。Dockerfile がマルチステージビルドを使用する場合、これはファイルの最後の FROM ディレクティブのイメージを置き換えます。 | |
|
| imageOptimizationPolicy は、イメージを構築するときにシステムが使用できる最適化を記述して、イメージの構築に費やされる最終的なサイズまたは時間を削減します。デフォルトのポリシーは 'None' です。これは、最終的なビルドイメージがコンテナーイメージビルド API によって作成されたイメージと同等になることを意味します。実験的なポリシー 'SkipLayers' は、各イメージステップの間に新しいレイヤーをコミットすることを回避し、Dockerfile が 'None' ポリシーとの互換性を提供できない場合は失敗します。追加の実験的なポリシー 'SkipLayersAndWarn' は 'SkipLayers' と同じですが、互換性を維持できない場合は単に警告します。 |
|
| noCache が true に設定されている場合、コンテナーイメージのビルドは --no-cache=true フラグを指定して実行する必要があることを示します |
| pullSecret は、プライベート Docker レジストリーからコンテナーイメージをプルするための認証を設定するために使用される Secret の名前です。 | |
|
| ボリュームは、ビルドのランタイム環境にマウントできる入力ボリュームのリストです。ビルドでサポートされているのは、Kubernetes Volume ソースのサブセットのみです。詳細: https://kubernetes.io/docs/concepts/storage/volumes |
|
| BuildVolume は、buildah のランタイム環境にマウントできるように、Pod をビルドするのに使用できるようになるボリュームを記述します。Kubernetes ボリュームソースのサブセットのみがサポートされています。 |
3.1.26. .spec.strategy.dockerStrategy.volumes リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ボリュームは、ビルドのランタイム環境にマウントできる入力ボリュームのリストです。ビルドでサポートされているのは、Kubernetes Volume ソースのサブセットのみです。詳細: https://kubernetes.io/docs/concepts/storage/volumes
- 型
-
array
3.1.27. .spec.strategy.dockerStrategy.volumes[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildVolume は、buildah のランタイム環境にマウントできるように、Pod をビルドするのに使用できるようになるボリュームを記述します。Kubernetes ボリュームソースのサブセットのみがサポートされています。
- 型
-
object
- 必須
-
name
-
source
-
mounts
-
プロパティー | 型 | 説明 |
---|---|---|
|
| mounts は、イメージビルドコンテナー内のボリュームの場所を表します |
|
| BuildVolumeMount は、buildah のランタイム環境内でのボリュームのマウントを説明します。 |
|
| name は、この BuildVolume の一意の識別子です。Kubernetes DNS ラベル標準に準拠し、Pod 内で一意である必要があります。名前が、ビルドコントローラーにより追加された名前と競合するとビルドが失敗し、エラーの原因となった名前の詳細を示すエラーメッセージが表示されます。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| BuildVolumeSource は、マウントするボリュームのソースを表します。サポートされているタイプの 1 つだけを常に指定できます。 |
3.1.28. .spec.strategy.dockerStrategy.volumes[].mounts リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- mounts は、イメージビルドコンテナー内のボリュームの場所を表します
- 型
-
array
3.1.29. .spec.strategy.dockerStrategy.volumes[].mounts[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildVolumeMount は、buildah のランタイム環境内でのボリュームのマウントを説明します。
- 型
-
object
- 必須
-
destinationPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| destinationPath は、ボリュームをマウントする必要がある buildah ランタイム環境内のパスです。ビルドイメージ内の一時マウントとバッキングボリュームは両方とも読み取り専用でマウントされます。絶対パスである必要があり、'..' または ':' を含めることはできません。また、ビルダープロセスにより生成された宛先パスと競合してはなりません。このパスが、ビルドコントローラーにより追加されたパスと競合すると、ビルドが失敗し、エラーの原因となったパスの詳細を示すエラーメッセージが表示されます。 |
3.1.30. .spec.strategy.dockerStrategy.volumes[].source リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildVolumeSource は、マウントするボリュームのソースを表します。サポートされているタイプの 1 つだけを常に指定できます。
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
| configMap は、このボリュームに入力する必要がある ConfigMap を表します | |
| csi は、このケイパビリティーをサポートする外部 CSI ドライバーが提供する一時ストレージを表します。 | |
| secret は、このボリュームに入力する必要がある Secret を表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#secret | |
|
| type は、ボリュームソースの BuildVolumeSourceType です。Type は、入力されたボリュームソースと一致する必要があります。有効なタイプは、Secret、ConfigMap です。 |
3.1.31. .spec.strategy.jenkinsPipelineStrategy リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- JenkinsPipelineBuildStrategy は、Jenkins Pipeline ビルドに固有のパラメーターを保持します。非推奨: OpenShift Pipelines を使用する
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
| env には、ビルドパイプラインに渡す追加の環境変数が含まれています。 | |
|
| Jenkinsfile は、Jenkins パイプラインビルドを定義する Jenkinsfile の任意の raw コンテンツを定義します。 |
|
| JenkinsfilePath は、コンテキストのルート (contextDir) を基準にしてパイプラインを設定するのに使用される Jenkinsfile の任意のパスです。JenkinsfilePath と Jenkinsfile の両方が指定されていない場合、これはデフォルトで、指定された contextDir のルートにある Jenkinsfile になります。 |
3.1.32. .spec.strategy.sourceStrategy リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceBuildStrategy は、ソースビルドに固有の入力パラメーターを定義します。
- 型
-
object
- 必須
-
from
-
プロパティー | 型 | 説明 |
---|---|---|
| env には、ビルダーコンテナーに渡す追加の環境変数が含まれています。 | |
|
| forcePull は、ビルダーがビルドする前にレジストリーからイメージをプルする必要があるかどうかを記述します。 |
| from は、コンテナーイメージのプル元となる DockerImage、ImageStreamTag、または ImageStreamImage への参照です。 | |
|
| 増分フラグは、true の場合、ソースビルドに増分ビルドを強制します。 |
| pullSecret は、プライベート Docker レジストリーからコンテナーイメージをプルするための認証を設定するために使用される Secret の名前です。 | |
|
| Source はソーススクリプトの場所です |
|
| ボリュームは、ビルドのランタイム環境にマウントできる入力ボリュームのリストです。ビルドでサポートされているのは、Kubernetes Volume ソースのサブセットのみです。詳細: https://kubernetes.io/docs/concepts/storage/volumes |
|
| BuildVolume は、buildah のランタイム環境にマウントできるように、Pod をビルドするのに使用できるようになるボリュームを記述します。Kubernetes ボリュームソースのサブセットのみがサポートされています。 |
3.1.33. .spec.strategy.sourceStrategy.volumes リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ボリュームは、ビルドのランタイム環境にマウントできる入力ボリュームのリストです。ビルドでサポートされているのは、Kubernetes Volume ソースのサブセットのみです。詳細: https://kubernetes.io/docs/concepts/storage/volumes
- 型
-
array
3.1.34. .spec.strategy.sourceStrategy.volumes[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildVolume は、buildah のランタイム環境にマウントできるように、Pod をビルドするのに使用できるようになるボリュームを記述します。Kubernetes ボリュームソースのサブセットのみがサポートされています。
- 型
-
object
- 必須
-
name
-
source
-
mounts
-
プロパティー | 型 | 説明 |
---|---|---|
|
| mounts は、イメージビルドコンテナー内のボリュームの場所を表します |
|
| BuildVolumeMount は、buildah のランタイム環境内でのボリュームのマウントを説明します。 |
|
| name は、この BuildVolume の一意の識別子です。Kubernetes DNS ラベル標準に準拠し、Pod 内で一意である必要があります。名前が、ビルドコントローラーにより追加された名前と競合するとビルドが失敗し、エラーの原因となった名前の詳細を示すエラーメッセージが表示されます。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| BuildVolumeSource は、マウントするボリュームのソースを表します。サポートされているタイプの 1 つだけを常に指定できます。 |
3.1.35. .spec.strategy.sourceStrategy.volumes[].mounts リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- mounts は、イメージビルドコンテナー内のボリュームの場所を表します
- 型
-
array
3.1.36. .spec.strategy.sourceStrategy.volumes[].mounts[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildVolumeMount は、buildah のランタイム環境内でのボリュームのマウントを説明します。
- 型
-
object
- 必須
-
destinationPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| destinationPath は、ボリュームをマウントする必要がある buildah ランタイム環境内のパスです。ビルドイメージ内の一時マウントとバッキングボリュームは両方とも読み取り専用でマウントされます。絶対パスである必要があり、'..' または ':' を含めることはできません。また、ビルダープロセスにより生成された宛先パスと競合してはなりません。このパスが、ビルドコントローラーにより追加されたパスと競合すると、ビルドが失敗し、エラーの原因となったパスの詳細を示すエラーメッセージが表示されます。 |
3.1.37. .spec.strategy.sourceStrategy.volumes[].source リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildVolumeSource は、マウントするボリュームのソースを表します。サポートされているタイプの 1 つだけを常に指定できます。
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
| configMap は、このボリュームに入力する必要がある ConfigMap を表します | |
| csi は、このケイパビリティーをサポートする外部 CSI ドライバーが提供する一時ストレージを表します。 | |
| secret は、このボリュームに入力する必要がある Secret を表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#secret | |
|
| type は、ボリュームソースの BuildVolumeSourceType です。Type は、入力されたボリュームソースと一致する必要があります。有効なタイプは、Secret、ConfigMap です。 |
3.1.38. .spec.triggeredBy リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- triggeredBy は、ビルド設定の最新の更新を開始したトリガーを記述し、そのトリガーに関する情報を含みます。
- 型
-
array
3.1.39. .spec.triggeredBy[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildTriggerCause は、トリガーされたビルドに関する情報を保持します。これは、oc describe の各ビルドおよびビルド設定のビルドトリガーデータを表示するのに使用されます。また、ビルド設定の最新の更新につながったトリガーを説明するためにも使用されます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| BitbucketWebHookCause には、ビルドをトリガーした Bitbucket Webhook に関する情報があります。 |
|
| GenericWebHookCause は、ビルドをトリガーした汎用 WebHook に関する情報を保持します。 |
|
| GitHubWebHookCause には、ビルドをトリガーした GitHub Webhook に関する情報があります。 |
|
| GitLabWebHookCause には、ビルドをトリガーした GitLab Webhook に関する情報があります。 |
|
| ImageChangeCause には、ビルドをトリガーしたイメージに関する情報が含まれています |
|
| message は、ビルドがトリガーされた理由に関する人間が読めるメッセージを格納するために使用されます。たとえば、"Manually triggered by user"、"Configuration change" などです。 |
3.1.40. .spec.triggeredBy[].bitbucketWebHook リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BitbucketWebHookCause には、ビルドをトリガーした Bitbucket Webhook に関する情報があります。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です |
|
| Secret は、ビルドのトリガーとなった難読化された Webhook シークレットです。 |
3.1.41. .spec.triggeredBy[].bitbucketWebHook.revision リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| GitSourceRevision は、ビルド用の git ソースからのコミット情報です。 |
|
| ビルドソースのタイプ。'Source'、'Dockerfile'、'Binary'、または 'Images' のいずれかになります。 |
3.1.42. .spec.triggeredBy[].bitbucketWebHook.revision.git リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GitSourceRevision は、ビルド用の git ソースからのコミット情報です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
| commit は、特定のコミットを識別するコミットハッシュです。 |
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
| メッセージは特定のコミットの説明です |
3.1.43. .spec.triggeredBy[].bitbucketWebHook.revision.git.author リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ソース管理ユーザーの電子メール |
|
| ソース管理ユーザーの名前 |
3.1.44. .spec.triggeredBy[].bitbucketWebHook.revision.git.committer リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ソース管理ユーザーの電子メール |
|
| ソース管理ユーザーの名前 |
3.1.45. .spec.triggeredBy[].genericWebHook リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GenericWebHookCause は、ビルドをトリガーした汎用 WebHook に関する情報を保持します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です |
|
| secret は、ビルドをトリガーした難読化された Webhook シークレットです。 |
3.1.46. .spec.triggeredBy[].genericWebHook.revision リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| GitSourceRevision は、ビルド用の git ソースからのコミット情報です。 |
|
| ビルドソースのタイプ。'Source'、'Dockerfile'、'Binary'、または 'Images' のいずれかになります。 |
3.1.47. .spec.triggeredBy[].genericWebHook.revision.git リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GitSourceRevision は、ビルド用の git ソースからのコミット情報です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
| commit は、特定のコミットを識別するコミットハッシュです。 |
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
| メッセージは特定のコミットの説明です |
3.1.48. .spec.triggeredBy[].genericWebHook.revision.git.author リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ソース管理ユーザーの電子メール |
|
| ソース管理ユーザーの名前 |
3.1.49. .spec.triggeredBy[].genericWebHook.revision.git.committer リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ソース管理ユーザーの電子メール |
|
| ソース管理ユーザーの名前 |
3.1.50. .spec.triggeredBy[].githubWebHook リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GitHubWebHookCause には、ビルドをトリガーした GitHub Webhook に関する情報があります。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です |
|
| secret は、ビルドをトリガーした難読化された Webhook シークレットです。 |
3.1.51. .spec.triggeredBy[].githubWebHook.revision リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| GitSourceRevision は、ビルド用の git ソースからのコミット情報です。 |
|
| ビルドソースのタイプ。'Source'、'Dockerfile'、'Binary'、または 'Images' のいずれかになります。 |
3.1.52. .spec.triggeredBy[].githubWebHook.revision.git リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GitSourceRevision は、ビルド用の git ソースからのコミット情報です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
| commit は、特定のコミットを識別するコミットハッシュです。 |
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
| メッセージは特定のコミットの説明です |
3.1.53. .spec.triggeredBy[].githubWebHook.revision.git.author リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ソース管理ユーザーの電子メール |
|
| ソース管理ユーザーの名前 |
3.1.54. .spec.triggeredBy[].githubWebHook.revision.git.committer リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ソース管理ユーザーの電子メール |
|
| ソース管理ユーザーの名前 |
3.1.55. .spec.triggeredBy[].gitlabWebHook リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GitLabWebHookCause には、ビルドをトリガーした GitLab Webhook に関する情報があります。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です |
|
| Secret は、ビルドのトリガーとなった難読化された Webhook シークレットです。 |
3.1.56. .spec.triggeredBy[].gitlabWebHook.revision リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| GitSourceRevision は、ビルド用の git ソースからのコミット情報です。 |
|
| ビルドソースのタイプ。'Source'、'Dockerfile'、'Binary'、または 'Images' のいずれかになります。 |
3.1.57. .spec.triggeredBy[].gitlabWebHook.revision.git リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GitSourceRevision は、ビルド用の git ソースからのコミット情報です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
| commit は、特定のコミットを識別するコミットハッシュです。 |
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
| メッセージは特定のコミットの説明です |
3.1.58. .spec.triggeredBy[].gitlabWebHook.revision.git.author リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ソース管理ユーザーの電子メール |
|
| ソース管理ユーザーの名前 |
3.1.59. .spec.triggeredBy[].gitlabWebHook.revision.git.committer リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ソース管理ユーザーの電子メール |
|
| ソース管理ユーザーの名前 |
3.1.60. .spec.triggeredBy[].imageChangeBuild リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ImageChangeCause には、ビルドをトリガーしたイメージに関する情報が含まれています
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
| fromRef には、ビルドをトリガーしたイメージに関する詳細情報が含まれています。 | |
|
| imageID は、新しいビルドをトリガーしたイメージの ID です。 |
3.1.61. .status リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildStatus には、ビルドのステータスが含まれる
- 型
-
object
- 必須
-
phase
-
プロパティー | 型 | 説明 |
---|---|---|
|
| cancelled は、ビルドに対してキャンセルイベントがトリガーされたかどうかを示します。 |
| time | completionTimestamp は、ビルドが失敗したか成功したかに関係なく、この Build が終了したサーバー時間を表すタイムスタンプです。これは、Build を実行している Pod が終了した時刻を反映しています。これは RFC3339 形式で表されます。これは UTC です。 |
|
| Conditions は、ビルドの現在の状態に関する利用可能な最新の観測値を表します。 |
|
| BuildCondition は、特定の時点でのビルドの状態を記述します。 |
| config は、この Build のベースとなる BuildConfig への ObjectReference です。 | |
|
| duration には time.Duration オブジェクトが含まれ、ビルド時間を記述します。 |
|
| logSnippet は、ビルドログの最後の数行です。この値は、失敗したビルドに対してのみ設定されます。 |
|
| message は、ビルドがこのステータスになる理由の詳細を示す、人が判読できるメッセージです。 |
|
| BuildStatusOutput には、ビルドされたイメージのステータスが含まれます。 |
|
| outputDockerImageReference には、このビルドによりビルドされるコンテナーイメージへの参照が含まれています。その値は Build.Spec.Output.To から計算され、イメージをプッシュおよびプルするのに使用できるように、レジストリーアドレスを含める必要があります。 |
|
| フェーズは、ビルドライフサイクルのポイントです。可能な値は、"New"、"Pending"、"Running"、"Complete"、"Failed"、"Error"、および "Cancelled" です。 |
|
| reason は、障害を説明する簡単な CamelCase 文字列であり、CLI でのマシン解析と整理された表示を目的としています。 |
|
| stages には、開始時間、期間 (ミリ秒単位)、各ステージ内で発生したステップなど、ビルド中に発生する各ステージに関する詳細が含まれます。 |
|
| StageInfo には、ビルドステージに関する詳細が含まれています。 |
| time | startTimestamp は、この Build が Pod で実行を開始したときのサーバー時間を表すタイムスタンプです。これは RFC3339 形式で表されます。これは UTC です。 |
3.1.62. .status.conditions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Conditions は、ビルドの現在の状態に関する利用可能な最新の観測値を表します。
- 型
-
array
3.1.63. .status.conditions[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildCondition は、特定の時点でのビルドの状態を記述します。
- 型
-
object
- 必須
-
type
-
status
-
プロパティー | 型 | 説明 |
---|---|---|
| time | 最後にある状態から別の状態に遷移した時間。 |
| time | この状態が最後に更新された時刻。 |
|
| 遷移の詳細を示す人が判読できるメッセージ。 |
|
| 条件の最後の遷移の理由。 |
|
| 状態のステータス (True、False、Unknown のいずれか)。 |
|
| ビルド条件のタイプ。 |
3.1.64. .status.output リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildStatusOutput には、ビルドされたイメージのステータスが含まれます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| BuildStatusOutputTo は、プッシュ先のイメージレジストリーに関するビルドされたイメージのステータスを記述します。 |
3.1.65. .status.output.to リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildStatusOutputTo は、プッシュ先のイメージレジストリーに関するビルドされたイメージのステータスを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| imageDigest は、ビルドされたコンテナーイメージのダイジェストです。ダイジェストは、プッシュ先のレジストリー内のイメージを一意に識別します。 プッシュが正常に完了した場合でも、このフィールドが常に設定されるとは限らないことに注意してください。たとえば、レジストリーがダイジェストを返さない場合や、ビルダーが理解できない形式で返す場合などです。 |
3.1.66. .status.stages リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- stages には、開始時間、期間 (ミリ秒単位)、各ステージ内で発生したステップなど、ビルド中に発生する各ステージに関する詳細が含まれます。
- 型
-
array
3.1.67. .status.stages[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- StageInfo には、ビルドステージに関する詳細が含まれています。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| durationMilliseconds は、ステージが完了するまでにかかった時間をミリ秒単位で識別します。注: 明示的なビルドステップですべてのアクションが考慮されるわけではないため、ステージの期間は、ステージ内のステップの期間の合計を超える可能性があります。 |
|
| name は、発生する各ビルドステージの一意の識別子です。 |
| time | startTime は、この Stage が開始したときのサーバー時間を表すタイムスタンプです。これは RFC3339 形式で表されます。これは UTC です。 |
|
| ステップには、開始時間やミリ秒単位の期間など、ビルドステージ中に発生する各ステップの詳細が含まれています。 |
|
| StepInfo には、ビルドステップに関する詳細が含まれています。 |
3.1.68. .status.stages[].steps リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ステップには、開始時間やミリ秒単位の期間など、ビルドステージ中に発生する各ステップの詳細が含まれています。
- 型
-
array
3.1.69. .status.stages[].steps[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- StepInfo には、ビルドステップに関する詳細が含まれています。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| durationMilliseconds は、ステップが完了するまでにかかった時間をミリ秒単位で識別します。 |
|
| name は、各ビルドステップの一意の識別子です。 |
| time | startTime は、このステップが開始したときのサーバー時間を表すタイムスタンプです。RFC3339 形式で表され、UTC で表示されます。 |
3.2. API エンドポイント リンクのコピーリンクがクリップボードにコピーされました!
以下の API エンドポイントを利用できます。
/apis/build.openshift.io/v1/builds
-
GET
: 種類が Build のオブジェクトをリスト表示または監視する
-
/apis/build.openshift.io/v1/watch/builds
-
GET
: Build のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
-
/apis/build.openshift.io/v1/namespaces/{namespace}/builds
-
削除
: ビルドのコレクションを削除します -
GET
: 種類が Build のオブジェクトをリスト表示または監視する -
POST
: ビルドを作成します
-
/apis/build.openshift.io/v1/watch/namespaces/{namespace}/builds
-
GET
: Build のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
-
/apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name}
-
削除
: ビルドを削除します -
GET
: 指定されたビルドを読み取ります -
PATCH
: 指定されたビルドを部分的に更新します -
PUT
: 指定されたビルドを置き換えます
-
/apis/build.openshift.io/v1/watch/namespaces/{namespace}/builds/{name}
-
GET
: Build 種類のオブジェクトへの変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用し、'fieldSelector' パラメーターで単一の項目にフィルター処理します。
-
/apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name}/details
-
PUT
: 指定された Build の詳細を置き換える
-
/apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs/{name}/webhooks
-
POST
: POST リクエストを BuildConfig の Webhook に接続する
-
/apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs/{name}/webhooks/{path}
-
POST
: POST リクエストを BuildConfig の Webhook に接続する
-
3.2.1. /apis/build.openshift.io/v1/builds リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- 種類 Build のオブジェクトをリスト表示または監視する
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
3.2.2. /apis/build.openshift.io/v1/watch/builds リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- Build のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
3.2.3. /apis/build.openshift.io/v1/namespaces/{namespace}/builds リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
DELETE
- 説明
- ビルドのコレクションを削除します
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
GET
- 説明
- 種類 Build のオブジェクトをリスト表示または監視する
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
POST
- 説明
- ビルドを作成する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
3.2.4. /apis/build.openshift.io/v1/watch/namespaces/{namespace}/builds リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- Build のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
3.2.5. /apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name} リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| ビルドの名前 |
- HTTP メソッド
-
DELETE
- 説明
- ビルドを削除する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
202 - Accepted |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
GET
- 説明
- 指定されたビルドを読み取る
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PATCH
- 説明
- 指定されたビルドを部分的に更新します
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PUT
- 説明
- 指定されたビルドを置き換えます
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
3.2.6. /apis/build.openshift.io/v1/watch/namespaces/{namespace}/builds/{name} リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| ビルドの名前 |
- HTTP メソッド
-
GET
- 説明
- Build 種類のオブジェクトへの変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用し、'fieldSelector' パラメーターで単一の項目にフィルター処理します。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
3.2.7. /apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name}/details リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| ビルドの名前 |
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
- HTTP メソッド
-
PUT
- 説明
- 指定された Build の詳細を置き換える
パラメーター | 型 | 説明 |
---|---|---|
|
|
3.2.8. /apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs/{name}/webhooks リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| ビルドの名前 |
- HTTP メソッド
-
POST
- 説明
- POST リクエストを BuildConfig の Webhook に接続する
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
3.2.9. /apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs/{name}/webhooks/{path} リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| ビルドの名前 |
- HTTP メソッド
-
POST
- 説明
- POST リクエストを BuildConfig の Webhook に接続する
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
第4章 BuildLog [build.openshift.io/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
BuildLog は、ビルドログリダイレクターに関連付けられた (未使用の) リソースです。
互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
- 型
-
object
4.1. 仕様 リンクのコピーリンクがクリップボードにコピーされました!
プロパティー | 型 | 説明 |
---|---|---|
|
| apiVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。 |
|
| kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できる場合があります。これは更新できません。CamelCase を使用します。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。 |
4.2. API エンドポイント リンクのコピーリンクがクリップボードにコピーされました!
以下の API エンドポイントを利用できます。
/apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name}/log
-
GET
: 指定された Build のログを読み取る
-
4.2.1. /apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name}/log リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| BuildLog の名前 |
- HTTP メソッド
-
GET
- 説明
- 指定された Build のログを読み取る
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
第5章 BuildRequest [build.openshift.io/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
BuildRequest は、ビルドジェネレーターにパラメーターを渡すのに使用されるリソースです。
互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
- 型
-
object
5.1. 仕様 リンクのコピーリンクがクリップボードにコピーされました!
プロパティー | 型 | 説明 |
---|---|---|
|
| apiVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。 |
|
| BinaryBuildSource は、Docker および Source ビルドストラテジーに使用されるバイナリーファイルを記述します。ファイルは抽出され、ビルドソースとして使用されます。 |
|
| DockerStrategyOptions には、コンテナーイメージビルド用の追加の戦略オプションが含まれています |
| env には、ビルダーコンテナーに渡す追加の環境変数が含まれています。 | |
| from は、ビルドをトリガーした ImageStreamTag への参照です。 | |
|
| kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できる場合があります。これは更新できません。CamelCase を使用します。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。 |
|
| lastVersion (オプション) は、ビルドの生成に使用された BuildConfig の LastVersion です。ジェネレーターの BuildConfig が一致しない場合、ビルドは生成されません。 |
| metadata は標準オブジェクトのメタデータです。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。 | |
|
| SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です |
|
| SourceStrategyOptions には、Source ビルド用の追加の戦略オプションが含まれています |
|
| triggeredBy は、ビルド設定の最新の更新を開始したトリガーを記述し、そのトリガーに関する情報を含みます。 |
|
| BuildTriggerCause は、トリガーされたビルドに関する情報を保持します。これは、oc describe の各ビルドおよびビルド設定のビルドトリガーデータを表示するのに使用されます。また、ビルド設定の最新の更新につながったトリガーを説明するためにも使用されます。 |
| triggeredByImage は、このビルドをトリガーしたイメージです。 |
5.1.1. .binary リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BinaryBuildSource は、Docker および Source ビルドストラテジーに使用されるバイナリーファイルを記述します。ファイルは抽出され、ビルドソースとして使用されます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
|
asFile は、提供されたバイナリー入力がビルド入力内の単一ファイルと見なされる必要があることを示します。たとえば、"webapp.war" を指定すると、提供されたバイナリーがビルダーの |
5.1.2. .dockerStrategyOptions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DockerStrategyOptions には、コンテナーイメージビルド用の追加の戦略オプションが含まれています
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
| Args には、Docker に渡されるビルド引数が含まれています。詳細は、https://docs.docker.com/engine/reference/builder/#/arg を参照してください | |
|
| noCache は、ビルド設定の docker-strategy noCache オプションをオーバーライドします |
5.1.3. .revision リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| GitSourceRevision は、ビルド用の git ソースからのコミット情報です。 |
|
| ビルドソースのタイプ。'Source'、'Dockerfile'、'Binary'、または 'Images' のいずれかになります。 |
5.1.4. .revision.git リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GitSourceRevision は、ビルド用の git ソースからのコミット情報です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
| commit は、特定のコミットを識別するコミットハッシュです。 |
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
| メッセージは特定のコミットの説明です |
5.1.5. .revision.git.author リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ソース管理ユーザーの電子メール |
|
| ソース管理ユーザーの名前 |
5.1.6. .revision.git.committer リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ソース管理ユーザーの電子メール |
|
| ソース管理ユーザーの名前 |
5.1.7. .sourceStrategyOptions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceStrategyOptions には、Source ビルド用の追加の戦略オプションが含まれています
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 増分は、ビルド設定のソース戦略増分オプションをオーバーライドします |
5.1.8. .triggeredBy リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- triggeredBy は、ビルド設定の最新の更新を開始したトリガーを記述し、そのトリガーに関する情報を含みます。
- 型
-
array
5.1.9. .triggeredBy[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BuildTriggerCause は、トリガーされたビルドに関する情報を保持します。これは、oc describe の各ビルドおよびビルド設定のビルドトリガーデータを表示するのに使用されます。また、ビルド設定の最新の更新につながったトリガーを説明するためにも使用されます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| BitbucketWebHookCause には、ビルドをトリガーした Bitbucket Webhook に関する情報があります。 |
|
| GenericWebHookCause は、ビルドをトリガーした汎用 WebHook に関する情報を保持します。 |
|
| GitHubWebHookCause には、ビルドをトリガーした GitHub Webhook に関する情報があります。 |
|
| GitLabWebHookCause には、ビルドをトリガーした GitLab Webhook に関する情報があります。 |
|
| ImageChangeCause には、ビルドをトリガーしたイメージに関する情報が含まれています |
|
| message は、ビルドがトリガーされた理由に関する人間が読めるメッセージを格納するために使用されます。たとえば、"Manually triggered by user"、"Configuration change" などです。 |
5.1.10. .triggeredBy[].bitbucketWebHook リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- BitbucketWebHookCause には、ビルドをトリガーした Bitbucket Webhook に関する情報があります。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です |
|
| Secret は、ビルドのトリガーとなった難読化された Webhook シークレットです。 |
5.1.11. .triggeredBy[].bitbucketWebHook.revision リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| GitSourceRevision は、ビルド用の git ソースからのコミット情報です。 |
|
| ビルドソースのタイプ。'Source'、'Dockerfile'、'Binary'、または 'Images' のいずれかになります。 |
5.1.12. .triggeredBy[].bitbucketWebHook.revision.git リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GitSourceRevision は、ビルド用の git ソースからのコミット情報です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
| commit は、特定のコミットを識別するコミットハッシュです。 |
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
| メッセージは特定のコミットの説明です |
5.1.13. .triggeredBy[].bitbucketWebHook.revision.git.author リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ソース管理ユーザーの電子メール |
|
| ソース管理ユーザーの名前 |
5.1.14. .triggeredBy[].bitbucketWebHook.revision.git.committer リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ソース管理ユーザーの電子メール |
|
| ソース管理ユーザーの名前 |
5.1.15. .triggeredBy[].genericWebHook リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GenericWebHookCause は、ビルドをトリガーした汎用 WebHook に関する情報を保持します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です |
|
| secret は、ビルドをトリガーした難読化された Webhook シークレットです。 |
5.1.16. .triggeredBy[].genericWebHook.revision リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| GitSourceRevision は、ビルド用の git ソースからのコミット情報です。 |
|
| ビルドソースのタイプ。'Source'、'Dockerfile'、'Binary'、または 'Images' のいずれかになります。 |
5.1.17. .triggeredBy[].genericWebHook.revision.git リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GitSourceRevision は、ビルド用の git ソースからのコミット情報です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
| commit は、特定のコミットを識別するコミットハッシュです。 |
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
| メッセージは特定のコミットの説明です |
5.1.18. .triggeredBy[].genericWebHook.revision.git.author リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ソース管理ユーザーの電子メール |
|
| ソース管理ユーザーの名前 |
5.1.19. .triggeredBy[].genericWebHook.revision.git.committer リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ソース管理ユーザーの電子メール |
|
| ソース管理ユーザーの名前 |
5.1.20. .triggeredBy[].githubWebHook リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GitHubWebHookCause には、ビルドをトリガーした GitHub Webhook に関する情報があります。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です |
|
| secret は、ビルドをトリガーした難読化された Webhook シークレットです。 |
5.1.21. .triggeredBy[].githubWebHook.revision リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| GitSourceRevision は、ビルド用の git ソースからのコミット情報です。 |
|
| ビルドソースのタイプ。'Source'、'Dockerfile'、'Binary'、または 'Images' のいずれかになります。 |
5.1.22. .triggeredBy[].githubWebHook.revision.git リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GitSourceRevision は、ビルド用の git ソースからのコミット情報です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
| commit は、特定のコミットを識別するコミットハッシュです。 |
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
| メッセージは特定のコミットの説明です |
5.1.23. .triggeredBy[].githubWebHook.revision.git.author リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ソース管理ユーザーの電子メール |
|
| ソース管理ユーザーの名前 |
5.1.24. .triggeredBy[].githubWebHook.revision.git.committer リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ソース管理ユーザーの電子メール |
|
| ソース管理ユーザーの名前 |
5.1.25. .triggeredBy[].gitlabWebHook リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GitLabWebHookCause には、ビルドをトリガーした GitLab Webhook に関する情報があります。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です |
|
| Secret は、ビルドのトリガーとなった難読化された Webhook シークレットです。 |
5.1.26. .triggeredBy[].gitlabWebHook.revision リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| GitSourceRevision は、ビルド用の git ソースからのコミット情報です。 |
|
| ビルドソースのタイプ。'Source'、'Dockerfile'、'Binary'、または 'Images' のいずれかになります。 |
5.1.27. .triggeredBy[].gitlabWebHook.revision.git リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GitSourceRevision は、ビルド用の git ソースからのコミット情報です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
| commit は、特定のコミットを識別するコミットハッシュです。 |
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
| メッセージは特定のコミットの説明です |
5.1.28. .triggeredBy[].gitlabWebHook.revision.git.author リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ソース管理ユーザーの電子メール |
|
| ソース管理ユーザーの名前 |
5.1.29. .triggeredBy[].gitlabWebHook.revision.git.committer リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ソース管理ユーザーの電子メール |
|
| ソース管理ユーザーの名前 |
5.1.30. .triggeredBy[].imageChangeBuild リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ImageChangeCause には、ビルドをトリガーしたイメージに関する情報が含まれています
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
| fromRef には、ビルドをトリガーしたイメージに関する詳細情報が含まれています。 | |
|
| imageID は、新しいビルドをトリガーしたイメージの ID です。 |
5.2. API エンドポイント リンクのコピーリンクがクリップボードにコピーされました!
以下の API エンドポイントを利用できます。
/apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name}/clone
-
POST
: Build のクローンを作成する
-
/apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs/{name}/instantiate
-
POST
: BuildConfig のインスタンス化を作成する
-
5.2.1. /apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name}/clone リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| BuildRequest の名前 |
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
- HTTP メソッド
-
POST
- 説明
- Build のクローンを作成する
パラメーター | 型 | 説明 |
---|---|---|
|
|
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
202 - Accepted |
|
401 - Unauthorized | 空白 |
5.2.2. /apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs/{name}/instantiate リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| BuildRequest の名前 |
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
- HTTP メソッド
-
POST
- 説明
- BuildConfig のインスタンス化を作成する
パラメーター | 型 | 説明 |
---|---|---|
|
|
第6章 CronJob [batch/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- CronJob は、単一の cron ジョブの設定を表します。
- 型
-
object
6.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 を参照してください。 | |
|
| CronJobSpec は、ジョブの実行がどのようになり、実際にいつ実行されるかを記述します。 |
|
| CronJobStatus は、cron ジョブの現在の状態を表します。 |
6.1.1. .spec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- CronJobSpec は、ジョブの実行がどのようになり、実際にいつ実行されるかを記述します。
- 型
-
object
- 必須
-
スケジュール
-
jobTemplate
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ジョブの同時実行を処理する方法を指定します。有効な値は以下のとおりです。 - "Allow" (デフォルト):CronJobs の同時実行を許可します。- "Forbid": 同時実行を禁止し、前の実行がまだ終了していない場合は次の実行をスキップします。- "Replace": 現在実行中のジョブをキャンセルし、新しいジョブに置き換えます。
有効な列挙値: |
|
| 保持する失敗した終了ジョブの数。値は負の値ではない整数にする必要があります。デフォルトは 1 です。 |
|
| JobTemplateSpec は、テンプレートから作成されたときにジョブが持つべきデータを記述します |
|
| Cron 形式のスケジュールは、https://en.wikipedia.org/wiki/Cron を参照してください。 |
|
| ジョブを開始するためのオプションの期限 (秒単位)(何らかの理由によりスケジュールされた時間が経過する場合)。ジョブの実行が行われない場合、ジョブの失敗としてカウントされます。 |
|
| 保持する成功した終了済みジョブの数。値は負の値ではない整数にする必要があります。デフォルトは 3 です。 |
|
| このフラグは、後続の実行を一時停止するようにコントローラーに指示します。すでに開始されている実行には適用されません。デフォルトは false です。 |
|
| 指定されたスケジュールのタイムゾーン名は、https://en.wikipedia.org/wiki/List_of_tz_database_time_zones を参照してください。指定しない場合、デフォルトで kube-controller-manager プロセスのタイムゾーンが使用されます。有効なタイムゾーン名とタイムゾーンオフセットのセットは、CronJob の検証中および実行時にコントローラーマネージャーによって、システム全体のタイムゾーンデータベースから読み込まれます。システム全体のタイムゾーンデータベースが見つからない場合は、代わりにバンドル化されたバージョンのデータベースが使用されます。CronJob の有効期間中またはホスト設定の変更によってタイムゾーン名が無効になると、コントローラーは新しいジョブの作成を停止し、理由が UnknownTimeZone のシステムイベントを作成します。詳細は、https://kubernetes.io/docs/concepts/workloads/controllers/cron-jobs/#time-zones を参照してください。 |
6.1.2. .spec.jobTemplate リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- JobTemplateSpec は、テンプレートから作成されたときにジョブが持つべきデータを記述します
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
| このテンプレートから作成されたジョブの標準オブジェクトのメタデータ。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。 | |
|
| JobSpec は、ジョブの実行がどのようになるかを記述します。 |
6.1.3. .spec.jobTemplate.spec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- JobSpec は、ジョブの実行がどのようになるかを記述します。
- 型
-
object
- 必須
-
template
-
プロパティー | 型 | 説明 |
---|---|---|
|
| システムがジョブを終了しようとする前に、ジョブが継続的にアクティブになる可能性がある startTime を基準とした秒単位の期間を指定します。値は正の整数でなければなりません。ジョブが (作成時または更新中に) 一時停止になった場合、このタイマーは事実上停止となり、ジョブが再開したときにリセットされます。 |
|
| このジョブを失敗とマークするまでの再試行回数を指定します。デフォルトは 6 です。 |
|
|
このインデックスを失敗としてマークするまでの、インデックス内における再試行回数の制限を指定します。有効にすると、インデックスごとの失敗回数が Pod の batch.kubernetes.io/job-index-failure-count アノテーションに保持されます。これは、ジョブの completionMode=Indexed で、Pod の再起動ポリシーが Never の場合にのみ設定できます。このフィールドはイミュータブルです。このフィールドはアルファレベルです。 |
|
|
completionMode は、Pod の完了を追跡する方法を指定します。
今後、さらに多くの完了モードを追加できます。ジョブコントローラーが認識できないモードを確認した場合、コントローラーはジョブの更新をスキップします。
可能な列挙値: |
|
| ジョブを実行するために正常に終了した Pod の希望数を指定します。null に設定すると、任意の Pod の成功がすべての Pod の成功を示し、並列処理に正の値を設定できるようになります。1 に設定すると、並列処理が 1 に制限され、その Pod の成功がジョブの成功を示します。詳細: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/ |
|
|
manualSelector は、Pod ラベルと Pod セレクターの生成を制御します。何をしているのかわからない場合は、 |
|
|
backoffLimitPerIndex が設定されている場合、ジョブを失敗としてマークするまでの失敗したインデックスの最大数を指定します。失敗したインデックスの数がこの数を超えると、ジョブ全体が Failed としてマークされ、実行が終了します。null のままにすると、ジョブはすべてのインデックスの実行を続行し、ジョブ状態は |
|
| ジョブが任意の時点で実行する必要のある Pod の最大数を指定します。定常状態で実行している Pod の実際の数は、((.spec.completions - .status.successful) < .spec.parallelism) の場合、つまり、実行する必要のある作業が最大並列処理より少ない場合は、この数より少なくなります。詳細: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/ |
|
| PodFailurePolicy は、失敗した Pod が backoffLimit にどのように影響するかを説明します。 |
|
| podReplacementPolicy は、代替 Pod をいつ作成するか指定します。可能な値は次のとおりです。- TerminatingOrFailed : Pod が終了中 (metadata.deletionTimestamp がある) または失敗したときに Pod が再作成されます。- Failed: 以前に作成された Pod が完全に終了する (フェーズが Failed または Succeeded になる) まで待機してから代替 Pod を作成します。 podFailurePolicy を使用する場合、許可される値は Failed のみです。podFailurePolicy が使用されていない場合、許可される値は TerminatingOrFailed と Failed です。これはアルファフィールドです。このフィールドを使用できるように、JobPodReplacementPolicy を有効にします。
可能な列挙値: - |
| Pod 数と一致する必要がある Pod に対するラベルクエリー。通常、システムはこのフィールドを設定します。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors | |
|
| suspend は、Job コントローラーが Pod を作成するかどうかを指定します。suspend を true に設定して Job を作成すると、ジョブコントローラーは Pod を作成しません。作成後に Job が一時停止した場合 (つまり、フラグが false から true になる場合)、Job コントローラーはこの Job に関連付けられているすべてのアクティブな Pod を削除します。ユーザーは、これを適切に処理するようにワークロードを設計する必要があります。ジョブを一時停止すると、ジョブの StartTime フィールドがリセットされ、ActiveDeadlineSeconds タイマーも効果的にリセットされます。デフォルトは false です。 |
| ジョブの実行時に作成される Pod を説明します。使用できる template.spec.restartPolicy の値は "Never" または "OnFailure" のみです。詳細: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/ | |
|
| ttlSecondsAfterFinished は、実行が終了した (Complete または Failed のいずれか) Job の存続期間を制限します。このフィールドが設定されている場合、Job の終了後に ttlSecondsAfterFinished を設定すると、自動的に削除される可能性があります。ジョブが削除されると、そのライフサイクル保証 (ファイナライザーなど) が尊重されます。このフィールドが設定されていないと、ジョブが自動的に削除されません。このフィールドがゼロに設定されていると、ジョブは終了後すぐに削除できるようになります。 |
6.1.4. .spec.jobTemplate.spec.podFailurePolicy リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodFailurePolicy は、失敗した Pod が backoffLimit にどのように影響するかを説明します。
- 型
-
object
- 必須
-
rules
-
プロパティー | 型 | 説明 |
---|---|---|
|
| Pod 障害ポリシールールの一覧。ルールは順番に評価されます。ルールが Pod の障害に一致すると、残りのルールは無視されます。Pod の障害に一致するルールがない場合は、デフォルトの処理が適用されます。つまり、Pod の失敗のカウンターが増分され、backoffLimit に対してチェックされます。最大 20 個の要素が許可されます。 |
|
| PodFailurePolicyRule は、要件が満たされた場合に Pod の障害がどのように処理されるかを記述します。各ルールでは、onExitCodes と onPodConditions のいずれか 1 つを使用できますが、両方は使用できません。 |
6.1.5. .spec.jobTemplate.spec.podFailurePolicy.rules リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod 障害ポリシールールの一覧。ルールは順番に評価されます。ルールが Pod の障害に一致すると、残りのルールは無視されます。Pod の障害に一致するルールがない場合は、デフォルトの処理が適用されます。つまり、Pod の失敗のカウンターが増分され、backoffLimit に対してチェックされます。最大 20 個の要素が許可されます。
- 型
-
array
6.1.6. .spec.jobTemplate.spec.podFailurePolicy.rules[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodFailurePolicyRule は、要件が満たされた場合に Pod の障害がどのように処理されるかを記述します。各ルールでは、onExitCodes と onPodConditions のいずれか 1 つを使用できますが、両方は使用できません。
- 型
-
object
- 必須
-
action
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 要件が満たされた場合に Pod の障害に対して実行されるアクションを指定します。可能な値は次のとおりです。
- FailJob: Pod のジョブが Failed としてマークされ、実行中のすべての Pod が終了したことを示します。- FailIndex: Pod のインデックスが Failed としてマークされ、再起動されないことを示します。この値はアルファレベルです。これは、
可能な列挙値: - |
|
| PodFailurePolicyOnExitCodesRequirement は、コンテナー終了コードに基づいて失敗した Pod を処理するための要件を説明します。特に、各アプリケーションコンテナーの .state.termination.exitCode と init コンテナーのステータスを検索します。これは、Pod ステータスの .status.containerStatuses フィールドと .status.initContainerStatuses フィールドをそれぞれ検索します。正常に完了したコンテナー (終了コード 0) は、要件チェックから除外されます。 |
|
| Pod の条件に関する要件を表します。要件は Pod 条件パターンのリストとして表されます。少なくとも 1 つのパターンが実際の Pod の状態と一致する場合、要件は満たされます。最大 20 個の要素が許可されます。 |
|
| PodFailurePolicyOnPodConditionsPattern は、実際の Pod 条件タイプと一致するパターンを記述します。 |
6.1.7. .spec.jobTemplate.spec.podFailurePolicy.rules[].onExitCodes リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodFailurePolicyOnExitCodesRequirement は、コンテナー終了コードに基づいて失敗した Pod を処理するための要件を説明します。特に、各アプリケーションコンテナーの .state.termination.exitCode と init コンテナーのステータスを検索します。これは、Pod ステータスの .status.containerStatuses フィールドと .status.initContainerStatuses フィールドをそれぞれ検索します。正常に完了したコンテナー (終了コード 0) は、要件チェックから除外されます。
- 型
-
object
- 必須
-
operator
-
values
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 終了コードのチェックを指定された名前のコンテナーに制限します。null の場合、ルールはすべてのコンテナーに適用されます。指定する場合、Pod テンプレート内のコンテナー名または initContainer 名のいずれかと一致する必要があります。 |
|
| コンテナー終了コードと指定された値の関係を表します。正常に完了したコンテナー (終了コード 0) は、要件チェックから除外されます。可能な値は次のとおりです。 - In: 少なくとも 1 つのコンテナーの終了コードが指定の値のセット内にある場合、要件は満たされます ('containerName' フィールドからの制限がないコンテナーが複数ある場合は、複数の終了コードが存在する可能性があります)。- NotIn: 少なくとも 1 つのコンテナーの終了コードが指定の値のセット内にない場合、要件は満たされます ('containerName' フィールドからの制限がないコンテナーが複数ある場合は、複数の終了コードが存在する可能性があります)。その他の値は、今後追加される予定です。クライアントは、要件が満たされていないことを前提として、不明な演算子に対応する必要があります。
使用可能な列挙値: - |
|
| 値のセットを指定します。返された各コンテナー終了コードは、この値のセットに対して、演算子に関するチェックを行います (複数のコンテナーがある場合は複数存在する可能性があります)。値のリストは順序付けする必要があり、重複を含めることはできません。値 '0' は、In 演算子に使用できません。少なくとも 1 つの要素が必要です。最大 255 個の要素が許可されます。 |
6.1.8. .spec.jobTemplate.spec.podFailurePolicy.rules[].onPodConditions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod の条件に関する要件を表します。要件は Pod 条件パターンのリストとして表されます。少なくとも 1 つのパターンが実際の Pod の状態と一致する場合、要件は満たされます。最大 20 個の要素が許可されます。
- 型
-
array
6.1.9. .spec.jobTemplate.spec.podFailurePolicy.rules[].onPodConditions[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodFailurePolicyOnPodConditionsPattern は、実際の Pod 条件タイプと一致するパターンを記述します。
- 型
-
object
- 必須
-
type
-
status
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 必要な Pod の条件ステータスを指定します。Pod 条件と一致するには、指定されたステータスが Pod 条件ステータスと等しい必要があります。デフォルトは True です。 |
|
| 必要な Pod 条件タイプを指定します。Pod 条件と一致するには、指定されたタイプが Pod 条件タイプと等しい必要があります。 |
6.1.10. .status リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- CronJobStatus は、cron ジョブの現在の状態を表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
| 現在実行中のジョブへのポインターのリスト。 | |
| time | この Job が最後に正常にスケジュールされた時刻情報。 |
| time | この Job が最後に正常に完了した時刻情報。 |
6.2. API エンドポイント リンクのコピーリンクがクリップボードにコピーされました!
以下の API エンドポイントを利用できます。
/apis/batch/v1/cronjobs
-
GET
: CronJob 種類のオブジェクトをリスト表示または監視します
-
/apis/batch/v1/watch/cronjobs
-
GET
: CronJob のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
-
/apis/batch/v1/namespaces/{namespace}/cronjobs
-
削除
: CronJob のコレクションを削除する -
GET
: CronJob 種類のオブジェクトをリスト表示または監視します -
POST
: CronJob を作成する
-
/apis/batch/v1/watch/namespaces/{namespace}/cronjobs
-
GET
: CronJob のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
-
/apis/batch/v1/namespaces/{namespace}/cronjobs/{name}
-
DELETE
: CronJob を削除する -
GET
: 指定された CronJob を読み取る -
PATCH
: 指定された CronJob を部分的に更新します -
PUT
: 指定された CronJob を置き換える
-
/apis/batch/v1/watch/namespaces/{namespace}/cronjobs/{name}
-
GET
: CronJob 種類のオブジェクトへの変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用し、'fieldSelector' パラメーターで単一の項目にフィルター処理します。
-
/apis/batch/v1/namespaces/{namespace}/cronjobs/{name}/status
-
GET
: 指定された CronJob のステータスを読み取る -
PATCH
: 指定された CronJob のステータスを部分的に更新します -
PUT
: 指定された CronJob のステータスを置き換えます
-
6.2.1. /apis/batch/v1/cronjobs リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- CronJob 種類のオブジェクトをリスト表示または監視する
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
6.2.2. /apis/batch/v1/watch/cronjobs リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- CronJob のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
6.2.3. /apis/batch/v1/namespaces/{namespace}/cronjobs リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
DELETE
- 説明
- CronJob のコレクションを削除する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
GET
- 説明
- CronJob 種類のオブジェクトをリスト表示または監視する
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
POST
- 説明
- CronJob を作成する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
6.2.4. /apis/batch/v1/watch/namespaces/{namespace}/cronjobs リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- CronJob のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
6.2.5. /apis/batch/v1/namespaces/{namespace}/cronjobs/{name} リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| CronJob の名前 |
- HTTP メソッド
-
DELETE
- 説明
- CronJob を削除する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
202 - Accepted |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
GET
- 説明
- 指定された CronJob を読み取る
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PATCH
- 説明
- 指定された CronJob を部分的に更新する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PUT
- 説明
- 指定された CronJob を置き換える
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
6.2.6. /apis/batch/v1/watch/namespaces/{namespace}/cronjobs/{name} リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| CronJob の名前 |
- HTTP メソッド
-
GET
- 説明
- CronJob 種類のオブジェクトへの変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用し、'fieldSelector' パラメーターで単一の項目にフィルター処理します。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
6.2.7. /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}/status リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| CronJob の名前 |
- HTTP メソッド
-
GET
- 説明
- 指定された CronJob のステータスを読み取る
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PATCH
- 説明
- 指定された CronJob のステータスを部分的に更新します
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PUT
- 説明
- 指定された CronJob のステータスを置き換える
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
第7章 DaemonSet [apps/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DaemonSet は、デーモンセットの設定を表します。
- 型
-
object
7.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 を参照してください。 | |
|
| DaemonSetSpec は、デーモンセットの仕様です。 |
|
| DaemonSetStatus は、デーモンセットの現在のステータスを表します。 |
7.1.1. .spec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DaemonSetSpec は、デーモンセットの仕様です。
- 型
-
object
- 必須
-
selector
-
template
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 新しく作成された DaemonSet Pod が使用可能であると見なされるために、コンテナーがクラッシュすることなく準備ができる最小秒数。デフォルトは 0 です (Pod は準備ができ次第利用可能と見なされます)。 |
|
| ロールバックを可能にするために保持する古い履歴の数。これは、明示的なゼロと指定されていないものを区別するためのポインターです。デフォルトは 10 です。 |
| デーモンセットにより管理される Pod に対するラベルクエリー。制御されるには一致する必要があります。Pod テンプレートのラベルと一致する必要があります。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors | |
| 作成される Pod を説明するオブジェクト。DaemonSet は、テンプレートのノードセレクターに一致するすべてのノード (またはノードセレクターが指定されていない場合はすべてのノード) に、この Pod のコピーを 1 つだけ作成する。許可される template.spec.restartPolicy 値は "Always" のみです。詳細: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller#pod-template | |
|
| DaemonSetUpdateStrategy は、DaemonSet の更新戦略を制御するのに使用される構造体です。 |
7.1.2. .spec.updateStrategy リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DaemonSetUpdateStrategy は、DaemonSet の更新戦略を制御するのに使用される構造体です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| デーモンセットのローリング更新の望ましい動作を制御するための仕様。 |
|
| デーモンセットの更新のタイプ。"RollingUpdate" または "OnDelete" にすることができます。デフォルトは RollingUpdate です。
使用可能な列挙値: - |
7.1.3. .spec.updateStrategy.rollingUpdate リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- デーモンセットのローリング更新の望ましい動作を制御するための仕様。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
| 更新中に更新された DaemonSet Pod を持つことができる既存の利用可能な DaemonSet Pod を持つノードの最大数。値は、絶対数 (例:5) または目的の Pod のパーセンテージ (例:10%) にすることができます。MaxUnavailable が 0 の場合、これを 0 にすることはできません。絶対数は、最小値 1 に切り上げてパーセンテージから計算されます。デフォルト値は 0 です。例: これが 30% に設定されている場合は、デーモン Pod (つまり status.desiredNumberScheduled) を実行する必要があるノードの総数の最大 30% で、古い Pod が削除済みとしてマークされる前に新しい Pod を作成できます。更新は、ノードの 30% で新しい Pod を起動することから始まります。更新された Pod が利用可能になると (少なくとも minReadySeconds の準備ができたら)、そのノードの古い DaemonSetPod は削除済みとしてマークされます。古い Pod が何らかの理由で使用できなくなった場合 (Ready が false に移行した場合、削除された場合、またはドレイン (解放) された場合)、サージ制限を考慮せずに、更新された Pod がそのノードに即座に作成されます。サージを許可することは、readiness チェックが失敗した場合に任意のノードのデーモンセットによって消費されるリソースが 2 倍になる可能性があることを意味します。したがって、リソースを大量に消費するデーモンセットは、中断中にエビクションを引き起こす可能性があることを考慮に入れる必要があります。 | |
| 更新中に使用できなくなる可能性のある DaemonSet Pod の最大数。値は、絶対数 (例: 5) または更新開始時の DaemonSet Pod の総数のパーセンテージ (例: 10%) にすることができます。絶対数は、端数を切り上げてパーセンテージから計算されます。MaxSurge が 0 の場合、これを 0 にすることはできません。デフォルト値は 1 です。例: これが 30% に設定されている場合は、デーモン Pod (つまり status.desiredNumberScheduled) を実行する必要があるノードの総数の最大 30% で、いつでも更新のために Pod を停止できます。更新は、これらの DaemonSet Pod の最大 30% を停止することから始まり、代わりに新しい DaemonSet Pod を起動します。新しい Pod が使用可能になると、他の DaemonSetPod に進みます。これにより、更新中は常に元の数の DaemonSetPod の 70% 以上が使用可能になります。 |
7.1.4. .status リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DaemonSetStatus は、デーモンセットの現在のステータスを表します。
- 型
-
object
- 必須
-
currentNumberScheduled
-
numberMisscheduled
-
desiredNumberScheduled
-
numberReady
-
プロパティー | 型 | 説明 |
---|---|---|
|
| DaemonSet のハッシュ競合の数。DaemonSet コントローラーは、最新の ControllerRevision の名前を作成する必要がある場合に、このフィールドを競合回避メカニズムとして使用します。 |
|
| DaemonSet の現在の状態の最新の利用可能な観測を表します。 |
|
| DaemonSetCondition は、特定の時点での DaemonSet の状態を記述します。 |
|
| 少なくとも 1 つのデーモン Pod を実行していて、デーモン Pod を実行することになっているノードの数。詳細: https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/ |
|
| デーモン Pod を実行する必要があるノードの総数 (デーモン Pod を正しく実行しているノードを含む)。詳細: https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/ |
|
| デーモン Pod を実行し、1 つ以上のデーモン Pod を実行して使用可能にする必要があるノードの数 (少なくとも spec.minReadySeconds の準備ができている) |
|
| デーモン Pod を実行しているが、デーモン Pod を実行することは想定されていないノードの数。詳細: https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/ |
|
| numberReady は、デーモン Pod を実行している必要があり、1 つ以上のデーモン Pod が Ready Condition で実行されているノードの数です。 |
|
| デーモン Pod を実行している必要があり、デーモン Pod が実行されておらず、使用可能になっていないノードの数 (少なくとも spec.minReadySeconds の準備ができている) |
|
| デーモンセットコントローラーによって監視された最新の世代。 |
|
| 更新されたデーモン Pod を実行しているノードの総数 |
7.1.5. .status.conditions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DaemonSet の現在の状態の最新の利用可能な観測を表します。
- 型
-
array
7.1.6. .status.conditions[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DaemonSetCondition は、特定の時点での DaemonSet の状態を記述します。
- 型
-
object
- 必須
-
type
-
status
-
プロパティー | 型 | 説明 |
---|---|---|
| time | 最後にある状態から別の状態に遷移した時間。 |
|
| 遷移の詳細を示す人が判読できるメッセージ。 |
|
| 条件の最後の遷移の理由。 |
|
| 状態のステータス (True、False、Unknown のいずれか)。 |
|
| DaemonSet 条件のタイプ。 |
7.2. API エンドポイント リンクのコピーリンクがクリップボードにコピーされました!
以下の API エンドポイントを利用できます。
/apis/apps/v1/daemonsets
-
GET
: DaemonSet 種類のオブジェクトをリスト表示または監視する
-
/apis/apps/v1/watch/daemonsets
-
GET
: DaemonSet のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
-
/apis/apps/v1/namespaces/{namespace}/daemonsets
-
DELETE
: DaemonSet のコレクションを削除する -
GET
: DaemonSet 種類のオブジェクトをリスト表示または監視する -
POST
:DaemonSet を作成する
-
/apis/apps/v1/watch/namespaces/{namespace}/daemonsets
-
GET
: DaemonSet のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
-
/apis/apps/v1/namespaces/{namespace}/daemonsets/{name}
-
DELETE
: DaemonSet を削除する -
GET
: 指定された DaemonSet を読み取る -
PATCH
: 指定された DaemonSet を部分的に更新する -
PUT
: 指定された DaemonSet を置き換える
-
/apis/apps/v1/watch/namespaces/{namespace}/daemonsets/{name}
-
GET
: DaemonSet 種類のオブジェクトへの変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用し、'fieldSelector' パラメーターで単一の項目にフィルター処理します。
-
/apis/apps/v1/namespaces/{namespace}/daemonsets/{name}/status
-
GET
: 指定された DaemonSet のステータスを読み取る -
PATCH
: 指定された DaemonSet のステータスを部分的に更新します -
PUT
: 指定された DaemonSet のステータスを置き換える
-
7.2.1. /apis/apps/v1/daemonsets リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- DaemonSet 種類のオブジェクトをリスト表示または監視する
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
7.2.2. /apis/apps/v1/watch/daemonsets リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- DaemonSet のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
7.2.3. /apis/apps/v1/namespaces/{namespace}/daemonsets リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
DELETE
- 説明
- DaemonSet のコレクションを削除する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
GET
- 説明
- DaemonSet 種類のオブジェクトをリスト表示または監視する
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
POST
- 説明
- DaemonSet を作成します。
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
7.2.4. /apis/apps/v1/watch/namespaces/{namespace}/daemonsets リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- DaemonSet のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
7.2.5. /apis/apps/v1/namespaces/{namespace}/daemonsets/{name} リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| DaemonSet の名前 |
- HTTP メソッド
-
DELETE
- 説明
- DaemonSet を削除する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
202 - Accepted |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
GET
- 説明
- 指定された DaemonSet を読み取る
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PATCH
- 説明
- 指定された DaemonSet を部分的に更新する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PUT
- 説明
- 指定された DaemonSet を置き換える
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
7.2.6. /apis/apps/v1/watch/namespaces/{namespace}/daemonsets/{name} リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| DaemonSet の名前 |
- HTTP メソッド
-
GET
- 説明
- DaemonSet 種類のオブジェクトへの変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用し、'fieldSelector' パラメーターで単一の項目にフィルター処理します。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
7.2.7. /apis/apps/v1/namespaces/{namespace}/daemonsets/{name}/status リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| DaemonSet の名前 |
- HTTP メソッド
-
GET
- 説明
- 指定された DaemonSet のステータスを読み取る
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PATCH
- 説明
- 指定された DaemonSet のステータスを部分的に更新する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PUT
- 説明
- 指定された DaemonSet のステータスを置き換える
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
第8章 Deployment [apps/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- デプロイメントにより、Pod と ReplicaSets の宣言型更新が可能になります。
- 型
-
object
8.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 を参照してください。 | |
|
| DeploymentSpec は、デプロイメントの望ましい動作の仕様です。 |
|
| DeploymentStatus は、Deployment の最後に観察されたステータスです。 |
8.1.1. .spec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DeploymentSpec は、デプロイメントの望ましい動作の仕様です。
- 型
-
object
- 必須
-
selector
-
template
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 新しく作成された Pod が使用可能であると見なされるために、コンテナーがクラッシュすることなく準備ができる最小秒数。デフォルトは 0 です (Pod は準備ができ次第利用可能と見なされます) |
|
| デプロイメントが一時停止されていることを示します。 |
|
| デプロイメントが失敗したと見なされる前に、デプロイメントが進行するまでの最大時間 (秒単位)。デプロイメントコントローラーは失敗したデプロイメントの処理を続行し、ProgressDeadlineExceeded 理由のある条件がデプロイメントステータスに表示されます。デプロイメントが一時停止している間は、進行状況は推定されないことに注意してください。デフォルトは 600 秒です。 |
|
| 必要な Pod の数。これは、明示的なゼロと指定されていないものを区別するためのポインターです。デフォルトは 1 です。 |
|
| ロールバックを可能にするために保持する古い ReplicaSet の数。これは、明示的なゼロと指定されていないものを区別するためのポインターです。デフォルトは 10 です。 |
| Pod のラベルセレクター。これによって Pod が選択される既存の ReplicaSet は、このデプロイメントの影響を受けるものになります。Pod テンプレートのラベルと一致する必要があります。 | |
|
| DeploymentStrategy は、既存の Pod を新しい Pod に置き換える方法を説明しています。 |
| テンプレートには、作成される Pod が記述されています。許可される template.spec.restartPolicy 値は "Always" のみです。 |
8.1.2. .spec.strategy リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DeploymentStrategy は、既存の Pod を新しい Pod に置き換える方法を説明しています。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ローリング更新の望ましい動作を制御するための仕様。 |
|
| デプロイメントのタイプ。"Recreate" または "RollingUpdate" にすることができます。デフォルトは RollingUpdate です。
使用可能な列挙値: - |
8.1.3. .spec.strategy.rollingUpdate リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ローリング更新の望ましい動作を制御するための仕様。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
| 希望する Pod 数を超えてスケジュールできる Pod の最大数。値は、絶対数 (例:5) または目的の Pod のパーセンテージ (例:10%) にすることができます。MaxUnavailable が 0 の場合、これを 0 にすることはできません。絶対数は、端数を切り上げてパーセンテージから計算されます。デフォルトは 25% です。例: これが 30% に設定されている場合、ローリング更新の開始時に新しい ReplicaSet をすぐにスケールアップして、新旧の Pod の総数が目的の Pod の 130% を超えないようにすることができます。古い Pod が強制終了されると、新しい ReplicaSet をさらにスケールアップして、更新中にいつでも実行されている Pod の総数が目的の Pod の最大 130% になるようにすることができます。 | |
| 更新中に使用できなくなる可能性のある Pod の最大数。値は、絶対数 (例:5) または目的の Pod のパーセンテージ (例:10%) にすることができます。絶対数は、端数を切り捨ててパーセンテージから計算されます。MaxSurge が 0 の場合、これを 0 にすることはできません。デフォルトは 25% です。例: これが 30% に設定されている場合、ローリング更新が開始されるとすぐに、古い ReplicaSet を目的の Pod の 70% に縮小できます。新しい Pod の準備ができたら、古い ReplicaSet をさらにスケールダウンしてから、新しい ReplicaSet をスケールアップして、更新中に常に使用可能な Pod の総数が目的の Pod の少なくとも 70% になるようにします。 |
8.1.4. .status リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DeploymentStatus は、Deployment の最後に観察されたステータスです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| このデプロイメントの対象となる利用可能な Pod の総数 (少なくとも minReadySeconds の準備ができています)。 |
|
| Deployment のハッシュ競合の数。Deployment コントローラーは、最新の ReplicaSet の名前を作成する必要がある場合に、このフィールドを競合回避メカニズムとして使用します。 |
|
| デプロイメントの現在の状態の最新の利用可能な観測を表します。 |
|
| DeploymentCondition は、特定の時点でのデプロイメントの状態を記述します。 |
|
| デプロイメントコントローラーにより監視される世代。 |
|
| readyReplicas は、このデプロイの対象となる Ready Condition 状態の Pod の数です。 |
|
| このデプロイメントの対象となる非終了 Pod の総数 (ラベルはセレクターと一致します)。 |
|
| このデプロイメントの対象となる使用できない Pod の総数。これは、デプロイメントで 100% の使用可能な容量を確保するために必要な Pod の総数です。それらは、実行されているがまだ利用できない Pod か、まだ作成されていない Pod のいずれかです。 |
|
| 目的のテンプレート仕様を持つ、このデプロイメントの対象となる非終了 Pod の総数。 |
8.1.5. .status.conditions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- デプロイメントの現在の状態の最新の利用可能な観測を表します。
- 型
-
array
8.1.6. .status.conditions[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DeploymentCondition は、特定の時点でのデプロイメントの状態を記述します。
- 型
-
object
- 必須
-
type
-
status
-
プロパティー | 型 | 説明 |
---|---|---|
| time | 最後にある状態から別の状態に遷移した時間。 |
| time | この状態が最後に更新された時刻。 |
|
| 遷移の詳細を示す人が判読できるメッセージ。 |
|
| 条件の最後の遷移の理由。 |
|
| 状態のステータス (True、False、Unknown のいずれか)。 |
|
| デプロイメント条件のタイプ。 |
8.2. API エンドポイント リンクのコピーリンクがクリップボードにコピーされました!
以下の API エンドポイントを利用できます。
/apis/apps/v1/deployments
-
GET
: Deployment 種類のオブジェクトをリスト表示または監視する
-
/apis/apps/v1/watch/deployments
-
GET
: Deployment のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
-
/apis/apps/v1/namespaces/{namespace}/deployments
-
DELETE
: Deployment のコレクションを削除する -
GET
: Deployment 種類のオブジェクトをリスト表示または監視する -
POST
: Deployment を作成する
-
/apis/apps/v1/watch/namespaces/{namespace}/deployments
-
GET
: Deployment のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
-
/apis/apps/v1/namespaces/{namespace}/deployments/{name}
-
DELETE
: Deployment を削除する -
GET
: 指定された Deployment を読み取る -
PATCH
: 指定された Deployment を部分的に更新する -
PUT
: 指定されたデプロイメントを置き換える
-
/apis/apps/v1/watch/namespaces/{namespace}/deployments/{name}
-
GET
: Deployment 種類のオブジェクトへの変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用し、'fieldSelector' パラメーターで単一の項目にフィルター処理します。
-
/apis/apps/v1/namespaces/{namespace}/deployments/{name}/status
-
GET
: 指定されたデプロイメントのステータスを読み取る -
PATCH
: 指定された Deployment のステータスを部分的に更新する -
PUT
: 指定された Deployment のステータスを置き換える
-
8.2.1. /apis/apps/v1/deployments リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- Deployment 種類のオブジェクトをリスト表示または監視する
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
8.2.2. /apis/apps/v1/watch/deployments リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- Deployment のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
8.2.3. /apis/apps/v1/namespaces/{namespace}/deployments リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
DELETE
- 説明
- Deployment のコレクションを削除する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
GET
- 説明
- Deployment 種類のオブジェクトをリスト表示または監視する
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
POST
- 説明
- デプロイメントを作成する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
202 - Accepted |
|
401 - Unauthorized | 空白 |
8.2.4. /apis/apps/v1/watch/namespaces/{namespace}/deployments リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- Deployment のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
8.2.5. /apis/apps/v1/namespaces/{namespace}/deployments/{name} リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| デプロイメントの名前。 |
- HTTP メソッド
-
DELETE
- 説明
- デプロイメントを削除する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
202 - Accepted |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
GET
- 説明
- 指定された Deployment を読み取る
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PATCH
- 説明
- 指定された Deployment を読み込む。
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PUT
- 説明
- 指定されたデプロイメントを置き換える
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
8.2.6. /apis/apps/v1/watch/namespaces/{namespace}/deployments/{name} リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| デプロイメントの名前。 |
- HTTP メソッド
-
GET
- 説明
- Deployment 種類のオブジェクトへの変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用し、'fieldSelector' パラメーターで単一の項目にフィルター処理します。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
8.2.7. /apis/apps/v1/namespaces/{namespace}/deployments/{name}/status リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| デプロイメントの名前。 |
- HTTP メソッド
-
GET
- 説明
- 指定された Deployment のステータスを読み取る
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PATCH
- 説明
- 指定された Deployment のステータスを部分的に更新する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PUT
- 説明
- 指定された Deployment のステータスを置き換える
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
第9章 DeploymentConfig [apps.openshift.io/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
Deployment Configs は、Pod のテンプレートを定義し、新しいイメージのデプロイまたは設定の変更を管理します。単一のデプロイメント設定は通常、単一のマイクロサービスに類似しています。完全な再起動、カスタマイズ可能なローリング更新、完全にカスタム化された動作、デプロイメント前およびデプロイメント後のフックなど、さまざまなデプロイメントパターンをサポートできます。個々のデプロイメントは、レプリケーションコントローラーとして表されます。
デプロイメントは、その設定が変更されたとき、またはイメージストリーム内のタグが変更されたときに "トリガー" されます。トリガーを無効にして、デプロイメントを手動で制御できるようにすることができます。"strategy" は、デプロイメントの実行方法を決定し、いつでも変更できます。
latestVersion
フィールドは、何らかの方法で新しいデプロイメントがトリガーされたときに更新されます。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。非推奨: Pod の宣言的更新には、デプロイメントまたはその他の手段を使用してください。
- 型
-
object
- 必須
-
spec
-
9.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 を参照してください。 |
| metadata は標準オブジェクトのメタデータです。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。 | |
|
| DeploymentConfigSpec は、デプロイメントの望ましい状態を表します。 |
|
| DeploymentConfigStatus は、現在のデプロイメント状態を表します。 |
9.1.1. .spec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DeploymentConfigSpec は、デプロイメントの望ましい状態を表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| MinReadySeconds は、新しく作成された Pod が使用可能であると見なされるために、コンテナーがクラッシュすることなく準備ができる最小秒数。デフォルトは 0 です (Pod は準備ができ次第利用可能と見なされます) |
|
| Paused は、デプロイメント設定が一時停止され、テンプレートの変更または他のトリガーにより引き起こされたテンプレートの変更に新しいデプロイメントが発生しないことを示します。 |
|
| レプリカは、必要なレプリカの数です。 |
|
| RevisionHistoryLimit は、ロールバックを可能にするために保持する古い ReplicationController の数です。このフィールドは、明示的なゼロと、指定されていないものを区別できるようにするためのポインターです。デフォルトは 10 です。(これは、レガシーリソースではなく、新しいグループの API リソースを介して作成された DeploymentConfig にのみ適用されます。) |
|
| Selector は、Replicas 数と一致する必要がある Pod に対するラベルクエリーです。 |
|
| DeploymentStrategy は、デプロイメントを実行する方法を説明します。 |
| テンプレートは、不十分なレプリカが検出された場合に作成される Pod を説明するオブジェクトです。 | |
|
| テストでは、デプロイメントの実行中を除いて、このデプロイメント設定のレプリカがゼロであることを確認します。これにより、デプロイメント設定を継続的なデプロイメントテストとして使用できます。つまり、イメージでトリガーし、デプロイメントを実行してから、成功または失敗します。ポストストラテジーフックと After アクションを使用して、デプロイメントの成功をアクションと統合できます。 |
|
| トリガーは、DeploymentConfig の更新によって新しいデプロイメントがどのように発生するかを決定します。トリガーが定義されていない場合、新しいデプロイメントは、新しい LatestVersion を使用した DeploymentConfig への明示的なクライアント更新の結果としてのみ発生します。null の場合、デフォルトで設定変更トリガーが設定されます。 |
|
| DeploymentTriggerPolicy は、新しいデプロイメントをもたらす単一のトリガーのポリシーを記述します。 |
9.1.2. .spec.strategy リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DeploymentStrategy は、デプロイメントを実行する方法を説明します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ActiveDeadlineSeconds は、システムがアクティブに終了を試みる前に、このデプロイメント設定のデプロイヤー Pod がノード上でアクティブになる可能性がある秒単位の期間です。 |
|
| Annotations は、カスタムデプロイヤーとライフサイクルのプレ/ポストフック Pod に追加されるキーと値のペアのセットです。 |
|
| CustomDeploymentStrategyParams は、カスタムデプロイメント戦略への入力です。 |
|
| ラベルは、カスタムデプロイヤーとライフサイクルのプレ/ポストフック Pod に追加されるキーと値のペアのセットです。 |
|
| RecreateDeploymentStrategyParams は、Recreate デプロイメント戦略への入力です。 |
| リソースには、デプロイメントおよびフックを実行するためのリソース要件が含まれています。 | |
|
| RollingDeploymentStrategyParams は、Rolling デプロイメント戦略への入力です。 |
|
| タイプは、デプロイメント戦略の名前です。 |
9.1.3. .spec.strategy.customParams リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- CustomDeploymentStrategyParams は、カスタムデプロイメント戦略への入力です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Command は任意であり、コンテナーイメージの CMD を上書きします。 |
| 環境は、イメージのコンテナーに与えられる環境を保持します。 | |
|
| イメージは、デプロイメントを実行できるコンテナーイメージを指定します。 |
9.1.4. .spec.strategy.recreateParams リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- RecreateDeploymentStrategyParams は、Recreate デプロイメント戦略への入力です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| LifecycleHook は、特定のデプロイメントライフサイクルアクションを定義します。一度に指定できるアクションのタイプは 1 つだけです。 |
|
| LifecycleHook は、特定のデプロイメントライフサイクルアクションを定義します。一度に指定できるアクションのタイプは 1 つだけです。 |
|
| LifecycleHook は、特定のデプロイメントライフサイクルアクションを定義します。一度に指定できるアクションのタイプは 1 つだけです。 |
|
| TimeoutSeconds は、更新を待ってからあきらめるまでの時間です。値が nil の場合は、デフォルトが使用されます。 |
9.1.5. .spec.strategy.recreateParams.mid リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LifecycleHook は、特定のデプロイメントライフサイクルアクションを定義します。一度に指定できるアクションのタイプは 1 つだけです。
- 型
-
object
- 必須
-
failurePolicy
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecNewPodHook は、デプロイメントテンプレートの一部であると想定される指定されたコンテナーに基づいて、新しい Pod でコマンドを実行するフック実装です。 |
|
| FailurePolicy は、フックが失敗した場合に実行するアクションを指定します。 |
|
| TagImages は、コンテナーの下で参照されている現在のイメージをイメージストリームタグにタグ付けするようにデプロイヤ-に指示します。 |
|
| TagImageHook は、特定のコンテナー内のイメージを ImageStreamTag にタグ付けするリクエストです。 |
9.1.6. .spec.strategy.recreateParams.mid.execNewPod リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecNewPodHook は、デプロイメントテンプレートの一部であると想定される指定されたコンテナーに基づいて、新しい Pod でコマンドを実行するフック実装です。
- 型
-
object
- 必須
-
command
-
containerName
-
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドは、アクションコマンドおよびその引数です。 |
|
| ContainerName は、デプロイメント Pod テンプレート内のコンテナーの名前であり、そのコンテナーイメージはフック Pod のコンテナーに使用されます。 |
| Env は、フック Pod のコンテナーに提供する環境変数のセットです。 | |
|
| ボリュームは、フック Pod にコピーする必要がある Pod テンプレートからの名前付きボリュームのリストです。Pod 仕様にないボリューム名は無視されます。空のリストは、ボリュームがコピーされないことを意味します。 |
9.1.7. .spec.strategy.recreateParams.mid.tagImages リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TagImages は、コンテナーの下で参照されている現在のイメージをイメージストリームタグにタグ付けするようにデプロイヤ-に指示します。
- 型
-
array
9.1.8. .spec.strategy.recreateParams.mid.tagImages[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TagImageHook は、特定のコンテナー内のイメージを ImageStreamTag にタグ付けするリクエストです。
- 型
-
object
- 必須
-
containerName
-
to
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ContainerName は、イメージ値がタグのソースとして使用されるデプロイメント設定内のコンテナーの名前です。コンテナーが 1 つしかない場合、この値はデフォルトでそのコンテナーの名前になります。 |
| To は、コンテナーのイメージを設定するターゲット ImageStreamTag です。 |
9.1.9. .spec.strategy.recreateParams.post リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LifecycleHook は、特定のデプロイメントライフサイクルアクションを定義します。一度に指定できるアクションのタイプは 1 つだけです。
- 型
-
object
- 必須
-
failurePolicy
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecNewPodHook は、デプロイメントテンプレートの一部であると想定される指定されたコンテナーに基づいて、新しい Pod でコマンドを実行するフック実装です。 |
|
| FailurePolicy は、フックが失敗した場合に実行するアクションを指定します。 |
|
| TagImages は、コンテナーの下で参照されている現在のイメージをイメージストリームタグにタグ付けするようにデプロイヤ-に指示します。 |
|
| TagImageHook は、特定のコンテナー内のイメージを ImageStreamTag にタグ付けするリクエストです。 |
9.1.10. .spec.strategy.recreateParams.post.execNewPod リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecNewPodHook は、デプロイメントテンプレートの一部であると想定される指定されたコンテナーに基づいて、新しい Pod でコマンドを実行するフック実装です。
- 型
-
object
- 必須
-
command
-
containerName
-
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドは、アクションコマンドおよびその引数です。 |
|
| ContainerName は、デプロイメント Pod テンプレート内のコンテナーの名前であり、そのコンテナーイメージはフック Pod のコンテナーに使用されます。 |
| Env は、フック Pod のコンテナーに提供する環境変数のセットです。 | |
|
| ボリュームは、フック Pod にコピーする必要がある Pod テンプレートからの名前付きボリュームのリストです。Pod 仕様にないボリューム名は無視されます。空のリストは、ボリュームがコピーされないことを意味します。 |
9.1.11. .spec.strategy.recreateParams.post.tagImages リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TagImages は、コンテナーの下で参照されている現在のイメージをイメージストリームタグにタグ付けするようにデプロイヤ-に指示します。
- 型
-
array
9.1.12. .spec.strategy.recreateParams.post.tagImages[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TagImageHook は、特定のコンテナー内のイメージを ImageStreamTag にタグ付けするリクエストです。
- 型
-
object
- 必須
-
containerName
-
to
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ContainerName は、イメージ値がタグのソースとして使用されるデプロイメント設定内のコンテナーの名前です。コンテナーが 1 つしかない場合、この値はデフォルトでそのコンテナーの名前になります。 |
| To は、コンテナーのイメージを設定するターゲット ImageStreamTag です。 |
9.1.13. .spec.strategy.recreateParams.pre リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LifecycleHook は、特定のデプロイメントライフサイクルアクションを定義します。一度に指定できるアクションのタイプは 1 つだけです。
- 型
-
object
- 必須
-
failurePolicy
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecNewPodHook は、デプロイメントテンプレートの一部であると想定される指定されたコンテナーに基づいて、新しい Pod でコマンドを実行するフック実装です。 |
|
| FailurePolicy は、フックが失敗した場合に実行するアクションを指定します。 |
|
| TagImages は、コンテナーの下で参照されている現在のイメージをイメージストリームタグにタグ付けするようにデプロイヤ-に指示します。 |
|
| TagImageHook は、特定のコンテナー内のイメージを ImageStreamTag にタグ付けするリクエストです。 |
9.1.14. .spec.strategy.recreateParams.pre.execNewPod リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecNewPodHook は、デプロイメントテンプレートの一部であると想定される指定されたコンテナーに基づいて、新しい Pod でコマンドを実行するフック実装です。
- 型
-
object
- 必須
-
command
-
containerName
-
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドは、アクションコマンドおよびその引数です。 |
|
| ContainerName は、デプロイメント Pod テンプレート内のコンテナーの名前であり、そのコンテナーイメージはフック Pod のコンテナーに使用されます。 |
| Env は、フック Pod のコンテナーに提供する環境変数のセットです。 | |
|
| ボリュームは、フック Pod にコピーする必要がある Pod テンプレートからの名前付きボリュームのリストです。Pod 仕様にないボリューム名は無視されます。空のリストは、ボリュームがコピーされないことを意味します。 |
9.1.15. .spec.strategy.recreateParams.pre.tagImages リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TagImages は、コンテナーの下で参照されている現在のイメージをイメージストリームタグにタグ付けするようにデプロイヤ-に指示します。
- 型
-
array
9.1.16. .spec.strategy.recreateParams.pre.tagImages[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TagImageHook は、特定のコンテナー内のイメージを ImageStreamTag にタグ付けするリクエストです。
- 型
-
object
- 必須
-
containerName
-
to
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ContainerName は、イメージ値がタグのソースとして使用されるデプロイメント設定内のコンテナーの名前です。コンテナーが 1 つしかない場合、この値はデフォルトでそのコンテナーの名前になります。 |
| To は、コンテナーのイメージを設定するターゲット ImageStreamTag です。 |
9.1.17. .spec.strategy.rollingParams リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- RollingDeploymentStrategyParams は、Rolling デプロイメント戦略への入力です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| IntervalSeconds は、更新後のデプロイメントステータスのポーリングの間に待機する時間です。値が nil の場合は、デフォルトが使用されます。 |
| MaxSurge は、元の Pod 数を超えてスケジュールできる Pod の最大数です。値は、絶対数 (例: 5) または更新開始時の Pod 全体のパーセンテージ (例: 10%) にすることができます。絶対数は、端数を切り上げてパーセンテージから計算されます。 MaxUnavailable が 0 の場合は、これを 0 にすることができません。デフォルトでは、25% が使用されます。 例: これが 30% に設定されている場合は、ローリング更新が開始するとすぐに新しい RC を 30% スケールアップできます。古い Pod が強制的に終了されると、新しい RC をさらにスケールアップして、更新中にいつでも実行されている Pod の総数が元の Pod の最大 130% になるようにすることができます。 | |
| MaxUnavailable は、更新中に使用できなくなる可能性のある Pod の最大数です。値は、絶対数 (例: 5) または更新開始時の Pod 全体のパーセンテージ (例: 10%) にすることができます。絶対数は、端数を切り捨ててパーセンテージから計算されます。 MaxSurge が 0 の場合は、これを 0 にすることはできません。デフォルトでは、25% が使用されます。 例: これが 30% に設定されている場合は、ローリング更新が開始されるとすぐに古い RC を 30% 縮小できます。新しい Pod の準備ができたら、古い RC をさらにスケールダウンしてから、新しい RC をスケールアップして、更新中に常に元の Pod 数の 70% 以上を使用できるようにします。 | |
|
| LifecycleHook は、特定のデプロイメントライフサイクルアクションを定義します。一度に指定できるアクションのタイプは 1 つだけです。 |
|
| LifecycleHook は、特定のデプロイメントライフサイクルアクションを定義します。一度に指定できるアクションのタイプは 1 つだけです。 |
|
| TimeoutSeconds は、更新を待ってからあきらめるまでの時間です。値が nil の場合は、デフォルトが使用されます。 |
|
| UpdatePeriodSeconds は、個々の Pod の更新の間に待機する時間です。値が nil の場合は、デフォルトが使用されます。 |
9.1.18. .spec.strategy.rollingParams.post リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LifecycleHook は、特定のデプロイメントライフサイクルアクションを定義します。一度に指定できるアクションのタイプは 1 つだけです。
- 型
-
object
- 必須
-
failurePolicy
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecNewPodHook は、デプロイメントテンプレートの一部であると想定される指定されたコンテナーに基づいて、新しい Pod でコマンドを実行するフック実装です。 |
|
| FailurePolicy は、フックが失敗した場合に実行するアクションを指定します。 |
|
| TagImages は、コンテナーの下で参照されている現在のイメージをイメージストリームタグにタグ付けするようにデプロイヤ-に指示します。 |
|
| TagImageHook は、特定のコンテナー内のイメージを ImageStreamTag にタグ付けするリクエストです。 |
9.1.19. .spec.strategy.rollingParams.post.execNewPod リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecNewPodHook は、デプロイメントテンプレートの一部であると想定される指定されたコンテナーに基づいて、新しい Pod でコマンドを実行するフック実装です。
- 型
-
object
- 必須
-
command
-
containerName
-
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドは、アクションコマンドおよびその引数です。 |
|
| ContainerName は、デプロイメント Pod テンプレート内のコンテナーの名前であり、そのコンテナーイメージはフック Pod のコンテナーに使用されます。 |
| Env は、フック Pod のコンテナーに提供する環境変数のセットです。 | |
|
| ボリュームは、フック Pod にコピーする必要がある Pod テンプレートからの名前付きボリュームのリストです。Pod 仕様にないボリューム名は無視されます。空のリストは、ボリュームがコピーされないことを意味します。 |
9.1.20. .spec.strategy.rollingParams.post.tagImages リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TagImages は、コンテナーの下で参照されている現在のイメージをイメージストリームタグにタグ付けするようにデプロイヤ-に指示します。
- 型
-
array
9.1.21. .spec.strategy.rollingParams.post.tagImages[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TagImageHook は、特定のコンテナー内のイメージを ImageStreamTag にタグ付けするリクエストです。
- 型
-
object
- 必須
-
containerName
-
to
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ContainerName は、イメージ値がタグのソースとして使用されるデプロイメント設定内のコンテナーの名前です。コンテナーが 1 つしかない場合、この値はデフォルトでそのコンテナーの名前になります。 |
| To は、コンテナーのイメージを設定するターゲット ImageStreamTag です。 |
9.1.22. .spec.strategy.rollingParams.pre リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LifecycleHook は、特定のデプロイメントライフサイクルアクションを定義します。一度に指定できるアクションのタイプは 1 つだけです。
- 型
-
object
- 必須
-
failurePolicy
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecNewPodHook は、デプロイメントテンプレートの一部であると想定される指定されたコンテナーに基づいて、新しい Pod でコマンドを実行するフック実装です。 |
|
| FailurePolicy は、フックが失敗した場合に実行するアクションを指定します。 |
|
| TagImages は、コンテナーの下で参照されている現在のイメージをイメージストリームタグにタグ付けするようにデプロイヤ-に指示します。 |
|
| TagImageHook は、特定のコンテナー内のイメージを ImageStreamTag にタグ付けするリクエストです。 |
9.1.23. .spec.strategy.rollingParams.pre.execNewPod リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecNewPodHook は、デプロイメントテンプレートの一部であると想定される指定されたコンテナーに基づいて、新しい Pod でコマンドを実行するフック実装です。
- 型
-
object
- 必須
-
command
-
containerName
-
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドは、アクションコマンドおよびその引数です。 |
|
| ContainerName は、デプロイメント Pod テンプレート内のコンテナーの名前であり、そのコンテナーイメージはフック Pod のコンテナーに使用されます。 |
| Env は、フック Pod のコンテナーに提供する環境変数のセットです。 | |
|
| ボリュームは、フック Pod にコピーする必要がある Pod テンプレートからの名前付きボリュームのリストです。Pod 仕様にないボリューム名は無視されます。空のリストは、ボリュームがコピーされないことを意味します。 |
9.1.24. .spec.strategy.rollingParams.pre.tagImages リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TagImages は、コンテナーの下で参照されている現在のイメージをイメージストリームタグにタグ付けするようにデプロイヤ-に指示します。
- 型
-
array
9.1.25. .spec.strategy.rollingParams.pre.tagImages[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TagImageHook は、特定のコンテナー内のイメージを ImageStreamTag にタグ付けするリクエストです。
- 型
-
object
- 必須
-
containerName
-
to
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ContainerName は、イメージ値がタグのソースとして使用されるデプロイメント設定内のコンテナーの名前です。コンテナーが 1 つしかない場合、この値はデフォルトでそのコンテナーの名前になります。 |
| To は、コンテナーのイメージを設定するターゲット ImageStreamTag です。 |
9.1.26. .spec.triggers リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- トリガーは、DeploymentConfig の更新によって新しいデプロイメントがどのように発生するかを決定します。トリガーが定義されていない場合、新しいデプロイメントは、新しい LatestVersion を使用した DeploymentConfig への明示的なクライアント更新の結果としてのみ発生します。null の場合、デフォルトで設定変更トリガーが設定されます。
- 型
-
array
9.1.27. .spec.triggers[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DeploymentTriggerPolicy は、新しいデプロイメントをもたらす単一のトリガーのポリシーを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| DeploymentTriggerImageChangeParams は、ImageChange トリガーへのパラメーターを表します。 |
|
| トリガーの種類 |
9.1.28. .spec.triggers[].imageChangeParams リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DeploymentTriggerImageChangeParams は、ImageChange トリガーへのパラメーターを表します。
- 型
-
object
- 必須
-
from
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 自動とは、新しいタグ値を検出すると、Pod テンプレート内のイメージが更新されることを意味します。 |
|
| ContainerNames は、タグの更新を Pod 内の指定されたコンテナー名のセットに制限するために使用されます。複数のトリガーが同じコンテナーを指している場合、結果の動作は未定義です。将来の API バージョンでは、これは検証エラーになります。ContainerNames が有効なコンテナーを指していない場合、トリガーは無視されます。将来の API バージョンでは、これは検証エラーになります。 |
| From は、変更を監視するためのイメージストリームタグへの参照です。From.Name が唯一の必須サブフィールドです。- From.Namespace が空白の場合、現在のデプロイメントトリガーの namespace が使用されます。 | |
|
| LastTriggeredImage は、トリガーされる最後のイメージです。 |
9.1.29. .status リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DeploymentConfigStatus は、現在のデプロイメント状態を表します。
- 型
-
object
- 必須
-
latestVersion
-
observedGeneration
-
replicas
-
updatedReplicas
-
availableReplicas
-
unavailableReplicas
-
プロパティー | 型 | 説明 |
---|---|---|
|
| AvailableReplicas は、このデプロイメント設定の対象となる使用可能な Pod の総数です。 |
|
| 条件は、デプロイメント設定の現在の状態について利用可能な最新の観測値を表します。 |
|
| DeploymentCondition は、特定の時点でのデプロイメント設定の状態を記述します。 |
|
| DeploymentDetails は、デプロイメントの原因に関する情報をキャプチャーします。 |
|
| LatestVersion は、デプロイメント設定に関連付けられている現在のデプロイメントが同期していないかどうかを判別するのに使用されます。 |
|
| ObservedGeneration は、デプロイメント設定コントローラーによって観察された最新の世代です。 |
|
| このデプロイメントの対象となる準備ができている Pod の総数。 |
|
| レプリカは、このデプロイメント設定の対象となる Pod の総数です。 |
|
| UnavailableReplicas は、このデプロイメント設定の対象となる使用できない Pod の総数です。 |
|
| UpdatedReplicas は、目的のテンプレート仕様を持つ、このデプロイメント設定の対象となる非終了 Pod の総数です。 |
9.1.30. .status.conditions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 条件は、デプロイメント設定の現在の状態について利用可能な最新の観測値を表します。
- 型
-
array
9.1.31. .status.conditions[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DeploymentCondition は、特定の時点でのデプロイメント設定の状態を記述します。
- 型
-
object
- 必須
-
type
-
status
-
プロパティー | 型 | 説明 |
---|---|---|
| time | 最後にある状態から別の状態に遷移した時間。 |
| time | この状態が最後に更新された時刻。 |
|
| 遷移の詳細を示す人が判読できるメッセージ。 |
|
| 条件の最後の遷移の理由。 |
|
| 状態のステータス (True、False、Unknown のいずれか)。 |
|
| デプロイメント条件のタイプ。 |
9.1.32. .status.details リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DeploymentDetails は、デプロイメントの原因に関する情報をキャプチャーします。
- 型
-
object
- 必須
-
causes
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 原因は、新しいデプロイメントを作成するためのすべての原因に関連付けられた拡張データです |
|
| DeploymentCause は、デプロイメントの特定の原因に関する情報をキャプチャーします。 |
|
| このデプロイメントがユーザーによって手動でトリガーされた場合、メッセージはユーザー指定の変更メッセージです |
9.1.33. .status.details.causes リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 原因は、新しいデプロイメントを作成するためのすべての原因に関連付けられた拡張データです
- 型
-
array
9.1.34. .status.details.causes[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DeploymentCause は、デプロイメントの特定の原因に関する情報をキャプチャーします。
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| DeploymentCauseImageTrigger は、イメージ変更トリガーに起因するデプロイメントの原因に関する詳細を表します |
|
| 新しいデプロイメントの作成につながったトリガーのタイプ |
9.1.35. .status.details.causes[].imageTrigger リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DeploymentCauseImageTrigger は、イメージ変更トリガーに起因するデプロイメントの原因に関する詳細を表します
- 型
-
object
- 必須
-
from
-
プロパティー | 型 | 説明 |
---|---|---|
| From は、デプロイメントをトリガーした変更されたオブジェクトへの参照です。フィールドには、DockerImage、ImageStreamTag、または ImageStreamImage の種類があります。 |
9.2. API エンドポイント リンクのコピーリンクがクリップボードにコピーされました!
以下の API エンドポイントを利用できます。
/apis/apps.openshift.io/v1/deploymentconfigs
-
GET
: DeploymentConfig 種類のオブジェクトをリスト表示または監視する
-
/apis/apps.openshift.io/v1/watch/deploymentconfigs
-
GET
: DeploymentConfig のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
-
/apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs
-
DELETE
: DeploymentConfig のコレクションを削除する -
GET
: DeploymentConfig 種類のオブジェクトをリスト表示または監視する -
POST
: DeploymentConfig を作成する
-
/apis/apps.openshift.io/v1/watch/namespaces/{namespace}/deploymentconfigs
-
GET
: DeploymentConfig のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
-
/apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}
-
DELETE
: DeploymentConfig を削除する -
GET
: 指定された DeploymentConfig を読み取ります。 -
PATCH
: 指定された DeploymentConfig を一部更新します。 -
PUT
: 指定された DeploymentConfig を置き換えます。
-
/apis/apps.openshift.io/v1/watch/namespaces/{namespace}/deploymentconfigs/{name}
-
GET
: DeploymentConfig 種類のオブジェクトへの変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用し、'fieldSelector' パラメーターで単一の項目にフィルター処理します。
-
/apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}/status
-
GET
: 指定された DeploymentConfig のステータスを読み取る -
PATCH
: 指定された DeploymentConfig のステータスを部分的に更新する -
PUT
: 指定された DeploymentConfig のステータスを置き換える
-
9.2.1. /apis/apps.openshift.io/v1/deploymentconfigs リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- DeploymentConfig 種類のオブジェクトをリスト表示または監視する
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
9.2.2. /apis/apps.openshift.io/v1/watch/deploymentconfigs リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- DeploymentConfig のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
9.2.3. /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
DELETE
- 説明
- DeploymentConfig のコレクションを削除する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
GET
- 説明
- DeploymentConfig 種類のオブジェクトをリスト表示または監視する
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
POST
- 説明
- DeploymentConfig を作成する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
202 - Accepted |
|
401 - Unauthorized | 空白 |
9.2.4. /apis/apps.openshift.io/v1/watch/namespaces/{namespace}/deploymentconfigs リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- DeploymentConfig のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
9.2.5. /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name} リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| DeploymentConfig の名前 |
- HTTP メソッド
-
DELETE
- 説明
- DeploymentConfig を削除する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
202 - Accepted |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
GET
- 説明
- 指定された DeploymentConfig を読み込む。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PATCH
- 説明
- 指定された DeploymentConfig を読み込む。
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PUT
- 説明
- 指定された DeploymentConfig を読み込む。
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
9.2.6. /apis/apps.openshift.io/v1/watch/namespaces/{namespace}/deploymentconfigs/{name} リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| DeploymentConfig の名前 |
- HTTP メソッド
-
GET
- 説明
- DeploymentConfig 種類のオブジェクトへの変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用し、'fieldSelector' パラメーターで単一の項目にフィルター処理します。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
9.2.7. /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}/status リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| DeploymentConfig の名前 |
- HTTP メソッド
-
GET
- 説明
- 指定された DeploymentConfig のステータスを読み取る
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PATCH
- 説明
- 指定された DeploymentConfig のステータスを部分的に更新する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PUT
- 説明
- 指定された DeploymentConfig のステータスを置き換える
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
第10章 DeploymentConfigRollback [apps.openshift.io/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
DeploymentConfigRollback は、ロールバック生成への入力を提供します。
互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
- 型
-
object
- 必須
-
name
-
spec
-
10.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 を参照してください。 |
|
| ロールバックされるデプロイメント設定の名前。 |
|
| DeploymentConfigRollbackSpec は、ロールバック生成のオプションを表します。 |
|
| UpdatedAnnotations は、デプロイメント設定に追加される一連の新しいアノテーションです。 |
10.1.1. .spec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DeploymentConfigRollbackSpec は、ロールバック生成のオプションを表します。
- 型
-
object
- 必須
-
from
-
includeTriggers
-
includeTemplate
-
includeReplicationMeta
-
includeStrategy
-
プロパティー | 型 | 説明 |
---|---|---|
| ポイントからデプロイメントである ReplicationController へ。 | |
|
| IncludeReplicationMeta は、レプリカ数およびセレクターを含めるかどうかを指定します。 |
|
| IncludeStrategy は、デプロイメント戦略を含めるかどうかを指定します。 |
|
| IncludeTemplate は、PodTemplateSpec を含めるかどうかを指定します。 |
|
| IncludeTriggers は、設定 Trigger を含めるかどうかを指定します。 |
|
| ロールバックするリビジョン。0 に設定すると、最後のリビジョンにロールバックします。 |
10.2. API エンドポイント リンクのコピーリンクがクリップボードにコピーされました!
以下の API エンドポイントを利用できます。
/apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}/rollback
-
POST
: DeploymentConfig のロールバックを作成する
-
10.2.1. /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}/rollback リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| DeploymentConfigRollback の名前 |
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
- HTTP メソッド
-
POST
- 説明
- DeploymentConfig のロールバックを作成する
パラメーター | 型 | 説明 |
---|---|---|
|
HTTP コード | レスポンスのボディー |
---|---|
200 - OK | |
201 - Created | |
202 - Accepted | |
401 - Unauthorized | 空白 |
第11章 DeploymentLog [apps.openshift.io/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
DeploymentLog は、デプロイメントのログを表します
互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
- 型
-
object
11.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 を参照してください。 |
11.2. API エンドポイント リンクのコピーリンクがクリップボードにコピーされました!
以下の API エンドポイントを利用できます。
/apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}/log
-
GET
: 指定された DeploymentConfig のログを読み取る
-
11.2.1. /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}/log リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| DeploymentLog の名前 |
- HTTP メソッド
-
GET
- 説明
- 指定された DeploymentConfig のログを読み取る
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
第12章 DeploymentRequest [apps.openshift.io/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
DeploymentRequest は、新しいデプロイメントのデプロイメント設定へのリクエストです。
互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
- 型
-
object
- 必須
-
name
-
latest
-
force
-
12.1. 仕様 リンクのコピーリンクがクリップボードにコピーされました!
プロパティー | 型 | 説明 |
---|---|---|
|
| apiVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。 |
|
| ExcludeTriggers は、指定されたトリガーの処理を回避するようにインスタンス化ツールに指示します。このフィールドは、最新のトリガーをオーバーライドし、クライアントが特定のロジックを制御できるようにします。指定しないと、このフィールドは無視されます。 |
|
| Force は、新しいデプロイメントを強制的に実行しようとします。デプロイメント設定が一時停止となっている場合は、これを true に設定すると、無効なエラーが返されます。 |
|
| kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できる場合があります。これは更新できません。CamelCase を使用します。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。 |
|
| 最新は、すべてのトリガーからの最新の状態でデプロイメント設定を更新します。 |
|
| 新しいデプロイメントを要求するためのデプロイメント設定の名前。 |
12.2. API エンドポイント リンクのコピーリンクがクリップボードにコピーされました!
以下の API エンドポイントを利用できます。
/apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}/instantiate
-
POST
: DeploymentConfig のインスタンス化を作成する
-
12.2.1. /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}/instantiate リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| DeploymentRequest の名前 |
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
- HTTP メソッド
-
POST
- 説明
- DeploymentConfig のインスタンス化を作成する
パラメーター | 型 | 説明 |
---|---|---|
|
|
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
202 - Accepted |
|
401 - Unauthorized | 空白 |
第13章 Job [batch/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Job は、単一の Job の設定を表します。
- 型
-
object
13.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 を参照してください。 | |
|
| JobSpec は、ジョブの実行がどのようになるかを記述します。 |
|
| JobStatus は、ジョブの現在の状態を表します。 |
13.1.1. .spec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- JobSpec は、ジョブの実行がどのようになるかを記述します。
- 型
-
object
- 必須
-
template
-
プロパティー | 型 | 説明 |
---|---|---|
|
| システムがジョブを終了しようとする前に、ジョブが継続的にアクティブになる可能性がある startTime を基準とした秒単位の期間を指定します。値は正の整数でなければなりません。ジョブが (作成時または更新中に) 一時停止になった場合、このタイマーは事実上停止となり、ジョブが再開したときにリセットされます。 |
|
| このジョブを失敗とマークするまでの再試行回数を指定します。デフォルトは 6 です。 |
|
|
このインデックスを失敗としてマークするまでの、インデックス内における再試行回数の制限を指定します。有効にすると、インデックスごとの失敗回数が Pod の batch.kubernetes.io/job-index-failure-count アノテーションに保持されます。これは、ジョブの completionMode=Indexed で、Pod の再起動ポリシーが Never の場合にのみ設定できます。このフィールドはイミュータブルです。このフィールドはアルファレベルです。 |
|
|
completionMode は、Pod の完了を追跡する方法を指定します。
今後、さらに多くの完了モードを追加できます。ジョブコントローラーが認識できないモードを確認した場合、コントローラーはジョブの更新をスキップします。
可能な列挙値: |
|
| ジョブを実行するために正常に終了した Pod の希望数を指定します。null に設定すると、任意の Pod の成功がすべての Pod の成功を示し、並列処理に正の値を設定できるようになります。1 に設定すると、並列処理が 1 に制限され、その Pod の成功がジョブの成功を示します。詳細: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/ |
|
|
manualSelector は、Pod ラベルと Pod セレクターの生成を制御します。何をしているのかわからない場合は、 |
|
|
backoffLimitPerIndex が設定されている場合、ジョブを失敗としてマークするまでの失敗したインデックスの最大数を指定します。失敗したインデックスの数がこの数を超えると、ジョブ全体が Failed としてマークされ、実行が終了します。null のままにすると、ジョブはすべてのインデックスの実行を続行し、ジョブ状態は |
|
| ジョブが任意の時点で実行する必要のある Pod の最大数を指定します。定常状態で実行している Pod の実際の数は、((.spec.completions - .status.successful) < .spec.parallelism) の場合、つまり、実行する必要のある作業が最大並列処理より少ない場合は、この数より少なくなります。詳細: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/ |
|
| PodFailurePolicy は、失敗した Pod が backoffLimit にどのように影響するかを説明します。 |
|
| podReplacementPolicy は、代替 Pod をいつ作成するか指定します。可能な値は次のとおりです。- TerminatingOrFailed : Pod が終了中 (metadata.deletionTimestamp がある) または失敗したときに Pod が再作成されます。- Failed: 以前に作成された Pod が完全に終了する (フェーズが Failed または Succeeded になる) まで待機してから代替 Pod を作成します。 podFailurePolicy を使用する場合、許可される値は Failed のみです。podFailurePolicy が使用されていない場合、許可される値は TerminatingOrFailed と Failed です。これはアルファフィールドです。このフィールドを使用できるように、JobPodReplacementPolicy を有効にします。
可能な列挙値: - |
| Pod 数と一致する必要がある Pod に対するラベルクエリー。通常、システムはこのフィールドを設定します。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors | |
|
| suspend は、Job コントローラーが Pod を作成するかどうかを指定します。suspend を true に設定して Job を作成すると、ジョブコントローラーは Pod を作成しません。作成後に Job が一時停止した場合 (つまり、フラグが false から true になる場合)、Job コントローラーはこの Job に関連付けられているすべてのアクティブな Pod を削除します。ユーザーは、これを適切に処理するようにワークロードを設計する必要があります。ジョブを一時停止すると、ジョブの StartTime フィールドがリセットされ、ActiveDeadlineSeconds タイマーも効果的にリセットされます。デフォルトは false です。 |
| ジョブの実行時に作成される Pod を説明します。使用できる template.spec.restartPolicy の値は "Never" または "OnFailure" のみです。詳細: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/ | |
|
| ttlSecondsAfterFinished は、実行が終了した (Complete または Failed のいずれか) Job の存続期間を制限します。このフィールドが設定されている場合、Job の終了後に ttlSecondsAfterFinished を設定すると、自動的に削除される可能性があります。ジョブが削除されると、そのライフサイクル保証 (ファイナライザーなど) が尊重されます。このフィールドが設定されていないと、ジョブが自動的に削除されません。このフィールドがゼロに設定されていると、ジョブは終了後すぐに削除できるようになります。 |
13.1.2. .spec.podFailurePolicy リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodFailurePolicy は、失敗した Pod が backoffLimit にどのように影響するかを説明します。
- 型
-
object
- 必須
-
rules
-
プロパティー | 型 | 説明 |
---|---|---|
|
| Pod 障害ポリシールールの一覧。ルールは順番に評価されます。ルールが Pod の障害に一致すると、残りのルールは無視されます。Pod の障害に一致するルールがない場合は、デフォルトの処理が適用されます。つまり、Pod の失敗のカウンターが増分され、backoffLimit に対してチェックされます。最大 20 個の要素が許可されます。 |
|
| PodFailurePolicyRule は、要件が満たされた場合に Pod の障害がどのように処理されるかを記述します。各ルールでは、onExitCodes と onPodConditions のいずれか 1 つを使用できますが、両方は使用できません。 |
13.1.3. .spec.podFailurePolicy.rules リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod 障害ポリシールールの一覧。ルールは順番に評価されます。ルールが Pod の障害に一致すると、残りのルールは無視されます。Pod の障害に一致するルールがない場合は、デフォルトの処理が適用されます。つまり、Pod の失敗のカウンターが増分され、backoffLimit に対してチェックされます。最大 20 個の要素が許可されます。
- 型
-
array
13.1.4. .spec.podFailurePolicy.rules[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodFailurePolicyRule は、要件が満たされた場合に Pod の障害がどのように処理されるかを記述します。各ルールでは、onExitCodes と onPodConditions のいずれか 1 つを使用できますが、両方は使用できません。
- 型
-
object
- 必須
-
action
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 要件が満たされた場合に Pod の障害に対して実行されるアクションを指定します。可能な値は次のとおりです。
- FailJob: Pod のジョブが Failed としてマークされ、実行中のすべての Pod が終了したことを示します。- FailIndex: Pod のインデックスが Failed としてマークされ、再起動されないことを示します。この値はアルファレベルです。これは、
可能な列挙値: - |
|
| PodFailurePolicyOnExitCodesRequirement は、コンテナー終了コードに基づいて失敗した Pod を処理するための要件を説明します。特に、各アプリケーションコンテナーの .state.termination.exitCode と init コンテナーのステータスを検索します。これは、Pod ステータスの .status.containerStatuses フィールドと .status.initContainerStatuses フィールドをそれぞれ検索します。正常に完了したコンテナー (終了コード 0) は、要件チェックから除外されます。 |
|
| Pod の条件に関する要件を表します。要件は Pod 条件パターンのリストとして表されます。少なくとも 1 つのパターンが実際の Pod の状態と一致する場合、要件は満たされます。最大 20 個の要素が許可されます。 |
|
| PodFailurePolicyOnPodConditionsPattern は、実際の Pod 条件タイプと一致するパターンを記述します。 |
13.1.5. .spec.podFailurePolicy.rules[].onExitCodes リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodFailurePolicyOnExitCodesRequirement は、コンテナー終了コードに基づいて失敗した Pod を処理するための要件を説明します。特に、各アプリケーションコンテナーの .state.termination.exitCode と init コンテナーのステータスを検索します。これは、Pod ステータスの .status.containerStatuses フィールドと .status.initContainerStatuses フィールドをそれぞれ検索します。正常に完了したコンテナー (終了コード 0) は、要件チェックから除外されます。
- 型
-
object
- 必須
-
operator
-
values
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 終了コードのチェックを指定された名前のコンテナーに制限します。null の場合、ルールはすべてのコンテナーに適用されます。指定する場合、Pod テンプレート内のコンテナー名または initContainer 名のいずれかと一致する必要があります。 |
|
| コンテナー終了コードと指定された値の関係を表します。正常に完了したコンテナー (終了コード 0) は、要件チェックから除外されます。可能な値は次のとおりです。 - In: 少なくとも 1 つのコンテナーの終了コードが指定の値のセット内にある場合、要件は満たされます ('containerName' フィールドからの制限がないコンテナーが複数ある場合は、複数の終了コードが存在する可能性があります)。- NotIn: 少なくとも 1 つのコンテナーの終了コードが指定の値のセット内にない場合、要件は満たされます ('containerName' フィールドからの制限がないコンテナーが複数ある場合は、複数の終了コードが存在する可能性があります)。その他の値は、今後追加される予定です。クライアントは、要件が満たされていないことを前提として、不明な演算子に対応する必要があります。
使用可能な列挙値: - |
|
| 値のセットを指定します。返された各コンテナー終了コードは、この値のセットに対して、演算子に関するチェックを行います (複数のコンテナーがある場合は複数存在する可能性があります)。値のリストは順序付けする必要があり、重複を含めることはできません。値 '0' は、In 演算子に使用できません。少なくとも 1 つの要素が必要です。最大 255 個の要素が許可されます。 |
13.1.6. .spec.podFailurePolicy.rules[].onPodConditions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod の条件に関する要件を表します。要件は Pod 条件パターンのリストとして表されます。少なくとも 1 つのパターンが実際の Pod の状態と一致する場合、要件は満たされます。最大 20 個の要素が許可されます。
- 型
-
array
13.1.7. .spec.podFailurePolicy.rules[].onPodConditions[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodFailurePolicyOnPodConditionsPattern は、実際の Pod 条件タイプと一致するパターンを記述します。
- 型
-
object
- 必須
-
type
-
status
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 必要な Pod の条件ステータスを指定します。Pod 条件と一致するには、指定されたステータスが Pod 条件ステータスと等しい必要があります。デフォルトは True です。 |
|
| 必要な Pod 条件タイプを指定します。Pod 条件と一致するには、指定されたタイプが Pod 条件タイプと等しい必要があります。 |
13.1.8. .status リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- JobStatus は、ジョブの現在の状態を表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 保留中および実行中の Pod の数。 |
|
| completedIndexes は、.spec.completionMode = "Indexed" の場合に完成したインデックスをテキスト形式で保持します。インデックスは、コンマで区切られた 10 進整数として表されます。番号は昇順でリストされています。3 つ以上の連続する数値は圧縮され、ハイフンで区切られたシリーズの最初と最後の要素で表されます。たとえば、完了したインデックスが 1、3、4、5、7 の場合は、"1,3-5,7" で表現されます。 |
| time | ジョブが完了した時間を表します。別々の操作をまたいで、happens-before の順序が設定されることは保証されていません。これは RFC3339 形式で表されます。これは UTC です。完了時間は、ジョブが正常に終了したときにのみ設定されます。 |
|
| オブジェクトの現在の状態の最新の利用可能な観測。ジョブが失敗すると、条件の 1 つに "Failed" と入力され、ステータスが true になります。Job が一時停止すると、条件の 1 つのタイプが "Suspended" になり、ステータスが true になります。Job が再開すると、この状態のステータスは false になります。ジョブが完了すると、条件の 1 つのタイプが "Complete" になり、ステータスが true になります。詳細: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/ |
|
| JobCondition は、ジョブの現在の状態を記述します。 |
|
| フェーズ失敗に達した Pod の数。 |
|
|
FailedIndexes は、backoffLimitPerIndex=true の場合に失敗したインデックスを保持します。インデックスは、 |
|
| Ready 状態の Pod 数。 このフィールドは、ベータレベルですジョブコントローラーは、JobReadyPods のフィーチャーゲートが有効になっている場合 (デフォルトで有効になっている場合)、フィールドにデータを入力します。 |
| time | ジョブコントローラーがジョブの処理を開始した時刻を表します。Job が一時停止状態で作成された場合、このフィールドは最初に再開されるまで設定されません。このフィールドは、Job が一時停止から再開するたびにリセットされます。これは RFC3339 形式で表されます。これは UTC です。 |
|
| フェーズ成功に達した Pod の数。 |
|
| 終了中の (Pending または Running フェーズにあり、deletetionTimestamp を持つ) Pod の数。 このフィールドはアルファレベルです。フィーチャーゲート JobPodReplacementPolicy (デフォルトで有効) が有効な場合、ジョブコントローラーはフィールドに値を入力します。 |
|
| UncountedTerminatedPods は、終了したにもかかわらず Job ステータスカウンターに計上されていない Pod の UID を保持します。 |
13.1.9. .status.conditions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- オブジェクトの現在の状態の最新の利用可能な観測。ジョブが失敗すると、条件の 1 つに "Failed" と入力され、ステータスが true になります。Job が一時停止すると、条件の 1 つのタイプが "Suspended" になり、ステータスが true になります。Job が再開すると、この状態のステータスは false になります。ジョブが完了すると、条件の 1 つのタイプが "Complete" になり、ステータスが true になります。詳細: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/
- 型
-
array
13.1.10. .status.conditions[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- JobCondition は、ジョブの現在の状態を記述します。
- 型
-
object
- 必須
-
type
-
status
-
プロパティー | 型 | 説明 |
---|---|---|
| time | 前回条件がチェックされたとき。 |
| time | 前回、状態が 1 つのステータスから別のステータスに移行したとき。 |
|
| 最後にある状態から別の状態に遷移した時間。 |
|
| (簡単な) 条件の最後の遷移の理由。 |
|
| 状態のステータス (True、False、Unknown のいずれか)。 |
|
| ジョブ条件のタイプ、完了または失敗。 |
13.1.11. .status.uncountedTerminatedPods リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- UncountedTerminatedPods は、終了したにもかかわらず Job ステータスカウンターに計上されていない Pod の UID を保持します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| failed は、失敗した Pod の UID を保持します。 |
|
| succeeded は、成功した Pod の UID を保持します。 |
13.2. API エンドポイント リンクのコピーリンクがクリップボードにコピーされました!
以下の API エンドポイントを利用できます。
/apis/batch/v1/jobs
-
GET
: Job 種類のオブジェクトをリスト表示または監視するロール
-
/apis/batch/v1/watch/jobs
-
GET
: Job のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
-
/apis/batch/v1/namespaces/{namespace}/jobs
-
DELETE
: Job のコレクションを削除します。 -
GET
: Job 種類のオブジェクトをリスト表示または監視するロール -
POST
: ジョブを作成する
-
/apis/batch/v1/watch/namespaces/{namespace}/jobs
-
GET
: Job のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
-
/apis/batch/v1/namespaces/{namespace}/jobs/{name}
-
DELETE
: Job を削除する -
GET
: 指定された Job を読み取ります。 -
PATCH
: 指定された Job を部分的に更新します。 -
PUT
: 指定された Job を置き換えます。
-
/apis/batch/v1/watch/namespaces/{namespace}/jobs/{name}
-
GET
: Job 種類のオブジェクトへの変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用し、'fieldSelector' パラメーターで単一の項目にフィルター処理します。
-
/apis/batch/v1/namespaces/{namespace}/jobs/{name}/status
-
GET
: 指定された Job のステータスを読み取ります。 -
PATCH
: 指定された Job のステータスを部分的に更新します。 -
PUT
: 指定された Job のステータスを置き換えます。
-
13.2.1. /apis/batch/v1/jobs リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- Job 種類のオブジェクトをリスト表示または監視するロール
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
13.2.2. /apis/batch/v1/watch/jobs リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- Job のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
13.2.3. /apis/batch/v1/namespaces/{namespace}/jobs リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
DELETE
- 説明
- Job のコレクションを削除します。
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
GET
- 説明
- Job 種類のオブジェクトをリスト表示または監視するロール
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
POST
- 説明
- Job を作成する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
13.2.4. /apis/batch/v1/watch/namespaces/{namespace}/jobs リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- Job のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
13.2.5. /apis/batch/v1/namespaces/{namespace}/jobs/{name} リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| Job の名前 |
- HTTP メソッド
-
DELETE
- 説明
- Job を削除する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
202 - Accepted |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
GET
- 説明
- 指定された Job を読み取る
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PATCH
- 説明
- 指定された Job を部分的に更新します。
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PUT
- 説明
- 指定された Job を置き換えます。
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
13.2.6. /apis/batch/v1/watch/namespaces/{namespace}/jobs/{name} リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| Job の名前 |
- HTTP メソッド
-
GET
- 説明
- Job 種類のオブジェクトへの変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用し、'fieldSelector' パラメーターで単一の項目にフィルター処理します。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
13.2.7. /apis/batch/v1/namespaces/{namespace}/jobs/{name}/status リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| Job の名前 |
- HTTP メソッド
-
GET
- 説明
- 指定された Job のステータスを読み取る
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PATCH
- 説明
- 指定された Job のステータスを部分的に更新する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PUT
- 説明
- 指定された Job のステータスを置き換える
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
第14章 Pod [v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod は、ホスト上で実行できるコンテナーのコレクションです。このリソースはクライアントによって作成され、ホストにスケジュールされます。
- 型
-
object
14.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 を参照してください。 | |
|
| PodSpec は Pod の説明です。 |
|
| PodStatus は、Pod のステータスに関する情報を表します。特に Pod をホストするノードがコントロールプレーンに接続できない場合、ステータスはシステムの実際の状態を追跡する可能性があります。 |
14.1.1. .spec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodSpec は Pod の説明です。
- 型
-
object
- 必須
-
containers
-
プロパティー | 型 | 説明 |
---|---|---|
|
| システムがアクティブに失敗のマークを付けて関連するコンテナーを強制終了する前に、StartTime を基準にして Pod がノード上でアクティブになる可能性がある秒単位のオプションの期間。その値は正の整数でなければなりません。 |
|
| アフィニティーは、アフィニティースケジューリングルールのグループです。 |
|
| AutomountServiceAccountToken は、サービスアカウントトークンを自動的にマウントする必要があるかどうかを示します。 |
|
| Pod に属するコンテナーのリスト。現在、コンテナーを追加または削除することはできません。Pod には少なくとも 1 つのコンテナーが必要です。これを更新することはできません。 |
|
| Pod 内で実行する単一のアプリケーションコンテナー。 |
|
| PodDNSConfig は、DNSPolicy から生成されたパラメーターに加えて、Pod の DNS パラメーターを定義します。 |
|
| Pod の DNS ポリシーを設定します。デフォルトは "ClusterFirst" です。有効な値は、'ClusterFirstWithHostNet'、'ClusterFirst'、'Default'、または 'None' です。DNSConfig で指定された DNS パラメーターは、DNSPolicy で選択されたポリシーとマージされます。hostNetwork とともに DNS オプションを設定するには、DNS ポリシーを 'ClusterFirstWithHostNet' に明示的に指定する必要があります。
使用可能な列挙値: - |
|
| EnableServiceLinks は、Docker リンクの構文と一致して、サービスに関する情報を Pod の環境変数に挿入する必要があるかどうかを示します。オプション: デフォルトは true です。 |
|
| この Pod で実行されるエフェメラルコンテナーのリスト。エフェメラルコンテナーを既存の Pod で実行して、デバッグなどのユーザーが開始するアクションを実行できます。このリストは、Pod の作成時に指定することはできません。また、Pod の仕様を更新して変更することもできません。エフェメラルコンテナーを既存の Pod に追加するには、Pod のエフェメラルコンテナーサブリソースを使用します。 |
|
| EphemeralContainer は、デバッグなど、ユーザーが開始したアクティビティーに対して、既存の Pod に追加できる一時コンテナーです。エフェメラルコンテナーにはリソースやスケジュールの保証がなく、コンテナーの終了時、または Pod の削除または再起動時に再起動されません。エフェメラルコンテナーが原因で Pod がリソース割り当てを超過した場合、kubelet は Pod をエビクトする可能性があります。 エフェメラルコンテナーを追加するには、既存の Pod の ephemeralcontainers サブリソースを使用します。エフェメラルコンテナーは削除または再起動できません。 |
|
| HostAliases は、指定された場合に Pod の hosts ファイルに注入されるホストおよび IP のオプションのリストです。これは、hostNetwork 以外の Pod にのみ有効です。 |
|
| HostAlias は、Pod の hosts ファイルのエントリーとして挿入される IP とホスト名の間のマッピングを保持します。 |
|
| ホストの ipc 名前空間を使用します。オプション: デフォルトは false です。 |
|
| この Pod に要求されたホストネットワーク。ホストのネットワーク名前空間を使用します。このオプションを設定する場合は、使用するポートを指定する必要があります。デフォルトは false です。 |
|
| ホストの pid 名前空間を使用します。オプション: デフォルトは false です。 |
|
| ホストのユーザー namespace を使用します。任意: デフォルトは true です。true に設定するか存在しない場合、Pod はホストユーザーの namespace で実行されます。これは、CAP_SYS_MODULE を使用したカーネルモジュールのロードなど、ホストユーザー namespace でのみ利用できる機能が Pod に必要な場合に役立ちます。false に設定すると、Pod 用に新しい userns が作成されます。false に設定すると、コンテナーブレークアウトの脆弱性を軽減するのに役立ち、ユーザーがホスト上で実際に root 権限を持たずにコンテナーを root として実行できるようになります。このフィールドはアルファレベルであり、UserNamespacesSupport 機能を有効にするサーバーでのみ認識されます。 |
|
| Pod のホスト名を指定します指定しない場合、Pod のホスト名はシステム定義の値に設定されます。 |
|
| ImagePullSecrets は、この PodSpec で使用されるイメージをプルするために使用する、同じ名前空間内のシークレットへの参照のオプションのリストです。指定されている場合、これらのシークレットは、使用するために個々のプラー実装に渡されます。詳細: https://kubernetes.io/docs/concepts/containers/images#specifying-imagepullsecrets-on-a-pod |
|
| LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。 |
|
| Pod に属する初期化コンテナーのリスト。コンテナーが開始される前に、初期化コンテナーが順番に実行されます。init コンテナーに障害が発生した場合、Pod は障害が発生したと見なされ、restartPolicy に従って処理されます。init コンテナーまたは通常のコンテナーの名前は、すべてのコンテナー間で一意である必要があります。Init コンテナーには、ライフサイクルアクション、準備プローブ、ライブネスプローブ、またはスタートアッププローブがない場合があります。init コンテナーの resourceRequirements は、各リソースタイプの最大の要求/制限を見つけ、その値の最大値または通常のコンテナーの合計を使用することにより、スケジューリング中に考慮されます。同様の方法で、init コンテナーに制限が適用されます。現在、初期化コンテナーを追加または削除することはできません。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/ |
|
| Pod 内で実行する単一のアプリケーションコンテナー。 |
|
| NodeName は、この Pod を特定のノードにスケジュールするためのリクエストです。空でない場合、スケジューラーは、リソース要件に適合していると想定して、この Pod をそのノードにスケジュールするだけです。 |
|
| NodeSelector は、Pod がノードに収まるようにするために true である必要があるセレクターです。そのノードでスケジュールされる Pod のノードのラベルと一致する必要があるセレクター。詳細: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/ |
|
| PodOS は、Pod の OS パラメーターを定義します。 |
| オーバーヘッドは、特定の RuntimeClass の Pod の実行に関連するリソースオーバーヘッドを表します。このフィールドは、RuntimeClass アドミッションコントローラーによってアドミッション時に自動入力されます。RuntimeClass アドミッションコントローラーが有効になっている場合は、Pod 作成要求でオーバーヘッドを設定しないでください。RuntimeClass アドミッションコントローラーは、オーバーヘッドがすでに設定されている Pod 作成要求を拒否します。RuntimeClass が PodSpec で設定および選択されている場合、オーバーヘッドは対応する RuntimeClass で定義されている値に設定されます。それ以外の場合は、未設定のままでゼロとして扱われます。詳細は、https://git.k8s.io/enhancements/keps/sig-node/688-pod-overhead/README.md を参照してください。 | |
|
| PreemptionPolicy は、優先度の低い Pod をプリエンプトするためのポリシーです。Never、PreemptLowerPriority の 1 つ。設定されていない場合、デフォルトは PreemptLowerPriority です。
使用可能な列挙値: - |
|
| 優先度の値。さまざまなシステムコンポーネントがこのフィールドを使用して、Pod の優先度を検索します。Priority Admission Controller が有効になっている場合、ユーザーはこのフィールドを設定できません。アドミッションコントローラーは、PriorityClassName からこのフィールドに入力します。値が高いと優先順位が高くなります。 |
|
| 指定されている場合、Pod の優先度を示します。"system-node-critical" と "system-cluster-critical" は、最も高い優先度を示す 2 つの特別なキーワードであり、前者が最も高い優先度です。その他の名前は、その名前で PriorityClass オブジェクトを作成して定義する必要があります。指定しない場合、Pod の優先度はデフォルトになり、デフォルトがない場合はゼロになります。 |
|
| 指定した場合、すべての準備ゲートが Pod の準備状況に対して評価されます。すべてのコンテナーの準備が整い、準備ゲートで指定されたすべての条件のステータスが "True" になると、Pod の準備が整います。詳細: https://git.k8s.io/enhancements/keps/sig-network/580-pod-readiness-gates |
|
| PodReadinessGate には、Pod 条件への参照が含まれています |
|
| ResourceClaims は、Pod の起動を許可する前にどの ResourceClaim を割り当てて予約する必要があるかを定義します。リソースは、名前ベースでリソースを使用するコンテナーに提供されます。 これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。 このフィールドは不変です。 |
|
| PodResourceClaim は、ClaimSource を介して 1 つの ResourceClaim のみを参照します。Pod 内の ResourceClaim を一意に識別する名前を追加します。ResourceClaim へのアクセスが必要なコンテナーは、この名前で参照します。 |
|
| Pod 内のすべてのコンテナーのポリシーを再起動します。Always、OnFailure、Never のいずれか。コンテキストによっては、これらの値のサブセットのみが使用できます。デフォルトは Always です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#restart-policy
使用可能な列挙値: - |
|
| RuntimeClassName は、node.k8s.io グループ内の RuntimeClass オブジェクトを参照します。このオブジェクトは、この Pod を実行するために使用する必要があります。指定されたクラスに一致する RuntimeClass リソースがない場合、Pod は実行されません。設定されていないか空の場合は、"レガシー" の RuntimeClass が使用されます。これは、デフォルトのランタイムハンドラーを使用する空の定義を持つ暗黙のクラスです。詳細は、https://git.k8s.io/enhancements/keps/sig-node/585-runtime-class を参照してください。 |
|
| 指定した場合、Pod は指定したスケジューラーによってディスパッチされます。指定しない場合、Pod はデフォルトのスケジューラーによってディスパッチされます。 |
|
| SchedulingGates は、指定されている場合に Pod のスケジューリングをブロックする不透明な値のリストです。schedulingGates が空でない場合、Pod は SchedulingGated 状態のままになり、スケジューラーは Pod のスケジュールを試行しません。 SchedulingGates を設定できるのは Pod の作成時にのみで、それ以降は削除されます。 これは、PodSchedulingReadiness フィーチャーゲートによって有効になるベータ機能です。 |
|
| PodSchedulingGate は Pod に割り当てられ、そのスケジューリングを保護します。 |
|
| PodSecurityContext は、Pod レベルのセキュリティー属性と一般的なコンテナー設定を保持します。一部のフィールドは container.securityContext にも存在します。container.securityContext のフィールド値は、PodSecurityContext のフィールド値よりも優先されます。 |
|
| DeprecatedServiceAccount は、ServiceAccountName の減価償却されたエイリアスです。非推奨: 代わりに serviceAccountName を使用してください。 |
|
| ServiceAccountName は、この Pod の実行に使用する ServiceAccount の名前です。詳細: https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/ |
|
| true の場合、Pod のホスト名は、リーフ名 (デフォルト) ではなく、Pod の FQDN として設定されます。Linux コンテナーでは、これはカーネルのホスト名フィールド (struct utsname のノード名フィールド) に FQDN を設定することを意味します。Windows コンテナーでは、これはレジストリーキー HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters のホスト名のレジストリー値を FQDN に設定することを意味します。Pod に FQDN がない場合、これは効果がありません。デフォルトは false です。 |
|
| Pod 内のすべてのコンテナー間で単一のプロセス名前空間を共有します。これが設定されると、コンテナーは同じ Pod 内の他のコンテナーからのプロセスを表示および通知できるようになり、各コンテナーの最初のプロセスには PID1 が割り当てられません。HostPID と ShareProcessNamespace の両方を設定することはできません。オプション: デフォルトは false です。 |
|
| 指定した場合、完全修飾 Pod のホスト名は "<hostname>.<subdomain>.<pod namespace>.svc.<cluster domain>" になります。指定しない場合、Pod にはドメイン名がまったくありません。 |
|
| Pod が正常に終了する必要がある秒単位のオプションの期間。削除リクエストで減少する可能性があります。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。この値が nil の場合、代わりにデフォルトの猶予期間が使用されます。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。デフォルトは 30 秒です。 |
|
| 指定されている場合、Pod の許容範囲。 |
|
| この toleration が割り当てられる Pod は、マッチング Operator <operator> を使用してトリプル <key,value,effect> と一致する taint を許容します。 |
|
| TopologySpreadConstraints は、Pod のグループがトポロジードメイン全体にどのように分散するべきかを説明します。スケジューラーは、制約に従う方法で Pod をスケジュールします。すべての topologySpreadConstraints は AND 演算されます。 |
|
| topologySpreadConstraint は、指定されたトポロジー間で一致する Pod を分散する方法を指定します。 |
|
| Pod に属するコンテナーによってマウントできるボリュームのリスト。詳細: https://kubernetes.io/docs/concepts/storage/volumes |
|
| ボリュームは、Pod 内の任意のコンテナーからアクセスできる Pod 内の名前付きボリュームを表します。 |
14.1.2. .spec.affinity リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- アフィニティーは、アフィニティースケジューリングルールのグループです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ノードアフィニティーは、ノードアフィニティースケジューリングルールのグループです。 |
|
| Pod アフィニティーは、Pod 間アフィニティースケジューリングルールのグループです。 |
|
| Pod アンチアフィニティーは、Pod 間アンチアフィニティースケジューリングルールのグループです。 |
14.1.3. .spec.affinity.nodeAffinity リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ノードアフィニティーは、ノードアフィニティースケジューリングルールのグループです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| スケジューラーは、このフィールドで指定されたアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アフィニティー式など) を満たすノードごとに、このフィールドの要素を反復処理して合計を計算します。ノードが対応する matchExpressions と一致する場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。 |
|
| 空の優先スケジューリング用語は、暗黙の重み 0 を持つすべてのオブジェクトに一致します (つまり、操作なしです)。null の優先スケジューリング用語は、オブジェクトに一致しません (つまり、no-op でもあります)。 |
|
| ノードセレクターは、ノードのセットに対する 1 つ以上のラベルクエリーの結果の和集合を表します。つまり、ノードセレクター用語で表されるセレクターの OR を表します。 |
14.1.4. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- スケジューラーは、このフィールドで指定されたアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アフィニティー式など) を満たすノードごとに、このフィールドの要素を反復処理して合計を計算します。ノードが対応する matchExpressions と一致する場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。
- 型
-
array
14.1.5. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 空の優先スケジューリング用語は、暗黙の重み 0 を持つすべてのオブジェクトに一致します (つまり、操作なしです)。null の優先スケジューリング用語は、オブジェクトに一致しません (つまり、no-op でもあります)。
- 型
-
object
- 必須
-
weight
-
preference
-
プロパティー | 型 | 説明 |
---|---|---|
|
| null または空のノードセレクター用語はオブジェクトに一致しません。これらの要件は AND で結合されます。TopologySelectorTerm タイプは、NodeSelectorTerm のサブセットを実装します。 |
|
| 対応する nodeSelectorTerm の一致に関連する重み (1〜100 の範囲)。 |
14.1.6. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- null または空のノードセレクター用語はオブジェクトに一致しません。これらの要件は AND で結合されます。TopologySelectorTerm タイプは、NodeSelectorTerm のサブセットを実装します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ノードのラベルごとのノードセレクター要件のリスト。 |
|
| ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| ノードのフィールドごとのノードセレクター要件のリスト。 |
|
| ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
- 説明
- ノードのラベルごとのノードセレクター要件のリスト。
- 型
-
array
- 説明
- ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| セレクターが適用されるラベルキー。 |
|
| キーと値のセットの関係を表します。有効な Operator は、In、NotIn、Exists、DoesNotExist です。Gt、および Lt。
使用可能な列挙値: - |
|
| 文字列値の配列。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
-
プロパティー | 型 | 説明 |
---|---|---|
|
| セレクターが適用されるラベルキー。 |
|
| キーと値のセットの関係を表します。有効な Operator は、In、NotIn、Exists、DoesNotExist です。Gt、および Lt。
使用可能な列挙値: - |
|
| 文字列値の配列。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。Operator が Gt または Lt の場合、values 配列には、整数として解釈される単一の要素が必要です。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
14.1.11. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ノードセレクターは、ノードのセットに対する 1 つ以上のラベルクエリーの結果の和集合を表します。つまり、ノードセレクター用語で表されるセレクターの OR を表します。
- 型
-
object
- 必須
-
nodeSelectorTerms
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 必須。ノードセレクター用語のリスト。用語は OR されています。 |
|
| 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
プロパティー | 型 | 説明 |
---|---|---|
|
| ノードのラベルごとのノードセレクター要件のリスト。 |
|
| ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| ノードのフィールドごとのノードセレクター要件のリスト。 |
|
| ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
- 説明
- ノードのラベルごとのノードセレクター要件のリスト。
- 型
-
array
- 説明
- ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| セレクターが適用されるラベルキー。 |
|
| キーと値のセットの関係を表します。有効な Operator は、In、NotIn、Exists、DoesNotExist です。Gt、および Lt。
使用可能な列挙値: - |
|
| 文字列値の配列。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。Operator が Gt または Lt の場合、values 配列には、整数として解釈される単一の要素が必要です。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
- 説明
- ノードのフィールドごとのノードセレクター要件のリスト。
- 型
-
array
- 説明
- ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| セレクターが適用されるラベルキー。 |
|
| キーと値のセットの関係を表します。有効な Operator は、In、NotIn、Exists、DoesNotExist です。Gt、および Lt。
使用可能な列挙値: - |
|
| 文字列値の配列。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。Operator が Gt または Lt の場合、values 配列には、整数として解釈される単一の要素が必要です。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
14.1.18. .spec.affinity.podAffinity リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod アフィニティーは、Pod 間アフィニティースケジューリングルールのグループです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| スケジューラーは、このフィールドで指定されたアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アフィニティー式など) を満たすノードごとに、このフィールドの要素を反復処理して合計を計算します。ノードに対応する podAffinityTerm に一致する Pod がある場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。 |
|
| 一致したすべての WeightedPodAffinityTerm フィールドの重みがノードごとに追加され、最も優先されるノードが検索されます。 |
|
| このフィールドで指定されたアフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定されたアフィニティー要件が Pod 実行中のある時点で満たされない場合 (Pod ラベルの更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。複数の要素がある場合、各 podAffinityTerm に対応するノードのリストが交差します。つまり、すべての用語が満たされる必要があります。 |
|
| この 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
- 必須
-
weight
-
podAffinityTerm
-
プロパティー | 型 | 説明 |
---|---|---|
|
| この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。この場合の同じ場所とは、キー <topologyKey> のラベルの値が、一連の Pod の Pod が実行されているノードの値と一致するノードで実行されていることを意味します。 |
|
| 対応する podAffinityTerm の一致に関連する重み (1〜100 の範囲)。 |
14.1.21. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。この場合の同じ場所とは、キー <topologyKey> のラベルの値が、一連の Pod の Pod が実行されているノードの値と一致するノードで実行されていることを意味します。
- 型
-
object
- 必須
-
topologyKey
-
プロパティー | 型 | 説明 |
---|---|---|
| リソースのセット (この場合は Pod) に対するラベルクエリー。 | |
| 用語が適用される namespace のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての namespace に一致します。 | |
|
| namespaces は、用語が適用される namespace 名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび nullnamespaceSelector は、"この Pod の namespace" を意味します |
|
| この Pod は、指定された namespace の labelSelector と一致する Pod と同じ場所 (affinity) または異なる場所 (anti-affinity) に配置します。同じ場所とは、topologyKey キーが含まれるラベルの値が一致し、選択した Pod のいずれかが実行されているノード上で実行されていることを意味します。空の topologyKey は許可されていません。 |
14.1.22. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- このフィールドで指定されたアフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定されたアフィニティー要件が Pod 実行中のある時点で満たされない場合 (Pod ラベルの更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。複数の要素がある場合、各 podAffinityTerm に対応するノードのリストが交差します。つまり、すべての用語が満たされる必要があります。
- 型
-
array
14.1.23. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。この場合の同じ場所とは、キー <topologyKey> のラベルの値が、一連の Pod の Pod が実行されているノードの値と一致するノードで実行されていることを意味します。
- 型
-
object
- 必須
-
topologyKey
-
プロパティー | 型 | 説明 |
---|---|---|
| リソースのセット (この場合は Pod) に対するラベルクエリー。 | |
| 用語が適用される namespace のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての namespace に一致します。 | |
|
| namespaces は、用語が適用される namespace 名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび nullnamespaceSelector は、"この Pod の namespace" を意味します |
|
| この Pod は、指定された namespace の labelSelector と一致する Pod と同じ場所 (affinity) または異なる場所 (anti-affinity) に配置します。同じ場所とは、topologyKey キーが含まれるラベルの値が一致し、選択した Pod のいずれかが実行されているノード上で実行されていることを意味します。空の topologyKey は許可されていません。 |
14.1.24. .spec.affinity.podAntiAffinity リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod アンチアフィニティーは、Pod 間アンチアフィニティースケジューリングルールのグループです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| スケジューラーは、このフィールドで指定された非アフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アンチアフィニティー式など) を満たすノードごとに、の要素を反復処理して合計を計算します。このフィールドと、対応する podAffinityTerm に一致する Pod がノードにある場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。 |
|
| 一致したすべての WeightedPodAffinityTerm フィールドの重みがノードごとに追加され、最も優先されるノードが検索されます。 |
|
| このフィールドで指定された非アフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定された非アフィニティー要件が Pod 実行中のある時点で満たされない場合 (Pod ラベルの更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。複数の要素がある場合、各 podAffinityTerm に対応するノードのリストが交差します。つまり、すべての用語が満たされる必要があります。 |
|
| この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。この場合の同じ場所とは、キー <topologyKey> のラベルの値が、一連の Pod の Pod が実行されているノードの値と一致するノードで実行されていることを意味します。 |
14.1.25. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- スケジューラーは、このフィールドで指定された非アフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アンチアフィニティー式など) を満たすノードごとに、の要素を反復処理して合計を計算します。このフィールドと、対応する podAffinityTerm に一致する Pod がノードにある場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。
- 型
-
array
14.1.26. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 一致したすべての WeightedPodAffinityTerm フィールドの重みがノードごとに追加され、最も優先されるノードが検索されます。
- 型
-
object
- 必須
-
weight
-
podAffinityTerm
-
プロパティー | 型 | 説明 |
---|---|---|
|
| この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。この場合の同じ場所とは、キー <topologyKey> のラベルの値が、一連の Pod の Pod が実行されているノードの値と一致するノードで実行されていることを意味します。 |
|
| 対応する podAffinityTerm の一致に関連する重み (1〜100 の範囲)。 |
14.1.27. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。この場合の同じ場所とは、キー <topologyKey> のラベルの値が、一連の Pod の Pod が実行されているノードの値と一致するノードで実行されていることを意味します。
- 型
-
object
- 必須
-
topologyKey
-
プロパティー | 型 | 説明 |
---|---|---|
| リソースのセット (この場合は Pod) に対するラベルクエリー。 | |
| 用語が適用される namespace のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての namespace に一致します。 | |
|
| namespaces は、用語が適用される namespace 名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび nullnamespaceSelector は、"この Pod の namespace" を意味します |
|
| この Pod は、指定された namespace の labelSelector と一致する Pod と同じ場所 (affinity) または異なる場所 (anti-affinity) に配置します。同じ場所とは、topologyKey キーが含まれるラベルの値が一致し、選択した Pod のいずれかが実行されているノード上で実行されていることを意味します。空の topologyKey は許可されていません。 |
14.1.28. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- このフィールドで指定された非アフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定された非アフィニティー要件が Pod 実行中のある時点で満たされない場合 (Pod ラベルの更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。複数の要素がある場合、各 podAffinityTerm に対応するノードのリストが交差します。つまり、すべての用語が満たされる必要があります。
- 型
-
array
14.1.29. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。この場合の同じ場所とは、キー <topologyKey> のラベルの値が、一連の Pod の Pod が実行されているノードの値と一致するノードで実行されていることを意味します。
- 型
-
object
- 必須
-
topologyKey
-
プロパティー | 型 | 説明 |
---|---|---|
| リソースのセット (この場合は Pod) に対するラベルクエリー。 | |
| 用語が適用される namespace のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての namespace に一致します。 | |
|
| namespaces は、用語が適用される namespace 名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび nullnamespaceSelector は、"この Pod の namespace" を意味します |
|
| この Pod は、指定された namespace の labelSelector と一致する Pod と同じ場所 (affinity) または異なる場所 (anti-affinity) に配置します。同じ場所とは、topologyKey キーが含まれるラベルの値が一致し、選択した Pod のいずれかが実行されているノード上で実行されていることを意味します。空の topologyKey は許可されていません。 |
14.1.30. .spec.containers リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod に属するコンテナーのリスト。現在、コンテナーを追加または削除することはできません。Pod には少なくとも 1 つのコンテナーが必要です。これを更新することはできません。
- 型
-
array
14.1.31. .spec.containers[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod 内で実行する単一のアプリケーションコンテナー。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| エントリーポイントへの引数。これが指定されていない場合は、コンテナーイメージの CMD が使用されます。変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、"(VAR_NAME)" は文字列リテラル "$(VAR_NAME)" を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。これを更新することはできません。詳細: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell |
|
| エントリーポイント配列。シェル内では実行されません。これが指定されていない場合は、コンテナーイメージの ENTRYPOINT が使用されます。変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、"(VAR_NAME)" は文字列リテラル "$(VAR_NAME)" を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。これを更新することはできません。詳細: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell |
|
| コンテナーに設定する環境変数のリスト。これを更新することはできません。 |
|
| EnvVar は、コンテナーに存在する環境変数を表します。 |
|
| コンテナー内の環境変数に入力するソースのリスト。ソース内で定義されたキーは C_IDENTIFIER である必要があります。無効なキーはすべて、コンテナーの起動時にイベントとして報告されます。キーが複数のソースに存在する場合、最後のソースに関連付けられた値が優先されます。重複キーを持つ環境によって定義された値が優先されます。これを更新することはできません。 |
|
| EnvFromSource は、一連の ConfigMap のソースを表します |
|
| コンテナーイメージ名詳細: https://kubernetes.io/docs/concepts/containers/images このフィールドはオプションであり、高レベルの設定管理で、Deployments や StatefulSets などのワークロードコントローラーのコンテナーイメージをデフォルトまたはオーバーライドできます。 |
|
| イメージプルポリシーAlways、Never、IfNotPresent のいずれか。デフォルトは、:latest タグが指定されている場合は常に、それ以外の場合は IfNotPresent です。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/containers/images#updating-images
使用可能な列挙値: - |
|
| ライフサイクルは、コンテナーのライフサイクルイベントに対応して管理システムが実行する必要のあるアクションを表します。PostStart および PreStop ライフサイクルハンドラーの場合、コンテナープロセスが失敗しない限り、アクションが完了するまでコンテナー管理がブロックされます。失敗した場合、ハンドラーは中止されます。 |
|
| プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。 |
|
| DNS_LABEL として指定されたコンテナーの名前。Pod 内の各コンテナーには、一意の名前 (DNS_LABEL) が必要です。これを更新することはできません。 |
|
| コンテナーから公開するポートのリスト。ここでポートを指定しなくても、そのポートが公開されるのを防ぐことはできません。コンテナー内のデフォルトの "0.0.0.0" アドレスをリッスンしているポートは、ネットワークからアクセスできます。戦略的マージパッチを使用してこの配列を変更すると、データが破損する可能性があります。詳細は、https://github.com/kubernetes/kubernetes/issues/108255 を参照してください。これを更新することはできません。 |
|
| ContainerPort は、単一のコンテナー内のネットワークポートを表します。 |
|
| プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。 |
|
| コンテナーのリソースサイズ変更ポリシー。 |
|
| ContainerResizePolicy は、コンテナーのリソースサイズ変更ポリシーを表します。 |
|
| ResourceRequirements は、コンピュートリソースの要件を説明します。 |
|
| RestartPolicy は、Pod 内の個々のコンテナーの再起動動作を定義します。このフィールドは init コンテナーに対してのみ設定でき、許可される値は "Always" のみです。init 以外のコンテナーの場合、またはこのフィールドが指定されていない場合、再起動の動作は Pod の再起動ポリシーとコンテナータイプによって定義されます。init コンテナーの RestartPolicy を "Always" に設定すると、次の効果が得られます: この init コンテナーは、すべての通常のコンテナーが終了するまで、終了時に継続的に再起動されます。すべての通常のコンテナーが完了すると、restartPolicy が "Always" のすべての init コンテナーがシャットダウンされます。このライフサイクルは通常の init コンテナーとは異なり、多くの場合、"sidecar" コンテナーと呼ばれます。この init コンテナーは、引き続き init コンテナーシーケンス内で開始されますが、次の init コンテナーに進む前にコンテナーが完了するのを待機しません。代わりに、この init コンテナーが起動した直後、または任意の startupProbe が正常に完了した後に、次の init コンテナーが起動します。 |
|
| SecurityContext は、コンテナーに適用されるセキュリティー設定を保持します。一部のフィールドは、SecurityContext と PodSecurityContext の両方に存在します。両方が設定されている場合は、SecurityContext の値が優先されます。 |
|
| プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。 |
|
| このコンテナーがコンテナーランタイムで stdin にバッファーを割り当てる必要があるかどうか。これが設定されていない場合、コンテナー内の stdin からの読み取りは常に EOF になります。デフォルトは false です。 |
|
| コンテナーランタイムが、単一の接続によって開かれた後に stdin チャネルを閉じる必要があるかどうか。stdin が true の場合、stdin ストリームは複数の接続セッションにわたって開いたままになります。stdinOnce が true に設定されている場合、stdin はコンテナーの起動時に開かれ、最初のクライアントが stdin に接続するまで空になり、クライアントが切断されるまで開いたままでデータを受け入れます。切断されると、stdin は閉じられ、コンテナーが再起動されるまで閉じられたままになります。。このフラグが false の場合、stdin から読み取るコンテナープロセスは EOF を受信しません。デフォルトは false です。 |
|
| オプション: コンテナーの終了メッセージが書き込まれるファイルがコンテナーのファイルシステムにマウントされるパス。書き込まれるメッセージは、アサーション失敗メッセージなどの簡単な最終ステータスを目的としています。4096 バイトを超える場合、ノードによって切り捨てられます。すべてのコンテナーの合計メッセージ長は 12kb に制限されます。デフォルトは/dev/termination-log です。これを更新することはできません。 |
|
| 終了メッセージの入力方法を示します。ファイルは、terminationMessagePath の内容を使用して、成功と失敗の両方でコンテナーステータスメッセージを入力します。終了メッセージファイルが空で、コンテナーがエラーで終了した場合、FallbackToLogsOnError はコンテナーログ出力の最後のチャンクを使用します。ログ出力は、2048 バイトまたは 80 行のいずれか小さい方に制限されます。デフォルトは File です。これを更新することはできません。
使用可能な列挙値: - |
|
| このコンテナーがそれ自体に TTY を割り当てる必要があるかどうかには、'stdin' が true である必要もあります。デフォルトは false です。 |
|
| volumeDevices は、コンテナーによって使用されるブロックデバイスのリストです。 |
|
| volumeDevice は、コンテナー内の raw ブロックデバイスのマッピングを記述します。 |
|
| コンテナーのファイルシステムにマウントする Pod ボリューム。これを更新することはできません。 |
|
| VolumeMount は、コンテナー内でのボリュームのマウントを説明します。 |
|
| コンテナーの作業ディレクトリー。指定しない場合、コンテナーランタイムのデフォルトが使用されます。これは、コンテナーイメージで設定されている可能性があります。これを更新することはできません。 |
14.1.32. .spec.containers[].env リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナーに設定する環境変数のリスト。これを更新することはできません。
- 型
-
array
14.1.33. .spec.containers[].env[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- EnvVar は、コンテナーに存在する環境変数を表します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 環境変数の名前。C_IDENTIFIER でなければなりません。 |
|
| 変数参照 $(VAR_NAME) は、コンテナー内で以前に定義された環境変数と任意のサービス環境変数を使用してデプロイメントされます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、"(VAR_NAME)" は文字列リテラル "$(VAR_NAME)" を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。デフォルトは "" です。 |
|
| EnvVarSource は、EnvVar の値のソースを表します。 |
14.1.34. .spec.containers[].env[].valueFrom リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- EnvVarSource は、EnvVar の値のソースを表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ConfigMap からキーを選択します。 |
|
| ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。 |
|
| ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。 |
|
| SecretKeySelector は、シークレットのキーを選択します。 |
14.1.35. .spec.containers[].env[].valueFrom.configMapKeyRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ConfigMap からキーを選択します。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
14.1.36. .spec.containers[].env[].valueFrom.fieldRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。
- 型
-
object
- 必須
-
fieldPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| FieldPath が記述されているスキーマのバージョン。デフォルトは "v1" です。 |
|
| 指定された API バージョンで選択するフィールドのパス。 |
14.1.37. .spec.containers[].env[].valueFrom.resourceFieldRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。
- 型
-
object
- 必須
-
resource
-
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナー名: ボリュームには必須、env 変数にはオプション |
| 公開されたリソースの出力形式を指定します。デフォルトは "1" です。 | |
|
| 必須: 選択するリソース |
14.1.38. .spec.containers[].env[].valueFrom.secretKeyRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SecretKeySelector は、シークレットのキーを選択します。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
14.1.39. .spec.containers[].envFrom リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナー内の環境変数に入力するソースのリスト。ソース内で定義されたキーは C_IDENTIFIER である必要があります。無効なキーはすべて、コンテナーの起動時にイベントとして報告されます。キーが複数のソースに存在する場合、最後のソースに関連付けられた値が優先されます。重複キーを持つ環境によって定義された値が優先されます。これを更新することはできません。
- 型
-
array
14.1.40. .spec.containers[].envFrom[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- EnvFromSource は、一連の ConfigMap のソースを表します
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ConfigMapEnvSource は、環境変数に入力する ConfigMap を選択します。 ターゲットの ConfigMap のデータフィールドの内容は、キーと値のペアを環境変数として表します。 |
|
| ConfigMap の各キーの前に追加するオプションの識別子。C_IDENTIFIER でなければなりません。 |
|
| SecretEnvSource は、環境変数に入力するシークレットを選択します。 ターゲットシークレットのデータフィールドの内容は、キーと値のペアを環境変数として表します。 |
14.1.41. .spec.containers[].envFrom[].configMapRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
ConfigMapEnvSource は、環境変数に入力する ConfigMap を選択します。
ターゲットの ConfigMap のデータフィールドの内容は、キーと値のペアを環境変数として表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap を定義する必要があるかどうかを指定します |
14.1.42. .spec.containers[].envFrom[].secretRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
SecretEnvSource は、環境変数に入力するシークレットを選択します。
ターゲットシークレットのデータフィールドの内容は、キーと値のペアを環境変数として表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットを定義する必要があるかどうかを指定します |
14.1.43. .spec.containers[].lifecycle リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ライフサイクルは、コンテナーのライフサイクルイベントに対応して管理システムが実行する必要のあるアクションを表します。PostStart および PreStop ライフサイクルハンドラーの場合、コンテナープロセスが失敗しない限り、アクションが完了するまでコンテナー管理がブロックされます。失敗した場合、ハンドラーは中止されます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。 |
|
| LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。 |
14.1.44. .spec.containers[].lifecycle.postStart リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
14.1.45. .spec.containers[].lifecycle.postStart.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.1.46. .spec.containers[].lifecycle.postStart.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
14.1.47. .spec.containers[].lifecycle.postStart.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
14.1.48. .spec.containers[].lifecycle.postStart.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.1.49. .spec.containers[].lifecycle.postStart.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.1.50. .spec.containers[].lifecycle.preStop リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
14.1.51. .spec.containers[].lifecycle.preStop.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.1.52. .spec.containers[].lifecycle.preStop.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
14.1.53. .spec.containers[].lifecycle.preStop.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
14.1.54. .spec.containers[].lifecycle.preStop.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.1.55. .spec.containers[].lifecycle.preStop.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.1.56. .spec.containers[].livenessProbe リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| 正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。 |
|
| GRPC は、GRPC ポートに関連するアクションを指定します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。 |
|
| 失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
|
| プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。 |
|
| プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
14.1.57. .spec.containers[].livenessProbe.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.1.58. .spec.containers[].livenessProbe.grpc リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GRPC は、GRPC ポートに関連するアクションを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| gRPC サービスのポート番号。番号は 1〜65535 の範囲である必要があります。 |
|
| Service は、gRPC HealthCheckRequest に配置するサービスの名前です (https://github.com/grpc/grpc/blob/master/doc/health-checking.md を参照)。 これが指定されていない場合、デフォルトの動作は gRPC によって定義されます。 |
14.1.59. .spec.containers[].livenessProbe.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
14.1.60. .spec.containers[].livenessProbe.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
14.1.61. .spec.containers[].livenessProbe.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.1.62. .spec.containers[].livenessProbe.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.1.63. .spec.containers[].ports リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナーから公開するポートのリスト。ここでポートを指定しなくても、そのポートが公開されるのを防ぐことはできません。コンテナー内のデフォルトの "0.0.0.0" アドレスをリッスンしているポートは、ネットワークからアクセスできます。戦略的マージパッチを使用してこの配列を変更すると、データが破損する可能性があります。詳細は、https://github.com/kubernetes/kubernetes/issues/108255 を参照してください。これを更新することはできません。
- 型
-
array
14.1.64. .spec.containers[].ports[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerPort は、単一のコンテナー内のネットワークポートを表します。
- 型
-
object
- 必須
-
containerPort
-
プロパティー | 型 | 説明 |
---|---|---|
|
| Pod の IP アドレスで公開するポートの数。これは有効なポート番号である必要があります、0<x<65536。 |
|
| 外部ポートをバインドするホスト IP。 |
|
| ホストで公開するポートの数。指定する場合、これは有効なポート番号、0<x<65536 である必要があります。HostNetwork が指定されている場合、これは ContainerPort と一致する必要があります。ほとんどのコンテナーはこれを必要としません。 |
|
| 指定する場合、これは IANA_SVC_NAME であり、Pod 内で一意である必要があります。Pod 内の名前付きポートにはそれぞれ一意の名前を付ける必要があります。サービスが参照できるポートの名前。 |
|
| ポートのプロトコル。UDP、TCP、または SCTP である必要があります。デフォルトは "TCP" です。
使用可能な列挙値: - |
14.1.65. .spec.containers[].readinessProbe リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| 正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。 |
|
| GRPC は、GRPC ポートに関連するアクションを指定します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。 |
|
| 失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
|
| プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。 |
|
| プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
14.1.66. .spec.containers[].readinessProbe.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.1.67. .spec.containers[].readinessProbe.grpc リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GRPC は、GRPC ポートに関連するアクションを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| gRPC サービスのポート番号。番号は 1〜65535 の範囲である必要があります。 |
|
| Service は、gRPC HealthCheckRequest に配置するサービスの名前です (https://github.com/grpc/grpc/blob/master/doc/health-checking.md を参照)。 これが指定されていない場合、デフォルトの動作は gRPC によって定義されます。 |
14.1.68. .spec.containers[].readinessProbe.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
14.1.69. .spec.containers[].readinessProbe.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
14.1.70. .spec.containers[].readinessProbe.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.1.71. .spec.containers[].readinessProbe.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.1.72. .spec.containers[].resizePolicy リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナーのリソースサイズ変更ポリシー。
- 型
-
array
14.1.73. .spec.containers[].resizePolicy[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerResizePolicy は、コンテナーのリソースサイズ変更ポリシーを表します。
- 型
-
object
- 必須
-
resourceName
-
restartPolicy
-
プロパティー | 型 | 説明 |
---|---|---|
|
| このリソースサイズ変更ポリシーが適用されるリソースの名前。対応している値は、cpu、memory です。 |
|
| 指定されたリソースのサイズが変更されたときに適用する再起動ポリシー。指定しない場合、デフォルトの NotRequired が設定されます。 |
14.1.74. .spec.containers[].resources リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceRequirements は、コンピュートリソースの要件を説明します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。 これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。 このフィールドは不変です。これはコンテナーにのみ設定できます。 |
|
| ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。 |
| limits は、許可されるコンピュートリソースの最大量を示します。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 | |
| requests は、必要なコンピュートリソースの最小量を示します。コンテナーで Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
14.1.75. .spec.containers[].resources.claims リンクのコピーリンクがクリップボードにコピーされました!
- 説明
Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。
これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。
このフィールドは不変です。これはコンテナーにのみ設定できます。
- 型
-
array
14.1.76. .spec.containers[].resources.claims[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。 |
14.1.77. .spec.containers[].securityContext リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SecurityContext は、コンテナーに適用されるセキュリティー設定を保持します。一部のフィールドは、SecurityContext と PodSecurityContext の両方に存在します。両方が設定されている場合は、SecurityContext の値が優先されます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| AllowPrivilegeEscalation は、プロセスがその親プロセスよりも多くの特権を取得できるかどうかを制御します。このブール値は、no_new_privs フラグがコンテナープロセスに設定されるかどうかを直接制御します。コンテナーが 1) 特権で実行されており、CAP_SYS_ADMIN が割り当てられている場合、2) AllowPrivilegeEscalation は常に true です。spec.os.name が windows の場合は、このフィールドは設定できないことに注意してください。 |
|
| 実行中のコンテナーに POSIX 機能を追加および削除します。 |
|
| コンテナーを特権モードで実行します。特権コンテナー内のプロセスは、基本的にホスト上の root と同等です。デフォルトは false です。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| procMount は、コンテナーに使用する proc マウントのタイプを示します。デフォルトは DefaultProcMount で、読み取り専用パスとマスクされたパスにコンテナーランタイムのデフォルトを使用します。これには、ProcMountType 機能フラグを有効にする必要があります。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
使用可能な列挙値: - |
|
| このコンテナーに読み取り専用のルートファイルシステムがあるかどうか。デフォルトは false です。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| コンテナープロセスのエントリーポイントを実行するための GID。設定されていない場合は、実行時のデフォルトを使用します。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| コンテナーが root 以外のユーザーとして実行される必要があることを示します。true の場合、Kubelet は実行時にイメージを検証して、イメージが UID 0(ルート) として実行されないことを確認し、実行される場合はコンテナーの開始に失敗します。未設定または false の場合、そのような検証は実行されません。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。 |
|
| コンテナープロセスのエントリーポイントを実行するための UID。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| SELinuxOptions は、コンテナーに適用されるラベルです。 |
|
| SeccompProfile は、Pod/コンテナーの seccomp プロファイル設定を定義します。設定できるプロファイルソースは 1 つだけです。 |
|
| WindowsSecurityContextOptions には、Windows 固有のオプションおよび認証情報が含まれています。 |
14.1.78. .spec.containers[].securityContext.capabilities リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 実行中のコンテナーに POSIX 機能を追加および削除します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 追加された機能 |
|
| 削除された機能 |
14.1.79. .spec.containers[].securityContext.seLinuxOptions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SELinuxOptions は、コンテナーに適用されるラベルです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Level は、コンテナーに適用される SELinux レベルのラベルです。 |
|
| Role は、コンテナーに適用される SELinux ロールラベルです。 |
|
| Type は、コンテナーに適用される SELinux タイプのラベルです。 |
|
| User は、コンテナーに適用される SELinux ユーザーラベルです。 |
14.1.80. .spec.containers[].securityContext.seccompProfile リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SeccompProfile は、Pod/コンテナーの seccomp プロファイル設定を定義します。設定できるプロファイルソースは 1 つだけです。
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| localhostProfile は、ノード上のファイルで定義されたプロファイルを使用する必要があることを示します。プロファイルが機能するには、ノードで事前に設定されている必要があります。kubelet の設定済みの seccomp プロファイルの場所を基準にして、降順のパスである必要があります。タイプが "Localhost" の場合は設定する必要があります。他のタイプには設定しないでください。 |
|
| type は、適用される seccomp プロファイルの種類を示します。有効なオプションは以下のとおりです。 Localhost - ノード上のファイルで定義されたプロファイルを使用する必要があります。RuntimeDefault- コンテナーのランタイムデフォルトプロファイルを使用する必要があります。制限なし - プロファイルを適用しないでください。
使用可能な列挙値: - |
14.1.81. .spec.containers[].securityContext.windowsOptions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- WindowsSecurityContextOptions には、Windows 固有のオプションおよび認証情報が含まれています。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| GMSACredentialSpec は、GMSA アドミッション Webhook (https://github.com/kubernetes-sigs/windows-gmsa) が GMSACredentialSpecName フィールドで指定された GMSA クレデンシャル仕様のコンテンツをインライン化する場所です。 |
|
| GMSACredentialSpecName は、使用する GMSA 認証情報仕様の名前です。 |
|
| hostProcess は、コンテナーを 'Host Process' コンテナーとして実行する必要があるかどうかを決定します。Pod のすべてのコンテナーは、同じ有効な HostProcess 値を持っている必要があります (HostProcess コンテナーと非 HostProcess コンテナーを混在させることはできません)。さらに、HostProcess が true の場合、HostNetwork も true に設定する必要があります。 |
|
| コンテナープロセスのエントリーポイントを実行するための Windows の UserName。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。 |
14.1.82. .spec.containers[].startupProbe リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| 正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。 |
|
| GRPC は、GRPC ポートに関連するアクションを指定します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。 |
|
| 失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
|
| プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。 |
|
| プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
14.1.83. .spec.containers[].startupProbe.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.1.84. .spec.containers[].startupProbe.grpc リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GRPC は、GRPC ポートに関連するアクションを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| gRPC サービスのポート番号。番号は 1〜65535 の範囲である必要があります。 |
|
| Service は、gRPC HealthCheckRequest に配置するサービスの名前です (https://github.com/grpc/grpc/blob/master/doc/health-checking.md を参照)。 これが指定されていない場合、デフォルトの動作は gRPC によって定義されます。 |
14.1.85. .spec.containers[].startupProbe.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
14.1.86. .spec.containers[].startupProbe.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
14.1.87. .spec.containers[].startupProbe.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.1.88. .spec.containers[].startupProbe.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.1.89. .spec.containers[].volumeDevices リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- volumeDevices は、コンテナーによって使用されるブロックデバイスのリストです。
- 型
-
array
14.1.90. .spec.containers[].volumeDevices[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- volumeDevice は、コンテナー内の raw ブロックデバイスのマッピングを記述します。
- 型
-
object
- 必須
-
name
-
devicePath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| devicePath は、デバイスがマップされるコンテナー内のパスです。 |
|
| name は、Pod 内の persistentVolumeClaim の名前と一致する必要があります |
14.1.91. .spec.containers[].volumeMounts リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナーのファイルシステムにマウントする Pod ボリューム。これを更新することはできません。
- 型
-
array
14.1.92. .spec.containers[].volumeMounts[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- VolumeMount は、コンテナー内でのボリュームのマウントを説明します。
- 型
-
object
- 必須
-
name
-
mountPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ボリュームをマウントする必要があるコンテナー内のパス。':' を含めることはできません。 |
|
| mountPropagation は、マウントがホストからコンテナーに、またはその逆にどのように伝播されるかを決定します。設定されていない場合、MountPropagationNone が使用されます。このフィールドは 1.10 のベータ版です。
使用可能な列挙値: - |
|
| ボリュームの名前に一致する必要があります。 |
|
| true の場合は読み取り専用、それ以外の場合は読み取り/書き込み (false または指定なし) でマウントされます。デフォルトは false です。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内のパス。デフォルトは "" (ボリュームのルート) です。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内の拡張パス。SubPath と同様に動作しますが、環境変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。デフォルトは "" (ボリュームのルート) です。SubPathExpr と SubPath は相互に排他的です。 |
14.1.93. .spec.dnsConfig リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodDNSConfig は、DNSPolicy から生成されたパラメーターに加えて、Pod の DNS パラメーターを定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| DNS ネームサーバーの IP アドレスのリスト。これは、DNSPolicy から生成されたベースネームサーバーに追加されます。重複したネームサーバーは削除されます。 |
|
| DNS リゾルバーオプションのリスト。これは、DNSPolicy から生成された基本オプションとマージされます。重複したエントリーは削除されます。オプションで指定された解決オプションは、ベース DNS ポリシーに表示されるものをオーバーライドします。 |
|
| PodDNSConfigOption は、Pod の DNS リゾルバーオプションを定義します。 |
|
| ホスト名ルックアップ用の DNS 検索ドメインのリスト。これは、DNSPolicy から生成された基本検索パスに追加されます。重複する検索パスは削除されます。 |
14.1.94. .spec.dnsConfig.options リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DNS リゾルバーオプションのリスト。これは、DNSPolicy から生成された基本オプションとマージされます。重複したエントリーは削除されます。オプションで指定された解決オプションは、ベース DNS ポリシーに表示されるものをオーバーライドします。
- 型
-
array
14.1.95. .spec.dnsConfig.options[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodDNSConfigOption は、Pod の DNS リゾルバーオプションを定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 必須。 |
|
|
14.1.96. .spec.ephemeralContainers リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- この Pod で実行されるエフェメラルコンテナーのリスト。エフェメラルコンテナーを既存の Pod で実行して、デバッグなどのユーザーが開始するアクションを実行できます。このリストは、Pod の作成時に指定することはできません。また、Pod の仕様を更新して変更することもできません。エフェメラルコンテナーを既存の Pod に追加するには、Pod のエフェメラルコンテナーサブリソースを使用します。
- 型
-
array
14.1.97. .spec.ephemeralContainers[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
EphemeralContainer は、デバッグなど、ユーザーが開始したアクティビティーに対して、既存の Pod に追加できる一時コンテナーです。エフェメラルコンテナーにはリソースやスケジュールの保証がなく、コンテナーの終了時、または Pod の削除または再起動時に再起動されません。エフェメラルコンテナーが原因で Pod がリソース割り当てを超過した場合、kubelet は Pod をエビクトする可能性があります。
エフェメラルコンテナーを追加するには、既存の Pod の ephemeralcontainers サブリソースを使用します。エフェメラルコンテナーは削除または再起動できません。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| エントリーポイントへの引数。このプロパティが指定されていない場合は、イメージの CMD が使用されます。変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、"(VAR_NAME)" は文字列リテラル "$(VAR_NAME)" を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。これを更新することはできません。詳細: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell |
|
| エントリーポイント配列。シェル内では実行されません。これが指定されていない場合は、イメージの ENTRYPOINT が使用されます。変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、"(VAR_NAME)" は文字列リテラル "$(VAR_NAME)" を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。これを更新することはできません。詳細: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell |
|
| コンテナーに設定する環境変数のリスト。これを更新することはできません。 |
|
| EnvVar は、コンテナーに存在する環境変数を表します。 |
|
| コンテナー内の環境変数に入力するソースのリスト。ソース内で定義されたキーは C_IDENTIFIER である必要があります。無効なキーはすべて、コンテナーの起動時にイベントとして報告されます。キーが複数のソースに存在する場合、最後のソースに関連付けられた値が優先されます。重複キーを持つ環境によって定義された値が優先されます。これを更新することはできません。 |
|
| EnvFromSource は、一連の ConfigMap のソースを表します |
|
| コンテナーイメージ名詳細: https://kubernetes.io/docs/concepts/containers/images |
|
| イメージプルポリシーAlways、Never、IfNotPresent のいずれか。デフォルトは、:latest タグが指定されている場合は常に、それ以外の場合は IfNotPresent です。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/containers/images#updating-images
使用可能な列挙値: - |
|
| ライフサイクルは、コンテナーのライフサイクルイベントに対応して管理システムが実行する必要のあるアクションを表します。PostStart および PreStop ライフサイクルハンドラーの場合、コンテナープロセスが失敗しない限り、アクションが完了するまでコンテナー管理がブロックされます。失敗した場合、ハンドラーは中止されます。 |
|
| プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。 |
|
| DNS_LABEL として指定されたエフェメラルコンテナーの名前。この名前は、すべてのコンテナー、init コンテナー、およびエフェメラルコンテナーの中で一意である必要があります。 |
|
| エフェメラルコンテナーのポートは許可されていません。 |
|
| ContainerPort は、単一のコンテナー内のネットワークポートを表します。 |
|
| プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。 |
|
| コンテナーのリソースサイズ変更ポリシー。 |
|
| ContainerResizePolicy は、コンテナーのリソースサイズ変更ポリシーを表します。 |
|
| ResourceRequirements は、コンピュートリソースの要件を説明します。 |
|
| Pod 内の各コンテナーの再起動動作を管理するためのコンテナーの再起動ポリシー。これは init コンテナーに対してのみ設定できます。このフィールドは一時コンテナーには設定できません。 |
|
| SecurityContext は、コンテナーに適用されるセキュリティー設定を保持します。一部のフィールドは、SecurityContext と PodSecurityContext の両方に存在します。両方が設定されている場合は、SecurityContext の値が優先されます。 |
|
| プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。 |
|
| このコンテナーがコンテナーランタイムで stdin にバッファーを割り当てる必要があるかどうか。これが設定されていない場合、コンテナー内の stdin からの読み取りは常に EOF になります。デフォルトは false です。 |
|
| コンテナーランタイムが、単一の接続によって開かれた後に stdin チャネルを閉じる必要があるかどうか。stdin が true の場合、stdin ストリームは複数の接続セッションにわたって開いたままになります。stdinOnce が true に設定されている場合、stdin はコンテナーの起動時に開かれ、最初のクライアントが stdin に接続するまで空になり、クライアントが切断されるまで開いたままでデータを受け入れます。切断されると、stdin は閉じられ、コンテナーが再起動されるまで閉じられたままになります。。このフラグが false の場合、stdin から読み取るコンテナープロセスは EOF を受信しません。デフォルトは false です。 |
|
| 設定されている場合、このエフェメラルコンテナーがターゲットとする PodSpec からのコンテナーの名前。エフェメラルコンテナーは、このコンテナーの namespace (IPC、PID など) で実行されます。設定されていない場合、エフェメラルコンテナーは Pod 仕様で設定された namespace を使用します。 コンテナーランタイムは、この機能のサポートを実装する必要があります。ランタイムが namespace ターゲットをサポートしていない場合、このフィールドの設定結果は定義されません。 |
|
| オプション: コンテナーの終了メッセージが書き込まれるファイルがコンテナーのファイルシステムにマウントされるパス。書き込まれるメッセージは、アサーション失敗メッセージなどの簡単な最終ステータスを目的としています。4096 バイトを超える場合、ノードによって切り捨てられます。すべてのコンテナーの合計メッセージ長は 12kb に制限されます。デフォルトは/dev/termination-log です。これを更新することはできません。 |
|
| 終了メッセージの入力方法を示します。ファイルは、terminationMessagePath の内容を使用して、成功と失敗の両方でコンテナーステータスメッセージを入力します。終了メッセージファイルが空で、コンテナーがエラーで終了した場合、FallbackToLogsOnError はコンテナーログ出力の最後のチャンクを使用します。ログ出力は、2048 バイトまたは 80 行のいずれか小さい方に制限されます。デフォルトは File です。これを更新することはできません。
使用可能な列挙値: - |
|
| このコンテナーがそれ自体に TTY を割り当てる必要があるかどうかには、'stdin' が true である必要もあります。デフォルトは false です。 |
|
| volumeDevices は、コンテナーによって使用されるブロックデバイスのリストです。 |
|
| volumeDevice は、コンテナー内の raw ブロックデバイスのマッピングを記述します。 |
|
| コンテナーのファイルシステムにマウントする Pod ボリューム。エフェメラルコンテナーでは、サブパスをマウントできません。これを更新することはできません。 |
|
| VolumeMount は、コンテナー内でのボリュームのマウントを説明します。 |
|
| コンテナーの作業ディレクトリー。指定しない場合、コンテナーランタイムのデフォルトが使用されます。これは、コンテナーイメージで設定されている可能性があります。これを更新することはできません。 |
14.1.98. .spec.ephemeralContainers[].env リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナーに設定する環境変数のリスト。これを更新することはできません。
- 型
-
array
14.1.99. .spec.ephemeralContainers[].env[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- EnvVar は、コンテナーに存在する環境変数を表します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 環境変数の名前。C_IDENTIFIER でなければなりません。 |
|
| 変数参照 $(VAR_NAME) は、コンテナー内で以前に定義された環境変数と任意のサービス環境変数を使用してデプロイメントされます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、"(VAR_NAME)" は文字列リテラル "$(VAR_NAME)" を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。デフォルトは "" です。 |
|
| EnvVarSource は、EnvVar の値のソースを表します。 |
14.1.100. .spec.ephemeralContainers[].env[].valueFrom リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- EnvVarSource は、EnvVar の値のソースを表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ConfigMap からキーを選択します。 |
|
| ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。 |
|
| ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。 |
|
| SecretKeySelector は、シークレットのキーを選択します。 |
14.1.101. .spec.ephemeralContainers[].env[].valueFrom.configMapKeyRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ConfigMap からキーを選択します。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
14.1.102. .spec.ephemeralContainers[].env[].valueFrom.fieldRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。
- 型
-
object
- 必須
-
fieldPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| FieldPath が記述されているスキーマのバージョン。デフォルトは "v1" です。 |
|
| 指定された API バージョンで選択するフィールドのパス。 |
14.1.103. .spec.ephemeralContainers[].env[].valueFrom.resourceFieldRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。
- 型
-
object
- 必須
-
resource
-
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナー名: ボリュームには必須、env 変数にはオプション |
| 公開されたリソースの出力形式を指定します。デフォルトは "1" です。 | |
|
| 必須: 選択するリソース |
14.1.104. .spec.ephemeralContainers[].env[].valueFrom.secretKeyRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SecretKeySelector は、シークレットのキーを選択します。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
14.1.105. .spec.ephemeralContainers[].envFrom リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナー内の環境変数に入力するソースのリスト。ソース内で定義されたキーは C_IDENTIFIER である必要があります。無効なキーはすべて、コンテナーの起動時にイベントとして報告されます。キーが複数のソースに存在する場合、最後のソースに関連付けられた値が優先されます。重複キーを持つ環境によって定義された値が優先されます。これを更新することはできません。
- 型
-
array
14.1.106. .spec.ephemeralContainers[].envFrom[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- EnvFromSource は、一連の ConfigMap のソースを表します
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ConfigMapEnvSource は、環境変数に入力する ConfigMap を選択します。 ターゲットの ConfigMap のデータフィールドの内容は、キーと値のペアを環境変数として表します。 |
|
| ConfigMap の各キーの前に追加するオプションの識別子。C_IDENTIFIER でなければなりません。 |
|
| SecretEnvSource は、環境変数に入力するシークレットを選択します。 ターゲットシークレットのデータフィールドの内容は、キーと値のペアを環境変数として表します。 |
14.1.107. .spec.ephemeralContainers[].envFrom[].configMapRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
ConfigMapEnvSource は、環境変数に入力する ConfigMap を選択します。
ターゲットの ConfigMap のデータフィールドの内容は、キーと値のペアを環境変数として表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap を定義する必要があるかどうかを指定します |
14.1.108. .spec.ephemeralContainers[].envFrom[].secretRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
SecretEnvSource は、環境変数に入力するシークレットを選択します。
ターゲットシークレットのデータフィールドの内容は、キーと値のペアを環境変数として表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットを定義する必要があるかどうかを指定します |
14.1.109. .spec.ephemeralContainers[].lifecycle リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ライフサイクルは、コンテナーのライフサイクルイベントに対応して管理システムが実行する必要のあるアクションを表します。PostStart および PreStop ライフサイクルハンドラーの場合、コンテナープロセスが失敗しない限り、アクションが完了するまでコンテナー管理がブロックされます。失敗した場合、ハンドラーは中止されます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。 |
|
| LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。 |
14.1.110. .spec.ephemeralContainers[].lifecycle.postStart リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
14.1.111. .spec.ephemeralContainers[].lifecycle.postStart.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.1.112. .spec.ephemeralContainers[].lifecycle.postStart.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
14.1.113. .spec.ephemeralContainers[].lifecycle.postStart.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
14.1.114. .spec.ephemeralContainers[].lifecycle.postStart.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.1.115. .spec.ephemeralContainers[].lifecycle.postStart.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.1.116. .spec.ephemeralContainers[].lifecycle.preStop リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
14.1.117. .spec.ephemeralContainers[].lifecycle.preStop.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.1.118. .spec.ephemeralContainers[].lifecycle.preStop.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
14.1.119. .spec.ephemeralContainers[].lifecycle.preStop.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
14.1.120. .spec.ephemeralContainers[].lifecycle.preStop.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.1.121. .spec.ephemeralContainers[].lifecycle.preStop.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.1.122. .spec.ephemeralContainers[].livenessProbe リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| 正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。 |
|
| GRPC は、GRPC ポートに関連するアクションを指定します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。 |
|
| 失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
|
| プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。 |
|
| プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
14.1.123. .spec.ephemeralContainers[].livenessProbe.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.1.124. .spec.ephemeralContainers[].livenessProbe.grpc リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GRPC は、GRPC ポートに関連するアクションを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| gRPC サービスのポート番号。番号は 1〜65535 の範囲である必要があります。 |
|
| Service は、gRPC HealthCheckRequest に配置するサービスの名前です (https://github.com/grpc/grpc/blob/master/doc/health-checking.md を参照)。 これが指定されていない場合、デフォルトの動作は gRPC によって定義されます。 |
14.1.125. .spec.ephemeralContainers[].livenessProbe.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
14.1.126. .spec.ephemeralContainers[].livenessProbe.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
14.1.127. .spec.ephemeralContainers[].livenessProbe.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.1.128. .spec.ephemeralContainers[].livenessProbe.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.1.129. .spec.ephemeralContainers[].ports リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- エフェメラルコンテナーのポートは許可されていません。
- 型
-
array
14.1.130. .spec.ephemeralContainers[].ports[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerPort は、単一のコンテナー内のネットワークポートを表します。
- 型
-
object
- 必須
-
containerPort
-
プロパティー | 型 | 説明 |
---|---|---|
|
| Pod の IP アドレスで公開するポートの数。これは有効なポート番号である必要があります、0<x<65536。 |
|
| 外部ポートをバインドするホスト IP。 |
|
| ホストで公開するポートの数。指定する場合、これは有効なポート番号、0<x<65536 である必要があります。HostNetwork が指定されている場合、これは ContainerPort と一致する必要があります。ほとんどのコンテナーはこれを必要としません。 |
|
| 指定する場合、これは IANA_SVC_NAME であり、Pod 内で一意である必要があります。Pod 内の名前付きポートにはそれぞれ一意の名前を付ける必要があります。サービスが参照できるポートの名前。 |
|
| ポートのプロトコル。UDP、TCP、または SCTP である必要があります。デフォルトは "TCP" です。
使用可能な列挙値: - |
14.1.131. .spec.ephemeralContainers[].readinessProbe リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| 正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。 |
|
| GRPC は、GRPC ポートに関連するアクションを指定します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。 |
|
| 失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
|
| プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。 |
|
| プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
14.1.132. .spec.ephemeralContainers[].readinessProbe.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.1.133. .spec.ephemeralContainers[].readinessProbe.grpc リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GRPC は、GRPC ポートに関連するアクションを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| gRPC サービスのポート番号。番号は 1〜65535 の範囲である必要があります。 |
|
| Service は、gRPC HealthCheckRequest に配置するサービスの名前です (https://github.com/grpc/grpc/blob/master/doc/health-checking.md を参照)。 これが指定されていない場合、デフォルトの動作は gRPC によって定義されます。 |
14.1.134. .spec.ephemeralContainers[].readinessProbe.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
14.1.135. .spec.ephemeralContainers[].readinessProbe.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
14.1.136. .spec.ephemeralContainers[].readinessProbe.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.1.137. .spec.ephemeralContainers[].readinessProbe.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.1.138. .spec.ephemeralContainers[].resizePolicy リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナーのリソースサイズ変更ポリシー。
- 型
-
array
14.1.139. .spec.ephemeralContainers[].resizePolicy[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerResizePolicy は、コンテナーのリソースサイズ変更ポリシーを表します。
- 型
-
object
- 必須
-
resourceName
-
restartPolicy
-
プロパティー | 型 | 説明 |
---|---|---|
|
| このリソースサイズ変更ポリシーが適用されるリソースの名前。対応している値は、cpu、memory です。 |
|
| 指定されたリソースのサイズが変更されたときに適用する再起動ポリシー。指定しない場合、デフォルトの NotRequired が設定されます。 |
14.1.140. .spec.ephemeralContainers[].resources リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceRequirements は、コンピュートリソースの要件を説明します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。 これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。 このフィールドは不変です。これはコンテナーにのみ設定できます。 |
|
| ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。 |
| limits は、許可されるコンピュートリソースの最大量を示します。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 | |
| requests は、必要なコンピュートリソースの最小量を示します。コンテナーで Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
14.1.141. .spec.ephemeralContainers[].resources.claims リンクのコピーリンクがクリップボードにコピーされました!
- 説明
Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。
これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。
このフィールドは不変です。これはコンテナーにのみ設定できます。
- 型
-
array
14.1.142. .spec.ephemeralContainers[].resources.claims[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。 |
14.1.143. .spec.ephemeralContainers[].securityContext リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SecurityContext は、コンテナーに適用されるセキュリティー設定を保持します。一部のフィールドは、SecurityContext と PodSecurityContext の両方に存在します。両方が設定されている場合は、SecurityContext の値が優先されます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| AllowPrivilegeEscalation は、プロセスがその親プロセスよりも多くの特権を取得できるかどうかを制御します。このブール値は、no_new_privs フラグがコンテナープロセスに設定されるかどうかを直接制御します。コンテナーが 1) 特権で実行されており、CAP_SYS_ADMIN が割り当てられている場合、2) AllowPrivilegeEscalation は常に true です。spec.os.name が windows の場合は、このフィールドは設定できないことに注意してください。 |
|
| 実行中のコンテナーに POSIX 機能を追加および削除します。 |
|
| コンテナーを特権モードで実行します。特権コンテナー内のプロセスは、基本的にホスト上の root と同等です。デフォルトは false です。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| procMount は、コンテナーに使用する proc マウントのタイプを示します。デフォルトは DefaultProcMount で、読み取り専用パスとマスクされたパスにコンテナーランタイムのデフォルトを使用します。これには、ProcMountType 機能フラグを有効にする必要があります。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
使用可能な列挙値: - |
|
| このコンテナーに読み取り専用のルートファイルシステムがあるかどうか。デフォルトは false です。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| コンテナープロセスのエントリーポイントを実行するための GID。設定されていない場合は、実行時のデフォルトを使用します。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| コンテナーが root 以外のユーザーとして実行される必要があることを示します。true の場合、Kubelet は実行時にイメージを検証して、イメージが UID 0(ルート) として実行されないことを確認し、実行される場合はコンテナーの開始に失敗します。未設定または false の場合、そのような検証は実行されません。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。 |
|
| コンテナープロセスのエントリーポイントを実行するための UID。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| SELinuxOptions は、コンテナーに適用されるラベルです。 |
|
| SeccompProfile は、Pod/コンテナーの seccomp プロファイル設定を定義します。設定できるプロファイルソースは 1 つだけです。 |
|
| WindowsSecurityContextOptions には、Windows 固有のオプションおよび認証情報が含まれています。 |
14.1.144. .spec.ephemeralContainers[].securityContext.capabilities リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 実行中のコンテナーに POSIX 機能を追加および削除します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 追加された機能 |
|
| 削除された機能 |
14.1.145. .spec.ephemeralContainers[].securityContext.seLinuxOptions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SELinuxOptions は、コンテナーに適用されるラベルです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Level は、コンテナーに適用される SELinux レベルのラベルです。 |
|
| Role は、コンテナーに適用される SELinux ロールラベルです。 |
|
| Type は、コンテナーに適用される SELinux タイプのラベルです。 |
|
| User は、コンテナーに適用される SELinux ユーザーラベルです。 |
14.1.146. .spec.ephemeralContainers[].securityContext.seccompProfile リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SeccompProfile は、Pod/コンテナーの seccomp プロファイル設定を定義します。設定できるプロファイルソースは 1 つだけです。
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| localhostProfile は、ノード上のファイルで定義されたプロファイルを使用する必要があることを示します。プロファイルが機能するには、ノードで事前に設定されている必要があります。kubelet の設定済みの seccomp プロファイルの場所を基準にして、降順のパスである必要があります。タイプが "Localhost" の場合は設定する必要があります。他のタイプには設定しないでください。 |
|
| type は、適用される seccomp プロファイルの種類を示します。有効なオプションは以下のとおりです。 Localhost - ノード上のファイルで定義されたプロファイルを使用する必要があります。RuntimeDefault- コンテナーのランタイムデフォルトプロファイルを使用する必要があります。制限なし - プロファイルを適用しないでください。
使用可能な列挙値: - |
14.1.147. .spec.ephemeralContainers[].securityContext.windowsOptions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- WindowsSecurityContextOptions には、Windows 固有のオプションおよび認証情報が含まれています。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| GMSACredentialSpec は、GMSA アドミッション Webhook (https://github.com/kubernetes-sigs/windows-gmsa) が GMSACredentialSpecName フィールドで指定された GMSA クレデンシャル仕様のコンテンツをインライン化する場所です。 |
|
| GMSACredentialSpecName は、使用する GMSA 認証情報仕様の名前です。 |
|
| hostProcess は、コンテナーを 'Host Process' コンテナーとして実行する必要があるかどうかを決定します。Pod のすべてのコンテナーは、同じ有効な HostProcess 値を持っている必要があります (HostProcess コンテナーと非 HostProcess コンテナーを混在させることはできません)。さらに、HostProcess が true の場合、HostNetwork も true に設定する必要があります。 |
|
| コンテナープロセスのエントリーポイントを実行するための Windows の UserName。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。 |
14.1.148. .spec.ephemeralContainers[].startupProbe リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| 正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。 |
|
| GRPC は、GRPC ポートに関連するアクションを指定します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。 |
|
| 失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
|
| プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。 |
|
| プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
14.1.149. .spec.ephemeralContainers[].startupProbe.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.1.150. .spec.ephemeralContainers[].startupProbe.grpc リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GRPC は、GRPC ポートに関連するアクションを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| gRPC サービスのポート番号。番号は 1〜65535 の範囲である必要があります。 |
|
| Service は、gRPC HealthCheckRequest に配置するサービスの名前です (https://github.com/grpc/grpc/blob/master/doc/health-checking.md を参照)。 これが指定されていない場合、デフォルトの動作は gRPC によって定義されます。 |
14.1.151. .spec.ephemeralContainers[].startupProbe.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
14.1.152. .spec.ephemeralContainers[].startupProbe.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
14.1.153. .spec.ephemeralContainers[].startupProbe.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.1.154. .spec.ephemeralContainers[].startupProbe.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.1.155. .spec.ephemeralContainers[].volumeDevices リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- volumeDevices は、コンテナーによって使用されるブロックデバイスのリストです。
- 型
-
array
14.1.156. .spec.ephemeralContainers[].volumeDevices[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- volumeDevice は、コンテナー内の raw ブロックデバイスのマッピングを記述します。
- 型
-
object
- 必須
-
name
-
devicePath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| devicePath は、デバイスがマップされるコンテナー内のパスです。 |
|
| name は、Pod 内の persistentVolumeClaim の名前と一致する必要があります |
14.1.157. .spec.ephemeralContainers[].volumeMounts リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナーのファイルシステムにマウントする Pod ボリューム。エフェメラルコンテナーでは、サブパスをマウントできません。これを更新することはできません。
- 型
-
array
14.1.158. .spec.ephemeralContainers[].volumeMounts[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- VolumeMount は、コンテナー内でのボリュームのマウントを説明します。
- 型
-
object
- 必須
-
name
-
mountPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ボリュームをマウントする必要があるコンテナー内のパス。':' を含めることはできません。 |
|
| mountPropagation は、マウントがホストからコンテナーに、またはその逆にどのように伝播されるかを決定します。設定されていない場合、MountPropagationNone が使用されます。このフィールドは 1.10 のベータ版です。
使用可能な列挙値: - |
|
| ボリュームの名前に一致する必要があります。 |
|
| true の場合は読み取り専用、それ以外の場合は読み取り/書き込み (false または指定なし) でマウントされます。デフォルトは false です。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内のパス。デフォルトは "" (ボリュームのルート) です。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内の拡張パス。SubPath と同様に動作しますが、環境変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。デフォルトは "" (ボリュームのルート) です。SubPathExpr と SubPath は相互に排他的です。 |
14.1.159. .spec.hostAliases リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HostAliases は、指定された場合に Pod の hosts ファイルに注入されるホストおよび IP のオプションのリストです。これは、hostNetwork 以外の Pod にのみ有効です。
- 型
-
array
14.1.160. .spec.hostAliases[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HostAlias は、Pod の hosts ファイルのエントリーとして挿入される IP とホスト名の間のマッピングを保持します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 上記の IP アドレスのホスト名。 |
|
| ホストファイルエントリーの IP アドレス。 |
14.1.161. .spec.imagePullSecrets リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ImagePullSecrets は、この PodSpec で使用されるイメージをプルするために使用する、同じ名前空間内のシークレットへの参照のオプションのリストです。指定されている場合、これらのシークレットは、使用するために個々のプラー実装に渡されます。詳細: https://kubernetes.io/docs/concepts/containers/images#specifying-imagepullsecrets-on-a-pod
- 型
-
array
14.1.162. .spec.imagePullSecrets[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
14.1.163. .spec.initContainers リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod に属する初期化コンテナーのリスト。コンテナーが開始される前に、初期化コンテナーが順番に実行されます。init コンテナーに障害が発生した場合、Pod は障害が発生したと見なされ、restartPolicy に従って処理されます。init コンテナーまたは通常のコンテナーの名前は、すべてのコンテナー間で一意である必要があります。Init コンテナーには、ライフサイクルアクション、準備プローブ、ライブネスプローブ、またはスタートアッププローブがない場合があります。init コンテナーの resourceRequirements は、各リソースタイプの最大の要求/制限を見つけ、その値の最大値または通常のコンテナーの合計を使用することにより、スケジューリング中に考慮されます。同様の方法で、init コンテナーに制限が適用されます。現在、初期化コンテナーを追加または削除することはできません。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/
- 型
-
array
14.1.164. .spec.initContainers[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod 内で実行する単一のアプリケーションコンテナー。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| エントリーポイントへの引数。これが指定されていない場合は、コンテナーイメージの CMD が使用されます。変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、"(VAR_NAME)" は文字列リテラル "$(VAR_NAME)" を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。これを更新することはできません。詳細: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell |
|
| エントリーポイント配列。シェル内では実行されません。これが指定されていない場合は、コンテナーイメージの ENTRYPOINT が使用されます。変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、"(VAR_NAME)" は文字列リテラル "$(VAR_NAME)" を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。これを更新することはできません。詳細: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell |
|
| コンテナーに設定する環境変数のリスト。これを更新することはできません。 |
|
| EnvVar は、コンテナーに存在する環境変数を表します。 |
|
| コンテナー内の環境変数に入力するソースのリスト。ソース内で定義されたキーは C_IDENTIFIER である必要があります。無効なキーはすべて、コンテナーの起動時にイベントとして報告されます。キーが複数のソースに存在する場合、最後のソースに関連付けられた値が優先されます。重複キーを持つ環境によって定義された値が優先されます。これを更新することはできません。 |
|
| EnvFromSource は、一連の ConfigMap のソースを表します |
|
| コンテナーイメージ名詳細: https://kubernetes.io/docs/concepts/containers/images このフィールドはオプションであり、高レベルの設定管理で、Deployments や StatefulSets などのワークロードコントローラーのコンテナーイメージをデフォルトまたはオーバーライドできます。 |
|
| イメージプルポリシーAlways、Never、IfNotPresent のいずれか。デフォルトは、:latest タグが指定されている場合は常に、それ以外の場合は IfNotPresent です。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/containers/images#updating-images
使用可能な列挙値: - |
|
| ライフサイクルは、コンテナーのライフサイクルイベントに対応して管理システムが実行する必要のあるアクションを表します。PostStart および PreStop ライフサイクルハンドラーの場合、コンテナープロセスが失敗しない限り、アクションが完了するまでコンテナー管理がブロックされます。失敗した場合、ハンドラーは中止されます。 |
|
| プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。 |
|
| DNS_LABEL として指定されたコンテナーの名前。Pod 内の各コンテナーには、一意の名前 (DNS_LABEL) が必要です。これを更新することはできません。 |
|
| コンテナーから公開するポートのリスト。ここでポートを指定しなくても、そのポートが公開されるのを防ぐことはできません。コンテナー内のデフォルトの "0.0.0.0" アドレスをリッスンしているポートは、ネットワークからアクセスできます。戦略的マージパッチを使用してこの配列を変更すると、データが破損する可能性があります。詳細は、https://github.com/kubernetes/kubernetes/issues/108255 を参照してください。これを更新することはできません。 |
|
| ContainerPort は、単一のコンテナー内のネットワークポートを表します。 |
|
| プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。 |
|
| コンテナーのリソースサイズ変更ポリシー。 |
|
| ContainerResizePolicy は、コンテナーのリソースサイズ変更ポリシーを表します。 |
|
| ResourceRequirements は、コンピュートリソースの要件を説明します。 |
|
| RestartPolicy は、Pod 内の個々のコンテナーの再起動動作を定義します。このフィールドは init コンテナーに対してのみ設定でき、許可される値は "Always" のみです。init 以外のコンテナーの場合、またはこのフィールドが指定されていない場合、再起動の動作は Pod の再起動ポリシーとコンテナータイプによって定義されます。init コンテナーの RestartPolicy を "Always" に設定すると、次の効果が得られます: この init コンテナーは、すべての通常のコンテナーが終了するまで、終了時に継続的に再起動されます。すべての通常のコンテナーが完了すると、restartPolicy が "Always" のすべての init コンテナーがシャットダウンされます。このライフサイクルは通常の init コンテナーとは異なり、多くの場合、"sidecar" コンテナーと呼ばれます。この init コンテナーは、引き続き init コンテナーシーケンス内で開始されますが、次の init コンテナーに進む前にコンテナーが完了するのを待機しません。代わりに、この init コンテナーが起動した直後、または任意の startupProbe が正常に完了した後に、次の init コンテナーが起動します。 |
|
| SecurityContext は、コンテナーに適用されるセキュリティー設定を保持します。一部のフィールドは、SecurityContext と PodSecurityContext の両方に存在します。両方が設定されている場合は、SecurityContext の値が優先されます。 |
|
| プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。 |
|
| このコンテナーがコンテナーランタイムで stdin にバッファーを割り当てる必要があるかどうか。これが設定されていない場合、コンテナー内の stdin からの読み取りは常に EOF になります。デフォルトは false です。 |
|
| コンテナーランタイムが、単一の接続によって開かれた後に stdin チャネルを閉じる必要があるかどうか。stdin が true の場合、stdin ストリームは複数の接続セッションにわたって開いたままになります。stdinOnce が true に設定されている場合、stdin はコンテナーの起動時に開かれ、最初のクライアントが stdin に接続するまで空になり、クライアントが切断されるまで開いたままでデータを受け入れます。切断されると、stdin は閉じられ、コンテナーが再起動されるまで閉じられたままになります。。このフラグが false の場合、stdin から読み取るコンテナープロセスは EOF を受信しません。デフォルトは false です。 |
|
| オプション: コンテナーの終了メッセージが書き込まれるファイルがコンテナーのファイルシステムにマウントされるパス。書き込まれるメッセージは、アサーション失敗メッセージなどの簡単な最終ステータスを目的としています。4096 バイトを超える場合、ノードによって切り捨てられます。すべてのコンテナーの合計メッセージ長は 12kb に制限されます。デフォルトは/dev/termination-log です。これを更新することはできません。 |
|
| 終了メッセージの入力方法を示します。ファイルは、terminationMessagePath の内容を使用して、成功と失敗の両方でコンテナーステータスメッセージを入力します。終了メッセージファイルが空で、コンテナーがエラーで終了した場合、FallbackToLogsOnError はコンテナーログ出力の最後のチャンクを使用します。ログ出力は、2048 バイトまたは 80 行のいずれか小さい方に制限されます。デフォルトは File です。これを更新することはできません。
使用可能な列挙値: - |
|
| このコンテナーがそれ自体に TTY を割り当てる必要があるかどうかには、'stdin' が true である必要もあります。デフォルトは false です。 |
|
| volumeDevices は、コンテナーによって使用されるブロックデバイスのリストです。 |
|
| volumeDevice は、コンテナー内の raw ブロックデバイスのマッピングを記述します。 |
|
| コンテナーのファイルシステムにマウントする Pod ボリューム。これを更新することはできません。 |
|
| VolumeMount は、コンテナー内でのボリュームのマウントを説明します。 |
|
| コンテナーの作業ディレクトリー。指定しない場合、コンテナーランタイムのデフォルトが使用されます。これは、コンテナーイメージで設定されている可能性があります。これを更新することはできません。 |
14.1.165. .spec.initContainers[].env リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナーに設定する環境変数のリスト。これを更新することはできません。
- 型
-
array
14.1.166. .spec.initContainers[].env[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- EnvVar は、コンテナーに存在する環境変数を表します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 環境変数の名前。C_IDENTIFIER でなければなりません。 |
|
| 変数参照 $(VAR_NAME) は、コンテナー内で以前に定義された環境変数と任意のサービス環境変数を使用してデプロイメントされます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、"(VAR_NAME)" は文字列リテラル "$(VAR_NAME)" を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。デフォルトは "" です。 |
|
| EnvVarSource は、EnvVar の値のソースを表します。 |
14.1.167. .spec.initContainers[].env[].valueFrom リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- EnvVarSource は、EnvVar の値のソースを表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ConfigMap からキーを選択します。 |
|
| ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。 |
|
| ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。 |
|
| SecretKeySelector は、シークレットのキーを選択します。 |
14.1.168. .spec.initContainers[].env[].valueFrom.configMapKeyRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ConfigMap からキーを選択します。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
14.1.169. .spec.initContainers[].env[].valueFrom.fieldRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。
- 型
-
object
- 必須
-
fieldPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| FieldPath が記述されているスキーマのバージョン。デフォルトは "v1" です。 |
|
| 指定された API バージョンで選択するフィールドのパス。 |
14.1.170. .spec.initContainers[].env[].valueFrom.resourceFieldRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。
- 型
-
object
- 必須
-
resource
-
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナー名: ボリュームには必須、env 変数にはオプション |
| 公開されたリソースの出力形式を指定します。デフォルトは "1" です。 | |
|
| 必須: 選択するリソース |
14.1.171. .spec.initContainers[].env[].valueFrom.secretKeyRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SecretKeySelector は、シークレットのキーを選択します。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
14.1.172. .spec.initContainers[].envFrom リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナー内の環境変数に入力するソースのリスト。ソース内で定義されたキーは C_IDENTIFIER である必要があります。無効なキーはすべて、コンテナーの起動時にイベントとして報告されます。キーが複数のソースに存在する場合、最後のソースに関連付けられた値が優先されます。重複キーを持つ環境によって定義された値が優先されます。これを更新することはできません。
- 型
-
array
14.1.173. .spec.initContainers[].envFrom[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- EnvFromSource は、一連の ConfigMap のソースを表します
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ConfigMapEnvSource は、環境変数に入力する ConfigMap を選択します。 ターゲットの ConfigMap のデータフィールドの内容は、キーと値のペアを環境変数として表します。 |
|
| ConfigMap の各キーの前に追加するオプションの識別子。C_IDENTIFIER でなければなりません。 |
|
| SecretEnvSource は、環境変数に入力するシークレットを選択します。 ターゲットシークレットのデータフィールドの内容は、キーと値のペアを環境変数として表します。 |
14.1.174. .spec.initContainers[].envFrom[].configMapRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
ConfigMapEnvSource は、環境変数に入力する ConfigMap を選択します。
ターゲットの ConfigMap のデータフィールドの内容は、キーと値のペアを環境変数として表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap を定義する必要があるかどうかを指定します |
14.1.175. .spec.initContainers[].envFrom[].secretRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
SecretEnvSource は、環境変数に入力するシークレットを選択します。
ターゲットシークレットのデータフィールドの内容は、キーと値のペアを環境変数として表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットを定義する必要があるかどうかを指定します |
14.1.176. .spec.initContainers[].lifecycle リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ライフサイクルは、コンテナーのライフサイクルイベントに対応して管理システムが実行する必要のあるアクションを表します。PostStart および PreStop ライフサイクルハンドラーの場合、コンテナープロセスが失敗しない限り、アクションが完了するまでコンテナー管理がブロックされます。失敗した場合、ハンドラーは中止されます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。 |
|
| LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。 |
14.1.177. .spec.initContainers[].lifecycle.postStart リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
14.1.178. .spec.initContainers[].lifecycle.postStart.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.1.179. .spec.initContainers[].lifecycle.postStart.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
14.1.180. .spec.initContainers[].lifecycle.postStart.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
14.1.181. .spec.initContainers[].lifecycle.postStart.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.1.182. .spec.initContainers[].lifecycle.postStart.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.1.183. .spec.initContainers[].lifecycle.preStop リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
14.1.184. .spec.initContainers[].lifecycle.preStop.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.1.185. .spec.initContainers[].lifecycle.preStop.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
14.1.186. .spec.initContainers[].lifecycle.preStop.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
14.1.187. .spec.initContainers[].lifecycle.preStop.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.1.188. .spec.initContainers[].lifecycle.preStop.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.1.189. .spec.initContainers[].livenessProbe リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| 正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。 |
|
| GRPC は、GRPC ポートに関連するアクションを指定します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。 |
|
| 失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
|
| プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。 |
|
| プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
14.1.190. .spec.initContainers[].livenessProbe.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.1.191. .spec.initContainers[].livenessProbe.grpc リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GRPC は、GRPC ポートに関連するアクションを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| gRPC サービスのポート番号。番号は 1〜65535 の範囲である必要があります。 |
|
| Service は、gRPC HealthCheckRequest に配置するサービスの名前です (https://github.com/grpc/grpc/blob/master/doc/health-checking.md を参照)。 これが指定されていない場合、デフォルトの動作は gRPC によって定義されます。 |
14.1.192. .spec.initContainers[].livenessProbe.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
14.1.193. .spec.initContainers[].livenessProbe.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
14.1.194. .spec.initContainers[].livenessProbe.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.1.195. .spec.initContainers[].livenessProbe.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.1.196. .spec.initContainers[].ports リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナーから公開するポートのリスト。ここでポートを指定しなくても、そのポートが公開されるのを防ぐことはできません。コンテナー内のデフォルトの "0.0.0.0" アドレスをリッスンしているポートは、ネットワークからアクセスできます。戦略的マージパッチを使用してこの配列を変更すると、データが破損する可能性があります。詳細は、https://github.com/kubernetes/kubernetes/issues/108255 を参照してください。これを更新することはできません。
- 型
-
array
14.1.197. .spec.initContainers[].ports[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerPort は、単一のコンテナー内のネットワークポートを表します。
- 型
-
object
- 必須
-
containerPort
-
プロパティー | 型 | 説明 |
---|---|---|
|
| Pod の IP アドレスで公開するポートの数。これは有効なポート番号である必要があります、0<x<65536。 |
|
| 外部ポートをバインドするホスト IP。 |
|
| ホストで公開するポートの数。指定する場合、これは有効なポート番号、0<x<65536 である必要があります。HostNetwork が指定されている場合、これは ContainerPort と一致する必要があります。ほとんどのコンテナーはこれを必要としません。 |
|
| 指定する場合、これは IANA_SVC_NAME であり、Pod 内で一意である必要があります。Pod 内の名前付きポートにはそれぞれ一意の名前を付ける必要があります。サービスが参照できるポートの名前。 |
|
| ポートのプロトコル。UDP、TCP、または SCTP である必要があります。デフォルトは "TCP" です。
使用可能な列挙値: - |
14.1.198. .spec.initContainers[].readinessProbe リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| 正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。 |
|
| GRPC は、GRPC ポートに関連するアクションを指定します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。 |
|
| 失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
|
| プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。 |
|
| プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
14.1.199. .spec.initContainers[].readinessProbe.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.1.200. .spec.initContainers[].readinessProbe.grpc リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GRPC は、GRPC ポートに関連するアクションを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| gRPC サービスのポート番号。番号は 1〜65535 の範囲である必要があります。 |
|
| Service は、gRPC HealthCheckRequest に配置するサービスの名前です (https://github.com/grpc/grpc/blob/master/doc/health-checking.md を参照)。 これが指定されていない場合、デフォルトの動作は gRPC によって定義されます。 |
14.1.201. .spec.initContainers[].readinessProbe.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
14.1.202. .spec.initContainers[].readinessProbe.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
14.1.203. .spec.initContainers[].readinessProbe.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.1.204. .spec.initContainers[].readinessProbe.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.1.205. .spec.initContainers[].resizePolicy リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナーのリソースサイズ変更ポリシー。
- 型
-
array
14.1.206. .spec.initContainers[].resizePolicy[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerResizePolicy は、コンテナーのリソースサイズ変更ポリシーを表します。
- 型
-
object
- 必須
-
resourceName
-
restartPolicy
-
プロパティー | 型 | 説明 |
---|---|---|
|
| このリソースサイズ変更ポリシーが適用されるリソースの名前。対応している値は、cpu、memory です。 |
|
| 指定されたリソースのサイズが変更されたときに適用する再起動ポリシー。指定しない場合、デフォルトの NotRequired が設定されます。 |
14.1.207. .spec.initContainers[].resources リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceRequirements は、コンピュートリソースの要件を説明します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。 これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。 このフィールドは不変です。これはコンテナーにのみ設定できます。 |
|
| ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。 |
| limits は、許可されるコンピュートリソースの最大量を示します。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 | |
| requests は、必要なコンピュートリソースの最小量を示します。コンテナーで Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
14.1.208. .spec.initContainers[].resources.claims リンクのコピーリンクがクリップボードにコピーされました!
- 説明
Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。
これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。
このフィールドは不変です。これはコンテナーにのみ設定できます。
- 型
-
array
14.1.209. .spec.initContainers[].resources.claims[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。 |
14.1.210. .spec.initContainers[].securityContext リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SecurityContext は、コンテナーに適用されるセキュリティー設定を保持します。一部のフィールドは、SecurityContext と PodSecurityContext の両方に存在します。両方が設定されている場合は、SecurityContext の値が優先されます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| AllowPrivilegeEscalation は、プロセスがその親プロセスよりも多くの特権を取得できるかどうかを制御します。このブール値は、no_new_privs フラグがコンテナープロセスに設定されるかどうかを直接制御します。コンテナーが 1) 特権で実行されており、CAP_SYS_ADMIN が割り当てられている場合、2) AllowPrivilegeEscalation は常に true です。spec.os.name が windows の場合は、このフィールドは設定できないことに注意してください。 |
|
| 実行中のコンテナーに POSIX 機能を追加および削除します。 |
|
| コンテナーを特権モードで実行します。特権コンテナー内のプロセスは、基本的にホスト上の root と同等です。デフォルトは false です。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| procMount は、コンテナーに使用する proc マウントのタイプを示します。デフォルトは DefaultProcMount で、読み取り専用パスとマスクされたパスにコンテナーランタイムのデフォルトを使用します。これには、ProcMountType 機能フラグを有効にする必要があります。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
使用可能な列挙値: - |
|
| このコンテナーに読み取り専用のルートファイルシステムがあるかどうか。デフォルトは false です。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| コンテナープロセスのエントリーポイントを実行するための GID。設定されていない場合は、実行時のデフォルトを使用します。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| コンテナーが root 以外のユーザーとして実行される必要があることを示します。true の場合、Kubelet は実行時にイメージを検証して、イメージが UID 0(ルート) として実行されないことを確認し、実行される場合はコンテナーの開始に失敗します。未設定または false の場合、そのような検証は実行されません。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。 |
|
| コンテナープロセスのエントリーポイントを実行するための UID。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| SELinuxOptions は、コンテナーに適用されるラベルです。 |
|
| SeccompProfile は、Pod/コンテナーの seccomp プロファイル設定を定義します。設定できるプロファイルソースは 1 つだけです。 |
|
| WindowsSecurityContextOptions には、Windows 固有のオプションおよび認証情報が含まれています。 |
14.1.211. .spec.initContainers[].securityContext.capabilities リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 実行中のコンテナーに POSIX 機能を追加および削除します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 追加された機能 |
|
| 削除された機能 |
14.1.212. .spec.initContainers[].securityContext.seLinuxOptions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SELinuxOptions は、コンテナーに適用されるラベルです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Level は、コンテナーに適用される SELinux レベルのラベルです。 |
|
| Role は、コンテナーに適用される SELinux ロールラベルです。 |
|
| Type は、コンテナーに適用される SELinux タイプのラベルです。 |
|
| User は、コンテナーに適用される SELinux ユーザーラベルです。 |
14.1.213. .spec.initContainers[].securityContext.seccompProfile リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SeccompProfile は、Pod/コンテナーの seccomp プロファイル設定を定義します。設定できるプロファイルソースは 1 つだけです。
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| localhostProfile は、ノード上のファイルで定義されたプロファイルを使用する必要があることを示します。プロファイルが機能するには、ノードで事前に設定されている必要があります。kubelet の設定済みの seccomp プロファイルの場所を基準にして、降順のパスである必要があります。タイプが "Localhost" の場合は設定する必要があります。他のタイプには設定しないでください。 |
|
| type は、適用される seccomp プロファイルの種類を示します。有効なオプションは以下のとおりです。 Localhost - ノード上のファイルで定義されたプロファイルを使用する必要があります。RuntimeDefault- コンテナーのランタイムデフォルトプロファイルを使用する必要があります。制限なし - プロファイルを適用しないでください。
使用可能な列挙値: - |
14.1.214. .spec.initContainers[].securityContext.windowsOptions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- WindowsSecurityContextOptions には、Windows 固有のオプションおよび認証情報が含まれています。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| GMSACredentialSpec は、GMSA アドミッション Webhook (https://github.com/kubernetes-sigs/windows-gmsa) が GMSACredentialSpecName フィールドで指定された GMSA クレデンシャル仕様のコンテンツをインライン化する場所です。 |
|
| GMSACredentialSpecName は、使用する GMSA 認証情報仕様の名前です。 |
|
| hostProcess は、コンテナーを 'Host Process' コンテナーとして実行する必要があるかどうかを決定します。Pod のすべてのコンテナーは、同じ有効な HostProcess 値を持っている必要があります (HostProcess コンテナーと非 HostProcess コンテナーを混在させることはできません)。さらに、HostProcess が true の場合、HostNetwork も true に設定する必要があります。 |
|
| コンテナープロセスのエントリーポイントを実行するための Windows の UserName。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。 |
14.1.215. .spec.initContainers[].startupProbe リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| 正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。 |
|
| GRPC は、GRPC ポートに関連するアクションを指定します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。 |
|
| 失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
|
| プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。 |
|
| プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
14.1.216. .spec.initContainers[].startupProbe.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.1.217. .spec.initContainers[].startupProbe.grpc リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GRPC は、GRPC ポートに関連するアクションを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| gRPC サービスのポート番号。番号は 1〜65535 の範囲である必要があります。 |
|
| Service は、gRPC HealthCheckRequest に配置するサービスの名前です (https://github.com/grpc/grpc/blob/master/doc/health-checking.md を参照)。 これが指定されていない場合、デフォルトの動作は gRPC によって定義されます。 |
14.1.218. .spec.initContainers[].startupProbe.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
14.1.219. .spec.initContainers[].startupProbe.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
14.1.220. .spec.initContainers[].startupProbe.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.1.221. .spec.initContainers[].startupProbe.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.1.222. .spec.initContainers[].volumeDevices リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- volumeDevices は、コンテナーによって使用されるブロックデバイスのリストです。
- 型
-
array
14.1.223. .spec.initContainers[].volumeDevices[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- volumeDevice は、コンテナー内の raw ブロックデバイスのマッピングを記述します。
- 型
-
object
- 必須
-
name
-
devicePath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| devicePath は、デバイスがマップされるコンテナー内のパスです。 |
|
| name は、Pod 内の persistentVolumeClaim の名前と一致する必要があります |
14.1.224. .spec.initContainers[].volumeMounts リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナーのファイルシステムにマウントする Pod ボリューム。これを更新することはできません。
- 型
-
array
14.1.225. .spec.initContainers[].volumeMounts[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- VolumeMount は、コンテナー内でのボリュームのマウントを説明します。
- 型
-
object
- 必須
-
name
-
mountPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ボリュームをマウントする必要があるコンテナー内のパス。':' を含めることはできません。 |
|
| mountPropagation は、マウントがホストからコンテナーに、またはその逆にどのように伝播されるかを決定します。設定されていない場合、MountPropagationNone が使用されます。このフィールドは 1.10 のベータ版です。
使用可能な列挙値: - |
|
| ボリュームの名前に一致する必要があります。 |
|
| true の場合は読み取り専用、それ以外の場合は読み取り/書き込み (false または指定なし) でマウントされます。デフォルトは false です。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内のパス。デフォルトは "" (ボリュームのルート) です。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内の拡張パス。SubPath と同様に動作しますが、環境変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。デフォルトは "" (ボリュームのルート) です。SubPathExpr と SubPath は相互に排他的です。 |
14.1.226. .spec.os リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodOS は、Pod の OS パラメーターを定義します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、オペレーティングシステムの名前です。現在サポートされている値は linux および windows です。今後、追加の値が定義される可能性があり、https://github.com/opencontainers/runtime-spec/blob/master/config.md#platform-specific-configuration のいずれかになります。クライアントは、追加の値を処理し、このフィールドで認識されない値を os: null として処理する必要があります。 |
14.1.227. .spec.readinessGates リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 指定した場合、すべての準備ゲートが Pod の準備状況に対して評価されます。すべてのコンテナーの準備が整い、準備ゲートで指定されたすべての条件のステータスが "True" になると、Pod の準備が整います。詳細: https://git.k8s.io/enhancements/keps/sig-network/580-pod-readiness-gates
- 型
-
array
14.1.228. .spec.readinessGates[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodReadinessGate には、Pod 条件への参照が含まれています
- 型
-
object
- 必須
-
conditionType
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ConditionType は、タイプが一致する Pod の条件リスト内の条件を参照します。 |
14.1.229. .spec.resourceClaims リンクのコピーリンクがクリップボードにコピーされました!
- 説明
ResourceClaims は、Pod の起動を許可する前にどの ResourceClaim を割り当てて予約する必要があるかを定義します。リソースは、名前ベースでリソースを使用するコンテナーに提供されます。
これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。
このフィールドは不変です。
- 型
-
array
14.1.230. .spec.resourceClaims[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodResourceClaim は、ClaimSource を介して 1 つの ResourceClaim のみを参照します。Pod 内の ResourceClaim を一意に識別する名前を追加します。ResourceClaim へのアクセスが必要なコンテナーは、この名前で参照します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は Pod 内でこのリソース要求を一意に識別します。これは DNS_LABEL である必要があります。 |
|
| ClaimSource は、ResourceClaim への参照を記述します。 これらのフィールドのうち 1 つだけを設定する必要があります。このタイプのコンシューマーは、不明な値が含まれているように、空のオブジェクトを処理する必要があります。 |
14.1.231. .spec.resourceClaims[].source リンクのコピーリンクがクリップボードにコピーされました!
- 説明
ClaimSource は、ResourceClaim への参照を記述します。
これらのフィールドのうち 1 つだけを設定する必要があります。このタイプのコンシューマーは、不明な値が含まれているように、空のオブジェクトを処理する必要があります。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ResourceClaimName は、この Pod と同じ namespace にある ResourceClaim オブジェクトの名前です。 |
|
| ResourceClaimTemplateName は、この Pod と同じ namespace にある ResourceClaimTemplate オブジェクトの名前です。 テンプレートは、この Pod にバインドされる新規 ResourceClaim の作成に使用されます。この Pod が削除されると、ResourceClaim も削除されます。Pod 名とリソース名は、生成されたコンポーネントとともに、ResourceClaim の一意の名前を形成するために使用され、pod.status.resourceClaimStatuses に記録されます。 このフィールドは不変であり、ResourceClaim の作成後にコントロールプレーンによって対応する ResourceClaim に変更が加えられることはありません。 |
14.1.232. .spec.schedulingGates リンクのコピーリンクがクリップボードにコピーされました!
- 説明
SchedulingGates は、指定されている場合に Pod のスケジューリングをブロックする不透明な値のリストです。schedulingGates が空でない場合、Pod は SchedulingGated 状態のままになり、スケジューラーは Pod のスケジュールを試行しません。
SchedulingGates を設定できるのは Pod の作成時にのみで、それ以降は削除されます。
これは、PodSchedulingReadiness フィーチャーゲートによって有効になるベータ機能です。
- 型
-
array
14.1.233. .spec.schedulingGates[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodSchedulingGate は Pod に割り当てられ、そのスケジューリングを保護します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| スケジューリングゲートの名前。各スケジューリングゲートには一意の name フィールドが必要です。 |
14.1.234. .spec.securityContext リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodSecurityContext は、Pod レベルのセキュリティー属性と一般的なコンテナー設定を保持します。一部のフィールドは container.securityContext にも存在します。container.securityContext のフィールド値は、PodSecurityContext のフィールド値よりも優先されます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Pod の全コンテナーに適用される特別な補助グループです。一部のボリュームタイプでは、Kubelet がそのボリュームの所有権を Pod が所有するように変更できます。 1.所有する GID は FSGroup2 になります。setgid ビットが設定されます (ボリュームに作成された新しいファイルは FSGroup によって所有されます)3。許可ビットは rw-rw---- と OR 演算されます 設定されていないと、Kubelet はボリュームの所有権および権限を変更しません。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| fsGroupChangePolicy は、Pod 内部で公開する前にボリュームの所有権とアクセス権を変更する動作を定義します。このフィールドは、fsGroup ベースの所有権 (および権限) をサポートするボリュームタイプにのみ適用されます。secret、configmaps、emptydir などのエフェメラルボリュームタイプには影響しません。有効な値は "OnRootMismatch" と "Always" です。指定しない場合は "Always" を使用します。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
使用可能な列挙値: - |
|
| コンテナープロセスのエントリーポイントを実行するための GID。設定されていない場合は、実行時のデフォルトを使用します。SecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値がそのコンテナーに優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| コンテナーが root 以外のユーザーとして実行される必要があることを示します。true の場合、Kubelet は実行時にイメージを検証して、イメージが UID 0(ルート) として実行されないことを確認し、実行される場合はコンテナーの開始に失敗します。未設定または false の場合、そのような検証は実行されません。SecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。 |
|
| コンテナープロセスのエントリーポイントを実行するための UID。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。SecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値がそのコンテナーに優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| SELinuxOptions は、コンテナーに適用されるラベルです。 |
|
| SeccompProfile は、Pod/コンテナーの seccomp プロファイル設定を定義します。設定できるプロファイルソースは 1 つだけです。 |
|
| コンテナーのプライマリー GID、fsGroup (指定されている場合)、およびコンテナープロセスの uid に対してコンテナーイメージで定義されているグループメンバーシップに加えて、各コンテナーで実行される最初のプロセスに適用されるグループのリスト。指定しない場合、追加のグループはコンテナーに追加されません。コンテナープロセスの uid のコンテナーイメージで定義されたグループメンバーシップは、このリストに含まれていない場合でも引き続き有効であることに注意してください。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| Sysctl は、Pod に使用される namespace 付き sysctl のリストを保持します。(コンテナーランタイムによる) サポートされていない sysctl を持つ Pod は起動に失敗する可能性があります。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| Sysctl は、設定するカーネルパラメーターを定義します |
|
| WindowsSecurityContextOptions には、Windows 固有のオプションおよび認証情報が含まれています。 |
14.1.235. .spec.securityContext.seLinuxOptions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SELinuxOptions は、コンテナーに適用されるラベルです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Level は、コンテナーに適用される SELinux レベルのラベルです。 |
|
| Role は、コンテナーに適用される SELinux ロールラベルです。 |
|
| Type は、コンテナーに適用される SELinux タイプのラベルです。 |
|
| User は、コンテナーに適用される SELinux ユーザーラベルです。 |
14.1.236. .spec.securityContext.seccompProfile リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SeccompProfile は、Pod/コンテナーの seccomp プロファイル設定を定義します。設定できるプロファイルソースは 1 つだけです。
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| localhostProfile は、ノード上のファイルで定義されたプロファイルを使用する必要があることを示します。プロファイルが機能するには、ノードで事前に設定されている必要があります。kubelet の設定済みの seccomp プロファイルの場所を基準にして、降順のパスである必要があります。タイプが "Localhost" の場合は設定する必要があります。他のタイプには設定しないでください。 |
|
| type は、適用される seccomp プロファイルの種類を示します。有効なオプションは以下のとおりです。 Localhost - ノード上のファイルで定義されたプロファイルを使用する必要があります。RuntimeDefault- コンテナーのランタイムデフォルトプロファイルを使用する必要があります。制限なし - プロファイルを適用しないでください。
使用可能な列挙値: - |
14.1.237. .spec.securityContext.sysctls リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Sysctl は、Pod に使用される namespace 付き sysctl のリストを保持します。(コンテナーランタイムによる) サポートされていない sysctl を持つ Pod は起動に失敗する可能性があります。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
- 型
-
array
14.1.238. .spec.securityContext.sysctls[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Sysctl は、設定するカーネルパラメーターを定義します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 設定するプロパティーの名前 |
|
| 設定するプロパティーの値 |
14.1.239. .spec.securityContext.windowsOptions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- WindowsSecurityContextOptions には、Windows 固有のオプションおよび認証情報が含まれています。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| GMSACredentialSpec は、GMSA アドミッション Webhook (https://github.com/kubernetes-sigs/windows-gmsa) が GMSACredentialSpecName フィールドで指定された GMSA クレデンシャル仕様のコンテンツをインライン化する場所です。 |
|
| GMSACredentialSpecName は、使用する GMSA 認証情報仕様の名前です。 |
|
| hostProcess は、コンテナーを 'Host Process' コンテナーとして実行する必要があるかどうかを決定します。Pod のすべてのコンテナーは、同じ有効な HostProcess 値を持っている必要があります (HostProcess コンテナーと非 HostProcess コンテナーを混在させることはできません)。さらに、HostProcess が true の場合、HostNetwork も true に設定する必要があります。 |
|
| コンテナープロセスのエントリーポイントを実行するための Windows の UserName。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。 |
14.1.240. .spec.tolerations リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 指定されている場合、Pod の許容範囲。
- 型
-
array
14.1.241. .spec.tolerations[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- この toleration が割り当てられる Pod は、マッチング Operator <operator> を使用してトリプル <key,value,effect> と一致する taint を許容します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| effect は、照合するテイントの効果を示します。空の場合は、すべてのテイント効果に一致します。指定されている場合、許可される値は NoSchedule、PreferNoSchedule、および NoExecute です。
使用可能な列挙値: - |
|
| key は toleration が適用されるテイントキーです。空の場合は、すべてのテイントキーに一致します。キーが空の場合、Operator は Exists である必要があります。この組み合わせは、すべての値とすべてのキーに一致することを意味します。 |
|
| Operator はキーと値の関係を表します。有効な Operator は Exists および Equal です。デフォルトは Equal です。Exists は、値のワイルドカードと同等であるため、Pod は特定のカテゴリーのすべてのテイントに耐えることができます。
使用可能な列挙値: - |
|
| tolerationSeconds は、toleration (effect は NoExecute でなければならず、NoExecute 以外の場合このフィールドは無視されます) が taint を許容する期間を表します。デフォルトでは設定されていません。つまり、テイントを永久に許容します (エビクトしないでください)。ゼロ値と負の値は、システムによって 0 (すぐにエビクト) として扱われます。 |
|
| value は、toleration が一致するテイントの値です。Operator が Exists の場合、値は空である必要があります。それ以外の場合は、通常の文字列のみになります。 |
14.1.242. .spec.topologySpreadConstraints リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TopologySpreadConstraints は、Pod のグループがトポロジードメイン全体にどのように分散するべきかを説明します。スケジューラーは、制約に従う方法で Pod をスケジュールします。すべての topologySpreadConstraints は AND 演算されます。
- 型
-
array
14.1.243. .spec.topologySpreadConstraints[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- topologySpreadConstraint は、指定されたトポロジー間で一致する Pod を分散する方法を指定します。
- 型
-
object
- 必須
-
maxSkew
-
topologyKey
-
whenUnsatisfiable
-
プロパティー | 型 | 説明 |
---|---|---|
| LabelSelector は、一致する Pod を見つけるために使用されます。このラベルセレクターに一致する Pod は、対応するトポロジードメイン内の Pod の数を決定するためにカウントされます。 | |
|
| MatchLabelKeys は、分散を計算する Pod を選択するための Pod ラベルキーのセットです。このようなキーは受信 Pod のラベルから値を検索するために使用され、このキーと値のラベルは labelSelector と AND 演算されて、受信 Pod の分散が計算される既存の Pod のグループを選択します。同じキーが MatchLabelKeys と LabelSelector の両方に存在することはできません。LabelSelector が設定されていないと、MatchLabelKeys は設定できません。受信 Pod ラベルに存在しないキーは無視されます。null または空のリストは、labelSelector とのみ一致することを意味します。 これはベータフィールドであり、MatchLabelKeysInPodTopologySpread フィーチャーゲートを有効にする必要があります (デフォルトで有効)。 |
|
|
MaxSkew は、Pod が不均一に分布している可能性の程度を表します。 |
|
| 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 は、Pod トポロジーの分散スキューを計算するときに Pod の nodeAffinity/nodeSelector をどのように扱うかを示します。オプションは - Honor: nodeAffinity/nodeSelector に一致するノードのみが計算に含まれます。- Ignore: nodeAffinity/nodeSelector は無視されます。すべてのノードが計算に含まれます。 この値が nil の場合、この動作は Honor ポリシーと同じです。これは、NodeInclusionPolicyInPodTopologySpread 機能フラグによってデフォルトで有効になるベータレベルの機能です。
使用可能な列挙値: - |
|
| NodeTaintsPolicy は、Pod トポロジースプレッドスキューを計算するときにノードのテイントを処理する方法を示します。オプション: - Honor: テイントのないノードと、受信 Pod が許容範囲でテイントがあるノードが含まれます。- Ignore: ノードのテイントは無視されます。すべてのノードが含まれます。 この値が nil の場合、この動作は Ignore ポリシーと同じです。これは、NodeInclusionPolicyInPodTopologySpread 機能フラグによってデフォルトで有効になるベータレベルの機能です。
使用可能な列挙値: - |
|
| TopologyKey は、ノードラベルのキーです。このキーと同じ値のラベルを持つノードは、同じトポロジーにあると見なされます。各 <key, value> を "バケット" と見なし、バランスの取れた数の Pod を各バケットに配置しようとします。ドメインをトポロジーの特定のインスタンスとして定義します。また、ノードが nodeAffinityPolicy および nodeTaintsPolicy の要件を満たすドメインとして、適格なドメインを定義します。たとえば、TopologyKey が "kubernetes.io/hostname" の場合、各ノードはそのトポロジーのドメインです。また、TopologyKey が "topology.kubernetes.io/zone" の場合は、各ゾーンがそのトポロジーのドメインになります。必須フィールドです。 |
|
| 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) になります。つまり、クラスターは依然として不均衡である可能性がありますが、スケジューラーによってクラスターが さらに 不均衡になることはありません。必須フィールドです。
使用可能な列挙値: - |
14.1.244. .spec.volumes リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod に属するコンテナーによってマウントできるボリュームのリスト。詳細: https://kubernetes.io/docs/concepts/storage/volumes
- 型
-
array
14.1.245. .spec.volumes[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ボリュームは、Pod 内の任意のコンテナーからアクセスできる Pod 内の名前付きボリュームを表します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| AWS の永続ディスクリソースを表します。 AWS EBS ディスクは、コンテナーにマウントする前に存在している必要があります。また、ディスクは kubelet と同じ AWS ゾーンにある必要があります。AWS EBS ディスクは、読み取り/書き込みとして 1 回だけマウントできます。AWS EBS ボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。 |
|
| AzureDisk は、ホスト上の Azure Data Disk マウントを表し、Pod へのバインドマウントを表します。 |
|
| AzureFile は、ホスト上の Azure File Service マウントを表し、マウントを Pod にバインドします。 |
|
| Pod の存続期間中持続する Ceph ファイルシステムマウントを表します。Cephfs ボリュームは所有権管理または SELinux の再ラベル付けをサポートしていません。 |
|
| Openstack の cinder ボリュームリソースを表します。コンテナーにマウントする前に、Cinder ボリュームが存在している必要があります。ボリュームも、kubelet と同じ領域にある必要があります。Cinder ボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。 |
|
| ConfigMap をボリュームに適用します。 項目要素にパスへのキーの特定のマッピングが入力されていない限り、ターゲットの ConfigMap のデータフィールドの内容は、データフィールドのキーをファイル名として使用してファイルとしてボリュームに表示されます。ConfigMap ボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。 |
|
| 外部 CSI ドライバーによって管理される、マウントするボリュームのソースの場所を表します |
|
| DownwardAPIVolumeSource は、Downward API 情報を含むボリュームを表します。Downward API ボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。 |
|
| Pod の空のディレクトリーを表します。空のディレクトリーボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。 |
|
| 通常のストレージドライバーによって処理される一時的なボリュームを表します。 |
|
| ファイバーチャネルボリュームを表します。ファイバーチャネルボリュームは、読み取り/書き込みとして 1 回だけマウントできます。ファイバーチャネルボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。 |
|
| FlexVolume は、exec ベースのプラグインを使用してプロビジョニング/接続される汎用ボリュームリソースを表します。 |
|
| Flocker エージェントによってマウントされた Flocker ボリュームを表します。datasetName および datasetUUID の 1 つだけを設定する必要があります。Flocker ボリュームは、所有権管理または SELinux の再ラベル付けをサポートしていません。 |
|
| Google Compute Engine の永続ディスクリソースを表します。 GCE PD は、コンテナーにマウントする前に存在している必要があります。ディスクは、kubelet と同じ GCE プロジェクトおよびゾーンにある必要もあります。GCE PD は、読み取り/書き込みとして 1 回のみマウントできます。また、読み取り専用としては何度でもマウントできます。GCE PD は、所有権管理および SELinux の再ラベル付けをサポートします。 |
|
| git リポジトリーのコンテンツが入力されているボリュームを表します。Git リポジトリーボリュームは所有権管理をサポートしていません。Git リポジトリーボリュームは SELinux の再ラベル付けをサポートしています。 非推奨:GitRepo は非推奨です。git レポジトリを使用してコンテナーをプロビジョニングするには、Git を使用してレポジトリのクローンを作成する InitContainer に EmptyDir をマウントしてから、Pod のコンテナーに EmptyDir をマウントします。 |
|
| Pod の存続期間中続く Glusterfs マウントを表します。Glusterfs ボリュームは、所有権管理または SELinux の再ラベル付けをサポートしていません。 |
|
| Pod にマップされたホストパスを表します。ホストパスボリュームは、所有権管理または SELinux の再ラベル付けをサポートしていません。 |
|
| ISCSI ディスクを表します。ISCSI ボリュームは、読み取り/書き込みとして 1 回だけマウントできます。ISCSI ボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。 |
|
| ボリュームの名前。DNS_LABEL であり、Pod 内で一意である必要があります。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| Pod の存続期間中続く NFS マウントを表します。NFS ボリュームは、所有権管理または SELinux の再ラベル付けをサポートしていません。 |
|
| PersistentVolumeClaimVolumeSource は、同じ namespace 内のユーザーの PVC を参照します。このボリュームは、バインドされた PV を検出し、Pod 用にそのボリュームをマウントします。PersistentVolumeClaimVolumeSource は、基本的に、他の誰か (システム) が所有する別のタイプのボリュームのラッパーです。 |
|
| Photon Controller 永続ディスクリソースを表します。 |
|
| PortworxVolumeSource は、Portworx ボリュームリソースを表します。 |
|
| Projected ボリュームソースを表します |
|
| Pod の存続期間中続く Quobyte マウントを表します。Quobyte ボリュームは、所有権管理または SELinux の再ラベル付けをサポートしていません。 |
|
| Pod の存続時間中続く Rados Block Device マウントを表します。RBD ボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。 |
|
| ScaleIOVolumeSource は、永続的な ScaleIO ボリュームを表します |
|
| シークレットをボリュームに適合させます。 ターゲットシークレットの Data フィールドの内容は、ファイル名として Data フィールドのキーを使用してファイルとしてボリュームに表示されます。シークレットボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。 |
|
| StorageOS 永続ボリュームリソースを表します。 |
|
| vSphere ボリュームリソースを表します。 |
14.1.246. .spec.volumes[].awsElasticBlockStore リンクのコピーリンクがクリップボードにコピーされました!
- 説明
AWS の永続ディスクリソースを表します。
AWS EBS ディスクは、コンテナーにマウントする前に存在している必要があります。また、ディスクは kubelet と同じ AWS ゾーンにある必要があります。AWS EBS ディスクは、読み取り/書き込みとして 1 回だけマウントできます。AWS EBS ボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。
- 型
-
object
- 必須
-
volumeID
-
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするボリュームのファイルシステムタイプです。ヒント: ファイルシステムタイプがホストオペレーティングシステムでサポートされていることを確認してください。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
|
| partition は、マウントするボリューム内のパーティションです。省略した場合、デフォルトではボリューム名でマウントします。例: ボリューム/dev/sda1 の場合、パーティションを "1" として指定します。同様に、/dev/sda のボリュームパーティションは "0" です (または、プロパティーを空のままにしておくこともできます)。 |
|
| readOnly 値 true は、VolumeMounts の readOnly 設定を強制的に実行します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
|
| volumeID は、AWS の永続ディスクリソースの一意の ID です (Amazon EBS ボリューム)。詳細: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
14.1.247. .spec.volumes[].azureDisk リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- AzureDisk は、ホスト上の Azure Data Disk マウントを表し、Pod へのバインドマウントを表します。
- 型
-
object
- 必須
-
diskName
-
diskURI
-
プロパティー | 型 | 説明 |
---|---|---|
|
| cachingMode はホストキャッシュモードです (None, Read Only, Read Write)。
使用可能な列挙値: - |
|
| diskName は、Blob ストレージ内のデータディスクの名前です。 |
|
| diskURI は、Blob ストレージ内のデータディスクの URI です |
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。 |
|
| kind での期待値は、Shared (ストレージアカウントごとに複数のブロブディスク)、Dedicated (ストレージアカウントごとにブロブ 1 つ)、Managed (Azure の管理データディスク (管理対象のアベイラビリティーセットのみ)) です。デフォルトは Shared です。
使用可能な列挙値:- |
|
| readOnly。デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。 |
14.1.248. .spec.volumes[].azureFile リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- AzureFile は、ホスト上の Azure File Service マウントを表し、マウントを Pod にバインドします。
- 型
-
object
- 必須
-
secretName
-
shareName
-
プロパティー | 型 | 説明 |
---|---|---|
|
| readOnly のデフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。 |
|
| secretName は、Azure ストレージアカウント名とキーを含むシークレットの名前です。 |
|
| shareName は Azure 共有名です。 |
14.1.249. .spec.volumes[].cephfs リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod の存続期間中持続する Ceph ファイルシステムマウントを表します。Cephfs ボリュームは所有権管理または SELinux の再ラベル付けをサポートしていません。
- 型
-
object
- 必須
-
monitors
-
プロパティー | 型 | 説明 |
---|---|---|
|
| monitors は必須: Monitors は Ceph モニターのコレクションです。詳細: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
| パスは任意: 完全な Ceph ツリーではなく、マウントされたルートとして使用されます。デフォルトは / です。 |
|
| readOnly は任意: デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。詳細: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
| secretFile は任意: SecretFile はユーザーのキーリングへのパスです。デフォルトは /etc/ceph/user.secret です。詳細: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
| LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。 |
|
| user 任意: User は rados ユーザー名、デフォルトは admin です。詳細: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
14.1.250. .spec.volumes[].cephfs.secretRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
14.1.251. .spec.volumes[].cinder リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Openstack の cinder ボリュームリソースを表します。コンテナーにマウントする前に、Cinder ボリュームが存在している必要があります。ボリュームも、kubelet と同じ領域にある必要があります。Cinder ボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。
- 型
-
object
- 必須
-
volumeID
-
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。詳細: https://examples.k8s.io/mysql-cinder-pd/README.md |
|
| readOnly のデフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。詳細: https://examples.k8s.io/mysql-cinder-pd/README.md |
|
| LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。 |
|
| cinder 内のボリュームを識別するために使用される volumeID。詳細: https://examples.k8s.io/mysql-cinder-pd/README.md |
14.1.252. .spec.volumes[].cinder.secretRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
14.1.253. .spec.volumes[].configMap リンクのコピーリンクがクリップボードにコピーされました!
- 説明
ConfigMap をボリュームに適用します。
項目要素にパスへのキーの特定のマッピングが入力されていない限り、ターゲットの ConfigMap のデータフィールドの内容は、データフィールドのキーをファイル名として使用してファイルとしてボリュームに表示されます。ConfigMap ボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| defaultMode は任意: デフォルトで、作成されたファイルのアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。デフォルトは 0644 に設定されます。パス内のディレクトリーはこの設定の影響を受けません。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| item が指定されていない場合、参照される ConfigMap の Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。ConfigMap に存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。 |
|
| 文字列キーをボリューム内のパスにマップします。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 任意。ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
14.1.254. .spec.volumes[].configMap.items リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- item が指定されていない場合、参照される ConfigMap の Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。ConfigMap に存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。
- 型
-
array
14.1.255. .spec.volumes[].configMap.items[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 文字列キーをボリューム内のパスにマップします。
- 型
-
object
- 必須
-
key
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key はプロジェクトのキーです。 |
|
| mode は任意: このファイルにアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| path はキーをマップするファイルの相対パスです。絶対的なパスではない可能性があります。パス要素 '..' を含めることはできません。文字列 '..' で始まらない場合があります。 |
14.1.256. .spec.volumes[].csi リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 外部 CSI ドライバーによって管理される、マウントするボリュームのソースの場所を表します
- 型
-
object
- 必須
-
driver
-
プロパティー | 型 | 説明 |
---|---|---|
|
| driver は、このボリュームを処理する CSI ドライバーの名前です。クラスターに登録されている正しい名前は、管理者に相談してください。 |
|
| マウントする fsType。例: "ext4"、"xfs"、"ntfs"。指定しない場合、空の値が関連する CSI ドライバーに渡され、適用するデフォルトのファイルシステムが決定されます。 |
|
| LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。 |
|
| readOnly は、ボリュームの読み取り専用設定を指定します。デフォルトは false (読み取り/書き込み) です。 |
|
| volumeAttributes は、CSI ドライバーに渡されるドライバー固有のプロパティーを格納します。サポートされている値は、ドライバーのドキュメントを参照してください。 |
14.1.257. .spec.volumes[].csi.nodePublishSecretRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
14.1.258. .spec.volumes[].downwardAPI リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DownwardAPIVolumeSource は、Downward API 情報を含むボリュームを表します。Downward API ボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: デフォルトで作成されたファイルで使用するモードビット。オプション: デフォルトで作成されたファイルのパーミッションを設定するために使用されるモードビット。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。デフォルトは 0644 に設定されます。パス内のディレクトリーはこの設定の影響を受けません。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| items は、Downward API ボリュームファイルのリストです |
|
| DownwardAPIVolumeFile は、Pod フィールドを含むファイルを作成するための情報を表します |
14.1.259. .spec.volumes[].downwardAPI.items リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- items は、Downward API ボリュームファイルのリストです
- 型
-
array
14.1.260. .spec.volumes[].downwardAPI.items[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DownwardAPIVolumeFile は、Pod フィールドを含むファイルを作成するための情報を表します
- 型
-
object
- 必須
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。 |
|
| オプション: このファイルの権限を設定するために使用されるモードビットは、0000 から 0777 までの 8 進数値、または 0 から 511 までの 10 進数値でなければなりません。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| 必須: パスは、作成するファイルの相対パス名です。絶対パスまたは '..' パスを含めることはできません。utf-8 でエンコードする必要があります。相対パスの最初の項目は '..' で始まってはなりません。 |
|
| ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。 |
14.1.261. .spec.volumes[].downwardAPI.items[].fieldRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。
- 型
-
object
- 必須
-
fieldPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| FieldPath が記述されているスキーマのバージョン。デフォルトは "v1" です。 |
|
| 指定された API バージョンで選択するフィールドのパス。 |
14.1.262. .spec.volumes[].downwardAPI.items[].resourceFieldRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。
- 型
-
object
- 必須
-
resource
-
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナー名: ボリュームには必須、env 変数にはオプション |
| 公開されたリソースの出力形式を指定します。デフォルトは "1" です。 | |
|
| 必須: 選択するリソース |
14.1.263. .spec.volumes[].emptyDir リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod の空のディレクトリーを表します。空のディレクトリーボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| medium は、このディレクトリーをバックアップする必要があるストレージメディアのタイプを表します。デフォルトは"" です。これは、ノードのデフォルトのメディアを使用することを意味します。空の文字列 (デフォルト) またはメモリーである必要があります。詳細: https://kubernetes.io/docs/concepts/storage/volumes#emptydir |
| sizeLimit は、この EmptyDir ボリュームに必要なローカルストレージの合計量です。サイズ制限はメモリーメディアにも適用されます。メモリーメディア EmptyDir での最大使用量は、ここで指定された SizeLimit と Pod 内のすべてのコンテナーのメモリー制限の合計との間の最小値になります。デフォルトは nil です。これは、制限が未定義であることを意味します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#emptydir |
14.1.264. .spec.volumes[].ephemeral リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 通常のストレージドライバーによって処理される一時的なボリュームを表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| PersistentVolumeClaimTemplate は、EphemeralVolumeSource の一部として PersistentVolumeClaim オブジェクトを生成するために使用されます。 |
14.1.265. .spec.volumes[].ephemeral.volumeClaimTemplate リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PersistentVolumeClaimTemplate は、EphemeralVolumeSource の一部として PersistentVolumeClaim オブジェクトを生成するために使用されます。
- 型
-
object
- 必須
-
spec
-
プロパティー | 型 | 説明 |
---|---|---|
| PVC の作成時に PVC にコピーされるラベルとアノテーションが含まれる場合があります。他のフィールドは許可されておらず、検証中に拒否されます。 | |
|
| PersistentVolumeClaimSpec は、ストレージデバイスの一般的な属性を記述し、プロバイダー固有の属性のソースを許可します |
14.1.266. .spec.volumes[].ephemeral.volumeClaimTemplate.spec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PersistentVolumeClaimSpec は、ストレージデバイスの一般的な属性を記述し、プロバイダー固有の属性のソースを許可します
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| accessModes には、ボリュームに割り当てる必要のあるアクセスモードが含まれます。詳細は、https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 を参照してください。 |
|
| TypedLocalObjectReference には、同じ namespace 内で typed 参照オブジェクトを見つけるのに十分な情報が含まれます。 |
|
| dataSourceRef は、空でないボリュームが必要な場合は、ボリュームにデータを取り込むオブジェクトを指定します。これには、空ではない API グループ (コアオブジェクトではない) または PersistentVolumeClaim オブジェクトの任意のオブジェクトを指定できます。このフィールドが指定されている場合、ボリュームバインディングは、指定されたオブジェクトのタイプが、インストールされているボリュームポピュレーターまたはダイナミックプロビジョナーと一致する場合にのみ成功します。このフィールドは、dataSource フィールドの機能を置き換えるため、両方のフィールドが空でない場合は、同じ値である必要があります。下位互換性を確保するために、dataSourceRef で namespace が指定されておらず、一方が空でもう一方が空でない場合、両方のフィールド (dataSource と dataSourceRef) が自動的に同じ値に設定されます。dataSourceRef で namespace が指定されている場合、dataSource は同じ値に設定されていないため、空にする必要があります。dataSource と dataSourceRef には 3 つの重要な違いがあります。* dataSource では 2 つの特定のタイプのオブジェクトのみが使用できますが、dataSourceRef ではコアオブジェクト以外および PersistentVolumeClaim オブジェクトを使用できます。* dataSource は使用できない値を無視 (ドロップ) しますが、dataSourceRef はすべての値を保持し、使用できない値が指定された場合はエラーを生成します。* dataSource ではローカルオブジェクトのみが使用できますが、dataSourceRef では任意の namespace のオブジェクトを使用できます。(ベータ版) このフィールドを使用するには、AnyVolumeDataSource フィーチャーゲートを有効にする必要があります。(アルファ版) dataSourceRef の namespace フィールドを使用するには、CrossNamespaceVolumeDataSource フィーチャーゲートを有効にする必要があります。 |
|
| ResourceRequirements は、コンピュートリソースの要件を説明します。 |
| selector は、バインドを考慮するボリュームに対するラベルクエリーです。 | |
|
| storageClassName は、要求に必要な StorageClass の名前です。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1 |
|
| volumeMode は、要求に必要なボリュームのタイプを定義します。Filesystem の値は、要求仕様に含まれていない場合に暗示されます。
使用可能な列挙値: - |
|
| volumeName は、この要求をサポートする PersistentVolume へのバインディング参照です。 |
14.1.267. .spec.volumes[].ephemeral.volumeClaimTemplate.spec.dataSource リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TypedLocalObjectReference には、同じ namespace 内で typed 参照オブジェクトを見つけるのに十分な情報が含まれます。
- 型
-
object
- 必須
-
kind
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| APIGroup は参照されているリソースのグループです。APIGroup が指定されていない場合は、指定の Kind をコア API グループに設定する必要があります。他のサードパーティータイプには、APIGroup が必要です。 |
|
| kind は参照されているリソースのタイプです。 |
|
| name は、参照されているリソースの名前です。 |
14.1.268. .spec.volumes[].ephemeral.volumeClaimTemplate.spec.dataSourceRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- dataSourceRef は、空でないボリュームが必要な場合は、ボリュームにデータを取り込むオブジェクトを指定します。これには、空ではない API グループ (コアオブジェクトではない) または PersistentVolumeClaim オブジェクトの任意のオブジェクトを指定できます。このフィールドが指定されている場合、ボリュームバインディングは、指定されたオブジェクトのタイプが、インストールされているボリュームポピュレーターまたはダイナミックプロビジョナーと一致する場合にのみ成功します。このフィールドは、dataSource フィールドの機能を置き換えるため、両方のフィールドが空でない場合は、同じ値である必要があります。下位互換性を確保するために、dataSourceRef で namespace が指定されておらず、一方が空でもう一方が空でない場合、両方のフィールド (dataSource と dataSourceRef) が自動的に同じ値に設定されます。dataSourceRef で namespace が指定されている場合、dataSource は同じ値に設定されていないため、空にする必要があります。dataSource と dataSourceRef には 3 つの重要な違いがあります。* dataSource では 2 つの特定のタイプのオブジェクトのみが使用できますが、dataSourceRef ではコアオブジェクト以外および PersistentVolumeClaim オブジェクトを使用できます。* dataSource は使用できない値を無視 (ドロップ) しますが、dataSourceRef はすべての値を保持し、使用できない値が指定された場合はエラーを生成します。* dataSource ではローカルオブジェクトのみが使用できますが、dataSourceRef では任意の namespace のオブジェクトを使用できます。(ベータ版) このフィールドを使用するには、AnyVolumeDataSource フィーチャーゲートを有効にする必要があります。(アルファ版) dataSourceRef の namespace フィールドを使用するには、CrossNamespaceVolumeDataSource フィーチャーゲートを有効にする必要があります。
- 型
-
object
- 必須
-
kind
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| APIGroup は参照されているリソースのグループです。APIGroup が指定されていない場合は、指定の Kind をコア API グループに設定する必要があります。他のサードパーティータイプには、APIGroup が必要です。 |
|
| kind は参照されているリソースのタイプです。 |
|
| name は、参照されているリソースの名前です。 |
|
| Namespace は、参照されるリソースの namespace です。namespace が指定されている場合は、その namespace の所有者が参照を受け入れることができるように、参照された namespace に gateway.networking.k8s.io/ReferenceGrant オブジェクトが必要であることに注意してください。詳細は、ReferenceGrant ドキュメントを参照してください。(アルファ版) このフィールドでは、CrossNamespaceVolumeDataSource フィーチャーゲートを有効にする必要があります。 |
14.1.269. .spec.volumes[].ephemeral.volumeClaimTemplate.spec.resources リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceRequirements は、コンピュートリソースの要件を説明します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。 これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。 このフィールドは不変です。これはコンテナーにのみ設定できます。 |
|
| ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。 |
| limits は、許可されるコンピュートリソースの最大量を示します。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 | |
| requests は、必要なコンピュートリソースの最小量を示します。コンテナーで Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
14.1.270. .spec.volumes[].ephemeral.volumeClaimTemplate.spec.resources.claims リンクのコピーリンクがクリップボードにコピーされました!
- 説明
Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。
これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。
このフィールドは不変です。これはコンテナーにのみ設定できます。
- 型
-
array
14.1.271. .spec.volumes[].ephemeral.volumeClaimTemplate.spec.resources.claims[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。 |
14.1.272. .spec.volumes[].fc リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ファイバーチャネルボリュームを表します。ファイバーチャネルボリュームは、読み取り/書き込みとして 1 回だけマウントできます。ファイバーチャネルボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。 |
|
| LUN は任意: FC ターゲットの LUN 番号 |
|
| readOnly は任意: デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。 |
|
| targetWWNs は任意: FC ターゲットのワールドワイド名 (WWN) |
|
| wwids は任意: FC ボリュームのワールドワイド ID(wwids)wwids または targetWWN と lun の組み合わせのいずれかを設定する必要がありますが、両方を同時に設定できません。 |
14.1.273. .spec.volumes[].flexVolume リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- FlexVolume は、exec ベースのプラグインを使用してプロビジョニング/接続される汎用ボリュームリソースを表します。
- 型
-
object
- 必須
-
driver
-
プロパティー | 型 | 説明 |
---|---|---|
|
| driver は、このボリュームに使用するドライバーの名前です。 |
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。デフォルトのファイルシステムは FlexVolume スクリプトに依存します。 |
|
| options は任意: このフィールドには追加のコマンドオプションがあれば保持されます。 |
|
| readOnly は任意: デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。 |
|
| LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。 |
14.1.274. .spec.volumes[].flexVolume.secretRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
14.1.275. .spec.volumes[].flocker リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Flocker エージェントによってマウントされた Flocker ボリュームを表します。datasetName および datasetUUID の 1 つだけを設定する必要があります。Flocker ボリュームは、所有権管理または SELinux の再ラベル付けをサポートしていません。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| datasetName はメタデータとして保存されているデータセットの名前です → Flocker のデータセット上の名前は非推奨として扱うようにしてください。 |
|
| datasetUUID は、データセットの UUID です。これは Flocker データセットの一意の識別子です |
14.1.276. .spec.volumes[].gcePersistentDisk リンクのコピーリンクがクリップボードにコピーされました!
- 説明
Google Compute Engine の永続ディスクリソースを表します。
GCE PD は、コンテナーにマウントする前に存在している必要があります。ディスクは、kubelet と同じ GCE プロジェクトおよびゾーンにある必要もあります。GCE PD は、読み取り/書き込みとして 1 回のみマウントできます。また、読み取り専用としては何度でもマウントできます。GCE PD は、所有権管理および SELinux の再ラベル付けをサポートします。
- 型
-
object
- 必須
-
pdName
-
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするボリュームのファイルシステムタイプです。ヒント: ファイルシステムタイプがホストオペレーティングシステムでサポートされていることを確認してください。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
| partition は、マウントするボリューム内のパーティションです。省略した場合、デフォルトではボリューム名でマウントします。例: ボリューム/dev/sda1 の場合、パーティションを "1" として指定します。同様に、/dev/sda のボリュームパーティションは "0" です (または、プロパティーを空のままにしておくこともできます)。詳細: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
| pdName は、GCE の PD リソースの一意の名前です。GCE でディスクを識別するために使用されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
| この readOnly は、VolumeMounts で ReadOnly 設定が強制的に指定されます。デフォルトは false です。詳細: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
14.1.277. .spec.volumes[].gitRepo リンクのコピーリンクがクリップボードにコピーされました!
- 説明
git リポジトリーのコンテンツが入力されているボリュームを表します。Git リポジトリーボリュームは所有権管理をサポートしていません。Git リポジトリーボリュームは SELinux の再ラベル付けをサポートしています。
非推奨:GitRepo は非推奨です。git レポジトリを使用してコンテナーをプロビジョニングするには、Git を使用してレポジトリのクローンを作成する InitContainer に EmptyDir をマウントしてから、Pod のコンテナーに EmptyDir をマウントします。
- 型
-
object
- 必須
-
repository
-
プロパティー | 型 | 説明 |
---|---|---|
|
| directory は、ターゲットディレクトリー名です。'..' を含まない、または..で始まらないようにする必要があります。もしも '。' が提供されている場合、ボリュームディレクトリーは git リポジトリーになります。それ以外の場合、指定されている場合、ボリュームには、指定された名前のサブディレクトリーに git リポジトリーが含まれます。 |
|
| repository は URL です。 |
|
| revision は、指定されたリビジョンのコミットハッシュです。 |
14.1.278. .spec.volumes[].glusterfs リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod の存続期間中続く Glusterfs マウントを表します。Glusterfs ボリュームは、所有権管理または SELinux の再ラベル付けをサポートしていません。
- 型
-
object
- 必須
-
endpoints
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| endpoints は、Glusterfs トポロジーの詳細を示すエンドポイント名です。詳細: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
|
| path は Glusterfs ボリュームパスです。詳細: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
|
| この readOnly は、Glusterfs ボリュームを読み取り専用のアクセス権限で強制的にマウントします。デフォルトは false です。詳細: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
14.1.279. .spec.volumes[].hostPath リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod にマップされたホストパスを表します。ホストパスボリュームは、所有権管理または SELinux の再ラベル付けをサポートしていません。
- 型
-
object
- 必須
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ホスト上のディレクトリーのパス。パスがシンボリックリンクの場合、実際のパスへのリンクをたどります。詳細: https://kubernetes.io/docs/concepts/storage/volumes#hostpath |
|
| HostPath ボリュームのデフォルトのタイプは "" です。詳細: https://kubernetes.io/docs/concepts/storage/volumes#hostpath
使用可能な列挙値: - |
14.1.280. .spec.volumes[].iscsi リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ISCSI ディスクを表します。ISCSI ボリュームは、読み取り/書き込みとして 1 回だけマウントできます。ISCSI ボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。
- 型
-
object
- 必須
-
targetPortal
-
iqn
-
lun
-
プロパティー | 型 | 説明 |
---|---|---|
|
| chapAuthDiscovery は、iSCSI 検出 CHAP 認証をサポートするかどうかを定義します。 |
|
| chapAuthSession は、iSCSI セッション CHAP 認証をサポートするかどうかを定義します。 |
|
| fsType は、マウントするボリュームのファイルシステムタイプです。ヒント: ファイルシステムタイプがホストオペレーティングシステムでサポートされていることを確認してください。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes#iscsi |
|
| initiatorName は、カスタムの iSCSI イニシエーター名です。iscsiInterface と同時に initiatorName を指定すると、接続用に新しい iSCSI インターフェイス <target portal>:<volume name> が作成されます。 |
|
| iqn は、ターゲットの iSCSI 修飾名です。 |
|
| iscsiInterface は、iSCSI トランスポートを使用するインターフェイス名です。デフォルトは 'default' (tcp) です。 |
|
| lun は、iSCSI ターゲット Lun 番号を表します。 |
|
| ポータルは iSCSI ターゲットポータルリストです。ポートがデフォルト以外の場合、ポータルは IP または ip_addr:port のいずれかです (通常は TCP ポート 860 および 3260)。 |
|
| この readOnly は、VolumeMounts で ReadOnly 設定が強制的に指定されます。デフォルトは false です。 |
|
| LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。 |
|
| targetPortal は iSCSI Target Portal です。ポートがデフォルト以外の場合、ポータルは IP または ip_addr:port のいずれかです (通常は TCP ポート 860 および 3260)。 |
14.1.281. .spec.volumes[].iscsi.secretRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
14.1.282. .spec.volumes[].nfs リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod の存続期間中続く NFS マウントを表します。NFS ボリュームは、所有権管理または SELinux の再ラベル付けをサポートしていません。
- 型
-
object
- 必須
-
server
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| NFS サーバーがエクスポートしているパス。詳細: https://kubernetes.io/docs/concepts/storage/volumes#nfs |
|
| ここで readOnly を指定すると、NFS エクスポートが読み取り専用権限で強制的にマウントされます。デフォルトは false です。詳細: https://kubernetes.io/docs/concepts/storage/volumes#nfs |
|
| server は、NFS サーバーのホスト名または IP アドレスです。詳細: https://kubernetes.io/docs/concepts/storage/volumes#nfs |
14.1.283. .spec.volumes[].persistentVolumeClaim リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PersistentVolumeClaimVolumeSource は、同じ namespace 内のユーザーの PVC を参照します。このボリュームは、バインドされた PV を検出し、Pod 用にそのボリュームをマウントします。PersistentVolumeClaimVolumeSource は、基本的に、他の誰か (システム) が所有する別のタイプのボリュームのラッパーです。
- 型
-
object
- 必須
-
claimName
-
プロパティー | 型 | 説明 |
---|---|---|
|
| claimName は、このボリュームを使用する Pod と同じ namespace にある PersistentVolumeClaim の名前です。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims |
|
| readOnly は、VolumeMounts の ReadOnly 設定が強制的に指定されます。デフォルト: false |
14.1.284. .spec.volumes[].photonPersistentDisk リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Photon Controller 永続ディスクリソースを表します。
- 型
-
object
- 必須
-
pdID
-
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。 |
|
| pdID は、Photon Controller の永続ディスクを識別する ID です。 |
14.1.285. .spec.volumes[].portworxVolume リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PortworxVolumeSource は、Portworx ボリュームリソースを表します。
- 型
-
object
- 必須
-
volumeID
-
プロパティー | 型 | 説明 |
---|---|---|
|
| fSType は、マウントするファイルシステムタイプを表します。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。 |
|
| readOnly のデフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。 |
|
| volumeID は、Portworx ボリュームを一意に識別します |
14.1.286. .spec.volumes[].projected リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Projected ボリュームソースを表します
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| defaultMode は、作成されたファイルにデフォルトでアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。パス内のディレクトリーはこの設定の影響を受けません。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| source は、ボリュームプロジェクションのリストです。 |
|
| サポートされている他のボリュームタイプと一緒にデプロイメントされる可能性のあるプロジェクション |
14.1.287. .spec.volumes[].projected.sources リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- source は、ボリュームプロジェクションのリストです。
- 型
-
array
14.1.288. .spec.volumes[].projected.sources[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- サポートされている他のボリュームタイプと一緒にデプロイメントされる可能性のあるプロジェクション
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ConfigMap をデプロイメントされたボリュームに適合させます。 項目要素にパスへのキーの特定のマッピングが入力されていない限り、ターゲットの ConfigMap のデータフィールドの内容は、データフィールドのキーをファイル名として使用してファイルとしてデプロイメントされるボリュームに表示されます。これは、デフォルトモードのない configmap ボリュームソースと同じであることに注意してください。 |
|
| デプロイメントされたボリュームにデプロイメントするための Downward API 情報を表します。これは、デフォルトモードのない downwardAPI ボリュームソースと同じであることに注意してください。 |
|
| シークレットを、デプロイメントされたボリュームに適合させます。 ターゲットシークレットの Data フィールドの内容は、ファイル名として Data フィールドのキーを使用して、ファイルとしてデプロイメントされたボリュームに表示されます。これは、デフォルトモードのないシークレットボリュームソースと同じであることに注意してください。 |
|
| ServiceAccountTokenProjection は、デプロイメントされるサービスアカウントトークンボリュームを表します。このプロジェクションを使用して、API (Kubernetes API サーバーなど) に対して使用するサービスアカウントトークンを Pod ランタイムファイルシステムに挿入できます。 |
14.1.289. .spec.volumes[].projected.sources[].configMap リンクのコピーリンクがクリップボードにコピーされました!
- 説明
ConfigMap をデプロイメントされたボリュームに適合させます。
項目要素にパスへのキーの特定のマッピングが入力されていない限り、ターゲットの ConfigMap のデータフィールドの内容は、データフィールドのキーをファイル名として使用してファイルとしてデプロイメントされるボリュームに表示されます。これは、デフォルトモードのない configmap ボリュームソースと同じであることに注意してください。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| item が指定されていない場合、参照される ConfigMap の Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。ConfigMap に存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。 |
|
| 文字列キーをボリューム内のパスにマップします。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 任意。ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
14.1.290. .spec.volumes[].projected.sources[].configMap.items リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- item が指定されていない場合、参照される ConfigMap の Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。ConfigMap に存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。
- 型
-
array
14.1.291. .spec.volumes[].projected.sources[].configMap.items[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 文字列キーをボリューム内のパスにマップします。
- 型
-
object
- 必須
-
key
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key はプロジェクトのキーです。 |
|
| mode は任意: このファイルにアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| path はキーをマップするファイルの相対パスです。絶対的なパスではない可能性があります。パス要素 '..' を含めることはできません。文字列 '..' で始まらない場合があります。 |
14.1.292. .spec.volumes[].projected.sources[].downwardAPI リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- デプロイメントされたボリュームにデプロイメントするための Downward API 情報を表します。これは、デフォルトモードのない downwardAPI ボリュームソースと同じであることに注意してください。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Items は DownwardAPIVolume ファイルのリストです |
|
| DownwardAPIVolumeFile は、Pod フィールドを含むファイルを作成するための情報を表します |
14.1.293. .spec.volumes[].projected.sources[].downwardAPI.items リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Items は DownwardAPIVolume ファイルのリストです
- 型
-
array
14.1.294. .spec.volumes[].projected.sources[].downwardAPI.items[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DownwardAPIVolumeFile は、Pod フィールドを含むファイルを作成するための情報を表します
- 型
-
object
- 必須
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。 |
|
| オプション: このファイルの権限を設定するために使用されるモードビットは、0000 から 0777 までの 8 進数値、または 0 から 511 までの 10 進数値でなければなりません。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| 必須: パスは、作成するファイルの相対パス名です。絶対パスまたは '..' パスを含めることはできません。utf-8 でエンコードする必要があります。相対パスの最初の項目は '..' で始まってはなりません。 |
|
| ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。 |
14.1.295. .spec.volumes[].projected.sources[].downwardAPI.items[].fieldRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。
- 型
-
object
- 必須
-
fieldPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| FieldPath が記述されているスキーマのバージョン。デフォルトは "v1" です。 |
|
| 指定された API バージョンで選択するフィールドのパス。 |
14.1.296. .spec.volumes[].projected.sources[].downwardAPI.items[].resourceFieldRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。
- 型
-
object
- 必須
-
resource
-
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナー名: ボリュームには必須、env 変数にはオプション |
| 公開されたリソースの出力形式を指定します。デフォルトは "1" です。 | |
|
| 必須: 選択するリソース |
14.1.297. .spec.volumes[].projected.sources[].secret リンクのコピーリンクがクリップボードにコピーされました!
- 説明
シークレットを、デプロイメントされたボリュームに適合させます。
ターゲットシークレットの Data フィールドの内容は、ファイル名として Data フィールドのキーを使用して、ファイルとしてデプロイメントされたボリュームに表示されます。これは、デフォルトモードのないシークレットボリュームソースと同じであることに注意してください。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| items が指定されていない場合、参照されるシークレットの Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。シークレットに存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。 |
|
| 文字列キーをボリューム内のパスにマップします。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| オプションフィールドは、シークレットかそのキーを定義する必要があるかどうかを指定します。 |
14.1.298. .spec.volumes[].projected.sources[].secret.items リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- items が指定されていない場合、参照されるシークレットの Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。シークレットに存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。
- 型
-
array
14.1.299. .spec.volumes[].projected.sources[].secret.items[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 文字列キーをボリューム内のパスにマップします。
- 型
-
object
- 必須
-
key
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key はプロジェクトのキーです。 |
|
| mode は任意: このファイルにアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| path はキーをマップするファイルの相対パスです。絶対的なパスではない可能性があります。パス要素 '..' を含めることはできません。文字列 '..' で始まらない場合があります。 |
14.1.300. .spec.volumes[].projected.sources[].serviceAccountToken リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ServiceAccountTokenProjection は、デプロイメントされるサービスアカウントトークンボリュームを表します。このプロジェクションを使用して、API (Kubernetes API サーバーなど) に対して使用するサービスアカウントトークンを Pod ランタイムファイルシステムに挿入できます。
- 型
-
object
- 必須
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| audience は、トークンの対象オーディエンスです。トークンの受信者は、トークンのオーディエンスで指定された識別子で自分自身を識別する必要があります。そうでない場合は、トークンを拒否する必要があります。対象はデフォルトで API サーバーの識別子に設定されます。 |
|
| expirationSeconds は、サービスアカウントトークンの要求された有効期間です。トークンの有効期限が近づくと、kubelet ボリュームプラグインはサービスアカウントトークンをプロアクティブにローテーションします。トークンが存続時間の 80% より古い場合、またはトークンが 24 時間より古い場合、kubelet はトークンのローテーションを開始します。デフォルトは 1 時間で、少なくとも 10 分である必要があります。 |
|
| path は、トークンのデプロイメント先となるファイルのマウントポイントに対する相対パスです。 |
14.1.301. .spec.volumes[].quobyte リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod の存続期間中続く Quobyte マウントを表します。Quobyte ボリュームは、所有権管理または SELinux の再ラベル付けをサポートしていません。
- 型
-
object
- 必須
-
registry
-
volume
-
プロパティー | 型 | 説明 |
---|---|---|
|
| アクセスできるボリュームをマップするグループ。デフォルトは no group です。 |
|
| ここでの readOnly は、Quobyte ボリュームを読み取り専用のアクセス権限で強制的にマウントします。デフォルトは false です。 |
|
| registry は、host:port ペアの文字列として指定された単一または複数の Quobyte Registry サービスを表し (複数のエントリーはコンマで区切る)、ボリュームの中央レジストリーとして機能します。 |
|
| 動的にプロビジョニングされた Quobyte ボリュームで使用されるバックエンドで指定の Quobyte ボリュームを所有するテナント。値はプラグインにより設定されます。 |
|
| アクセスできるボリュームをマップするグループ。デフォルトは serivceaccount user です。 |
|
| volume は、すでに作成されているクオバイトボリュームを名前で参照する文字列です。 |
14.1.302. .spec.volumes[].rbd リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod の存続時間中続く Rados Block Device マウントを表します。RBD ボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。
- 型
-
object
- 必須
-
monitors
-
image
-
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするボリュームのファイルシステムタイプです。ヒント: ファイルシステムタイプがホストオペレーティングシステムでサポートされていることを確認してください。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes#rbd |
|
| image は rados イメージ名です。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| keyring は、RBDUser のキーリングへのパスです。デフォルトは/etc/ceph/keyring です。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| monitors は Ceph モニターのコレクションです。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| pool は rados プール名です。デフォルトは rbd です。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| この readOnly は、VolumeMounts で ReadOnly 設定が強制的に指定されます。デフォルトは false です。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。 |
|
| user は rados ユーザー名です。これにより、プール内にイメージを作成できます。デフォルトは admin です。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
14.1.303. .spec.volumes[].rbd.secretRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
14.1.304. .spec.volumes[].scaleIO リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ScaleIOVolumeSource は、永続的な ScaleIO ボリュームを表します
- 型
-
object
- 必須
-
gateway
-
system
-
secretRef
-
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。デフォルトは "xfs" です。 |
|
| gateway は、ScaleIO API ゲートウェイのホストアドレスです。 |
|
| protectionDomain は、設定されたストレージの ScaleIO 保護ドメインの名前です。 |
|
| readOnly。デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。 |
|
| LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。 |
|
| sslEnabled Flag は、ゲートウェイとの SSL 通信を有効/無効にします。デフォルトは false です |
|
| storageMode は、ボリュームのストレージを ThickProvisioned にするか ThinProvisioned にするかを示します。デフォルトは ThinProvisioned です。 |
|
| storagePool は、保護ドメインに関連付けられた ScaleIO ストレージプールです。 |
|
| system は、ScaleIO で設定されたストレージシステムの名前です。 |
|
| volumeName は、このボリュームソースに関連付けられている、ScaleIO システムですでに作成されているボリュームの名前です。 |
14.1.305. .spec.volumes[].scaleIO.secretRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
14.1.306. .spec.volumes[].secret リンクのコピーリンクがクリップボードにコピーされました!
- 説明
シークレットをボリュームに適合させます。
ターゲットシークレットの Data フィールドの内容は、ファイル名として Data フィールドのキーを使用してファイルとしてボリュームに表示されます。シークレットボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| defaultMode は任意: デフォルトで、作成されたファイルのアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。デフォルトは 0644 に設定されます。パス内のディレクトリーはこの設定の影響を受けません。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| items が指定されていない場合、参照されるシークレットの Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。シークレットに存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。 |
|
| 文字列キーをボリューム内のパスにマップします。 |
|
| optional フィールド。シークレットかそのキーを定義する必要があるかどうかを指定します。 |
|
| secretName は、使用する Pod の namespace 内のシークレットの名前です。詳細: https://kubernetes.io/docs/concepts/storage/volumes#secret |
14.1.307. .spec.volumes[].secret.items リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- items が指定されていない場合、参照されるシークレットの Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。シークレットに存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。
- 型
-
array
14.1.308. .spec.volumes[].secret.items[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 文字列キーをボリューム内のパスにマップします。
- 型
-
object
- 必須
-
key
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key はプロジェクトのキーです。 |
|
| mode は任意: このファイルにアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| path はキーをマップするファイルの相対パスです。絶対的なパスではない可能性があります。パス要素 '..' を含めることはできません。文字列 '..' で始まらない場合があります。 |
14.1.309. .spec.volumes[].storageos リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- StorageOS 永続ボリュームリソースを表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。 |
|
| readOnly のデフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。 |
|
| LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。 |
|
| volumeName は、人間が判読えきる形式の StorageOS ボリュームの名前です。ボリューム名は namespace 内でのみ一意です。 |
|
| volumeNamespace は、StorageOS 内のボリュームのスコープを指定します。namespace が指定されていない場合は、Pod の namespace が使用されます。これにより、Kubernetes の名前スコープを StorageOS 内にミラーリングして、より緊密に統合することができます。VolumeName を任意の名前に設定して、デフォルトの動作をオーバーライドします。StorageOS 内で namespace を使用していない場合は、"デフォルト" に設定します。StorageOS 内に存在しない namespace が作成されます。 |
14.1.310. .spec.volumes[].storageos.secretRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
14.1.311. .spec.volumes[].vsphereVolume リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- vSphere ボリュームリソースを表します。
- 型
-
object
- 必須
-
volumePath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。 |
|
| storagePolicyID は、StoragePolicyName に関連付けられたストレージポリシーベースの管理 (SPBM) プロファイル ID です。 |
|
| storagePolicyName は、ストレージポリシーベースの管理 (SPBM) プロファイル名です。 |
|
| volumePath は、vSphere ボリューム vmdk を識別するパスです。 |
14.1.312. .status リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodStatus は、Pod のステータスに関する情報を表します。特に Pod をホストするノードがコントロールプレーンに接続できない場合、ステータスはシステムの実際の状態を追跡する可能性があります。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Pod の現在のサービス状態。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-conditions |
|
| PodCondition には、この Pod の現在の状態の詳細が含まれています。 |
|
| リストには、マニフェストのコンテナーごとに 1 つのエントリーがあります。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-and-container-status |
|
| ContainerStatus には、このコンテナーの現在のステータスの詳細が含まれています。 |
|
| この Pod で実行されたエフェメラルコンテナーのステータス。 |
|
| ContainerStatus には、このコンテナーの現在のステータスの詳細が含まれています。 |
|
| hostIP は、Pod の割り当て先であるホストの IP アドレスを保持します。Pod がまだ開始されていない場合は空です。Pod は、kubelet で問題のあるノードに割り当てられる可能性があります。その場合、Pod にノードが割り当てられていても HostIP は更新されません。 |
|
| hostIPs はホストに割り当てられた IP アドレスを保持します。このフィールドが指定されている場合、最初のエントリーは hostIP フィールドと一致する必要があります。Pod がまだ開始されていない場合、このリストは空になります。Pod は、kubelet で問題のあるノードに割り当てられる可能性があります。その場合、この Pod にノードが割り当てられていても HostIP は更新されません。 |
|
| HostIP は、ホストに割り当てられた単一の IP アドレスを表します。 |
|
| リストには、マニフェストの init コンテナーごとに 1 つのエントリーがあります。最後に成功した init コンテナーには ready = true が設定され、最後に起動したコンテナーには startTime が設定されます。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-and-container-status |
|
| ContainerStatus には、このコンテナーの現在のステータスの詳細が含まれています。 |
|
| Pod がこの状態にある理由の詳細を示す、人が判読できるメッセージ。 |
|
| nominatedNodeName は、この Pod がノード上の他の Pod をプリエンプトする場合にのみ設定されますが、プリエンプションの犠牲となったものが正常な終了期間を受け取るため、すぐにスケジュールすることはできません。このフィールドは、Pod がこのノードでスケジュールされることを保証するものではありません。他のノードがすぐに利用可能になると、Scheduler は Pod を別の場所に配置することを決定する場合があります。スケジューラーは、このノード上のリソースを、プリエンプション後に作成された優先度の高い Pod に割り当てることもできます。その結果、Pod がスケジュールされている場合、このフィールドは PodSpec.nodeName とは異なる場合があります。 |
|
| Pod のフェーズは、Pod がライフサイクルのどこにあるかを簡単にまとめたものです。条件配列、理由フィールドおよびメッセージフィールド、ならびに個々のコンテナーステータス配列には、Pod のステータスに関する詳細が含まれています。可能な位相値は 5 つあります。 保留中: Pod は Kubernetes システムによって受け入れられましたが、1 つ以上のコンテナーイメージが作成されていません。これには、スケジュールされるまでの時間と、ネットワーク経由でイメージをダウンロードするために費やされた時間が含まれます。これには時間がかかる場合があります。実行中: Pod はノードにバインドされ、すべてのコンテナーが作成されました。1 つ以上のコンテナーが実行中か、または起動または再起動のプロセスが実行中です。成功: Pod 内のすべてのコンテナーは正常に終了し、再起動されません。失敗: Pod 内のすべてのコンテナーが終了し、少なくとも 1 つのコンテナーが失敗して終了しました。コンテナーはゼロ以外のステータスで終了するか、またはシステムによって終了された状態であるかのいずれかになります。不明: 何らかの理由で Pod の状態を取得できませんでした。通常、Pod のホストとの通信エラーが原因です。 詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-phase
使用可能な列挙値: - |
|
| Pod に割り当てられた podIP アドレス少なくともクラスター内でルーティング可能。まだ割り当てられていない場合は空にします。 |
|
| podIPs は、Pod に割り当てられた IP アドレスを保持します。このフィールドを指定する場合、0 番目のエントリーは podIP フィールドと一致する必要があります。Pod には、IPv4 と IPv6 のそれぞれに最大 1 つの値を割り当てることができます。IP がまだ割り当てられていない場合は、このリストが空です。 |
|
| PodIP は、Pod に割り当てられた単一の IP アドレスを表します。 |
|
| リソース要件に基づいて Pod に割り当てられたサービス品質 (QOS) 分類利用可能な QOS クラスは、PodQOSClass タイプを参照してください。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-qos/#quality-of - サービスクラス
使用可能な列挙値: - |
|
| Pod がこの状態にある理由の詳細を示す簡単な CamelCase メッセージ。たとえば、以下のようになります。'Evicted' |
|
| Pod のコンテナーに必要とされるリソースサイズ変更のステータス。リソースのサイズ変更が保留中の場合は、空になります。コンテナーリソースに変更を加えると、これが自動的に "Proposed" に設定されます。 |
|
| リソース要求のステータス。 |
|
| PodResourceClaimStatus は、ResourceClaimTemplate を参照する各 PodResourceClaim の PodStatus に保存されます。対応する ResourceClaim の生成された名前を保存します。 |
| time | オブジェクトが Kubelet によって確認された RFC3339 の日付および時刻。これは、Kubelet が Pod のコンテナーイメージをプルする前です。 |
14.1.313. .status.conditions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod の現在のサービス状態。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-conditions
- 型
-
array
14.1.314. .status.conditions[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodCondition には、この Pod の現在の状態の詳細が含まれています。
- 型
-
object
- 必須
-
type
-
status
-
プロパティー | 型 | 説明 |
---|---|---|
| time | 最後に状態を調べました。 |
| time | 最後にある状態から別の状態に遷移した時間。 |
|
| 最後にある状態から別の状態に遷移した時間。 |
|
| 条件の最後の遷移の一意の 1 単語の CamelCase 理由。 |
|
| ステータスは、状態のステータスです。True、False、Unknown の場合があります。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-conditions |
|
| タイプは条件のタイプです。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-conditions |
14.1.315. .status.containerStatuses リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リストには、マニフェストのコンテナーごとに 1 つのエントリーがあります。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-and-container-status
- 型
-
array
14.1.316. .status.containerStatuses[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerStatus には、このコンテナーの現在のステータスの詳細が含まれています。
- 型
-
object
- 必須
-
name
-
ready
-
restartCount
-
image
-
imageID
-
プロパティー | 型 | 説明 |
---|---|---|
| AllocatedResources は、ノードによってこのコンテナーに割り当てられたコンピューティングリソースを表します。Kubelet は、Pod の承認が成功し、必要な Pod のサイズ変更が正常に承認された後、この値を Container.Resources.Requests に設定します。 | |
|
| containerID は、'<type>://<container_id>' 形式のコンテナーの ID です。type は、CRI API の Version 呼び出しから返されるコンテナーランタイム識別子 (例: "containerd") です。 |
|
| image は、コンテナーが実行されているコンテナーイメージの名前です。コンテナーイメージは、ランタイムによって解決されている可能性があるため、PodSpec で使用されるイメージと一致しない可能性があります。詳細: https://kubernetes.io/docs/concepts/containers/images。 |
|
| imageID は、コンテナーのイメージのイメージ ID です。image ID は、ランタイムによって解決されている可能性があるため、PodSpec で使用されるイメージのイメージ ID と一致しない可能性があります。 |
|
| ContainerState は、コンテナーの可能な状態を保持します。そのメンバーの 1 つだけを指定できます。それらのいずれも指定していないと、デフォルトは ContainerStateWaiting です。 |
|
| name は、コンテナーの一意の名前を表す DNS_LABEL です。Pod 内の各コンテナーには、すべてのコンテナータイプ全体で、名前が一意である必要があります。これを更新することはできません。 |
|
| Ready は、コンテナーが準備状況チェックに現在、合格しているかどうかを指定します。この値は、readiness プローブが実行していくうちに、変化します。readiness プローブが指定されていない場合、コンテナーが完全に開始されると、このフィールドはデフォルトで true になります (開始済みフィールドを参照)。 この値は通常、コンテナーがトラフィックを受け入れる準備ができているかどうかを判断するために使用されます。 |
|
| ResourceRequirements は、コンピュートリソースの要件を説明します。 |
|
| RestartCount は、コンテナーが再起動された回数を保持します。Kubelet は常に値をインクリメントしようとしますが、ノードの再起動により状態が失われ、値が 0 にリセットされる場合があります。値が負の値になることはありません。 |
|
| Started は、コンテナーが postStart ライフサイクルフックを終了し、startup プローブを合格したかどうかを示します。false として初期化され、startupProbe が成功したと見なされた後に true になります。コンテナーが再起動されたとき、または kubelet が一時的にステータスを失った場合は、false にリセットされます。いずれの場合も、startup プローブが再度実行されます。startupProbe が定義されておらず、コンテナーが実行中で、postStart ライフサイクルフックに合格している場合は、常に true です。null 値は false と同じように処理される必要があります。 |
|
| ContainerState は、コンテナーの可能な状態を保持します。そのメンバーの 1 つだけを指定できます。それらのいずれも指定していないと、デフォルトは ContainerStateWaiting です。 |
14.1.317. .status.containerStatuses[].lastState リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerState は、コンテナーの可能な状態を保持します。そのメンバーの 1 つだけを指定できます。それらのいずれも指定していないと、デフォルトは ContainerStateWaiting です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ContainerStateRunning は、コンテナーの実行状態です。 |
|
| ContainerStateTerminated は、コンテナーの終了状態です。 |
|
| ContainerStateWaiting は、コンテナーの待機状態です。 |
14.1.318. .status.containerStatuses[].lastState.running リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerStateRunning は、コンテナーの実行状態です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
| time | コンテナーが最後に (再) 起動した時刻 |
14.1.319. .status.containerStatuses[].lastState.terminated リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerStateTerminated は、コンテナーの終了状態です。
- 型
-
object
- 必須
-
exitCode
-
プロパティー | 型 | 説明 |
---|---|---|
|
| '<type>://<container_id>' 形式のコンテナーの ID |
|
| コンテナーの最後の終了からの終了ステータス |
| time | コンテナーが最後に終了した時刻 |
|
| コンテナーの最後の終了に関するメッセージ |
|
| コンテナーの最後の終了からの (簡単な) 理由 |
|
| コンテナーの最後の終了からのシグナル |
| time | コンテナーの前回の実行が開始された時刻 |
14.1.320. .status.containerStatuses[].lastState.waiting リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerStateWaiting は、コンテナーの待機状態です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナーがまだ実行されていない理由に関するメッセージ。 |
|
| コンテナーがまだ実行されていない (簡単な) 理由。 |
14.1.321. .status.containerStatuses[].resources リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceRequirements は、コンピュートリソースの要件を説明します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。 これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。 このフィールドは不変です。これはコンテナーにのみ設定できます。 |
|
| ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。 |
| limits は、許可されるコンピュートリソースの最大量を示します。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 | |
| requests は、必要なコンピュートリソースの最小量を示します。コンテナーで Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
14.1.322. .status.containerStatuses[].resources.claims リンクのコピーリンクがクリップボードにコピーされました!
- 説明
Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。
これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。
このフィールドは不変です。これはコンテナーにのみ設定できます。
- 型
-
array
14.1.323. .status.containerStatuses[].resources.claims[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。 |
14.1.324. .status.containerStatuses[].state リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerState は、コンテナーの可能な状態を保持します。そのメンバーの 1 つだけを指定できます。それらのいずれも指定していないと、デフォルトは ContainerStateWaiting です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ContainerStateRunning は、コンテナーの実行状態です。 |
|
| ContainerStateTerminated は、コンテナーの終了状態です。 |
|
| ContainerStateWaiting は、コンテナーの待機状態です。 |
14.1.325. .status.containerStatuses[].state.running リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerStateRunning は、コンテナーの実行状態です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
| time | コンテナーが最後に (再) 起動した時刻 |
14.1.326. .status.containerStatuses[].state.terminated リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerStateTerminated は、コンテナーの終了状態です。
- 型
-
object
- 必須
-
exitCode
-
プロパティー | 型 | 説明 |
---|---|---|
|
| '<type>://<container_id>' 形式のコンテナーの ID |
|
| コンテナーの最後の終了からの終了ステータス |
| time | コンテナーが最後に終了した時刻 |
|
| コンテナーの最後の終了に関するメッセージ |
|
| コンテナーの最後の終了からの (簡単な) 理由 |
|
| コンテナーの最後の終了からのシグナル |
| time | コンテナーの前回の実行が開始された時刻 |
14.1.327. .status.containerStatuses[].state.waiting リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerStateWaiting は、コンテナーの待機状態です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナーがまだ実行されていない理由に関するメッセージ。 |
|
| コンテナーがまだ実行されていない (簡単な) 理由。 |
14.1.328. .status.ephemeralContainerStatuses リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- この Pod で実行されたエフェメラルコンテナーのステータス。
- 型
-
array
14.1.329. .status.ephemeralContainerStatuses[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerStatus には、このコンテナーの現在のステータスの詳細が含まれています。
- 型
-
object
- 必須
-
name
-
ready
-
restartCount
-
image
-
imageID
-
プロパティー | 型 | 説明 |
---|---|---|
| AllocatedResources は、ノードによってこのコンテナーに割り当てられたコンピューティングリソースを表します。Kubelet は、Pod の承認が成功し、必要な Pod のサイズ変更が正常に承認された後、この値を Container.Resources.Requests に設定します。 | |
|
| containerID は、'<type>://<container_id>' 形式のコンテナーの ID です。type は、CRI API の Version 呼び出しから返されるコンテナーランタイム識別子 (例: "containerd") です。 |
|
| image は、コンテナーが実行されているコンテナーイメージの名前です。コンテナーイメージは、ランタイムによって解決されている可能性があるため、PodSpec で使用されるイメージと一致しない可能性があります。詳細: https://kubernetes.io/docs/concepts/containers/images。 |
|
| imageID は、コンテナーのイメージのイメージ ID です。image ID は、ランタイムによって解決されている可能性があるため、PodSpec で使用されるイメージのイメージ ID と一致しない可能性があります。 |
|
| ContainerState は、コンテナーの可能な状態を保持します。そのメンバーの 1 つだけを指定できます。それらのいずれも指定していないと、デフォルトは ContainerStateWaiting です。 |
|
| name は、コンテナーの一意の名前を表す DNS_LABEL です。Pod 内の各コンテナーには、すべてのコンテナータイプ全体で、名前が一意である必要があります。これを更新することはできません。 |
|
| Ready は、コンテナーが準備状況チェックに現在、合格しているかどうかを指定します。この値は、readiness プローブが実行していくうちに、変化します。readiness プローブが指定されていない場合、コンテナーが完全に開始されると、このフィールドはデフォルトで true になります (開始済みフィールドを参照)。 この値は通常、コンテナーがトラフィックを受け入れる準備ができているかどうかを判断するために使用されます。 |
|
| ResourceRequirements は、コンピュートリソースの要件を説明します。 |
|
| RestartCount は、コンテナーが再起動された回数を保持します。Kubelet は常に値をインクリメントしようとしますが、ノードの再起動により状態が失われ、値が 0 にリセットされる場合があります。値が負の値になることはありません。 |
|
| Started は、コンテナーが postStart ライフサイクルフックを終了し、startup プローブを合格したかどうかを示します。false として初期化され、startupProbe が成功したと見なされた後に true になります。コンテナーが再起動されたとき、または kubelet が一時的にステータスを失った場合は、false にリセットされます。いずれの場合も、startup プローブが再度実行されます。startupProbe が定義されておらず、コンテナーが実行中で、postStart ライフサイクルフックに合格している場合は、常に true です。null 値は false と同じように処理される必要があります。 |
|
| ContainerState は、コンテナーの可能な状態を保持します。そのメンバーの 1 つだけを指定できます。それらのいずれも指定していないと、デフォルトは ContainerStateWaiting です。 |
14.1.330. .status.ephemeralContainerStatuses[].lastState リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerState は、コンテナーの可能な状態を保持します。そのメンバーの 1 つだけを指定できます。それらのいずれも指定していないと、デフォルトは ContainerStateWaiting です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ContainerStateRunning は、コンテナーの実行状態です。 |
|
| ContainerStateTerminated は、コンテナーの終了状態です。 |
|
| ContainerStateWaiting は、コンテナーの待機状態です。 |
14.1.331. .status.ephemeralContainerStatuses[].lastState.running リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerStateRunning は、コンテナーの実行状態です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
| time | コンテナーが最後に (再) 起動した時刻 |
14.1.332. .status.ephemeralContainerStatuses[].lastState.terminated リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerStateTerminated は、コンテナーの終了状態です。
- 型
-
object
- 必須
-
exitCode
-
プロパティー | 型 | 説明 |
---|---|---|
|
| '<type>://<container_id>' 形式のコンテナーの ID |
|
| コンテナーの最後の終了からの終了ステータス |
| time | コンテナーが最後に終了した時刻 |
|
| コンテナーの最後の終了に関するメッセージ |
|
| コンテナーの最後の終了からの (簡単な) 理由 |
|
| コンテナーの最後の終了からのシグナル |
| time | コンテナーの前回の実行が開始された時刻 |
14.1.333. .status.ephemeralContainerStatuses[].lastState.waiting リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerStateWaiting は、コンテナーの待機状態です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナーがまだ実行されていない理由に関するメッセージ。 |
|
| コンテナーがまだ実行されていない (簡単な) 理由。 |
14.1.334. .status.ephemeralContainerStatuses[].resources リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceRequirements は、コンピュートリソースの要件を説明します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。 これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。 このフィールドは不変です。これはコンテナーにのみ設定できます。 |
|
| ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。 |
| limits は、許可されるコンピュートリソースの最大量を示します。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 | |
| requests は、必要なコンピュートリソースの最小量を示します。コンテナーで Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
14.1.335. .status.ephemeralContainerStatuses[].resources.claims リンクのコピーリンクがクリップボードにコピーされました!
- 説明
Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。
これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。
このフィールドは不変です。これはコンテナーにのみ設定できます。
- 型
-
array
14.1.336. .status.ephemeralContainerStatuses[].resources.claims[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。 |
14.1.337. .status.ephemeralContainerStatuses[].state リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerState は、コンテナーの可能な状態を保持します。そのメンバーの 1 つだけを指定できます。それらのいずれも指定していないと、デフォルトは ContainerStateWaiting です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ContainerStateRunning は、コンテナーの実行状態です。 |
|
| ContainerStateTerminated は、コンテナーの終了状態です。 |
|
| ContainerStateWaiting は、コンテナーの待機状態です。 |
14.1.338. .status.ephemeralContainerStatuses[].state.running リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerStateRunning は、コンテナーの実行状態です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
| time | コンテナーが最後に (再) 起動した時刻 |
14.1.339. .status.ephemeralContainerStatuses[].state.terminated リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerStateTerminated は、コンテナーの終了状態です。
- 型
-
object
- 必須
-
exitCode
-
プロパティー | 型 | 説明 |
---|---|---|
|
| '<type>://<container_id>' 形式のコンテナーの ID |
|
| コンテナーの最後の終了からの終了ステータス |
| time | コンテナーが最後に終了した時刻 |
|
| コンテナーの最後の終了に関するメッセージ |
|
| コンテナーの最後の終了からの (簡単な) 理由 |
|
| コンテナーの最後の終了からのシグナル |
| time | コンテナーの前回の実行が開始された時刻 |
14.1.340. .status.ephemeralContainerStatuses[].state.waiting リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerStateWaiting は、コンテナーの待機状態です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナーがまだ実行されていない理由に関するメッセージ。 |
|
| コンテナーがまだ実行されていない (簡単な) 理由。 |
14.1.341. .status.hostIPs リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- hostIPs はホストに割り当てられた IP アドレスを保持します。このフィールドが指定されている場合、最初のエントリーは hostIP フィールドと一致する必要があります。Pod がまだ開始されていない場合、このリストは空になります。Pod は、kubelet で問題のあるノードに割り当てられる可能性があります。その場合、この Pod にノードが割り当てられていても HostIP は更新されません。
- 型
-
array
14.1.342. .status.hostIPs[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HostIP は、ホストに割り当てられた単一の IP アドレスを表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| IP はホストに割り当てられた IP アドレスです |
14.1.343. .status.initContainerStatuses リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リストには、マニフェストの init コンテナーごとに 1 つのエントリーがあります。最後に成功した init コンテナーには ready = true が設定され、最後に起動したコンテナーには startTime が設定されます。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-and-container-status
- 型
-
array
14.1.344. .status.initContainerStatuses[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerStatus には、このコンテナーの現在のステータスの詳細が含まれています。
- 型
-
object
- 必須
-
name
-
ready
-
restartCount
-
image
-
imageID
-
プロパティー | 型 | 説明 |
---|---|---|
| AllocatedResources は、ノードによってこのコンテナーに割り当てられたコンピューティングリソースを表します。Kubelet は、Pod の承認が成功し、必要な Pod のサイズ変更が正常に承認された後、この値を Container.Resources.Requests に設定します。 | |
|
| containerID は、'<type>://<container_id>' 形式のコンテナーの ID です。type は、CRI API の Version 呼び出しから返されるコンテナーランタイム識別子 (例: "containerd") です。 |
|
| image は、コンテナーが実行されているコンテナーイメージの名前です。コンテナーイメージは、ランタイムによって解決されている可能性があるため、PodSpec で使用されるイメージと一致しない可能性があります。詳細: https://kubernetes.io/docs/concepts/containers/images。 |
|
| imageID は、コンテナーのイメージのイメージ ID です。image ID は、ランタイムによって解決されている可能性があるため、PodSpec で使用されるイメージのイメージ ID と一致しない可能性があります。 |
|
| ContainerState は、コンテナーの可能な状態を保持します。そのメンバーの 1 つだけを指定できます。それらのいずれも指定していないと、デフォルトは ContainerStateWaiting です。 |
|
| name は、コンテナーの一意の名前を表す DNS_LABEL です。Pod 内の各コンテナーには、すべてのコンテナータイプ全体で、名前が一意である必要があります。これを更新することはできません。 |
|
| Ready は、コンテナーが準備状況チェックに現在、合格しているかどうかを指定します。この値は、readiness プローブが実行していくうちに、変化します。readiness プローブが指定されていない場合、コンテナーが完全に開始されると、このフィールドはデフォルトで true になります (開始済みフィールドを参照)。 この値は通常、コンテナーがトラフィックを受け入れる準備ができているかどうかを判断するために使用されます。 |
|
| ResourceRequirements は、コンピュートリソースの要件を説明します。 |
|
| RestartCount は、コンテナーが再起動された回数を保持します。Kubelet は常に値をインクリメントしようとしますが、ノードの再起動により状態が失われ、値が 0 にリセットされる場合があります。値が負の値になることはありません。 |
|
| Started は、コンテナーが postStart ライフサイクルフックを終了し、startup プローブを合格したかどうかを示します。false として初期化され、startupProbe が成功したと見なされた後に true になります。コンテナーが再起動されたとき、または kubelet が一時的にステータスを失った場合は、false にリセットされます。いずれの場合も、startup プローブが再度実行されます。startupProbe が定義されておらず、コンテナーが実行中で、postStart ライフサイクルフックに合格している場合は、常に true です。null 値は false と同じように処理される必要があります。 |
|
| ContainerState は、コンテナーの可能な状態を保持します。そのメンバーの 1 つだけを指定できます。それらのいずれも指定していないと、デフォルトは ContainerStateWaiting です。 |
14.1.345. .status.initContainerStatuses[].lastState リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerState は、コンテナーの可能な状態を保持します。そのメンバーの 1 つだけを指定できます。それらのいずれも指定していないと、デフォルトは ContainerStateWaiting です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ContainerStateRunning は、コンテナーの実行状態です。 |
|
| ContainerStateTerminated は、コンテナーの終了状態です。 |
|
| ContainerStateWaiting は、コンテナーの待機状態です。 |
14.1.346. .status.initContainerStatuses[].lastState.running リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerStateRunning は、コンテナーの実行状態です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
| time | コンテナーが最後に (再) 起動した時刻 |
14.1.347. .status.initContainerStatuses[].lastState.terminated リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerStateTerminated は、コンテナーの終了状態です。
- 型
-
object
- 必須
-
exitCode
-
プロパティー | 型 | 説明 |
---|---|---|
|
| '<type>://<container_id>' 形式のコンテナーの ID |
|
| コンテナーの最後の終了からの終了ステータス |
| time | コンテナーが最後に終了した時刻 |
|
| コンテナーの最後の終了に関するメッセージ |
|
| コンテナーの最後の終了からの (簡単な) 理由 |
|
| コンテナーの最後の終了からのシグナル |
| time | コンテナーの前回の実行が開始された時刻 |
14.1.348. .status.initContainerStatuses[].lastState.waiting リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerStateWaiting は、コンテナーの待機状態です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナーがまだ実行されていない理由に関するメッセージ。 |
|
| コンテナーがまだ実行されていない (簡単な) 理由。 |
14.1.349. .status.initContainerStatuses[].resources リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceRequirements は、コンピュートリソースの要件を説明します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。 これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。 このフィールドは不変です。これはコンテナーにのみ設定できます。 |
|
| ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。 |
| limits は、許可されるコンピュートリソースの最大量を示します。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 | |
| requests は、必要なコンピュートリソースの最小量を示します。コンテナーで Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
14.1.350. .status.initContainerStatuses[].resources.claims リンクのコピーリンクがクリップボードにコピーされました!
- 説明
Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。
これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。
このフィールドは不変です。これはコンテナーにのみ設定できます。
- 型
-
array
14.1.351. .status.initContainerStatuses[].resources.claims[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。 |
14.1.352. .status.initContainerStatuses[].state リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerState は、コンテナーの可能な状態を保持します。そのメンバーの 1 つだけを指定できます。それらのいずれも指定していないと、デフォルトは ContainerStateWaiting です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ContainerStateRunning は、コンテナーの実行状態です。 |
|
| ContainerStateTerminated は、コンテナーの終了状態です。 |
|
| ContainerStateWaiting は、コンテナーの待機状態です。 |
14.1.353. .status.initContainerStatuses[].state.running リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerStateRunning は、コンテナーの実行状態です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
| time | コンテナーが最後に (再) 起動した時刻 |
14.1.354. .status.initContainerStatuses[].state.terminated リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerStateTerminated は、コンテナーの終了状態です。
- 型
-
object
- 必須
-
exitCode
-
プロパティー | 型 | 説明 |
---|---|---|
|
| '<type>://<container_id>' 形式のコンテナーの ID |
|
| コンテナーの最後の終了からの終了ステータス |
| time | コンテナーが最後に終了した時刻 |
|
| コンテナーの最後の終了に関するメッセージ |
|
| コンテナーの最後の終了からの (簡単な) 理由 |
|
| コンテナーの最後の終了からのシグナル |
| time | コンテナーの前回の実行が開始された時刻 |
14.1.355. .status.initContainerStatuses[].state.waiting リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerStateWaiting は、コンテナーの待機状態です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナーがまだ実行されていない理由に関するメッセージ。 |
|
| コンテナーがまだ実行されていない (簡単な) 理由。 |
14.1.356. .status.podIPs リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- podIPs は、Pod に割り当てられた IP アドレスを保持します。このフィールドを指定する場合、0 番目のエントリーは podIP フィールドと一致する必要があります。Pod には、IPv4 と IPv6 のそれぞれに最大 1 つの値を割り当てることができます。IP がまだ割り当てられていない場合は、このリストが空です。
- 型
-
array
14.1.357. .status.podIPs[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodIP は、Pod に割り当てられた単一の IP アドレスを表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| IP は Pod に割り当てられた IP アドレスです |
14.1.358. .status.resourceClaimStatuses リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リソース要求のステータス。
- 型
-
array
14.1.359. .status.resourceClaimStatuses[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodResourceClaimStatus は、ResourceClaimTemplate を参照する各 PodResourceClaim の PodStatus に保存されます。対応する ResourceClaim の生成された名前を保存します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は Pod 内でこのリソース要求を一意に識別します。これは、pod.spec.resourceClaims 内のエントリーの名前と一致する必要があり、文字列は DNS_LABEL である必要があります。 |
|
| ResourceClaimName は、Pod の namespace 内の Pod 用に生成された ResourceClaim の名前です。これが設定されていない場合は、ResourceClaim を生成する必要はありません。その場合、pod.spec.resourceClaims エントリーは無視できます。 |
14.2. API エンドポイント リンクのコピーリンクがクリップボードにコピーされました!
以下の API エンドポイントを利用できます。
/api/v1/pods
-
GET
: Pod 種類のオブジェクトをリスト表示または監視するロール
-
/api/v1/watch/pods
-
GET
: Pod のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
-
/api/v1/namespaces/{namespace}/pods
-
DELETE
: Pod のコレクションを削除します。 -
GET
: Pod 種類のオブジェクトをリスト表示または監視するロール -
POST
: Pod を作成する
-
/api/v1/watch/namespaces/{namespace}/pods
-
GET
: Pod のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
-
/api/v1/namespaces/{namespace}/pods/{name}
-
DELETE
: Pod を削除する -
GET
: 指定された Pod を読み取ります。 -
PATCH
: 指定された Pod を部分的に更新します。 -
PUT
: 指定された Pod を置き換えます。
-
/api/v1/namespaces/{namespace}/pods/{name}/log
-
GET
: 指定された Pod のログを読み取る
-
/api/v1/watch/namespaces/{namespace}/pods/{name}
-
GET
: Pod 種類のオブジェクトへの変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用し、'fieldSelector' パラメーターで単一の項目にフィルター処理します。
-
/api/v1/namespaces/{namespace}/pods/{name}/status
-
GET
: 指定された Pod のステータスを読み取ります。 -
PATCH
: 指定された Pod のステータスを部分的に更新します。 -
PUT
: 指定された Pod のステータスを置き換えます。
-
/api/v1/namespaces/{namespace}/pods/{name}/ephemeralcontainers
-
GET
: 指定された Pod の一時コンテナーを読み取ります。 -
PATCH
: 指定された Pod の ephemeralcontainer を部分的に更新します。 -
PUT
: 指定された Pod の一時コンテナーを置き換えます。
-
14.2.1. /api/v1/pods リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- Pod 種類のオブジェクトをリスト表示または監視するロール
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
14.2.2. /api/v1/watch/pods リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- Pod のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
14.2.3. /api/v1/namespaces/{namespace}/pods リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
DELETE
- 説明
- Pod のコレクションを削除する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
GET
- 説明
- Pod 種類のオブジェクトをリスト表示または監視するロール
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
POST
- 説明
- Pod を作成する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
14.2.4. /api/v1/watch/namespaces/{namespace}/pods リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- Pod のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
14.2.5. /api/v1/namespaces/{namespace}/pods/{name} リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| Pod の名前 |
- HTTP メソッド
-
DELETE
- 説明
- Pod を削除する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
202 - Accepted |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
GET
- 説明
- 指定された Pod を読み取る
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PATCH
- 説明
- 指定された Pod を部分的に更新する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PUT
- 説明
- 指定された Pod を置き換える
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
14.2.6. /api/v1/namespaces/{namespace}/pods/{name}/log リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| Pod の名前 |
- HTTP メソッド
-
GET
- 説明
- 指定された Pod のログを読み取る
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
14.2.7. /api/v1/watch/namespaces/{namespace}/pods/{name} リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| Pod の名前 |
- HTTP メソッド
-
GET
- 説明
- Pod 種類のオブジェクトへの変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用し、'fieldSelector' パラメーターで単一の項目にフィルター処理します。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
14.2.8. /api/v1/namespaces/{namespace}/pods/{name}/status リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| Pod の名前 |
- HTTP メソッド
-
GET
- 説明
- 指定された Pod のステータスを読み取る
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PATCH
- 説明
- 指定された Pod のステータスを部分的に更新する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PUT
- 説明
- 指定された Pod のステータスを置き換える
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
14.2.9. /api/v1/namespaces/{namespace}/pods/{name}/ephemeralcontainers リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| Pod の名前 |
- HTTP メソッド
-
GET
- 説明
- 指定された Pod の一時コンテナーを読み取ります。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PATCH
- 説明
- 指定された Pod の一時コンテナーを部分的に更新します。
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PUT
- 説明
- 指定された Pod の一時コンテナーを置き換えます。
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
第15章 ReplicationController [v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ReplicationController は、レプリケーションコントローラーの設定を表します。
- 型
-
object
15.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 を参照してください。 |
| ReplicationController のラベルが空の場合、デフォルトでは、レプリケーションコントローラーが管理する Pod と同じになります。標準オブジェクトのメタデータ。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。 | |
|
| ReplicationControllerSpec は、レプリケーションコントローラーの仕様です。 |
|
| ReplicationControllerStatus は、レプリケーションコントローラーの現在のステータスを表します。 |
15.1.1. .spec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ReplicationControllerSpec は、レプリケーションコントローラーの仕様です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 新しく作成された Pod が使用可能であると見なされるために、コンテナーがクラッシュすることなく準備ができる最小秒数。デフォルトは 0 です (Pod は準備ができ次第利用可能と見なされます) |
|
| レプリカは、必要なレプリカの数です。これは、明示的なゼロと指定されていないものを区別するためのポインターです。デフォルトは 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller#what-is-a-replicationcontroller |
|
| Selector は、Replicas 数と一致する必要がある Pod に対するラベルクエリーです。Selector が空の場合は、デフォルトで Pod テンプレートに存在するラベルになります。空のときに、Pod テンプレートのラベルにデフォルトで設定されている場合は、このレプリケーションコントローラーにより制御されるために一致する必要があるラベルキーと値。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors |
|
| PodTemplateSpec は、テンプレートから作成する際に Pod が要求するデータを記述します。 |
15.1.2. .spec.template リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodTemplateSpec は、テンプレートから作成する際に Pod が要求するデータを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
| 標準オブジェクトのメタデータ。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。 | |
|
| PodSpec は Pod の説明です。 |
15.1.3. .spec.template.spec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodSpec は Pod の説明です。
- 型
-
object
- 必須
-
containers
-
プロパティー | 型 | 説明 |
---|---|---|
|
| システムがアクティブに失敗のマークを付けて関連するコンテナーを強制終了する前に、StartTime を基準にして Pod がノード上でアクティブになる可能性がある秒単位のオプションの期間。その値は正の整数でなければなりません。 |
|
| アフィニティーは、アフィニティースケジューリングルールのグループです。 |
|
| AutomountServiceAccountToken は、サービスアカウントトークンを自動的にマウントする必要があるかどうかを示します。 |
|
| Pod に属するコンテナーのリスト。現在、コンテナーを追加または削除することはできません。Pod には少なくとも 1 つのコンテナーが必要です。これを更新することはできません。 |
|
| Pod 内で実行する単一のアプリケーションコンテナー。 |
|
| PodDNSConfig は、DNSPolicy から生成されたパラメーターに加えて、Pod の DNS パラメーターを定義します。 |
|
| Pod の DNS ポリシーを設定します。デフォルトは "ClusterFirst" です。有効な値は、'ClusterFirstWithHostNet'、'ClusterFirst'、'Default'、または 'None' です。DNSConfig で指定された DNS パラメーターは、DNSPolicy で選択されたポリシーとマージされます。hostNetwork とともに DNS オプションを設定するには、DNS ポリシーを 'ClusterFirstWithHostNet' に明示的に指定する必要があります。
使用可能な列挙値: - |
|
| EnableServiceLinks は、Docker リンクの構文と一致して、サービスに関する情報を Pod の環境変数に挿入する必要があるかどうかを示します。オプション: デフォルトは true です。 |
|
| この Pod で実行されるエフェメラルコンテナーのリスト。エフェメラルコンテナーを既存の Pod で実行して、デバッグなどのユーザーが開始するアクションを実行できます。このリストは、Pod の作成時に指定することはできません。また、Pod の仕様を更新して変更することもできません。エフェメラルコンテナーを既存の Pod に追加するには、Pod のエフェメラルコンテナーサブリソースを使用します。 |
|
| EphemeralContainer は、デバッグなど、ユーザーが開始したアクティビティーに対して、既存の Pod に追加できる一時コンテナーです。エフェメラルコンテナーにはリソースやスケジュールの保証がなく、コンテナーの終了時、または Pod の削除または再起動時に再起動されません。エフェメラルコンテナーが原因で Pod がリソース割り当てを超過した場合、kubelet は Pod をエビクトする可能性があります。 エフェメラルコンテナーを追加するには、既存の Pod の ephemeralcontainers サブリソースを使用します。エフェメラルコンテナーは削除または再起動できません。 |
|
| HostAliases は、指定された場合に Pod の hosts ファイルに注入されるホストおよび IP のオプションのリストです。これは、hostNetwork 以外の Pod にのみ有効です。 |
|
| HostAlias は、Pod の hosts ファイルのエントリーとして挿入される IP とホスト名の間のマッピングを保持します。 |
|
| ホストの ipc 名前空間を使用します。オプション: デフォルトは false です。 |
|
| この Pod に要求されたホストネットワーク。ホストのネットワーク名前空間を使用します。このオプションを設定する場合は、使用するポートを指定する必要があります。デフォルトは false です。 |
|
| ホストの pid 名前空間を使用します。オプション: デフォルトは false です。 |
|
| ホストのユーザー namespace を使用します。任意: デフォルトは true です。true に設定するか存在しない場合、Pod はホストユーザーの namespace で実行されます。これは、CAP_SYS_MODULE を使用したカーネルモジュールのロードなど、ホストユーザー namespace でのみ利用できる機能が Pod に必要な場合に役立ちます。false に設定すると、Pod 用に新しい userns が作成されます。false に設定すると、コンテナーブレークアウトの脆弱性を軽減するのに役立ち、ユーザーがホスト上で実際に root 権限を持たずにコンテナーを root として実行できるようになります。このフィールドはアルファレベルであり、UserNamespacesSupport 機能を有効にするサーバーでのみ認識されます。 |
|
| Pod のホスト名を指定します指定しない場合、Pod のホスト名はシステム定義の値に設定されます。 |
|
| ImagePullSecrets は、この PodSpec で使用されるイメージをプルするために使用する、同じ名前空間内のシークレットへの参照のオプションのリストです。指定されている場合、これらのシークレットは、使用するために個々のプラー実装に渡されます。詳細: https://kubernetes.io/docs/concepts/containers/images#specifying-imagepullsecrets-on-a-pod |
|
| LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。 |
|
| Pod に属する初期化コンテナーのリスト。コンテナーが開始される前に、初期化コンテナーが順番に実行されます。init コンテナーに障害が発生した場合、Pod は障害が発生したと見なされ、restartPolicy に従って処理されます。init コンテナーまたは通常のコンテナーの名前は、すべてのコンテナー間で一意である必要があります。Init コンテナーには、ライフサイクルアクション、準備プローブ、ライブネスプローブ、またはスタートアッププローブがない場合があります。init コンテナーの resourceRequirements は、各リソースタイプの最大の要求/制限を見つけ、その値の最大値または通常のコンテナーの合計を使用することにより、スケジューリング中に考慮されます。同様の方法で、init コンテナーに制限が適用されます。現在、初期化コンテナーを追加または削除することはできません。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/ |
|
| Pod 内で実行する単一のアプリケーションコンテナー。 |
|
| NodeName は、この Pod を特定のノードにスケジュールするためのリクエストです。空でない場合、スケジューラーは、リソース要件に適合していると想定して、この Pod をそのノードにスケジュールするだけです。 |
|
| NodeSelector は、Pod がノードに収まるようにするために true である必要があるセレクターです。そのノードでスケジュールされる Pod のノードのラベルと一致する必要があるセレクター。詳細: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/ |
|
| PodOS は、Pod の OS パラメーターを定義します。 |
| オーバーヘッドは、特定の RuntimeClass の Pod の実行に関連するリソースオーバーヘッドを表します。このフィールドは、RuntimeClass アドミッションコントローラーによってアドミッション時に自動入力されます。RuntimeClass アドミッションコントローラーが有効になっている場合は、Pod 作成要求でオーバーヘッドを設定しないでください。RuntimeClass アドミッションコントローラーは、オーバーヘッドがすでに設定されている Pod 作成要求を拒否します。RuntimeClass が PodSpec で設定および選択されている場合、オーバーヘッドは対応する RuntimeClass で定義されている値に設定されます。それ以外の場合は、未設定のままでゼロとして扱われます。詳細は、https://git.k8s.io/enhancements/keps/sig-node/688-pod-overhead/README.md を参照してください。 | |
|
| PreemptionPolicy は、優先度の低い Pod をプリエンプトするためのポリシーです。Never、PreemptLowerPriority の 1 つ。設定されていない場合、デフォルトは PreemptLowerPriority です。
使用可能な列挙値: - |
|
| 優先度の値。さまざまなシステムコンポーネントがこのフィールドを使用して、Pod の優先度を検索します。Priority Admission Controller が有効になっている場合、ユーザーはこのフィールドを設定できません。アドミッションコントローラーは、PriorityClassName からこのフィールドに入力します。値が高いと優先順位が高くなります。 |
|
| 指定されている場合、Pod の優先度を示します。"system-node-critical" と "system-cluster-critical" は、最も高い優先度を示す 2 つの特別なキーワードであり、前者が最も高い優先度です。その他の名前は、その名前で PriorityClass オブジェクトを作成して定義する必要があります。指定しない場合、Pod の優先度はデフォルトになり、デフォルトがない場合はゼロになります。 |
|
| 指定した場合、すべての準備ゲートが Pod の準備状況に対して評価されます。すべてのコンテナーの準備が整い、準備ゲートで指定されたすべての条件のステータスが "True" になると、Pod の準備が整います。詳細: https://git.k8s.io/enhancements/keps/sig-network/580-pod-readiness-gates |
|
| PodReadinessGate には、Pod 条件への参照が含まれています |
|
| ResourceClaims は、Pod の起動を許可する前にどの ResourceClaim を割り当てて予約する必要があるかを定義します。リソースは、名前ベースでリソースを使用するコンテナーに提供されます。 これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。 このフィールドは不変です。 |
|
| PodResourceClaim は、ClaimSource を介して 1 つの ResourceClaim のみを参照します。Pod 内の ResourceClaim を一意に識別する名前を追加します。ResourceClaim へのアクセスが必要なコンテナーは、この名前で参照します。 |
|
| Pod 内のすべてのコンテナーのポリシーを再起動します。Always、OnFailure、Never のいずれか。コンテキストによっては、これらの値のサブセットのみが使用できます。デフォルトは Always です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#restart-policy
使用可能な列挙値: - |
|
| RuntimeClassName は、node.k8s.io グループ内の RuntimeClass オブジェクトを参照します。このオブジェクトは、この Pod を実行するために使用する必要があります。指定されたクラスに一致する RuntimeClass リソースがない場合、Pod は実行されません。設定されていないか空の場合は、"レガシー" の RuntimeClass が使用されます。これは、デフォルトのランタイムハンドラーを使用する空の定義を持つ暗黙のクラスです。詳細は、https://git.k8s.io/enhancements/keps/sig-node/585-runtime-class を参照してください。 |
|
| 指定した場合、Pod は指定したスケジューラーによってディスパッチされます。指定しない場合、Pod はデフォルトのスケジューラーによってディスパッチされます。 |
|
| SchedulingGates は、指定されている場合に Pod のスケジューリングをブロックする不透明な値のリストです。schedulingGates が空でない場合、Pod は SchedulingGated 状態のままになり、スケジューラーは Pod のスケジュールを試行しません。 SchedulingGates を設定できるのは Pod の作成時にのみで、それ以降は削除されます。 これは、PodSchedulingReadiness フィーチャーゲートによって有効になるベータ機能です。 |
|
| PodSchedulingGate は Pod に割り当てられ、そのスケジューリングを保護します。 |
|
| PodSecurityContext は、Pod レベルのセキュリティー属性と一般的なコンテナー設定を保持します。一部のフィールドは container.securityContext にも存在します。container.securityContext のフィールド値は、PodSecurityContext のフィールド値よりも優先されます。 |
|
| DeprecatedServiceAccount は、ServiceAccountName の減価償却されたエイリアスです。非推奨: 代わりに serviceAccountName を使用してください。 |
|
| ServiceAccountName は、この Pod の実行に使用する ServiceAccount の名前です。詳細: https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/ |
|
| true の場合、Pod のホスト名は、リーフ名 (デフォルト) ではなく、Pod の FQDN として設定されます。Linux コンテナーでは、これはカーネルのホスト名フィールド (struct utsname のノード名フィールド) に FQDN を設定することを意味します。Windows コンテナーでは、これはレジストリーキー HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters のホスト名のレジストリー値を FQDN に設定することを意味します。Pod に FQDN がない場合、これは効果がありません。デフォルトは false です。 |
|
| Pod 内のすべてのコンテナー間で単一のプロセス名前空間を共有します。これが設定されると、コンテナーは同じ Pod 内の他のコンテナーからのプロセスを表示および通知できるようになり、各コンテナーの最初のプロセスには PID1 が割り当てられません。HostPID と ShareProcessNamespace の両方を設定することはできません。オプション: デフォルトは false です。 |
|
| 指定した場合、完全修飾 Pod のホスト名は "<hostname>.<subdomain>.<pod namespace>.svc.<cluster domain>" になります。指定しない場合、Pod にはドメイン名がまったくありません。 |
|
| Pod が正常に終了する必要がある秒単位のオプションの期間。削除リクエストで減少する可能性があります。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。この値が nil の場合、代わりにデフォルトの猶予期間が使用されます。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。デフォルトは 30 秒です。 |
|
| 指定されている場合、Pod の許容範囲。 |
|
| この toleration が割り当てられる Pod は、マッチング Operator <operator> を使用してトリプル <key,value,effect> と一致する taint を許容します。 |
|
| TopologySpreadConstraints は、Pod のグループがトポロジードメイン全体にどのように分散するべきかを説明します。スケジューラーは、制約に従う方法で Pod をスケジュールします。すべての topologySpreadConstraints は AND 演算されます。 |
|
| topologySpreadConstraint は、指定されたトポロジー間で一致する Pod を分散する方法を指定します。 |
|
| Pod に属するコンテナーによってマウントできるボリュームのリスト。詳細: https://kubernetes.io/docs/concepts/storage/volumes |
|
| ボリュームは、Pod 内の任意のコンテナーからアクセスできる Pod 内の名前付きボリュームを表します。 |
15.1.4. .spec.template.spec.affinity リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- アフィニティーは、アフィニティースケジューリングルールのグループです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ノードアフィニティーは、ノードアフィニティースケジューリングルールのグループです。 |
|
| Pod アフィニティーは、Pod 間アフィニティースケジューリングルールのグループです。 |
|
| Pod アンチアフィニティーは、Pod 間アンチアフィニティースケジューリングルールのグループです。 |
15.1.5. .spec.template.spec.affinity.nodeAffinity リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ノードアフィニティーは、ノードアフィニティースケジューリングルールのグループです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| スケジューラーは、このフィールドで指定されたアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アフィニティー式など) を満たすノードごとに、このフィールドの要素を反復処理して合計を計算します。ノードが対応する matchExpressions と一致する場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。 |
|
| 空の優先スケジューリング用語は、暗黙の重み 0 を持つすべてのオブジェクトに一致します (つまり、操作なしです)。null の優先スケジューリング用語は、オブジェクトに一致しません (つまり、no-op でもあります)。 |
|
| ノードセレクターは、ノードのセットに対する 1 つ以上のラベルクエリーの結果の和集合を表します。つまり、ノードセレクター用語で表されるセレクターの OR を表します。 |
15.1.6. .spec.template.spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- スケジューラーは、このフィールドで指定されたアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アフィニティー式など) を満たすノードごとに、このフィールドの要素を反復処理して合計を計算します。ノードが対応する matchExpressions と一致する場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。
- 型
-
array
15.1.7. .spec.template.spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 空の優先スケジューリング用語は、暗黙の重み 0 を持つすべてのオブジェクトに一致します (つまり、操作なしです)。null の優先スケジューリング用語は、オブジェクトに一致しません (つまり、no-op でもあります)。
- 型
-
object
- 必須
-
weight
-
preference
-
プロパティー | 型 | 説明 |
---|---|---|
|
| null または空のノードセレクター用語はオブジェクトに一致しません。これらの要件は AND で結合されます。TopologySelectorTerm タイプは、NodeSelectorTerm のサブセットを実装します。 |
|
| 対応する nodeSelectorTerm の一致に関連する重み (1〜100 の範囲)。 |
15.1.8. .spec.template.spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- null または空のノードセレクター用語はオブジェクトに一致しません。これらの要件は AND で結合されます。TopologySelectorTerm タイプは、NodeSelectorTerm のサブセットを実装します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ノードのラベルごとのノードセレクター要件のリスト。 |
|
| ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| ノードのフィールドごとのノードセレクター要件のリスト。 |
|
| ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
- 説明
- ノードのラベルごとのノードセレクター要件のリスト。
- 型
-
array
- 説明
- ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| セレクターが適用されるラベルキー。 |
|
| キーと値のセットの関係を表します。有効な Operator は、In、NotIn、Exists、DoesNotExist です。Gt、および Lt。
使用可能な列挙値: - |
|
| 文字列値の配列。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。Operator が Gt または Lt の場合、values 配列には、整数として解釈される単一の要素が必要です。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
- 説明
- ノードのフィールドごとのノードセレクター要件のリスト。
- 型
-
array
- 説明
- ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| セレクターが適用されるラベルキー。 |
|
| キーと値のセットの関係を表します。有効な Operator は、In、NotIn、Exists、DoesNotExist です。Gt、および Lt。
使用可能な列挙値: - |
|
| 文字列値の配列。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。Operator が Gt または Lt の場合、values 配列には、整数として解釈される単一の要素が必要です。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
15.1.13. .spec.template.spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ノードセレクターは、ノードのセットに対する 1 つ以上のラベルクエリーの結果の和集合を表します。つまり、ノードセレクター用語で表されるセレクターの OR を表します。
- 型
-
object
- 必須
-
nodeSelectorTerms
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 必須。ノードセレクター用語のリスト。用語は OR されています。 |
|
| null または空のノードセレクター用語はオブジェクトに一致しません。これらの要件は AND で結合されます。TopologySelectorTerm タイプは、NodeSelectorTerm のサブセットを実装します。 |
- 説明
- 必須。ノードセレクター用語のリスト。用語は OR されています。
- 型
-
array
- 説明
- null または空のノードセレクター用語はオブジェクトに一致しません。これらの要件は AND で結合されます。TopologySelectorTerm タイプは、NodeSelectorTerm のサブセットを実装します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ノードのラベルごとのノードセレクター要件のリスト。 |
|
| ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| ノードのフィールドごとのノードセレクター要件のリスト。 |
|
| ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
- 説明
- ノードのラベルごとのノードセレクター要件のリスト。
- 型
-
array
- 説明
- ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| セレクターが適用されるラベルキー。 |
|
| キーと値のセットの関係を表します。有効な Operator は、In、NotIn、Exists、DoesNotExist です。Gt、および Lt。
使用可能な列挙値: - |
|
| 文字列値の配列。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。Operator が Gt または Lt の場合、values 配列には、整数として解釈される単一の要素が必要です。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
- 説明
- ノードのフィールドごとのノードセレクター要件のリスト。
- 型
-
array
- 説明
- ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| セレクターが適用されるラベルキー。 |
|
| キーと値のセットの関係を表します。有効な Operator は、In、NotIn、Exists、DoesNotExist です。Gt、および Lt。
使用可能な列挙値: - |
|
| 文字列値の配列。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。Operator が Gt または Lt の場合、values 配列には、整数として解釈される単一の要素が必要です。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
15.1.20. .spec.template.spec.affinity.podAffinity リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod アフィニティーは、Pod 間アフィニティースケジューリングルールのグループです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| スケジューラーは、このフィールドで指定されたアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アフィニティー式など) を満たすノードごとに、このフィールドの要素を反復処理して合計を計算します。ノードに対応する podAffinityTerm に一致する Pod がある場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。 |
|
| 一致したすべての WeightedPodAffinityTerm フィールドの重みがノードごとに追加され、最も優先されるノードが検索されます。 |
|
| このフィールドで指定されたアフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定されたアフィニティー要件が Pod 実行中のある時点で満たされない場合 (Pod ラベルの更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。複数の要素がある場合、各 podAffinityTerm に対応するノードのリストが交差します。つまり、すべての用語が満たされる必要があります。 |
|
| この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。この場合の同じ場所とは、キー <topologyKey> のラベルの値が、一連の Pod の Pod が実行されているノードの値と一致するノードで実行されていることを意味します。 |
15.1.21. .spec.template.spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- スケジューラーは、このフィールドで指定されたアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アフィニティー式など) を満たすノードごとに、このフィールドの要素を反復処理して合計を計算します。ノードに対応する podAffinityTerm に一致する Pod がある場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。
- 型
-
array
15.1.22. .spec.template.spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 一致したすべての WeightedPodAffinityTerm フィールドの重みがノードごとに追加され、最も優先されるノードが検索されます。
- 型
-
object
- 必須
-
weight
-
podAffinityTerm
-
プロパティー | 型 | 説明 |
---|---|---|
|
| この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。この場合の同じ場所とは、キー <topologyKey> のラベルの値が、一連の Pod の Pod が実行されているノードの値と一致するノードで実行されていることを意味します。 |
|
| 対応する podAffinityTerm の一致に関連する重み (1〜100 の範囲)。 |
- 説明
- この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。この場合の同じ場所とは、キー <topologyKey> のラベルの値が、一連の Pod の Pod が実行されているノードの値と一致するノードで実行されていることを意味します。
- 型
-
object
- 必須
-
topologyKey
-
プロパティー | 型 | 説明 |
---|---|---|
| リソースのセット (この場合は Pod) に対するラベルクエリー。 | |
| 用語が適用される namespace のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての namespace に一致します。 | |
|
| namespaces は、用語が適用される namespace 名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび nullnamespaceSelector は、"この Pod の namespace" を意味します |
|
| この Pod は、指定された namespace の labelSelector と一致する Pod と同じ場所 (affinity) または異なる場所 (anti-affinity) に配置します。同じ場所とは、topologyKey キーが含まれるラベルの値が一致し、選択した Pod のいずれかが実行されているノード上で実行されていることを意味します。空の topologyKey は許可されていません。 |
15.1.24. .spec.template.spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- このフィールドで指定されたアフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定されたアフィニティー要件が Pod 実行中のある時点で満たされない場合 (Pod ラベルの更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。複数の要素がある場合、各 podAffinityTerm に対応するノードのリストが交差します。つまり、すべての用語が満たされる必要があります。
- 型
-
array
15.1.25. .spec.template.spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。この場合の同じ場所とは、キー <topologyKey> のラベルの値が、一連の Pod の Pod が実行されているノードの値と一致するノードで実行されていることを意味します。
- 型
-
object
- 必須
-
topologyKey
-
プロパティー | 型 | 説明 |
---|---|---|
| リソースのセット (この場合は Pod) に対するラベルクエリー。 | |
| 用語が適用される namespace のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての namespace に一致します。 | |
|
| namespaces は、用語が適用される namespace 名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび nullnamespaceSelector は、"この Pod の namespace" を意味します |
|
| この Pod は、指定された namespace の labelSelector と一致する Pod と同じ場所 (affinity) または異なる場所 (anti-affinity) に配置します。同じ場所とは、topologyKey キーが含まれるラベルの値が一致し、選択した Pod のいずれかが実行されているノード上で実行されていることを意味します。空の topologyKey は許可されていません。 |
15.1.26. .spec.template.spec.affinity.podAntiAffinity リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod アンチアフィニティーは、Pod 間アンチアフィニティースケジューリングルールのグループです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| スケジューラーは、このフィールドで指定された非アフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アンチアフィニティー式など) を満たすノードごとに、の要素を反復処理して合計を計算します。このフィールドと、対応する podAffinityTerm に一致する Pod がノードにある場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。 |
|
| 一致したすべての WeightedPodAffinityTerm フィールドの重みがノードごとに追加され、最も優先されるノードが検索されます。 |
|
| このフィールドで指定された非アフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定された非アフィニティー要件が Pod 実行中のある時点で満たされない場合 (Pod ラベルの更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。複数の要素がある場合、各 podAffinityTerm に対応するノードのリストが交差します。つまり、すべての用語が満たされる必要があります。 |
|
| この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。この場合の同じ場所とは、キー <topologyKey> のラベルの値が、一連の Pod の Pod が実行されているノードの値と一致するノードで実行されていることを意味します。 |
15.1.27. .spec.template.spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- スケジューラーは、このフィールドで指定された非アフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アンチアフィニティー式など) を満たすノードごとに、の要素を反復処理して合計を計算します。このフィールドと、対応する podAffinityTerm に一致する Pod がノードにある場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。
- 型
-
array
15.1.28. .spec.template.spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 一致したすべての WeightedPodAffinityTerm フィールドの重みがノードごとに追加され、最も優先されるノードが検索されます。
- 型
-
object
- 必須
-
weight
-
podAffinityTerm
-
プロパティー | 型 | 説明 |
---|---|---|
|
| この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。この場合の同じ場所とは、キー <topologyKey> のラベルの値が、一連の Pod の Pod が実行されているノードの値と一致するノードで実行されていることを意味します。 |
|
| 対応する podAffinityTerm の一致に関連する重み (1〜100 の範囲)。 |
- 説明
- この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。この場合の同じ場所とは、キー <topologyKey> のラベルの値が、一連の Pod の Pod が実行されているノードの値と一致するノードで実行されていることを意味します。
- 型
-
object
- 必須
-
topologyKey
-
プロパティー | 型 | 説明 |
---|---|---|
| リソースのセット (この場合は Pod) に対するラベルクエリー。 | |
| 用語が適用される namespace のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての namespace に一致します。 | |
|
| namespaces は、用語が適用される namespace 名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび nullnamespaceSelector は、"この Pod の namespace" を意味します |
|
| この Pod は、指定された namespace の labelSelector と一致する Pod と同じ場所 (affinity) または異なる場所 (anti-affinity) に配置します。同じ場所とは、topologyKey キーが含まれるラベルの値が一致し、選択した Pod のいずれかが実行されているノード上で実行されていることを意味します。空の topologyKey は許可されていません。 |
15.1.30. .spec.template.spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- このフィールドで指定された非アフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定された非アフィニティー要件が Pod 実行中のある時点で満たされない場合 (Pod ラベルの更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。複数の要素がある場合、各 podAffinityTerm に対応するノードのリストが交差します。つまり、すべての用語が満たされる必要があります。
- 型
-
array
15.1.31. .spec.template.spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。この場合の同じ場所とは、キー <topologyKey> のラベルの値が、一連の Pod の Pod が実行されているノードの値と一致するノードで実行されていることを意味します。
- 型
-
object
- 必須
-
topologyKey
-
プロパティー | 型 | 説明 |
---|---|---|
| リソースのセット (この場合は Pod) に対するラベルクエリー。 | |
| 用語が適用される namespace のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての namespace に一致します。 | |
|
| namespaces は、用語が適用される namespace 名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび nullnamespaceSelector は、"この Pod の namespace" を意味します |
|
| この Pod は、指定された namespace の labelSelector と一致する Pod と同じ場所 (affinity) または異なる場所 (anti-affinity) に配置します。同じ場所とは、topologyKey キーが含まれるラベルの値が一致し、選択した Pod のいずれかが実行されているノード上で実行されていることを意味します。空の topologyKey は許可されていません。 |
15.1.32. .spec.template.spec.containers リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod に属するコンテナーのリスト。現在、コンテナーを追加または削除することはできません。Pod には少なくとも 1 つのコンテナーが必要です。これを更新することはできません。
- 型
-
array
15.1.33. .spec.template.spec.containers[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod 内で実行する単一のアプリケーションコンテナー。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| エントリーポイントへの引数。これが指定されていない場合は、コンテナーイメージの CMD が使用されます。変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、"(VAR_NAME)" は文字列リテラル "$(VAR_NAME)" を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。これを更新することはできません。詳細: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell |
|
| エントリーポイント配列。シェル内では実行されません。これが指定されていない場合は、コンテナーイメージの ENTRYPOINT が使用されます。変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、"(VAR_NAME)" は文字列リテラル "$(VAR_NAME)" を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。これを更新することはできません。詳細: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell |
|
| コンテナーに設定する環境変数のリスト。これを更新することはできません。 |
|
| EnvVar は、コンテナーに存在する環境変数を表します。 |
|
| コンテナー内の環境変数に入力するソースのリスト。ソース内で定義されたキーは C_IDENTIFIER である必要があります。無効なキーはすべて、コンテナーの起動時にイベントとして報告されます。キーが複数のソースに存在する場合、最後のソースに関連付けられた値が優先されます。重複キーを持つ環境によって定義された値が優先されます。これを更新することはできません。 |
|
| EnvFromSource は、一連の ConfigMap のソースを表します |
|
| コンテナーイメージ名詳細: https://kubernetes.io/docs/concepts/containers/images このフィールドはオプションであり、高レベルの設定管理で、Deployments や StatefulSets などのワークロードコントローラーのコンテナーイメージをデフォルトまたはオーバーライドできます。 |
|
| イメージプルポリシーAlways、Never、IfNotPresent のいずれか。デフォルトは、:latest タグが指定されている場合は常に、それ以外の場合は IfNotPresent です。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/containers/images#updating-images
使用可能な列挙値: - |
|
| ライフサイクルは、コンテナーのライフサイクルイベントに対応して管理システムが実行する必要のあるアクションを表します。PostStart および PreStop ライフサイクルハンドラーの場合、コンテナープロセスが失敗しない限り、アクションが完了するまでコンテナー管理がブロックされます。失敗した場合、ハンドラーは中止されます。 |
|
| プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。 |
|
| DNS_LABEL として指定されたコンテナーの名前。Pod 内の各コンテナーには、一意の名前 (DNS_LABEL) が必要です。これを更新することはできません。 |
|
| コンテナーから公開するポートのリスト。ここでポートを指定しなくても、そのポートが公開されるのを防ぐことはできません。コンテナー内のデフォルトの "0.0.0.0" アドレスをリッスンしているポートは、ネットワークからアクセスできます。戦略的マージパッチを使用してこの配列を変更すると、データが破損する可能性があります。詳細は、https://github.com/kubernetes/kubernetes/issues/108255 を参照してください。これを更新することはできません。 |
|
| ContainerPort は、単一のコンテナー内のネットワークポートを表します。 |
|
| プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。 |
|
| コンテナーのリソースサイズ変更ポリシー。 |
|
| ContainerResizePolicy は、コンテナーのリソースサイズ変更ポリシーを表します。 |
|
| ResourceRequirements は、コンピュートリソースの要件を説明します。 |
|
| RestartPolicy は、Pod 内の個々のコンテナーの再起動動作を定義します。このフィールドは init コンテナーに対してのみ設定でき、許可される値は "Always" のみです。init 以外のコンテナーの場合、またはこのフィールドが指定されていない場合、再起動の動作は Pod の再起動ポリシーとコンテナータイプによって定義されます。init コンテナーの RestartPolicy を "Always" に設定すると、次の効果が得られます: この init コンテナーは、すべての通常のコンテナーが終了するまで、終了時に継続的に再起動されます。すべての通常のコンテナーが完了すると、restartPolicy が "Always" のすべての init コンテナーがシャットダウンされます。このライフサイクルは通常の init コンテナーとは異なり、多くの場合、"sidecar" コンテナーと呼ばれます。この init コンテナーは、引き続き init コンテナーシーケンス内で開始されますが、次の init コンテナーに進む前にコンテナーが完了するのを待機しません。代わりに、この init コンテナーが起動した直後、または任意の startupProbe が正常に完了した後に、次の init コンテナーが起動します。 |
|
| SecurityContext は、コンテナーに適用されるセキュリティー設定を保持します。一部のフィールドは、SecurityContext と PodSecurityContext の両方に存在します。両方が設定されている場合は、SecurityContext の値が優先されます。 |
|
| プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。 |
|
| このコンテナーがコンテナーランタイムで stdin にバッファーを割り当てる必要があるかどうか。これが設定されていない場合、コンテナー内の stdin からの読み取りは常に EOF になります。デフォルトは false です。 |
|
| コンテナーランタイムが、単一の接続によって開かれた後に stdin チャネルを閉じる必要があるかどうか。stdin が true の場合、stdin ストリームは複数の接続セッションにわたって開いたままになります。stdinOnce が true に設定されている場合、stdin はコンテナーの起動時に開かれ、最初のクライアントが stdin に接続するまで空になり、クライアントが切断されるまで開いたままでデータを受け入れます。切断されると、stdin は閉じられ、コンテナーが再起動されるまで閉じられたままになります。。このフラグが false の場合、stdin から読み取るコンテナープロセスは EOF を受信しません。デフォルトは false です。 |
|
| オプション: コンテナーの終了メッセージが書き込まれるファイルがコンテナーのファイルシステムにマウントされるパス。書き込まれるメッセージは、アサーション失敗メッセージなどの簡単な最終ステータスを目的としています。4096 バイトを超える場合、ノードによって切り捨てられます。すべてのコンテナーの合計メッセージ長は 12kb に制限されます。デフォルトは/dev/termination-log です。これを更新することはできません。 |
|
| 終了メッセージの入力方法を示します。ファイルは、terminationMessagePath の内容を使用して、成功と失敗の両方でコンテナーステータスメッセージを入力します。終了メッセージファイルが空で、コンテナーがエラーで終了した場合、FallbackToLogsOnError はコンテナーログ出力の最後のチャンクを使用します。ログ出力は、2048 バイトまたは 80 行のいずれか小さい方に制限されます。デフォルトは File です。これを更新することはできません。
使用可能な列挙値: - |
|
| このコンテナーがそれ自体に TTY を割り当てる必要があるかどうかには、'stdin' が true である必要もあります。デフォルトは false です。 |
|
| volumeDevices は、コンテナーによって使用されるブロックデバイスのリストです。 |
|
| volumeDevice は、コンテナー内の raw ブロックデバイスのマッピングを記述します。 |
|
| コンテナーのファイルシステムにマウントする Pod ボリューム。これを更新することはできません。 |
|
| VolumeMount は、コンテナー内でのボリュームのマウントを説明します。 |
|
| コンテナーの作業ディレクトリー。指定しない場合、コンテナーランタイムのデフォルトが使用されます。これは、コンテナーイメージで設定されている可能性があります。これを更新することはできません。 |
15.1.34. .spec.template.spec.containers[].env リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナーに設定する環境変数のリスト。これを更新することはできません。
- 型
-
array
15.1.35. .spec.template.spec.containers[].env[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- EnvVar は、コンテナーに存在する環境変数を表します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 環境変数の名前。C_IDENTIFIER でなければなりません。 |
|
| 変数参照 $(VAR_NAME) は、コンテナー内で以前に定義された環境変数と任意のサービス環境変数を使用してデプロイメントされます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、"(VAR_NAME)" は文字列リテラル "$(VAR_NAME)" を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。デフォルトは "" です。 |
|
| EnvVarSource は、EnvVar の値のソースを表します。 |
15.1.36. .spec.template.spec.containers[].env[].valueFrom リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- EnvVarSource は、EnvVar の値のソースを表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ConfigMap からキーを選択します。 |
|
| ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。 |
|
| ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。 |
|
| SecretKeySelector は、シークレットのキーを選択します。 |
15.1.37. .spec.template.spec.containers[].env[].valueFrom.configMapKeyRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ConfigMap からキーを選択します。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
15.1.38. .spec.template.spec.containers[].env[].valueFrom.fieldRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。
- 型
-
object
- 必須
-
fieldPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| FieldPath が記述されているスキーマのバージョン。デフォルトは "v1" です。 |
|
| 指定された API バージョンで選択するフィールドのパス。 |
15.1.39. .spec.template.spec.containers[].env[].valueFrom.resourceFieldRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。
- 型
-
object
- 必須
-
resource
-
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナー名: ボリュームには必須、env 変数にはオプション |
| 公開されたリソースの出力形式を指定します。デフォルトは "1" です。 | |
|
| 必須: 選択するリソース |
15.1.40. .spec.template.spec.containers[].env[].valueFrom.secretKeyRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SecretKeySelector は、シークレットのキーを選択します。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
15.1.41. .spec.template.spec.containers[].envFrom リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナー内の環境変数に入力するソースのリスト。ソース内で定義されたキーは C_IDENTIFIER である必要があります。無効なキーはすべて、コンテナーの起動時にイベントとして報告されます。キーが複数のソースに存在する場合、最後のソースに関連付けられた値が優先されます。重複キーを持つ環境によって定義された値が優先されます。これを更新することはできません。
- 型
-
array
15.1.42. .spec.template.spec.containers[].envFrom[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- EnvFromSource は、一連の ConfigMap のソースを表します
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ConfigMapEnvSource は、環境変数に入力する ConfigMap を選択します。 ターゲットの ConfigMap のデータフィールドの内容は、キーと値のペアを環境変数として表します。 |
|
| ConfigMap の各キーの前に追加するオプションの識別子。C_IDENTIFIER でなければなりません。 |
|
| SecretEnvSource は、環境変数に入力するシークレットを選択します。 ターゲットシークレットのデータフィールドの内容は、キーと値のペアを環境変数として表します。 |
15.1.43. .spec.template.spec.containers[].envFrom[].configMapRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
ConfigMapEnvSource は、環境変数に入力する ConfigMap を選択します。
ターゲットの ConfigMap のデータフィールドの内容は、キーと値のペアを環境変数として表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap を定義する必要があるかどうかを指定します |
15.1.44. .spec.template.spec.containers[].envFrom[].secretRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
SecretEnvSource は、環境変数に入力するシークレットを選択します。
ターゲットシークレットのデータフィールドの内容は、キーと値のペアを環境変数として表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットを定義する必要があるかどうかを指定します |
15.1.45. .spec.template.spec.containers[].lifecycle リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ライフサイクルは、コンテナーのライフサイクルイベントに対応して管理システムが実行する必要のあるアクションを表します。PostStart および PreStop ライフサイクルハンドラーの場合、コンテナープロセスが失敗しない限り、アクションが完了するまでコンテナー管理がブロックされます。失敗した場合、ハンドラーは中止されます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。 |
|
| LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。 |
15.1.46. .spec.template.spec.containers[].lifecycle.postStart リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
15.1.47. .spec.template.spec.containers[].lifecycle.postStart.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
15.1.48. .spec.template.spec.containers[].lifecycle.postStart.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
15.1.49. .spec.template.spec.containers[].lifecycle.postStart.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
15.1.50. .spec.template.spec.containers[].lifecycle.postStart.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
15.1.51. .spec.template.spec.containers[].lifecycle.postStart.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
15.1.52. .spec.template.spec.containers[].lifecycle.preStop リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
15.1.53. .spec.template.spec.containers[].lifecycle.preStop.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
15.1.54. .spec.template.spec.containers[].lifecycle.preStop.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
15.1.55. .spec.template.spec.containers[].lifecycle.preStop.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
15.1.56. .spec.template.spec.containers[].lifecycle.preStop.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
15.1.57. .spec.template.spec.containers[].lifecycle.preStop.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
15.1.58. .spec.template.spec.containers[].livenessProbe リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| 正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。 |
|
| GRPC は、GRPC ポートに関連するアクションを指定します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。 |
|
| 失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
|
| プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。 |
|
| プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
15.1.59. .spec.template.spec.containers[].livenessProbe.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
15.1.60. .spec.template.spec.containers[].livenessProbe.grpc リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GRPC は、GRPC ポートに関連するアクションを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| gRPC サービスのポート番号。番号は 1〜65535 の範囲である必要があります。 |
|
| Service は、gRPC HealthCheckRequest に配置するサービスの名前です (https://github.com/grpc/grpc/blob/master/doc/health-checking.md を参照)。 これが指定されていない場合、デフォルトの動作は gRPC によって定義されます。 |
15.1.61. .spec.template.spec.containers[].livenessProbe.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
15.1.62. .spec.template.spec.containers[].livenessProbe.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
15.1.63. .spec.template.spec.containers[].livenessProbe.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
15.1.64. .spec.template.spec.containers[].livenessProbe.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
15.1.65. .spec.template.spec.containers[].ports リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナーから公開するポートのリスト。ここでポートを指定しなくても、そのポートが公開されるのを防ぐことはできません。コンテナー内のデフォルトの "0.0.0.0" アドレスをリッスンしているポートは、ネットワークからアクセスできます。戦略的マージパッチを使用してこの配列を変更すると、データが破損する可能性があります。詳細は、https://github.com/kubernetes/kubernetes/issues/108255 を参照してください。これを更新することはできません。
- 型
-
array
15.1.66. .spec.template.spec.containers[].ports[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerPort は、単一のコンテナー内のネットワークポートを表します。
- 型
-
object
- 必須
-
containerPort
-
プロパティー | 型 | 説明 |
---|---|---|
|
| Pod の IP アドレスで公開するポートの数。これは有効なポート番号である必要があります、0<x<65536。 |
|
| 外部ポートをバインドするホスト IP。 |
|
| ホストで公開するポートの数。指定する場合、これは有効なポート番号、0<x<65536 である必要があります。HostNetwork が指定されている場合、これは ContainerPort と一致する必要があります。ほとんどのコンテナーはこれを必要としません。 |
|
| 指定する場合、これは IANA_SVC_NAME であり、Pod 内で一意である必要があります。Pod 内の名前付きポートにはそれぞれ一意の名前を付ける必要があります。サービスが参照できるポートの名前。 |
|
| ポートのプロトコル。UDP、TCP、または SCTP である必要があります。デフォルトは "TCP" です。
使用可能な列挙値: - |
15.1.67. .spec.template.spec.containers[].readinessProbe リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| 正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。 |
|
| GRPC は、GRPC ポートに関連するアクションを指定します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。 |
|
| 失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
|
| プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。 |
|
| プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
15.1.68. .spec.template.spec.containers[].readinessProbe.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
15.1.69. .spec.template.spec.containers[].readinessProbe.grpc リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GRPC は、GRPC ポートに関連するアクションを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| gRPC サービスのポート番号。番号は 1〜65535 の範囲である必要があります。 |
|
| Service は、gRPC HealthCheckRequest に配置するサービスの名前です (https://github.com/grpc/grpc/blob/master/doc/health-checking.md を参照)。 これが指定されていない場合、デフォルトの動作は gRPC によって定義されます。 |
15.1.70. .spec.template.spec.containers[].readinessProbe.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
15.1.71. .spec.template.spec.containers[].readinessProbe.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
15.1.72. .spec.template.spec.containers[].readinessProbe.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
15.1.73. .spec.template.spec.containers[].readinessProbe.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
15.1.74. .spec.template.spec.containers[].resizePolicy リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナーのリソースサイズ変更ポリシー。
- 型
-
array
15.1.75. .spec.template.spec.containers[].resizePolicy[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerResizePolicy は、コンテナーのリソースサイズ変更ポリシーを表します。
- 型
-
object
- 必須
-
resourceName
-
restartPolicy
-
プロパティー | 型 | 説明 |
---|---|---|
|
| このリソースサイズ変更ポリシーが適用されるリソースの名前。対応している値は、cpu、memory です。 |
|
| 指定されたリソースのサイズが変更されたときに適用する再起動ポリシー。指定しない場合、デフォルトの NotRequired が設定されます。 |
15.1.76. .spec.template.spec.containers[].resources リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceRequirements は、コンピュートリソースの要件を説明します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。 これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。 このフィールドは不変です。これはコンテナーにのみ設定できます。 |
|
| ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。 |
| limits は、許可されるコンピュートリソースの最大量を示します。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 | |
| requests は、必要なコンピュートリソースの最小量を示します。コンテナーで Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
15.1.77. .spec.template.spec.containers[].resources.claims リンクのコピーリンクがクリップボードにコピーされました!
- 説明
Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。
これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。
このフィールドは不変です。これはコンテナーにのみ設定できます。
- 型
-
array
15.1.78. .spec.template.spec.containers[].resources.claims[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。 |
15.1.79. .spec.template.spec.containers[].securityContext リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SecurityContext は、コンテナーに適用されるセキュリティー設定を保持します。一部のフィールドは、SecurityContext と PodSecurityContext の両方に存在します。両方が設定されている場合は、SecurityContext の値が優先されます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| AllowPrivilegeEscalation は、プロセスがその親プロセスよりも多くの特権を取得できるかどうかを制御します。このブール値は、no_new_privs フラグがコンテナープロセスに設定されるかどうかを直接制御します。コンテナーが 1) 特権で実行されており、CAP_SYS_ADMIN が割り当てられている場合、2) AllowPrivilegeEscalation は常に true です。spec.os.name が windows の場合は、このフィールドは設定できないことに注意してください。 |
|
| 実行中のコンテナーに POSIX 機能を追加および削除します。 |
|
| コンテナーを特権モードで実行します。特権コンテナー内のプロセスは、基本的にホスト上の root と同等です。デフォルトは false です。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| procMount は、コンテナーに使用する proc マウントのタイプを示します。デフォルトは DefaultProcMount で、読み取り専用パスとマスクされたパスにコンテナーランタイムのデフォルトを使用します。これには、ProcMountType 機能フラグを有効にする必要があります。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
使用可能な列挙値: - |
|
| このコンテナーに読み取り専用のルートファイルシステムがあるかどうか。デフォルトは false です。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| コンテナープロセスのエントリーポイントを実行するための GID。設定されていない場合は、実行時のデフォルトを使用します。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| コンテナーが root 以外のユーザーとして実行される必要があることを示します。true の場合、Kubelet は実行時にイメージを検証して、イメージが UID 0(ルート) として実行されないことを確認し、実行される場合はコンテナーの開始に失敗します。未設定または false の場合、そのような検証は実行されません。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。 |
|
| コンテナープロセスのエントリーポイントを実行するための UID。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| SELinuxOptions は、コンテナーに適用されるラベルです。 |
|
| SeccompProfile は、Pod/コンテナーの seccomp プロファイル設定を定義します。設定できるプロファイルソースは 1 つだけです。 |
|
| WindowsSecurityContextOptions には、Windows 固有のオプションおよび認証情報が含まれています。 |
15.1.80. .spec.template.spec.containers[].securityContext.capabilities リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 実行中のコンテナーに POSIX 機能を追加および削除します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 追加された機能 |
|
| 削除された機能 |
15.1.81. .spec.template.spec.containers[].securityContext.seLinuxOptions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SELinuxOptions は、コンテナーに適用されるラベルです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Level は、コンテナーに適用される SELinux レベルのラベルです。 |
|
| Role は、コンテナーに適用される SELinux ロールラベルです。 |
|
| Type は、コンテナーに適用される SELinux タイプのラベルです。 |
|
| User は、コンテナーに適用される SELinux ユーザーラベルです。 |
15.1.82. .spec.template.spec.containers[].securityContext.seccompProfile リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SeccompProfile は、Pod/コンテナーの seccomp プロファイル設定を定義します。設定できるプロファイルソースは 1 つだけです。
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| localhostProfile は、ノード上のファイルで定義されたプロファイルを使用する必要があることを示します。プロファイルが機能するには、ノードで事前に設定されている必要があります。kubelet の設定済みの seccomp プロファイルの場所を基準にして、降順のパスである必要があります。タイプが "Localhost" の場合は設定する必要があります。他のタイプには設定しないでください。 |
|
| type は、適用される seccomp プロファイルの種類を示します。有効なオプションは以下のとおりです。 Localhost - ノード上のファイルで定義されたプロファイルを使用する必要があります。RuntimeDefault- コンテナーのランタイムデフォルトプロファイルを使用する必要があります。制限なし - プロファイルを適用しないでください。
使用可能な列挙値: - |
15.1.83. .spec.template.spec.containers[].securityContext.windowsOptions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- WindowsSecurityContextOptions には、Windows 固有のオプションおよび認証情報が含まれています。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| GMSACredentialSpec は、GMSA アドミッション Webhook (https://github.com/kubernetes-sigs/windows-gmsa) が GMSACredentialSpecName フィールドで指定された GMSA クレデンシャル仕様のコンテンツをインライン化する場所です。 |
|
| GMSACredentialSpecName は、使用する GMSA 認証情報仕様の名前です。 |
|
| hostProcess は、コンテナーを 'Host Process' コンテナーとして実行する必要があるかどうかを決定します。Pod のすべてのコンテナーは、同じ有効な HostProcess 値を持っている必要があります (HostProcess コンテナーと非 HostProcess コンテナーを混在させることはできません)。さらに、HostProcess が true の場合、HostNetwork も true に設定する必要があります。 |
|
| コンテナープロセスのエントリーポイントを実行するための Windows の UserName。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。 |
15.1.84. .spec.template.spec.containers[].startupProbe リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| 正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。 |
|
| GRPC は、GRPC ポートに関連するアクションを指定します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。 |
|
| 失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
|
| プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。 |
|
| プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
15.1.85. .spec.template.spec.containers[].startupProbe.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
15.1.86. .spec.template.spec.containers[].startupProbe.grpc リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GRPC は、GRPC ポートに関連するアクションを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| gRPC サービスのポート番号。番号は 1〜65535 の範囲である必要があります。 |
|
| Service は、gRPC HealthCheckRequest に配置するサービスの名前です (https://github.com/grpc/grpc/blob/master/doc/health-checking.md を参照)。 これが指定されていない場合、デフォルトの動作は gRPC によって定義されます。 |
15.1.87. .spec.template.spec.containers[].startupProbe.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
15.1.88. .spec.template.spec.containers[].startupProbe.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
15.1.89. .spec.template.spec.containers[].startupProbe.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
15.1.90. .spec.template.spec.containers[].startupProbe.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
15.1.91. .spec.template.spec.containers[].volumeDevices リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- volumeDevices は、コンテナーによって使用されるブロックデバイスのリストです。
- 型
-
array
15.1.92. .spec.template.spec.containers[].volumeDevices[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- volumeDevice は、コンテナー内の raw ブロックデバイスのマッピングを記述します。
- 型
-
object
- 必須
-
name
-
devicePath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| devicePath は、デバイスがマップされるコンテナー内のパスです。 |
|
| name は、Pod 内の persistentVolumeClaim の名前と一致する必要があります |
15.1.93. .spec.template.spec.containers[].volumeMounts リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナーのファイルシステムにマウントする Pod ボリューム。これを更新することはできません。
- 型
-
array
15.1.94. .spec.template.spec.containers[].volumeMounts[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- VolumeMount は、コンテナー内でのボリュームのマウントを説明します。
- 型
-
object
- 必須
-
name
-
mountPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ボリュームをマウントする必要があるコンテナー内のパス。':' を含めることはできません。 |
|
| mountPropagation は、マウントがホストからコンテナーに、またはその逆にどのように伝播されるかを決定します。設定されていない場合、MountPropagationNone が使用されます。このフィールドは 1.10 のベータ版です。
使用可能な列挙値: - |
|
| ボリュームの名前に一致する必要があります。 |
|
| true の場合は読み取り専用、それ以外の場合は読み取り/書き込み (false または指定なし) でマウントされます。デフォルトは false です。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内のパス。デフォルトは "" (ボリュームのルート) です。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内の拡張パス。SubPath と同様に動作しますが、環境変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。デフォルトは "" (ボリュームのルート) です。SubPathExpr と SubPath は相互に排他的です。 |
15.1.95. .spec.template.spec.dnsConfig リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodDNSConfig は、DNSPolicy から生成されたパラメーターに加えて、Pod の DNS パラメーターを定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| DNS ネームサーバーの IP アドレスのリスト。これは、DNSPolicy から生成されたベースネームサーバーに追加されます。重複したネームサーバーは削除されます。 |
|
| DNS リゾルバーオプションのリスト。これは、DNSPolicy から生成された基本オプションとマージされます。重複したエントリーは削除されます。オプションで指定された解決オプションは、ベース DNS ポリシーに表示されるものをオーバーライドします。 |
|
| PodDNSConfigOption は、Pod の DNS リゾルバーオプションを定義します。 |
|
| ホスト名ルックアップ用の DNS 検索ドメインのリスト。これは、DNSPolicy から生成された基本検索パスに追加されます。重複する検索パスは削除されます。 |
15.1.96. .spec.template.spec.dnsConfig.options リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DNS リゾルバーオプションのリスト。これは、DNSPolicy から生成された基本オプションとマージされます。重複したエントリーは削除されます。オプションで指定された解決オプションは、ベース DNS ポリシーに表示されるものをオーバーライドします。
- 型
-
array
15.1.97. .spec.template.spec.dnsConfig.options[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodDNSConfigOption は、Pod の DNS リゾルバーオプションを定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 必須。 |
|
|
15.1.98. .spec.template.spec.ephemeralContainers リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- この Pod で実行されるエフェメラルコンテナーのリスト。エフェメラルコンテナーを既存の Pod で実行して、デバッグなどのユーザーが開始するアクションを実行できます。このリストは、Pod の作成時に指定することはできません。また、Pod の仕様を更新して変更することもできません。エフェメラルコンテナーを既存の Pod に追加するには、Pod のエフェメラルコンテナーサブリソースを使用します。
- 型
-
array
15.1.99. .spec.template.spec.ephemeralContainers[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
EphemeralContainer は、デバッグなど、ユーザーが開始したアクティビティーに対して、既存の Pod に追加できる一時コンテナーです。エフェメラルコンテナーにはリソースやスケジュールの保証がなく、コンテナーの終了時、または Pod の削除または再起動時に再起動されません。エフェメラルコンテナーが原因で Pod がリソース割り当てを超過した場合、kubelet は Pod をエビクトする可能性があります。
エフェメラルコンテナーを追加するには、既存の Pod の ephemeralcontainers サブリソースを使用します。エフェメラルコンテナーは削除または再起動できません。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| エントリーポイントへの引数。このプロパティが指定されていない場合は、イメージの CMD が使用されます。変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、"(VAR_NAME)" は文字列リテラル "$(VAR_NAME)" を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。これを更新することはできません。詳細: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell |
|
| エントリーポイント配列。シェル内では実行されません。これが指定されていない場合は、イメージの ENTRYPOINT が使用されます。変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、"(VAR_NAME)" は文字列リテラル "$(VAR_NAME)" を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。これを更新することはできません。詳細: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell |
|
| コンテナーに設定する環境変数のリスト。これを更新することはできません。 |
|
| EnvVar は、コンテナーに存在する環境変数を表します。 |
|
| コンテナー内の環境変数に入力するソースのリスト。ソース内で定義されたキーは C_IDENTIFIER である必要があります。無効なキーはすべて、コンテナーの起動時にイベントとして報告されます。キーが複数のソースに存在する場合、最後のソースに関連付けられた値が優先されます。重複キーを持つ環境によって定義された値が優先されます。これを更新することはできません。 |
|
| EnvFromSource は、一連の ConfigMap のソースを表します |
|
| コンテナーイメージ名詳細: https://kubernetes.io/docs/concepts/containers/images |
|
| イメージプルポリシーAlways、Never、IfNotPresent のいずれか。デフォルトは、:latest タグが指定されている場合は常に、それ以外の場合は IfNotPresent です。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/containers/images#updating-images
使用可能な列挙値: - |
|
| ライフサイクルは、コンテナーのライフサイクルイベントに対応して管理システムが実行する必要のあるアクションを表します。PostStart および PreStop ライフサイクルハンドラーの場合、コンテナープロセスが失敗しない限り、アクションが完了するまでコンテナー管理がブロックされます。失敗した場合、ハンドラーは中止されます。 |
|
| プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。 |
|
| DNS_LABEL として指定されたエフェメラルコンテナーの名前。この名前は、すべてのコンテナー、init コンテナー、およびエフェメラルコンテナーの中で一意である必要があります。 |
|
| エフェメラルコンテナーのポートは許可されていません。 |
|
| ContainerPort は、単一のコンテナー内のネットワークポートを表します。 |
|
| プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。 |
|
| コンテナーのリソースサイズ変更ポリシー。 |
|
| ContainerResizePolicy は、コンテナーのリソースサイズ変更ポリシーを表します。 |
|
| ResourceRequirements は、コンピュートリソースの要件を説明します。 |
|
| Pod 内の各コンテナーの再起動動作を管理するためのコンテナーの再起動ポリシー。これは init コンテナーに対してのみ設定できます。このフィールドは一時コンテナーには設定できません。 |
|
| SecurityContext は、コンテナーに適用されるセキュリティー設定を保持します。一部のフィールドは、SecurityContext と PodSecurityContext の両方に存在します。両方が設定されている場合は、SecurityContext の値が優先されます。 |
|
| プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。 |
|
| このコンテナーがコンテナーランタイムで stdin にバッファーを割り当てる必要があるかどうか。これが設定されていない場合、コンテナー内の stdin からの読み取りは常に EOF になります。デフォルトは false です。 |
|
| コンテナーランタイムが、単一の接続によって開かれた後に stdin チャネルを閉じる必要があるかどうか。stdin が true の場合、stdin ストリームは複数の接続セッションにわたって開いたままになります。stdinOnce が true に設定されている場合、stdin はコンテナーの起動時に開かれ、最初のクライアントが stdin に接続するまで空になり、クライアントが切断されるまで開いたままでデータを受け入れます。切断されると、stdin は閉じられ、コンテナーが再起動されるまで閉じられたままになります。。このフラグが false の場合、stdin から読み取るコンテナープロセスは EOF を受信しません。デフォルトは false です。 |
|
| 設定されている場合、このエフェメラルコンテナーがターゲットとする PodSpec からのコンテナーの名前。エフェメラルコンテナーは、このコンテナーの namespace (IPC、PID など) で実行されます。設定されていない場合、エフェメラルコンテナーは Pod 仕様で設定された namespace を使用します。 コンテナーランタイムは、この機能のサポートを実装する必要があります。ランタイムが namespace ターゲットをサポートしていない場合、このフィールドの設定結果は定義されません。 |
|
| オプション: コンテナーの終了メッセージが書き込まれるファイルがコンテナーのファイルシステムにマウントされるパス。書き込まれるメッセージは、アサーション失敗メッセージなどの簡単な最終ステータスを目的としています。4096 バイトを超える場合、ノードによって切り捨てられます。すべてのコンテナーの合計メッセージ長は 12kb に制限されます。デフォルトは/dev/termination-log です。これを更新することはできません。 |
|
| 終了メッセージの入力方法を示します。ファイルは、terminationMessagePath の内容を使用して、成功と失敗の両方でコンテナーステータスメッセージを入力します。終了メッセージファイルが空で、コンテナーがエラーで終了した場合、FallbackToLogsOnError はコンテナーログ出力の最後のチャンクを使用します。ログ出力は、2048 バイトまたは 80 行のいずれか小さい方に制限されます。デフォルトは File です。これを更新することはできません。
使用可能な列挙値: - |
|
| このコンテナーがそれ自体に TTY を割り当てる必要があるかどうかには、'stdin' が true である必要もあります。デフォルトは false です。 |
|
| volumeDevices は、コンテナーによって使用されるブロックデバイスのリストです。 |
|
| volumeDevice は、コンテナー内の raw ブロックデバイスのマッピングを記述します。 |
|
| コンテナーのファイルシステムにマウントする Pod ボリューム。エフェメラルコンテナーでは、サブパスをマウントできません。これを更新することはできません。 |
|
| VolumeMount は、コンテナー内でのボリュームのマウントを説明します。 |
|
| コンテナーの作業ディレクトリー。指定しない場合、コンテナーランタイムのデフォルトが使用されます。これは、コンテナーイメージで設定されている可能性があります。これを更新することはできません。 |
15.1.100. .spec.template.spec.ephemeralContainers[].env リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナーに設定する環境変数のリスト。これを更新することはできません。
- 型
-
array
15.1.101. .spec.template.spec.ephemeralContainers[].env[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- EnvVar は、コンテナーに存在する環境変数を表します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 環境変数の名前。C_IDENTIFIER でなければなりません。 |
|
| 変数参照 $(VAR_NAME) は、コンテナー内で以前に定義された環境変数と任意のサービス環境変数を使用してデプロイメントされます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、"(VAR_NAME)" は文字列リテラル "$(VAR_NAME)" を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。デフォルトは "" です。 |
|
| EnvVarSource は、EnvVar の値のソースを表します。 |
15.1.102. .spec.template.spec.ephemeralContainers[].env[].valueFrom リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- EnvVarSource は、EnvVar の値のソースを表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ConfigMap からキーを選択します。 |
|
| ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。 |
|
| ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。 |
|
| SecretKeySelector は、シークレットのキーを選択します。 |
15.1.103. .spec.template.spec.ephemeralContainers[].env[].valueFrom.configMapKeyRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ConfigMap からキーを選択します。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
15.1.104. .spec.template.spec.ephemeralContainers[].env[].valueFrom.fieldRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。
- 型
-
object
- 必須
-
fieldPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| FieldPath が記述されているスキーマのバージョン。デフォルトは "v1" です。 |
|
| 指定された API バージョンで選択するフィールドのパス。 |
15.1.105. .spec.template.spec.ephemeralContainers[].env[].valueFrom.resourceFieldRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。
- 型
-
object
- 必須
-
resource
-
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナー名: ボリュームには必須、env 変数にはオプション |
| 公開されたリソースの出力形式を指定します。デフォルトは "1" です。 | |
|
| 必須: 選択するリソース |
15.1.106. .spec.template.spec.ephemeralContainers[].env[].valueFrom.secretKeyRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SecretKeySelector は、シークレットのキーを選択します。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
15.1.107. .spec.template.spec.ephemeralContainers[].envFrom リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナー内の環境変数に入力するソースのリスト。ソース内で定義されたキーは C_IDENTIFIER である必要があります。無効なキーはすべて、コンテナーの起動時にイベントとして報告されます。キーが複数のソースに存在する場合、最後のソースに関連付けられた値が優先されます。重複キーを持つ環境によって定義された値が優先されます。これを更新することはできません。
- 型
-
array
15.1.108. .spec.template.spec.ephemeralContainers[].envFrom[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- EnvFromSource は、一連の ConfigMap のソースを表します
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ConfigMapEnvSource は、環境変数に入力する ConfigMap を選択します。 ターゲットの ConfigMap のデータフィールドの内容は、キーと値のペアを環境変数として表します。 |
|
| ConfigMap の各キーの前に追加するオプションの識別子。C_IDENTIFIER でなければなりません。 |
|
| SecretEnvSource は、環境変数に入力するシークレットを選択します。 ターゲットシークレットのデータフィールドの内容は、キーと値のペアを環境変数として表します。 |
15.1.109. .spec.template.spec.ephemeralContainers[].envFrom[].configMapRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
ConfigMapEnvSource は、環境変数に入力する ConfigMap を選択します。
ターゲットの ConfigMap のデータフィールドの内容は、キーと値のペアを環境変数として表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap を定義する必要があるかどうかを指定します |
15.1.110. .spec.template.spec.ephemeralContainers[].envFrom[].secretRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
SecretEnvSource は、環境変数に入力するシークレットを選択します。
ターゲットシークレットのデータフィールドの内容は、キーと値のペアを環境変数として表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットを定義する必要があるかどうかを指定します |
15.1.111. .spec.template.spec.ephemeralContainers[].lifecycle リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ライフサイクルは、コンテナーのライフサイクルイベントに対応して管理システムが実行する必要のあるアクションを表します。PostStart および PreStop ライフサイクルハンドラーの場合、コンテナープロセスが失敗しない限り、アクションが完了するまでコンテナー管理がブロックされます。失敗した場合、ハンドラーは中止されます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。 |
|
| LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。 |
15.1.112. .spec.template.spec.ephemeralContainers[].lifecycle.postStart リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
15.1.113. .spec.template.spec.ephemeralContainers[].lifecycle.postStart.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
15.1.114. .spec.template.spec.ephemeralContainers[].lifecycle.postStart.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
15.1.115. .spec.template.spec.ephemeralContainers[].lifecycle.postStart.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
15.1.116. .spec.template.spec.ephemeralContainers[].lifecycle.postStart.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
15.1.117. .spec.template.spec.ephemeralContainers[].lifecycle.postStart.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
15.1.118. .spec.template.spec.ephemeralContainers[].lifecycle.preStop リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
15.1.119. .spec.template.spec.ephemeralContainers[].lifecycle.preStop.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
15.1.120. .spec.template.spec.ephemeralContainers[].lifecycle.preStop.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
15.1.121. .spec.template.spec.ephemeralContainers[].lifecycle.preStop.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
15.1.122. .spec.template.spec.ephemeralContainers[].lifecycle.preStop.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
15.1.123. .spec.template.spec.ephemeralContainers[].lifecycle.preStop.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
15.1.124. .spec.template.spec.ephemeralContainers[].livenessProbe リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| 正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。 |
|
| GRPC は、GRPC ポートに関連するアクションを指定します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。 |
|
| 失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
|
| プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。 |
|
| プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
15.1.125. .spec.template.spec.ephemeralContainers[].livenessProbe.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
15.1.126. .spec.template.spec.ephemeralContainers[].livenessProbe.grpc リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GRPC は、GRPC ポートに関連するアクションを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| gRPC サービスのポート番号。番号は 1〜65535 の範囲である必要があります。 |
|
| Service は、gRPC HealthCheckRequest に配置するサービスの名前です (https://github.com/grpc/grpc/blob/master/doc/health-checking.md を参照)。 これが指定されていない場合、デフォルトの動作は gRPC によって定義されます。 |
15.1.127. .spec.template.spec.ephemeralContainers[].livenessProbe.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
15.1.128. .spec.template.spec.ephemeralContainers[].livenessProbe.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
15.1.129. .spec.template.spec.ephemeralContainers[].livenessProbe.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
15.1.130. .spec.template.spec.ephemeralContainers[].livenessProbe.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
15.1.131. .spec.template.spec.ephemeralContainers[].ports リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- エフェメラルコンテナーのポートは許可されていません。
- 型
-
array
15.1.132. .spec.template.spec.ephemeralContainers[].ports[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerPort は、単一のコンテナー内のネットワークポートを表します。
- 型
-
object
- 必須
-
containerPort
-
プロパティー | 型 | 説明 |
---|---|---|
|
| Pod の IP アドレスで公開するポートの数。これは有効なポート番号である必要があります、0<x<65536。 |
|
| 外部ポートをバインドするホスト IP。 |
|
| ホストで公開するポートの数。指定する場合、これは有効なポート番号、0<x<65536 である必要があります。HostNetwork が指定されている場合、これは ContainerPort と一致する必要があります。ほとんどのコンテナーはこれを必要としません。 |
|
| 指定する場合、これは IANA_SVC_NAME であり、Pod 内で一意である必要があります。Pod 内の名前付きポートにはそれぞれ一意の名前を付ける必要があります。サービスが参照できるポートの名前。 |
|
| ポートのプロトコル。UDP、TCP、または SCTP である必要があります。デフォルトは "TCP" です。
使用可能な列挙値: - |
15.1.133. .spec.template.spec.ephemeralContainers[].readinessProbe リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| 正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。 |
|
| GRPC は、GRPC ポートに関連するアクションを指定します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。 |
|
| 失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
|
| プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。 |
|
| プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
15.1.134. .spec.template.spec.ephemeralContainers[].readinessProbe.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
15.1.135. .spec.template.spec.ephemeralContainers[].readinessProbe.grpc リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GRPC は、GRPC ポートに関連するアクションを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| gRPC サービスのポート番号。番号は 1〜65535 の範囲である必要があります。 |
|
| Service は、gRPC HealthCheckRequest に配置するサービスの名前です (https://github.com/grpc/grpc/blob/master/doc/health-checking.md を参照)。 これが指定されていない場合、デフォルトの動作は gRPC によって定義されます。 |
15.1.136. .spec.template.spec.ephemeralContainers[].readinessProbe.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
15.1.137. .spec.template.spec.ephemeralContainers[].readinessProbe.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
15.1.138. .spec.template.spec.ephemeralContainers[].readinessProbe.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
15.1.139. .spec.template.spec.ephemeralContainers[].readinessProbe.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
15.1.140. .spec.template.spec.ephemeralContainers[].resizePolicy リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナーのリソースサイズ変更ポリシー。
- 型
-
array
15.1.141. .spec.template.spec.ephemeralContainers[].resizePolicy[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerResizePolicy は、コンテナーのリソースサイズ変更ポリシーを表します。
- 型
-
object
- 必須
-
resourceName
-
restartPolicy
-
プロパティー | 型 | 説明 |
---|---|---|
|
| このリソースサイズ変更ポリシーが適用されるリソースの名前。対応している値は、cpu、memory です。 |
|
| 指定されたリソースのサイズが変更されたときに適用する再起動ポリシー。指定しない場合、デフォルトの NotRequired が設定されます。 |
15.1.142. .spec.template.spec.ephemeralContainers[].resources リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceRequirements は、コンピュートリソースの要件を説明します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。 これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。 このフィールドは不変です。これはコンテナーにのみ設定できます。 |
|
| ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。 |
| limits は、許可されるコンピュートリソースの最大量を示します。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 | |
| requests は、必要なコンピュートリソースの最小量を示します。コンテナーで Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
15.1.143. .spec.template.spec.ephemeralContainers[].resources.claims リンクのコピーリンクがクリップボードにコピーされました!
- 説明
Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。
これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。
このフィールドは不変です。これはコンテナーにのみ設定できます。
- 型
-
array
15.1.144. .spec.template.spec.ephemeralContainers[].resources.claims[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。 |
15.1.145. .spec.template.spec.ephemeralContainers[].securityContext リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SecurityContext は、コンテナーに適用されるセキュリティー設定を保持します。一部のフィールドは、SecurityContext と PodSecurityContext の両方に存在します。両方が設定されている場合は、SecurityContext の値が優先されます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| AllowPrivilegeEscalation は、プロセスがその親プロセスよりも多くの特権を取得できるかどうかを制御します。このブール値は、no_new_privs フラグがコンテナープロセスに設定されるかどうかを直接制御します。コンテナーが 1) 特権で実行されており、CAP_SYS_ADMIN が割り当てられている場合、2) AllowPrivilegeEscalation は常に true です。spec.os.name が windows の場合は、このフィールドは設定できないことに注意してください。 |
|
| 実行中のコンテナーに POSIX 機能を追加および削除します。 |
|
| コンテナーを特権モードで実行します。特権コンテナー内のプロセスは、基本的にホスト上の root と同等です。デフォルトは false です。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| procMount は、コンテナーに使用する proc マウントのタイプを示します。デフォルトは DefaultProcMount で、読み取り専用パスとマスクされたパスにコンテナーランタイムのデフォルトを使用します。これには、ProcMountType 機能フラグを有効にする必要があります。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
使用可能な列挙値: - |
|
| このコンテナーに読み取り専用のルートファイルシステムがあるかどうか。デフォルトは false です。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| コンテナープロセスのエントリーポイントを実行するための GID。設定されていない場合は、実行時のデフォルトを使用します。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| コンテナーが root 以外のユーザーとして実行される必要があることを示します。true の場合、Kubelet は実行時にイメージを検証して、イメージが UID 0(ルート) として実行されないことを確認し、実行される場合はコンテナーの開始に失敗します。未設定または false の場合、そのような検証は実行されません。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。 |
|
| コンテナープロセスのエントリーポイントを実行するための UID。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| SELinuxOptions は、コンテナーに適用されるラベルです。 |
|
| SeccompProfile は、Pod/コンテナーの seccomp プロファイル設定を定義します。設定できるプロファイルソースは 1 つだけです。 |
|
| WindowsSecurityContextOptions には、Windows 固有のオプションおよび認証情報が含まれています。 |
15.1.146. .spec.template.spec.ephemeralContainers[].securityContext.capabilities リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 実行中のコンテナーに POSIX 機能を追加および削除します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 追加された機能 |
|
| 削除された機能 |
15.1.147. .spec.template.spec.ephemeralContainers[].securityContext.seLinuxOptions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SELinuxOptions は、コンテナーに適用されるラベルです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Level は、コンテナーに適用される SELinux レベルのラベルです。 |
|
| Role は、コンテナーに適用される SELinux ロールラベルです。 |
|
| Type は、コンテナーに適用される SELinux タイプのラベルです。 |
|
| User は、コンテナーに適用される SELinux ユーザーラベルです。 |
15.1.148. .spec.template.spec.ephemeralContainers[].securityContext.seccompProfile リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SeccompProfile は、Pod/コンテナーの seccomp プロファイル設定を定義します。設定できるプロファイルソースは 1 つだけです。
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| localhostProfile は、ノード上のファイルで定義されたプロファイルを使用する必要があることを示します。プロファイルが機能するには、ノードで事前に設定されている必要があります。kubelet の設定済みの seccomp プロファイルの場所を基準にして、降順のパスである必要があります。タイプが "Localhost" の場合は設定する必要があります。他のタイプには設定しないでください。 |
|
| type は、適用される seccomp プロファイルの種類を示します。有効なオプションは以下のとおりです。 Localhost - ノード上のファイルで定義されたプロファイルを使用する必要があります。RuntimeDefault- コンテナーのランタイムデフォルトプロファイルを使用する必要があります。制限なし - プロファイルを適用しないでください。
使用可能な列挙値: - |
15.1.149. .spec.template.spec.ephemeralContainers[].securityContext.windowsOptions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- WindowsSecurityContextOptions には、Windows 固有のオプションおよび認証情報が含まれています。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| GMSACredentialSpec は、GMSA アドミッション Webhook (https://github.com/kubernetes-sigs/windows-gmsa) が GMSACredentialSpecName フィールドで指定された GMSA クレデンシャル仕様のコンテンツをインライン化する場所です。 |
|
| GMSACredentialSpecName は、使用する GMSA 認証情報仕様の名前です。 |
|
| hostProcess は、コンテナーを 'Host Process' コンテナーとして実行する必要があるかどうかを決定します。Pod のすべてのコンテナーは、同じ有効な HostProcess 値を持っている必要があります (HostProcess コンテナーと非 HostProcess コンテナーを混在させることはできません)。さらに、HostProcess が true の場合、HostNetwork も true に設定する必要があります。 |
|
| コンテナープロセスのエントリーポイントを実行するための Windows の UserName。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。 |
15.1.150. .spec.template.spec.ephemeralContainers[].startupProbe リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| 正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。 |
|
| GRPC は、GRPC ポートに関連するアクションを指定します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。 |
|
| 失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
|
| プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。 |
|
| プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
15.1.151. .spec.template.spec.ephemeralContainers[].startupProbe.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
15.1.152. .spec.template.spec.ephemeralContainers[].startupProbe.grpc リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GRPC は、GRPC ポートに関連するアクションを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| gRPC サービスのポート番号。番号は 1〜65535 の範囲である必要があります。 |
|
| Service は、gRPC HealthCheckRequest に配置するサービスの名前です (https://github.com/grpc/grpc/blob/master/doc/health-checking.md を参照)。 これが指定されていない場合、デフォルトの動作は gRPC によって定義されます。 |
15.1.153. .spec.template.spec.ephemeralContainers[].startupProbe.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
15.1.154. .spec.template.spec.ephemeralContainers[].startupProbe.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
15.1.155. .spec.template.spec.ephemeralContainers[].startupProbe.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
15.1.156. .spec.template.spec.ephemeralContainers[].startupProbe.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
15.1.157. .spec.template.spec.ephemeralContainers[].volumeDevices リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- volumeDevices は、コンテナーによって使用されるブロックデバイスのリストです。
- 型
-
array
15.1.158. .spec.template.spec.ephemeralContainers[].volumeDevices[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- volumeDevice は、コンテナー内の raw ブロックデバイスのマッピングを記述します。
- 型
-
object
- 必須
-
name
-
devicePath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| devicePath は、デバイスがマップされるコンテナー内のパスです。 |
|
| name は、Pod 内の persistentVolumeClaim の名前と一致する必要があります |
15.1.159. .spec.template.spec.ephemeralContainers[].volumeMounts リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナーのファイルシステムにマウントする Pod ボリューム。エフェメラルコンテナーでは、サブパスをマウントできません。これを更新することはできません。
- 型
-
array
15.1.160. .spec.template.spec.ephemeralContainers[].volumeMounts[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- VolumeMount は、コンテナー内でのボリュームのマウントを説明します。
- 型
-
object
- 必須
-
name
-
mountPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ボリュームをマウントする必要があるコンテナー内のパス。':' を含めることはできません。 |
|
| mountPropagation は、マウントがホストからコンテナーに、またはその逆にどのように伝播されるかを決定します。設定されていない場合、MountPropagationNone が使用されます。このフィールドは 1.10 のベータ版です。
使用可能な列挙値: - |
|
| ボリュームの名前に一致する必要があります。 |
|
| true の場合は読み取り専用、それ以外の場合は読み取り/書き込み (false または指定なし) でマウントされます。デフォルトは false です。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内のパス。デフォルトは "" (ボリュームのルート) です。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内の拡張パス。SubPath と同様に動作しますが、環境変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。デフォルトは "" (ボリュームのルート) です。SubPathExpr と SubPath は相互に排他的です。 |
15.1.161. .spec.template.spec.hostAliases リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HostAliases は、指定された場合に Pod の hosts ファイルに注入されるホストおよび IP のオプションのリストです。これは、hostNetwork 以外の Pod にのみ有効です。
- 型
-
array
15.1.162. .spec.template.spec.hostAliases[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HostAlias は、Pod の hosts ファイルのエントリーとして挿入される IP とホスト名の間のマッピングを保持します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 上記の IP アドレスのホスト名。 |
|
| ホストファイルエントリーの IP アドレス。 |
15.1.163. .spec.template.spec.imagePullSecrets リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ImagePullSecrets は、この PodSpec で使用されるイメージをプルするために使用する、同じ名前空間内のシークレットへの参照のオプションのリストです。指定されている場合、これらのシークレットは、使用するために個々のプラー実装に渡されます。詳細: https://kubernetes.io/docs/concepts/containers/images#specifying-imagepullsecrets-on-a-pod
- 型
-
array
15.1.164. .spec.template.spec.imagePullSecrets[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
15.1.165. .spec.template.spec.initContainers リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod に属する初期化コンテナーのリスト。コンテナーが開始される前に、初期化コンテナーが順番に実行されます。init コンテナーに障害が発生した場合、Pod は障害が発生したと見なされ、restartPolicy に従って処理されます。init コンテナーまたは通常のコンテナーの名前は、すべてのコンテナー間で一意である必要があります。Init コンテナーには、ライフサイクルアクション、準備プローブ、ライブネスプローブ、またはスタートアッププローブがない場合があります。init コンテナーの resourceRequirements は、各リソースタイプの最大の要求/制限を見つけ、その値の最大値または通常のコンテナーの合計を使用することにより、スケジューリング中に考慮されます。同様の方法で、init コンテナーに制限が適用されます。現在、初期化コンテナーを追加または削除することはできません。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/
- 型
-
array
15.1.166. .spec.template.spec.initContainers[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod 内で実行する単一のアプリケーションコンテナー。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| エントリーポイントへの引数。これが指定されていない場合は、コンテナーイメージの CMD が使用されます。変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、"(VAR_NAME)" は文字列リテラル "$(VAR_NAME)" を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。これを更新することはできません。詳細: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell |
|
| エントリーポイント配列。シェル内では実行されません。これが指定されていない場合は、コンテナーイメージの ENTRYPOINT が使用されます。変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、"(VAR_NAME)" は文字列リテラル "$(VAR_NAME)" を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。これを更新することはできません。詳細: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell |
|
| コンテナーに設定する環境変数のリスト。これを更新することはできません。 |
|
| EnvVar は、コンテナーに存在する環境変数を表します。 |
|
| コンテナー内の環境変数に入力するソースのリスト。ソース内で定義されたキーは C_IDENTIFIER である必要があります。無効なキーはすべて、コンテナーの起動時にイベントとして報告されます。キーが複数のソースに存在する場合、最後のソースに関連付けられた値が優先されます。重複キーを持つ環境によって定義された値が優先されます。これを更新することはできません。 |
|
| EnvFromSource は、一連の ConfigMap のソースを表します |
|
| コンテナーイメージ名詳細: https://kubernetes.io/docs/concepts/containers/images このフィールドはオプションであり、高レベルの設定管理で、Deployments や StatefulSets などのワークロードコントローラーのコンテナーイメージをデフォルトまたはオーバーライドできます。 |
|
| イメージプルポリシーAlways、Never、IfNotPresent のいずれか。デフォルトは、:latest タグが指定されている場合は常に、それ以外の場合は IfNotPresent です。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/containers/images#updating-images
使用可能な列挙値: - |
|
| ライフサイクルは、コンテナーのライフサイクルイベントに対応して管理システムが実行する必要のあるアクションを表します。PostStart および PreStop ライフサイクルハンドラーの場合、コンテナープロセスが失敗しない限り、アクションが完了するまでコンテナー管理がブロックされます。失敗した場合、ハンドラーは中止されます。 |
|
| プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。 |
|
| DNS_LABEL として指定されたコンテナーの名前。Pod 内の各コンテナーには、一意の名前 (DNS_LABEL) が必要です。これを更新することはできません。 |
|
| コンテナーから公開するポートのリスト。ここでポートを指定しなくても、そのポートが公開されるのを防ぐことはできません。コンテナー内のデフォルトの "0.0.0.0" アドレスをリッスンしているポートは、ネットワークからアクセスできます。戦略的マージパッチを使用してこの配列を変更すると、データが破損する可能性があります。詳細は、https://github.com/kubernetes/kubernetes/issues/108255 を参照してください。これを更新することはできません。 |
|
| ContainerPort は、単一のコンテナー内のネットワークポートを表します。 |
|
| プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。 |
|
| コンテナーのリソースサイズ変更ポリシー。 |
|
| ContainerResizePolicy は、コンテナーのリソースサイズ変更ポリシーを表します。 |
|
| ResourceRequirements は、コンピュートリソースの要件を説明します。 |
|
| RestartPolicy は、Pod 内の個々のコンテナーの再起動動作を定義します。このフィールドは init コンテナーに対してのみ設定でき、許可される値は "Always" のみです。init 以外のコンテナーの場合、またはこのフィールドが指定されていない場合、再起動の動作は Pod の再起動ポリシーとコンテナータイプによって定義されます。init コンテナーの RestartPolicy を "Always" に設定すると、次の効果が得られます: この init コンテナーは、すべての通常のコンテナーが終了するまで、終了時に継続的に再起動されます。すべての通常のコンテナーが完了すると、restartPolicy が "Always" のすべての init コンテナーがシャットダウンされます。このライフサイクルは通常の init コンテナーとは異なり、多くの場合、"sidecar" コンテナーと呼ばれます。この init コンテナーは、引き続き init コンテナーシーケンス内で開始されますが、次の init コンテナーに進む前にコンテナーが完了するのを待機しません。代わりに、この init コンテナーが起動した直後、または任意の startupProbe が正常に完了した後に、次の init コンテナーが起動します。 |
|
| SecurityContext は、コンテナーに適用されるセキュリティー設定を保持します。一部のフィールドは、SecurityContext と PodSecurityContext の両方に存在します。両方が設定されている場合は、SecurityContext の値が優先されます。 |
|
| プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。 |
|
| このコンテナーがコンテナーランタイムで stdin にバッファーを割り当てる必要があるかどうか。これが設定されていない場合、コンテナー内の stdin からの読み取りは常に EOF になります。デフォルトは false です。 |
|
| コンテナーランタイムが、単一の接続によって開かれた後に stdin チャネルを閉じる必要があるかどうか。stdin が true の場合、stdin ストリームは複数の接続セッションにわたって開いたままになります。stdinOnce が true に設定されている場合、stdin はコンテナーの起動時に開かれ、最初のクライアントが stdin に接続するまで空になり、クライアントが切断されるまで開いたままでデータを受け入れます。切断されると、stdin は閉じられ、コンテナーが再起動されるまで閉じられたままになります。。このフラグが false の場合、stdin から読み取るコンテナープロセスは EOF を受信しません。デフォルトは false です。 |
|
| オプション: コンテナーの終了メッセージが書き込まれるファイルがコンテナーのファイルシステムにマウントされるパス。書き込まれるメッセージは、アサーション失敗メッセージなどの簡単な最終ステータスを目的としています。4096 バイトを超える場合、ノードによって切り捨てられます。すべてのコンテナーの合計メッセージ長は 12kb に制限されます。デフォルトは/dev/termination-log です。これを更新することはできません。 |
|
| 終了メッセージの入力方法を示します。ファイルは、terminationMessagePath の内容を使用して、成功と失敗の両方でコンテナーステータスメッセージを入力します。終了メッセージファイルが空で、コンテナーがエラーで終了した場合、FallbackToLogsOnError はコンテナーログ出力の最後のチャンクを使用します。ログ出力は、2048 バイトまたは 80 行のいずれか小さい方に制限されます。デフォルトは File です。これを更新することはできません。
使用可能な列挙値: - |
|
| このコンテナーがそれ自体に TTY を割り当てる必要があるかどうかには、'stdin' が true である必要もあります。デフォルトは false です。 |
|
| volumeDevices は、コンテナーによって使用されるブロックデバイスのリストです。 |
|
| volumeDevice は、コンテナー内の raw ブロックデバイスのマッピングを記述します。 |
|
| コンテナーのファイルシステムにマウントする Pod ボリューム。これを更新することはできません。 |
|
| VolumeMount は、コンテナー内でのボリュームのマウントを説明します。 |
|
| コンテナーの作業ディレクトリー。指定しない場合、コンテナーランタイムのデフォルトが使用されます。これは、コンテナーイメージで設定されている可能性があります。これを更新することはできません。 |
15.1.167. .spec.template.spec.initContainers[].env リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナーに設定する環境変数のリスト。これを更新することはできません。
- 型
-
array
15.1.168. .spec.template.spec.initContainers[].env[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- EnvVar は、コンテナーに存在する環境変数を表します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 環境変数の名前。C_IDENTIFIER でなければなりません。 |
|
| 変数参照 $(VAR_NAME) は、コンテナー内で以前に定義された環境変数と任意のサービス環境変数を使用してデプロイメントされます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、"(VAR_NAME)" は文字列リテラル "$(VAR_NAME)" を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。デフォルトは "" です。 |
|
| EnvVarSource は、EnvVar の値のソースを表します。 |
15.1.169. .spec.template.spec.initContainers[].env[].valueFrom リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- EnvVarSource は、EnvVar の値のソースを表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ConfigMap からキーを選択します。 |
|
| ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。 |
|
| ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。 |
|
| SecretKeySelector は、シークレットのキーを選択します。 |
15.1.170. .spec.template.spec.initContainers[].env[].valueFrom.configMapKeyRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ConfigMap からキーを選択します。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
15.1.171. .spec.template.spec.initContainers[].env[].valueFrom.fieldRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。
- 型
-
object
- 必須
-
fieldPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| FieldPath が記述されているスキーマのバージョン。デフォルトは "v1" です。 |
|
| 指定された API バージョンで選択するフィールドのパス。 |
15.1.172. .spec.template.spec.initContainers[].env[].valueFrom.resourceFieldRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。
- 型
-
object
- 必須
-
resource
-
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナー名: ボリュームには必須、env 変数にはオプション |
| 公開されたリソースの出力形式を指定します。デフォルトは "1" です。 | |
|
| 必須: 選択するリソース |
15.1.173. .spec.template.spec.initContainers[].env[].valueFrom.secretKeyRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SecretKeySelector は、シークレットのキーを選択します。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
15.1.174. .spec.template.spec.initContainers[].envFrom リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナー内の環境変数に入力するソースのリスト。ソース内で定義されたキーは C_IDENTIFIER である必要があります。無効なキーはすべて、コンテナーの起動時にイベントとして報告されます。キーが複数のソースに存在する場合、最後のソースに関連付けられた値が優先されます。重複キーを持つ環境によって定義された値が優先されます。これを更新することはできません。
- 型
-
array
15.1.175. .spec.template.spec.initContainers[].envFrom[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- EnvFromSource は、一連の ConfigMap のソースを表します
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ConfigMapEnvSource は、環境変数に入力する ConfigMap を選択します。 ターゲットの ConfigMap のデータフィールドの内容は、キーと値のペアを環境変数として表します。 |
|
| ConfigMap の各キーの前に追加するオプションの識別子。C_IDENTIFIER でなければなりません。 |
|
| SecretEnvSource は、環境変数に入力するシークレットを選択します。 ターゲットシークレットのデータフィールドの内容は、キーと値のペアを環境変数として表します。 |
15.1.176. .spec.template.spec.initContainers[].envFrom[].configMapRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
ConfigMapEnvSource は、環境変数に入力する ConfigMap を選択します。
ターゲットの ConfigMap のデータフィールドの内容は、キーと値のペアを環境変数として表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap を定義する必要があるかどうかを指定します |
15.1.177. .spec.template.spec.initContainers[].envFrom[].secretRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
SecretEnvSource は、環境変数に入力するシークレットを選択します。
ターゲットシークレットのデータフィールドの内容は、キーと値のペアを環境変数として表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットを定義する必要があるかどうかを指定します |
15.1.178. .spec.template.spec.initContainers[].lifecycle リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ライフサイクルは、コンテナーのライフサイクルイベントに対応して管理システムが実行する必要のあるアクションを表します。PostStart および PreStop ライフサイクルハンドラーの場合、コンテナープロセスが失敗しない限り、アクションが完了するまでコンテナー管理がブロックされます。失敗した場合、ハンドラーは中止されます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。 |
|
| LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。 |
15.1.179. .spec.template.spec.initContainers[].lifecycle.postStart リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
15.1.180. .spec.template.spec.initContainers[].lifecycle.postStart.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
15.1.181. .spec.template.spec.initContainers[].lifecycle.postStart.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
15.1.182. .spec.template.spec.initContainers[].lifecycle.postStart.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
15.1.183. .spec.template.spec.initContainers[].lifecycle.postStart.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
15.1.184. .spec.template.spec.initContainers[].lifecycle.postStart.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
15.1.185. .spec.template.spec.initContainers[].lifecycle.preStop リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
15.1.186. .spec.template.spec.initContainers[].lifecycle.preStop.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
15.1.187. .spec.template.spec.initContainers[].lifecycle.preStop.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
15.1.188. .spec.template.spec.initContainers[].lifecycle.preStop.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
15.1.189. .spec.template.spec.initContainers[].lifecycle.preStop.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
15.1.190. .spec.template.spec.initContainers[].lifecycle.preStop.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
15.1.191. .spec.template.spec.initContainers[].livenessProbe リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| 正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。 |
|
| GRPC は、GRPC ポートに関連するアクションを指定します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。 |
|
| 失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
|
| プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。 |
|
| プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
15.1.192. .spec.template.spec.initContainers[].livenessProbe.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
15.1.193. .spec.template.spec.initContainers[].livenessProbe.grpc リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GRPC は、GRPC ポートに関連するアクションを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| gRPC サービスのポート番号。番号は 1〜65535 の範囲である必要があります。 |
|
| Service は、gRPC HealthCheckRequest に配置するサービスの名前です (https://github.com/grpc/grpc/blob/master/doc/health-checking.md を参照)。 これが指定されていない場合、デフォルトの動作は gRPC によって定義されます。 |
15.1.194. .spec.template.spec.initContainers[].livenessProbe.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
15.1.195. .spec.template.spec.initContainers[].livenessProbe.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
15.1.196. .spec.template.spec.initContainers[].livenessProbe.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
15.1.197. .spec.template.spec.initContainers[].livenessProbe.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
15.1.198. .spec.template.spec.initContainers[].ports リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナーから公開するポートのリスト。ここでポートを指定しなくても、そのポートが公開されるのを防ぐことはできません。コンテナー内のデフォルトの "0.0.0.0" アドレスをリッスンしているポートは、ネットワークからアクセスできます。戦略的マージパッチを使用してこの配列を変更すると、データが破損する可能性があります。詳細は、https://github.com/kubernetes/kubernetes/issues/108255 を参照してください。これを更新することはできません。
- 型
-
array
15.1.199. .spec.template.spec.initContainers[].ports[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerPort は、単一のコンテナー内のネットワークポートを表します。
- 型
-
object
- 必須
-
containerPort
-
プロパティー | 型 | 説明 |
---|---|---|
|
| Pod の IP アドレスで公開するポートの数。これは有効なポート番号である必要があります、0<x<65536。 |
|
| 外部ポートをバインドするホスト IP。 |
|
| ホストで公開するポートの数。指定する場合、これは有効なポート番号、0<x<65536 である必要があります。HostNetwork が指定されている場合、これは ContainerPort と一致する必要があります。ほとんどのコンテナーはこれを必要としません。 |
|
| 指定する場合、これは IANA_SVC_NAME であり、Pod 内で一意である必要があります。Pod 内の名前付きポートにはそれぞれ一意の名前を付ける必要があります。サービスが参照できるポートの名前。 |
|
| ポートのプロトコル。UDP、TCP、または SCTP である必要があります。デフォルトは "TCP" です。
使用可能な列挙値: - |
15.1.200. .spec.template.spec.initContainers[].readinessProbe リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| 正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。 |
|
| GRPC は、GRPC ポートに関連するアクションを指定します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。 |
|
| 失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
|
| プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。 |
|
| プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
15.1.201. .spec.template.spec.initContainers[].readinessProbe.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
15.1.202. .spec.template.spec.initContainers[].readinessProbe.grpc リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GRPC は、GRPC ポートに関連するアクションを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| gRPC サービスのポート番号。番号は 1〜65535 の範囲である必要があります。 |
|
| Service は、gRPC HealthCheckRequest に配置するサービスの名前です (https://github.com/grpc/grpc/blob/master/doc/health-checking.md を参照)。 これが指定されていない場合、デフォルトの動作は gRPC によって定義されます。 |
15.1.203. .spec.template.spec.initContainers[].readinessProbe.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
15.1.204. .spec.template.spec.initContainers[].readinessProbe.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
15.1.205. .spec.template.spec.initContainers[].readinessProbe.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
15.1.206. .spec.template.spec.initContainers[].readinessProbe.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
15.1.207. .spec.template.spec.initContainers[].resizePolicy リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナーのリソースサイズ変更ポリシー。
- 型
-
array
15.1.208. .spec.template.spec.initContainers[].resizePolicy[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ContainerResizePolicy は、コンテナーのリソースサイズ変更ポリシーを表します。
- 型
-
object
- 必須
-
resourceName
-
restartPolicy
-
プロパティー | 型 | 説明 |
---|---|---|
|
| このリソースサイズ変更ポリシーが適用されるリソースの名前。対応している値は、cpu、memory です。 |
|
| 指定されたリソースのサイズが変更されたときに適用する再起動ポリシー。指定しない場合、デフォルトの NotRequired が設定されます。 |
15.1.209. .spec.template.spec.initContainers[].resources リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceRequirements は、コンピュートリソースの要件を説明します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。 これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。 このフィールドは不変です。これはコンテナーにのみ設定できます。 |
|
| ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。 |
| limits は、許可されるコンピュートリソースの最大量を示します。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 | |
| requests は、必要なコンピュートリソースの最小量を示します。コンテナーで Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
15.1.210. .spec.template.spec.initContainers[].resources.claims リンクのコピーリンクがクリップボードにコピーされました!
- 説明
Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。
これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。
このフィールドは不変です。これはコンテナーにのみ設定できます。
- 型
-
array
15.1.211. .spec.template.spec.initContainers[].resources.claims[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。 |
15.1.212. .spec.template.spec.initContainers[].securityContext リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SecurityContext は、コンテナーに適用されるセキュリティー設定を保持します。一部のフィールドは、SecurityContext と PodSecurityContext の両方に存在します。両方が設定されている場合は、SecurityContext の値が優先されます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| AllowPrivilegeEscalation は、プロセスがその親プロセスよりも多くの特権を取得できるかどうかを制御します。このブール値は、no_new_privs フラグがコンテナープロセスに設定されるかどうかを直接制御します。コンテナーが 1) 特権で実行されており、CAP_SYS_ADMIN が割り当てられている場合、2) AllowPrivilegeEscalation は常に true です。spec.os.name が windows の場合は、このフィールドは設定できないことに注意してください。 |
|
| 実行中のコンテナーに POSIX 機能を追加および削除します。 |
|
| コンテナーを特権モードで実行します。特権コンテナー内のプロセスは、基本的にホスト上の root と同等です。デフォルトは false です。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| procMount は、コンテナーに使用する proc マウントのタイプを示します。デフォルトは DefaultProcMount で、読み取り専用パスとマスクされたパスにコンテナーランタイムのデフォルトを使用します。これには、ProcMountType 機能フラグを有効にする必要があります。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
使用可能な列挙値: - |
|
| このコンテナーに読み取り専用のルートファイルシステムがあるかどうか。デフォルトは false です。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| コンテナープロセスのエントリーポイントを実行するための GID。設定されていない場合は、実行時のデフォルトを使用します。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| コンテナーが root 以外のユーザーとして実行される必要があることを示します。true の場合、Kubelet は実行時にイメージを検証して、イメージが UID 0(ルート) として実行されないことを確認し、実行される場合はコンテナーの開始に失敗します。未設定または false の場合、そのような検証は実行されません。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。 |
|
| コンテナープロセスのエントリーポイントを実行するための UID。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| SELinuxOptions は、コンテナーに適用されるラベルです。 |
|
| SeccompProfile は、Pod/コンテナーの seccomp プロファイル設定を定義します。設定できるプロファイルソースは 1 つだけです。 |
|
| WindowsSecurityContextOptions には、Windows 固有のオプションおよび認証情報が含まれています。 |
15.1.213. .spec.template.spec.initContainers[].securityContext.capabilities リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 実行中のコンテナーに POSIX 機能を追加および削除します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 追加された機能 |
|
| 削除された機能 |
15.1.214. .spec.template.spec.initContainers[].securityContext.seLinuxOptions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SELinuxOptions は、コンテナーに適用されるラベルです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Level は、コンテナーに適用される SELinux レベルのラベルです。 |
|
| Role は、コンテナーに適用される SELinux ロールラベルです。 |
|
| Type は、コンテナーに適用される SELinux タイプのラベルです。 |
|
| User は、コンテナーに適用される SELinux ユーザーラベルです。 |
15.1.215. .spec.template.spec.initContainers[].securityContext.seccompProfile リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SeccompProfile は、Pod/コンテナーの seccomp プロファイル設定を定義します。設定できるプロファイルソースは 1 つだけです。
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| localhostProfile は、ノード上のファイルで定義されたプロファイルを使用する必要があることを示します。プロファイルが機能するには、ノードで事前に設定されている必要があります。kubelet の設定済みの seccomp プロファイルの場所を基準にして、降順のパスである必要があります。タイプが "Localhost" の場合は設定する必要があります。他のタイプには設定しないでください。 |
|
| type は、適用される seccomp プロファイルの種類を示します。有効なオプションは以下のとおりです。 Localhost - ノード上のファイルで定義されたプロファイルを使用する必要があります。RuntimeDefault- コンテナーのランタイムデフォルトプロファイルを使用する必要があります。制限なし - プロファイルを適用しないでください。
使用可能な列挙値: - |
15.1.216. .spec.template.spec.initContainers[].securityContext.windowsOptions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- WindowsSecurityContextOptions には、Windows 固有のオプションおよび認証情報が含まれています。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| GMSACredentialSpec は、GMSA アドミッション Webhook (https://github.com/kubernetes-sigs/windows-gmsa) が GMSACredentialSpecName フィールドで指定された GMSA クレデンシャル仕様のコンテンツをインライン化する場所です。 |
|
| GMSACredentialSpecName は、使用する GMSA 認証情報仕様の名前です。 |
|
| hostProcess は、コンテナーを 'Host Process' コンテナーとして実行する必要があるかどうかを決定します。Pod のすべてのコンテナーは、同じ有効な HostProcess 値を持っている必要があります (HostProcess コンテナーと非 HostProcess コンテナーを混在させることはできません)。さらに、HostProcess が true の場合、HostNetwork も true に設定する必要があります。 |
|
| コンテナープロセスのエントリーポイントを実行するための Windows の UserName。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。 |
15.1.217. .spec.template.spec.initContainers[].startupProbe リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- プローブは、コンテナーが稼働しているか、トラフィックを受け取る準備ができているかどうかを判断するために、コンテナーに対して実行されるヘルスチェックを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| 正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。 |
|
| GRPC は、GRPC ポートに関連するアクションを指定します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。 |
|
| 失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
|
| プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。 |
|
| プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
15.1.218. .spec.template.spec.initContainers[].startupProbe.exec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ExecAction は、"run in container" アクションを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
15.1.219. .spec.template.spec.initContainers[].startupProbe.grpc リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- GRPC は、GRPC ポートに関連するアクションを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| gRPC サービスのポート番号。番号は 1〜65535 の範囲である必要があります。 |
|
| Service は、gRPC HealthCheckRequest に配置するサービスの名前です (https://github.com/grpc/grpc/blob/master/doc/health-checking.md を参照)。 これが指定されていない場合、デフォルトの動作は gRPC によって定義されます。 |
15.1.220. .spec.template.spec.initContainers[].startupProbe.httpGet リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 | |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。
使用可能な列挙値: - |
15.1.221. .spec.template.spec.initContainers[].startupProbe.httpGet.httpHeaders リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
15.1.222. .spec.template.spec.initContainers[].startupProbe.httpGet.httpHeaders[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
15.1.223. .spec.template.spec.initContainers[].startupProbe.tcpSocket リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
15.1.224. .spec.template.spec.initContainers[].volumeDevices リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- volumeDevices は、コンテナーによって使用されるブロックデバイスのリストです。
- 型
-
array
15.1.225. .spec.template.spec.initContainers[].volumeDevices[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- volumeDevice は、コンテナー内の raw ブロックデバイスのマッピングを記述します。
- 型
-
object
- 必須
-
name
-
devicePath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| devicePath は、デバイスがマップされるコンテナー内のパスです。 |
|
| name は、Pod 内の persistentVolumeClaim の名前と一致する必要があります |
15.1.226. .spec.template.spec.initContainers[].volumeMounts リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- コンテナーのファイルシステムにマウントする Pod ボリューム。これを更新することはできません。
- 型
-
array
15.1.227. .spec.template.spec.initContainers[].volumeMounts[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- VolumeMount は、コンテナー内でのボリュームのマウントを説明します。
- 型
-
object
- 必須
-
name
-
mountPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ボリュームをマウントする必要があるコンテナー内のパス。':' を含めることはできません。 |
|
| mountPropagation は、マウントがホストからコンテナーに、またはその逆にどのように伝播されるかを決定します。設定されていない場合、MountPropagationNone が使用されます。このフィールドは 1.10 のベータ版です。
使用可能な列挙値: - |
|
| ボリュームの名前に一致する必要があります。 |
|
| true の場合は読み取り専用、それ以外の場合は読み取り/書き込み (false または指定なし) でマウントされます。デフォルトは false です。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内のパス。デフォルトは "" (ボリュームのルート) です。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内の拡張パス。SubPath と同様に動作しますが、環境変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。デフォルトは "" (ボリュームのルート) です。SubPathExpr と SubPath は相互に排他的です。 |
15.1.228. .spec.template.spec.os リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodOS は、Pod の OS パラメーターを定義します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、オペレーティングシステムの名前です。現在サポートされている値は linux および windows です。今後、追加の値が定義される可能性があり、https://github.com/opencontainers/runtime-spec/blob/master/config.md#platform-specific-configuration のいずれかになります。クライアントは、追加の値を処理し、このフィールドで認識されない値を os: null として処理する必要があります。 |
15.1.229. .spec.template.spec.readinessGates リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 指定した場合、すべての準備ゲートが Pod の準備状況に対して評価されます。すべてのコンテナーの準備が整い、準備ゲートで指定されたすべての条件のステータスが "True" になると、Pod の準備が整います。詳細: https://git.k8s.io/enhancements/keps/sig-network/580-pod-readiness-gates
- 型
-
array
15.1.230. .spec.template.spec.readinessGates[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodReadinessGate には、Pod 条件への参照が含まれています
- 型
-
object
- 必須
-
conditionType
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ConditionType は、タイプが一致する Pod の条件リスト内の条件を参照します。 |
15.1.231. .spec.template.spec.resourceClaims リンクのコピーリンクがクリップボードにコピーされました!
- 説明
ResourceClaims は、Pod の起動を許可する前にどの ResourceClaim を割り当てて予約する必要があるかを定義します。リソースは、名前ベースでリソースを使用するコンテナーに提供されます。
これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。
このフィールドは不変です。
- 型
-
array
15.1.232. .spec.template.spec.resourceClaims[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodResourceClaim は、ClaimSource を介して 1 つの ResourceClaim のみを参照します。Pod 内の ResourceClaim を一意に識別する名前を追加します。ResourceClaim へのアクセスが必要なコンテナーは、この名前で参照します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は Pod 内でこのリソース要求を一意に識別します。これは DNS_LABEL である必要があります。 |
|
| ClaimSource は、ResourceClaim への参照を記述します。 これらのフィールドのうち 1 つだけを設定する必要があります。このタイプのコンシューマーは、不明な値が含まれているように、空のオブジェクトを処理する必要があります。 |
15.1.233. .spec.template.spec.resourceClaims[].source リンクのコピーリンクがクリップボードにコピーされました!
- 説明
ClaimSource は、ResourceClaim への参照を記述します。
これらのフィールドのうち 1 つだけを設定する必要があります。このタイプのコンシューマーは、不明な値が含まれているように、空のオブジェクトを処理する必要があります。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ResourceClaimName は、この Pod と同じ namespace にある ResourceClaim オブジェクトの名前です。 |
|
| ResourceClaimTemplateName は、この Pod と同じ namespace にある ResourceClaimTemplate オブジェクトの名前です。 テンプレートは、この Pod にバインドされる新規 ResourceClaim の作成に使用されます。この Pod が削除されると、ResourceClaim も削除されます。Pod 名とリソース名は、生成されたコンポーネントとともに、ResourceClaim の一意の名前を形成するために使用され、pod.status.resourceClaimStatuses に記録されます。 このフィールドは不変であり、ResourceClaim の作成後にコントロールプレーンによって対応する ResourceClaim に変更が加えられることはありません。 |
15.1.234. .spec.template.spec.schedulingGates リンクのコピーリンクがクリップボードにコピーされました!
- 説明
SchedulingGates は、指定されている場合に Pod のスケジューリングをブロックする不透明な値のリストです。schedulingGates が空でない場合、Pod は SchedulingGated 状態のままになり、スケジューラーは Pod のスケジュールを試行しません。
SchedulingGates を設定できるのは Pod の作成時にのみで、それ以降は削除されます。
これは、PodSchedulingReadiness フィーチャーゲートによって有効になるベータ機能です。
- 型
-
array
15.1.235. .spec.template.spec.schedulingGates[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodSchedulingGate は Pod に割り当てられ、そのスケジューリングを保護します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| スケジューリングゲートの名前。各スケジューリングゲートには一意の name フィールドが必要です。 |
15.1.236. .spec.template.spec.securityContext リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PodSecurityContext は、Pod レベルのセキュリティー属性と一般的なコンテナー設定を保持します。一部のフィールドは container.securityContext にも存在します。container.securityContext のフィールド値は、PodSecurityContext のフィールド値よりも優先されます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Pod の全コンテナーに適用される特別な補助グループです。一部のボリュームタイプでは、Kubelet がそのボリュームの所有権を Pod が所有するように変更できます。 1.所有する GID は FSGroup2 になります。setgid ビットが設定されます (ボリュームに作成された新しいファイルは FSGroup によって所有されます)3。許可ビットは rw-rw---- と OR 演算されます 設定されていないと、Kubelet はボリュームの所有権および権限を変更しません。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| fsGroupChangePolicy は、Pod 内部で公開する前にボリュームの所有権とアクセス権を変更する動作を定義します。このフィールドは、fsGroup ベースの所有権 (および権限) をサポートするボリュームタイプにのみ適用されます。secret、configmaps、emptydir などのエフェメラルボリュームタイプには影響しません。有効な値は "OnRootMismatch" と "Always" です。指定しない場合は "Always" を使用します。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
使用可能な列挙値: - |
|
| コンテナープロセスのエントリーポイントを実行するための GID。設定されていない場合は、実行時のデフォルトを使用します。SecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値がそのコンテナーに優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| コンテナーが root 以外のユーザーとして実行される必要があることを示します。true の場合、Kubelet は実行時にイメージを検証して、イメージが UID 0(ルート) として実行されないことを確認し、実行される場合はコンテナーの開始に失敗します。未設定または false の場合、そのような検証は実行されません。SecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。 |
|
| コンテナープロセスのエントリーポイントを実行するための UID。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。SecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値がそのコンテナーに優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| SELinuxOptions は、コンテナーに適用されるラベルです。 |
|
| SeccompProfile は、Pod/コンテナーの seccomp プロファイル設定を定義します。設定できるプロファイルソースは 1 つだけです。 |
|
| コンテナーのプライマリー GID、fsGroup (指定されている場合)、およびコンテナープロセスの uid に対してコンテナーイメージで定義されているグループメンバーシップに加えて、各コンテナーで実行される最初のプロセスに適用されるグループのリスト。指定しない場合、追加のグループはコンテナーに追加されません。コンテナープロセスの uid のコンテナーイメージで定義されたグループメンバーシップは、このリストに含まれていない場合でも引き続き有効であることに注意してください。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| Sysctl は、Pod に使用される namespace 付き sysctl のリストを保持します。(コンテナーランタイムによる) サポートされていない sysctl を持つ Pod は起動に失敗する可能性があります。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| Sysctl は、設定するカーネルパラメーターを定義します |
|
| WindowsSecurityContextOptions には、Windows 固有のオプションおよび認証情報が含まれています。 |
15.1.237. .spec.template.spec.securityContext.seLinuxOptions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SELinuxOptions は、コンテナーに適用されるラベルです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Level は、コンテナーに適用される SELinux レベルのラベルです。 |
|
| Role は、コンテナーに適用される SELinux ロールラベルです。 |
|
| Type は、コンテナーに適用される SELinux タイプのラベルです。 |
|
| User は、コンテナーに適用される SELinux ユーザーラベルです。 |
15.1.238. .spec.template.spec.securityContext.seccompProfile リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- SeccompProfile は、Pod/コンテナーの seccomp プロファイル設定を定義します。設定できるプロファイルソースは 1 つだけです。
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| localhostProfile は、ノード上のファイルで定義されたプロファイルを使用する必要があることを示します。プロファイルが機能するには、ノードで事前に設定されている必要があります。kubelet の設定済みの seccomp プロファイルの場所を基準にして、降順のパスである必要があります。タイプが "Localhost" の場合は設定する必要があります。他のタイプには設定しないでください。 |
|
| type は、適用される seccomp プロファイルの種類を示します。有効なオプションは以下のとおりです。 Localhost - ノード上のファイルで定義されたプロファイルを使用する必要があります。RuntimeDefault- コンテナーのランタイムデフォルトプロファイルを使用する必要があります。制限なし - プロファイルを適用しないでください。
使用可能な列挙値: - |
15.1.239. .spec.template.spec.securityContext.sysctls リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Sysctl は、Pod に使用される namespace 付き sysctl のリストを保持します。(コンテナーランタイムによる) サポートされていない sysctl を持つ Pod は起動に失敗する可能性があります。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
- 型
-
array
15.1.240. .spec.template.spec.securityContext.sysctls[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Sysctl は、設定するカーネルパラメーターを定義します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 設定するプロパティーの名前 |
|
| 設定するプロパティーの値 |
15.1.241. .spec.template.spec.securityContext.windowsOptions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- WindowsSecurityContextOptions には、Windows 固有のオプションおよび認証情報が含まれています。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| GMSACredentialSpec は、GMSA アドミッション Webhook (https://github.com/kubernetes-sigs/windows-gmsa) が GMSACredentialSpecName フィールドで指定された GMSA クレデンシャル仕様のコンテンツをインライン化する場所です。 |
|
| GMSACredentialSpecName は、使用する GMSA 認証情報仕様の名前です。 |
|
| hostProcess は、コンテナーを 'Host Process' コンテナーとして実行する必要があるかどうかを決定します。Pod のすべてのコンテナーは、同じ有効な HostProcess 値を持っている必要があります (HostProcess コンテナーと非 HostProcess コンテナーを混在させることはできません)。さらに、HostProcess が true の場合、HostNetwork も true に設定する必要があります。 |
|
| コンテナープロセスのエントリーポイントを実行するための Windows の UserName。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。 |
15.1.242. .spec.template.spec.tolerations リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 指定されている場合、Pod の許容範囲。
- 型
-
array
15.1.243. .spec.template.spec.tolerations[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- この toleration が割り当てられる Pod は、マッチング Operator <operator> を使用してトリプル <key,value,effect> と一致する taint を許容します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| effect は、照合するテイントの効果を示します。空の場合は、すべてのテイント効果に一致します。指定されている場合、許可される値は NoSchedule、PreferNoSchedule、および NoExecute です。
使用可能な列挙値: - |
|
| key は toleration が適用されるテイントキーです。空の場合は、すべてのテイントキーに一致します。キーが空の場合、Operator は Exists である必要があります。この組み合わせは、すべての値とすべてのキーに一致することを意味します。 |
|
| Operator はキーと値の関係を表します。有効な Operator は Exists および Equal です。デフォルトは Equal です。Exists は、値のワイルドカードと同等であるため、Pod は特定のカテゴリーのすべてのテイントに耐えることができます。
使用可能な列挙値: - |
|
| tolerationSeconds は、toleration (effect は NoExecute でなければならず、NoExecute 以外の場合このフィールドは無視されます) が taint を許容する期間を表します。デフォルトでは設定されていません。つまり、テイントを永久に許容します (エビクトしないでください)。ゼロ値と負の値は、システムによって 0 (すぐにエビクト) として扱われます。 |
|
| value は、toleration が一致するテイントの値です。Operator が Exists の場合、値は空である必要があります。それ以外の場合は、通常の文字列のみになります。 |
15.1.244. .spec.template.spec.topologySpreadConstraints リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TopologySpreadConstraints は、Pod のグループがトポロジードメイン全体にどのように分散するべきかを説明します。スケジューラーは、制約に従う方法で Pod をスケジュールします。すべての topologySpreadConstraints は AND 演算されます。
- 型
-
array
15.1.245. .spec.template.spec.topologySpreadConstraints[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- topologySpreadConstraint は、指定されたトポロジー間で一致する Pod を分散する方法を指定します。
- 型
-
object
- 必須
-
maxSkew
-
topologyKey
-
whenUnsatisfiable
-
プロパティー | 型 | 説明 |
---|---|---|
| LabelSelector は、一致する Pod を見つけるために使用されます。このラベルセレクターに一致する Pod は、対応するトポロジードメイン内の Pod の数を決定するためにカウントされます。 | |
|
| MatchLabelKeys は、分散を計算する Pod を選択するための Pod ラベルキーのセットです。このようなキーは受信 Pod のラベルから値を検索するために使用され、このキーと値のラベルは labelSelector と AND 演算されて、受信 Pod の分散が計算される既存の Pod のグループを選択します。同じキーが MatchLabelKeys と LabelSelector の両方に存在することはできません。LabelSelector が設定されていないと、MatchLabelKeys は設定できません。受信 Pod ラベルに存在しないキーは無視されます。null または空のリストは、labelSelector とのみ一致することを意味します。 これはベータフィールドであり、MatchLabelKeysInPodTopologySpread フィーチャーゲートを有効にする必要があります (デフォルトで有効)。 |
|
|
MaxSkew は、Pod が不均一に分布している可能性の程度を表します。 |
|
| 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 は、Pod トポロジーの分散スキューを計算するときに Pod の nodeAffinity/nodeSelector をどのように扱うかを示します。オプションは - Honor: nodeAffinity/nodeSelector に一致するノードのみが計算に含まれます。- Ignore: nodeAffinity/nodeSelector は無視されます。すべてのノードが計算に含まれます。 この値が nil の場合、この動作は Honor ポリシーと同じです。これは、NodeInclusionPolicyInPodTopologySpread 機能フラグによってデフォルトで有効になるベータレベルの機能です。
使用可能な列挙値: - |
|
| NodeTaintsPolicy は、Pod トポロジースプレッドスキューを計算するときにノードのテイントを処理する方法を示します。オプション: - Honor: テイントのないノードと、受信 Pod が許容範囲でテイントがあるノードが含まれます。- Ignore: ノードのテイントは無視されます。すべてのノードが含まれます。 この値が nil の場合、この動作は Ignore ポリシーと同じです。これは、NodeInclusionPolicyInPodTopologySpread 機能フラグによってデフォルトで有効になるベータレベルの機能です。
使用可能な列挙値: - |
|
| TopologyKey は、ノードラベルのキーです。このキーと同じ値のラベルを持つノードは、同じトポロジーにあると見なされます。各 <key, value> を "バケット" と見なし、バランスの取れた数の Pod を各バケットに配置しようとします。ドメインをトポロジーの特定のインスタンスとして定義します。また、ノードが nodeAffinityPolicy および nodeTaintsPolicy の要件を満たすドメインとして、適格なドメインを定義します。たとえば、TopologyKey が "kubernetes.io/hostname" の場合、各ノードはそのトポロジーのドメインです。また、TopologyKey が "topology.kubernetes.io/zone" の場合は、各ゾーンがそのトポロジーのドメインになります。必須フィールドです。 |
|
| 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) になります。つまり、クラスターは依然として不均衡である可能性がありますが、スケジューラーによってクラスターが さらに 不均衡になることはありません。必須フィールドです。
使用可能な列挙値: - |
15.1.246. .spec.template.spec.volumes リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod に属するコンテナーによってマウントできるボリュームのリスト。詳細: https://kubernetes.io/docs/concepts/storage/volumes
- 型
-
array
15.1.247. .spec.template.spec.volumes[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ボリュームは、Pod 内の任意のコンテナーからアクセスできる Pod 内の名前付きボリュームを表します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| AWS の永続ディスクリソースを表します。 AWS EBS ディスクは、コンテナーにマウントする前に存在している必要があります。また、ディスクは kubelet と同じ AWS ゾーンにある必要があります。AWS EBS ディスクは、読み取り/書き込みとして 1 回だけマウントできます。AWS EBS ボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。 |
|
| AzureDisk は、ホスト上の Azure Data Disk マウントを表し、Pod へのバインドマウントを表します。 |
|
| AzureFile は、ホスト上の Azure File Service マウントを表し、マウントを Pod にバインドします。 |
|
| Pod の存続期間中持続する Ceph ファイルシステムマウントを表します。Cephfs ボリュームは所有権管理または SELinux の再ラベル付けをサポートしていません。 |
|
| Openstack の cinder ボリュームリソースを表します。コンテナーにマウントする前に、Cinder ボリュームが存在している必要があります。ボリュームも、kubelet と同じ領域にある必要があります。Cinder ボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。 |
|
| ConfigMap をボリュームに適用します。 項目要素にパスへのキーの特定のマッピングが入力されていない限り、ターゲットの ConfigMap のデータフィールドの内容は、データフィールドのキーをファイル名として使用してファイルとしてボリュームに表示されます。ConfigMap ボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。 |
|
| 外部 CSI ドライバーによって管理される、マウントするボリュームのソースの場所を表します |
|
| DownwardAPIVolumeSource は、Downward API 情報を含むボリュームを表します。Downward API ボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。 |
|
| Pod の空のディレクトリーを表します。空のディレクトリーボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。 |
|
| 通常のストレージドライバーによって処理される一時的なボリュームを表します。 |
|
| ファイバーチャネルボリュームを表します。ファイバーチャネルボリュームは、読み取り/書き込みとして 1 回だけマウントできます。ファイバーチャネルボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。 |
|
| FlexVolume は、exec ベースのプラグインを使用してプロビジョニング/接続される汎用ボリュームリソースを表します。 |
|
| Flocker エージェントによってマウントされた Flocker ボリュームを表します。datasetName および datasetUUID の 1 つだけを設定する必要があります。Flocker ボリュームは、所有権管理または SELinux の再ラベル付けをサポートしていません。 |
|
| Google Compute Engine の永続ディスクリソースを表します。 GCE PD は、コンテナーにマウントする前に存在している必要があります。ディスクは、kubelet と同じ GCE プロジェクトおよびゾーンにある必要もあります。GCE PD は、読み取り/書き込みとして 1 回のみマウントできます。また、読み取り専用としては何度でもマウントできます。GCE PD は、所有権管理および SELinux の再ラベル付けをサポートします。 |
|
| git リポジトリーのコンテンツが入力されているボリュームを表します。Git リポジトリーボリュームは所有権管理をサポートしていません。Git リポジトリーボリュームは SELinux の再ラベル付けをサポートしています。 非推奨:GitRepo は非推奨です。git レポジトリを使用してコンテナーをプロビジョニングするには、Git を使用してレポジトリのクローンを作成する InitContainer に EmptyDir をマウントしてから、Pod のコンテナーに EmptyDir をマウントします。 |
|
| Pod の存続期間中続く Glusterfs マウントを表します。Glusterfs ボリュームは、所有権管理または SELinux の再ラベル付けをサポートしていません。 |
|
| Pod にマップされたホストパスを表します。ホストパスボリュームは、所有権管理または SELinux の再ラベル付けをサポートしていません。 |
|
| ISCSI ディスクを表します。ISCSI ボリュームは、読み取り/書き込みとして 1 回だけマウントできます。ISCSI ボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。 |
|
| ボリュームの名前。DNS_LABEL であり、Pod 内で一意である必要があります。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| Pod の存続期間中続く NFS マウントを表します。NFS ボリュームは、所有権管理または SELinux の再ラベル付けをサポートしていません。 |
|
| PersistentVolumeClaimVolumeSource は、同じ namespace 内のユーザーの PVC を参照します。このボリュームは、バインドされた PV を検出し、Pod 用にそのボリュームをマウントします。PersistentVolumeClaimVolumeSource は、基本的に、他の誰か (システム) が所有する別のタイプのボリュームのラッパーです。 |
|
| Photon Controller 永続ディスクリソースを表します。 |
|
| PortworxVolumeSource は、Portworx ボリュームリソースを表します。 |
|
| Projected ボリュームソースを表します |
|
| Pod の存続期間中続く Quobyte マウントを表します。Quobyte ボリュームは、所有権管理または SELinux の再ラベル付けをサポートしていません。 |
|
| Pod の存続時間中続く Rados Block Device マウントを表します。RBD ボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。 |
|
| ScaleIOVolumeSource は、永続的な ScaleIO ボリュームを表します |
|
| シークレットをボリュームに適合させます。 ターゲットシークレットの Data フィールドの内容は、ファイル名として Data フィールドのキーを使用してファイルとしてボリュームに表示されます。シークレットボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。 |
|
| StorageOS 永続ボリュームリソースを表します。 |
|
| vSphere ボリュームリソースを表します。 |
15.1.248. .spec.template.spec.volumes[].awsElasticBlockStore リンクのコピーリンクがクリップボードにコピーされました!
- 説明
AWS の永続ディスクリソースを表します。
AWS EBS ディスクは、コンテナーにマウントする前に存在している必要があります。また、ディスクは kubelet と同じ AWS ゾーンにある必要があります。AWS EBS ディスクは、読み取り/書き込みとして 1 回だけマウントできます。AWS EBS ボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。
- 型
-
object
- 必須
-
volumeID
-
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするボリュームのファイルシステムタイプです。ヒント: ファイルシステムタイプがホストオペレーティングシステムでサポートされていることを確認してください。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
|
| partition は、マウントするボリューム内のパーティションです。省略した場合、デフォルトではボリューム名でマウントします。例: ボリューム/dev/sda1 の場合、パーティションを "1" として指定します。同様に、/dev/sda のボリュームパーティションは "0" です (または、プロパティーを空のままにしておくこともできます)。 |
|
| readOnly 値 true は、VolumeMounts の readOnly 設定を強制的に実行します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
|
| volumeID は、AWS の永続ディスクリソースの一意の ID です (Amazon EBS ボリューム)。詳細: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
15.1.249. .spec.template.spec.volumes[].azureDisk リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- AzureDisk は、ホスト上の Azure Data Disk マウントを表し、Pod へのバインドマウントを表します。
- 型
-
object
- 必須
-
diskName
-
diskURI
-
プロパティー | 型 | 説明 |
---|---|---|
|
| cachingMode はホストキャッシュモードです (None, Read Only, Read Write)。
使用可能な列挙値: - |
|
| diskName は、Blob ストレージ内のデータディスクの名前です。 |
|
| diskURI は、Blob ストレージ内のデータディスクの URI です |
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。 |
|
| kind での期待値は、Shared (ストレージアカウントごとに複数のブロブディスク)、Dedicated (ストレージアカウントごとにブロブ 1 つ)、Managed (Azure の管理データディスク (管理対象のアベイラビリティーセットのみ)) です。デフォルトは Shared です。
使用可能な列挙値:- |
|
| readOnly。デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。 |
15.1.250. .spec.template.spec.volumes[].azureFile リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- AzureFile は、ホスト上の Azure File Service マウントを表し、マウントを Pod にバインドします。
- 型
-
object
- 必須
-
secretName
-
shareName
-
プロパティー | 型 | 説明 |
---|---|---|
|
| readOnly のデフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。 |
|
| secretName は、Azure ストレージアカウント名とキーを含むシークレットの名前です。 |
|
| shareName は Azure 共有名です。 |
15.1.251. .spec.template.spec.volumes[].cephfs リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod の存続期間中持続する Ceph ファイルシステムマウントを表します。Cephfs ボリュームは所有権管理または SELinux の再ラベル付けをサポートしていません。
- 型
-
object
- 必須
-
monitors
-
プロパティー | 型 | 説明 |
---|---|---|
|
| monitors は必須: Monitors は Ceph モニターのコレクションです。詳細: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
| パスは任意: 完全な Ceph ツリーではなく、マウントされたルートとして使用されます。デフォルトは / です。 |
|
| readOnly は任意: デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。詳細: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
| secretFile は任意: SecretFile はユーザーのキーリングへのパスです。デフォルトは /etc/ceph/user.secret です。詳細: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
| LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。 |
|
| user 任意: User は rados ユーザー名、デフォルトは admin です。詳細: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
15.1.252. .spec.template.spec.volumes[].cephfs.secretRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
15.1.253. .spec.template.spec.volumes[].cinder リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Openstack の cinder ボリュームリソースを表します。コンテナーにマウントする前に、Cinder ボリュームが存在している必要があります。ボリュームも、kubelet と同じ領域にある必要があります。Cinder ボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。
- 型
-
object
- 必須
-
volumeID
-
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。詳細: https://examples.k8s.io/mysql-cinder-pd/README.md |
|
| readOnly のデフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。詳細: https://examples.k8s.io/mysql-cinder-pd/README.md |
|
| LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。 |
|
| cinder 内のボリュームを識別するために使用される volumeID。詳細: https://examples.k8s.io/mysql-cinder-pd/README.md |
15.1.254. .spec.template.spec.volumes[].cinder.secretRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
15.1.255. .spec.template.spec.volumes[].configMap リンクのコピーリンクがクリップボードにコピーされました!
- 説明
ConfigMap をボリュームに適用します。
項目要素にパスへのキーの特定のマッピングが入力されていない限り、ターゲットの ConfigMap のデータフィールドの内容は、データフィールドのキーをファイル名として使用してファイルとしてボリュームに表示されます。ConfigMap ボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| defaultMode は任意: デフォルトで、作成されたファイルのアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。デフォルトは 0644 に設定されます。パス内のディレクトリーはこの設定の影響を受けません。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| item が指定されていない場合、参照される ConfigMap の Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。ConfigMap に存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。 |
|
| 文字列キーをボリューム内のパスにマップします。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 任意。ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
15.1.256. .spec.template.spec.volumes[].configMap.items リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- item が指定されていない場合、参照される ConfigMap の Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。ConfigMap に存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。
- 型
-
array
15.1.257. .spec.template.spec.volumes[].configMap.items[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 文字列キーをボリューム内のパスにマップします。
- 型
-
object
- 必須
-
key
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key はプロジェクトのキーです。 |
|
| mode は任意: このファイルにアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| path はキーをマップするファイルの相対パスです。絶対的なパスではない可能性があります。パス要素 '..' を含めることはできません。文字列 '..' で始まらない場合があります。 |
15.1.258. .spec.template.spec.volumes[].csi リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 外部 CSI ドライバーによって管理される、マウントするボリュームのソースの場所を表します
- 型
-
object
- 必須
-
driver
-
プロパティー | 型 | 説明 |
---|---|---|
|
| driver は、このボリュームを処理する CSI ドライバーの名前です。クラスターに登録されている正しい名前は、管理者に相談してください。 |
|
| マウントする fsType。例: "ext4"、"xfs"、"ntfs"。指定しない場合、空の値が関連する CSI ドライバーに渡され、適用するデフォルトのファイルシステムが決定されます。 |
|
| LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。 |
|
| readOnly は、ボリュームの読み取り専用設定を指定します。デフォルトは false (読み取り/書き込み) です。 |
|
| volumeAttributes は、CSI ドライバーに渡されるドライバー固有のプロパティーを格納します。サポートされている値は、ドライバーのドキュメントを参照してください。 |
15.1.259. .spec.template.spec.volumes[].csi.nodePublishSecretRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
15.1.260. .spec.template.spec.volumes[].downwardAPI リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DownwardAPIVolumeSource は、Downward API 情報を含むボリュームを表します。Downward API ボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: デフォルトで作成されたファイルで使用するモードビット。オプション: デフォルトで作成されたファイルのパーミッションを設定するために使用されるモードビット。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。デフォルトは 0644 に設定されます。パス内のディレクトリーはこの設定の影響を受けません。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| items は、Downward API ボリュームファイルのリストです |
|
| DownwardAPIVolumeFile は、Pod フィールドを含むファイルを作成するための情報を表します |
15.1.261. .spec.template.spec.volumes[].downwardAPI.items リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- items は、Downward API ボリュームファイルのリストです
- 型
-
array
15.1.262. .spec.template.spec.volumes[].downwardAPI.items[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DownwardAPIVolumeFile は、Pod フィールドを含むファイルを作成するための情報を表します
- 型
-
object
- 必須
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。 |
|
| オプション: このファイルの権限を設定するために使用されるモードビットは、0000 から 0777 までの 8 進数値、または 0 から 511 までの 10 進数値でなければなりません。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| 必須: パスは、作成するファイルの相対パス名です。絶対パスまたは '..' パスを含めることはできません。utf-8 でエンコードする必要があります。相対パスの最初の項目は '..' で始まってはなりません。 |
|
| ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。 |
15.1.263. .spec.template.spec.volumes[].downwardAPI.items[].fieldRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。
- 型
-
object
- 必須
-
fieldPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| FieldPath が記述されているスキーマのバージョン。デフォルトは "v1" です。 |
|
| 指定された API バージョンで選択するフィールドのパス。 |
15.1.264. .spec.template.spec.volumes[].downwardAPI.items[].resourceFieldRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。
- 型
-
object
- 必須
-
resource
-
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナー名: ボリュームには必須、env 変数にはオプション |
| 公開されたリソースの出力形式を指定します。デフォルトは "1" です。 | |
|
| 必須: 選択するリソース |
15.1.265. .spec.template.spec.volumes[].emptyDir リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod の空のディレクトリーを表します。空のディレクトリーボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| medium は、このディレクトリーをバックアップする必要があるストレージメディアのタイプを表します。デフォルトは"" です。これは、ノードのデフォルトのメディアを使用することを意味します。空の文字列 (デフォルト) またはメモリーである必要があります。詳細: https://kubernetes.io/docs/concepts/storage/volumes#emptydir |
| sizeLimit は、この EmptyDir ボリュームに必要なローカルストレージの合計量です。サイズ制限はメモリーメディアにも適用されます。メモリーメディア EmptyDir での最大使用量は、ここで指定された SizeLimit と Pod 内のすべてのコンテナーのメモリー制限の合計との間の最小値になります。デフォルトは nil です。これは、制限が未定義であることを意味します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#emptydir |
15.1.266. .spec.template.spec.volumes[].ephemeral リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 通常のストレージドライバーによって処理される一時的なボリュームを表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| PersistentVolumeClaimTemplate は、EphemeralVolumeSource の一部として PersistentVolumeClaim オブジェクトを生成するために使用されます。 |
15.1.267. .spec.template.spec.volumes[].ephemeral.volumeClaimTemplate リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PersistentVolumeClaimTemplate は、EphemeralVolumeSource の一部として PersistentVolumeClaim オブジェクトを生成するために使用されます。
- 型
-
object
- 必須
-
spec
-
プロパティー | 型 | 説明 |
---|---|---|
| PVC の作成時に PVC にコピーされるラベルとアノテーションが含まれる場合があります。他のフィールドは許可されておらず、検証中に拒否されます。 | |
|
| PersistentVolumeClaimSpec は、ストレージデバイスの一般的な属性を記述し、プロバイダー固有の属性のソースを許可します |
15.1.268. .spec.template.spec.volumes[].ephemeral.volumeClaimTemplate.spec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PersistentVolumeClaimSpec は、ストレージデバイスの一般的な属性を記述し、プロバイダー固有の属性のソースを許可します
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| accessModes には、ボリュームに割り当てる必要のあるアクセスモードが含まれます。詳細は、https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 を参照してください。 |
|
| TypedLocalObjectReference には、同じ namespace 内で typed 参照オブジェクトを見つけるのに十分な情報が含まれます。 |
|
| dataSourceRef は、空でないボリュームが必要な場合は、ボリュームにデータを取り込むオブジェクトを指定します。これには、空ではない API グループ (コアオブジェクトではない) または PersistentVolumeClaim オブジェクトの任意のオブジェクトを指定できます。このフィールドが指定されている場合、ボリュームバインディングは、指定されたオブジェクトのタイプが、インストールされているボリュームポピュレーターまたはダイナミックプロビジョナーと一致する場合にのみ成功します。このフィールドは、dataSource フィールドの機能を置き換えるため、両方のフィールドが空でない場合は、同じ値である必要があります。下位互換性を確保するために、dataSourceRef で namespace が指定されておらず、一方が空でもう一方が空でない場合、両方のフィールド (dataSource と dataSourceRef) が自動的に同じ値に設定されます。dataSourceRef で namespace が指定されている場合、dataSource は同じ値に設定されていないため、空にする必要があります。dataSource と dataSourceRef には 3 つの重要な違いがあります。* dataSource では 2 つの特定のタイプのオブジェクトのみが使用できますが、dataSourceRef ではコアオブジェクト以外および PersistentVolumeClaim オブジェクトを使用できます。* dataSource は使用できない値を無視 (ドロップ) しますが、dataSourceRef はすべての値を保持し、使用できない値が指定された場合はエラーを生成します。* dataSource ではローカルオブジェクトのみが使用できますが、dataSourceRef では任意の namespace のオブジェクトを使用できます。(ベータ版) このフィールドを使用するには、AnyVolumeDataSource フィーチャーゲートを有効にする必要があります。(アルファ版) dataSourceRef の namespace フィールドを使用するには、CrossNamespaceVolumeDataSource フィーチャーゲートを有効にする必要があります。 |
|
| ResourceRequirements は、コンピュートリソースの要件を説明します。 |
| selector は、バインドを考慮するボリュームに対するラベルクエリーです。 | |
|
| storageClassName は、要求に必要な StorageClass の名前です。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1 |
|
| volumeMode は、要求に必要なボリュームのタイプを定義します。Filesystem の値は、要求仕様に含まれていない場合に暗示されます。
使用可能な列挙値: - |
|
| volumeName は、この要求をサポートする PersistentVolume へのバインディング参照です。 |
15.1.269. .spec.template.spec.volumes[].ephemeral.volumeClaimTemplate.spec.dataSource リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- TypedLocalObjectReference には、同じ namespace 内で typed 参照オブジェクトを見つけるのに十分な情報が含まれます。
- 型
-
object
- 必須
-
kind
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| APIGroup は参照されているリソースのグループです。APIGroup が指定されていない場合は、指定の Kind をコア API グループに設定する必要があります。他のサードパーティータイプには、APIGroup が必要です。 |
|
| kind は参照されているリソースのタイプです。 |
|
| name は、参照されているリソースの名前です。 |
15.1.270. .spec.template.spec.volumes[].ephemeral.volumeClaimTemplate.spec.dataSourceRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- dataSourceRef は、空でないボリュームが必要な場合は、ボリュームにデータを取り込むオブジェクトを指定します。これには、空ではない API グループ (コアオブジェクトではない) または PersistentVolumeClaim オブジェクトの任意のオブジェクトを指定できます。このフィールドが指定されている場合、ボリュームバインディングは、指定されたオブジェクトのタイプが、インストールされているボリュームポピュレーターまたはダイナミックプロビジョナーと一致する場合にのみ成功します。このフィールドは、dataSource フィールドの機能を置き換えるため、両方のフィールドが空でない場合は、同じ値である必要があります。下位互換性を確保するために、dataSourceRef で namespace が指定されておらず、一方が空でもう一方が空でない場合、両方のフィールド (dataSource と dataSourceRef) が自動的に同じ値に設定されます。dataSourceRef で namespace が指定されている場合、dataSource は同じ値に設定されていないため、空にする必要があります。dataSource と dataSourceRef には 3 つの重要な違いがあります。* dataSource では 2 つの特定のタイプのオブジェクトのみが使用できますが、dataSourceRef ではコアオブジェクト以外および PersistentVolumeClaim オブジェクトを使用できます。* dataSource は使用できない値を無視 (ドロップ) しますが、dataSourceRef はすべての値を保持し、使用できない値が指定された場合はエラーを生成します。* dataSource ではローカルオブジェクトのみが使用できますが、dataSourceRef では任意の namespace のオブジェクトを使用できます。(ベータ版) このフィールドを使用するには、AnyVolumeDataSource フィーチャーゲートを有効にする必要があります。(アルファ版) dataSourceRef の namespace フィールドを使用するには、CrossNamespaceVolumeDataSource フィーチャーゲートを有効にする必要があります。
- 型
-
object
- 必須
-
kind
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| APIGroup は参照されているリソースのグループです。APIGroup が指定されていない場合は、指定の Kind をコア API グループに設定する必要があります。他のサードパーティータイプには、APIGroup が必要です。 |
|
| kind は参照されているリソースのタイプです。 |
|
| name は、参照されているリソースの名前です。 |
|
| Namespace は、参照されるリソースの namespace です。namespace が指定されている場合は、その namespace の所有者が参照を受け入れることができるように、参照された namespace に gateway.networking.k8s.io/ReferenceGrant オブジェクトが必要であることに注意してください。詳細は、ReferenceGrant ドキュメントを参照してください。(アルファ版) このフィールドでは、CrossNamespaceVolumeDataSource フィーチャーゲートを有効にする必要があります。 |
15.1.271. .spec.template.spec.volumes[].ephemeral.volumeClaimTemplate.spec.resources リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceRequirements は、コンピュートリソースの要件を説明します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。 これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。 このフィールドは不変です。これはコンテナーにのみ設定できます。 |
|
| ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。 |
| limits は、許可されるコンピュートリソースの最大量を示します。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 | |
| requests は、必要なコンピュートリソースの最小量を示します。コンテナーで Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
15.1.272. .spec.template.spec.volumes[].ephemeral.volumeClaimTemplate.spec.resources.claims リンクのコピーリンクがクリップボードにコピーされました!
- 説明
Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。
これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。
このフィールドは不変です。これはコンテナーにのみ設定できます。
- 型
-
array
15.1.273. .spec.template.spec.volumes[].ephemeral.volumeClaimTemplate.spec.resources.claims[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。 |
15.1.274. .spec.template.spec.volumes[].fc リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ファイバーチャネルボリュームを表します。ファイバーチャネルボリュームは、読み取り/書き込みとして 1 回だけマウントできます。ファイバーチャネルボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。 |
|
| LUN は任意: FC ターゲットの LUN 番号 |
|
| readOnly は任意: デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。 |
|
| targetWWNs は任意: FC ターゲットのワールドワイド名 (WWN) |
|
| wwids は任意: FC ボリュームのワールドワイド ID(wwids)wwids または targetWWN と lun の組み合わせのいずれかを設定する必要がありますが、両方を同時に設定できません。 |
15.1.275. .spec.template.spec.volumes[].flexVolume リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- FlexVolume は、exec ベースのプラグインを使用してプロビジョニング/接続される汎用ボリュームリソースを表します。
- 型
-
object
- 必須
-
driver
-
プロパティー | 型 | 説明 |
---|---|---|
|
| driver は、このボリュームに使用するドライバーの名前です。 |
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。デフォルトのファイルシステムは FlexVolume スクリプトに依存します。 |
|
| options は任意: このフィールドには追加のコマンドオプションがあれば保持されます。 |
|
| readOnly は任意: デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。 |
|
| LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。 |
15.1.276. .spec.template.spec.volumes[].flexVolume.secretRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
15.1.277. .spec.template.spec.volumes[].flocker リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Flocker エージェントによってマウントされた Flocker ボリュームを表します。datasetName および datasetUUID の 1 つだけを設定する必要があります。Flocker ボリュームは、所有権管理または SELinux の再ラベル付けをサポートしていません。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| datasetName はメタデータとして保存されているデータセットの名前です → Flocker のデータセット上の名前は非推奨として扱うようにしてください。 |
|
| datasetUUID は、データセットの UUID です。これは Flocker データセットの一意の識別子です |
15.1.278. .spec.template.spec.volumes[].gcePersistentDisk リンクのコピーリンクがクリップボードにコピーされました!
- 説明
Google Compute Engine の永続ディスクリソースを表します。
GCE PD は、コンテナーにマウントする前に存在している必要があります。ディスクは、kubelet と同じ GCE プロジェクトおよびゾーンにある必要もあります。GCE PD は、読み取り/書き込みとして 1 回のみマウントできます。また、読み取り専用としては何度でもマウントできます。GCE PD は、所有権管理および SELinux の再ラベル付けをサポートします。
- 型
-
object
- 必須
-
pdName
-
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするボリュームのファイルシステムタイプです。ヒント: ファイルシステムタイプがホストオペレーティングシステムでサポートされていることを確認してください。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
| partition は、マウントするボリューム内のパーティションです。省略した場合、デフォルトではボリューム名でマウントします。例: ボリューム/dev/sda1 の場合、パーティションを "1" として指定します。同様に、/dev/sda のボリュームパーティションは "0" です (または、プロパティーを空のままにしておくこともできます)。詳細: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
| pdName は、GCE の PD リソースの一意の名前です。GCE でディスクを識別するために使用されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
| この readOnly は、VolumeMounts で ReadOnly 設定が強制的に指定されます。デフォルトは false です。詳細: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
15.1.279. .spec.template.spec.volumes[].gitRepo リンクのコピーリンクがクリップボードにコピーされました!
- 説明
git リポジトリーのコンテンツが入力されているボリュームを表します。Git リポジトリーボリュームは所有権管理をサポートしていません。Git リポジトリーボリュームは SELinux の再ラベル付けをサポートしています。
非推奨:GitRepo は非推奨です。git レポジトリを使用してコンテナーをプロビジョニングするには、Git を使用してレポジトリのクローンを作成する InitContainer に EmptyDir をマウントしてから、Pod のコンテナーに EmptyDir をマウントします。
- 型
-
object
- 必須
-
repository
-
プロパティー | 型 | 説明 |
---|---|---|
|
| directory は、ターゲットディレクトリー名です。'..' を含まない、または..で始まらないようにする必要があります。もしも '。' が提供されている場合、ボリュームディレクトリーは git リポジトリーになります。それ以外の場合、指定されている場合、ボリュームには、指定された名前のサブディレクトリーに git リポジトリーが含まれます。 |
|
| repository は URL です。 |
|
| revision は、指定されたリビジョンのコミットハッシュです。 |
15.1.280. .spec.template.spec.volumes[].glusterfs リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod の存続期間中続く Glusterfs マウントを表します。Glusterfs ボリュームは、所有権管理または SELinux の再ラベル付けをサポートしていません。
- 型
-
object
- 必須
-
endpoints
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| endpoints は、Glusterfs トポロジーの詳細を示すエンドポイント名です。詳細: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
|
| path は Glusterfs ボリュームパスです。詳細: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
|
| この readOnly は、Glusterfs ボリュームを読み取り専用のアクセス権限で強制的にマウントします。デフォルトは false です。詳細: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
15.1.281. .spec.template.spec.volumes[].hostPath リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod にマップされたホストパスを表します。ホストパスボリュームは、所有権管理または SELinux の再ラベル付けをサポートしていません。
- 型
-
object
- 必須
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ホスト上のディレクトリーのパス。パスがシンボリックリンクの場合、実際のパスへのリンクをたどります。詳細: https://kubernetes.io/docs/concepts/storage/volumes#hostpath |
|
| HostPath ボリュームのデフォルトのタイプは "" です。詳細: https://kubernetes.io/docs/concepts/storage/volumes#hostpath
使用可能な列挙値: - |
15.1.282. .spec.template.spec.volumes[].iscsi リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ISCSI ディスクを表します。ISCSI ボリュームは、読み取り/書き込みとして 1 回だけマウントできます。ISCSI ボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。
- 型
-
object
- 必須
-
targetPortal
-
iqn
-
lun
-
プロパティー | 型 | 説明 |
---|---|---|
|
| chapAuthDiscovery は、iSCSI 検出 CHAP 認証をサポートするかどうかを定義します。 |
|
| chapAuthSession は、iSCSI セッション CHAP 認証をサポートするかどうかを定義します。 |
|
| fsType は、マウントするボリュームのファイルシステムタイプです。ヒント: ファイルシステムタイプがホストオペレーティングシステムでサポートされていることを確認してください。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes#iscsi |
|
| initiatorName は、カスタムの iSCSI イニシエーター名です。iscsiInterface と同時に initiatorName を指定すると、接続用に新しい iSCSI インターフェイス <target portal>:<volume name> が作成されます。 |
|
| iqn は、ターゲットの iSCSI 修飾名です。 |
|
| iscsiInterface は、iSCSI トランスポートを使用するインターフェイス名です。デフォルトは 'default' (tcp) です。 |
|
| lun は、iSCSI ターゲット Lun 番号を表します。 |
|
| ポータルは iSCSI ターゲットポータルリストです。ポートがデフォルト以外の場合、ポータルは IP または ip_addr:port のいずれかです (通常は TCP ポート 860 および 3260)。 |
|
| この readOnly は、VolumeMounts で ReadOnly 設定が強制的に指定されます。デフォルトは false です。 |
|
| LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。 |
|
| targetPortal は iSCSI Target Portal です。ポートがデフォルト以外の場合、ポータルは IP または ip_addr:port のいずれかです (通常は TCP ポート 860 および 3260)。 |
15.1.283. .spec.template.spec.volumes[].iscsi.secretRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
15.1.284. .spec.template.spec.volumes[].nfs リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod の存続期間中続く NFS マウントを表します。NFS ボリュームは、所有権管理または SELinux の再ラベル付けをサポートしていません。
- 型
-
object
- 必須
-
server
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| NFS サーバーがエクスポートしているパス。詳細: https://kubernetes.io/docs/concepts/storage/volumes#nfs |
|
| ここで readOnly を指定すると、NFS エクスポートが読み取り専用権限で強制的にマウントされます。デフォルトは false です。詳細: https://kubernetes.io/docs/concepts/storage/volumes#nfs |
|
| server は、NFS サーバーのホスト名または IP アドレスです。詳細: https://kubernetes.io/docs/concepts/storage/volumes#nfs |
15.1.285. .spec.template.spec.volumes[].persistentVolumeClaim リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PersistentVolumeClaimVolumeSource は、同じ namespace 内のユーザーの PVC を参照します。このボリュームは、バインドされた PV を検出し、Pod 用にそのボリュームをマウントします。PersistentVolumeClaimVolumeSource は、基本的に、他の誰か (システム) が所有する別のタイプのボリュームのラッパーです。
- 型
-
object
- 必須
-
claimName
-
プロパティー | 型 | 説明 |
---|---|---|
|
| claimName は、このボリュームを使用する Pod と同じ namespace にある PersistentVolumeClaim の名前です。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims |
|
| readOnly は、VolumeMounts の ReadOnly 設定が強制的に指定されます。デフォルト: false |
15.1.286. .spec.template.spec.volumes[].photonPersistentDisk リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Photon Controller 永続ディスクリソースを表します。
- 型
-
object
- 必須
-
pdID
-
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。 |
|
| pdID は、Photon Controller の永続ディスクを識別する ID です。 |
15.1.287. .spec.template.spec.volumes[].portworxVolume リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- PortworxVolumeSource は、Portworx ボリュームリソースを表します。
- 型
-
object
- 必須
-
volumeID
-
プロパティー | 型 | 説明 |
---|---|---|
|
| fSType は、マウントするファイルシステムタイプを表します。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。 |
|
| readOnly のデフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。 |
|
| volumeID は、Portworx ボリュームを一意に識別します |
15.1.288. .spec.template.spec.volumes[].projected リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Projected ボリュームソースを表します
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| defaultMode は、作成されたファイルにデフォルトでアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。パス内のディレクトリーはこの設定の影響を受けません。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| source は、ボリュームプロジェクションのリストです。 |
|
| サポートされている他のボリュームタイプと一緒にデプロイメントされる可能性のあるプロジェクション |
15.1.289. .spec.template.spec.volumes[].projected.sources リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- source は、ボリュームプロジェクションのリストです。
- 型
-
array
15.1.290. .spec.template.spec.volumes[].projected.sources[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- サポートされている他のボリュームタイプと一緒にデプロイメントされる可能性のあるプロジェクション
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ConfigMap をデプロイメントされたボリュームに適合させます。 項目要素にパスへのキーの特定のマッピングが入力されていない限り、ターゲットの ConfigMap のデータフィールドの内容は、データフィールドのキーをファイル名として使用してファイルとしてデプロイメントされるボリュームに表示されます。これは、デフォルトモードのない configmap ボリュームソースと同じであることに注意してください。 |
|
| デプロイメントされたボリュームにデプロイメントするための Downward API 情報を表します。これは、デフォルトモードのない downwardAPI ボリュームソースと同じであることに注意してください。 |
|
| シークレットを、デプロイメントされたボリュームに適合させます。 ターゲットシークレットの Data フィールドの内容は、ファイル名として Data フィールドのキーを使用して、ファイルとしてデプロイメントされたボリュームに表示されます。これは、デフォルトモードのないシークレットボリュームソースと同じであることに注意してください。 |
|
| ServiceAccountTokenProjection は、デプロイメントされるサービスアカウントトークンボリュームを表します。このプロジェクションを使用して、API (Kubernetes API サーバーなど) に対して使用するサービスアカウントトークンを Pod ランタイムファイルシステムに挿入できます。 |
15.1.291. .spec.template.spec.volumes[].projected.sources[].configMap リンクのコピーリンクがクリップボードにコピーされました!
- 説明
ConfigMap をデプロイメントされたボリュームに適合させます。
項目要素にパスへのキーの特定のマッピングが入力されていない限り、ターゲットの ConfigMap のデータフィールドの内容は、データフィールドのキーをファイル名として使用してファイルとしてデプロイメントされるボリュームに表示されます。これは、デフォルトモードのない configmap ボリュームソースと同じであることに注意してください。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| item が指定されていない場合、参照される ConfigMap の Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。ConfigMap に存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。 |
|
| 文字列キーをボリューム内のパスにマップします。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 任意。ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
15.1.292. .spec.template.spec.volumes[].projected.sources[].configMap.items リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- item が指定されていない場合、参照される ConfigMap の Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。ConfigMap に存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。
- 型
-
array
15.1.293. .spec.template.spec.volumes[].projected.sources[].configMap.items[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 文字列キーをボリューム内のパスにマップします。
- 型
-
object
- 必須
-
key
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key はプロジェクトのキーです。 |
|
| mode は任意: このファイルにアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| path はキーをマップするファイルの相対パスです。絶対的なパスではない可能性があります。パス要素 '..' を含めることはできません。文字列 '..' で始まらない場合があります。 |
15.1.294. .spec.template.spec.volumes[].projected.sources[].downwardAPI リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- デプロイメントされたボリュームにデプロイメントするための Downward API 情報を表します。これは、デフォルトモードのない downwardAPI ボリュームソースと同じであることに注意してください。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Items は DownwardAPIVolume ファイルのリストです |
|
| DownwardAPIVolumeFile は、Pod フィールドを含むファイルを作成するための情報を表します |
15.1.295. .spec.template.spec.volumes[].projected.sources[].downwardAPI.items リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Items は DownwardAPIVolume ファイルのリストです
- 型
-
array
15.1.296. .spec.template.spec.volumes[].projected.sources[].downwardAPI.items[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- DownwardAPIVolumeFile は、Pod フィールドを含むファイルを作成するための情報を表します
- 型
-
object
- 必須
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。 |
|
| オプション: このファイルの権限を設定するために使用されるモードビットは、0000 から 0777 までの 8 進数値、または 0 から 511 までの 10 進数値でなければなりません。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| 必須: パスは、作成するファイルの相対パス名です。絶対パスまたは '..' パスを含めることはできません。utf-8 でエンコードする必要があります。相対パスの最初の項目は '..' で始まってはなりません。 |
|
| ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。 |
15.1.297. .spec.template.spec.volumes[].projected.sources[].downwardAPI.items[].fieldRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。
- 型
-
object
- 必須
-
fieldPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| FieldPath が記述されているスキーマのバージョン。デフォルトは "v1" です。 |
|
| 指定された API バージョンで選択するフィールドのパス。 |
15.1.298. .spec.template.spec.volumes[].projected.sources[].downwardAPI.items[].resourceFieldRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。
- 型
-
object
- 必須
-
resource
-
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナー名: ボリュームには必須、env 変数にはオプション |
| 公開されたリソースの出力形式を指定します。デフォルトは "1" です。 | |
|
| 必須: 選択するリソース |
15.1.299. .spec.template.spec.volumes[].projected.sources[].secret リンクのコピーリンクがクリップボードにコピーされました!
- 説明
シークレットを、デプロイメントされたボリュームに適合させます。
ターゲットシークレットの Data フィールドの内容は、ファイル名として Data フィールドのキーを使用して、ファイルとしてデプロイメントされたボリュームに表示されます。これは、デフォルトモードのないシークレットボリュームソースと同じであることに注意してください。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| items が指定されていない場合、参照されるシークレットの Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。シークレットに存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。 |
|
| 文字列キーをボリューム内のパスにマップします。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| オプションフィールドは、シークレットかそのキーを定義する必要があるかどうかを指定します。 |
15.1.300. .spec.template.spec.volumes[].projected.sources[].secret.items リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- items が指定されていない場合、参照されるシークレットの Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。シークレットに存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。
- 型
-
array
15.1.301. .spec.template.spec.volumes[].projected.sources[].secret.items[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 文字列キーをボリューム内のパスにマップします。
- 型
-
object
- 必須
-
key
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key はプロジェクトのキーです。 |
|
| mode は任意: このファイルにアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| path はキーをマップするファイルの相対パスです。絶対的なパスではない可能性があります。パス要素 '..' を含めることはできません。文字列 '..' で始まらない場合があります。 |
15.1.302. .spec.template.spec.volumes[].projected.sources[].serviceAccountToken リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ServiceAccountTokenProjection は、デプロイメントされるサービスアカウントトークンボリュームを表します。このプロジェクションを使用して、API (Kubernetes API サーバーなど) に対して使用するサービスアカウントトークンを Pod ランタイムファイルシステムに挿入できます。
- 型
-
object
- 必須
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| audience は、トークンの対象オーディエンスです。トークンの受信者は、トークンのオーディエンスで指定された識別子で自分自身を識別する必要があります。そうでない場合は、トークンを拒否する必要があります。対象はデフォルトで API サーバーの識別子に設定されます。 |
|
| expirationSeconds は、サービスアカウントトークンの要求された有効期間です。トークンの有効期限が近づくと、kubelet ボリュームプラグインはサービスアカウントトークンをプロアクティブにローテーションします。トークンが存続時間の 80% より古い場合、またはトークンが 24 時間より古い場合、kubelet はトークンのローテーションを開始します。デフォルトは 1 時間で、少なくとも 10 分である必要があります。 |
|
| path は、トークンのデプロイメント先となるファイルのマウントポイントに対する相対パスです。 |
15.1.303. .spec.template.spec.volumes[].quobyte リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod の存続期間中続く Quobyte マウントを表します。Quobyte ボリュームは、所有権管理または SELinux の再ラベル付けをサポートしていません。
- 型
-
object
- 必須
-
registry
-
volume
-
プロパティー | 型 | 説明 |
---|---|---|
|
| アクセスできるボリュームをマップするグループ。デフォルトは no group です。 |
|
| ここでの readOnly は、Quobyte ボリュームを読み取り専用のアクセス権限で強制的にマウントします。デフォルトは false です。 |
|
| registry は、host:port ペアの文字列として指定された単一または複数の Quobyte Registry サービスを表し (複数のエントリーはコンマで区切る)、ボリュームの中央レジストリーとして機能します。 |
|
| 動的にプロビジョニングされた Quobyte ボリュームで使用されるバックエンドで指定の Quobyte ボリュームを所有するテナント。値はプラグインにより設定されます。 |
|
| アクセスできるボリュームをマップするグループ。デフォルトは serivceaccount user です。 |
|
| volume は、すでに作成されているクオバイトボリュームを名前で参照する文字列です。 |
15.1.304. .spec.template.spec.volumes[].rbd リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- Pod の存続時間中続く Rados Block Device マウントを表します。RBD ボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。
- 型
-
object
- 必須
-
monitors
-
image
-
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするボリュームのファイルシステムタイプです。ヒント: ファイルシステムタイプがホストオペレーティングシステムでサポートされていることを確認してください。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes#rbd |
|
| image は rados イメージ名です。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| keyring は、RBDUser のキーリングへのパスです。デフォルトは/etc/ceph/keyring です。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| monitors は Ceph モニターのコレクションです。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| pool は rados プール名です。デフォルトは rbd です。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| この readOnly は、VolumeMounts で ReadOnly 設定が強制的に指定されます。デフォルトは false です。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。 |
|
| user は rados ユーザー名です。これにより、プール内にイメージを作成できます。デフォルトは admin です。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
15.1.305. .spec.template.spec.volumes[].rbd.secretRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
15.1.306. .spec.template.spec.volumes[].scaleIO リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ScaleIOVolumeSource は、永続的な ScaleIO ボリュームを表します
- 型
-
object
- 必須
-
gateway
-
system
-
secretRef
-
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。デフォルトは "xfs" です。 |
|
| gateway は、ScaleIO API ゲートウェイのホストアドレスです。 |
|
| protectionDomain は、設定されたストレージの ScaleIO 保護ドメインの名前です。 |
|
| readOnly。デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。 |
|
| LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。 |
|
| sslEnabled Flag は、ゲートウェイとの SSL 通信を有効/無効にします。デフォルトは false です |
|
| storageMode は、ボリュームのストレージを ThickProvisioned にするか ThinProvisioned にするかを示します。デフォルトは ThinProvisioned です。 |
|
| storagePool は、保護ドメインに関連付けられた ScaleIO ストレージプールです。 |
|
| system は、ScaleIO で設定されたストレージシステムの名前です。 |
|
| volumeName は、このボリュームソースに関連付けられている、ScaleIO システムですでに作成されているボリュームの名前です。 |
15.1.307. .spec.template.spec.volumes[].scaleIO.secretRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
15.1.308. .spec.template.spec.volumes[].secret リンクのコピーリンクがクリップボードにコピーされました!
- 説明
シークレットをボリュームに適合させます。
ターゲットシークレットの Data フィールドの内容は、ファイル名として Data フィールドのキーを使用してファイルとしてボリュームに表示されます。シークレットボリュームは、所有権管理および SELinux の再ラベル付けをサポートします。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| defaultMode は任意: デフォルトで、作成されたファイルのアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。デフォルトは 0644 に設定されます。パス内のディレクトリーはこの設定の影響を受けません。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| items が指定されていない場合、参照されるシークレットの Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。シークレットに存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。 |
|
| 文字列キーをボリューム内のパスにマップします。 |
|
| optional フィールド。シークレットかそのキーを定義する必要があるかどうかを指定します。 |
|
| secretName は、使用する Pod の namespace 内のシークレットの名前です。詳細: https://kubernetes.io/docs/concepts/storage/volumes#secret |
15.1.309. .spec.template.spec.volumes[].secret.items リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- items が指定されていない場合、参照されるシークレットの Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。シークレットに存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。
- 型
-
array
15.1.310. .spec.template.spec.volumes[].secret.items[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- 文字列キーをボリューム内のパスにマップします。
- 型
-
object
- 必須
-
key
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key はプロジェクトのキーです。 |
|
| mode は任意: このファイルにアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| path はキーをマップするファイルの相対パスです。絶対的なパスではない可能性があります。パス要素 '..' を含めることはできません。文字列 '..' で始まらない場合があります。 |
15.1.311. .spec.template.spec.volumes[].storageos リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- StorageOS 永続ボリュームリソースを表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。 |
|
| readOnly のデフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。 |
|
| LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。 |
|
| volumeName は、人間が判読えきる形式の StorageOS ボリュームの名前です。ボリューム名は namespace 内でのみ一意です。 |
|
| volumeNamespace は、StorageOS 内のボリュームのスコープを指定します。namespace が指定されていない場合は、Pod の namespace が使用されます。これにより、Kubernetes の名前スコープを StorageOS 内にミラーリングして、より緊密に統合することができます。VolumeName を任意の名前に設定して、デフォルトの動作をオーバーライドします。StorageOS 内で namespace を使用していない場合は、"デフォルト" に設定します。StorageOS 内に存在しない namespace が作成されます。 |
15.1.312. .spec.template.spec.volumes[].storageos.secretRef リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
15.1.313. .spec.template.spec.volumes[].vsphereVolume リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- vSphere ボリュームリソースを表します。
- 型
-
object
- 必須
-
volumePath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。 |
|
| storagePolicyID は、StoragePolicyName に関連付けられたストレージポリシーベースの管理 (SPBM) プロファイル ID です。 |
|
| storagePolicyName は、ストレージポリシーベースの管理 (SPBM) プロファイル名です。 |
|
| volumePath は、vSphere ボリューム vmdk を識別するパスです。 |
15.1.314. .status リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ReplicationControllerStatus は、レプリケーションコントローラーの現在のステータスを表します。
- 型
-
object
- 必須
-
replicas
-
プロパティー | 型 | 説明 |
---|---|---|
|
| このレプリケーションコントローラーで使用可能なレプリカの数 (少なくとも minReadySeconds の準備ができている)。 |
|
| レプリケーションコントローラーの現在の状態に関する最新の利用可能な観測を表します。 |
|
| ReplicationControllerCondition は、特定の時点でのレプリケーションコントローラーの状態を記述します。 |
|
| レプリケーションコントローラーの Pod テンプレートのラベルと一致するラベルを持つ Pod の数。 |
|
| ObservedGeneration は、最後に監視されたレプリケーションコントローラーの生成を反映します。 |
|
| このレプリケーションコントローラーの準備ができているレプリカの数。 |
|
| レプリカは、最近観察されたレプリカの数です。詳細: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller#what-is-a-replicationcontroller |
15.1.315. .status.conditions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- レプリケーションコントローラーの現在の状態に関する最新の利用可能な観測を表します。
- 型
-
array
15.1.316. .status.conditions[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ReplicationControllerCondition は、特定の時点でのレプリケーションコントローラーの状態を記述します。
- 型
-
object
- 必須
-
type
-
status
-
プロパティー | 型 | 説明 |
---|---|---|
| time | 最後にある状態から別の状態に遷移した時間。 |
|
| 遷移の詳細を示す人が判読できるメッセージ。 |
|
| 条件の最後の遷移の理由。 |
|
| 状態のステータス (True、False、Unknown のいずれか)。 |
|
| レプリケーションコントローラーの状態のタイプ。 |
15.2. API エンドポイント リンクのコピーリンクがクリップボードにコピーされました!
以下の API エンドポイントを利用できます。
/api/v1/replicationcontrollers
-
GET
: ReplicationController 種類のオブジェクトをリスト表示または監視する
-
/api/v1/watch/replicationcontrollers
-
GET
: ReplicationController のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
-
/api/v1/namespaces/{namespace}/replicationcontrollers
-
DELETE
: ReplicationController のコレクションを削除する -
GET
: ReplicationController 種類のオブジェクトをリスト表示または監視する -
POST
: ReplicationController を作成する
-
/api/v1/watch/namespaces/{namespace}/replicationcontrollers
-
GET
: ReplicationController のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
-
/api/v1/namespaces/{namespace}/replicationcontrollers/{name}
-
DELETE
: ReplicationController を削除する -
GET
: 指定された ReplicationController を読み取る -
PATCH
: 指定された ReplicationController を部分的に更新する -
PUT
: 指定された ReplicationController を置き換える
-
/api/v1/watch/namespaces/{namespace}/replicationcontrollers/{name}
-
GET
: ReplicationController の種類のオブジェクトへの変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用し、'fieldSelector' パラメーターで単一の項目にフィルター処理します。
-
/api/v1/namespaces/{namespace}/replicationcontrollers/{name}/status
-
GET
: 指定された ReplicationController のステータスを読み取る -
PATCH
: 指定された ReplicationController のステータスを部分的に更新する -
PUT
: 指定された ReplicationController のステータスを置き換える
-
15.2.1. /api/v1/replicationcontrollers リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- ReplicationController 種類のオブジェクトをリスト表示または監視する
HTTP コード | レスポンスのボディー |
---|---|
200 - OK | |
401 - Unauthorized | 空白 |
15.2.2. /api/v1/watch/replicationcontrollers リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- ReplicationController のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
15.2.3. /api/v1/namespaces/{namespace}/replicationcontrollers リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
DELETE
- 説明
- ReplicationController のコレクションを削除する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
GET
- 説明
- ReplicationController 種類のオブジェクトをリスト表示または監視する
HTTP コード | レスポンスのボディー |
---|---|
200 - OK | |
401 - Unauthorized | 空白 |
- HTTP メソッド
-
POST
- 説明
- ReplicationController を作成する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
HTTP コード | レスポンスのボディー |
---|---|
200 - OK | |
201 - Created | |
202 - Accepted | |
401 - Unauthorized | 空白 |
15.2.4. /api/v1/watch/namespaces/{namespace}/replicationcontrollers リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- ReplicationController のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
15.2.5. /api/v1/namespaces/{namespace}/replicationcontrollers/{name} リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| ReplicationController の名前 |
- HTTP メソッド
-
DELETE
- 説明
- ReplicationController を削除する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
202 - Accepted |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
GET
- 説明
- 指定された ReplicationController を読み取る
HTTP コード | レスポンスのボディー |
---|---|
200 - OK | |
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PATCH
- 説明
- 指定された ReplicationController を部分的に更新する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK | |
201 - Created | |
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PUT
- 説明
- 指定された ReplicationController を置き換える
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
HTTP コード | レスポンスのボディー |
---|---|
200 - OK | |
201 - Created | |
401 - Unauthorized | 空白 |
15.2.6. /api/v1/watch/namespaces/{namespace}/replicationcontrollers/{name} リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| ReplicationController の名前 |
- HTTP メソッド
-
GET
- 説明
- ReplicationController の種類のオブジェクトへの変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用し、'fieldSelector' パラメーターで単一の項目にフィルター処理します。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
15.2.7. /api/v1/namespaces/{namespace}/replicationcontrollers/{name}/status リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| ReplicationController の名前 |
- HTTP メソッド
-
GET
- 説明
- 指定された ReplicationController のステータスを読み取る
HTTP コード | レスポンスのボディー |
---|---|
200 - OK | |
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PATCH
- 説明
- 指定された ReplicationController のステータスを部分的に更新する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK | |
201 - Created | |
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PUT
- 説明
- 指定された ReplicationController のステータスを置き換える
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
HTTP コード | レスポンスのボディー |
---|---|
200 - OK | |
201 - Created | |
401 - Unauthorized | 空白 |
第16章 ReplicaSet [apps/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ReplicaSet は、指定された数の Pod レプリカが常に実行されていることを確認します。
- 型
-
object
16.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 を参照してください。 |
| ReplicaSet のラベルが空の場合、デフォルトでは、ReplicaSet が管理する Pod と同じになります。標準オブジェクトのメタデータ。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。 | |
|
| ReplicaSetSpec は、ReplicaSet の仕様です。 |
|
| ReplicaSetStatus は、ReplicaSet の現在のステータスを表します。 |
16.1.1. .spec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ReplicaSetSpec は、ReplicaSet の仕様です。
- 型
-
object
- 必須
-
selector
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 新しく作成された Pod が使用可能であると見なされるために、コンテナーがクラッシュすることなく準備ができる最小秒数。デフォルトは 0 です (Pod は準備ができ次第利用可能と見なされます) |
|
| レプリカは、必要なレプリカの数です。これは、明示的なゼロと指定されていないものを区別するためのポインターです。デフォルトは 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller/#what-is-a-replicationcontroller |
| Selector は、レプリカ数と一致する必要がある Pod に対するラベルクエリーです。このレプリカセットによって制御されるために一致する必要があるキーと値にラベルを付けます。Pod テンプレートのラベルと一致する必要があります。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors | |
| テンプレートは、不十分なレプリカが検出された場合に作成される Pod を説明するオブジェクトです。詳細: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller#pod-template |
16.1.2. .status リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ReplicaSetStatus は、ReplicaSet の現在のステータスを表します。
- 型
-
object
- 必須
-
replicas
-
プロパティー | 型 | 説明 |
---|---|---|
|
| このレプリカセットで使用可能なレプリカの数 (少なくとも minReadySeconds の準備ができています)。 |
|
| レプリカセットの現在の状態の最新の利用可能な観察値を表します。 |
|
| ReplicaSetCondition は、特定の時点でのレプリカセットの状態を記述します。 |
|
| レプリカセットの Pod テンプレートのラベルと一致するラベルを持つ Pod の数。 |
|
| ObservedGeneration は、最後に観察された ReplicaSet の生成を反映します。 |
|
| readyReplicas は、Ready Condition のこの ReplicaSet によってターゲットに設定された Pod 数です。 |
|
| レプリカは、最近観察されたレプリカの数です。詳細: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller/#what-is-a-replicationcontroller |
16.1.3. .status.conditions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- レプリカセットの現在の状態の最新の利用可能な観察値を表します。
- 型
-
array
16.1.4. .status.conditions[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- ReplicaSetCondition は、特定の時点でのレプリカセットの状態を記述します。
- 型
-
object
- 必須
-
type
-
status
-
プロパティー | 型 | 説明 |
---|---|---|
| time | 最後にある状態から別の状態に遷移した時間。 |
|
| 遷移の詳細を示す人が判読できるメッセージ。 |
|
| 条件の最後の遷移の理由。 |
|
| 状態のステータス (True、False、Unknown のいずれか)。 |
|
| レプリカセット条件のタイプ。 |
16.2. API エンドポイント リンクのコピーリンクがクリップボードにコピーされました!
以下の API エンドポイントを利用できます。
/apis/apps/v1/replicasets
-
GET
: ReplicaSet 種類のオブジェクトをリスト表示または監視します
-
/apis/apps/v1/watch/replicasets
-
GET
: ReplicaSet のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
-
/apis/apps/v1/namespaces/{namespace}/replicasets
-
DELETE
: ReplicaSet のコレクションを削除する -
GET
: ReplicaSet 種類のオブジェクトをリスト表示または監視します -
POST
: ReplicaSet を作成する
-
/apis/apps/v1/watch/namespaces/{namespace}/replicasets
-
GET
: ReplicaSet のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
-
/apis/apps/v1/namespaces/{namespace}/replicasets/{name}
-
DELETE
: ReplicaSet を削除する -
GET
: 指定された ReplicaSet を読み取る -
PATCH
: 指定された ReplicaSet を部分的に更新する -
PUT
: 指定された ReplicaSet を置き換える
-
/apis/apps/v1/watch/namespaces/{namespace}/replicasets/{name}
-
GET
: ReplicaSet 種類のオブジェクトへの変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用し、'fieldSelector' パラメーターで単一の項目にフィルター処理します。
-
/apis/apps/v1/namespaces/{namespace}/replicasets/{name}/status
-
GET
: 指定された ReplicaSet のステータスを読み取る -
PATCH
: 指定された ReplicaSet のステータスを部分的に更新する -
PUT
: 指定された ReplicaSet のステータスを置き換える
-
16.2.1. /apis/apps/v1/replicasets リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- ReplicaSet 種類のオブジェクトをリスト表示または監視する
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
16.2.2. /apis/apps/v1/watch/replicasets リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- ReplicaSet のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
16.2.3. /apis/apps/v1/namespaces/{namespace}/replicasets リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
DELETE
- 説明
- ReplicaSet のコレクションを削除する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
GET
- 説明
- ReplicaSet 種類のオブジェクトをリスト表示または監視する
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
POST
- 説明
- ReplicaSet を作成する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
202 - Accepted |
|
401 - Unauthorized | 空白 |
16.2.4. /apis/apps/v1/watch/namespaces/{namespace}/replicasets リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- ReplicaSet のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
16.2.5. /apis/apps/v1/namespaces/{namespace}/replicasets/{name} リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| ReplicaSet の名前 |
- HTTP メソッド
-
DELETE
- 説明
- ReplicaSet を削除する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
202 - Accepted |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
GET
- 説明
- 指定された ReplicaSet を読み取る
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PATCH
- 説明
- 指定された ReplicaSet を部分的に更新する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PUT
- 説明
- 指定された ReplicaSet を置き換える
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
16.2.6. /apis/apps/v1/watch/namespaces/{namespace}/replicasets/{name} リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| ReplicaSet の名前 |
- HTTP メソッド
-
GET
- 説明
- ReplicaSet 種類のオブジェクトへの変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用し、'fieldSelector' パラメーターで単一の項目にフィルター処理します。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
16.2.7. /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/status リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| ReplicaSet の名前 |
- HTTP メソッド
-
GET
- 説明
- 指定された ReplicaSet のステータスを読み取る
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PATCH
- 説明
- 指定された ReplicaSet のステータスを部分的に更新する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PUT
- 説明
- 指定された ReplicaSet のステータスを置き換える
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
第17章 StatefulSet [apps/v1] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
StatefulSet は、一貫した ID を持つ Pod のセットを表します。ID は次のように定義されます。- ネットワーク: 単一の安定した DNS およびホスト名。- ストレージ: 要求された数の VolumeClaim。
StatefulSet は、特定のネットワーク ID が常に同じストレージ ID にマップされることを保証します。
- 型
-
object
17.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 を参照してください。 | |
|
| StatefulSetSpec は、StatefulSet の仕様です。 |
|
| StatefulSetStatus は、StatefulSet の現在の状態を表します。 |
17.1.1. .spec リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- StatefulSetSpec は、StatefulSet の仕様です。
- 型
-
object
- 必須
-
selector
-
template
-
serviceName
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 新しく作成された Pod が使用可能であると見なされるために、コンテナーがクラッシュすることなく準備ができる最小秒数。デフォルトは 0 です (Pod は準備ができ次第利用可能と見なされます) |
|
| StatefulSetOrdinals は、この StatefulSet でのレプリカ順序割り当てに使用されるポリシーを記述します。 |
|
| StatefulSetPersistentVolumeClaimRetentionPolicy は、StatefulSet VolumeClaimTemplate から作成された PVC に使用されるポリシーを記述します。 |
|
|
podManagementPolicy は、初期スケールアップ時、ノード上の Pod の交換時、またはスケールダウン時に Pod を作成する方法を制御します。デフォルトのポリシーは
使用可能な列挙値: - |
|
| レプリカは、指定した Template のレプリカの希望する数です。これらは、同じ Template のインスタンス化であるという意味でレプリカですが、個々のレプリカにも一貫した ID があります。指定しない場合、デフォルトは 1 です。 |
|
| revisionHistoryLimit は、StatefulSet のリビジョン履歴に保持されるリビジョンの最大数です。リビジョン履歴は、現在適用されている StatefulSetSpec バージョンで表されていないすべてのリビジョンで構成されます。デフォルト値は 10 です。 |
| selector は、レプリカ数と一致する必要がある Pod に対するラベルクエリーです。Pod テンプレートのラベルと一致する必要があります。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors | |
|
| serviceName は、この StatefulSet を管理するサービスの名前です。このサービスは StatefulSet の前に存在する必要があり、セットのネットワーク ID を担当します。Pod は、pod-specific-string.serviceName.default.svc.cluster.local のパターンに従う DNS/ホスト名を取得します。ここで、"pod-specific-string" は StatefulSet コントローラーによって管理されます。 |
| テンプレートは、不十分なレプリカが検出された場合に作成される Pod を説明するオブジェクトです。StatefulSet によりスタンプされた各 Pod はこのテンプレートを満たしますが、StatefulSet の残りの部分とは異なる一意の ID を持ちます。各 Pod には、<statefulsetname>-<podindex> の形式で名前が付けられます。たとえば、インデックス番号 "3" を持つ "web" という名前の StatefulSet 内の Pod は、"web-3" という名前になります。許可される template.spec.restartPolicy 値は "Always" のみです。 | |
|
| StatefulSetUpdateStrategy は、StatefulSet コントローラーが更新を実行するのに使用する戦略を示します。示された戦略の更新を実行するのに必要な追加のパラメーターが含まれています。 |
| volumeClaimTemplates は、Pod が参照できるクレームのリストです。StatefulSet コントローラーは、Pod の ID を維持する方法で、ネットワーク ID をクレームにマッピングするロールを果たします。このリストのすべてのクレームには、テンプレートの 1 つのコンテナーに (名前で) 一致する volumeMount が 1 つ以上含まれている必要があります。このリストのクレームは、同じ名前のテンプレート内のどのボリュームよりも優先されます。 |
17.1.2. .spec.ordinals リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- StatefulSetOrdinals は、この StatefulSet でのレプリカ順序割り当てに使用されるポリシーを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| start は、最初のレプリカのインデックスを表す番号です。これを使用すると、デフォルトの 0 から始まるインデックス名ではなく、別のインデックス (例: 1 から始まるインデックス) からレプリカに番号を付けるか、別の StatefulSet へのレプリカの段階的な移動をオーケストレーションすることができます。設定されている場合、レプリカインデックスは .spec.ordinals.start、.spec.ordinals.start + .spec.replicas) の範囲になります。設定されていない場合、デフォルトは 0 です。レプリカのインデックスは [0、.spec.replicas) の範囲になります。 |
17.1.3. .spec.persistentVolumeClaimRetentionPolicy リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- StatefulSetPersistentVolumeClaimRetentionPolicy は、StatefulSet VolumeClaimTemplate から作成された PVC に使用されるポリシーを記述します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
|
WhenDeleted は、StatefulSet が削除されたときに、StatefulSet VolumeClaimTemplates から作成された PVC に何が起こるかを指定します。 |
|
|
WhenScaled は、StatefulSet がスケールダウンされたときに StatefulSet VolumeClaimTemplates から作成された PVC に何が起こるかを指定します。 |
17.1.4. .spec.updateStrategy リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- StatefulSetUpdateStrategy は、StatefulSet コントローラーが更新を実行するのに使用する戦略を示します。示された戦略の更新を実行するのに必要な追加のパラメーターが含まれています。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| RollingUpdateStatefulSetStrategy は、RollingUpdateStatefulSetStrategyType のパラメーターを伝達するのに使用されます。 |
|
| タイプは、StatefulSetUpdateStrategy のタイプを示します。デフォルトは RollingUpdate です。
可能な列挙値: - |
17.1.5. .spec.updateStrategy.rollingUpdate リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- RollingUpdateStatefulSetStrategy は、RollingUpdateStatefulSetStrategyType のパラメーターを伝達するのに使用されます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
| 更新中に使用できなくなる可能性のある Pod の最大数。値は、絶対数 (例:5) または目的の Pod のパーセンテージ (例:10%) にすることができます。絶対数は、端数を切り上げてパーセンテージから計算されます。これは 0 にすることはできません。デフォルトは 1 です。このフィールドはアルファレベルであり、MaxUnavailableStatefulSet 機能を有効にするサーバーでのみ認識されます。このフィールドは、0 から Replicas-1 の範囲内のすべての Pod に適用されます。つまり、0 から Replicas-1 までの範囲内に使用できない Pod がある場合は、MaxUnavailable にカウントされます。 | |
|
| Partition は、StatefulSet をパーティション分割して更新する序数を示します。ローリング更新時に、通常の Replicas-1 からパーティションへのすべての Pod が更新されます。パーティション 1 から 0 までの Pod はどれも変更されません。これは、カナリアベースのデプロイメントを実行できるようにするのに役立ちます。デフォルト値は 0 です。 |
17.1.6. .status リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- StatefulSetStatus は、StatefulSet の現在の状態を表します。
- 型
-
object
- 必須
-
replicas
-
プロパティー | 型 | 説明 |
---|---|---|
|
| この statefulset の対象となる利用可能な Pod (少なくとも minReadySeconds の準備ができている) の総数。 |
|
| collisionCount は、StatefulSet のハッシュ競合の数です。StatefulSet コントローラーは、最新の ControllerRevision の名前を作成する必要がある場合に、このフィールドを競合回避メカニズムとして使用します。 |
|
| statefulset の現在の状態の最新の利用可能な観測値を表します。 |
|
| StatefulSetCondition は、特定の時点での statefulset の状態を記述します。 |
|
| currentReplicas は、currentRevision により示される StatefulSet バージョンから StatefulSet コントローラーによって作成された Pod の数です。 |
|
| currentRevision は、空でない場合、シーケンス [0,currentReplicas) で Pod を生成するのに使用される StatefulSet のバージョンを示します。 |
|
| observedGeneration は、この StatefulSet で観察された最新の世代です。これは、API サーバーによる変更時に更新される StatefulSet の生成に対応します。 |
|
| readyReplicas は、Ready 条件が指定されたこの StatefulSet に対して作成された Pod の数です。 |
|
| レプリカは、StatefulSet コントローラーによって作成された Pod の数です。 |
|
| updateRevision は、空でないと、シーケンス [replicas-updatedReplicas,replicas) で Pod を生成するのに使用される StatefulSet のバージョンを示します。 |
|
| updatedReplicas は、updateRevision により示される StatefulSet バージョンから StatefulSet コントローラーにより作成された Pod の数です。 |
17.1.7. .status.conditions リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- statefulset の現在の状態の最新の利用可能な観測値を表します。
- 型
-
array
17.1.8. .status.conditions[] リンクのコピーリンクがクリップボードにコピーされました!
- 説明
- StatefulSetCondition は、特定の時点での statefulset の状態を記述します。
- 型
-
object
- 必須
-
type
-
status
-
プロパティー | 型 | 説明 |
---|---|---|
| time | 最後にある状態から別の状態に遷移した時間。 |
|
| 遷移の詳細を示す人が判読できるメッセージ。 |
|
| 条件の最後の遷移の理由。 |
|
| 状態のステータス (True、False、Unknown のいずれか)。 |
|
| statefulset 条件のタイプ。 |
17.2. API エンドポイント リンクのコピーリンクがクリップボードにコピーされました!
以下の API エンドポイントを利用できます。
/apis/apps/v1/statefulsets
-
GET
: StatefulSet 種類のオブジェクトをリスト表示または監視する
-
/apis/apps/v1/watch/statefulsets
-
GET
: StatefulSet のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
-
/apis/apps/v1/namespaces/{namespace}/statefulsets
-
DELETE
: StatefulSet のコレクションを削除する -
GET
: StatefulSet 種類のオブジェクトをリスト表示または監視する -
POST
: StatefulSet を作成する
-
/apis/apps/v1/watch/namespaces/{namespace}/statefulsets
-
GET
: StatefulSet のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
-
/apis/apps/v1/namespaces/{namespace}/statefulsets/{name}
-
DELETE
: StatefulSet を削除する -
GET
: 指定された StatefulSet を読み取る -
PATCH
: 指定された StatefulSet を部分的に更新する -
PUT
: 指定された StatefulSet を置き換える
-
/apis/apps/v1/watch/namespaces/{namespace}/statefulsets/{name}
-
GET
: StatefulSet 種類のオブジェクトへの変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用し、'fieldSelector' パラメーターで単一の項目にフィルター処理します。
-
/apis/apps/v1/namespaces/{namespace}/statefulsets/{name}/status
-
GET
: 指定された StatefulSet のステータスを読み取ります。 -
PATCH
: 指定された StatefulSet のステータスを部分的に更新します。 -
PUT
: 指定された StatefulSet のステータスを置き換えます。
-
17.2.1. /apis/apps/v1/statefulsets リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- StatefulSet 種類のオブジェクトをリスト表示または監視する
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
17.2.2. /apis/apps/v1/watch/statefulsets リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- StatefulSet のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
17.2.3. /apis/apps/v1/namespaces/{namespace}/statefulsets リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
DELETE
- 説明
- StatefulSet のコレクションを削除する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
GET
- 説明
- StatefulSet 種類のオブジェクトをリスト表示または監視する
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
POST
- 説明
- StatefulSet を作成する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
202 - Accepted |
|
401 - Unauthorized | 空白 |
17.2.4. /apis/apps/v1/watch/namespaces/{namespace}/statefulsets リンクのコピーリンクがクリップボードにコピーされました!
- HTTP メソッド
-
GET
- 説明
- StatefulSet のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
17.2.5. /apis/apps/v1/namespaces/{namespace}/statefulsets/{name} リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| StatefulSet の名前 |
- HTTP メソッド
-
DELETE
- 説明
- StatefulSet を削除する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
202 - Accepted |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
GET
- 説明
- 指定された StatefulSet を読み取る
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PATCH
- 説明
- 指定された StatefulSet を部分的に更新する
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PUT
- 説明
- 指定された StatefulSet を置き換える
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
17.2.6. /apis/apps/v1/watch/namespaces/{namespace}/statefulsets/{name} リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| StatefulSet の名前 |
- HTTP メソッド
-
GET
- 説明
- StatefulSet 種類のオブジェクトへの変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用し、'fieldSelector' パラメーターで単一の項目にフィルター処理します。
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
17.2.7. /apis/apps/v1/namespaces/{namespace}/statefulsets/{name}/status リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | 型 | 説明 |
---|---|---|
|
| StatefulSet の名前 |
- HTTP メソッド
-
GET
- 説明
- 指定された StatefulSet のステータスを読み取ります
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PATCH
- 説明
- 指定された StatefulSet のステータスを部分的に更新します
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PUT
- 説明
- 指定された StatefulSet のステータスを置き換えます
パラメーター | 型 | 説明 |
---|---|---|
|
| これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
HTTP コード | レスポンスのボディー |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
Legal Notice
リンクのコピーリンクがクリップボードにコピーされました!
Copyright © 2025 Red Hat
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.