14.12. Pod [v1]
- 説明
- Pod は、ホスト上で実行できるコンテナーのコレクションです。このリソースはクライアントによって作成され、ホストにスケジュールされます。
- タイプ
-
object
14.12.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.12.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> と一致するテイントを許容します。 |
|
| TopologySpreadConstraints は、Pod のグループがトポロジードメイン全体にどのように分散するべきかを説明します。スケジューラーは、制約に従う方法で Pod をスケジュールします。すべての topologySpreadConstraints は AND 演算されます。 |
|
| TopologySpreadConstraint は、指定されたトポロジー間で一致する Pod を分散する方法を指定します。 |
|
| Pod に属するコンテナーによってマウントできるボリュームのリスト。詳細: https://kubernetes.io/docs/concepts/storage/volumes |
|
| ボリュームは、Pod 内の任意のコンテナーからアクセスできる Pod 内の名前付きボリュームを表します。 |
14.12.1.2. .spec.affinity
- 説明
- アフィニティーは、アフィニティースケジューリングルールのグループです。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ノードアフィニティーは、ノードアフィニティースケジューリングルールのグループです。 |
|
| Pod アフィニティーは、Pod 間アフィニティースケジューリングルールのグループです。 |
|
| Pod アンチアフィニティーは、Pod 間アンチアフィニティースケジューリングルールのグループです。 |
14.12.1.3. .spec.affinity.nodeAffinity
- 説明
- ノードアフィニティーは、ノードアフィニティースケジューリングルールのグループです。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| スケジューラーは、このフィールドで指定されたアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アフィニティー式など) を満たすノードごとに、このフィールドの要素を反復処理して合計を計算します。ノードが対応する matchExpressions と一致する場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。 |
|
| 空の優先スケジューリング用語は、暗黙の重み 0 を持つすべてのオブジェクトに一致します (つまり、操作なしです)。null の優先スケジューリング用語は、オブジェクトに一致しません (つまり、no-op でもあります)。 |
|
| ノードセレクターは、ノードのセットに対する 1 つ以上のラベルクエリーの結果の和集合を表します。つまり、ノードセレクター用語で表されるセレクターの OR を表します。 |
14.12.1.4. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution
- 説明
- スケジューラーは、このフィールドで指定されたアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アフィニティー式など) を満たすノードごとに、このフィールドの要素を反復処理して合計を計算します。ノードが対応する matchExpressions と一致する場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。
- タイプ
-
array
14.12.1.5. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[]
- 説明
- 空の優先スケジューリング用語は、暗黙の重み 0 を持つすべてのオブジェクトに一致します (つまり、操作なしです)。null の優先スケジューリング用語は、オブジェクトに一致しません (つまり、no-op でもあります)。
- タイプ
-
object
- 必須
-
weight
-
preference
-
プロパティー | 型 | 説明 |
---|---|---|
|
| null または空のノードセレクター用語はオブジェクトに一致しません。これらの要件は AND で結合されます。TopologySelectorTerm タイプは、NodeSelectorTerm のサブセットを実装します。 |
|
| 対応する nodeSelectorTerm の一致に関連する重み (1〜100 の範囲)。 |
14.12.1.6. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference
- 説明
- null または空のノードセレクター用語はオブジェクトに一致しません。これらの要件は AND で結合されます。TopologySelectorTerm タイプは、NodeSelectorTerm のサブセットを実装します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ノードのラベルごとのノードセレクター要件のリスト。 |
|
| ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| ノードのフィールドごとのノードセレクター要件のリスト。 |
|
| ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
14.12.1.7. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchExpressions
- 説明
- ノードのラベルごとのノードセレクター要件のリスト。
- タイプ
-
array
14.12.1.8. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchExpressions[]
- 説明
- ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- タイプ
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| セレクターが適用されるラベルキー。 |
|
| キーと値のセットの関係を表します。有効な Operator は、In、NotIn、Exists、DoesNotExist です。Gt、および Lt。
使用可能な列挙値:- |
|
| 文字列値の配列。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。Operator が Gt または Lt の場合、values 配列には、整数として解釈される単一の要素が必要です。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
14.12.1.9. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchFields
- 説明
- ノードのフィールドごとのノードセレクター要件のリスト。
- タイプ
-
array
14.12.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.12.1.11. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution
- 説明
- ノードセレクターは、ノードのセットに対する 1 つ以上のラベルクエリーの結果の和集合を表します。つまり、ノードセレクター用語で表されるセレクターの OR を表します。
- タイプ
-
object
- 必須
-
nodeSelectorTerms
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 必須。ノードセレクター用語のリスト。用語は OR されています。 |
|
| null または空のノードセレクター用語はオブジェクトに一致しません。これらの要件は AND で結合されます。TopologySelectorTerm タイプは、NodeSelectorTerm のサブセットを実装します。 |
14.12.1.12. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms
- 説明
- 必須。ノードセレクター用語のリスト。用語は OR されています。
- タイプ
-
array
14.12.1.13. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[]
- 説明
- null または空のノードセレクター用語はオブジェクトに一致しません。これらの要件は AND で結合されます。TopologySelectorTerm タイプは、NodeSelectorTerm のサブセットを実装します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ノードのラベルごとのノードセレクター要件のリスト。 |
|
| ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| ノードのフィールドごとのノードセレクター要件のリスト。 |
|
| ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
14.12.1.14. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms。matchExpressions
- 説明
- ノードのラベルごとのノードセレクター要件のリスト。
- タイプ
-
array
14.12.1.15. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms。matchExpressions
- 説明
- ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- タイプ
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| セレクターが適用されるラベルキー。 |
|
| キーと値のセットの関係を表します。有効な Operator は、In、NotIn、Exists、DoesNotExist です。Gt、および Lt。
使用可能な列挙値:- |
|
| 文字列値の配列。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。Operator が Gt または Lt の場合、values 配列には、整数として解釈される単一の要素が必要です。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
14.12.1.16. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchFields
- 説明
- ノードのフィールドごとのノードセレクター要件のリスト。
- タイプ
-
array
14.12.1.17. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].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.12.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.12.1.19. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution
- 説明
- スケジューラーは、このフィールドで指定されたアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アフィニティー式など) を満たすノードごとに、このフィールドの要素を反復処理して合計を計算します。ノードに対応する podAffinityTerm に一致する Pod がある場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。
- タイプ
-
array
14.12.1.20. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[]
- 説明
- 一致したすべての WeightedPodAffinityTerm フィールドの重みがノードごとに追加され、最も優先されるノードが検索されます。
- タイプ
-
object
- 必須
-
weight
-
podAffinityTerm
-
プロパティー | 型 | 説明 |
---|---|---|
|
| この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。ここで、同じ場所は次のように定義されます。キー <topologyKey> のラベルの値が、Pod のセットの Pod が実行されているノードの値と一致するノードで実行されている |
|
| 対応する podAffinityTerm の一致に関連する重み (1〜100 の範囲)。 |
14.12.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" を意味します。空のセレクター ({}) は、すべての名前空間に一致します。 | |
|
| namespaces は、用語が適用される名前空間名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび nullnamespaceSelector は、"この Pod の namespace" を意味します |
|
| この Pod は、指定された名前空間の labelSelector と一致する Pod と同じ場所に配置 (アフィニティー) するか、同じ場所に配置しない (アンチアフィニティー) 必要があります。ここで、同じ場所に配置されるのは、キー topologyKey を持つラベルの値を持つノードで実行されるものとして定義されます。選択した Pod のいずれかが実行されているノードのノードと一致します。空の topologyKey は許可されていません。 |
14.12.1.22. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution
- 説明
- このフィールドで指定されたアフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定されたアフィニティー要件が Pod 実行中のある時点で満たされない場合 (Pod ラベルの更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。複数の要素がある場合、各 podAffinityTerm に対応するノードのリストが交差します。つまり、すべての用語が満たされる必要があります。
- タイプ
-
array
14.12.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" を意味します。空のセレクター ({}) は、すべての名前空間に一致します。 | |
|
| namespaces は、用語が適用される名前空間名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび nullnamespaceSelector は、"この Pod の namespace" を意味します |
|
| この Pod は、指定された名前空間の labelSelector と一致する Pod と同じ場所に配置 (アフィニティー) するか、同じ場所に配置しない (アンチアフィニティー) 必要があります。ここで、同じ場所に配置されるのは、キー topologyKey を持つラベルの値を持つノードで実行されるものとして定義されます。選択した Pod のいずれかが実行されているノードのノードと一致します。空の topologyKey は許可されていません。 |
14.12.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.12.1.25. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution
- 説明
- スケジューラーは、このフィールドで指定された非アフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アンチアフィニティー式など) を満たすノードごとに、の要素を反復処理して合計を計算します。このフィールドと、対応する podAffinityTerm に一致する Pod がノードにある場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。
- タイプ
-
array
14.12.1.26. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[]
- 説明
- 一致したすべての WeightedPodAffinityTerm フィールドの重みがノードごとに追加され、最も優先されるノードが検索されます。
- タイプ
-
object
- 必須
-
weight
-
podAffinityTerm
-
プロパティー | 型 | 説明 |
---|---|---|
|
| この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。ここで、同じ場所は次のように定義されます。キー <topologyKey> のラベルの値が、Pod のセットの Pod が実行されているノードの値と一致するノードで実行されている |
|
| 対応する podAffinityTerm の一致に関連する重み (1〜100 の範囲)。 |
14.12.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" を意味します。空のセレクター ({}) は、すべての名前空間に一致します。 | |
|
| namespaces は、用語が適用される名前空間名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび nullnamespaceSelector は、"この Pod の namespace" を意味します |
|
| この Pod は、指定された名前空間の labelSelector と一致する Pod と同じ場所に配置 (アフィニティー) するか、同じ場所に配置しない (アンチアフィニティー) 必要があります。ここで、同じ場所に配置されるのは、キー topologyKey を持つラベルの値を持つノードで実行されるものとして定義されます。選択した Pod のいずれかが実行されているノードのノードと一致します。空の topologyKey は許可されていません。 |
14.12.1.28. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution
- 説明
- このフィールドで指定された非アフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定された非アフィニティー要件が Pod 実行中のある時点で満たされない場合 (Pod ラベルの更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。複数の要素がある場合、各 podAffinityTerm に対応するノードのリストが交差します。つまり、すべての用語が満たされる必要があります。
- タイプ
-
array
14.12.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" を意味します。空のセレクター ({}) は、すべての名前空間に一致します。 | |
|
| namespaces は、用語が適用される名前空間名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび nullnamespaceSelector は、"この Pod の namespace" を意味します |
|
| この Pod は、指定された名前空間の labelSelector と一致する Pod と同じ場所に配置 (アフィニティー) するか、同じ場所に配置しない (アンチアフィニティー) 必要があります。ここで、同じ場所に配置されるのは、キー topologyKey を持つラベルの値を持つノードで実行されるものとして定義されます。選択した Pod のいずれかが実行されているノードのノードと一致します。空の topologyKey は許可されていません。 |
14.12.1.30. .spec.containers
- 説明
- Pod に属するコンテナーのリスト。現在、コンテナーを追加または削除することはできません。Pod には少なくとも 1 つのコンテナーが必要です。これを更新することはできません。
- タイプ
-
array
14.12.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 は、コンピュートリソースの要件を説明します。 |
|
| 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.12.1.32. .spec.containers[].env
- 説明
- コンテナーに設定する環境変数のリスト。これを更新することはできません。
- タイプ
-
array
14.12.1.33. .spec.containers[].env[]
- 説明
- EnvVar は、コンテナーに存在する環境変数を表します。
- タイプ
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 環境変数の名前。C_IDENTIFIER でなければなりません。 |
|
| 変数参照 $(VAR_NAME) は、コンテナー内で以前に定義された環境変数と任意のサービス環境変数を使用してデプロイメントされます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、"(VAR_NAME)" は文字列リテラル "$(VAR_NAME)" を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。デフォルトは "" です。 |
|
| EnvVarSource は、EnvVar の値のソースを表します。 |
14.12.1.34. .spec.containers[].env[].valueFrom
- 説明
- EnvVarSource は、EnvVar の値のソースを表します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ConfigMap からキーを選択します。 |
|
| ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。 |
|
| ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。 |
|
| SecretKeySelector は、シークレットのキーを選択します。 |
14.12.1.35. .spec.containers[].env[].valueFrom.configMapKeyRef
- 説明
- ConfigMap からキーを選択します。
- タイプ
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
14.12.1.36. .spec.containers[].env[].valueFrom.fieldRef
- 説明
- ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。
- タイプ
-
object
- 必須
-
fieldPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| FieldPath が記述されているスキーマのバージョン。デフォルトは "v1" です。 |
|
| 指定された API バージョンで選択するフィールドのパス。 |
14.12.1.37. .spec.containers[].env[].valueFrom.resourceFieldRef
- 説明
- ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。
- タイプ
-
object
- 必須
-
resource
-
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナー名: ボリュームには必須、env 変数にはオプション |
| 公開されたリソースの出力形式を指定します。デフォルトは "1" です。 | |
|
| 必須: 選択するリソース |
14.12.1.38. .spec.containers[].env[].valueFrom.secretKeyRef
- 説明
- SecretKeySelector は、シークレットのキーを選択します。
- タイプ
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
14.12.1.39. .spec.containers[].envFrom
- 説明
- コンテナー内の環境変数に入力するソースのリスト。ソース内で定義されたキーは C_IDENTIFIER である必要があります。無効なキーはすべて、コンテナーの起動時にイベントとして報告されます。キーが複数のソースに存在する場合、最後のソースに関連付けられた値が優先されます。重複キーを持つ環境によって定義された値が優先されます。これを更新することはできません。
- タイプ
-
array
14.12.1.40. .spec.containers[].envFrom[]
- 説明
- EnvFromSource は、一連の ConfigMap のソースを表します
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ConfigMapEnvSource は、環境変数に入力する ConfigMap を選択します。 ターゲットの ConfigMap のデータフィールドの内容は、キーと値のペアを環境変数として表します。 |
|
| ConfigMap の各キーの前に追加するオプションの識別子。C_IDENTIFIER でなければなりません。 |
|
| SecretEnvSource は、環境変数に入力するシークレットを選択します。 ターゲットシークレットのデータフィールドの内容は、キーと値のペアを環境変数として表します。 |
14.12.1.41. .spec.containers[].envFrom[].configMapRef
- 説明
ConfigMapEnvSource は、環境変数に入力する ConfigMap を選択します。
ターゲットの ConfigMap のデータフィールドの内容は、キーと値のペアを環境変数として表します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap を定義する必要があるかどうかを指定します |
14.12.1.42. .spec.containers[].envFrom[].secretRef
- 説明
SecretEnvSource は、環境変数に入力するシークレットを選択します。
ターゲットシークレットのデータフィールドの内容は、キーと値のペアを環境変数として表します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットを定義する必要があるかどうかを指定します |
14.12.1.43. .spec.containers[].lifecycle
- 説明
- ライフサイクルは、コンテナーのライフサイクルイベントに対応して管理システムが実行する必要のあるアクションを表します。PostStart および PreStop ライフサイクルハンドラーの場合、コンテナープロセスが失敗しない限り、アクションが完了するまでコンテナー管理がブロックされます。失敗した場合、ハンドラーは中止されます。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。 |
|
| LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。 |
14.12.1.44. .spec.containers[].lifecycle.postStart
- 説明
- LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
14.12.1.45. .spec.containers[].lifecycle.postStart.exec
- 説明
- ExecAction は、"run in container" アクションを記述します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.12.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.12.1.47. .spec.containers[].lifecycle.postStart.httpGet.httpHeaders
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- タイプ
-
array
14.12.1.48. .spec.containers[].lifecycle.postStart.httpGet.httpHeaders[]
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- タイプ
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.12.1.49. .spec.containers[].lifecycle.postStart.tcpSocket
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- タイプ
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.12.1.50. .spec.containers[].lifecycle.preStop
- 説明
- LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
14.12.1.51. .spec.containers[].lifecycle.preStop.exec
- 説明
- ExecAction は、"run in container" アクションを記述します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.12.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.12.1.53. .spec.containers[].lifecycle.preStop.httpGet.httpHeaders
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- タイプ
-
array
14.12.1.54. .spec.containers[].lifecycle.preStop.httpGet.httpHeaders[]
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- タイプ
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.12.1.55. .spec.containers[].lifecycle.preStop.tcpSocket
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- タイプ
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.12.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.12.1.57. .spec.containers[].livenessProbe.exec
- 説明
- ExecAction は、"run in container" アクションを記述します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.12.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.12.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.12.1.60. .spec.containers[].livenessProbe.httpGet.httpHeaders
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- タイプ
-
array
14.12.1.61. .spec.containers[].livenessProbe.httpGet.httpHeaders[]
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- タイプ
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.12.1.62. .spec.containers[].livenessProbe.tcpSocket
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- タイプ
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.12.1.63. .spec.containers[].ports
- 説明
- コンテナーから公開するポートのリスト。ここでポートを指定しなくても、そのポートが公開されるのを防ぐことはできません。コンテナー内のデフォルトの "0.0.0.0" アドレスをリッスンしているポートは、ネットワークからアクセスできます。戦略的マージパッチを使用してこの配列を変更すると、データが破損する可能性があります。詳細は、https://github.com/kubernetes/kubernetes/issues/108255 を参照してください。更新はできません。
- タイプ
-
array
14.12.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.12.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.12.1.66. .spec.containers[].readinessProbe.exec
- 説明
- ExecAction は、"run in container" アクションを記述します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.12.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.12.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.12.1.69. .spec.containers[].readinessProbe.httpGet.httpHeaders
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- タイプ
-
array
14.12.1.70. .spec.containers[].readinessProbe.httpGet.httpHeaders[]
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- タイプ
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.12.1.71. .spec.containers[].readinessProbe.tcpSocket
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- タイプ
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.12.1.72. .spec.containers[].resizePolicy
- 説明
- コンテナーのリソースサイズ変更ポリシー。
- タイプ
-
array
14.12.1.73. .spec.containers[].resizePolicy[]
- 説明
- ContainerResizePolicy は、コンテナーのリソースサイズ変更ポリシーを表します。
- タイプ
-
object
- 必須
-
resourceName
-
restartPolicy
-
プロパティー | 型 | 説明 |
---|---|---|
|
| このリソースサイズ変更ポリシーが適用されるリソースの名前。対応している値は、cpu、memory です。 |
|
| 指定されたリソースのサイズが変更されたときに適用する再起動ポリシー。指定しない場合、デフォルトの NotRequired が設定されます。 |
14.12.1.74. .spec.containers[].resources
- 説明
- ResourceRequirements は、コンピュートリソースの要件を説明します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。 これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。 このフィールドは不変です。これはコンテナーにのみ設定できます。 |
|
| ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。 |
| 制限は、許容されるコンピュートリソースの最大量を記述します。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 | |
| 要求は、必要なコンピュートリソースの最小量を記述します。コンテナーについて Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
14.12.1.75. .spec.containers[].resources.claims
- 説明
Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。
これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。
このフィールドは不変です。これはコンテナーにのみ設定できます。
- タイプ
-
array
14.12.1.76. .spec.containers[].resources.claims[]
- 説明
- ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。
- タイプ
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。 |
14.12.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.12.1.78. .spec.containers[].securityContext.capabilities
- 説明
- 実行中のコンテナーに POSIX 機能を追加および削除します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 追加された機能 |
|
| 削除された機能 |
14.12.1.79. .spec.containers[].securityContext.seLinuxOptions
- 説明
- SELinuxOptions は、コンテナーに適用されるラベルです。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Level は、コンテナーに適用される SELinux レベルのラベルです。 |
|
| Role は、コンテナーに適用される SELinux ロールラベルです。 |
|
| Type は、コンテナーに適用される SELinux タイプのラベルです。 |
|
| User は、コンテナーに適用される SELinux ユーザーラベルです。 |
14.12.1.80. .spec.containers[].securityContext.seccompProfile
- 説明
- SeccompProfile は、Pod/コンテナーの seccomp プロファイル設定を定義します。設定できるプロファイルソースは 1 つだけです。
- タイプ
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| localhostProfile は、ノード上のファイルで定義されたプロファイルを使用する必要があることを示します。プロファイルが機能するには、ノードで事前に設定されている必要があります。kubelet の設定済みの seccomp プロファイルの場所を基準にして、降順のパスである必要があります。タイプが "Localhost" の場合にのみ設定する必要があります。 |
|
| type は、適用される seccomp プロファイルの種類を示します。有効なオプションは以下のとおりです。 Localhost - ノード上のファイルで定義されたプロファイルを使用する必要があります。RuntimeDefault- コンテナーのランタイムデフォルトプロファイルを使用する必要があります。制限なし - プロファイルを適用しないでください。
使用可能な列挙値: - |
14.12.1.81. .spec.containers[].securityContext.windowsOptions
- 説明
- WindowsSecurityContextOptions には、Windows 固有のオプションおよび認証情報が含まれています。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| GMSACredentialSpec は、GMSA アドミッション Webhook (https://github.com/kubernetes-sigs/windows-gmsa) が GMSACredentialSpecName フィールドで指定された GMSA クレデンシャル仕様のコンテンツをインライン化する場所です。 |
|
| GMSACredentialSpecName は、使用する GMSA 認証情報仕様の名前です。 |
|
| HostProcess は、コンテナーをホストプロセスコンテナーとして実行する必要があるかどうかを決定します。このフィールドはアルファレベルであり、WindowsHostProcessContainers 機能フラグを有効にするコンポーネントによってのみ尊重されます。機能フラグなしでこのフィールドを設定すると、Pod の検証時にエラーが発生します。Pod のすべてのコンテナーは、同じ有効な HostProcess 値を持っている必要があります (HostProcess コンテナーと非 HostProcess コンテナーを混在させることはできません)。さらに、HostProcess が true の場合、HostNetwork も true に設定する必要があります。 |
|
| コンテナープロセスのエントリーポイントを実行するための Windows の UserName。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。 |
14.12.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.12.1.83. .spec.containers[].startupProbe.exec
- 説明
- ExecAction は、"run in container" アクションを記述します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.12.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.12.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.12.1.86. .spec.containers[].startupProbe.httpGet.httpHeaders
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- タイプ
-
array
14.12.1.87. .spec.containers[].startupProbe.httpGet.httpHeaders[]
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- タイプ
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.12.1.88. .spec.containers[].startupProbe.tcpSocket
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- タイプ
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.12.1.89. .spec.containers[].volumeDevices
- 説明
- volumeDevices は、コンテナーによって使用されるブロックデバイスのリストです。
- タイプ
-
array
14.12.1.90. .spec.containers[].volumeDevices[]
- 説明
- volumeDevice は、コンテナー内の raw ブロックデバイスのマッピングを記述します。
- タイプ
-
object
- 必須
-
name
-
devicePath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| devicePath は、デバイスがマップされるコンテナー内のパスです。 |
|
| name は、Pod 内の persistentVolumeClaim の名前と一致する必要があります |
14.12.1.91. .spec.containers[].volumeMounts
- 説明
- コンテナーのファイルシステムにマウントする Pod ボリューム。これを更新することはできません。
- タイプ
-
array
14.12.1.92. .spec.containers[].volumeMounts[]
- 説明
- VolumeMount は、コンテナー内でのボリュームのマウントについて説明します。
- タイプ
-
object
- 必須
-
name
-
mountPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ボリュームをマウントする必要があるコンテナー内のパス。':' を含めることはできません。 |
|
| mountPropagation は、マウントがホストからコンテナーに、またはその逆にどのように伝播されるかを決定します。設定されていない場合、MountPropagationNone が使用されます。このフィールドは 1.10 のベータ版です。
使用可能な列挙値: - |
|
| ボリュームの名前に一致する必要があります。 |
|
| true の場合は読み取り専用、それ以外の場合は読み取り/書き込み (false または指定なし) でマウントされます。デフォルトは false です。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内のパス。デフォルトは (ボリュームのルート) です。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内の拡張パス。SubPath と同様に動作しますが、環境変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。デフォルトは (ボリュームのルート) です。SubPathExpr と SubPath は相互に排他的です。 |
14.12.1.93. .spec.dnsConfig
- 説明
- PodDNSConfig は、DNSPolicy から生成されたパラメーターに加えて、Pod の DNS パラメーターを定義します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| DNS ネームサーバーの IP アドレスのリスト。これは、DNSPolicy から生成されたベースネームサーバーに追加されます。重複したネームサーバーは削除されます。 |
|
| DNS リゾルバーオプションのリスト。これは、DNSPolicy から生成された基本オプションとマージされます。重複したエントリーは削除されます。オプションで指定された解決オプションは、ベース DNS ポリシーに表示されるものをオーバーライドします。 |
|
| PodDNSConfigOption は、Pod の DNS リゾルバーオプションを定義します。 |
|
| ホスト名ルックアップ用の DNS 検索ドメインのリスト。これは、DNSPolicy から生成された基本検索パスに追加されます。重複する検索パスは削除されます。 |
14.12.1.94. .spec.dnsConfig.options
- 説明
- DNS リゾルバーオプションのリスト。これは、DNSPolicy から生成された基本オプションとマージされます。重複したエントリーは削除されます。オプションで指定された解決オプションは、ベース DNS ポリシーに表示されるものをオーバーライドします。
- タイプ
-
array
14.12.1.95. .spec.dnsConfig.options[]
- 説明
- PodDNSConfigOption は、Pod の DNS リゾルバーオプションを定義します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 必須。 |
|
|
14.12.1.96. .spec.ephemeralContainers
- 説明
- この Pod で実行されるエフェメラルコンテナーのリスト。エフェメラルコンテナーを既存の Pod で実行して、デバッグなどのユーザーが開始するアクションを実行できます。このリストは、Pod の作成時に指定することはできません。また、Pod の仕様を更新して変更することもできません。エフェメラルコンテナーを既存の Pod に追加するには、Pod のエフェメラルコンテナーサブリソースを使用します。
- タイプ
-
array
14.12.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 は、コンピュートリソースの要件を説明します。 |
|
| 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.12.1.98. .spec.ephemeralContainers[].env
- 説明
- コンテナーに設定する環境変数のリスト。これを更新することはできません。
- タイプ
-
array
14.12.1.99. .spec.ephemeralContainers[].env[]
- 説明
- EnvVar は、コンテナーに存在する環境変数を表します。
- タイプ
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 環境変数の名前。C_IDENTIFIER でなければなりません。 |
|
| 変数参照 $(VAR_NAME) は、コンテナー内で以前に定義された環境変数と任意のサービス環境変数を使用してデプロイメントされます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、"(VAR_NAME)" は文字列リテラル "$(VAR_NAME)" を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。デフォルトは "" です。 |
|
| EnvVarSource は、EnvVar の値のソースを表します。 |
14.12.1.100. .spec.ephemeralContainers[].env[].valueFrom
- 説明
- EnvVarSource は、EnvVar の値のソースを表します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ConfigMap からキーを選択します。 |
|
| ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。 |
|
| ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。 |
|
| SecretKeySelector は、シークレットのキーを選択します。 |
14.12.1.101. .spec.ephemeralContainers[].env[].valueFrom.configMapKeyRef
- 説明
- ConfigMap からキーを選択します。
- タイプ
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
14.12.1.102. .spec.ephemeralContainers[].env[].valueFrom.fieldRef
- 説明
- ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。
- タイプ
-
object
- 必須
-
fieldPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| FieldPath が記述されているスキーマのバージョン。デフォルトは "v1" です。 |
|
| 指定された API バージョンで選択するフィールドのパス。 |
14.12.1.103. .spec.ephemeralContainers[].env[].valueFrom.resourceFieldRef
- 説明
- ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。
- タイプ
-
object
- 必須
-
resource
-
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナー名: ボリュームには必須、env 変数にはオプション |
| 公開されたリソースの出力形式を指定します。デフォルトは "1" です。 | |
|
| 必須: 選択するリソース |
14.12.1.104. .spec.ephemeralContainers[].env[].valueFrom.secretKeyRef
- 説明
- SecretKeySelector は、シークレットのキーを選択します。
- タイプ
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
14.12.1.105. .spec.ephemeralContainers[].envFrom
- 説明
- コンテナー内の環境変数に入力するソースのリスト。ソース内で定義されたキーは C_IDENTIFIER である必要があります。無効なキーはすべて、コンテナーの起動時にイベントとして報告されます。キーが複数のソースに存在する場合、最後のソースに関連付けられた値が優先されます。重複キーを持つ環境によって定義された値が優先されます。これを更新することはできません。
- タイプ
-
array
14.12.1.106. .spec.ephemeralContainers[].envFrom[]
- 説明
- EnvFromSource は、一連の ConfigMap のソースを表します
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ConfigMapEnvSource は、環境変数に入力する ConfigMap を選択します。 ターゲットの ConfigMap のデータフィールドの内容は、キーと値のペアを環境変数として表します。 |
|
| ConfigMap の各キーの前に追加するオプションの識別子。C_IDENTIFIER でなければなりません。 |
|
| SecretEnvSource は、環境変数に入力するシークレットを選択します。 ターゲットシークレットのデータフィールドの内容は、キーと値のペアを環境変数として表します。 |
14.12.1.107. .spec.ephemeralContainers[].envFrom[].configMapRef
- 説明
ConfigMapEnvSource は、環境変数に入力する ConfigMap を選択します。
ターゲットの ConfigMap のデータフィールドの内容は、キーと値のペアを環境変数として表します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap を定義する必要があるかどうかを指定します |
14.12.1.108. .spec.ephemeralContainers[].envFrom[].secretRef
- 説明
SecretEnvSource は、環境変数に入力するシークレットを選択します。
ターゲットシークレットのデータフィールドの内容は、キーと値のペアを環境変数として表します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットを定義する必要があるかどうかを指定します |
14.12.1.109. .spec.ephemeralContainers[].lifecycle
- 説明
- ライフサイクルは、コンテナーのライフサイクルイベントに対応して管理システムが実行する必要のあるアクションを表します。PostStart および PreStop ライフサイクルハンドラーの場合、コンテナープロセスが失敗しない限り、アクションが完了するまでコンテナー管理がブロックされます。失敗した場合、ハンドラーは中止されます。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。 |
|
| LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。 |
14.12.1.110. .spec.ephemeralContainers[].lifecycle.postStart
- 説明
- LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
14.12.1.111. .spec.ephemeralContainers[].lifecycle.postStart.exec
- 説明
- ExecAction は、"run in container" アクションを記述します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.12.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.12.1.113. .spec.ephemeralContainers[].lifecycle.postStart.httpGet.httpHeaders
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- タイプ
-
array
14.12.1.114. .spec.ephemeralContainers[].lifecycle.postStart.httpGet.httpHeaders[]
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- タイプ
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.12.1.115. .spec.ephemeralContainers[].lifecycle.postStart.tcpSocket
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- タイプ
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.12.1.116. .spec.ephemeralContainers[].lifecycle.preStop
- 説明
- LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
14.12.1.117. .spec.ephemeralContainers[].lifecycle.preStop.exec
- 説明
- ExecAction は、"run in container" アクションを記述します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.12.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.12.1.119. .spec.ephemeralContainers[].lifecycle.preStop.httpGet.httpHeaders
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- タイプ
-
array
14.12.1.120. .spec.ephemeralContainers[].lifecycle.preStop.httpGet.httpHeaders[]
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- タイプ
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.12.1.121. .spec.ephemeralContainers[].lifecycle.preStop.tcpSocket
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- タイプ
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.12.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.12.1.123. .spec.ephemeralContainers[].livenessProbe.exec
- 説明
- ExecAction は、"run in container" アクションを記述します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.12.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.12.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.12.1.126. .spec.ephemeralContainers[].livenessProbe.httpGet.httpHeaders
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- タイプ
-
array
14.12.1.127. .spec.ephemeralContainers[].livenessProbe.httpGet.httpHeaders[]
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- タイプ
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.12.1.128. .spec.ephemeralContainers[].livenessProbe.tcpSocket
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- タイプ
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.12.1.129. .spec.ephemeralContainers[].ports
- 説明
- エフェメラルコンテナーのポートは許可されていません。
- タイプ
-
array
14.12.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.12.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.12.1.132. .spec.ephemeralContainers[].readinessProbe.exec
- 説明
- ExecAction は、"run in container" アクションを記述します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.12.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.12.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.12.1.135. .spec.ephemeralContainers[].readinessProbe.httpGet.httpHeaders
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- タイプ
-
array
14.12.1.136. .spec.ephemeralContainers[].readinessProbe.httpGet.httpHeaders[]
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- タイプ
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.12.1.137. .spec.ephemeralContainers[].readinessProbe.tcpSocket
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- タイプ
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.12.1.138. .spec.ephemeralContainers[].resizePolicy
- 説明
- コンテナーのリソースサイズ変更ポリシー。
- タイプ
-
array
14.12.1.139. .spec.ephemeralContainers[].resizePolicy[]
- 説明
- ContainerResizePolicy は、コンテナーのリソースサイズ変更ポリシーを表します。
- タイプ
-
object
- 必須
-
resourceName
-
restartPolicy
-
プロパティー | 型 | 説明 |
---|---|---|
|
| このリソースサイズ変更ポリシーが適用されるリソースの名前。対応している値は、cpu、memory です。 |
|
| 指定されたリソースのサイズが変更されたときに適用する再起動ポリシー。指定しない場合、デフォルトの NotRequired が設定されます。 |
14.12.1.140. .spec.ephemeralContainers[].resources
- 説明
- ResourceRequirements は、コンピュートリソースの要件を説明します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。 これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。 このフィールドは不変です。これはコンテナーにのみ設定できます。 |
|
| ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。 |
| 制限は、許容されるコンピュートリソースの最大量を記述します。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 | |
| 要求は、必要なコンピュートリソースの最小量を記述します。コンテナーについて Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
14.12.1.141. .spec.ephemeralContainers[].resources.claims
- 説明
Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。
これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。
このフィールドは不変です。これはコンテナーにのみ設定できます。
- タイプ
-
array
14.12.1.142. .spec.ephemeralContainers[].resources.claims[]
- 説明
- ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。
- タイプ
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。 |
14.12.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.12.1.144. .spec.ephemeralContainers[].securityContext.capabilities
- 説明
- 実行中のコンテナーに POSIX 機能を追加および削除します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 追加された機能 |
|
| 削除された機能 |
14.12.1.145. .spec.ephemeralContainers[].securityContext.seLinuxOptions
- 説明
- SELinuxOptions は、コンテナーに適用されるラベルです。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Level は、コンテナーに適用される SELinux レベルのラベルです。 |
|
| Role は、コンテナーに適用される SELinux ロールラベルです。 |
|
| Type は、コンテナーに適用される SELinux タイプのラベルです。 |
|
| User は、コンテナーに適用される SELinux ユーザーラベルです。 |
14.12.1.146. .spec.ephemeralContainers[].securityContext.seccompProfile
- 説明
- SeccompProfile は、Pod/コンテナーの seccomp プロファイル設定を定義します。設定できるプロファイルソースは 1 つだけです。
- タイプ
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| localhostProfile は、ノード上のファイルで定義されたプロファイルを使用する必要があることを示します。プロファイルが機能するには、ノードで事前に設定されている必要があります。kubelet の設定済みの seccomp プロファイルの場所を基準にして、降順のパスである必要があります。タイプが "Localhost" の場合にのみ設定する必要があります。 |
|
| type は、適用される seccomp プロファイルの種類を示します。有効なオプションは以下のとおりです。 Localhost - ノード上のファイルで定義されたプロファイルを使用する必要があります。RuntimeDefault- コンテナーのランタイムデフォルトプロファイルを使用する必要があります。制限なし - プロファイルを適用しないでください。
使用可能な列挙値: - |
14.12.1.147. .spec.ephemeralContainers[].securityContext.windowsOptions
- 説明
- WindowsSecurityContextOptions には、Windows 固有のオプションおよび認証情報が含まれています。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| GMSACredentialSpec は、GMSA アドミッション Webhook (https://github.com/kubernetes-sigs/windows-gmsa) が GMSACredentialSpecName フィールドで指定された GMSA クレデンシャル仕様のコンテンツをインライン化する場所です。 |
|
| GMSACredentialSpecName は、使用する GMSA 認証情報仕様の名前です。 |
|
| HostProcess は、コンテナーをホストプロセスコンテナーとして実行する必要があるかどうかを決定します。このフィールドはアルファレベルであり、WindowsHostProcessContainers 機能フラグを有効にするコンポーネントによってのみ尊重されます。機能フラグなしでこのフィールドを設定すると、Pod の検証時にエラーが発生します。Pod のすべてのコンテナーは、同じ有効な HostProcess 値を持っている必要があります (HostProcess コンテナーと非 HostProcess コンテナーを混在させることはできません)。さらに、HostProcess が true の場合、HostNetwork も true に設定する必要があります。 |
|
| コンテナープロセスのエントリーポイントを実行するための Windows の UserName。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。 |
14.12.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.12.1.149. .spec.ephemeralContainers[].startupProbe.exec
- 説明
- ExecAction は、"run in container" アクションを記述します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.12.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.12.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.12.1.152. .spec.ephemeralContainers[].startupProbe.httpGet.httpHeaders
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- タイプ
-
array
14.12.1.153. .spec.ephemeralContainers[].startupProbe.httpGet.httpHeaders[]
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- タイプ
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.12.1.154. .spec.ephemeralContainers[].startupProbe.tcpSocket
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- タイプ
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.12.1.155. .spec.ephemeralContainers[].volumeDevices
- 説明
- volumeDevices は、コンテナーによって使用されるブロックデバイスのリストです。
- タイプ
-
array
14.12.1.156. .spec.ephemeralContainers[].volumeDevices[]
- 説明
- volumeDevice は、コンテナー内の raw ブロックデバイスのマッピングを記述します。
- タイプ
-
object
- 必須
-
name
-
devicePath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| devicePath は、デバイスがマップされるコンテナー内のパスです。 |
|
| name は、Pod 内の persistentVolumeClaim の名前と一致する必要があります |
14.12.1.157. .spec.ephemeralContainers[].volumeMounts
- 説明
- コンテナーのファイルシステムにマウントする Pod ボリューム。エフェメラルコンテナーでは、サブパスをマウントできません。更新はできません。
- タイプ
-
array
14.12.1.158. .spec.ephemeralContainers[].volumeMounts[]
- 説明
- VolumeMount は、コンテナー内でのボリュームのマウントについて説明します。
- タイプ
-
object
- 必須
-
name
-
mountPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ボリュームをマウントする必要があるコンテナー内のパス。':' を含めることはできません。 |
|
| mountPropagation は、マウントがホストからコンテナーに、またはその逆にどのように伝播されるかを決定します。設定されていない場合、MountPropagationNone が使用されます。このフィールドは 1.10 のベータ版です。
使用可能な列挙値: - |
|
| ボリュームの名前に一致する必要があります。 |
|
| true の場合は読み取り専用、それ以外の場合は読み取り/書き込み (false または指定なし) でマウントされます。デフォルトは false です。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内のパス。デフォルトは (ボリュームのルート) です。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内の拡張パス。SubPath と同様に動作しますが、環境変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。デフォルトは (ボリュームのルート) です。SubPathExpr と SubPath は相互に排他的です。 |
14.12.1.159. .spec.hostAliases
- 説明
- HostAliases は、指定された場合に Pod の hosts ファイルに注入されるホストおよび IP のオプションのリストです。これは、hostNetwork 以外の Pod にのみ有効です。
- タイプ
-
array
14.12.1.160. .spec.hostAliases[]
- 説明
- HostAlias は、Pod の hosts ファイルのエントリーとして挿入される IP とホスト名の間のマッピングを保持します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 上記の IP アドレスのホスト名。 |
|
| ホストファイルエントリーの IP アドレス。 |
14.12.1.161. .spec.imagePullSecrets
- 説明
- ImagePullSecrets は、この PodSpec で使用されるイメージをプルするために使用する、同じ名前空間内のシークレットへの参照のオプションのリストです。指定されている場合、これらのシークレットは、使用するために個々のプラー実装に渡されます。詳細: https://kubernetes.io/docs/concepts/containers/images#specifying-imagepullsecrets-on-a-pod
- タイプ
-
array
14.12.1.162. .spec.imagePullSecrets[]
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
14.12.1.163. .spec.initContainers
- 説明
- Pod に属する初期化コンテナーのリスト。コンテナーが開始される前に、初期化コンテナーが順番に実行されます。init コンテナーに障害が発生した場合、Pod は障害が発生したと見なされ、restartPolicy に従って処理されます。init コンテナーまたは通常のコンテナーの名前は、すべてのコンテナー間で一意である必要があります。Init コンテナーには、ライフサイクルアクション、準備プローブ、ライブネスプローブ、またはスタートアッププローブがない場合があります。init コンテナーの resourceRequirements は、各リソースタイプの最大の要求/制限を見つけ、その値の最大値または通常のコンテナーの合計を使用することにより、スケジューリング中に考慮されます。同様の方法で、init コンテナーに制限が適用されます。現在、初期化コンテナーを追加または削除することはできません。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/
- タイプ
-
array
14.12.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 は、コンピュートリソースの要件を説明します。 |
|
| 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.12.1.165. .spec.initContainers[].env
- 説明
- コンテナーに設定する環境変数のリスト。これを更新することはできません。
- タイプ
-
array
14.12.1.166. .spec.initContainers[].env[]
- 説明
- EnvVar は、コンテナーに存在する環境変数を表します。
- タイプ
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 環境変数の名前。C_IDENTIFIER でなければなりません。 |
|
| 変数参照 $(VAR_NAME) は、コンテナー内で以前に定義された環境変数と任意のサービス環境変数を使用してデプロイメントされます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、"(VAR_NAME)" は文字列リテラル "$(VAR_NAME)" を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。デフォルトは "" です。 |
|
| EnvVarSource は、EnvVar の値のソースを表します。 |
14.12.1.167. .spec.initContainers[].env[].valueFrom
- 説明
- EnvVarSource は、EnvVar の値のソースを表します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ConfigMap からキーを選択します。 |
|
| ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。 |
|
| ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。 |
|
| SecretKeySelector は、シークレットのキーを選択します。 |
14.12.1.168. .spec.initContainers[].env[].valueFrom.configMapKeyRef
- 説明
- ConfigMap からキーを選択します。
- タイプ
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
14.12.1.169. .spec.initContainers[].env[].valueFrom.fieldRef
- 説明
- ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。
- タイプ
-
object
- 必須
-
fieldPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| FieldPath が記述されているスキーマのバージョン。デフォルトは "v1" です。 |
|
| 指定された API バージョンで選択するフィールドのパス。 |
14.12.1.170. .spec.initContainers[].env[].valueFrom.resourceFieldRef
- 説明
- ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。
- タイプ
-
object
- 必須
-
resource
-
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナー名: ボリュームには必須、env 変数にはオプション |
| 公開されたリソースの出力形式を指定します。デフォルトは "1" です。 | |
|
| 必須: 選択するリソース |
14.12.1.171. .spec.initContainers[].env[].valueFrom.secretKeyRef
- 説明
- SecretKeySelector は、シークレットのキーを選択します。
- タイプ
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
14.12.1.172. .spec.initContainers[].envFrom
- 説明
- コンテナー内の環境変数に入力するソースのリスト。ソース内で定義されたキーは C_IDENTIFIER である必要があります。無効なキーはすべて、コンテナーの起動時にイベントとして報告されます。キーが複数のソースに存在する場合、最後のソースに関連付けられた値が優先されます。重複キーを持つ環境によって定義された値が優先されます。これを更新することはできません。
- タイプ
-
array
14.12.1.173. .spec.initContainers[].envFrom[]
- 説明
- EnvFromSource は、一連の ConfigMap のソースを表します
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ConfigMapEnvSource は、環境変数に入力する ConfigMap を選択します。 ターゲットの ConfigMap のデータフィールドの内容は、キーと値のペアを環境変数として表します。 |
|
| ConfigMap の各キーの前に追加するオプションの識別子。C_IDENTIFIER でなければなりません。 |
|
| SecretEnvSource は、環境変数に入力するシークレットを選択します。 ターゲットシークレットのデータフィールドの内容は、キーと値のペアを環境変数として表します。 |
14.12.1.174. .spec.initContainers[].envFrom[].configMapRef
- 説明
ConfigMapEnvSource は、環境変数に入力する ConfigMap を選択します。
ターゲットの ConfigMap のデータフィールドの内容は、キーと値のペアを環境変数として表します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap を定義する必要があるかどうかを指定します |
14.12.1.175. .spec.initContainers[].envFrom[].secretRef
- 説明
SecretEnvSource は、環境変数に入力するシークレットを選択します。
ターゲットシークレットのデータフィールドの内容は、キーと値のペアを環境変数として表します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットを定義する必要があるかどうかを指定します |
14.12.1.176. .spec.initContainers[].lifecycle
- 説明
- ライフサイクルは、コンテナーのライフサイクルイベントに対応して管理システムが実行する必要のあるアクションを表します。PostStart および PreStop ライフサイクルハンドラーの場合、コンテナープロセスが失敗しない限り、アクションが完了するまでコンテナー管理がブロックされます。失敗した場合、ハンドラーは中止されます。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。 |
|
| LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。 |
14.12.1.177. .spec.initContainers[].lifecycle.postStart
- 説明
- LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
14.12.1.178. .spec.initContainers[].lifecycle.postStart.exec
- 説明
- ExecAction は、"run in container" アクションを記述します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.12.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.12.1.180. .spec.initContainers[].lifecycle.postStart.httpGet.httpHeaders
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- タイプ
-
array
14.12.1.181. .spec.initContainers[].lifecycle.postStart.httpGet.httpHeaders[]
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- タイプ
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.12.1.182. .spec.initContainers[].lifecycle.postStart.tcpSocket
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- タイプ
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.12.1.183. .spec.initContainers[].lifecycle.preStop
- 説明
- LifecycleHandler は、ライフサイクルフックで実行する必要がある特定のアクションを定義します。TCPSocket を除くフィールドのうち 1 つだけを指定する必要があります。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ExecAction は、"run in container" アクションを記述します。 |
|
| HTTPGetAction は、HTTP GET リクエストに基づくアクションを記述します。 |
|
| TCPSocketAction は、ソケットを開くことに基づくアクションを記述します |
14.12.1.184. .spec.initContainers[].lifecycle.preStop.exec
- 説明
- ExecAction は、"run in container" アクションを記述します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.12.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.12.1.186. .spec.initContainers[].lifecycle.preStop.httpGet.httpHeaders
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- タイプ
-
array
14.12.1.187. .spec.initContainers[].lifecycle.preStop.httpGet.httpHeaders[]
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- タイプ
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.12.1.188. .spec.initContainers[].lifecycle.preStop.tcpSocket
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- タイプ
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.12.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.12.1.190. .spec.initContainers[].livenessProbe.exec
- 説明
- ExecAction は、"run in container" アクションを記述します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.12.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.12.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.12.1.193. .spec.initContainers[].livenessProbe.httpGet.httpHeaders
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- タイプ
-
array
14.12.1.194. .spec.initContainers[].livenessProbe.httpGet.httpHeaders[]
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- タイプ
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.12.1.195. .spec.initContainers[].livenessProbe.tcpSocket
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- タイプ
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.12.1.196. .spec.initContainers[].ports
- 説明
- コンテナーから公開するポートのリスト。ここでポートを指定しなくても、そのポートが公開されるのを防ぐことはできません。コンテナー内のデフォルトの "0.0.0.0" アドレスをリッスンしているポートは、ネットワークからアクセスできます。戦略的マージパッチを使用してこの配列を変更すると、データが破損する可能性があります。詳細は、https://github.com/kubernetes/kubernetes/issues/108255 を参照してください。更新はできません。
- タイプ
-
array
14.12.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.12.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.12.1.199. .spec.initContainers[].readinessProbe.exec
- 説明
- ExecAction は、"run in container" アクションを記述します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.12.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.12.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.12.1.202. .spec.initContainers[].readinessProbe.httpGet.httpHeaders
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- タイプ
-
array
14.12.1.203. .spec.initContainers[].readinessProbe.httpGet.httpHeaders[]
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- タイプ
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.12.1.204. .spec.initContainers[].readinessProbe.tcpSocket
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- タイプ
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.12.1.205. .spec.initContainers[].resizePolicy
- 説明
- コンテナーのリソースサイズ変更ポリシー。
- タイプ
-
array
14.12.1.206. .spec.initContainers[].resizePolicy[]
- 説明
- ContainerResizePolicy は、コンテナーのリソースサイズ変更ポリシーを表します。
- タイプ
-
object
- 必須
-
resourceName
-
restartPolicy
-
プロパティー | 型 | 説明 |
---|---|---|
|
| このリソースサイズ変更ポリシーが適用されるリソースの名前。対応している値は、cpu、memory です。 |
|
| 指定されたリソースのサイズが変更されたときに適用する再起動ポリシー。指定しない場合、デフォルトの NotRequired が設定されます。 |
14.12.1.207. .spec.initContainers[].resources
- 説明
- ResourceRequirements は、コンピュートリソースの要件を説明します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。 これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。 このフィールドは不変です。これはコンテナーにのみ設定できます。 |
|
| ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。 |
| 制限は、許容されるコンピュートリソースの最大量を記述します。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 | |
| 要求は、必要なコンピュートリソースの最小量を記述します。コンテナーについて Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
14.12.1.208. .spec.initContainers[].resources.claims
- 説明
Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。
これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。
このフィールドは不変です。これはコンテナーにのみ設定できます。
- タイプ
-
array
14.12.1.209. .spec.initContainers[].resources.claims[]
- 説明
- ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。
- タイプ
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。 |
14.12.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.12.1.211. .spec.initContainers[].securityContext.capabilities
- 説明
- 実行中のコンテナーに POSIX 機能を追加および削除します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 追加された機能 |
|
| 削除された機能 |
14.12.1.212. .spec.initContainers[].securityContext.seLinuxOptions
- 説明
- SELinuxOptions は、コンテナーに適用されるラベルです。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Level は、コンテナーに適用される SELinux レベルのラベルです。 |
|
| Role は、コンテナーに適用される SELinux ロールラベルです。 |
|
| Type は、コンテナーに適用される SELinux タイプのラベルです。 |
|
| User は、コンテナーに適用される SELinux ユーザーラベルです。 |
14.12.1.213. .spec.initContainers[].securityContext.seccompProfile
- 説明
- SeccompProfile は、Pod/コンテナーの seccomp プロファイル設定を定義します。設定できるプロファイルソースは 1 つだけです。
- タイプ
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| localhostProfile は、ノード上のファイルで定義されたプロファイルを使用する必要があることを示します。プロファイルが機能するには、ノードで事前に設定されている必要があります。kubelet の設定済みの seccomp プロファイルの場所を基準にして、降順のパスである必要があります。タイプが "Localhost" の場合にのみ設定する必要があります。 |
|
| type は、適用される seccomp プロファイルの種類を示します。有効なオプションは以下のとおりです。 Localhost - ノード上のファイルで定義されたプロファイルを使用する必要があります。RuntimeDefault- コンテナーのランタイムデフォルトプロファイルを使用する必要があります。制限なし - プロファイルを適用しないでください。
使用可能な列挙値: - |
14.12.1.214. .spec.initContainers[].securityContext.windowsOptions
- 説明
- WindowsSecurityContextOptions には、Windows 固有のオプションおよび認証情報が含まれています。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| GMSACredentialSpec は、GMSA アドミッション Webhook (https://github.com/kubernetes-sigs/windows-gmsa) が GMSACredentialSpecName フィールドで指定された GMSA クレデンシャル仕様のコンテンツをインライン化する場所です。 |
|
| GMSACredentialSpecName は、使用する GMSA 認証情報仕様の名前です。 |
|
| HostProcess は、コンテナーをホストプロセスコンテナーとして実行する必要があるかどうかを決定します。このフィールドはアルファレベルであり、WindowsHostProcessContainers 機能フラグを有効にするコンポーネントによってのみ尊重されます。機能フラグなしでこのフィールドを設定すると、Pod の検証時にエラーが発生します。Pod のすべてのコンテナーは、同じ有効な HostProcess 値を持っている必要があります (HostProcess コンテナーと非 HostProcess コンテナーを混在させることはできません)。さらに、HostProcess が true の場合、HostNetwork も true に設定する必要があります。 |
|
| コンテナープロセスのエントリーポイントを実行するための Windows の UserName。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。 |
14.12.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.12.1.216. .spec.initContainers[].startupProbe.exec
- 説明
- ExecAction は、"run in container" アクションを記述します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
14.12.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.12.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.12.1.219. .spec.initContainers[].startupProbe.httpGet.httpHeaders
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- タイプ
-
array
14.12.1.220. .spec.initContainers[].startupProbe.httpGet.httpHeaders[]
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- タイプ
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
14.12.1.221. .spec.initContainers[].startupProbe.tcpSocket
- 説明
- TCPSocketAction は、ソケットを開くことに基づくアクションを記述します
- タイプ
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
14.12.1.222. .spec.initContainers[].volumeDevices
- 説明
- volumeDevices は、コンテナーによって使用されるブロックデバイスのリストです。
- タイプ
-
array
14.12.1.223. .spec.initContainers[].volumeDevices[]
- 説明
- volumeDevice は、コンテナー内の raw ブロックデバイスのマッピングを記述します。
- タイプ
-
object
- 必須
-
name
-
devicePath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| devicePath は、デバイスがマップされるコンテナー内のパスです。 |
|
| name は、Pod 内の persistentVolumeClaim の名前と一致する必要があります |
14.12.1.224. .spec.initContainers[].volumeMounts
- 説明
- コンテナーのファイルシステムにマウントする Pod ボリューム。これを更新することはできません。
- タイプ
-
array
14.12.1.225. .spec.initContainers[].volumeMounts[]
- 説明
- VolumeMount は、コンテナー内でのボリュームのマウントについて説明します。
- タイプ
-
object
- 必須
-
name
-
mountPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ボリュームをマウントする必要があるコンテナー内のパス。':' を含めることはできません。 |
|
| mountPropagation は、マウントがホストからコンテナーに、またはその逆にどのように伝播されるかを決定します。設定されていない場合、MountPropagationNone が使用されます。このフィールドは 1.10 のベータ版です。
使用可能な列挙値: - |
|
| ボリュームの名前に一致する必要があります。 |
|
| true の場合は読み取り専用、それ以外の場合は読み取り/書き込み (false または指定なし) でマウントされます。デフォルトは false です。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内のパス。デフォルトは (ボリュームのルート) です。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内の拡張パス。SubPath と同様に動作しますが、環境変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。デフォルトは (ボリュームのルート) です。SubPathExpr と SubPath は相互に排他的です。 |
14.12.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.12.1.227. .spec.readinessGates
- 説明
- 指定した場合、すべての準備ゲートが Pod の準備状況について評価されます。すべてのコンテナーの準備が整い、準備ゲートで指定されたすべての条件のステータスが "True" になると、Pod の準備が整います。詳細: https://git.k8s.io/enhancements/keps/sig-network/580-pod-readiness-gates
- タイプ
-
array
14.12.1.228. .spec.readinessGates[]
- 説明
- PodReadinessGate には、Pod 条件への参照が含まれています
- タイプ
-
object
- 必須
-
conditionType
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ConditionType は、タイプが一致する Pod の条件リスト内の条件を参照します。 |
14.12.1.229. .spec.resourceClaims
- 説明
ResourceClaims は、Pod の起動を許可する前にどの ResourceClaim を割り当てて予約する必要があるかを定義します。リソースは、名前ベースでリソースを使用するコンテナーに提供されます。
これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。
このフィールドは不変です。
- タイプ
-
array
14.12.1.230. .spec.resourceClaims[]
- 説明
- PodResourceClaim は、ClaimSource を介して 1 つの ResourceClaim のみを参照します。Pod 内の ResourceClaim を一意に識別する名前を追加します。ResourceClaim へのアクセスが必要なコンテナーは、この名前で参照します。
- タイプ
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は Pod 内でこのリソース要求を一意に識別します。これは DNS_LABEL である必要があります。 |
|
| ClaimSource は、ResourceClaim への参照を記述します。 これらのフィールドのうち 1 つだけを設定する必要があります。このタイプのコンシューマーは、不明な値が含まれているように、空のオブジェクトを処理する必要があります。 |
14.12.1.231. .spec.resourceClaims[].source
- 説明
ClaimSource は、ResourceClaim への参照を記述します。
これらのフィールドのうち 1 つだけを設定する必要があります。このタイプのコンシューマーは、不明な値が含まれているように、空のオブジェクトを処理する必要があります。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ResourceClaimName は、この Pod と同じ namespace にある ResourceClaim オブジェクトの名前です。 |
|
| ResourceClaimTemplateName は、この Pod と同じ namespace にある ResourceClaimTemplate オブジェクトの名前です。 テンプレートは、この Pod にバインドされる新規 ResourceClaim の作成に使用されます。この Pod が削除されると、ResourceClaim も削除されます。ResourceClaim の名前は <pod name>-<resource name> になります。ここで、<resource name> は PodResourceClaim.Name です。連結された名前が ResourceClaim に対して有効でない (長すぎるなど) 場合は、Pod の検証で Pod が拒否されます。 Pod が所有していない名前が含まれる、既存の ResourceClaim は、無関係なリソースが誤って使用されることを避けるために、Pod では使用されません。スケジュールと Pod の起動は、関連のない ResourceClaim が削除されるまでブロックされます。 このフィールドは不変であり、ResourceClaim の作成後にコントロールプレーンによって対応する ResourceClaim に変更が加えられることはありません。 |
14.12.1.232. .spec.schedulingGates
- 説明
SchedulingGates は、指定されている場合に Pod のスケジューリングをブロックする不透明な値のリストです。schedulingGates が空でない場合、Pod は SchedulingGated 状態のままになり、スケジューラーは Pod のスケジュールを試行しません。
SchedulingGates を設定できるのは Pod の作成時にのみで、それ以降は削除されます。
これは、PodSchedulingReadiness フィーチャーゲートによって有効になるベータ機能です。
- タイプ
-
array
14.12.1.233. .spec.schedulingGates[]
- 説明
- PodSchedulingGate は Pod に割り当てられ、そのスケジューリングを保護します。
- タイプ
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| スケジューリングゲートの名前。各スケジューリングゲートには一意の name フィールドが必要です。 |
14.12.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 に使用される名前空間化された sysctl のリストを保持します。(コンテナーランタイムによる) サポートされていない sysctl を持つ Pod は起動に失敗する可能性があります。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| Sysctl は、設定するカーネルパラメーターを定義します |
|
| WindowsSecurityContextOptions には、Windows 固有のオプションおよび認証情報が含まれています。 |
14.12.1.235. .spec.securityContext.seLinuxOptions
- 説明
- SELinuxOptions は、コンテナーに適用されるラベルです。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Level は、コンテナーに適用される SELinux レベルのラベルです。 |
|
| Role は、コンテナーに適用される SELinux ロールラベルです。 |
|
| Type は、コンテナーに適用される SELinux タイプのラベルです。 |
|
| User は、コンテナーに適用される SELinux ユーザーラベルです。 |
14.12.1.236. .spec.securityContext.seccompProfile
- 説明
- SeccompProfile は、Pod/コンテナーの seccomp プロファイル設定を定義します。設定できるプロファイルソースは 1 つだけです。
- タイプ
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| localhostProfile は、ノード上のファイルで定義されたプロファイルを使用する必要があることを示します。プロファイルが機能するには、ノードで事前に設定されている必要があります。kubelet の設定済みの seccomp プロファイルの場所を基準にして、降順のパスである必要があります。タイプが "Localhost" の場合にのみ設定する必要があります。 |
|
| type は、適用される seccomp プロファイルの種類を示します。有効なオプションは以下のとおりです。 Localhost - ノード上のファイルで定義されたプロファイルを使用する必要があります。RuntimeDefault- コンテナーのランタイムデフォルトプロファイルを使用する必要があります。制限なし - プロファイルを適用しないでください。
使用可能な列挙値: - |
14.12.1.237. .spec.securityContext.sysctls
- 説明
- Sysctl は、Pod に使用される名前空間化された sysctl のリストを保持します。(コンテナーランタイムによる) サポートされていない sysctl を持つ Pod は起動に失敗する可能性があります。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
- タイプ
-
array
14.12.1.238. .spec.securityContext.sysctls[]
- 説明
- Sysctl は、設定するカーネルパラメーターを定義します
- タイプ
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 設定するプロパティーの名前 |
|
| 設定するプロパティーの値 |
14.12.1.239. .spec.securityContext.windowsOptions
- 説明
- WindowsSecurityContextOptions には、Windows 固有のオプションおよび認証情報が含まれています。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| GMSACredentialSpec は、GMSA アドミッション Webhook (https://github.com/kubernetes-sigs/windows-gmsa) が GMSACredentialSpecName フィールドで指定された GMSA クレデンシャル仕様のコンテンツをインライン化する場所です。 |
|
| GMSACredentialSpecName は、使用する GMSA 認証情報仕様の名前です。 |
|
| HostProcess は、コンテナーをホストプロセスコンテナーとして実行する必要があるかどうかを決定します。このフィールドはアルファレベルであり、WindowsHostProcessContainers 機能フラグを有効にするコンポーネントによってのみ尊重されます。機能フラグなしでこのフィールドを設定すると、Pod の検証時にエラーが発生します。Pod のすべてのコンテナーは、同じ有効な HostProcess 値を持っている必要があります (HostProcess コンテナーと非 HostProcess コンテナーを混在させることはできません)。さらに、HostProcess が true の場合、HostNetwork も true に設定する必要があります。 |
|
| コンテナープロセスのエントリーポイントを実行するための Windows の UserName。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。 |
14.12.1.240. .spec.tolerations
- 説明
- 指定されている場合、Pod の許容範囲。
- タイプ
-
array
14.12.1.241. .spec.tolerations[]
- 説明
- この toleration が割り当てられる Pod は、マッチング Operator <operator> を使用してトリプル <key,value,effect> と一致するテイントを許容します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| effect は、照合するテイントの効果を示します。空の場合は、すべてのテイント効果に一致します。指定されている場合、許可される値は NoSchedule、PreferNoSchedule、および NoExecute です。
使用可能な列挙値: - |
|
| key は toleration が適用されるテイントキーです。空の場合は、すべてのテイントキーに一致します。キーが空の場合、Operator は Exists である必要があります。この組み合わせは、すべての値とすべてのキーに一致することを意味します。 |
|
| Operator はキーと値の関係を表します。有効な Operator は Exists および Equal です。デフォルトは Equal です。Exists は、値のワイルドカードと同等であるため、Pod は特定のカテゴリーのすべてのテイントに耐えることができます。
使用可能な列挙値: - |
|
| tolerationSeconds は、toleration (effect は NoExecute でなければならず、NoExecute 以外の場合このフィールドは無視されます) がテイントを許容する期間を表します。デフォルトでは設定されていません。つまり、テイントを永久に許容します (エビクトしないでください)。ゼロ値と負の値は、システムによって 0 (すぐにエビクト) として扱われます。 |
|
| value は、toleration が一致するテイントの値です。Operator が Exists の場合、値は空である必要があります。それ以外の場合は、通常の文字列のみになります。 |
14.12.1.242. .spec.topologySpreadConstraints
- 説明
- TopologySpreadConstraints は、Pod のグループがトポロジードメイン全体にどのように分散するべきかを説明します。スケジューラーは、制約に従う方法で Pod をスケジュールします。すべての topologySpreadConstraints は AND 演算されます。
- タイプ
-
array
14.12.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.12.1.244. .spec.volumes
- 説明
- Pod に属するコンテナーによってマウントできるボリュームのリスト。詳細: https://kubernetes.io/docs/concepts/storage/volumes
- タイプ
-
array
14.12.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.12.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.12.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.12.1.248. .spec.volumes[].azureFile
- 説明
- AzureFile は、ホスト上の Azure File Service マウントを表し、マウントを Pod にバインドします。
- タイプ
-
object
- 必須
-
secretName
-
shareName
-
プロパティー | 型 | 説明 |
---|---|---|
|
| readOnly のデフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。 |
|
| secretName は、Azure ストレージアカウント名とキーを含むシークレットの名前です。 |
|
| shareName は Azure 共有名です。 |
14.12.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.12.1.250. .spec.volumes[].cephfs.secretRef
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
14.12.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.12.1.252. .spec.volumes[].cinder.secretRef
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
14.12.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.12.1.254. .spec.volumes[].configMap.items
- 説明
- item が指定されていない場合、参照される ConfigMap の Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。ConfigMap に存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。
- タイプ
-
array
14.12.1.255. .spec.volumes[].configMap.items[]
- 説明
- 文字列キーをボリューム内のパスにマップします。
- タイプ
-
object
- 必須
-
key
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key はプロジェクトのキーです。 |
|
| mode は任意: このファイルにアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| oath はキーをマップするファイルの相対パスです。絶対的なパスではない可能性があります。パス要素 '..' を含めることはできません。文字列 '..' で始まらない場合があります。 |
14.12.1.256. .spec.volumes[].csi
- 説明
- 外部 CSI ドライバーによって管理される、マウントするボリュームのソースの場所を表します
- タイプ
-
object
- 必須
-
driver
-
プロパティー | 型 | 説明 |
---|---|---|
|
| driver は、このボリュームを処理する CSI ドライバーの名前です。クラスターに登録されている正しい名前については、管理者に相談してください。 |
|
| マウントする fsType。例: "ext4"、"xfs"、"ntfs"。指定しない場合、空の値が関連する CSI ドライバーに渡され、適用するデフォルトのファイルシステムが決定されます。 |
|
| LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。 |
|
| readOnly は、ボリュームの読み取り専用設定を指定します。デフォルトは false (読み取り/書き込み) です。 |
|
| volumeAttributes は、CSI ドライバーに渡されるドライバー固有のプロパティーを格納します。サポートされている値については、ドライバーのドキュメントを参照してください。 |
14.12.1.257. .spec.volumes[].csi.nodePublishSecretRef
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
14.12.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.12.1.259. .spec.volumes[].downwardAPI.items
- 説明
- items は、Downward API ボリュームファイルのリストです
- タイプ
-
array
14.12.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.12.1.261. .spec.volumes[].downwardAPI.items[].fieldRef
- 説明
- ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。
- タイプ
-
object
- 必須
-
fieldPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| FieldPath が記述されているスキーマのバージョン。デフォルトは "v1" です。 |
|
| 指定された API バージョンで選択するフィールドのパス。 |
14.12.1.262. .spec.volumes[].downwardAPI.items[].resourceFieldRef
- 説明
- ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。
- タイプ
-
object
- 必須
-
resource
-
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナー名: ボリュームには必須、env 変数にはオプション |
| 公開されたリソースの出力形式を指定します。デフォルトは "1" です。 | |
|
| 必須: 選択するリソース |
14.12.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.12.1.264. .spec.volumes[].ephemeral
- 説明
- 通常のストレージドライバーによって処理される一時的なボリュームを表します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| PersistentVolumeClaimTemplate は、EphemeralVolumeSource の一部として PersistentVolumeClaim オブジェクトを生成するために使用されます。 |
14.12.1.265. .spec.volumes[].ephemeral.volumeClaimTemplate
- 説明
- PersistentVolumeClaimTemplate は、EphemeralVolumeSource の一部として PersistentVolumeClaim オブジェクトを生成するために使用されます。
- タイプ
-
object
- 必須
-
spec
-
プロパティー | 型 | 説明 |
---|---|---|
| PVC の作成時に PVC にコピーされるラベルとアノテーションが含まれる場合があります。他のフィールドは許可されておらず、検証中に拒否されます。 | |
|
| PersistentVolumeClaimSpec は、ストレージデバイスの一般的な属性を記述し、プロバイダー固有の属性のソースを許可します |
14.12.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.12.1.267. .spec.volumes[].ephemeral.volumeClaimTemplate.spec.dataSource
- 説明
- TypedLocalObjectReference には、同じ namespace 内で typed 参照オブジェクトを見つけるのに十分な情報が含まれます。
- タイプ
-
object
- 必須
-
kind
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| APIGroup は参照されているリソースのグループです。APIGroup が指定されていない場合には、指定の Kind をコア API グループに設定する必要があります。他のサードパーティータイプについては、APIGroup が必要です。 |
|
| kind は参照されているリソースのタイプです。 |
|
| name は、参照されているリソースの名前です。 |
14.12.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.12.1.269. .spec.volumes[].ephemeral.volumeClaimTemplate.spec.resources
- 説明
- ResourceRequirements は、コンピュートリソースの要件を説明します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。 これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。 このフィールドは不変です。これはコンテナーにのみ設定できます。 |
|
| ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。 |
| 制限は、許容されるコンピュートリソースの最大量を記述します。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 | |
| 要求は、必要なコンピュートリソースの最小量を記述します。コンテナーについて Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
14.12.1.270. .spec.volumes[].ephemeral.volumeClaimTemplate.spec.resources.claims
- 説明
Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。
これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。
このフィールドは不変です。これはコンテナーにのみ設定できます。
- タイプ
-
array
14.12.1.271. .spec.volumes[].ephemeral.volumeClaimTemplate.spec.resources.claims[]
- 説明
- ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。
- タイプ
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。 |
14.12.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.12.1.273. .spec.volumes[].flexVolume
- 説明
- FlexVolume は、exec ベースのプラグインを使用してプロビジョニング/接続される汎用ボリュームリソースを表します。
- タイプ
-
object
- 必須
-
driver
-
プロパティー | 型 | 説明 |
---|---|---|
|
| driver は、このボリュームに使用するドライバーの名前です。 |
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。デフォルトのファイルシステムは FlexVolume スクリプトに依存します。 |
|
| options は任意: このフィールドには追加のコマンドオプションがあれば保持されます。 |
|
| readOnly は任意: デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。 |
|
| LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。 |
14.12.1.274. .spec.volumes[].flexVolume.secretRef
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
14.12.1.275. .spec.volumes[].flocker
- 説明
- Flocker エージェントによってマウントされた Flocker ボリュームを表します。datasetName および datasetUUID の 1 つだけを設定する必要があります。Flocker ボリュームは、所有権管理または SELinux の再ラベル付けをサポートしていません。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
|
datasetName はメタデータとして保存されているデータセットの名前です |
|
| datasetUUID は、データセットの UUID です。これは Flocker データセットの一意の識別子です |
14.12.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#awselasticblockstore |
|
| partition は、マウントするボリューム内のパーティションです。省略した場合、デフォルトではボリューム名でマウントします。例: ボリューム/dev/sda1 の場合、パーティションを "1" として指定します。同様に、/dev/sda のボリュームパーティションは "0" です (または、プロパティーを空のままにしておくこともできます)。詳細: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
|
| pdName は、GCE の PD リソースの一意の名前です。GCE でディスクを識別するために使用されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
|
| この readOnly は、VolumeMounts で ReadOnly 設定が強制的に指定されます。デフォルトは false です。詳細: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
14.12.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.12.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.12.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.12.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.12.1.281. .spec.volumes[].iscsi.secretRef
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
14.12.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.12.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.12.1.284. .spec.volumes[].photonPersistentDisk
- 説明
- Photon Controller 永続ディスクリソースを表します。
- タイプ
-
object
- 必須
-
pdID
-
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。 |
|
| pdID は、Photon Controller の永続ディスクを識別する ID です。 |
14.12.1.285. .spec.volumes[].portworxVolume
- 説明
- PortworxVolumeSource は、Portworx ボリュームリソースを表します。
- タイプ
-
object
- 必須
-
volumeID
-
プロパティー | 型 | 説明 |
---|---|---|
|
| fSType は、マウントするファイルシステムタイプを表します。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。 |
|
| readOnly のデフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。 |
|
| volumeID は、Portworx ボリュームを一意に識別します |
14.12.1.286. .spec.volumes[].projected
- 説明
- Projected ボリュームソースを表します
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| defaultMode は、作成されたファイルにデフォルトでアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。パス内のディレクトリーはこの設定の影響を受けません。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| source は、ボリュームプロジェクションのリストです。 |
|
| サポートされている他のボリュームタイプと一緒にデプロイメントされる可能性のあるプロジェクション |
14.12.1.287. .spec.volumes[].projected.sources
- 説明
- source は、ボリュームプロジェクションのリストです。
- タイプ
-
array
14.12.1.288. .spec.volumes[].projected.sources[]
- 説明
- サポートされている他のボリュームタイプと一緒にデプロイメントされる可能性のあるプロジェクション
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ConfigMap をデプロイメントされたボリュームに適合させます。 項目要素にパスへのキーの特定のマッピングが入力されていない限り、ターゲットの ConfigMap のデータフィールドの内容は、データフィールドのキーをファイル名として使用してファイルとしてデプロイメントされるボリュームに表示されます。これは、デフォルトモードのない configmap ボリュームソースと同じであることに注意してください。 |
|
| デプロイメントされたボリュームにデプロイメントするための Downward API 情報を表します。これは、デフォルトモードのない downwardAPI ボリュームソースと同じであることに注意してください。 |
|
| シークレットを、デプロイメントされたボリュームに適合させます。 ターゲットシークレットの Data フィールドの内容は、ファイル名として Data フィールドのキーを使用して、ファイルとしてデプロイメントされたボリュームに表示されます。これは、デフォルトモードのないシークレットボリュームソースと同じであることに注意してください。 |
|
| ServiceAccountTokenProjection は、デプロイメントされるサービスアカウントトークンボリュームを表します。このプロジェクションを使用して、API (Kubernetes API サーバーなど) に対して使用するサービスアカウントトークンを Pod ランタイムファイルシステムに挿入できます。 |
14.12.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.12.1.290. .spec.volumes[].projected.sources[].configMap.items
- 説明
- item が指定されていない場合、参照される ConfigMap の Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。ConfigMap に存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。
- タイプ
-
array
14.12.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 などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| oath はキーをマップするファイルの相対パスです。絶対的なパスではない可能性があります。パス要素 '..' を含めることはできません。文字列 '..' で始まらない場合があります。 |
14.12.1.292. .spec.volumes[].projected.sources[].downwardAPI
- 説明
- デプロイメントされたボリュームにデプロイメントするための Downward API 情報を表します。これは、デフォルトモードのない downwardAPI ボリュームソースと同じであることに注意してください。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Items は DownwardAPIVolume ファイルのリストです |
|
| DownwardAPIVolumeFile は、Pod フィールドを含むファイルを作成するための情報を表します |
14.12.1.293. .spec.volumes[].projected.sources[].downwardAPI.items
- 説明
- Items は DownwardAPIVolume ファイルのリストです
- タイプ
-
array
14.12.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.12.1.295. .spec.volumes[].projected.sources[].downwardAPI.items[].fieldRef
- 説明
- ObjectFieldSelector は、オブジェクトの APIVersioned フィールドを選択します。
- タイプ
-
object
- 必須
-
fieldPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| FieldPath が記述されているスキーマのバージョン。デフォルトは "v1" です。 |
|
| 指定された API バージョンで選択するフィールドのパス。 |
14.12.1.296. .spec.volumes[].projected.sources[].downwardAPI.items[].resourceFieldRef
- 説明
- ResourceFieldSelector は、コンテナーリソース (CPU、メモリー) とその出力形式を表します。
- タイプ
-
object
- 必須
-
resource
-
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナー名: ボリュームには必須、env 変数にはオプション |
| 公開されたリソースの出力形式を指定します。デフォルトは "1" です。 | |
|
| 必須: 選択するリソース |
14.12.1.297. .spec.volumes[].projected.sources[].secret
- 説明
シークレットを、デプロイメントされたボリュームに適合させます。
ターゲットシークレットの Data フィールドの内容は、ファイル名として Data フィールドのキーを使用して、ファイルとしてデプロイメントされたボリュームに表示されます。これは、デフォルトモードのないシークレットボリュームソースと同じであることに注意してください。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| items が指定されていない場合、参照されるシークレットの Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。シークレットに存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。 |
|
| 文字列キーをボリューム内のパスにマップします。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| オプションフィールドは、シークレットかそのキーを定義する必要があるかどうかを指定します。 |
14.12.1.298. .spec.volumes[].projected.sources[].secret.items
- 説明
- items が指定されていない場合、参照されるシークレットの Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。シークレットに存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。
- タイプ
-
array
14.12.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 などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| oath はキーをマップするファイルの相対パスです。絶対的なパスではない可能性があります。パス要素 '..' を含めることはできません。文字列 '..' で始まらない場合があります。 |
14.12.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.12.1.301. .spec.volumes[].quobyte
- 説明
- Pod の存続期間中続く Quobyte マウントを表します。Quobyte ボリュームは、所有権管理または SELinux の再ラベル付けをサポートしていません。
- タイプ
-
object
- 必須
-
registry
-
ボリューム
-
プロパティー | 型 | 説明 |
---|---|---|
|
| アクセスできるボリュームをマップするグループ。デフォルトは no group です。 |
|
| ここでの readOnly は、Quobyte ボリュームを読み取り専用のアクセス権限で強制的にマウントします。デフォルトは false です。 |
|
| registry は、host:port ペアの文字列として指定された単一または複数の Quobyte Registry サービスを表し (複数のエントリーはコンマで区切る)、ボリュームの中央レジストリーとして機能します。 |
|
| 動的にプロビジョニングされた Quobyte ボリュームで使用されるバックエンドで指定の Quobyte ボリュームを所有するテナント。値はプラグインにより設定されます。 |
|
| アクセスできるボリュームをマップするグループ。デフォルトは serivceaccount user です。 |
|
| volume は、すでに作成されているクオバイトボリュームを名前で参照する文字列です。 |
14.12.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.12.1.303. .spec.volumes[].rbd.secretRef
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
14.12.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.12.1.305. .spec.volumes[].scaleIO.secretRef
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
14.12.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.12.1.307. .spec.volumes[].secret.items
- 説明
- items が指定されていない場合、参照されるシークレットの Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。シークレットに存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。
- タイプ
-
array
14.12.1.308. .spec.volumes[].secret.items[]
- 説明
- 文字列キーをボリューム内のパスにマップします。
- タイプ
-
object
- 必須
-
key
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key はプロジェクトのキーです。 |
|
| mode は任意: このファイルにアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| oath はキーをマップするファイルの相対パスです。絶対的なパスではない可能性があります。パス要素 '..' を含めることはできません。文字列 '..' で始まらない場合があります。 |
14.12.1.309. .spec.volumes[].storageos
- 説明
- StorageOS 永続ボリュームリソースを表します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。 |
|
| readOnly のデフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。 |
|
| LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。 |
|
| volumeName は、人間が判読えきる形式の StorageOS ボリュームの名前です。ボリューム名は、ネームスペース内でのみ一意です。 |
|
| volumeNamespace は、StorageOS 内のボリュームのスコープを指定します。名前空間が指定されていない場合は、Pod の名前空間が使用されます。これにより、Kubernetes の名前スコープを StorageOS 内にミラーリングして、より緊密に統合することができます。VolumeName を任意の名前に設定して、デフォルトの動作をオーバーライドします。StorageOS 内で namespace を使用していない場合は、"デフォルト" に設定します。StorageOS 内に事前に存在しない名前空間が作成されます。 |
14.12.1.310. .spec.volumes[].storageos.secretRef
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
14.12.1.311. .spec.volumes[].vsphereVolume
- 説明
- vSphere ボリュームリソースを表します。
- タイプ
-
object
- 必須
-
volumePath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。 |
|
| storagePolicyID は、StoragePolicyName に関連付けられたストレージポリシーベースの管理 (SPBM) プロファイル ID です。 |
|
| storagePolicyName は、ストレージポリシーベースの管理 (SPBM) プロファイル名です。 |
|
| volumePath は、vSphere ボリューム vmdk を識別するパスです。 |
14.12.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 には、このコンテナーの現在のステータスの詳細が含まれています。 |
|
| Pod が割り当てられているホストの 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 に割り当てられる IP アドレス少なくともクラスター内でルーティング可能。まだ割り当てられていない場合は空にします。 |
|
| podIPs は、Pod に割り当てられた IP アドレスを保持します。このフィールドを指定する場合、0 番目のエントリーは podIP フィールドと一致する必要があります。Pod には、IPv4 と IPv6 のそれぞれに最大 1 つの値を割り当てることができます。IP がまだ割り当てられていない場合は、このリストが空です。 |
|
| (複数) PodIPs フィールドのエントリーの IP アドレス情報。各エントリーには以下が含まれます。 IP: Pod に割り当てられた IP アドレス。少なくともクラスター内でルーティング可能。 |
|
| リソース要件に基づいて Pod に割り当てられたサービス品質 (QOS) 分類利用可能な QOS クラスについては、PodQOSClass タイプを参照してください。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-qos/#quality-of - サービスクラス
使用可能な列挙値: - |
|
| Pod がこの状態にある理由の詳細を示す簡単な CamelCase メッセージ。たとえば、以下のようになります。'Evicted' |
|
| Pod のコンテナーに必要とされるリソースサイズ変更のステータス。リソースのサイズ変更が保留中の場合は、空になります。コンテナーリソースに変更を加えると、これが自動的に "Proposed" に設定されます。 |
| オブジェクトが Kubelet によって確認された RFC3339 の日付および時刻。これは、Kubelet が Pod のコンテナーイメージをプルする前です。 |
14.12.1.313. .status.conditions
- 説明
- Pod の現在のサービス状態。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-conditions
- タイプ
-
array
14.12.1.314. .status.conditions[]
- 説明
- PodCondition には、この Pod の現在の状態の詳細が含まれています。
- タイプ
-
object
- 必須
-
type
-
status
-
プロパティー | 型 | 説明 |
---|---|---|
| 最後に状態を調べました。 | |
| 最後にある状態から別の状態に遷移した時間。 | |
|
| 最後にある状態から別の状態に遷移した時間。 |
|
| 条件の最後の遷移の一意の 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.12.1.315. .status.containerStatuses
- 説明
- リストには、マニフェストのコンテナーごとに 1 つのエントリーがあります。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-and-container-status
- タイプ
-
array
14.12.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 プローブが再度実行されます。startProbe が定義されておらず、コンテナーが実行中で、postStart ライフサイクルフックに合格している場合は、常に true です。null 値は false と同じように処理される必要があります。 |
|
| ContainerState は、コンテナーの可能な状態を保持します。そのメンバーの 1 つだけを指定できます。それらのいずれも指定していないと、デフォルトは ContainerStateWaiting です。 |
14.12.1.317. .status.containerStatuses[].lastState
- 説明
- ContainerState は、コンテナーの可能な状態を保持します。そのメンバーの 1 つだけを指定できます。それらのいずれも指定していないと、デフォルトは ContainerStateWaiting です。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ContainerStateRunning は、コンテナーの実行状態です。 |
|
| ContainerStateTerminated は、コンテナーの終了状態です。 |
|
| ContainerStateWaiting は、コンテナーの待機状態です。 |
14.12.1.318. .status.containerStatuses[].lastState.running
- 説明
- ContainerStateRunning は、コンテナーの実行状態です。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
| コンテナーが最後に (再) 起動した時刻 |
14.12.1.319. .status.containerStatuses[].lastState.terminated
- 説明
- ContainerStateTerminated は、コンテナーの終了状態です。
- タイプ
-
object
- 必須
-
exitCode
-
プロパティー | 型 | 説明 |
---|---|---|
|
| <type>://<container_id> 形式のコンテナーの ID |
|
| コンテナーの最後の終了からの終了ステータス |
| コンテナーが最後に終了した時刻 | |
|
| コンテナーの最後の終了に関するメッセージ |
|
| コンテナーの最後の終了からの (簡単な) 理由 |
|
| コンテナーの最後の終了からのシグナル |
| コンテナーの前回の実行が開始された時刻 |
14.12.1.320. .status.containerStatuses[].lastState.waiting
- 説明
- ContainerStateWaiting は、コンテナーの待機状態です。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナーがまだ実行されていない理由に関するメッセージ。 |
|
| コンテナーがまだ実行されていない (簡単な) 理由。 |
14.12.1.321. .status.containerStatuses[].resources
- 説明
- ResourceRequirements は、コンピュートリソースの要件を説明します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。 これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。 このフィールドは不変です。これはコンテナーにのみ設定できます。 |
|
| ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。 |
| 制限は、許容されるコンピュートリソースの最大量を記述します。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 | |
| 要求は、必要なコンピュートリソースの最小量を記述します。コンテナーについて Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
14.12.1.322. .status.containerStatuses[].resources.claims
- 説明
Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。
これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。
このフィールドは不変です。これはコンテナーにのみ設定できます。
- タイプ
-
array
14.12.1.323. .status.containerStatuses[].resources.claims[]
- 説明
- ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。
- タイプ
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。 |
14.12.1.324. .status.containerStatuses[].state
- 説明
- ContainerState は、コンテナーの可能な状態を保持します。そのメンバーの 1 つだけを指定できます。それらのいずれも指定していないと、デフォルトは ContainerStateWaiting です。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ContainerStateRunning は、コンテナーの実行状態です。 |
|
| ContainerStateTerminated は、コンテナーの終了状態です。 |
|
| ContainerStateWaiting は、コンテナーの待機状態です。 |
14.12.1.325. .status.containerStatuses[].state.running
- 説明
- ContainerStateRunning は、コンテナーの実行状態です。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
| コンテナーが最後に (再) 起動した時刻 |
14.12.1.326. .status.containerStatuses[].state.terminated
- 説明
- ContainerStateTerminated は、コンテナーの終了状態です。
- タイプ
-
object
- 必須
-
exitCode
-
プロパティー | 型 | 説明 |
---|---|---|
|
| <type>://<container_id> 形式のコンテナーの ID |
|
| コンテナーの最後の終了からの終了ステータス |
| コンテナーが最後に終了した時刻 | |
|
| コンテナーの最後の終了に関するメッセージ |
|
| コンテナーの最後の終了からの (簡単な) 理由 |
|
| コンテナーの最後の終了からのシグナル |
| コンテナーの前回の実行が開始された時刻 |
14.12.1.327. .status.containerStatuses[].state.waiting
- 説明
- ContainerStateWaiting は、コンテナーの待機状態です。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナーがまだ実行されていない理由に関するメッセージ。 |
|
| コンテナーがまだ実行されていない (簡単な) 理由。 |
14.12.1.328. .status.ephemeralContainerStatuses
- 説明
- この Pod で実行されたエフェメラルコンテナーのステータス。
- タイプ
-
array
14.12.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 プローブが再度実行されます。startProbe が定義されておらず、コンテナーが実行中で、postStart ライフサイクルフックに合格している場合は、常に true です。null 値は false と同じように処理される必要があります。 |
|
| ContainerState は、コンテナーの可能な状態を保持します。そのメンバーの 1 つだけを指定できます。それらのいずれも指定していないと、デフォルトは ContainerStateWaiting です。 |
14.12.1.330. .status.ephemeralContainerStatuses[].lastState
- 説明
- ContainerState は、コンテナーの可能な状態を保持します。そのメンバーの 1 つだけを指定できます。それらのいずれも指定していないと、デフォルトは ContainerStateWaiting です。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ContainerStateRunning は、コンテナーの実行状態です。 |
|
| ContainerStateTerminated は、コンテナーの終了状態です。 |
|
| ContainerStateWaiting は、コンテナーの待機状態です。 |
14.12.1.331. .status.ephemeralContainerStatuses[].lastState.running
- 説明
- ContainerStateRunning は、コンテナーの実行状態です。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
| コンテナーが最後に (再) 起動した時刻 |
14.12.1.332. .status.ephemeralContainerStatuses[].lastState.terminated
- 説明
- ContainerStateTerminated は、コンテナーの終了状態です。
- タイプ
-
object
- 必須
-
exitCode
-
プロパティー | 型 | 説明 |
---|---|---|
|
| <type>://<container_id> 形式のコンテナーの ID |
|
| コンテナーの最後の終了からの終了ステータス |
| コンテナーが最後に終了した時刻 | |
|
| コンテナーの最後の終了に関するメッセージ |
|
| コンテナーの最後の終了からの (簡単な) 理由 |
|
| コンテナーの最後の終了からのシグナル |
| コンテナーの前回の実行が開始された時刻 |
14.12.1.333. .status.ephemeralContainerStatuses[].lastState.waiting
- 説明
- ContainerStateWaiting は、コンテナーの待機状態です。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナーがまだ実行されていない理由に関するメッセージ。 |
|
| コンテナーがまだ実行されていない (簡単な) 理由。 |
14.12.1.334. .status.ephemeralContainerStatuses[].resources
- 説明
- ResourceRequirements は、コンピュートリソースの要件を説明します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。 これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。 このフィールドは不変です。これはコンテナーにのみ設定できます。 |
|
| ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。 |
| 制限は、許容されるコンピュートリソースの最大量を記述します。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 | |
| 要求は、必要なコンピュートリソースの最小量を記述します。コンテナーについて Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
14.12.1.335. .status.ephemeralContainerStatuses[].resources.claims
- 説明
Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。
これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。
このフィールドは不変です。これはコンテナーにのみ設定できます。
- タイプ
-
array
14.12.1.336. .status.ephemeralContainerStatuses[].resources.claims[]
- 説明
- ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。
- タイプ
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。 |
14.12.1.337. .status.ephemeralContainerStatuses[].state
- 説明
- ContainerState は、コンテナーの可能な状態を保持します。そのメンバーの 1 つだけを指定できます。それらのいずれも指定していないと、デフォルトは ContainerStateWaiting です。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ContainerStateRunning は、コンテナーの実行状態です。 |
|
| ContainerStateTerminated は、コンテナーの終了状態です。 |
|
| ContainerStateWaiting は、コンテナーの待機状態です。 |
14.12.1.338. .status.ephemeralContainerStatuses[].state.running
- 説明
- ContainerStateRunning は、コンテナーの実行状態です。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
| コンテナーが最後に (再) 起動した時刻 |
14.12.1.339. .status.ephemeralContainerStatuses[].state.terminated
- 説明
- ContainerStateTerminated は、コンテナーの終了状態です。
- タイプ
-
object
- 必須
-
exitCode
-
プロパティー | 型 | 説明 |
---|---|---|
|
| <type>://<container_id> 形式のコンテナーの ID |
|
| コンテナーの最後の終了からの終了ステータス |
| コンテナーが最後に終了した時刻 | |
|
| コンテナーの最後の終了に関するメッセージ |
|
| コンテナーの最後の終了からの (簡単な) 理由 |
|
| コンテナーの最後の終了からのシグナル |
| コンテナーの前回の実行が開始された時刻 |
14.12.1.340. .status.ephemeralContainerStatuses[].state.waiting
- 説明
- ContainerStateWaiting は、コンテナーの待機状態です。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナーがまだ実行されていない理由に関するメッセージ。 |
|
| コンテナーがまだ実行されていない (簡単な) 理由。 |
14.12.1.341. .status.initContainerStatuses
- 説明
- リストには、マニフェストの init コンテナーごとに 1 つのエントリーがあります。最後に成功した init コンテナーには ready = true が設定され、最後に起動したコンテナーには startTime が設定されます。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-and-container-status
- タイプ
-
array
14.12.1.342. .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 プローブが再度実行されます。startProbe が定義されておらず、コンテナーが実行中で、postStart ライフサイクルフックに合格している場合は、常に true です。null 値は false と同じように処理される必要があります。 |
|
| ContainerState は、コンテナーの可能な状態を保持します。そのメンバーの 1 つだけを指定できます。それらのいずれも指定していないと、デフォルトは ContainerStateWaiting です。 |
14.12.1.343. .status.initContainerStatuses[].lastState
- 説明
- ContainerState は、コンテナーの可能な状態を保持します。そのメンバーの 1 つだけを指定できます。それらのいずれも指定していないと、デフォルトは ContainerStateWaiting です。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ContainerStateRunning は、コンテナーの実行状態です。 |
|
| ContainerStateTerminated は、コンテナーの終了状態です。 |
|
| ContainerStateWaiting は、コンテナーの待機状態です。 |
14.12.1.344. .status.initContainerStatuses[].lastState.running
- 説明
- ContainerStateRunning は、コンテナーの実行状態です。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
| コンテナーが最後に (再) 起動した時刻 |
14.12.1.345. .status.initContainerStatuses[].lastState.terminated
- 説明
- ContainerStateTerminated は、コンテナーの終了状態です。
- タイプ
-
object
- 必須
-
exitCode
-
プロパティー | 型 | 説明 |
---|---|---|
|
| <type>://<container_id> 形式のコンテナーの ID |
|
| コンテナーの最後の終了からの終了ステータス |
| コンテナーが最後に終了した時刻 | |
|
| コンテナーの最後の終了に関するメッセージ |
|
| コンテナーの最後の終了からの (簡単な) 理由 |
|
| コンテナーの最後の終了からのシグナル |
| コンテナーの前回の実行が開始された時刻 |
14.12.1.346. .status.initContainerStatuses[].lastState.waiting
- 説明
- ContainerStateWaiting は、コンテナーの待機状態です。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナーがまだ実行されていない理由に関するメッセージ。 |
|
| コンテナーがまだ実行されていない (簡単な) 理由。 |
14.12.1.347. .status.initContainerStatuses[].resources
- 説明
- ResourceRequirements は、コンピュートリソースの要件を説明します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。 これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。 このフィールドは不変です。これはコンテナーにのみ設定できます。 |
|
| ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。 |
| 制限は、許容されるコンピュートリソースの最大量を記述します。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 | |
| 要求は、必要なコンピュートリソースの最小量を記述します。コンテナーについて Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
14.12.1.348. .status.initContainerStatuses[].resources.claims
- 説明
Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。
これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。
このフィールドは不変です。これはコンテナーにのみ設定できます。
- タイプ
-
array
14.12.1.349. .status.initContainerStatuses[].resources.claims[]
- 説明
- ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。
- タイプ
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。 |
14.12.1.350. .status.initContainerStatuses[].state
- 説明
- ContainerState は、コンテナーの可能な状態を保持します。そのメンバーの 1 つだけを指定できます。それらのいずれも指定していないと、デフォルトは ContainerStateWaiting です。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ContainerStateRunning は、コンテナーの実行状態です。 |
|
| ContainerStateTerminated は、コンテナーの終了状態です。 |
|
| ContainerStateWaiting は、コンテナーの待機状態です。 |
14.12.1.351. .status.initContainerStatuses[].state.running
- 説明
- ContainerStateRunning は、コンテナーの実行状態です。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
| コンテナーが最後に (再) 起動した時刻 |
14.12.1.352. .status.initContainerStatuses[].state.terminated
- 説明
- ContainerStateTerminated は、コンテナーの終了状態です。
- タイプ
-
object
- 必須
-
exitCode
-
プロパティー | 型 | 説明 |
---|---|---|
|
| <type>://<container_id> 形式のコンテナーの ID |
|
| コンテナーの最後の終了からの終了ステータス |
| コンテナーが最後に終了した時刻 | |
|
| コンテナーの最後の終了に関するメッセージ |
|
| コンテナーの最後の終了からの (簡単な) 理由 |
|
| コンテナーの最後の終了からのシグナル |
| コンテナーの前回の実行が開始された時刻 |
14.12.1.353. .status.initContainerStatuses[].state.waiting
- 説明
- ContainerStateWaiting は、コンテナーの待機状態です。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナーがまだ実行されていない理由に関するメッセージ。 |
|
| コンテナーがまだ実行されていない (簡単な) 理由。 |
14.12.1.354. .status.podIPs
- 説明
- podIPs は、Pod に割り当てられた IP アドレスを保持します。このフィールドを指定する場合、0 番目のエントリーは podIP フィールドと一致する必要があります。Pod には、IPv4 と IPv6 のそれぞれに最大 1 つの値を割り当てることができます。IP がまだ割り当てられていない場合は、このリストが空です。
- タイプ
-
array
14.12.1.355. .status.podIPs[]
- 説明
(複数) PodIPs フィールドのエントリーの IP アドレス情報。各エントリーには以下が含まれます。
IP: An IP address allocated to the pod. Routable at least within the cluster.
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ip は、Pod に割り当てられた IP アドレス (IPv4 または IPv6) です。 |
14.12.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.12.2.1. /api/v1/pods
パラメーター | 型 | 説明 |
---|---|---|
|
| allowWatchBookmarks は、タイプが BOOKMARK の監視イベントを要求します。ブックマークを実装していないサーバーはこのフラグを無視する可能性があり、ブックマークはサーバーの判断で送信されます。クライアントは、ブックマークが特定の間隔で返される、またはサーバーがセッション中に BOOKMARK イベントを送信すると想定するべきではありません。これが watch でない場合は、このフィールドが無視されます。 |
|
| サーバーからさらに結果を取得する場合は、continue オプションを設定する必要があります。この値はサーバー定義であるため、クライアントは同じクエリーパラメーター (continue の値を除く) で、以前のクエリー結果からの continue 値のみを使用でき、サーバーは認識できない continue 値を拒否する可能性があります。指定された continue の値が有効期限切れ (通常 5-15 分) やサーバーでの設定変更により無効となった場合、サーバーは 410 ResourceExpired エラーと continue トークンを返します。クライアントが一貫性のあるリストを必要とする場合は、続行フィールドなしでリストを再起動する必要があります。必要としない場合、クライアントは 410 エラーで受信したトークンを使用して別のリスト要求を送信できます。サーバーは次のキーから始まるリストで応答しますが、最新のスナップショットから取得するため、以前のリストの結果とは矛盾します。作成、変更、または削除されたオブジェクトは、キーが「次のキー」の後にある限り応答に含まれます。 watch が true の場合、このフィールドはサポートされません。クライアントは、サーバーから返された最後の resourceVersion 値から監視を開始し、変更を見逃すことはありません。 |
|
| 返されるオブジェクトのリストをフィールドごとに制限するセレクター。デフォルトは everything です。 |
|
| 返されるオブジェクトのリストをラベルで制限するためのセレクター。デフォルトは everything です。 |
|
| limit は、リスト呼び出しに対して返される応答の最大数です。他にもアイテムが存在する場合は、サーバーは、リストのメタデータ上の `continue` フィールドを、同じ初期クエリーで使用できる値に設定して、次の結果セットを取得します。制限を設定すると、要求されたすべてのオブジェクトが除外された場合に、要求された量より少ないアイテム (最大 0 個のアイテム) が返される場合があります。クライアントは、続行フィールドの存在のみを使用して、より多くの結果が利用可能かどうかを判断する必要があります。サーバーは limit 引数をサポートしない場合もあり、その場合は利用可能なすべての結果を返します。制限が指定され、続行フィールドが空の場合、クライアントはこれ以上結果が利用できないと想定する場合があります。watch が true の場合、このフィールドはサポートされません。 サーバーは、continue を使用したときに返されるオブジェクトが、制限なしで単一のリスト呼び出しを発行するのと同じであることを保証します。つまり、最初の要求が発行された後に作成、変更、または削除されたオブジェクトは、後続の継続要求に含まれません。これは、一貫性のあるスナップショットと呼ばれることもあり、limit を使用して非常にサイズの大きい結果が小さめのチャンクに分けて受信することで、考えられるオブジェクトがすべて表示されるようにします。チャンクリスト中にオブジェクトが更新された場合は、最初のリスト結果が計算されたときに存在していたオブジェクトのバージョンが返されます。 |
|
| true の場合は、出力が整形表示 (Pretty-print) されます。 |
|
| resourceVersion は、要求を処理できるリソースのバージョンに関する制約を設定します。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。 デフォルトは unset です。 |
|
| resourceVersionMatch は、resourceVersion をリスト呼び出しに適用する方法を決定します。resourceVersion が設定されているリスト呼び出しには resourceVersionMatch を設定することが強く推奨されます。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。 デフォルトは unset です。 |
|
| `sendInitialEvents=true` may be set together with `watch=true`.その場合、監視ストリームは合成イベントで始まり、コレクション内のオブジェクトの現在の状態を生成します。このようなイベントがすべて送信されると、合成的 "Bookmark" イベントが送信されます。ブックマークはオブジェクトのセットに対応する ResourceVersion (RV) を報告し、`"k8s.io/initial-events-end": "true"` アノテーションが付けられます。その後、監視ストリームは通常どおり続行され、(RV に続く) 変更に対応する監視イベントが監視対象のオブジェクトに送信されます。 'sendInitialEvents' オプションが設定されている場合、resourceVersionMatch オプションも設定する必要があります。監視リクエストのセマンティクスとして、`resourceVersionMatch` = NotOlderThan は、最低でも、指定された `resourceVersion` と同程度に新しいデータとして解釈され、最低でも状態が ListOptions が指定したものと同程度に新しい `resourceVersion` に同期される場合にブックバークイベントが送信されます。 `resourceVersion` が設定されていない場合、"consistent read" として解釈され、少なくともリクエストの処理が開始された瞬間までの状態が同期されると、ブックマークイベントが送信されます。- `resourceVersionMatch` を他の値に設定するか、未設定にすると、無効なエラーが返されます。 `resourceVersion=""` または `resourceVersion="0"` (下位互換性の目的) の場合、デフォルトは true、それ以外の場合は false です。 |
|
| リスト/ウォッチ呼び出しのタイムアウト。これにより、アクティビティーの有無に関係なく、呼び出し時間が制限されます。 |
|
| 記述されたリソースへの変更を監視し、追加、更新、および削除通知のストリームとして返します。resourceVersion を指定します。 |
- HTTP メソッド
-
GET
- 説明
- Pod 種類のオブジェクトをリスト表示または監視するロール
HTTP コード | 応答本文 |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
14.12.2.2. /api/v1/watch/pods
パラメーター | 型 | 説明 |
---|---|---|
|
| allowWatchBookmarks は、タイプが BOOKMARK の監視イベントを要求します。ブックマークを実装していないサーバーはこのフラグを無視する可能性があり、ブックマークはサーバーの判断で送信されます。クライアントは、ブックマークが特定の間隔で返される、またはサーバーがセッション中に BOOKMARK イベントを送信すると想定するべきではありません。これが watch でない場合は、このフィールドが無視されます。 |
|
| サーバーからさらに結果を取得する場合は、continue オプションを設定する必要があります。この値はサーバー定義であるため、クライアントは同じクエリーパラメーター (continue の値を除く) で、以前のクエリー結果からの continue 値のみを使用でき、サーバーは認識できない continue 値を拒否する可能性があります。指定された continue の値が有効期限切れ (通常 5-15 分) やサーバーでの設定変更により無効となった場合、サーバーは 410 ResourceExpired エラーと continue トークンを返します。クライアントが一貫性のあるリストを必要とする場合は、続行フィールドなしでリストを再起動する必要があります。必要としない場合、クライアントは 410 エラーで受信したトークンを使用して別のリスト要求を送信できます。サーバーは次のキーから始まるリストで応答しますが、最新のスナップショットから取得するため、以前のリストの結果とは矛盾します。作成、変更、または削除されたオブジェクトは、キーが「次のキー」の後にある限り応答に含まれます。 watch が true の場合、このフィールドはサポートされません。クライアントは、サーバーから返された最後の resourceVersion 値から監視を開始し、変更を見逃すことはありません。 |
|
| 返されるオブジェクトのリストをフィールドごとに制限するセレクター。デフォルトは everything です。 |
|
| 返されるオブジェクトのリストをラベルで制限するためのセレクター。デフォルトは everything です。 |
|
| limit は、リスト呼び出しに対して返される応答の最大数です。他にもアイテムが存在する場合は、サーバーは、リストのメタデータ上の `continue` フィールドを、同じ初期クエリーで使用できる値に設定して、次の結果セットを取得します。制限を設定すると、要求されたすべてのオブジェクトが除外された場合に、要求された量より少ないアイテム (最大 0 個のアイテム) が返される場合があります。クライアントは、続行フィールドの存在のみを使用して、より多くの結果が利用可能かどうかを判断する必要があります。サーバーは limit 引数をサポートしない場合もあり、その場合は利用可能なすべての結果を返します。制限が指定され、続行フィールドが空の場合、クライアントはこれ以上結果が利用できないと想定する場合があります。watch が true の場合、このフィールドはサポートされません。 サーバーは、continue を使用したときに返されるオブジェクトが、制限なしで単一のリスト呼び出しを発行するのと同じであることを保証します。つまり、最初の要求が発行された後に作成、変更、または削除されたオブジェクトは、後続の継続要求に含まれません。これは、一貫性のあるスナップショットと呼ばれることもあり、limit を使用して非常にサイズの大きい結果が小さめのチャンクに分けて受信することで、考えられるオブジェクトがすべて表示されるようにします。チャンクリスト中にオブジェクトが更新された場合は、最初のリスト結果が計算されたときに存在していたオブジェクトのバージョンが返されます。 |
|
| true の場合は、出力が整形表示 (Pretty-print) されます。 |
|
| resourceVersion は、要求を処理できるリソースのバージョンに関する制約を設定します。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。 デフォルトは unset です。 |
|
| resourceVersionMatch は、resourceVersion をリスト呼び出しに適用する方法を決定します。resourceVersion が設定されているリスト呼び出しには resourceVersionMatch を設定することが強く推奨されます。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。 デフォルトは unset です。 |
|
| `sendInitialEvents=true` may be set together with `watch=true`.その場合、監視ストリームは合成イベントで始まり、コレクション内のオブジェクトの現在の状態を生成します。このようなイベントがすべて送信されると、合成的 "Bookmark" イベントが送信されます。ブックマークはオブジェクトのセットに対応する ResourceVersion (RV) を報告し、`"k8s.io/initial-events-end": "true"` アノテーションが付けられます。その後、監視ストリームは通常どおり続行され、(RV に続く) 変更に対応する監視イベントが監視対象のオブジェクトに送信されます。 'sendInitialEvents' オプションが設定されている場合、resourceVersionMatch オプションも設定する必要があります。監視リクエストのセマンティクスとして、`resourceVersionMatch` = NotOlderThan は、最低でも、指定された `resourceVersion` と同程度に新しいデータとして解釈され、最低でも状態が ListOptions が指定したものと同程度に新しい `resourceVersion` に同期される場合にブックバークイベントが送信されます。 `resourceVersion` が設定されていない場合、"consistent read" として解釈され、少なくともリクエストの処理が開始された瞬間までの状態が同期されると、ブックマークイベントが送信されます。- `resourceVersionMatch` を他の値に設定するか、未設定にすると、無効なエラーが返されます。 `resourceVersion=""` または `resourceVersion="0"` (下位互換性の目的) の場合、デフォルトは true、それ以外の場合は false です。 |
|
| リスト/ウォッチ呼び出しのタイムアウト。これにより、アクティビティーの有無に関係なく、呼び出し時間が制限されます。 |
|
| 記述されたリソースへの変更を監視し、追加、更新、および削除通知のストリームとして返します。resourceVersion を指定します。 |
- HTTP メソッド
-
GET
- 説明
- Pod のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で watch パラメーターを使用してください。
HTTP コード | 応答本文 |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
14.12.2.3. /api/v1/namespaces/{namespace}/pods
パラメーター | 型 | 説明 |
---|---|---|
|
| チームやプロジェクトなどのオブジェクト名と認証スコープ |
パラメーター | 型 | 説明 |
---|---|---|
|
| true の場合は、出力が整形表示 (Pretty-print) されます。 |
- HTTP メソッド
-
DELETE
- 説明
- Pod のコレクションを削除する
パラメーター | 型 | 説明 |
---|---|---|
|
| サーバーからさらに結果を取得する場合は、continue オプションを設定する必要があります。この値はサーバー定義であるため、クライアントは同じクエリーパラメーター (continue の値を除く) で、以前のクエリー結果からの continue 値のみを使用でき、サーバーは認識できない continue 値を拒否する可能性があります。指定された continue の値が有効期限切れ (通常 5-15 分) やサーバーでの設定変更により無効となった場合、サーバーは 410 ResourceExpired エラーと continue トークンを返します。クライアントが一貫性のあるリストを必要とする場合は、続行フィールドなしでリストを再起動する必要があります。必要としない場合、クライアントは 410 エラーで受信したトークンを使用して別のリスト要求を送信できます。サーバーは次のキーから始まるリストで応答しますが、最新のスナップショットから取得するため、以前のリストの結果とは矛盾します。作成、変更、または削除されたオブジェクトは、キーが「次のキー」の後にある限り応答に含まれます。 watch が true の場合、このフィールドはサポートされません。クライアントは、サーバーから返された最後の resourceVersion 値から監視を開始し、変更を見逃すことはありません。 |
|
| これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべての dryRun ステージが処理されます。 |
|
| 返されるオブジェクトのリストをフィールドごとに制限するセレクター。デフォルトは everything です。 |
|
| オブジェクトが削除されるまでの時間 (秒)。値は負の値ではない整数にする必要があります。値をゼロに指定すると、ただちに削除されます。この値が nil の場合は、指定されたタイプのデフォルトの猶予期間が使用されます。指定しない場合は、デフォルトでオブジェクトごとの値になります。ゼロはすぐに削除することを意味します。 |
|
| 返されるオブジェクトのリストをラベルで制限するためのセレクター。デフォルトは everything です。 |
|
| limit は、リスト呼び出しに対して返される応答の最大数です。他にもアイテムが存在する場合は、サーバーは、リストのメタデータ上の `continue` フィールドを、同じ初期クエリーで使用できる値に設定して、次の結果セットを取得します。制限を設定すると、要求されたすべてのオブジェクトが除外された場合に、要求された量より少ないアイテム (最大 0 個のアイテム) が返される場合があります。クライアントは、続行フィールドの存在のみを使用して、より多くの結果が利用可能かどうかを判断する必要があります。サーバーは limit 引数をサポートしない場合もあり、その場合は利用可能なすべての結果を返します。制限が指定され、続行フィールドが空の場合、クライアントはこれ以上結果が利用できないと想定する場合があります。watch が true の場合、このフィールドはサポートされません。 サーバーは、continue を使用したときに返されるオブジェクトが、制限なしで単一のリスト呼び出しを発行するのと同じであることを保証します。つまり、最初の要求が発行された後に作成、変更、または削除されたオブジェクトは、後続の継続要求に含まれません。これは、一貫性のあるスナップショットと呼ばれることもあり、limit を使用して非常にサイズの大きい結果が小さめのチャンクに分けて受信することで、考えられるオブジェクトがすべて表示されるようにします。チャンクリスト中にオブジェクトが更新された場合は、最初のリスト結果が計算されたときに存在していたオブジェクトのバージョンが返されます。 |
|
| 非推奨。PropagationPolicy を使用してください。このフィールドは 1.7 で非推奨となります。依存オブジェクトが孤立している必要があります。true/false の場合は、孤立したファイナライザーがオブジェクトのファイナライザー一覧で追加/削除されます。このフィールドまたは PropagationPolicy のいずれかを設定できますが、両方を設定できません。 |
|
| ガベージコレクションが実行されるかどうか、およびその方法。このフィールドまたは OrphanDependents のどちらかを設定できますが、両方を設定できません。デフォルトポリシーは、metadata.finalizers に設定されている既存のファイナライザーとリソース固有のデフォルトポリシーによって決定されます。許容値は次のとおりです。'Orphan' - 依存を削除して孤立させます。'Background' - ガベージコレクターがバックグラウンドで依存関係を削除できるようにします。'Foreground' - フォアグラウンド内のすべての依存関係を削除するカスケードポリシーです。 |
|
| resourceVersion は、要求を処理できるリソースのバージョンに関する制約を設定します。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。 デフォルトは unset です。 |
|
| resourceVersionMatch は、resourceVersion をリスト呼び出しに適用する方法を決定します。resourceVersion が設定されているリスト呼び出しには resourceVersionMatch を設定することが強く推奨されます。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。 デフォルトは unset です。 |
|
| `sendInitialEvents=true` may be set together with `watch=true`.その場合、監視ストリームは合成イベントで始まり、コレクション内のオブジェクトの現在の状態を生成します。このようなイベントがすべて送信されると、合成的 "Bookmark" イベントが送信されます。ブックマークはオブジェクトのセットに対応する ResourceVersion (RV) を報告し、`"k8s.io/initial-events-end": "true"` アノテーションが付けられます。その後、監視ストリームは通常どおり続行され、(RV に続く) 変更に対応する監視イベントが監視対象のオブジェクトに送信されます。 'sendInitialEvents' オプションが設定されている場合、resourceVersionMatch オプションも設定する必要があります。監視リクエストのセマンティクスとして、`resourceVersionMatch` = NotOlderThan は、最低でも、指定された `resourceVersion` と同程度に新しいデータとして解釈され、最低でも状態が ListOptions が指定したものと同程度に新しい `resourceVersion` に同期される場合にブックバークイベントが送信されます。 `resourceVersion` が設定されていない場合、"consistent read" として解釈され、少なくともリクエストの処理が開始された瞬間までの状態が同期されると、ブックマークイベントが送信されます。- `resourceVersionMatch` を他の値に設定するか、未設定にすると、無効なエラーが返されます。 `resourceVersion=""` または `resourceVersion="0"` (下位互換性の目的) の場合、デフォルトは true、それ以外の場合は false です。 |
|
| リスト/ウォッチ呼び出しのタイムアウト。これにより、アクティビティーの有無に関係なく、呼び出し時間が制限されます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
HTTP コード | 応答本文 |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
GET
- 説明
- Pod 種類のオブジェクトをリスト表示または監視するロール
パラメーター | 型 | 説明 |
---|---|---|
|
| allowWatchBookmarks は、タイプが BOOKMARK の監視イベントを要求します。ブックマークを実装していないサーバーはこのフラグを無視する可能性があり、ブックマークはサーバーの判断で送信されます。クライアントは、ブックマークが特定の間隔で返される、またはサーバーがセッション中に BOOKMARK イベントを送信すると想定するべきではありません。これが watch でない場合は、このフィールドが無視されます。 |
|
| サーバーからさらに結果を取得する場合は、continue オプションを設定する必要があります。この値はサーバー定義であるため、クライアントは同じクエリーパラメーター (continue の値を除く) で、以前のクエリー結果からの continue 値のみを使用でき、サーバーは認識できない continue 値を拒否する可能性があります。指定された continue の値が有効期限切れ (通常 5-15 分) やサーバーでの設定変更により無効となった場合、サーバーは 410 ResourceExpired エラーと continue トークンを返します。クライアントが一貫性のあるリストを必要とする場合は、続行フィールドなしでリストを再起動する必要があります。必要としない場合、クライアントは 410 エラーで受信したトークンを使用して別のリスト要求を送信できます。サーバーは次のキーから始まるリストで応答しますが、最新のスナップショットから取得するため、以前のリストの結果とは矛盾します。作成、変更、または削除されたオブジェクトは、キーが「次のキー」の後にある限り応答に含まれます。 watch が true の場合、このフィールドはサポートされません。クライアントは、サーバーから返された最後の resourceVersion 値から監視を開始し、変更を見逃すことはありません。 |
|
| 返されるオブジェクトのリストをフィールドごとに制限するセレクター。デフォルトは everything です。 |
|
| 返されるオブジェクトのリストをラベルで制限するためのセレクター。デフォルトは everything です。 |
|
| limit は、リスト呼び出しに対して返される応答の最大数です。他にもアイテムが存在する場合は、サーバーは、リストのメタデータ上の `continue` フィールドを、同じ初期クエリーで使用できる値に設定して、次の結果セットを取得します。制限を設定すると、要求されたすべてのオブジェクトが除外された場合に、要求された量より少ないアイテム (最大 0 個のアイテム) が返される場合があります。クライアントは、続行フィールドの存在のみを使用して、より多くの結果が利用可能かどうかを判断する必要があります。サーバーは limit 引数をサポートしない場合もあり、その場合は利用可能なすべての結果を返します。制限が指定され、続行フィールドが空の場合、クライアントはこれ以上結果が利用できないと想定する場合があります。watch が true の場合、このフィールドはサポートされません。 サーバーは、continue を使用したときに返されるオブジェクトが、制限なしで単一のリスト呼び出しを発行するのと同じであることを保証します。つまり、最初の要求が発行された後に作成、変更、または削除されたオブジェクトは、後続の継続要求に含まれません。これは、一貫性のあるスナップショットと呼ばれることもあり、limit を使用して非常にサイズの大きい結果が小さめのチャンクに分けて受信することで、考えられるオブジェクトがすべて表示されるようにします。チャンクリスト中にオブジェクトが更新された場合は、最初のリスト結果が計算されたときに存在していたオブジェクトのバージョンが返されます。 |
|
| resourceVersion は、要求を処理できるリソースのバージョンに関する制約を設定します。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。 デフォルトは unset です。 |
|
| resourceVersionMatch は、resourceVersion をリスト呼び出しに適用する方法を決定します。resourceVersion が設定されているリスト呼び出しには resourceVersionMatch を設定することが強く推奨されます。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。 デフォルトは unset です。 |
|
| `sendInitialEvents=true` may be set together with `watch=true`.その場合、監視ストリームは合成イベントで始まり、コレクション内のオブジェクトの現在の状態を生成します。このようなイベントがすべて送信されると、合成的 "Bookmark" イベントが送信されます。ブックマークはオブジェクトのセットに対応する ResourceVersion (RV) を報告し、`"k8s.io/initial-events-end": "true"` アノテーションが付けられます。その後、監視ストリームは通常どおり続行され、(RV に続く) 変更に対応する監視イベントが監視対象のオブジェクトに送信されます。 'sendInitialEvents' オプションが設定されている場合、resourceVersionMatch オプションも設定する必要があります。監視リクエストのセマンティクスとして、`resourceVersionMatch` = NotOlderThan は、最低でも、指定された `resourceVersion` と同程度に新しいデータとして解釈され、最低でも状態が ListOptions が指定したものと同程度に新しい `resourceVersion` に同期される場合にブックバークイベントが送信されます。 `resourceVersion` が設定されていない場合、"consistent read" として解釈され、少なくともリクエストの処理が開始された瞬間までの状態が同期されると、ブックマークイベントが送信されます。- `resourceVersionMatch` を他の値に設定するか、未設定にすると、無効なエラーが返されます。 `resourceVersion=""` または `resourceVersion="0"` (下位互換性の目的) の場合、デフォルトは true、それ以外の場合は false です。 |
|
| リスト/ウォッチ呼び出しのタイムアウト。これにより、アクティビティーの有無に関係なく、呼び出し時間が制限されます。 |
|
| 記述されたリソースへの変更を監視し、追加、更新、および削除通知のストリームとして返します。resourceVersion を指定します。 |
HTTP コード | 応答本文 |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
POST
- 説明
- Pod を作成する
パラメーター | 型 | 説明 |
---|---|---|
|
| これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべての dryRun ステージが処理されます。 |
|
| fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
HTTP コード | 応答本文 |
---|---|
200 - OK |
|
201 - Created |
|
202 - Accepted |
|
401 - Unauthorized | 空白 |
14.12.2.4. /api/v1/watch/namespaces/{namespace}/pods
パラメーター | 型 | 説明 |
---|---|---|
|
| チームやプロジェクトなどのオブジェクト名と認証スコープ |
パラメーター | 型 | 説明 |
---|---|---|
|
| allowWatchBookmarks は、タイプが BOOKMARK の監視イベントを要求します。ブックマークを実装していないサーバーはこのフラグを無視する可能性があり、ブックマークはサーバーの判断で送信されます。クライアントは、ブックマークが特定の間隔で返される、またはサーバーがセッション中に BOOKMARK イベントを送信すると想定するべきではありません。これが watch でない場合は、このフィールドが無視されます。 |
|
| サーバーからさらに結果を取得する場合は、continue オプションを設定する必要があります。この値はサーバー定義であるため、クライアントは同じクエリーパラメーター (continue の値を除く) で、以前のクエリー結果からの continue 値のみを使用でき、サーバーは認識できない continue 値を拒否する可能性があります。指定された continue の値が有効期限切れ (通常 5-15 分) やサーバーでの設定変更により無効となった場合、サーバーは 410 ResourceExpired エラーと continue トークンを返します。クライアントが一貫性のあるリストを必要とする場合は、続行フィールドなしでリストを再起動する必要があります。必要としない場合、クライアントは 410 エラーで受信したトークンを使用して別のリスト要求を送信できます。サーバーは次のキーから始まるリストで応答しますが、最新のスナップショットから取得するため、以前のリストの結果とは矛盾します。作成、変更、または削除されたオブジェクトは、キーが「次のキー」の後にある限り応答に含まれます。 watch が true の場合、このフィールドはサポートされません。クライアントは、サーバーから返された最後の resourceVersion 値から監視を開始し、変更を見逃すことはありません。 |
|
| 返されるオブジェクトのリストをフィールドごとに制限するセレクター。デフォルトは everything です。 |
|
| 返されるオブジェクトのリストをラベルで制限するためのセレクター。デフォルトは everything です。 |
|
| limit は、リスト呼び出しに対して返される応答の最大数です。他にもアイテムが存在する場合は、サーバーは、リストのメタデータ上の `continue` フィールドを、同じ初期クエリーで使用できる値に設定して、次の結果セットを取得します。制限を設定すると、要求されたすべてのオブジェクトが除外された場合に、要求された量より少ないアイテム (最大 0 個のアイテム) が返される場合があります。クライアントは、続行フィールドの存在のみを使用して、より多くの結果が利用可能かどうかを判断する必要があります。サーバーは limit 引数をサポートしない場合もあり、その場合は利用可能なすべての結果を返します。制限が指定され、続行フィールドが空の場合、クライアントはこれ以上結果が利用できないと想定する場合があります。watch が true の場合、このフィールドはサポートされません。 サーバーは、continue を使用したときに返されるオブジェクトが、制限なしで単一のリスト呼び出しを発行するのと同じであることを保証します。つまり、最初の要求が発行された後に作成、変更、または削除されたオブジェクトは、後続の継続要求に含まれません。これは、一貫性のあるスナップショットと呼ばれることもあり、limit を使用して非常にサイズの大きい結果が小さめのチャンクに分けて受信することで、考えられるオブジェクトがすべて表示されるようにします。チャンクリスト中にオブジェクトが更新された場合は、最初のリスト結果が計算されたときに存在していたオブジェクトのバージョンが返されます。 |
|
| true の場合は、出力が整形表示 (Pretty-print) されます。 |
|
| resourceVersion は、要求を処理できるリソースのバージョンに関する制約を設定します。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。 デフォルトは unset です。 |
|
| resourceVersionMatch は、resourceVersion をリスト呼び出しに適用する方法を決定します。resourceVersion が設定されているリスト呼び出しには resourceVersionMatch を設定することが強く推奨されます。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。 デフォルトは unset です。 |
|
| `sendInitialEvents=true` may be set together with `watch=true`.その場合、監視ストリームは合成イベントで始まり、コレクション内のオブジェクトの現在の状態を生成します。このようなイベントがすべて送信されると、合成的 "Bookmark" イベントが送信されます。ブックマークはオブジェクトのセットに対応する ResourceVersion (RV) を報告し、`"k8s.io/initial-events-end": "true"` アノテーションが付けられます。その後、監視ストリームは通常どおり続行され、(RV に続く) 変更に対応する監視イベントが監視対象のオブジェクトに送信されます。 'sendInitialEvents' オプションが設定されている場合、resourceVersionMatch オプションも設定する必要があります。監視リクエストのセマンティクスとして、`resourceVersionMatch` = NotOlderThan は、最低でも、指定された `resourceVersion` と同程度に新しいデータとして解釈され、最低でも状態が ListOptions が指定したものと同程度に新しい `resourceVersion` に同期される場合にブックバークイベントが送信されます。 `resourceVersion` が設定されていない場合、"consistent read" として解釈され、少なくともリクエストの処理が開始された瞬間までの状態が同期されると、ブックマークイベントが送信されます。- `resourceVersionMatch` を他の値に設定するか、未設定にすると、無効なエラーが返されます。 `resourceVersion=""` または `resourceVersion="0"` (下位互換性の目的) の場合、デフォルトは true、それ以外の場合は false です。 |
|
| リスト/ウォッチ呼び出しのタイムアウト。これにより、アクティビティーの有無に関係なく、呼び出し時間が制限されます。 |
|
| 記述されたリソースへの変更を監視し、追加、更新、および削除通知のストリームとして返します。resourceVersion を指定します。 |
- HTTP メソッド
-
GET
- 説明
- Pod のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で watch パラメーターを使用してください。
HTTP コード | 応答本文 |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
14.12.2.5. /api/v1/namespaces/{namespace}/pods/{name}
パラメーター | 型 | 説明 |
---|---|---|
|
| Pod の名前 |
|
| チームやプロジェクトなどのオブジェクト名と認証スコープ |
パラメーター | 型 | 説明 |
---|---|---|
|
| true の場合は、出力が整形表示 (Pretty-print) されます。 |
- HTTP メソッド
-
DELETE
- 説明
- Pod を削除する
パラメーター | 型 | 説明 |
---|---|---|
|
| これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべての dryRun ステージが処理されます。 |
|
| オブジェクトが削除されるまでの時間 (秒)。値は負の値ではない整数にする必要があります。値をゼロに指定すると、ただちに削除されます。この値が nil の場合は、指定されたタイプのデフォルトの猶予期間が使用されます。指定しない場合は、デフォルトでオブジェクトごとの値になります。ゼロはすぐに削除することを意味します。 |
|
| 非推奨。PropagationPolicy を使用してください。このフィールドは 1.7 で非推奨となります。依存オブジェクトが孤立している必要があります。true/false の場合は、孤立したファイナライザーがオブジェクトのファイナライザー一覧で追加/削除されます。このフィールドまたは PropagationPolicy のいずれかを設定できますが、両方を設定できません。 |
|
| ガベージコレクションが実行されるかどうか、およびその方法。このフィールドまたは OrphanDependents のどちらかを設定できますが、両方を設定できません。デフォルトポリシーは、metadata.finalizers に設定されている既存のファイナライザーとリソース固有のデフォルトポリシーによって決定されます。許容値は次のとおりです。'Orphan' - 依存を削除して孤立させます。'Background' - ガベージコレクターがバックグラウンドで依存関係を削除できるようにします。'Foreground' - フォアグラウンド内のすべての依存関係を削除するカスケードポリシーです。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
HTTP コード | 応答本文 |
---|---|
200 - OK |
|
202 - Accepted |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
GET
- 説明
- 指定された Pod を読み取る
HTTP コード | 応答本文 |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PATCH
- 説明
- 指定された DNS を部分的に更新する
パラメーター | 型 | 説明 |
---|---|---|
|
| これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべての dryRun ステージが処理されます。 |
|
| fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。このフィールドは、apply 要求 (application/apply-patch) の場合は必須ですが、apply 以外のパッチタイプ (JsonPatch、MergePatch、StrategicMergePatch) の場合は任意です。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
|
| Force は、Apply 要求を強制します。これは、ユーザーが他の人が所有する競合するフィールドを再取得することを意味します。非適用パッチ要求の場合は、強制フラグを設定解除する必要があります。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
HTTP コード | 応答本文 |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PUT
- 説明
- 指定された Pod を置き換える
パラメーター | 型 | 説明 |
---|---|---|
|
| これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべての dryRun ステージが処理されます。 |
|
| fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
HTTP コード | 応答本文 |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
14.12.2.6. /api/v1/namespaces/{namespace}/pods/{name}/log
パラメーター | 型 | 説明 |
---|---|---|
|
| Pod の名前 |
|
| チームやプロジェクトなどのオブジェクト名と認証スコープ |
パラメーター | 型 | 説明 |
---|---|---|
|
| ログをストリーミングするコンテナー。Pod にコンテナーが 1 つある場合、デフォルトではコンテナーのみになります。 |
|
| Pod のログストリームを追跡します。デフォルトは false です。 |
|
| insecureSkipTLSVerifyBackend は、apiserver が接続先のバックエンドの提供証明書の有効性を確認してはならないことを示します。これにより、apiserver とバックエンド間の HTTPS 接続が安全でなくなります。これは、apiserver が受け取っているログデータが実際の kubelet からのものであることを確認できないことを意味します。kubelet が apiserver の TLS 認証情報を検証するように設定されている場合は、実際の kubelet への接続が中間者攻撃に対して脆弱であることを意味するわけではありません (たとえば、攻撃者は実際の kubelet からの実際のログデータを傍受できませんでした)。 |
|
| 設定されている場合は、ログ出力を終了する前にサーバーから読み取るバイト数。これにより、ロギングの完全な最終行が表示されない場合があり、指定された制限よりわずかに多いまたはわずかに少ない値が返される場合があります。 |
|
| 'true' の場合、出力はきれいに印刷されます。 |
|
| 以前に終了したコンテナーログを返します。デフォルトは false です。 |
|
| ログを表示する現在の時刻より前の相対時間 (秒単位)。この値が Pod の開始時刻より前の場合は、Pod の開始以降のログのみが返されます。この値が将来の場合は、ログが返されません。sinceSeconds または sinceTime のいずれか 1 つのみを指定できます。 |
|
| 設定されている場合は、表示するログの最後からの行数。指定しない場合、ログはコンテナーの作成時、sinceSeconds、sinceTime から表示されます |
|
| true の場合は、ログ出力のすべての行の先頭に RFC3339 または RFC3339Nano タイムスタンプを追加します。デフォルトは false です。 |
- HTTP メソッド
-
GET
- 説明
- 指定された Pod のログを読み取る
HTTP コード | 応答本文 |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
14.12.2.7. /api/v1/watch/namespaces/{namespace}/pods/{name}
パラメーター | 型 | 説明 |
---|---|---|
|
| Pod の名前 |
|
| チームやプロジェクトなどのオブジェクト名と認証スコープ |
パラメーター | 型 | 説明 |
---|---|---|
|
| allowWatchBookmarks は、タイプが BOOKMARK の監視イベントを要求します。ブックマークを実装していないサーバーはこのフラグを無視する可能性があり、ブックマークはサーバーの判断で送信されます。クライアントは、ブックマークが特定の間隔で返される、またはサーバーがセッション中に BOOKMARK イベントを送信すると想定するべきではありません。これが watch でない場合は、このフィールドが無視されます。 |
|
| サーバーからさらに結果を取得する場合は、continue オプションを設定する必要があります。この値はサーバー定義であるため、クライアントは同じクエリーパラメーター (continue の値を除く) で、以前のクエリー結果からの continue 値のみを使用でき、サーバーは認識できない continue 値を拒否する可能性があります。指定された continue の値が有効期限切れ (通常 5-15 分) やサーバーでの設定変更により無効となった場合、サーバーは 410 ResourceExpired エラーと continue トークンを返します。クライアントが一貫性のあるリストを必要とする場合は、続行フィールドなしでリストを再起動する必要があります。必要としない場合、クライアントは 410 エラーで受信したトークンを使用して別のリスト要求を送信できます。サーバーは次のキーから始まるリストで応答しますが、最新のスナップショットから取得するため、以前のリストの結果とは矛盾します。作成、変更、または削除されたオブジェクトは、キーが「次のキー」の後にある限り応答に含まれます。 watch が true の場合、このフィールドはサポートされません。クライアントは、サーバーから返された最後の resourceVersion 値から監視を開始し、変更を見逃すことはありません。 |
|
| 返されるオブジェクトのリストをフィールドごとに制限するセレクター。デフォルトは everything です。 |
|
| 返されるオブジェクトのリストをラベルで制限するためのセレクター。デフォルトは everything です。 |
|
| limit は、リスト呼び出しに対して返される応答の最大数です。他にもアイテムが存在する場合は、サーバーは、リストのメタデータ上の `continue` フィールドを、同じ初期クエリーで使用できる値に設定して、次の結果セットを取得します。制限を設定すると、要求されたすべてのオブジェクトが除外された場合に、要求された量より少ないアイテム (最大 0 個のアイテム) が返される場合があります。クライアントは、続行フィールドの存在のみを使用して、より多くの結果が利用可能かどうかを判断する必要があります。サーバーは limit 引数をサポートしない場合もあり、その場合は利用可能なすべての結果を返します。制限が指定され、続行フィールドが空の場合、クライアントはこれ以上結果が利用できないと想定する場合があります。watch が true の場合、このフィールドはサポートされません。 サーバーは、continue を使用したときに返されるオブジェクトが、制限なしで単一のリスト呼び出しを発行するのと同じであることを保証します。つまり、最初の要求が発行された後に作成、変更、または削除されたオブジェクトは、後続の継続要求に含まれません。これは、一貫性のあるスナップショットと呼ばれることもあり、limit を使用して非常にサイズの大きい結果が小さめのチャンクに分けて受信することで、考えられるオブジェクトがすべて表示されるようにします。チャンクリスト中にオブジェクトが更新された場合は、最初のリスト結果が計算されたときに存在していたオブジェクトのバージョンが返されます。 |
|
| true の場合は、出力が整形表示 (Pretty-print) されます。 |
|
| resourceVersion は、要求を処理できるリソースのバージョンに関する制約を設定します。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。 デフォルトは unset です。 |
|
| resourceVersionMatch は、resourceVersion をリスト呼び出しに適用する方法を決定します。resourceVersion が設定されているリスト呼び出しには resourceVersionMatch を設定することが強く推奨されます。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。 デフォルトは unset です。 |
|
| `sendInitialEvents=true` may be set together with `watch=true`.その場合、監視ストリームは合成イベントで始まり、コレクション内のオブジェクトの現在の状態を生成します。このようなイベントがすべて送信されると、合成的 "Bookmark" イベントが送信されます。ブックマークはオブジェクトのセットに対応する ResourceVersion (RV) を報告し、`"k8s.io/initial-events-end": "true"` アノテーションが付けられます。その後、監視ストリームは通常どおり続行され、(RV に続く) 変更に対応する監視イベントが監視対象のオブジェクトに送信されます。 'sendInitialEvents' オプションが設定されている場合、resourceVersionMatch オプションも設定する必要があります。監視リクエストのセマンティクスとして、`resourceVersionMatch` = NotOlderThan は、最低でも、指定された `resourceVersion` と同程度に新しいデータとして解釈され、最低でも状態が ListOptions が指定したものと同程度に新しい `resourceVersion` に同期される場合にブックバークイベントが送信されます。 `resourceVersion` が設定されていない場合、"consistent read" として解釈され、少なくともリクエストの処理が開始された瞬間までの状態が同期されると、ブックマークイベントが送信されます。- `resourceVersionMatch` を他の値に設定するか、未設定にすると、無効なエラーが返されます。 `resourceVersion=""` または `resourceVersion="0"` (下位互換性の目的) の場合、デフォルトは true、それ以外の場合は false です。 |
|
| リスト/ウォッチ呼び出しのタイムアウト。これにより、アクティビティーの有無に関係なく、呼び出し時間が制限されます。 |
|
| 記述されたリソースへの変更を監視し、追加、更新、および削除通知のストリームとして返します。resourceVersion を指定します。 |
- HTTP メソッド
-
GET
- 説明
- Pod 種類のオブジェクトへの変更を監視します。非推奨: 代わりに、リスト操作で watch パラメーターを使用し、fieldSelector パラメーターで単一の項目にフィルター処理します。
HTTP コード | 応答本文 |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
14.12.2.8. /api/v1/namespaces/{namespace}/pods/{name}/status
パラメーター | 型 | 説明 |
---|---|---|
|
| Pod の名前 |
|
| チームやプロジェクトなどのオブジェクト名と認証スコープ |
パラメーター | 型 | 説明 |
---|---|---|
|
| true の場合は、出力が整形表示 (Pretty-print) されます。 |
- HTTP メソッド
-
GET
- 説明
- 指定された Pod のステータスを読み取る
HTTP コード | 応答本文 |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PATCH
- 説明
- 指定された Pod のステータスを部分的に更新する
パラメーター | 型 | 説明 |
---|---|---|
|
| これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべての dryRun ステージが処理されます。 |
|
| fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。このフィールドは、apply 要求 (application/apply-patch) の場合は必須ですが、apply 以外のパッチタイプ (JsonPatch、MergePatch、StrategicMergePatch) の場合は任意です。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
|
| Force は、Apply 要求を強制します。これは、ユーザーが他の人が所有する競合するフィールドを再取得することを意味します。非適用パッチ要求の場合は、強制フラグを設定解除する必要があります。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
HTTP コード | 応答本文 |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PUT
- 説明
- 指定された Pod のステータスを置き換える
パラメーター | 型 | 説明 |
---|---|---|
|
| これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべての dryRun ステージが処理されます。 |
|
| fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
HTTP コード | 応答本文 |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | Empty |
14.12.2.9. /api/v1/namespaces/{namespace}/pods/{name}/ephemeralcontainers
パラメーター | 型 | 説明 |
---|---|---|
|
| Pod の名前 |
|
| チームやプロジェクトなどのオブジェクト名と認証スコープ |
パラメーター | 型 | 説明 |
---|---|---|
|
| true の場合は、出力が整形表示 (Pretty-print) されます。 |
- HTTP メソッド
-
GET
- 説明
- 指定された Pod の一時コンテナーを読み取ります。
HTTP コード | 応答本文 |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PATCH
- 説明
- 指定された Pod の一時コンテナーを部分的に更新します。
パラメーター | 型 | 説明 |
---|---|---|
|
| これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべての dryRun ステージが処理されます。 |
|
| fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。このフィールドは、apply 要求 (application/apply-patch) の場合は必須ですが、apply 以外のパッチタイプ (JsonPatch、MergePatch、StrategicMergePatch) の場合は任意です。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
|
| Force は、Apply 要求を強制します。これは、ユーザーが他の人が所有する競合するフィールドを再取得することを意味します。非適用パッチ要求の場合は、強制フラグを設定解除する必要があります。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
HTTP コード | 応答本文 |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |
- HTTP メソッド
-
PUT
- 説明
- 指定された Pod の一時コンテナーを置き換えます。
パラメーター | 型 | 説明 |
---|---|---|
|
| これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべての dryRun ステージが処理されます。 |
|
| fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。 |
|
| fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです - Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。 |
パラメーター | 型 | 説明 |
---|---|---|
|
|
HTTP コード | 応答本文 |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空白 |