第8章 Prometheus [monitoring.coreos.com/v1]
- 説明
Prometheus
カスタムリソース定義 (CRD) は、Kubernetes クラスターで実行するために必要な [Prometheus](https://prometheus.io/docs/prometheus) のセットアップを定義します。レプリカの数、永続ストレージ、アラートの送信先となる Alertmanager など、さまざまなオプションを指定できます。各
Prometheus
リソースに対して、Operator が同じ namespace に 1 つまたは複数のStatefulSet
オブジェクトをデプロイします。StatefulSet の数はシャードの数と同じで、デフォルトでは 1 です。このリソースでは、ラベルセレクターと namespace セレクターを使用して、デプロイする Prometheus インスタンスに関連付ける
ServiceMonitor
、PodMonitor
、Probe
、およびPrometheusRule
オブジェクトを定義します。Operator はスクレイピングとルールの設定を継続的に調整します。Prometheus Pod で実行されるサイドカーコンテナーが、必要に応じて設定の再読み込みをトリガーします。
- 型
-
object
- 必須
-
spec
-
8.1. 仕様
プロパティー | 型 | 説明 |
---|---|---|
|
| apiVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。 |
|
| kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できる場合があります。これは更新できません。CamelCase を使用します。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。 |
| 標準オブジェクトのメタデータ。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。 | |
|
| Prometheus クラスターの望ましい動作の仕様。詳細: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status |
|
| Prometheus クラスターの最新の観測ステータス。read-only詳細: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status |
8.1.1. .spec
- 説明
- Prometheus クラスターの望ましい動作の仕様。詳細: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| AdditionalAlertManagerConfigs は、追加の Prometheus Alertmanager 設定を含む Secret のキーを指定します。Alertmanager 設定は、Prometheus Operator によって生成された設定に追加されます。これらは、Prometheus の公式ドキュメントに従ってフォーマットする必要があります。 https://prometheus.io/docs/prometheus/latest/configuration/configuration/#alertmanager_config ユーザーは、設定が有効であることを確認する責任があります この機能を使用すると、Prometheus のアップグレードが中断される可能性があることに注意してください。アップグレード後に互換性のない AlertManager 設定が Prometheus を壊さないように、Prometheus リリースノートを確認することを推奨します。 |
|
| additionalAlertRelabelConfigs は、追加の Prometheus アラートのラベル再設定の設定を含む Secret のキーを指定します。アラートのラベル再設定の設定は、Prometheus Operator によって生成された設定に追加されます。これらは、Prometheus の公式ドキュメントに従ってフォーマットする必要があります。 https://prometheus.io/docs/prometheus/latest/configuration/configuration/#alert_relabel_configs ユーザーは、設定が有効であることを確認する責任があります この機能を使用すると、Prometheus のアップグレードが中断される可能性があることに注意してください。Prometheus のリリースノートを確認して、アップグレード後に互換性のないアラートのラベル変更設定によって Prometheus が破損しないようにすることを推奨します。 |
|
| additionalArgs を使用すると、'prometheus' コンテナーに追加の引数を設定できます。 これは、専用の設定オプションではまだサポートされていない隠しフラグを有効にする場合などに使用されます。引数はそのまま Prometheus コンテナーに渡されますが、引数が無効であったり、指定された Prometheus バージョンでサポートされていない場合は問題が発生する可能性があります。 引数が競合する場合 (たとえば、Operator によってすでに設定されている引数)、または無効な引数を指定すると、調整は失敗し、エラーが記録されます。 |
|
| AdditionalArgs リストの一部である引数。 |
|
| AdditionalScrapeConfigs を使用すると、追加の Prometheus スクレイプ設定を含むシークレットのキーを指定できます。指定されたスクレープ設定は、Prometheus Operator によって生成された設定に追加されます。指定するジョブ設定は、Prometheus の公式ドキュメント https://prometheus.io/docs/prometheus/latest/configuration/configuration/#scrape_config で指定されている形式である必要があります。スクレイプ設定が追加されると、ユーザーはそれが有効であることを確認する責任があります。この機能を使用すると、Prometheus のアップグレードが中断される可能性があることに注意してください。アップグレード後に互換性のないスクレイプ設定が Prometheus を壊さないように、Prometheus リリースノートを確認することを推奨します。 |
|
| 指定されている場合、Pod のアフィニティースケジューリングルールを定義します。 |
|
| Alertmanager に関連する設定を定義します。 |
|
| AllowOverlappingBlocks は、Prometheus での垂直圧縮と垂直クエリーマージを有効にします。 非推奨: このフラグは、重複ブロックがデフォルトで有効になっている Prometheus 2.39.0 以降では効果がありません。 |
|
| APIServerConfig を使用すると、Kuberntees API サーバーにアクセスするためのホストと認証方法を指定できます。null の場合、Prometheus はクラスター内で実行されると想定され、API サーバーが自動的に検出され、Pod の CA 証明書とベアラートークンファイル (/var/run/secrets/kubernetes.io/serviceaccount/) が使用されます。 |
|
|
true の場合、ServiceMonitor、PodMonitor、および Probe オブジェクトは、'Prometheus' コンテナーのファイルシステム上の任意のファイルを参照することが禁止されます。ServiceMonitor のエンドポイントが |
|
| AutomountServiceAccountToken は、Pod にサービスアカウントトークンを自動的にマウントする必要があるかどうかを示します。このフィールドが設定されていない場合、Operator はデフォルトでサービスアカウントトークンをマウントします。 警告: デフォルトでは、Prometheus は Kubernetes サービスの検出にサービスアカウントトークンを必要とすることに注意してください。ストラトジックマージパッチを使用して、サービスアカウントトークンを 'Prometheus' コンテナーに投影できます。 |
|
| 非推奨: 代わりに 'spec.image' を使用します。 |
|
| bodySizeLimit は、スクレイプごとのレスポンスボディーのサイズを定義します。Prometheus バージョン 2.45.0 以降でのみ有効です。 グローバル制限は、明示的な制限値を指定しないスクレイプオブジェクトにのみ適用されることに注意してください。すべてのスクレイプオブジェクトに最大制限を適用する場合は、enforcedBodySizeLimit を参照してください。 |
|
|
ConfigMaps は、Prometheus オブジェクトと同じ namespace にある ConfigMap のリストであり、Prometheus Pod にマウントされます。各 ConfigMap は、 |
|
| コンテナーを使用すると、追加のコンテナーを挿入したり、Operator が生成したコンテナーを変更したりできます。これを使用すると、Pod に認証プロキシーを追加したり、Operator が生成したコンテナーの動作を変更したりすることができます。ここで説明するコンテナーは、同じ名前を共有し、戦略的マージパッチを介して変更が行われる場合、Operator が生成したコンテナーを変更します。
Operator によって管理されるコンテナーの名前は次のとおりです: * コンテナーのオーバーライドは、メンテナーがサポートする範囲外であり、そうすることで、この動作が予告なしにいつでも中断する可能性があることを認めます。 |
|
| Pod 内で実行する単一のアプリケーションコンテナー。 |
|
| true の場合、Prometheus 圧縮は無効になります。 |
|
| Pod の DNS 設定を定義します。 |
|
| Pod の DNS ポリシーを定義します。 |
|
| Prometheus Web 管理 API へのアクセスを有効にします。 警告: 管理 API を有効にすると、エンドポイントの変更、データの削除、Prometheus のシャットダウンなどが可能になります。これを有効にする場合は注意が必要です。ユーザーは、これらのアクションの実行を許可されたクライアントのみが許可できるように、プロキシーを介して追加の認証許可を追加することを推奨します。 詳細は、https://prometheus.io/docs/prometheus/latest/querying/api/#tsdb-admin-apis を参照してください。 |
|
| Prometheus 機能フラグへのアクセスを有効にします。デフォルトでは、機能は有効になっていません。 デフォルトで無効になっている機能を有効にすることは、完全にメンテナーのサポート範囲外であり、これを行うと、この動作が予告なしにいつでも中断される可能性があることに同意したものとみなされます。 詳細は https://prometheus.io/docs/prometheus/latest/feature_flags/ を参照してください。 |
|
| Prometheus を Prometheus リモート書き込みプロトコルのレシーバーとして使用できるようにします。 警告: これは効率的なサンプル取り込み方法とはみなされていません。特定の低ボリュームのユースケースでは注意して使用してください。スクレイピングによる取り込みの代わりに使用して、Prometheus をプッシュベースのメトリクス収集システムに変換するには適していません。詳細は、https://prometheus.io/docs/prometheus/latest/querying/api/#remote-write-receiver を参照してください。 Prometheus v2.33.0 以降が必要です。 |
|
| 定義されている場合、enforcedBodySizeLimit は、Prometheus が受け入れる非圧縮形式のレスポンスボディーのサイズに対するグローバル制限を指定します。この数バイトよりも大きい本文で応答するターゲットは、スクレイプが失敗する原因になります。 Prometheus v2.28.0 以降が必要です。
|
|
|
定義されている場合、enforcedKeepDroppedTargets は、ラベルの再設定によりドロップされてメモリーに保持されるターゲットの数のグローバル制限を指定します。 Prometheus v2.47.0 以降が必要です。
|
|
|
定義されている場合、enforcedLabelLimit はサンプルごとのラベル数のグローバル制限を指定します。 Prometheus v2.27.0 以降が必要です。
|
|
|
定義されている場合、enforcedLabelNameLengthLimit はサンプルごとのラベル名の長さに対するグローバル制限を指定します。 Prometheus v2.27.0 以降が必要です。
|
|
|
null 以外の場合、enforcedLabelValueLengthLimit はサンプルごとのラベル値の長さに対するグローバル制限を定義します。 Prometheus v2.27.0 以降が必要です。
|
|
| 空でない場合は、以下にラベルが追加されます。
1.
ラベルの名前は、このフィールドの値になります。ラベルの値は、 |
|
|
定義されている場合、enforcedSampleLimit は受け入れられるスクレイピングされたサンプル数に対するグローバル制限を指定します。 これは、管理者がサンプル/シリーズの総数を必要な制限内に保つために使用します。
|
|
|
定義されている場合、enforcedTargetLimit はスクレイピングされたターゲットの数に対するグローバル制限を指定します。 これは、管理者がターゲットの総数を望ましい制限以下に維持するために使用します。
|
|
| ルール評価の間隔。デフォルト: "30s" |
|
| 元の namespace ラベルの適用から除外される PodMonitor、ServiceMonitor、Probe、および PrometheusRule オブジェクトへの参照のリスト。
|
|
| ObjectReference は、PodMonitor、ServiceMonitor、Probe、または PrometheusRule オブジェクトを参照します。 |
|
|
実行時に再読み込み可能な Exemplar 関連の設定。有効にするには、 |
|
|
外部システム (フェデレーション、リモートストレージ、Alertmanager) と通信するときに、任意の時系列またはアラートに追加するラベル。 |
|
| Prometheus サービスを外部から使用するための外部 URL。正しい URL を生成するために必要です (たとえば、Prometheus が Ingress リソースの背後でアクセス可能である場合など)。 |
|
| 指定された場合に Pod のホストファイルに注入されるホストと IP のオプションのリスト。 |
|
| HostAlias は、Pod の hosts ファイルのエントリーとして挿入される IP とホスト名の間のマッピングを保持します。 |
|
| true の場合、ホストのネットワーク namespace を使用します。 有効にする場合は、必ずセキュリティー上の影響を必ず理解した上で有効にしてください (https://kubernetes.io/docs/concepts/configuration/overview/)。
hostNetwork が有効になっている場合、DNS ポリシーが |
|
|
true の場合、すべての PodMonitor、ServiceMonitor、および Probe オブジェクトの |
|
|
Prometheus のコンテナーイメージ名。指定されている場合、
Prometheus Operator が設定されている Prometheus のバージョンを認識するためには、
|
|
| 'prometheus', 'init-config-reloader'、'config-reloader' コンテナーのイメージプルポリシー。詳細は、https://kubernetes.io/docs/concepts/containers/images/#image-pull-policy を参照してください。 |
|
| レジストリーからイメージをプルするために使用する、同じ namespace 内の Secret へのオプションの参照リスト。http://kubernetes.io/docs/user-guide/images#specifying-imagepullsecrets-on-a-pod を参照してください。 |
|
| LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。 |
|
| InitContainers を使用して、Pod 定義に initContainers を注入できます。これらは、たとえば、外部ソースから Prometheus 設定に注入するためのシークレットをフェッチするために使用できます。initContainer の実行中にエラーが発生すると、Pod が再起動します。詳細: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/ ここで説明する InitContainers は、同じ名前を共有し、戦略的なマージパッチを介して変更が行われる場合は、オペレーターが生成した init コンテナーを変更します。
Operator によって管理される init コンテナー名は次のとおりです: * init コンテナーのオーバーライドは、メンテナーがサポートする範囲外であり、そうすることで、この動作が予告なしにいつでも中断する可能性があることを認めます。 |
|
| Pod 内で実行する単一のアプリケーションコンテナー。 |
|
| 再ラベル付けによって削除され、メモリーに保持されるターゲットの数に対するスクレイプごとの制限。0 は制限がないことを意味します。 Prometheus v2.47.0 以降が必要です。 グローバル制限は、明示的な制限値を指定しないスクレイプオブジェクトにのみ適用されることに注意してください。すべてのスクレイプオブジェクトに最大制限を適用する場合は、enforcedKeepDroppedTargets を参照してください。 |
|
| サンプルに受け入れられるラベルの数のスクレープごとの制限。Prometheus バージョン 2.45.0 以降でのみ有効です。 グローバル制限は、明示的な制限値を指定しないスクレイプオブジェクトにのみ適用されることに注意してください。すべてのスクレイプオブジェクトに最大制限を適用する場合は、enforcedLabelLimit を参照してください。 |
|
| サンプルで受け入れられるラベル名の長さのスクレープごとの制限。Prometheus バージョン 2.45.0 以降でのみ有効です。 グローバル制限は、明示的な制限値を指定しないスクレイプオブジェクトにのみ適用されることに注意してください。すべてのスクレイプオブジェクトに最大制限を適用する場合は、enforcedLabelNameLengthLimit を参照してください。 |
|
| サンプルに受け入れられるラベル値の長さのスクレープごとの制限。Prometheus バージョン 2.45.0 以降でのみ有効です。 グローバル制限は、明示的な制限値を指定しないスクレイプオブジェクトにのみ適用されることに注意してください。すべてのスクレイプオブジェクトに最大制限を適用する場合は、enforcedLabelValueLengthLimit を参照してください。 |
|
| true の場合、Prometheus サーバーは Pod IP のアドレスではなくループバックアドレスをリッスンします。 |
|
| Prometheus および config-reloader サイドカーのログレベルのログ形式。 |
|
| Prometheus と config-reloader サイドカーのログレベル。 |
|
|
|
|
| 新しく作成された Pod が使用可能であると見なされるために、コンテナーがクラッシュすることなく準備完了になるまでの最小秒数。デフォルトは 0 です (Pod は準備ができ次第利用可能と見なされます) これは、Kubernetes 1.22 から 1.24 までのアルファフィールドであり、StatefulSetMinReadySeconds フィーチャーゲートを有効にする必要があります。 |
|
| Pod がどのノードにスケジュールされるかを定義します。 |
|
| OTLP レシーバーの機能に関する設定。Prometheus v2.55.0 以降が必要です。 |
|
|
true の場合、Prometheus は、ServiceMonitor、PodMonitor、および ScrapeConfig オブジェクトから作成されたすべてのターゲットに対して、スクレイピングされたデータ内のラベルの名前を “exported_” に変更することでラベルの競合を解決します。それ以外の場合は、サービスまたは Pod モニターの HonorLabels フィールドが適用されます。実際には、 |
|
| true の場合、Prometheus はサービスおよび Pod モニターから作成されたすべてのターゲットのタイムスタンプを無視します。それ以外の場合は、サービスまたは Pod モニターの HonorTimestamps フィールドが適用されます。 |
|
| Prometheus のデプロイメントが一時停止されると、基になるオブジェクトに対して削除以外のアクションは実行されません。 |
|
| このフィールドは、StatefulSet のライフサイクル中に PVC を削除するかどうか、および削除する場合はその方法を制御します。デフォルトの動作では、すべての PVC が保持されます。これは、Kubernetes 1.23 から 1.26 までのアルファフィールドであり、1.26 以降ではベータフィールドです。StatefulSetAutoDeletePVC フィーチャーゲートを有効にする必要があります。 |
|
| PodMetadata は、Prometheus Pod に伝播されるラベルとアノテーションを設定します。 次の項目は予約されており、オーバーライドできません: * Prometheus オブジェクトの名前に設定された "prometheus" ラベル。* Prometheus オブジェクトの名前に設定された "app.kubernetes.io/instance" ラベル。* "prometheus-operator" に設定された "app.kubernetes.io/managed-by" ラベル。* "prometheus" に設定された "app.kubernetes.io/name" ラベル。* Prometheus バージョンに設定された "app.kubernetes.io/version" ラベル。* Prometheus オブジェクトの名前に設定された "operator.prometheus.io/name" ラベル。* Prometheus オブジェクトのシャード番号に設定された "operator.prometheus.io/shard" ラベル。* "prometheus" に設定された "kubectl.kubernetes.io/default-container" アノテーション。 |
|
| PodMonitors 検出に一致する namespace。空のラベルセレクターはすべての namespace に一致します。null ラベルセレクター (デフォルト値) は現在の namespace にのみ一致します。 |
|
| ターゲット検出のために選択される PodMonitor。ラベルセレクターが空の場合は、全オブジェクトをマッチします。ラベルセレクターが null の場合は、どのオブジェクトもマッチしません。
|
|
|
PodTargetLabels は、すべての PodMonitor および ServiceMonitor オブジェクトの |
|
| Pod および管理サービスに使用されるポート名。デフォルト: "web" |
|
| Pod に割り当てられた優先度クラス。 |
|
| プローブ検出に一致する namespace。空のラベルセレクターはすべての namespace に一致します。null ラベルセレクターは現在の namespace にのみ一致します。 |
|
| ターゲット検出のために選択されるプローブ。ラベルセレクターが空の場合は、全オブジェクトをマッチします。ラベルセレクターが null の場合は、どのオブジェクトもマッチしません。
|
|
|
Prometheus インスタンス名を示すために使用される Prometheus 外部ラベルの名前。フィールドが空の文字列 ( デフォルト: "prometheus" |
|
|
namespace ラベルの強制が適用されない PrometheusRule オブジェクトのリストを定義します。これは、 |
|
| PrometheusRuleExcludeConfig を使用すると、ユーザーは、アラートとメトリックの namespace ラベルを適用するときに、除外された PrometheusRule 名とその namespace を無視するように設定できます。 |
|
| QuerySpec は、Promethus クエリーサービスの設定を定義します。 |
|
| queryLogFile は、PromQL クエリーがログに記録されるファイルを指定します。
ファイル名に空のパスが含まれる場合 (例: 'query.log')、Prometheus Pod はファイルを |
|
| Prometheus 設定をリロードするために使用されるストラテジーを定義します。指定されていない場合、設定は /-/reload HTTP エンドポイントを使用してリロードされます。 |
|
| リモート読み取り設定のリストを定義します。 |
|
| RemoteReadSpec は、Prometheus がリモートエンドポイントからサンプルを読み戻すための設定を定義します。 |
|
| リモート書き込み設定のリストを定義します。 |
|
| RemoteWriteSpec は、Prometheus からリモートエンドポイントにサンプルを書き込むための設定を定義します。 |
|
| リモート書き込みを受信するときに受け入れる protobuf メッセージバージョンのリスト。 Prometheus v2.54.0 以降が必要です。 |
|
|
レプリカ名を示すために使用される Prometheus 外部ラベルの名前。フィールドが空の文字列 ( デフォルト: "prometheus_replica" |
|
|
Prometheus デプロイメント用にデプロイする各シャードのレプリカの数。 デフォルト: 1 |
|
| 'prometheus' コンテナーのリソースリクエストと制限を定義します。 |
|
| Prometheus データを保持する期間。
デフォルト: |
|
| Prometheus データで使用される最大バイト数。 |
|
| ルート接頭辞 Prometheus は、の HTTP ハンドラーを登録します。
|
|
| PrometheusRule 検出に一致する namespace。空のラベルセレクターはすべての namespace に一致します。null ラベルセレクターは現在の namespace にのみ一致します。 |
|
| この特定のグループのルール評価タイムスタンプを、指定期間だけ過去にオフセットすることを定義します。Prometheus v2.53.0 以降が必要です。 |
|
| ルール評価のために選択される PrometheusRule オブジェクト。ラベルセレクターが空の場合は、全オブジェクトをマッチします。ラベルセレクターが null の場合は、どのオブジェクトもマッチしません。 |
|
| Prometheus ルールのエンジンの設定を定義します。 |
|
| RuntimeConfig は Prometheus プロセスの動作の値を設定します。 |
|
| SampleLimit は、受け入れられるスクレイプされたサンプルの数に対するスクレイプごとの制限を定義します。Prometheus バージョン 2.45.0 以降でのみ有効です。 グローバル制限は、明示的な制限値を指定しないスクレイプオブジェクトにのみ適用されることに注意してください。すべてのスクレイプオブジェクトに最大制限を適用する場合は、enforcedSampleLimit を参照してください。 |
|
| PodMonitors、ServiceMonitors、Probes、ScrapeConfigs などのスクレイピングオブジェクトに公開するスクレイプクラスのリスト。 これは 実験的な機能 であり、今後のリリースで重大な変更が加えられる可能性があります。 |
|
| |
|
| ScrapeConfig 検出に一致する namespace。空のラベルセレクターはすべての namespace に一致します。null ラベルセレクターは現在の namespace にのみ一致します。 現在、ScrapeConfig カスタムリソース定義はアルファレベルであることに注意してください。 |
|
| ターゲット検出のために選択される ScrapeConfigs。ラベルセレクターが空の場合は、全オブジェクトをマッチします。ラベルセレクターが null の場合は、どのオブジェクトもマッチしません。
現在、ScrapeConfig カスタムリソース定義はアルファレベルであることに注意してください。 |
|
| 連続するスクレイプの間隔。 デフォルト: "30s" |
|
| スクレイピング中にネゴシエートするプロトコル。これは、Prometheus でサポートされているプロトコルを (優先度が高いものから低いものへ) 優先度順にクライアントに通知します。 設定されていない場合、Prometheus はデフォルト値を使用します。 Prometheus v2.49.0 以降が必要です。 |
|
| スクレイプリクエストがタイムアウトするまでの待機秒数。 |
|
|
シークレットは、Prometheus オブジェクトと同じ namespace にあるシークレットのリストであり、Prometheus Pod にマウントされます。各シークレットは、 |
|
| SecurityContext は、Pod レベルのセキュリティー属性と一般的なコンテナー設定を保持します。これはデフォルトでデフォルトの PodSecurityContext になります。 |
|
| ServiceAccountName は、Prometheus Pod の実行に使用する ServiceAccount の名前です。 |
|
|
設定する場合、"Endpoints" または "EndpointSlice" のいずれかの値を指定する必要があります。設定されていない場合、Operator は "Endpoints" ロールを想定します。 |
|
| ServicedMonitors 検出に一致する namespace。空のラベルセレクターはすべての namespace に一致します。null ラベルセレクター (デフォルト値) は現在の namespace にのみ一致します。 |
|
| ターゲット検出用に選択される ServiceMonitor。ラベルセレクターが空の場合は、全オブジェクトをマッチします。ラベルセレクターが null の場合は、どのオブジェクトもマッチしません。
|
|
| 非推奨: 代わりに 'spec.image' を使用します。イメージのダイジェストはイメージ名の一部として指定できます。 |
|
|
ターゲットの分散先となるシャードの数。 シャードを縮小しても、データは残りのインスタンスに再シャーディングされないことに注意してください。手動で移動する必要があります。シャードを増やしてもデータはリシャードされませんが、同じインスタンスから引き続き使用できます。グローバルにクエリーを実行するには、Thanos サイドカーと Thanos クエリアを使用するか、中央の場所にデータをリモートで書き込みます。
シャーディングは、PodMonitor および ServiceMonitor の デフォルト: 1 |
|
| storage は、Prometheus が使用するストレージを定義します。 |
|
| 非推奨: 代わりに 'spec.image' を使用します。イメージのタグはイメージ名の一部として指定できます。 |
|
| TargetLimit は、受け入れられるスクレイプされたターゲットの数の制限を定義します。Prometheus バージョン 2.45.0 以降でのみ有効です。 グローバル制限は、明示的な制限値を指定しないスクレイプオブジェクトにのみ適用されることに注意してください。すべてのスクレイプオブジェクトに最大制限を適用する場合は、enforcedTargetLimit を参照してください。 |
|
| オプションの Thanos サイドカーの設定を定義します。 |
|
| 指定されている場合、Pod の toleration を定義します。 |
|
| この toleration が割り当てられる Pod は、マッチング Operator <operator> を使用してトリプル <key,value,effect> と一致する taint を許容します。 |
|
| 指定されている場合、Pod のトポロジー分散制約を定義します。 |
|
| |
|
| TracingConfig は Prometheus でトレーシングを設定します。 これは 実験的な機能 であり、今後のリリースで重大な変更が加えられる可能性があります。 |
|
| ランタイムでのリロードが可能な時系列データベース (TSDB) の設定を定義します。Prometheus v2.39.0 以降または PrometheusAgent v2.54.0 以降が必要です。 |
|
| デプロイされている Prometheus のバージョン。Operator はこの情報を使用して、Prometheus StatefulSet と設定ファイルを生成します。 指定されていない場合、Operator はその Operator バージョンがリリースされた時点で利用可能な Prometheus の最新アップストリームバージョンを想定します。 |
|
| volumeMounts を使用して、追加の volumeMounts を設定できます。 VolumeMounts は、StorageSpec オブジェクトの結果として生成される 'prometheus' コンテナー内の他の VolumeMounts に追加されます。 |
|
| VolumeMount は、コンテナー内でのボリュームのマウントを説明します。 |
|
| volumes を使用して、出力の StatefulSet 定義に追加のボリュームを設定できます。指定されたボリュームは、StorageSpec オブジェクトの結果として生成される他のボリュームに追加されます。 |
|
| ボリュームは、Pod 内の任意のコンテナーからアクセスできる Pod 内の名前付きボリュームを表します。 |
|
| Snappy を使用してログ先行書き込み (WAL) の圧縮を設定します。 Prometheus 2.20.0 以降では、デフォルトで WAL 圧縮が有効になっています。 Prometheus v2.11.0 以降が必要です。 |
|
| Prometheus Web サーバーの設定を定義します。 |
8.1.2. .spec.additionalAlertManagerConfigs
- 説明
AdditionalAlertManagerConfigs は、追加の Prometheus Alertmanager 設定を含む Secret のキーを指定します。Alertmanager 設定は、Prometheus Operator によって生成された設定に追加されます。これらは、Prometheus の公式ドキュメントに従ってフォーマットする必要があります。
https://prometheus.io/docs/prometheus/latest/configuration/configuration/#alertmanager_config
ユーザーは、設定が有効であることを確認する責任があります
この機能を使用すると、Prometheus のアップグレードが中断される可能性があることに注意してください。アップグレード後に互換性のない AlertManager 設定が Prometheus を壊さないように、Prometheus リリースノートを確認することを推奨します。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.3. .spec.additionalAlertRelabelConfigs
- 説明
additionalAlertRelabelConfigs は、追加の Prometheus アラートのラベル再設定の設定を含む Secret のキーを指定します。アラートのラベル再設定の設定は、Prometheus Operator によって生成された設定に追加されます。これらは、Prometheus の公式ドキュメントに従ってフォーマットする必要があります。
https://prometheus.io/docs/prometheus/latest/configuration/configuration/#alert_relabel_configs
ユーザーは、設定が有効であることを確認する責任があります
この機能を使用すると、Prometheus のアップグレードが中断される可能性があることに注意してください。Prometheus のリリースノートを確認して、アップグレード後に互換性のないアラートのラベル変更設定によって Prometheus が破損しないようにすることを推奨します。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.4. .spec.additionalArgs
- 説明
additionalArgs を使用すると、'prometheus' コンテナーに追加の引数を設定できます。
これは、専用の設定オプションではまだサポートされていない隠しフラグを有効にする場合などに使用されます。引数はそのまま Prometheus コンテナーに渡されますが、引数が無効であったり、指定された Prometheus バージョンでサポートされていない場合は問題が発生する可能性があります。
引数が競合する場合 (たとえば、Operator によってすでに設定されている引数)、または無効な引数を指定すると、調整は失敗し、エラーが記録されます。
- 型
-
array
8.1.5. .spec.additionalArgs[]
- 説明
- AdditionalArgs リストの一部である引数。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 引数の名前 (例: "scrape.discovery-reload-interval")。 |
|
| 引数の値 (例: 30s)。名前のみの引数は空にできます (例: --storage.tsdb.no-lockfile) |
8.1.6. .spec.additionalScrapeConfigs
- 説明
- AdditionalScrapeConfigs を使用すると、追加の Prometheus スクレイプ設定を含むシークレットのキーを指定できます。指定されたスクレープ設定は、Prometheus Operator によって生成された設定に追加されます。指定するジョブ設定は、Prometheus の公式ドキュメント https://prometheus.io/docs/prometheus/latest/configuration/configuration/#scrape_config で指定されている形式である必要があります。スクレイプ設定が追加されると、ユーザーはそれが有効であることを確認する責任があります。この機能を使用すると、Prometheus のアップグレードが中断される可能性があることに注意してください。アップグレード後に互換性のないスクレイプ設定が Prometheus を壊さないように、Prometheus リリースノートを確認することを推奨します。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.7. .spec.affinity
- 説明
- 指定されている場合、Pod のアフィニティースケジューリングルールを定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Pod のノードアフィニティースケジューリングルールを説明します。 |
|
| Pod アフィニティースケジューリングルールを説明します (たとえば、この Pod を他の Pod と同じノード、ゾーンなどに配置します)。 |
|
| Pod の非アフィニティースケジューリングルールを説明します (たとえば、この Pod を他の Pod と同じノード、ゾーンなどに配置しないでください)。 |
8.1.8. .spec.affinity.nodeAffinity
- 説明
- Pod のノードアフィニティースケジューリングルールを説明します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| スケジューラーは、このフィールドで指定されたアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アフィニティー式など) を満たすノードごとに、このフィールドの要素を反復処理して合計を計算します。ノードが対応する matchExpressions と一致する場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。 |
|
| 空の優先スケジューリング用語は、暗黙の重み 0 を持つすべてのオブジェクトに一致します (つまり、操作なしです)。null の優先スケジューリング用語は、オブジェクトに一致しません (つまり、no-op でもあります)。 |
|
| このフィールドで指定されたアフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定されたアフィニティー要件が Pod 実行中のある時点で満たされない場合 (更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。 |
8.1.9. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution
- 説明
- スケジューラーは、このフィールドで指定されたアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アフィニティー式など) を満たすノードごとに、このフィールドの要素を反復処理して合計を計算します。ノードが対応する matchExpressions と一致する場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。
- 型
-
array
8.1.10. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[]
- 説明
- 空の優先スケジューリング用語は、暗黙の重み 0 を持つすべてのオブジェクトに一致します (つまり、操作なしです)。null の優先スケジューリング用語は、オブジェクトに一致しません (つまり、no-op でもあります)。
- 型
-
object
- 必須
-
preference
-
weight
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 対応する重みに関連付けられたノードセレクター用語。 |
|
| 対応する nodeSelectorTerm の一致に関連する重み (1〜100 の範囲)。 |
8.1.11. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference
- 説明
- 対応する重みに関連付けられたノードセレクター用語。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ノードのラベルごとのノードセレクター要件のリスト。 |
|
| ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| ノードのフィールドごとのノードセレクター要件のリスト。 |
|
| ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
8.1.12. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchExpressions
- 説明
- ノードのラベルごとのノードセレクター要件のリスト。
- 型
-
array
8.1.13. .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 配列には、整数として解釈される単一の要素が必要です。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.14. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchFields
- 説明
- ノードのフィールドごとのノードセレクター要件のリスト。
- 型
-
array
8.1.15. .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 配列には、整数として解釈される単一の要素が必要です。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.16. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution
- 説明
- このフィールドで指定されたアフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定されたアフィニティー要件が Pod 実行中のある時点で満たされない場合 (更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。
- 型
-
object
- 必須
-
nodeSelectorTerms
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 必須。ノードセレクター用語のリスト。用語は OR されています。 |
|
| null または空のノードセレクター用語はオブジェクトに一致しません。これらの要件は AND で結合されます。TopologySelectorTerm タイプは、NodeSelectorTerm のサブセットを実装します。 |
8.1.17. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms
- 説明
- 必須。ノードセレクター用語のリスト。用語は OR されています。
- 型
-
array
8.1.18. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[]
- 説明
- null または空のノードセレクター用語はオブジェクトに一致しません。これらの要件は AND で結合されます。TopologySelectorTerm タイプは、NodeSelectorTerm のサブセットを実装します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ノードのラベルごとのノードセレクター要件のリスト。 |
|
| ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| ノードのフィールドごとのノードセレクター要件のリスト。 |
|
| ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
8.1.19. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchExpressions
- 説明
- ノードのラベルごとのノードセレクター要件のリスト。
- 型
-
array
8.1.20. .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 配列には、整数として解釈される単一の要素が必要です。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.21. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchFields
- 説明
- ノードのフィールドごとのノードセレクター要件のリスト。
- 型
-
array
8.1.22. .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 配列には、整数として解釈される単一の要素が必要です。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.23. .spec.affinity.podAffinity
- 説明
- Pod アフィニティースケジューリングルールを説明します (たとえば、この Pod を他の Pod と同じノード、ゾーンなどに配置します)。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| スケジューラーは、このフィールドで指定されたアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アフィニティー式など) を満たすノードごとに、このフィールドの要素を反復処理して合計を計算します。ノードに対応する podAffinityTerm に一致する Pod がある場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。 |
|
| 一致したすべての WeightedPodAffinityTerm フィールドの重みがノードごとに追加され、最も優先されるノードが検索されます。 |
|
| このフィールドで指定されたアフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定されたアフィニティー要件が Pod 実行中のある時点で満たされない場合 (Pod ラベルの更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。複数の要素がある場合、各 podAffinityTerm に対応するノードのリストが交差します。つまり、すべての用語が満たされる必要があります。 |
|
| この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。この場合の同じ場所とは、キー <topologyKey> のラベルの値が、一連の Pod の Pod が実行されているノードの値と一致するノードで実行されていることを意味します。 |
8.1.24. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution
- 説明
- スケジューラーは、このフィールドで指定されたアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アフィニティー式など) を満たすノードごとに、このフィールドの要素を反復処理して合計を計算します。ノードに対応する podAffinityTerm に一致する Pod がある場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。
- 型
-
array
8.1.25. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[]
- 説明
- 一致したすべての WeightedPodAffinityTerm フィールドの重みがノードごとに追加され、最も優先されるノードが検索されます。
- 型
-
object
- 必須
-
podAffinityTerm
-
weight
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 必須。対応する重みに関連付けられた Pod アフィニティー用語。 |
|
| 対応する podAffinityTerm の一致に関連する重み (1〜100 の範囲)。 |
8.1.26. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm
- 説明
- 必須。対応する重みに関連付けられた Pod アフィニティー用語。
- 型
-
object
- 必須
-
topologyKey
-
プロパティー | 型 | 説明 |
---|---|---|
|
| リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。 |
|
|
MatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは |
|
|
MismatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは |
|
| 用語が適用される namespace のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての namespace に一致します。 |
|
| namespaces は、用語が適用される namespace 名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび nullnamespaceSelector は、"この Pod の namespace" を意味します |
|
| この Pod は、指定された namespace の labelSelector と一致する Pod と同じ場所 (affinity) または異なる場所 (anti-affinity) に配置します。同じ場所とは、topologyKey キーが含まれるラベルの値が一致し、選択した Pod のいずれかが実行されているノード上で実行されていることを意味します。空の topologyKey は許可されていません。 |
8.1.27. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector
- 説明
- リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。 |
8.1.28. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector.matchExpressions
- 説明
- matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
- 型
-
array
8.1.29. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector.matchExpressions[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.30. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector
- 説明
- 用語が適用される namespace のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての namespace に一致します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。 |
8.1.31. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector.matchExpressions
- 説明
- matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
- 型
-
array
8.1.32. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector.matchExpressions[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.33. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution
- 説明
- このフィールドで指定されたアフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定されたアフィニティー要件が Pod 実行中のある時点で満たされない場合 (Pod ラベルの更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。複数の要素がある場合、各 podAffinityTerm に対応するノードのリストが交差します。つまり、すべての用語が満たされる必要があります。
- 型
-
array
8.1.34. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[]
- 説明
- この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。この場合の同じ場所とは、キー <topologyKey> のラベルの値が、一連の Pod の Pod が実行されているノードの値と一致するノードで実行されていることを意味します。
- 型
-
object
- 必須
-
topologyKey
-
プロパティー | 型 | 説明 |
---|---|---|
|
| リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。 |
|
|
MatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは |
|
|
MismatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは |
|
| 用語が適用される namespace のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての namespace に一致します。 |
|
| namespaces は、用語が適用される namespace 名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび nullnamespaceSelector は、"この Pod の namespace" を意味します |
|
| この Pod は、指定された namespace の labelSelector と一致する Pod と同じ場所 (affinity) または異なる場所 (anti-affinity) に配置します。同じ場所とは、topologyKey キーが含まれるラベルの値が一致し、選択した Pod のいずれかが実行されているノード上で実行されていることを意味します。空の topologyKey は許可されていません。 |
8.1.35. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector
- 説明
- リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。 |
8.1.36. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector.matchExpressions
- 説明
- matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
- 型
-
array
8.1.37. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector.matchExpressions[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.38. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector
- 説明
- 用語が適用される namespace のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての namespace に一致します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。 |
8.1.39. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector.matchExpressions
- 説明
- matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
- 型
-
array
8.1.40. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector.matchExpressions[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.41. .spec.affinity.podAntiAffinity
- 説明
- Pod の非アフィニティースケジューリングルールを説明します (たとえば、この Pod を他の Pod と同じノード、ゾーンなどに配置しないでください)。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| スケジューラーは、このフィールドで指定された非アフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アンチアフィニティー式など) を満たすノードごとに、の要素を反復処理して合計を計算します。このフィールドと、対応する podAffinityTerm に一致する Pod がノードにある場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。 |
|
| 一致したすべての WeightedPodAffinityTerm フィールドの重みがノードごとに追加され、最も優先されるノードが検索されます。 |
|
| このフィールドで指定された非アフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定された非アフィニティー要件が Pod 実行中のある時点で満たされない場合 (Pod ラベルの更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。複数の要素がある場合、各 podAffinityTerm に対応するノードのリストが交差します。つまり、すべての用語が満たされる必要があります。 |
|
| この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。この場合の同じ場所とは、キー <topologyKey> のラベルの値が、一連の Pod の Pod が実行されているノードの値と一致するノードで実行されていることを意味します。 |
8.1.42. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution
- 説明
- スケジューラーは、このフィールドで指定された非アフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アンチアフィニティー式など) を満たすノードごとに、の要素を反復処理して合計を計算します。このフィールドと、対応する podAffinityTerm に一致する Pod がノードにある場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。
- 型
-
array
8.1.43. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[]
- 説明
- 一致したすべての WeightedPodAffinityTerm フィールドの重みがノードごとに追加され、最も優先されるノードが検索されます。
- 型
-
object
- 必須
-
podAffinityTerm
-
weight
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 必須。対応する重みに関連付けられた Pod アフィニティー用語。 |
|
| 対応する podAffinityTerm の一致に関連する重み (1〜100 の範囲)。 |
8.1.44. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm
- 説明
- 必須。対応する重みに関連付けられた Pod アフィニティー用語。
- 型
-
object
- 必須
-
topologyKey
-
プロパティー | 型 | 説明 |
---|---|---|
|
| リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。 |
|
|
MatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは |
|
|
MismatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは |
|
| 用語が適用される namespace のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての namespace に一致します。 |
|
| namespaces は、用語が適用される namespace 名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび nullnamespaceSelector は、"この Pod の namespace" を意味します |
|
| この Pod は、指定された namespace の labelSelector と一致する Pod と同じ場所 (affinity) または異なる場所 (anti-affinity) に配置します。同じ場所とは、topologyKey キーが含まれるラベルの値が一致し、選択した Pod のいずれかが実行されているノード上で実行されていることを意味します。空の topologyKey は許可されていません。 |
8.1.45. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector
- 説明
- リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。 |
8.1.46. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector.matchExpressions
- 説明
- matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
- 型
-
array
8.1.47. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector.matchExpressions[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.48. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector
- 説明
- 用語が適用される namespace のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての namespace に一致します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。 |
8.1.49. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector.matchExpressions
- 説明
- matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
- 型
-
array
8.1.50. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector.matchExpressions[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.51. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution
- 説明
- このフィールドで指定された非アフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定された非アフィニティー要件が Pod 実行中のある時点で満たされない場合 (Pod ラベルの更新など)、システムは最終的に Pod をノードから削除しようとする場合としない場合があります。複数の要素がある場合、各 podAffinityTerm に対応するノードのリストが交差します。つまり、すべての用語が満たされる必要があります。
- 型
-
array
8.1.52. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[]
- 説明
- この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。この場合の同じ場所とは、キー <topologyKey> のラベルの値が、一連の Pod の Pod が実行されているノードの値と一致するノードで実行されていることを意味します。
- 型
-
object
- 必須
-
topologyKey
-
プロパティー | 型 | 説明 |
---|---|---|
|
| リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。 |
|
|
MatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは |
|
|
MismatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは |
|
| 用語が適用される namespace のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての namespace に一致します。 |
|
| namespaces は、用語が適用される namespace 名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび nullnamespaceSelector は、"この Pod の namespace" を意味します |
|
| この Pod は、指定された namespace の labelSelector と一致する Pod と同じ場所 (affinity) または異なる場所 (anti-affinity) に配置します。同じ場所とは、topologyKey キーが含まれるラベルの値が一致し、選択した Pod のいずれかが実行されているノード上で実行されていることを意味します。空の topologyKey は許可されていません。 |
8.1.53. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector
- 説明
- リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。 |
8.1.54. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector.matchExpressions
- 説明
- matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
- 型
-
array
8.1.55. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector.matchExpressions[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.56. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector
- 説明
- 用語が適用される namespace のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての namespace に一致します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。 |
8.1.57. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector.matchExpressions
- 説明
- matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
- 型
-
array
8.1.58. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector.matchExpressions[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.59. .spec.alerting
- 説明
- Alertmanager に関連する設定を定義します。
- 型
-
object
- 必須
-
alertmanagers
-
プロパティー | 型 | 説明 |
---|---|---|
|
| Prometheus がアラートを送信する Alertmanager エンドポイント。 |
|
| AlertmanagerEndpoints は、アラートを発動させる Alertmanager IP を含む単一の Endpoints オブジェクトの選択を定義します。 |
8.1.60. .spec.alerting.alertmanagers
- 説明
- Prometheus がアラートを送信する Alertmanager エンドポイント。
- 型
-
array
8.1.61. .spec.alerting.alertmanagers[]
- 説明
- AlertmanagerEndpoints は、アラートを発動させる Alertmanager IP を含む単一の Endpoints オブジェクトの選択を定義します。
- 型
-
object
- 必須
-
name
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 特定の Alertmanager にアラートを送信する前に適用されるラベル再設定の設定。Prometheus v2.51.0 以降が必要です。 |
|
| RelabelConfig を使用すると、ターゲット、アラート、スクレイピングされたサンプル、リモート書き込みサンプルのラベルセットを動的に書き換えることができます。 詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config |
|
| Prometheus がアラートの送信に使用する Alertmanager API のバージョン。"v1" または "v2" を使用できます。 |
|
| Alertmanager の認可セクション。
|
|
| Alertmanager の BasicAuth 設定。
|
|
| Alertmanager のベアラートークンを読み取るファイル。
非推奨: 今後のリリースで削除される予定です。 |
|
| HTTP2 を有効にするかどうか。 |
|
| namespace 内のエンドポイントオブジェクトの名前。 |
|
| エンドポイントオブジェクトの namespace。 設定されていない場合、Prometheus オブジェクトの namespace でオブジェクトが検出されます。 |
|
| HTTP パスアラートの接頭辞はにプッシュされます。 |
|
| Alertmanager API が公開されるポート。 |
|
| 検出された Alertmanagers に適用されるラベル再設定の設定。 |
|
| RelabelConfig を使用すると、ターゲット、アラート、スクレイピングされたサンプル、リモート書き込みサンプルのラベルセットを動的に書き換えることができます。 詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config |
|
| アラートを発するときに使用するスキーム。 |
|
| sigv4 を使用して、URL に対して AWS の Signature Verification 4 を設定できます。 Prometheus v2.48.0 以降が必要です。
|
|
| タイムアウトは、アラートをプッシュするときのターゲットごとの Alertmanager タイムアウトです。 |
|
| Alertmanager に使用する TLS 設定。 |
8.1.62. .spec.alerting.alertmanagers[].alertRelabelings
- 説明
- 特定の Alertmanager にアラートを送信する前に適用されるラベル再設定の設定。Prometheus v2.51.0 以降が必要です。
- 型
-
array
8.1.63. .spec.alerting.alertmanagers[].alertRelabelings[]
- 説明
RelabelConfig を使用すると、ターゲット、アラート、スクレイピングされたサンプル、リモート書き込みサンプルのラベルセットを動的に書き換えることができます。
詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 正規表現の一致に基づいて実行するアクション。
デフォルト: "Replace" |
|
| ソースラベル値のハッシュを取得するためのモジュラス。
アクションが |
|
| 抽出された値が一致する正規表現。 |
|
| 正規表現が一致する場合に置き換えアクションが実施される置換値。 正規表現キャプチャグループが利用可能です。 |
|
| separator は連結された SourceLabel 間の文字列です。 |
|
| ソースラベルは、既存のラベルから値を選択します。それらのコンテンツは、設定されたセパレータを使用して連結され、設定された正規表現と照合されます。 |
|
| 結果の文字列が置換で書き込まれるラベル。
正規表現キャプチャグループが利用可能です。 |
8.1.64. .spec.alerting.alertmanagers[].authorization
- 説明
Alertmanager の認可セクション。
basicAuth
、bearerTokenFile
、sigv4
と同時に設定することはできません。- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 認証の認証情報を含む、namespace 内の Secret のキーを選択します。 |
|
| 認証タイプを定義します。この値は大文字と小文字を区別しません。 "Basic" はサポートされている値ではありません。 デフォルト: "Bearer" |
8.1.65. .spec.alerting.alertmanagers[].authorization.credentials
- 説明
- 認証の認証情報を含む、namespace 内の Secret のキーを選択します。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.66. .spec.alerting.alertmanagers[].basicAuth
- 説明
Alertmanager の BasicAuth 設定。
bearerTokenFile
、authorization
、sigv4
と同時に設定することはできません。- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
|
|
|
|
|
8.1.67. .spec.alerting.alertmanagers[].basicAuth.password
- 説明
-
password
は、認証用のパスワードを含むシークレットのキーを指定します。 - 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.68. .spec.alerting.alertmanagers[].basicAuth.username
- 説明
-
username
は、認証用のユーザー名を含むシークレットのキーを指定します。 - 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.69. .spec.alerting.alertmanagers[].relabelings
- 説明
- 検出された Alertmanagers に適用されるラベル再設定の設定。
- 型
-
array
8.1.70. .spec.alerting.alertmanagers[].relabelings[]
- 説明
RelabelConfig を使用すると、ターゲット、アラート、スクレイピングされたサンプル、リモート書き込みサンプルのラベルセットを動的に書き換えることができます。
詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 正規表現の一致に基づいて実行するアクション。
デフォルト: "Replace" |
|
| ソースラベル値のハッシュを取得するためのモジュラス。
アクションが |
|
| 抽出された値が一致する正規表現。 |
|
| 正規表現が一致する場合に置き換えアクションが実施される置換値。 正規表現キャプチャグループが利用可能です。 |
|
| separator は連結された SourceLabel 間の文字列です。 |
|
| ソースラベルは、既存のラベルから値を選択します。それらのコンテンツは、設定されたセパレータを使用して連結され、設定された正規表現と照合されます。 |
|
| 結果の文字列が置換で書き込まれるラベル。
正規表現キャプチャグループが利用可能です。 |
8.1.71. .spec.alerting.alertmanagers[].sigv4
- 説明
sigv4 を使用して、URL に対して AWS の Signature Verification 4 を設定できます。
Prometheus v2.48.0 以降が必要です。
basicAuth
、bearerTokenFile
、authorization
と同時に設定することはできません。- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
|
AccessKey は AWS API キーです。指定されていない場合は、環境変数 |
|
| profile は、認証に使用される名前付き AWS プロファイルです。 |
|
| region は AWS リージョンです。空白の場合は、デフォルトの認証情報チェーンのリージョンが使用されます。 |
|
| roleArn は、認証に使用される名前付き AWS プロファイルです。 |
|
|
secretKey は AWS API シークレットです。指定されていない場合は、環境変数 |
8.1.72. .spec.alerting.alertmanagers[].sigv4.accessKey
- 説明
-
AccessKey は AWS API キーです。指定されていない場合は、環境変数
AWS_ACCESS_KEY_ID
が使用されます。 - 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.73. .spec.alerting.alertmanagers[].sigv4.secretKey
- 説明
-
secretKey は AWS API シークレットです。指定されていない場合は、環境変数
AWS_SECRET_ACCESS_KEY
が使用されます。 - 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.74. .spec.alerting.alertmanagers[].tlsConfig
- 説明
- Alertmanager に使用する TLS 設定。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| サーバー証明書の検証に使用される認証局。 |
|
| ターゲットに使用する Prometheus コンテナー内の CA 証明書へのパス。 |
|
| クライアント認証を行うときに提示するクライアント証明書。 |
|
| ターゲットの Prometheus コンテナー内のクライアント証明書ファイルへのパス。 |
|
| ターゲット証明書の検証を無効にします。 |
|
| ターゲットの Prometheus コンテナー内のクライアントキーファイルへのパス。 |
|
| ターゲットのクライアントキーファイルを含むシークレット。 |
|
| 許容可能な最大 TLS バージョン。 Prometheus v2.41.0 以降が必要です。 |
|
| 許容可能な最小 TLS バージョン。 Prometheus v2.35.0 以降が必要です。 |
|
| ターゲットのホスト名を確認するために使用されます。 |
8.1.75. .spec.alerting.alertmanagers[].tlsConfig.ca
- 説明
- サーバー証明書の検証に使用される認証局。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用するデータを含む ConfigMap。 |
|
| ターゲットに使用するデータを含むシークレット。 |
8.1.76. .spec.alerting.alertmanagers[].tlsConfig.ca.configMap
- 説明
- ターゲットに使用するデータを含む ConfigMap。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
8.1.77. .spec.alerting.alertmanagers[].tlsConfig.ca.secret
- 説明
- ターゲットに使用するデータを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.78. .spec.alerting.alertmanagers[].tlsConfig.cert
- 説明
- クライアント認証を行うときに提示するクライアント証明書。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用するデータを含む ConfigMap。 |
|
| ターゲットに使用するデータを含むシークレット。 |
8.1.79. .spec.alerting.alertmanagers[].tlsConfig.cert.configMap
- 説明
- ターゲットに使用するデータを含む ConfigMap。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
8.1.80. .spec.alerting.alertmanagers[].tlsConfig.cert.secret
- 説明
- ターゲットに使用するデータを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.81. .spec.alerting.alertmanagers[].tlsConfig.keySecret
- 説明
- ターゲットのクライアントキーファイルを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.82. .spec.apiserverConfig
- 説明
- APIServerConfig を使用すると、Kuberntees API サーバーにアクセスするためのホストと認証方法を指定できます。null の場合、Prometheus はクラスター内で実行されると想定され、API サーバーが自動的に検出され、Pod の CA 証明書とベアラートークンファイル (/var/run/secrets/kubernetes.io/serviceaccount/) が使用されます。
- 型
-
object
- 必須
-
host
-
プロパティー | 型 | 説明 |
---|---|---|
|
| API サーバーの認可セクション。
|
|
| API サーバーの BasicAuth 設定。
|
|
|
警告: トークン値がクリアテキストで表示されるため、このフィールドは使用しないでください。 非推奨: 今後のリリースで削除される予定です。 |
|
| apiserver にアクセスするためのベアラトークンを読み取るためのファイル。
非推奨: 今後のリリースで削除される予定です。 |
|
| ホスト名または IP アドレスとオプションのポート番号で構成される Kubernetes API アドレス。 |
|
| API サーバーに使用する TLS 設定。 |
8.1.83. .spec.apiserverConfig.authorization
- 説明
API サーバーの認可セクション。
basicAuth
、bearerToken
、bearerTokenFile
と同時に設定することはできません。- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 認証の認証情報を含む、namespace 内の Secret のキーを選択します。 |
|
|
シークレットを読み取るファイル。 |
|
| 認証タイプを定義します。この値は大文字と小文字を区別しません。 "Basic" はサポートされている値ではありません。 デフォルト: "Bearer" |
8.1.84. .spec.apiserverConfig.authorization.credentials
- 説明
- 認証の認証情報を含む、namespace 内の Secret のキーを選択します。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.85. .spec.apiserverConfig.basicAuth
- 説明
API サーバーの BasicAuth 設定。
authorization
、bearerToken
、bearerTokenFile
と同時に設定することはできません。- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
|
|
|
|
|
8.1.86. .spec.apiserverConfig.basicAuth.password
- 説明
-
password
は、認証用のパスワードを含むシークレットのキーを指定します。 - 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.87. .spec.apiserverConfig.basicAuth.username
- 説明
-
username
は、認証用のユーザー名を含むシークレットのキーを指定します。 - 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.88. .spec.apiserverConfig.tlsConfig
- 説明
- API サーバーに使用する TLS 設定。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| サーバー証明書の検証に使用される認証局。 |
|
| ターゲットに使用する Prometheus コンテナー内の CA 証明書へのパス。 |
|
| クライアント認証を行うときに提示するクライアント証明書。 |
|
| ターゲットの Prometheus コンテナー内のクライアント証明書ファイルへのパス。 |
|
| ターゲット証明書の検証を無効にします。 |
|
| ターゲットの Prometheus コンテナー内のクライアントキーファイルへのパス。 |
|
| ターゲットのクライアントキーファイルを含むシークレット。 |
|
| 許容可能な最大 TLS バージョン。 Prometheus v2.41.0 以降が必要です。 |
|
| 許容可能な最小 TLS バージョン。 Prometheus v2.35.0 以降が必要です。 |
|
| ターゲットのホスト名を確認するために使用されます。 |
8.1.89. .spec.apiserverConfig.tlsConfig.ca
- 説明
- サーバー証明書の検証に使用される認証局。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用するデータを含む ConfigMap。 |
|
| ターゲットに使用するデータを含むシークレット。 |
8.1.90. .spec.apiserverConfig.tlsConfig.ca.configMap
- 説明
- ターゲットに使用するデータを含む ConfigMap。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
8.1.91. .spec.apiserverConfig.tlsConfig.ca.secret
- 説明
- ターゲットに使用するデータを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.92. .spec.apiserverConfig.tlsConfig.cert
- 説明
- クライアント認証を行うときに提示するクライアント証明書。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用するデータを含む ConfigMap。 |
|
| ターゲットに使用するデータを含むシークレット。 |
8.1.93. .spec.apiserverConfig.tlsConfig.cert.configMap
- 説明
- ターゲットに使用するデータを含む ConfigMap。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
8.1.94. .spec.apiserverConfig.tlsConfig.cert.secret
- 説明
- ターゲットに使用するデータを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.95. .spec.apiserverConfig.tlsConfig.keySecret
- 説明
- ターゲットのクライアントキーファイルを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.96. .spec.arbitraryFSAccessThroughSMs
- 説明
-
true の場合、ServiceMonitor、PodMonitor、および Probe オブジェクトは、'Prometheus' コンテナーのファイルシステム上の任意のファイルを参照することが禁止されます。ServiceMonitor のエンドポイントが
bearerTokenFile
値 (例: '/var/run/secrets/kubernetes.io/serviceaccount/token') を指定すると、悪意のあるターゲットは Prometheus のスクレイプ要求内の Prometheus サービスアカウントのトークンにアクセスできるようになります。spec.arbitraryFSAccessThroughSM
を 'true' に設定すると、攻撃を防ぐことができます。代わりに、ユーザーはspec.bearerTokenSecret
フィールドを使用して認証情報を提供する必要があります。 - 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
|
8.1.97. .spec.containers
- 説明
コンテナーを使用すると、追加のコンテナーを挿入したり、Operator が生成したコンテナーを変更したりできます。これを使用すると、Pod に認証プロキシーを追加したり、Operator が生成したコンテナーの動作を変更したりすることができます。ここで説明するコンテナーは、同じ名前を共有し、戦略的マージパッチを介して変更が行われる場合、Operator が生成したコンテナーを変更します。
Operator によって管理されるコンテナーの名前は次のとおりです: *
prometheus
*config-reloader
*thanos-sidecar
コンテナーのオーバーライドは、メンテナーがサポートする範囲外であり、そうすることで、この動作が予告なしにいつでも中断する可能性があることを認めます。
- 型
-
array
8.1.98. .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 |
|
| コンテナーのライフサイクルイベントに対応して管理システムが実行する必要のあるアクション。これを更新することはできません。 |
|
| コンテナーの活性度の定期的な調査。プローブが失敗した場合、コンテナーは再起動されます。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| DNS_LABEL として指定されたコンテナーの名前。Pod 内の各コンテナーには、一意の名前 (DNS_LABEL) が必要です。これを更新することはできません。 |
|
| コンテナーから公開するポートのリスト。ここでポートを指定しなくても、そのポートが公開されるのを防ぐことはできません。コンテナー内のデフォルトの "0.0.0.0" アドレスをリッスンしているポートは、ネットワークからアクセスできます。戦略的マージパッチを使用してこの配列を変更すると、データが破損する可能性があります。詳細は、https://github.com/kubernetes/kubernetes/issues/108255 を参照してください。これを更新することはできません。 |
|
| ContainerPort は、単一のコンテナー内のネットワークポートを表します。 |
|
| コンテナーサービスの準備状況の定期的な調査。プローブが失敗すると、コンテナーはサービスエンドポイントから削除されます。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| コンテナーのリソースサイズ変更ポリシー。 |
|
| ContainerResizePolicy は、コンテナーのリソースサイズ変更ポリシーを表します。 |
|
| このコンテナーに必要なコンピューティングリソース。これを更新することはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
|
| RestartPolicy は、Pod 内の個々のコンテナーの再起動動作を定義します。このフィールドは init コンテナーに対してのみ設定でき、許可される値は "Always" のみです。init 以外のコンテナーの場合、またはこのフィールドが指定されていない場合、再起動の動作は Pod の再起動ポリシーとコンテナータイプによって定義されます。init コンテナーの RestartPolicy を "Always" に設定すると、次の効果が得られます: この init コンテナーは、すべての通常のコンテナーが終了するまで、終了時に継続的に再起動されます。すべての通常のコンテナーが完了すると、restartPolicy が "Always" のすべての init コンテナーがシャットダウンされます。このライフサイクルは通常の init コンテナーとは異なり、多くの場合、"sidecar" コンテナーと呼ばれます。この init コンテナーは、引き続き init コンテナーシーケンス内で開始されますが、次の init コンテナーに進む前にコンテナーが完了するのを待機しません。代わりに、この init コンテナーが起動した直後、または任意の startupProbe が正常に完了した後に、次の init コンテナーが起動します。 |
|
| SecurityContext は、コンテナーを実行する必要があるセキュリティーオプションを定義します。設定されている場合、SecurityContext のフィールドは PodSecurityContext の同等のフィールドをオーバーライドします。詳細: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/ |
|
| StartupProbe は、Pod が正常に初期化されたことを示します。指定した場合、これが正常に完了するまで、他のプローブは実行されません。このプローブが失敗すると、livenessProbe が失敗したかのように、Pod が再起動されます。これは、Pod のライフサイクルの開始時に、定常状態の操作中よりもデータのロードやキャッシュのウォームアップに長い時間がかかる可能性がある場合に、さまざまなプローブパラメーターを提供するために使用できます。これは更新できません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| このコンテナーがコンテナーランタイムで 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 は、コンテナー内でのボリュームのマウントを説明します。 |
|
| コンテナーの作業ディレクトリー。指定しない場合、コンテナーランタイムのデフォルトが使用されます。これは、コンテナーイメージで設定されている可能性があります。これを更新することはできません。 |
8.1.99. .spec.containers[].env
- 説明
- コンテナーに設定する環境変数のリスト。これを更新することはできません。
- 型
-
array
8.1.100. .spec.containers[].env[]
- 説明
- EnvVar は、コンテナーに存在する環境変数を表します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 環境変数の名前。C_IDENTIFIER でなければなりません。 |
|
| 変数参照 $(VAR_NAME) は、コンテナー内で以前に定義された環境変数と任意のサービス環境変数を使用してデプロイメントされます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、"(VAR_NAME)" は文字列リテラル "$(VAR_NAME)" を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。デフォルトは "" です。 |
|
| 環境変数の値のソースです。値が空でない場合は使用できません。 |
8.1.101. .spec.containers[].env[].valueFrom
- 説明
- 環境変数の値のソースです。値が空でない場合は使用できません。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ConfigMap のキーを選択します。 |
|
|
Pod のフィールドを選択します。metadata.name、metadata.namespace、 |
|
| コンテナーのリソースを選択します。現在、リソースの制限とリクエスト (limits.cpu、limits.memory、limits.ephemeral-storage、requests.cpu、requests.memory、requests.ephemeral-storage) のみがサポートされています。 |
|
| Pod の namespace でシークレットのキーを選択します |
8.1.102. .spec.containers[].env[].valueFrom.configMapKeyRef
- 説明
- ConfigMap のキーを選択します。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
8.1.103. .spec.containers[].env[].valueFrom.fieldRef
- 説明
-
Pod のフィールドを選択します。metadata.name、metadata.namespace、
metadata.labels['<KEY>']
、metadata.annotations['<KEY>']
、spec.nodeName、spec.serviceAccountName、status.hostIP、status.podIP、status.podIPs がサポートされています。 - 型
-
object
- 必須
-
fieldPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| FieldPath が記述されているスキーマのバージョン。デフォルトは "v1" です。 |
|
| 指定された API バージョンで選択するフィールドのパス。 |
8.1.104. .spec.containers[].env[].valueFrom.resourceFieldRef
- 説明
- コンテナーのリソースを選択します。現在、リソースの制限とリクエスト (limits.cpu、limits.memory、limits.ephemeral-storage、requests.cpu、requests.memory、requests.ephemeral-storage) のみがサポートされています。
- 型
-
object
- 必須
-
resource
-
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナー名: ボリュームには必須、env 変数にはオプション |
|
| 公開されたリソースの出力形式を指定します。デフォルトは "1" です。 |
|
| 必須: 選択するリソース |
8.1.105. .spec.containers[].env[].valueFrom.secretKeyRef
- 説明
- Pod の namespace でシークレットのキーを選択します
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.106. .spec.containers[].envFrom
- 説明
- コンテナー内の環境変数に入力するソースのリスト。ソース内で定義されたキーは C_IDENTIFIER である必要があります。無効なキーはすべて、コンテナーの起動時にイベントとして報告されます。キーが複数のソースに存在する場合、最後のソースに関連付けられた値が優先されます。重複キーを持つ環境によって定義された値が優先されます。これを更新することはできません。
- 型
-
array
8.1.107. .spec.containers[].envFrom[]
- 説明
- EnvFromSource は、一連の ConfigMap のソースを表します
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択する ConfigMap |
|
| ConfigMap の各キーの前に追加するオプションの識別子。C_IDENTIFIER でなければなりません。 |
|
| から選択する秘密 |
8.1.108. .spec.containers[].envFrom[].configMapRef
- 説明
- 選択する ConfigMap
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap を定義する必要があるかどうかを指定します |
8.1.109. .spec.containers[].envFrom[].secretRef
- 説明
- から選択する秘密
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットを定義する必要があるかどうかを指定します |
8.1.110. .spec.containers[].lifecycle
- 説明
- コンテナーのライフサイクルイベントに対応して管理システムが実行する必要のあるアクション。これを更新することはできません。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| PostStart は、コンテナーが作成された直後に呼び出されます。ハンドラーに障害が発生した場合、コンテナーは終了し、再始動ポリシーに従って再始動されます。フックが完了するまでのコンテナーブロックの他の管理。詳細: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks |
|
| PreStop は、API リクエスト、または活性/起動プローブの失敗、プリエンプション、リソース競合などの管理イベントが原因でコンテナーが終了する直前に呼び出されます。コンテナーがクラッシュまたは終了した場合、ハンドラーは呼び出されません。Pod の終了猶予期間のカウントダウンは、PreStop フックが実行される前に開始されます。ハンドラーの結果に関係なく、コンテナーは最終的に Pod の終了猶予期間内に終了します (ファイナライザーによって遅延されない限り)。フックが完了するまで、または終了猶予期間に達するまで、コンテナーブロックの他の管理。詳細: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks |
8.1.111. .spec.containers[].lifecycle.postStart
- 説明
- PostStart は、コンテナーが作成された直後に呼び出されます。ハンドラーに障害が発生した場合、コンテナーは終了し、再始動ポリシーに従って再始動されます。フックが完了するまでのコンテナーブロックの他の管理。詳細: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Exec は実行するアクションを指定します。 |
|
| HTTPGet は、実行する http リクエストを指定します。 |
|
| Sleep は、コンテナーが終了されるまでのスリープ期間を表します。 |
|
| 非推奨。TCPSocket は LifecycleHandler としてサポートされておらず、後方互換性を確保するために保持されています。このフィールドは検証されず、tcp ハンドラーが指定されている場合、ライフサイクルフックは実行時に失敗します。 |
8.1.112. .spec.containers[].lifecycle.postStart.exec
- 説明
- Exec は実行するアクションを指定します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
8.1.113. .spec.containers[].lifecycle.postStart.httpGet
- 説明
- HTTPGet は、実行する http リクエストを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
|
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。 |
8.1.114. .spec.containers[].lifecycle.postStart.httpGet.httpHeaders
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
8.1.115. .spec.containers[].lifecycle.postStart.httpGet.httpHeaders[]
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
8.1.116. .spec.containers[].lifecycle.postStart.sleep
- 説明
- Sleep は、コンテナーが終了されるまでのスリープ期間を表します。
- 型
-
object
- 必須
-
秒
-
プロパティー | 型 | 説明 |
---|---|---|
|
| Seconds はスリープする秒数です。 |
8.1.117. .spec.containers[].lifecycle.postStart.tcpSocket
- 説明
- 非推奨。TCPSocket は LifecycleHandler としてサポートされておらず、後方互換性を確保するために保持されています。このフィールドは検証されず、tcp ハンドラーが指定されている場合、ライフサイクルフックは実行時に失敗します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
|
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
8.1.118. .spec.containers[].lifecycle.preStop
- 説明
- PreStop は、API リクエスト、または活性/起動プローブの失敗、プリエンプション、リソース競合などの管理イベントが原因でコンテナーが終了する直前に呼び出されます。コンテナーがクラッシュまたは終了した場合、ハンドラーは呼び出されません。Pod の終了猶予期間のカウントダウンは、PreStop フックが実行される前に開始されます。ハンドラーの結果に関係なく、コンテナーは最終的に Pod の終了猶予期間内に終了します (ファイナライザーによって遅延されない限り)。フックが完了するまで、または終了猶予期間に達するまで、コンテナーブロックの他の管理。詳細: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Exec は実行するアクションを指定します。 |
|
| HTTPGet は、実行する http リクエストを指定します。 |
|
| Sleep は、コンテナーが終了されるまでのスリープ期間を表します。 |
|
| 非推奨。TCPSocket は LifecycleHandler としてサポートされておらず、後方互換性を確保するために保持されています。このフィールドは検証されず、tcp ハンドラーが指定されている場合、ライフサイクルフックは実行時に失敗します。 |
8.1.119. .spec.containers[].lifecycle.preStop.exec
- 説明
- Exec は実行するアクションを指定します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
8.1.120. .spec.containers[].lifecycle.preStop.httpGet
- 説明
- HTTPGet は、実行する http リクエストを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
|
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。 |
8.1.121. .spec.containers[].lifecycle.preStop.httpGet.httpHeaders
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
8.1.122. .spec.containers[].lifecycle.preStop.httpGet.httpHeaders[]
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
8.1.123. .spec.containers[].lifecycle.preStop.sleep
- 説明
- Sleep は、コンテナーが終了されるまでのスリープ期間を表します。
- 型
-
object
- 必須
-
秒
-
プロパティー | 型 | 説明 |
---|---|---|
|
| Seconds はスリープする秒数です。 |
8.1.124. .spec.containers[].lifecycle.preStop.tcpSocket
- 説明
- 非推奨。TCPSocket は LifecycleHandler としてサポートされておらず、後方互換性を確保するために保持されています。このフィールドは検証されず、tcp ハンドラーが指定されている場合、ライフサイクルフックは実行時に失敗します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
|
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
8.1.125. .spec.containers[].livenessProbe
- 説明
- コンテナーの活性度の定期的な調査。プローブが失敗した場合、コンテナーは再起動されます。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Exec は実行するアクションを指定します。 |
|
| 正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。 |
|
| GRPC は、GRPC ポートに関連するアクションを指定します。 |
|
| HTTPGet は、実行する http リクエストを指定します。 |
|
| コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。 |
|
| 失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。 |
|
| TCPSocket は、TCP ポートを含むアクションを指定します。 |
|
| プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。 |
|
| プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
8.1.126. .spec.containers[].livenessProbe.exec
- 説明
- Exec は実行するアクションを指定します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
8.1.127. .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 によって定義されます。 |
8.1.128. .spec.containers[].livenessProbe.httpGet
- 説明
- HTTPGet は、実行する http リクエストを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
|
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。 |
8.1.129. .spec.containers[].livenessProbe.httpGet.httpHeaders
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
8.1.130. .spec.containers[].livenessProbe.httpGet.httpHeaders[]
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
8.1.131. .spec.containers[].livenessProbe.tcpSocket
- 説明
- TCPSocket は、TCP ポートを含むアクションを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
|
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
8.1.132. .spec.containers[].ports
- 説明
- コンテナーから公開するポートのリスト。ここでポートを指定しなくても、そのポートが公開されるのを防ぐことはできません。コンテナー内のデフォルトの "0.0.0.0" アドレスをリッスンしているポートは、ネットワークからアクセスできます。戦略的マージパッチを使用してこの配列を変更すると、データが破損する可能性があります。詳細は、https://github.com/kubernetes/kubernetes/issues/108255 を参照してください。これを更新することはできません。
- 型
-
array
8.1.133. .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" です。 |
8.1.134. .spec.containers[].readinessProbe
- 説明
- コンテナーサービスの準備状況の定期的な調査。プローブが失敗すると、コンテナーはサービスエンドポイントから削除されます。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Exec は実行するアクションを指定します。 |
|
| 正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。 |
|
| GRPC は、GRPC ポートに関連するアクションを指定します。 |
|
| HTTPGet は、実行する http リクエストを指定します。 |
|
| コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。 |
|
| 失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。 |
|
| TCPSocket は、TCP ポートを含むアクションを指定します。 |
|
| プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。 |
|
| プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
8.1.135. .spec.containers[].readinessProbe.exec
- 説明
- Exec は実行するアクションを指定します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
8.1.136. .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 によって定義されます。 |
8.1.137. .spec.containers[].readinessProbe.httpGet
- 説明
- HTTPGet は、実行する http リクエストを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
|
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。 |
8.1.138. .spec.containers[].readinessProbe.httpGet.httpHeaders
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
8.1.139. .spec.containers[].readinessProbe.httpGet.httpHeaders[]
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
8.1.140. .spec.containers[].readinessProbe.tcpSocket
- 説明
- TCPSocket は、TCP ポートを含むアクションを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
|
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
8.1.141. .spec.containers[].resizePolicy
- 説明
- コンテナーのリソースサイズ変更ポリシー。
- 型
-
array
8.1.142. .spec.containers[].resizePolicy[]
- 説明
- ContainerResizePolicy は、コンテナーのリソースサイズ変更ポリシーを表します。
- 型
-
object
- 必須
-
resourceName
-
restartPolicy
-
プロパティー | 型 | 説明 |
---|---|---|
|
| このリソースサイズ変更ポリシーが適用されるリソースの名前。対応している値は、cpu、memory です。 |
|
| 指定されたリソースのサイズが変更されたときに適用する再起動ポリシー。指定しない場合、デフォルトの NotRequired が設定されます。 |
8.1.143. .spec.containers[].resources
- 説明
- このコンテナーに必要なコンピューティングリソース。これを更新することはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。 これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。 このフィールドは不変です。これはコンテナーにのみ設定できます。 |
|
| ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。 |
|
| limits は、許可されるコンピュートリソースの最大量を示します。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
|
| requests は、必要なコンピュートリソースの最小量を示します。コンテナーで Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
8.1.144. .spec.containers[].resources.claims
- 説明
Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。
これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。
このフィールドは不変です。これはコンテナーにのみ設定できます。
- 型
-
array
8.1.145. .spec.containers[].resources.claims[]
- 説明
- ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。 |
|
| request は、参照されるクレーム内のリクエストに対して選択された名前です。空の場合、クレームからのすべてのものが利用可能になり、それ以外の場合はこの request の結果のみが利用可能になります。 |
8.1.146. .spec.containers[].securityContext
- 説明
- SecurityContext は、コンテナーを実行する必要があるセキュリティーオプションを定義します。設定されている場合、SecurityContext のフィールドは PodSecurityContext の同等のフィールドをオーバーライドします。詳細: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| AllowPrivilegeEscalation は、プロセスがその親プロセスよりも多くの特権を取得できるかどうかを制御します。このブール値は、no_new_privs フラグがコンテナープロセスに設定されるかどうかを直接制御します。コンテナーが 1) 特権で実行されており、CAP_SYS_ADMIN が割り当てられている場合、2) AllowPrivilegeEscalation は常に true です。spec.os.name が windows の場合は、このフィールドは設定できないことに注意してください。 |
|
| appArmorProfile は、このコンテナーで使用する AppArmor オプションです。設定されている場合、このプロファイルによって Pod の appArmorProfile がオーバーライドされます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| コンテナーの実行時に追加/削除する機能。デフォルトは、コンテナーランタイムによって付与されるデフォルトの機能セットです。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| コンテナーを特権モードで実行します。特権コンテナー内のプロセスは、基本的にホスト上の root と同等です。デフォルトは false です。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| procMount は、コンテナーに使用する proc マウントのタイプを示します。デフォルト値は Default で、読み取り専用パスおよびマスクされたパスのコンテナーランタイムのデフォルトを使用します。これには、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 の場合、このフィールドは設定できないことに注意してください。 |
|
| コンテナーに適用される SELinux コンテキスト。指定しない場合、コンテナーランタイムはコンテナーごとにランダムな SELinux コンテキストを割り当てます。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| このコンテナーで使用する seccomp オプション。Pod とコンテナーの両方のレベルで seccomp オプションが提供されている場合、コンテナーオプションは Pod オプションを上書きします。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| すべてのコンテナーに適用される Windows 固有の設定。指定しない場合、PodSecurityContext のオプションが使用されます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が linux の場合は、このフィールドを設定できないことに注意してください。 |
8.1.147. .spec.containers[].securityContext.appArmorProfile
- 説明
- appArmorProfile は、このコンテナーで使用する AppArmor オプションです。設定されている場合、このプロファイルによって Pod の appArmorProfile がオーバーライドされます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| localhostProfile は、使用する必要があるノードにロードされたプロファイルを示します。プロファイルが機能するには、ノードで事前に設定されている必要があります。プロファイルのロードされた名前と一致する必要があります。タイプが "Localhost" の場合にのみ設定する必要があります。 |
|
| type は、適用される AppArmor プロファイルの種類を示します。有効なオプション: Localhost - ノードに事前にロードされたプロファイル。RuntimeDefault - コンテナーランタイムのデフォルトのプロファイル。制限なし - AppArmor の強制はありません。 |
8.1.148. .spec.containers[].securityContext.capabilities
- 説明
- コンテナーの実行時に追加/削除する機能。デフォルトは、コンテナーランタイムによって付与されるデフォルトの機能セットです。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 追加された機能 |
|
| 削除された機能 |
8.1.149. .spec.containers[].securityContext.seLinuxOptions
- 説明
- コンテナーに適用される SELinux コンテキスト。指定しない場合、コンテナーランタイムはコンテナーごとにランダムな SELinux コンテキストを割り当てます。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Level は、コンテナーに適用される SELinux レベルのラベルです。 |
|
| Role は、コンテナーに適用される SELinux ロールラベルです。 |
|
| Type は、コンテナーに適用される SELinux タイプのラベルです。 |
|
| User は、コンテナーに適用される SELinux ユーザーラベルです。 |
8.1.150. .spec.containers[].securityContext.seccompProfile
- 説明
- このコンテナーで使用する seccomp オプション。Pod とコンテナーの両方のレベルで seccomp オプションが提供されている場合、コンテナーオプションは Pod オプションを上書きします。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| localhostProfile は、ノード上のファイルで定義されたプロファイルを使用する必要があることを示します。プロファイルが機能するには、ノードで事前に設定されている必要があります。kubelet の設定済みの seccomp プロファイルの場所を基準にして、降順のパスである必要があります。タイプが "Localhost" の場合は設定する必要があります。他のタイプには設定しないでください。 |
|
| type は、適用される seccomp プロファイルの種類を示します。有効なオプションは以下のとおりです。 Localhost - ノード上のファイルで定義されたプロファイルを使用する必要があります。RuntimeDefault- コンテナーのランタイムデフォルトプロファイルを使用する必要があります。制限なし - プロファイルを適用しないでください。 |
8.1.151. .spec.containers[].securityContext.windowsOptions
- 説明
- すべてのコンテナーに適用される Windows 固有の設定。指定しない場合、PodSecurityContext のオプションが使用されます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が linux の場合は、このフィールドを設定できないことに注意してください。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| GMSACredentialSpec は、GMSA アドミッション Webhook (https://github.com/kubernetes-sigs/windows-gmsa) が GMSACredentialSpecName フィールドで指定された GMSA クレデンシャル仕様のコンテンツをインライン化する場所です。 |
|
| GMSACredentialSpecName は、使用する GMSA 認証情報仕様の名前です。 |
|
| hostProcess は、コンテナーを 'Host Process' コンテナーとして実行する必要があるかどうかを決定します。Pod のすべてのコンテナーは、同じ有効な HostProcess 値を持っている必要があります (HostProcess コンテナーと非 HostProcess コンテナーを混在させることはできません)。さらに、HostProcess が true の場合、HostNetwork も true に設定する必要があります。 |
|
| コンテナープロセスのエントリーポイントを実行するための Windows の UserName。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。 |
8.1.152. .spec.containers[].startupProbe
- 説明
- StartupProbe は、Pod が正常に初期化されたことを示します。指定した場合、これが正常に完了するまで、他のプローブは実行されません。このプローブが失敗すると、livenessProbe が失敗したかのように、Pod が再起動されます。これは、Pod のライフサイクルの開始時に、定常状態の操作中よりもデータのロードやキャッシュのウォームアップに長い時間がかかる可能性がある場合に、さまざまなプローブパラメーターを提供するために使用できます。これは更新できません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Exec は実行するアクションを指定します。 |
|
| 正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。 |
|
| GRPC は、GRPC ポートに関連するアクションを指定します。 |
|
| HTTPGet は、実行する http リクエストを指定します。 |
|
| コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。 |
|
| 失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。 |
|
| TCPSocket は、TCP ポートを含むアクションを指定します。 |
|
| プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。 |
|
| プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
8.1.153. .spec.containers[].startupProbe.exec
- 説明
- Exec は実行するアクションを指定します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
8.1.154. .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 によって定義されます。 |
8.1.155. .spec.containers[].startupProbe.httpGet
- 説明
- HTTPGet は、実行する http リクエストを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
|
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。 |
8.1.156. .spec.containers[].startupProbe.httpGet.httpHeaders
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
8.1.157. .spec.containers[].startupProbe.httpGet.httpHeaders[]
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
8.1.158. .spec.containers[].startupProbe.tcpSocket
- 説明
- TCPSocket は、TCP ポートを含むアクションを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
|
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
8.1.159. .spec.containers[].volumeDevices
- 説明
- volumeDevices は、コンテナーによって使用されるブロックデバイスのリストです。
- 型
-
array
8.1.160. .spec.containers[].volumeDevices[]
- 説明
- volumeDevice は、コンテナー内の raw ブロックデバイスのマッピングを記述します。
- 型
-
object
- 必須
-
devicePath
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| devicePath は、デバイスがマップされるコンテナー内のパスです。 |
|
| name は、Pod 内の persistentVolumeClaim の名前と一致する必要があります |
8.1.161. .spec.containers[].volumeMounts
- 説明
- コンテナーのファイルシステムにマウントする Pod ボリューム。これを更新することはできません。
- 型
-
array
8.1.162. .spec.containers[].volumeMounts[]
- 説明
- VolumeMount は、コンテナー内でのボリュームのマウントを説明します。
- 型
-
object
- 必須
-
mountPath
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ボリュームをマウントする必要があるコンテナー内のパス。':' を含めることはできません。 |
|
| mountPropagation は、マウントがホストからコンテナーに、またはその逆にどのように伝播されるかを決定します。設定されていない場合、MountPropagationNone が使用されます。このフィールドは 1.10 のベータ版です。RecursiveReadOnly が IfPossible または Enabled に設定されている場合、MountPropagation は None または未指定 (デフォルトは None) にする必要があります。 |
|
| ボリュームの名前に一致する必要があります。 |
|
| true の場合は読み取り専用、それ以外の場合は読み取り/書き込み (false または指定なし) でマウントされます。デフォルトは false です。 |
|
| RecursiveReadOnly は、読み取り専用マウントを再帰的に処理するかどうかを指定します。 ReadOnly が false の場合、このフィールドには意味がなく、未指定にする必要があります。 ReadOnly が true で、このフィールドが Disabled に設定されている場合、マウントは再帰的に読み取り専用にはなりません。このフィールドが IfPossible に設定されている場合、コンテナーランタイムでサポートされている場合は、マウントは再帰的に読み取り専用になります。このフィールドが Enabled に設定されている場合で、コンテナーランタイムでサポートされている場合は、マウントが再帰的に読み取り専用になり、そうでない場合は Pod が起動されず、理由を示すエラーが生成されます。 このフィールドが IfPossible または Enabled に設定されている場合、MountPropagation は None に設定する必要があります (または未指定にする必要があります。この場合、デフォルトは None になります)。 このフィールドが指定されていない場合は、無効と同じ扱いになります。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内のパス。デフォルトは "" (ボリュームのルート) です。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内の拡張パス。SubPath と同様に動作しますが、環境変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。デフォルトは "" (ボリュームのルート) です。SubPathExpr と SubPath は相互に排他的です。 |
8.1.163. .spec.dnsConfig
- 説明
- Pod の DNS 設定を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| DNS ネームサーバーの IP アドレスのリスト。これは、DNSPolicy から生成されたベースネームサーバーに追加されます。 |
|
| DNS リゾルバーオプションのリスト。これは、DNSPolicy から生成された基本オプションとマージされます。オプションで指定された解決オプションは、ベース DNS ポリシーに表示されるものをオーバーライドします。 |
|
| PodDNSConfigOption は、Pod の DNS リゾルバーオプションを定義します。 |
|
| ホスト名ルックアップ用の DNS 検索ドメインのリスト。これは、DNSPolicy から生成された基本検索パスに追加されます。 |
8.1.164. .spec.dnsConfig.options
- 説明
- DNS リゾルバーオプションのリスト。これは、DNSPolicy から生成された基本オプションとマージされます。オプションで指定された解決オプションは、ベース DNS ポリシーに表示されるものをオーバーライドします。
- 型
-
array
8.1.165. .spec.dnsConfig.options[]
- 説明
- PodDNSConfigOption は、Pod の DNS リゾルバーオプションを定義します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 名前は必須であり、一意である必要があります。 |
|
| 値は任意です。 |
8.1.166. .spec.excludedFromEnforcement
- 説明
元の namespace ラベルの適用から除外される PodMonitor、ServiceMonitor、Probe、および PrometheusRule オブジェクトへの参照のリスト。
spec.enforcedNamespaceLabel
が true に設定されている場合にのみ適用されます。- 型
-
array
8.1.167. .spec.excludedFromEnforcement[]
- 説明
- ObjectReference は、PodMonitor、ServiceMonitor、Probe、または PrometheusRule オブジェクトを参照します。
- 型
-
object
- 必須
-
namespace
-
resource
-
プロパティー | 型 | 説明 |
---|---|---|
|
|
参照先のグループ。指定しない場合は、デフォルトで |
|
| 参照先の名前。設定されていない場合は、namespace 内のすべてのリソースが一致します。 |
|
| 参照先の namespace。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
|
| 参照先のリソース。 |
8.1.168. .spec.exemplars
- 説明
-
実行時に再読み込み可能な Exemplar 関連の設定。有効にするには、
exemplar-storage
機能フラグを有効にする必要があります。 - 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| すべてのシリーズでメモリーに保存されるエグザンプラーの最大数。
エグザンプラーをスクレイピングするには、 設定されていない場合、Prometheus はデフォルト値を使用します。値が 0 または 0 未満の場合、ストレージは無効になります。 |
8.1.169. .spec.hostAliases
- 説明
- 指定された場合に Pod のホストファイルに注入されるホストと IP のオプションのリスト。
- 型
-
array
8.1.170. .spec.hostAliases[]
- 説明
- HostAlias は、Pod の hosts ファイルのエントリーとして挿入される IP とホスト名の間のマッピングを保持します。
- 型
-
object
- 必須
-
hostnames
-
ip
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 上記の IP アドレスのホスト名。 |
|
| ホストファイルエントリーの IP アドレス。 |
8.1.171. .spec.imagePullSecrets
- 説明
- レジストリーからイメージをプルするために使用する、同じ namespace 内の Secret へのオプションの参照リスト。http://kubernetes.io/docs/user-guide/images#specifying-imagepullsecrets-on-a-pod を参照してください。
- 型
-
array
8.1.172. .spec.imagePullSecrets[]
- 説明
- LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
8.1.173. .spec.initContainers
- 説明
InitContainers を使用して、Pod 定義に initContainers を注入できます。これらは、たとえば、外部ソースから Prometheus 設定に注入するためのシークレットをフェッチするために使用できます。initContainer の実行中にエラーが発生すると、Pod が再起動します。詳細: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/ ここで説明する InitContainers は、同じ名前を共有し、戦略的なマージパッチを介して変更が行われる場合は、オペレーターが生成した init コンテナーを変更します。
Operator によって管理される init コンテナー名は次のとおりです: *
init-config-reloader
。init コンテナーのオーバーライドは、メンテナーがサポートする範囲外であり、そうすることで、この動作が予告なしにいつでも中断する可能性があることを認めます。
- 型
-
array
8.1.174. .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 |
|
| コンテナーのライフサイクルイベントに対応して管理システムが実行する必要のあるアクション。これを更新することはできません。 |
|
| コンテナーの活性度の定期的な調査。プローブが失敗した場合、コンテナーは再起動されます。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| DNS_LABEL として指定されたコンテナーの名前。Pod 内の各コンテナーには、一意の名前 (DNS_LABEL) が必要です。これを更新することはできません。 |
|
| コンテナーから公開するポートのリスト。ここでポートを指定しなくても、そのポートが公開されるのを防ぐことはできません。コンテナー内のデフォルトの "0.0.0.0" アドレスをリッスンしているポートは、ネットワークからアクセスできます。戦略的マージパッチを使用してこの配列を変更すると、データが破損する可能性があります。詳細は、https://github.com/kubernetes/kubernetes/issues/108255 を参照してください。これを更新することはできません。 |
|
| ContainerPort は、単一のコンテナー内のネットワークポートを表します。 |
|
| コンテナーサービスの準備状況の定期的な調査。プローブが失敗すると、コンテナーはサービスエンドポイントから削除されます。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| コンテナーのリソースサイズ変更ポリシー。 |
|
| ContainerResizePolicy は、コンテナーのリソースサイズ変更ポリシーを表します。 |
|
| このコンテナーに必要なコンピューティングリソース。これを更新することはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
|
| RestartPolicy は、Pod 内の個々のコンテナーの再起動動作を定義します。このフィールドは init コンテナーに対してのみ設定でき、許可される値は "Always" のみです。init 以外のコンテナーの場合、またはこのフィールドが指定されていない場合、再起動の動作は Pod の再起動ポリシーとコンテナータイプによって定義されます。init コンテナーの RestartPolicy を "Always" に設定すると、次の効果が得られます: この init コンテナーは、すべての通常のコンテナーが終了するまで、終了時に継続的に再起動されます。すべての通常のコンテナーが完了すると、restartPolicy が "Always" のすべての init コンテナーがシャットダウンされます。このライフサイクルは通常の init コンテナーとは異なり、多くの場合、"sidecar" コンテナーと呼ばれます。この init コンテナーは、引き続き init コンテナーシーケンス内で開始されますが、次の init コンテナーに進む前にコンテナーが完了するのを待機しません。代わりに、この init コンテナーが起動した直後、または任意の startupProbe が正常に完了した後に、次の init コンテナーが起動します。 |
|
| SecurityContext は、コンテナーを実行する必要があるセキュリティーオプションを定義します。設定されている場合、SecurityContext のフィールドは PodSecurityContext の同等のフィールドをオーバーライドします。詳細: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/ |
|
| StartupProbe は、Pod が正常に初期化されたことを示します。指定した場合、これが正常に完了するまで、他のプローブは実行されません。このプローブが失敗すると、livenessProbe が失敗したかのように、Pod が再起動されます。これは、Pod のライフサイクルの開始時に、定常状態の操作中よりもデータのロードやキャッシュのウォームアップに長い時間がかかる可能性がある場合に、さまざまなプローブパラメーターを提供するために使用できます。これは更新できません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| このコンテナーがコンテナーランタイムで 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 は、コンテナー内でのボリュームのマウントを説明します。 |
|
| コンテナーの作業ディレクトリー。指定しない場合、コンテナーランタイムのデフォルトが使用されます。これは、コンテナーイメージで設定されている可能性があります。これを更新することはできません。 |
8.1.175. .spec.initContainers[].env
- 説明
- コンテナーに設定する環境変数のリスト。これを更新することはできません。
- 型
-
array
8.1.176. .spec.initContainers[].env[]
- 説明
- EnvVar は、コンテナーに存在する環境変数を表します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 環境変数の名前。C_IDENTIFIER でなければなりません。 |
|
| 変数参照 $(VAR_NAME) は、コンテナー内で以前に定義された環境変数と任意のサービス環境変数を使用してデプロイメントされます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、"(VAR_NAME)" は文字列リテラル "$(VAR_NAME)" を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。デフォルトは "" です。 |
|
| 環境変数の値のソースです。値が空でない場合は使用できません。 |
8.1.177. .spec.initContainers[].env[].valueFrom
- 説明
- 環境変数の値のソースです。値が空でない場合は使用できません。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ConfigMap のキーを選択します。 |
|
|
Pod のフィールドを選択します。metadata.name、metadata.namespace、 |
|
| コンテナーのリソースを選択します。現在、リソースの制限とリクエスト (limits.cpu、limits.memory、limits.ephemeral-storage、requests.cpu、requests.memory、requests.ephemeral-storage) のみがサポートされています。 |
|
| Pod の namespace でシークレットのキーを選択します |
8.1.178. .spec.initContainers[].env[].valueFrom.configMapKeyRef
- 説明
- ConfigMap のキーを選択します。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
8.1.179. .spec.initContainers[].env[].valueFrom.fieldRef
- 説明
-
Pod のフィールドを選択します。metadata.name、metadata.namespace、
metadata.labels['<KEY>']
、metadata.annotations['<KEY>']
、spec.nodeName、spec.serviceAccountName、status.hostIP、status.podIP、status.podIPs がサポートされています。 - 型
-
object
- 必須
-
fieldPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| FieldPath が記述されているスキーマのバージョン。デフォルトは "v1" です。 |
|
| 指定された API バージョンで選択するフィールドのパス。 |
8.1.180. .spec.initContainers[].env[].valueFrom.resourceFieldRef
- 説明
- コンテナーのリソースを選択します。現在、リソースの制限とリクエスト (limits.cpu、limits.memory、limits.ephemeral-storage、requests.cpu、requests.memory、requests.ephemeral-storage) のみがサポートされています。
- 型
-
object
- 必須
-
resource
-
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナー名: ボリュームには必須、env 変数にはオプション |
|
| 公開されたリソースの出力形式を指定します。デフォルトは "1" です。 |
|
| 必須: 選択するリソース |
8.1.181. .spec.initContainers[].env[].valueFrom.secretKeyRef
- 説明
- Pod の namespace でシークレットのキーを選択します
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.182. .spec.initContainers[].envFrom
- 説明
- コンテナー内の環境変数に入力するソースのリスト。ソース内で定義されたキーは C_IDENTIFIER である必要があります。無効なキーはすべて、コンテナーの起動時にイベントとして報告されます。キーが複数のソースに存在する場合、最後のソースに関連付けられた値が優先されます。重複キーを持つ環境によって定義された値が優先されます。これを更新することはできません。
- 型
-
array
8.1.183. .spec.initContainers[].envFrom[]
- 説明
- EnvFromSource は、一連の ConfigMap のソースを表します
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択する ConfigMap |
|
| ConfigMap の各キーの前に追加するオプションの識別子。C_IDENTIFIER でなければなりません。 |
|
| から選択する秘密 |
8.1.184. .spec.initContainers[].envFrom[].configMapRef
- 説明
- 選択する ConfigMap
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap を定義する必要があるかどうかを指定します |
8.1.185. .spec.initContainers[].envFrom[].secretRef
- 説明
- から選択する秘密
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットを定義する必要があるかどうかを指定します |
8.1.186. .spec.initContainers[].lifecycle
- 説明
- コンテナーのライフサイクルイベントに対応して管理システムが実行する必要のあるアクション。これを更新することはできません。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| PostStart は、コンテナーが作成された直後に呼び出されます。ハンドラーに障害が発生した場合、コンテナーは終了し、再始動ポリシーに従って再始動されます。フックが完了するまでのコンテナーブロックの他の管理。詳細: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks |
|
| PreStop は、API リクエスト、または活性/起動プローブの失敗、プリエンプション、リソース競合などの管理イベントが原因でコンテナーが終了する直前に呼び出されます。コンテナーがクラッシュまたは終了した場合、ハンドラーは呼び出されません。Pod の終了猶予期間のカウントダウンは、PreStop フックが実行される前に開始されます。ハンドラーの結果に関係なく、コンテナーは最終的に Pod の終了猶予期間内に終了します (ファイナライザーによって遅延されない限り)。フックが完了するまで、または終了猶予期間に達するまで、コンテナーブロックの他の管理。詳細: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks |
8.1.187. .spec.initContainers[].lifecycle.postStart
- 説明
- PostStart は、コンテナーが作成された直後に呼び出されます。ハンドラーに障害が発生した場合、コンテナーは終了し、再始動ポリシーに従って再始動されます。フックが完了するまでのコンテナーブロックの他の管理。詳細: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Exec は実行するアクションを指定します。 |
|
| HTTPGet は、実行する http リクエストを指定します。 |
|
| Sleep は、コンテナーが終了されるまでのスリープ期間を表します。 |
|
| 非推奨。TCPSocket は LifecycleHandler としてサポートされておらず、後方互換性を確保するために保持されています。このフィールドは検証されず、tcp ハンドラーが指定されている場合、ライフサイクルフックは実行時に失敗します。 |
8.1.188. .spec.initContainers[].lifecycle.postStart.exec
- 説明
- Exec は実行するアクションを指定します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
8.1.189. .spec.initContainers[].lifecycle.postStart.httpGet
- 説明
- HTTPGet は、実行する http リクエストを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
|
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。 |
8.1.190. .spec.initContainers[].lifecycle.postStart.httpGet.httpHeaders
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
8.1.191. .spec.initContainers[].lifecycle.postStart.httpGet.httpHeaders[]
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
8.1.192. .spec.initContainers[].lifecycle.postStart.sleep
- 説明
- Sleep は、コンテナーが終了されるまでのスリープ期間を表します。
- 型
-
object
- 必須
-
秒
-
プロパティー | 型 | 説明 |
---|---|---|
|
| Seconds はスリープする秒数です。 |
8.1.193. .spec.initContainers[].lifecycle.postStart.tcpSocket
- 説明
- 非推奨。TCPSocket は LifecycleHandler としてサポートされておらず、後方互換性を確保するために保持されています。このフィールドは検証されず、tcp ハンドラーが指定されている場合、ライフサイクルフックは実行時に失敗します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
|
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
8.1.194. .spec.initContainers[].lifecycle.preStop
- 説明
- PreStop は、API リクエスト、または活性/起動プローブの失敗、プリエンプション、リソース競合などの管理イベントが原因でコンテナーが終了する直前に呼び出されます。コンテナーがクラッシュまたは終了した場合、ハンドラーは呼び出されません。Pod の終了猶予期間のカウントダウンは、PreStop フックが実行される前に開始されます。ハンドラーの結果に関係なく、コンテナーは最終的に Pod の終了猶予期間内に終了します (ファイナライザーによって遅延されない限り)。フックが完了するまで、または終了猶予期間に達するまで、コンテナーブロックの他の管理。詳細: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Exec は実行するアクションを指定します。 |
|
| HTTPGet は、実行する http リクエストを指定します。 |
|
| Sleep は、コンテナーが終了されるまでのスリープ期間を表します。 |
|
| 非推奨。TCPSocket は LifecycleHandler としてサポートされておらず、後方互換性を確保するために保持されています。このフィールドは検証されず、tcp ハンドラーが指定されている場合、ライフサイクルフックは実行時に失敗します。 |
8.1.195. .spec.initContainers[].lifecycle.preStop.exec
- 説明
- Exec は実行するアクションを指定します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
8.1.196. .spec.initContainers[].lifecycle.preStop.httpGet
- 説明
- HTTPGet は、実行する http リクエストを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
|
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。 |
8.1.197. .spec.initContainers[].lifecycle.preStop.httpGet.httpHeaders
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
8.1.198. .spec.initContainers[].lifecycle.preStop.httpGet.httpHeaders[]
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
8.1.199. .spec.initContainers[].lifecycle.preStop.sleep
- 説明
- Sleep は、コンテナーが終了されるまでのスリープ期間を表します。
- 型
-
object
- 必須
-
秒
-
プロパティー | 型 | 説明 |
---|---|---|
|
| Seconds はスリープする秒数です。 |
8.1.200. .spec.initContainers[].lifecycle.preStop.tcpSocket
- 説明
- 非推奨。TCPSocket は LifecycleHandler としてサポートされておらず、後方互換性を確保するために保持されています。このフィールドは検証されず、tcp ハンドラーが指定されている場合、ライフサイクルフックは実行時に失敗します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
|
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
8.1.201. .spec.initContainers[].livenessProbe
- 説明
- コンテナーの活性度の定期的な調査。プローブが失敗した場合、コンテナーは再起動されます。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Exec は実行するアクションを指定します。 |
|
| 正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。 |
|
| GRPC は、GRPC ポートに関連するアクションを指定します。 |
|
| HTTPGet は、実行する http リクエストを指定します。 |
|
| コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。 |
|
| 失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。 |
|
| TCPSocket は、TCP ポートを含むアクションを指定します。 |
|
| プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。 |
|
| プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
8.1.202. .spec.initContainers[].livenessProbe.exec
- 説明
- Exec は実行するアクションを指定します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
8.1.203. .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 によって定義されます。 |
8.1.204. .spec.initContainers[].livenessProbe.httpGet
- 説明
- HTTPGet は、実行する http リクエストを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
|
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。 |
8.1.205. .spec.initContainers[].livenessProbe.httpGet.httpHeaders
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
8.1.206. .spec.initContainers[].livenessProbe.httpGet.httpHeaders[]
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
8.1.207. .spec.initContainers[].livenessProbe.tcpSocket
- 説明
- TCPSocket は、TCP ポートを含むアクションを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
|
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
8.1.208. .spec.initContainers[].ports
- 説明
- コンテナーから公開するポートのリスト。ここでポートを指定しなくても、そのポートが公開されるのを防ぐことはできません。コンテナー内のデフォルトの "0.0.0.0" アドレスをリッスンしているポートは、ネットワークからアクセスできます。戦略的マージパッチを使用してこの配列を変更すると、データが破損する可能性があります。詳細は、https://github.com/kubernetes/kubernetes/issues/108255 を参照してください。これを更新することはできません。
- 型
-
array
8.1.209. .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" です。 |
8.1.210. .spec.initContainers[].readinessProbe
- 説明
- コンテナーサービスの準備状況の定期的な調査。プローブが失敗すると、コンテナーはサービスエンドポイントから削除されます。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Exec は実行するアクションを指定します。 |
|
| 正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。 |
|
| GRPC は、GRPC ポートに関連するアクションを指定します。 |
|
| HTTPGet は、実行する http リクエストを指定します。 |
|
| コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。 |
|
| 失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。 |
|
| TCPSocket は、TCP ポートを含むアクションを指定します。 |
|
| プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。 |
|
| プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
8.1.211. .spec.initContainers[].readinessProbe.exec
- 説明
- Exec は実行するアクションを指定します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
8.1.212. .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 によって定義されます。 |
8.1.213. .spec.initContainers[].readinessProbe.httpGet
- 説明
- HTTPGet は、実行する http リクエストを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
|
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。 |
8.1.214. .spec.initContainers[].readinessProbe.httpGet.httpHeaders
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
8.1.215. .spec.initContainers[].readinessProbe.httpGet.httpHeaders[]
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
8.1.216. .spec.initContainers[].readinessProbe.tcpSocket
- 説明
- TCPSocket は、TCP ポートを含むアクションを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
|
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
8.1.217. .spec.initContainers[].resizePolicy
- 説明
- コンテナーのリソースサイズ変更ポリシー。
- 型
-
array
8.1.218. .spec.initContainers[].resizePolicy[]
- 説明
- ContainerResizePolicy は、コンテナーのリソースサイズ変更ポリシーを表します。
- 型
-
object
- 必須
-
resourceName
-
restartPolicy
-
プロパティー | 型 | 説明 |
---|---|---|
|
| このリソースサイズ変更ポリシーが適用されるリソースの名前。対応している値は、cpu、memory です。 |
|
| 指定されたリソースのサイズが変更されたときに適用する再起動ポリシー。指定しない場合、デフォルトの NotRequired が設定されます。 |
8.1.219. .spec.initContainers[].resources
- 説明
- このコンテナーに必要なコンピューティングリソース。これを更新することはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。 これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。 このフィールドは不変です。これはコンテナーにのみ設定できます。 |
|
| ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。 |
|
| limits は、許可されるコンピュートリソースの最大量を示します。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
|
| requests は、必要なコンピュートリソースの最小量を示します。コンテナーで Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
8.1.220. .spec.initContainers[].resources.claims
- 説明
Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。
これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。
このフィールドは不変です。これはコンテナーにのみ設定できます。
- 型
-
array
8.1.221. .spec.initContainers[].resources.claims[]
- 説明
- ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。 |
|
| request は、参照されるクレーム内のリクエストに対して選択された名前です。空の場合、クレームからのすべてのものが利用可能になり、それ以外の場合はこの request の結果のみが利用可能になります。 |
8.1.222. .spec.initContainers[].securityContext
- 説明
- SecurityContext は、コンテナーを実行する必要があるセキュリティーオプションを定義します。設定されている場合、SecurityContext のフィールドは PodSecurityContext の同等のフィールドをオーバーライドします。詳細: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| AllowPrivilegeEscalation は、プロセスがその親プロセスよりも多くの特権を取得できるかどうかを制御します。このブール値は、no_new_privs フラグがコンテナープロセスに設定されるかどうかを直接制御します。コンテナーが 1) 特権で実行されており、CAP_SYS_ADMIN が割り当てられている場合、2) AllowPrivilegeEscalation は常に true です。spec.os.name が windows の場合は、このフィールドは設定できないことに注意してください。 |
|
| appArmorProfile は、このコンテナーで使用する AppArmor オプションです。設定されている場合、このプロファイルによって Pod の appArmorProfile がオーバーライドされます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| コンテナーの実行時に追加/削除する機能。デフォルトは、コンテナーランタイムによって付与されるデフォルトの機能セットです。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| コンテナーを特権モードで実行します。特権コンテナー内のプロセスは、基本的にホスト上の root と同等です。デフォルトは false です。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| procMount は、コンテナーに使用する proc マウントのタイプを示します。デフォルト値は Default で、読み取り専用パスおよびマスクされたパスのコンテナーランタイムのデフォルトを使用します。これには、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 の場合、このフィールドは設定できないことに注意してください。 |
|
| コンテナーに適用される SELinux コンテキスト。指定しない場合、コンテナーランタイムはコンテナーごとにランダムな SELinux コンテキストを割り当てます。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| このコンテナーで使用する seccomp オプション。Pod とコンテナーの両方のレベルで seccomp オプションが提供されている場合、コンテナーオプションは Pod オプションを上書きします。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| すべてのコンテナーに適用される Windows 固有の設定。指定しない場合、PodSecurityContext のオプションが使用されます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が linux の場合は、このフィールドを設定できないことに注意してください。 |
8.1.223. .spec.initContainers[].securityContext.appArmorProfile
- 説明
- appArmorProfile は、このコンテナーで使用する AppArmor オプションです。設定されている場合、このプロファイルによって Pod の appArmorProfile がオーバーライドされます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| localhostProfile は、使用する必要があるノードにロードされたプロファイルを示します。プロファイルが機能するには、ノードで事前に設定されている必要があります。プロファイルのロードされた名前と一致する必要があります。タイプが "Localhost" の場合にのみ設定する必要があります。 |
|
| type は、適用される AppArmor プロファイルの種類を示します。有効なオプション: Localhost - ノードに事前にロードされたプロファイル。RuntimeDefault - コンテナーランタイムのデフォルトのプロファイル。制限なし - AppArmor の強制はありません。 |
8.1.224. .spec.initContainers[].securityContext.capabilities
- 説明
- コンテナーの実行時に追加/削除する機能。デフォルトは、コンテナーランタイムによって付与されるデフォルトの機能セットです。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 追加された機能 |
|
| 削除された機能 |
8.1.225. .spec.initContainers[].securityContext.seLinuxOptions
- 説明
- コンテナーに適用される SELinux コンテキスト。指定しない場合、コンテナーランタイムはコンテナーごとにランダムな SELinux コンテキストを割り当てます。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Level は、コンテナーに適用される SELinux レベルのラベルです。 |
|
| Role は、コンテナーに適用される SELinux ロールラベルです。 |
|
| Type は、コンテナーに適用される SELinux タイプのラベルです。 |
|
| User は、コンテナーに適用される SELinux ユーザーラベルです。 |
8.1.226. .spec.initContainers[].securityContext.seccompProfile
- 説明
- このコンテナーで使用する seccomp オプション。Pod とコンテナーの両方のレベルで seccomp オプションが提供されている場合、コンテナーオプションは Pod オプションを上書きします。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| localhostProfile は、ノード上のファイルで定義されたプロファイルを使用する必要があることを示します。プロファイルが機能するには、ノードで事前に設定されている必要があります。kubelet の設定済みの seccomp プロファイルの場所を基準にして、降順のパスである必要があります。タイプが "Localhost" の場合は設定する必要があります。他のタイプには設定しないでください。 |
|
| type は、適用される seccomp プロファイルの種類を示します。有効なオプションは以下のとおりです。 Localhost - ノード上のファイルで定義されたプロファイルを使用する必要があります。RuntimeDefault- コンテナーのランタイムデフォルトプロファイルを使用する必要があります。制限なし - プロファイルを適用しないでください。 |
8.1.227. .spec.initContainers[].securityContext.windowsOptions
- 説明
- すべてのコンテナーに適用される Windows 固有の設定。指定しない場合、PodSecurityContext のオプションが使用されます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が linux の場合は、このフィールドを設定できないことに注意してください。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| GMSACredentialSpec は、GMSA アドミッション Webhook (https://github.com/kubernetes-sigs/windows-gmsa) が GMSACredentialSpecName フィールドで指定された GMSA クレデンシャル仕様のコンテンツをインライン化する場所です。 |
|
| GMSACredentialSpecName は、使用する GMSA 認証情報仕様の名前です。 |
|
| hostProcess は、コンテナーを 'Host Process' コンテナーとして実行する必要があるかどうかを決定します。Pod のすべてのコンテナーは、同じ有効な HostProcess 値を持っている必要があります (HostProcess コンテナーと非 HostProcess コンテナーを混在させることはできません)。さらに、HostProcess が true の場合、HostNetwork も true に設定する必要があります。 |
|
| コンテナープロセスのエントリーポイントを実行するための Windows の UserName。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。 |
8.1.228. .spec.initContainers[].startupProbe
- 説明
- StartupProbe は、Pod が正常に初期化されたことを示します。指定した場合、これが正常に完了するまで、他のプローブは実行されません。このプローブが失敗すると、livenessProbe が失敗したかのように、Pod が再起動されます。これは、Pod のライフサイクルの開始時に、定常状態の操作中よりもデータのロードやキャッシュのウォームアップに長い時間がかかる可能性がある場合に、さまざまなプローブパラメーターを提供するために使用できます。これは更新できません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Exec は実行するアクションを指定します。 |
|
| 正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。 |
|
| GRPC は、GRPC ポートに関連するアクションを指定します。 |
|
| HTTPGet は、実行する http リクエストを指定します。 |
|
| コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。 |
|
| 失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。 |
|
| TCPSocket は、TCP ポートを含むアクションを指定します。 |
|
| プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。 |
|
| プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
8.1.229. .spec.initContainers[].startupProbe.exec
- 説明
- Exec は実行するアクションを指定します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。 |
8.1.230. .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 によって定義されます。 |
8.1.231. .spec.initContainers[].startupProbe.httpGet
- 説明
- HTTPGet は、実行する http リクエストを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。 |
|
| リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。 |
|
| HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します |
|
| HTTP サーバーでアクセスするパス。 |
|
| コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
|
| ホストへの接続に使用するスキーム。デフォルトは HTTP です。 |
8.1.232. .spec.initContainers[].startupProbe.httpGet.httpHeaders
- 説明
- リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
- 型
-
array
8.1.233. .spec.initContainers[].startupProbe.httpGet.httpHeaders[]
- 説明
- HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。 |
|
| ヘッダーフィールド値 |
8.1.234. .spec.initContainers[].startupProbe.tcpSocket
- 説明
- TCPSocket は、TCP ポートを含むアクションを指定します。
- 型
-
object
- 必須
-
port
-
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: 接続するホスト名。デフォルトは Pod IP です。 |
|
| コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。 |
8.1.235. .spec.initContainers[].volumeDevices
- 説明
- volumeDevices は、コンテナーによって使用されるブロックデバイスのリストです。
- 型
-
array
8.1.236. .spec.initContainers[].volumeDevices[]
- 説明
- volumeDevice は、コンテナー内の raw ブロックデバイスのマッピングを記述します。
- 型
-
object
- 必須
-
devicePath
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| devicePath は、デバイスがマップされるコンテナー内のパスです。 |
|
| name は、Pod 内の persistentVolumeClaim の名前と一致する必要があります |
8.1.237. .spec.initContainers[].volumeMounts
- 説明
- コンテナーのファイルシステムにマウントする Pod ボリューム。これを更新することはできません。
- 型
-
array
8.1.238. .spec.initContainers[].volumeMounts[]
- 説明
- VolumeMount は、コンテナー内でのボリュームのマウントを説明します。
- 型
-
object
- 必須
-
mountPath
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ボリュームをマウントする必要があるコンテナー内のパス。':' を含めることはできません。 |
|
| mountPropagation は、マウントがホストからコンテナーに、またはその逆にどのように伝播されるかを決定します。設定されていない場合、MountPropagationNone が使用されます。このフィールドは 1.10 のベータ版です。RecursiveReadOnly が IfPossible または Enabled に設定されている場合、MountPropagation は None または未指定 (デフォルトは None) にする必要があります。 |
|
| ボリュームの名前に一致する必要があります。 |
|
| true の場合は読み取り専用、それ以外の場合は読み取り/書き込み (false または指定なし) でマウントされます。デフォルトは false です。 |
|
| RecursiveReadOnly は、読み取り専用マウントを再帰的に処理するかどうかを指定します。 ReadOnly が false の場合、このフィールドには意味がなく、未指定にする必要があります。 ReadOnly が true で、このフィールドが Disabled に設定されている場合、マウントは再帰的に読み取り専用にはなりません。このフィールドが IfPossible に設定されている場合、コンテナーランタイムでサポートされている場合は、マウントは再帰的に読み取り専用になります。このフィールドが Enabled に設定されている場合で、コンテナーランタイムでサポートされている場合は、マウントが再帰的に読み取り専用になり、そうでない場合は Pod が起動されず、理由を示すエラーが生成されます。 このフィールドが IfPossible または Enabled に設定されている場合、MountPropagation は None に設定する必要があります (または未指定にする必要があります。この場合、デフォルトは None になります)。 このフィールドが指定されていない場合は、無効と同じ扱いになります。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内のパス。デフォルトは "" (ボリュームのルート) です。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内の拡張パス。SubPath と同様に動作しますが、環境変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。デフォルトは "" (ボリュームのルート) です。SubPathExpr と SubPath は相互に排他的です。 |
8.1.239. .spec.otlp
- 説明
- OTLP レシーバーの機能に関する設定。Prometheus v2.55.0 以降が必要です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| メトリクスラベルにプロモートする必要がある OpenTelemetry 属性のリスト。デフォルトは none です。 |
8.1.240. .spec.persistentVolumeClaimRetentionPolicy
- 説明
- このフィールドは、StatefulSet のライフサイクル中に PVC を削除するかどうか、および削除する場合はその方法を制御します。デフォルトの動作では、すべての PVC が保持されます。これは、Kubernetes 1.23 から 1.26 までのアルファフィールドであり、1.26 以降ではベータフィールドです。StatefulSetAutoDeletePVC フィーチャーゲートを有効にする必要があります。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
|
WhenDeleted は、StatefulSet が削除されたときに、StatefulSet VolumeClaimTemplates から作成された PVC に何が起こるかを指定します。 |
|
|
WhenScaled は、StatefulSet がスケールダウンされたときに StatefulSet VolumeClaimTemplates から作成された PVC に何が起こるかを指定します。 |
8.1.241. .spec.podMetadata
- 説明
PodMetadata は、Prometheus Pod に伝播されるラベルとアノテーションを設定します。
次の項目は予約されており、オーバーライドできません: * Prometheus オブジェクトの名前に設定された "prometheus" ラベル。* Prometheus オブジェクトの名前に設定された "app.kubernetes.io/instance" ラベル。* "prometheus-operator" に設定された "app.kubernetes.io/managed-by" ラベル。* "prometheus" に設定された "app.kubernetes.io/name" ラベル。* Prometheus バージョンに設定された "app.kubernetes.io/version" ラベル。* Prometheus オブジェクトの名前に設定された "operator.prometheus.io/name" ラベル。* Prometheus オブジェクトのシャード番号に設定された "operator.prometheus.io/shard" ラベル。* "prometheus" に設定された "kubectl.kubernetes.io/default-container" アノテーション。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| アノテーションは、任意のメタデータを保存し、取得するために外部ツールで設定できる、リソースとともに保存される構造化されていないキー値のマップです。これらはクエリーできないため、オブジェクトを変更する場合に維持する必要があります。詳細: http://kubernetes.io/docs/user-guide/annotations |
|
| オブジェクトの整理と分類 (スコープと選択) に使用できる文字列キーと値のマップ。レプリケーションコントローラーおよびサービスのセレクターと一致する場合があります。詳細: http://kubernetes.io/docs/user-guide/labels |
|
| name は namespace 内で一意である必要があります。リソースの作成時に必要ですが、リソースによっては、クライアントが適切な名前の生成を自動的に要求することを許可する場合があります。name は、主にべき等性と設定定義の作成を目的としています。これを更新することはできません。詳細: http://kubernetes.io/docs/user-guide/identifiers#names |
8.1.242. .spec.podMonitorNamespaceSelector
- 説明
- PodMonitors 検出に一致する namespace。空のラベルセレクターはすべての namespace に一致します。null ラベルセレクター (デフォルト値) は現在の namespace にのみ一致します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。 |
8.1.243. .spec.podMonitorNamespaceSelector.matchExpressions
- 説明
- matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
- 型
-
array
8.1.244. .spec.podMonitorNamespaceSelector.matchExpressions[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.245. .spec.podMonitorSelector
- 説明
ターゲット検出のために選択される PodMonitor。ラベルセレクターが空の場合は、全オブジェクトをマッチします。ラベルセレクターが null の場合は、どのオブジェクトもマッチしません。
spec.serviceMonitorSelector
、spec.podMonitorSelector
、spec.probeSelector
、spec.scrapeConfigSelector
が null の場合、Prometheus 設定は管理されません。Prometheus Operator は Prometheus 設定のシークレットが存在することを確認しますが、prometheus.yaml.gz
キーの下に生の gzip 圧縮された Prometheus 設定を提供するのはユーザーの責任です。この動作は 非推奨 であり、カスタムリソース定義の次のメジャーバージョンでは削除されます。代わりにspec.additionalScrapeConfigs
を使用することが推奨されます。- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。 |
8.1.246. .spec.podMonitorSelector.matchExpressions
- 説明
- matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
- 型
-
array
8.1.247. .spec.podMonitorSelector.matchExpressions[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.248. .spec.probeNamespaceSelector
- 説明
- プローブ検出に一致する namespace。空のラベルセレクターはすべての namespace に一致します。null ラベルセレクターは現在の namespace にのみ一致します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。 |
8.1.249. .spec.probeNamespaceSelector.matchExpressions
- 説明
- matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
- 型
-
array
8.1.250. .spec.probeNamespaceSelector.matchExpressions[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.251. .spec.probeSelector
- 説明
ターゲット検出のために選択されるプローブ。ラベルセレクターが空の場合は、全オブジェクトをマッチします。ラベルセレクターが null の場合は、どのオブジェクトもマッチしません。
spec.serviceMonitorSelector
、spec.podMonitorSelector
、spec.probeSelector
、spec.scrapeConfigSelector
が null の場合、Prometheus 設定は管理されません。Prometheus Operator は Prometheus 設定のシークレットが存在することを確認しますが、prometheus.yaml.gz
キーの下に生の gzip 圧縮された Prometheus 設定を提供するのはユーザーの責任です。この動作は 非推奨 であり、カスタムリソース定義の次のメジャーバージョンでは削除されます。代わりにspec.additionalScrapeConfigs
を使用することが推奨されます。- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。 |
8.1.252. .spec.probeSelector.matchExpressions
- 説明
- matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
- 型
-
array
8.1.253. .spec.probeSelector.matchExpressions[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.254. .spec.prometheusRulesExcludedFromEnforce
- 説明
-
namespace ラベルの強制が適用されない PrometheusRule オブジェクトのリストを定義します。これは、
spec.enforcedNamespaceLabel
が true に設定されている場合にのみ関連します。非推奨: 代わりにspec.excludedFromEnforcement
を使用します。 - 型
-
array
8.1.255. .spec.prometheusRulesExcludedFromEnforce[]
- 説明
- PrometheusRuleExcludeConfig を使用すると、ユーザーは、アラートとメトリックの namespace ラベルを適用するときに、除外された PrometheusRule 名とその namespace を無視するように設定できます。
- 型
-
object
- 必須
-
ruleName
-
ruleNamespace
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 除外される PrometheusRule オブジェクトの名前。 |
|
| 除外された PrometheusRule オブジェクトの namespace。 |
8.1.256. .spec.query
- 説明
- QuerySpec は、Promethus クエリーサービスの設定を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| デルタの違いにより、式の評価中にメトリックを取得できます。 |
|
| 一度に実行できる同時クエリーの数。 |
|
| 1 つのクエリーがメモリーにロードできるサンプルの最大数。これより多くのサンプルをメモリーにロードするとクエリーは失敗するため、クエリーが返すことができるサンプルの数も制限されることに注意してください。 |
|
| クエリーが中止されるまでにかかる最大時間。 |
8.1.257. .spec.remoteRead
- 説明
- リモート読み取り設定のリストを定義します。
- 型
-
array
8.1.258. .spec.remoteRead[]
- 説明
- RemoteReadSpec は、Prometheus がリモートエンドポイントからサンプルを読み戻すための設定を定義します。
- 型
-
object
- 必須
-
url
-
プロパティー | 型 | 説明 |
---|---|---|
|
| URL の認可セクション。 Prometheus v2.26.0 以降が必要です。
|
|
| URL の BasicAuth 設定。
|
|
|
警告: トークン値がクリアテキストで表示されるため、このフィールドは使用しないでください。 非推奨: 今後のリリースで削除される予定です。 |
|
| URL のベアラートークンの読み取り先となるファイル。
非推奨: 今後のリリースで削除される予定です。 |
|
| リモート読み取りエンドポイントのセレクターとして外部ラベルを使用するかどうか。 Prometheus v2.34.0 以降が必要です。 |
|
| HTTP リクエストが HTTP 3xx リダイレクトに従うかどうかを設定します。 Prometheus v2.26.0 以降が必要です。 |
|
| 各リモート読み取り要求と併せて送信されるカスタム HTTP ヘッダー。Prometheus 自体によって設定されたヘッダーは上書きできないことに注意してください。Prometheus バージョン 2.26.0 以降でのみ有効です。 |
|
| リモート読み取りキューの名前。指定する場合は一意である必要があります。この名前は、読み取り設定を区別するためにメトリックとロギングで使用されます。 Prometheus v2.15.0 以降が必要です。 |
|
|
Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。 |
|
| URL の OAuth2 設定。 Prometheus v2.27.0 以降が必要です。
|
|
| ProxyConnectHeader は、CONNECT リクエスト中にプロキシーに送信するヘッダーをオプションで指定します。 Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。 |
|
| |
|
| SecretKeySelector は、シークレットのキーを選択します。 |
|
| 環境変数 (HTTP_PROXY、HTTPS_PROXY、NO_PROXY) によって定義されたプロキシー設定を使用するかどうか。 Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。 |
|
|
|
|
| ローカルストレージに完全なデータが必要な時間範囲のクエリーに対して読み取りを行う必要があるかどうか。 |
|
| リモート読み取りエンドポイントへの要求のタイムアウト。 |
|
| リモート読み取りエンドポイントを照会するためにセレクターに存在する必要がある等式マッチャーのオプションのリスト。 |
|
| URL に使用する TLS 設定。 |
|
| クエリーの実行元となるエンドポイントの URL。 |
8.1.259. .spec.remoteRead[].authorization
- 説明
URL の認可セクション。
Prometheus v2.26.0 以降が必要です。
basicAuth
またはoauth2
と同時に設定することはできません。- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 認証の認証情報を含む、namespace 内の Secret のキーを選択します。 |
|
|
シークレットを読み取るファイル。 |
|
| 認証タイプを定義します。この値は大文字と小文字を区別しません。 "Basic" はサポートされている値ではありません。 デフォルト: "Bearer" |
8.1.260. .spec.remoteRead[].authorization.credentials
- 説明
- 認証の認証情報を含む、namespace 内の Secret のキーを選択します。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.261. .spec.remoteRead[].basicAuth
- 説明
URL の BasicAuth 設定。
authorization
またはoauth2
と同時に設定することはできません。- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
|
|
|
|
|
8.1.262. .spec.remoteRead[].basicAuth.password
- 説明
-
password
は、認証用のパスワードを含むシークレットのキーを指定します。 - 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.263. .spec.remoteRead[].basicAuth.username
- 説明
-
username
は、認証用のユーザー名を含むシークレットのキーを指定します。 - 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.264. .spec.remoteRead[].oauth2
- 説明
URL の OAuth2 設定。
Prometheus v2.27.0 以降が必要です。
authorization
またはbasicAuth
と同時に設定することはできません。- 型
-
object
- 必須
-
clientId
-
clientSecret
-
tokenUrl
-
プロパティー | 型 | 説明 |
---|---|---|
|
|
|
|
|
|
|
|
|
|
|
Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。 |
|
| ProxyConnectHeader は、CONNECT リクエスト中にプロキシーに送信するヘッダーをオプションで指定します。 Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。 |
|
| |
|
| SecretKeySelector は、シークレットのキーを選択します。 |
|
| 環境変数 (HTTP_PROXY、HTTPS_PROXY、NO_PROXY) によって定義されたプロキシー設定を使用するかどうか。 Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。 |
|
|
|
|
|
|
|
| OAuth2 サーバーに接続するときに使用する TLS 設定。Prometheus v2.43.0 以降が必要です。 |
|
|
|
8.1.265. .spec.remoteRead[].oauth2.clientId
- 説明
-
clientId
は、OAuth2 クライアントの ID を含む Secret または ConfigMap のキーを指定します。 - 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用するデータを含む ConfigMap。 |
|
| ターゲットに使用するデータを含むシークレット。 |
8.1.266. .spec.remoteRead[].oauth2.clientId.configMap
- 説明
- ターゲットに使用するデータを含む ConfigMap。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
8.1.267. .spec.remoteRead[].oauth2.clientId.secret
- 説明
- ターゲットに使用するデータを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.268. .spec.remoteRead[].oauth2.clientSecret
- 説明
-
clientSecret
は、OAuth2 クライアントのシークレットを含む Secret のキーを指定します。 - 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.269. .spec.remoteRead[].oauth2.proxyConnectHeader
- 説明
ProxyConnectHeader は、CONNECT リクエスト中にプロキシーに送信するヘッダーをオプションで指定します。
Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。
- 型
-
object
8.1.270. .spec.remoteRead[].oauth2.proxyConnectHeader{}
- 説明
- 型
-
array
8.1.271. .spec.remoteRead[].oauth2.proxyConnectHeader{}[]
- 説明
- SecretKeySelector は、シークレットのキーを選択します。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.272. .spec.remoteRead[].oauth2.tlsConfig
- 説明
- OAuth2 サーバーに接続するときに使用する TLS 設定。Prometheus v2.43.0 以降が必要です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| サーバー証明書の検証に使用される認証局。 |
|
| クライアント認証を行うときに提示するクライアント証明書。 |
|
| ターゲット証明書の検証を無効にします。 |
|
| ターゲットのクライアントキーファイルを含むシークレット。 |
|
| 許容可能な最大 TLS バージョン。 Prometheus v2.41.0 以降が必要です。 |
|
| 許容可能な最小 TLS バージョン。 Prometheus v2.35.0 以降が必要です。 |
|
| ターゲットのホスト名を確認するために使用されます。 |
8.1.273. .spec.remoteRead[].oauth2.tlsConfig.ca
- 説明
- サーバー証明書の検証に使用される認証局。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用するデータを含む ConfigMap。 |
|
| ターゲットに使用するデータを含むシークレット。 |
8.1.274. .spec.remoteRead[].oauth2.tlsConfig.ca.configMap
- 説明
- ターゲットに使用するデータを含む ConfigMap。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
8.1.275. .spec.remoteRead[].oauth2.tlsConfig.ca.secret
- 説明
- ターゲットに使用するデータを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.276. .spec.remoteRead[].oauth2.tlsConfig.cert
- 説明
- クライアント認証を行うときに提示するクライアント証明書。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用するデータを含む ConfigMap。 |
|
| ターゲットに使用するデータを含むシークレット。 |
8.1.277. .spec.remoteRead[].oauth2.tlsConfig.cert.configMap
- 説明
- ターゲットに使用するデータを含む ConfigMap。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
8.1.278. .spec.remoteRead[].oauth2.tlsConfig.cert.secret
- 説明
- ターゲットに使用するデータを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.279. .spec.remoteRead[].oauth2.tlsConfig.keySecret
- 説明
- ターゲットのクライアントキーファイルを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.280. .spec.remoteRead[].proxyConnectHeader
- 説明
ProxyConnectHeader は、CONNECT リクエスト中にプロキシーに送信するヘッダーをオプションで指定します。
Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。
- 型
-
object
8.1.281. .spec.remoteRead[].proxyConnectHeader{}
- 説明
- 型
-
array
8.1.282. .spec.remoteRead[].proxyConnectHeader{}[]
- 説明
- SecretKeySelector は、シークレットのキーを選択します。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.283. .spec.remoteRead[].tlsConfig
- 説明
- URL に使用する TLS 設定。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| サーバー証明書の検証に使用される認証局。 |
|
| ターゲットに使用する Prometheus コンテナー内の CA 証明書へのパス。 |
|
| クライアント認証を行うときに提示するクライアント証明書。 |
|
| ターゲットの Prometheus コンテナー内のクライアント証明書ファイルへのパス。 |
|
| ターゲット証明書の検証を無効にします。 |
|
| ターゲットの Prometheus コンテナー内のクライアントキーファイルへのパス。 |
|
| ターゲットのクライアントキーファイルを含むシークレット。 |
|
| 許容可能な最大 TLS バージョン。 Prometheus v2.41.0 以降が必要です。 |
|
| 許容可能な最小 TLS バージョン。 Prometheus v2.35.0 以降が必要です。 |
|
| ターゲットのホスト名を確認するために使用されます。 |
8.1.284. .spec.remoteRead[].tlsConfig.ca
- 説明
- サーバー証明書の検証に使用される認証局。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用するデータを含む ConfigMap。 |
|
| ターゲットに使用するデータを含むシークレット。 |
8.1.285. .spec.remoteRead[].tlsConfig.ca.configMap
- 説明
- ターゲットに使用するデータを含む ConfigMap。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
8.1.286. .spec.remoteRead[].tlsConfig.ca.secret
- 説明
- ターゲットに使用するデータを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.287. .spec.remoteRead[].tlsConfig.cert
- 説明
- クライアント認証を行うときに提示するクライアント証明書。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用するデータを含む ConfigMap。 |
|
| ターゲットに使用するデータを含むシークレット。 |
8.1.288. .spec.remoteRead[].tlsConfig.cert.configMap
- 説明
- ターゲットに使用するデータを含む ConfigMap。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
8.1.289. .spec.remoteRead[].tlsConfig.cert.secret
- 説明
- ターゲットに使用するデータを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.290. .spec.remoteRead[].tlsConfig.keySecret
- 説明
- ターゲットのクライアントキーファイルを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.291. .spec.remoteWrite
- 説明
- リモート書き込み設定のリストを定義します。
- 型
-
array
8.1.292. .spec.remoteWrite[]
- 説明
- RemoteWriteSpec は、Prometheus からリモートエンドポイントにサンプルを書き込むための設定を定義します。
- 型
-
object
- 必須
-
url
-
プロパティー | 型 | 説明 |
---|---|---|
|
| URL の認可セクション。 Prometheus v2.26.0 以降が必要です。
|
|
| URL の AzureAD。 Prometheus 2.45.0 以降が必要です。
|
|
| URL の BasicAuth 設定。
|
|
|
警告: トークン値がクリアテキストで表示されるため、このフィールドは使用しないでください。 非推奨: 今後のリリースで削除される予定です。 |
|
| URL のベアラートークンを読み取るファイル。
非推奨: 今後のリリースで削除される予定です。 |
|
| HTTP2 を有効にするかどうか。 |
|
| HTTP リクエストが HTTP 3xx リダイレクトに従うかどうかを設定します。 Prometheus v2.26.0 以降が必要です。 |
|
| 各リモート書き込み要求とともに送信されるカスタム HTTP ヘッダー。Prometheus 自体によって設定されたヘッダーは上書きできないことに注意してください。 Prometheus v2.25.0 以降が必要です。 |
|
| エンドポイントに書き込むときに使用するリモート書き込みメッセージのバージョン。
このフィールドを設定する前に、サポートされるメッセージバージョンについて、リモートストレージプロバイダーに問い合わせてください。 Prometheus v2.54.0 以降が必要です。 |
|
| metadataConfig は、リモートストレージへのシリーズメタデータの送信を設定します。 |
|
| リモート書き込みキューの名前。指定する場合は一意である必要があります。この名前は、キューを区別するためにメトリックとロギングで使用されます。 Prometheus v2.15.0 以降が必要です。 |
|
|
Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。 |
|
| URL の OAuth2 設定。 Prometheus v2.27.0 以降が必要です。
|
|
| ProxyConnectHeader は、CONNECT リクエスト中にプロキシーに送信するヘッダーをオプションで指定します。 Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。 |
|
| |
|
| SecretKeySelector は、シークレットのキーを選択します。 |
|
| 環境変数 (HTTP_PROXY、HTTPS_PROXY、NO_PROXY) によって定義されたプロキシー設定を使用するかどうか。 Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。 |
|
|
|
|
| QueueConfig を使用すると、リモート書き込みキューパラメーターを調整できます。 |
|
| リモート書き込みエンドポイントへの要求のタイムアウト。 |
|
|
リモート書き込みによるエグザンプラーの送信を有効にします。エグザンプラーをスクレイピングするには、 Prometheus v2.27.0 以降が必要です。 |
|
| リモート書き込みによるネイティブヒストグラム (スパースヒストグラムとも呼ばれる) の送信を有効にします。 Prometheus v2.40.0 以降が必要です。 |
|
| sigv4 を使用して、URL に対して AWS の Signature Verification 4 を設定できます。 Prometheus v2.26.0 以降が必要です。
|
|
| URL に使用する TLS 設定。 |
|
| サンプルの送信先のエンドポイントの URL。 |
|
| リモート書き込み再ラベル付け設定のリスト。 |
|
| RelabelConfig を使用すると、ターゲット、アラート、スクレイピングされたサンプル、リモート書き込みサンプルのラベルセットを動的に書き換えることができます。 詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config |
8.1.293. .spec.remoteWrite[].authorization
- 説明
URL の認可セクション。
Prometheus v2.26.0 以降が必要です。
sigv4
、basicAuth
、oauth2
、azureAd
と同時に設定することはできません。- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 認証の認証情報を含む、namespace 内の Secret のキーを選択します。 |
|
|
シークレットを読み取るファイル。 |
|
| 認証タイプを定義します。この値は大文字と小文字を区別しません。 "Basic" はサポートされている値ではありません。 デフォルト: "Bearer" |
8.1.294. .spec.remoteWrite[].authorization.credentials
- 説明
- 認証の認証情報を含む、namespace 内の Secret のキーを選択します。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.295. .spec.remoteWrite[].azureAd
- 説明
URL の AzureAD。
Prometheus 2.45.0 以降が必要です。
authorization
、basicAuth
、oauth2
、sigv4
と同時に設定することはできません。- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Azure クラウド。オプションは、'AzurePublic'、'AzureChina'、'AzureGovernment' です。 |
|
|
managedIdentity は、Azure ユーザーが割り当てたマネージド ID を定義します。 |
|
|
oauth は、認証に使用される oauth 設定を定義します。 Prometheus v2.48.0 以降が必要です。 |
|
|
SDK は、認証に使用される Azure SDK 設定を定義します。https://learn.microsoft.com/en-us/azure/developer/go/azure-sdk-authentication を参照してください。 Prometheus 2.52.0 以降が必要です。 |
8.1.296. .spec.remoteWrite[].azureAd.managedIdentity
- 説明
-
managedIdentity は、Azure ユーザーが割り当てたマネージド ID を定義します。
oauth
またはsdk
と同時に設定することはできません。 - 型
-
object
- 必須
-
clientId
-
プロパティー | 型 | 説明 |
---|---|---|
|
| クライアント ID |
8.1.297. .spec.remoteWrite[].azureAd.oauth
- 説明
oauth は、認証に使用される oauth 設定を定義します。
managedIdentity
またはsdk
と同時に設定することはできません。Prometheus v2.48.0 以降が必要です。
- 型
-
object
- 必須
-
clientId
-
clientSecret
-
tenantId
-
プロパティー | 型 | 説明 |
---|---|---|
|
|
|
|
|
|
|
|
|
8.1.298. .spec.remoteWrite[].azureAd.oauth.clientSecret
- 説明
-
clientSecret
は、認証に使用される Azure Active Directory アプリケーションのクライアントシークレットを含む Secret のキーを指定します。 - 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.299. .spec.remoteWrite[].azureAd.sdk
- 説明
SDK は、認証に使用される Azure SDK 設定を定義します。https://learn.microsoft.com/en-us/azure/developer/go/azure-sdk-authentication を参照してください。
oauth
またはmanagedIdentity
と同時に設定することはできません。Prometheus 2.52.0 以降が必要です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
|
|
8.1.300. .spec.remoteWrite[].basicAuth
- 説明
URL の BasicAuth 設定。
sigv4
、authorization
、oauth2
、azureAd
と同時に設定することはできません。- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
|
|
|
|
|
8.1.301. .spec.remoteWrite[].basicAuth.password
- 説明
-
password
は、認証用のパスワードを含むシークレットのキーを指定します。 - 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.302. .spec.remoteWrite[].basicAuth.username
- 説明
-
username
は、認証用のユーザー名を含むシークレットのキーを指定します。 - 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.303. .spec.remoteWrite[].metadataConfig
- 説明
- metadataConfig は、リモートストレージへのシリーズメタデータの送信を設定します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| メトリクスメタデータをリモートストレージに送信するかどうかを定義します。 |
|
| メトリクスメタデータをリモートストレージに送信する頻度を定義します。 |
8.1.304. .spec.remoteWrite[].oauth2
- 説明
URL の OAuth2 設定。
Prometheus v2.27.0 以降が必要です。
sigv4
、authorization
、basicAuth
、azureAd
と同時に設定することはできません。- 型
-
object
- 必須
-
clientId
-
clientSecret
-
tokenUrl
-
プロパティー | 型 | 説明 |
---|---|---|
|
|
|
|
|
|
|
|
|
|
|
Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。 |
|
| ProxyConnectHeader は、CONNECT リクエスト中にプロキシーに送信するヘッダーをオプションで指定します。 Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。 |
|
| |
|
| SecretKeySelector は、シークレットのキーを選択します。 |
|
| 環境変数 (HTTP_PROXY、HTTPS_PROXY、NO_PROXY) によって定義されたプロキシー設定を使用するかどうか。 Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。 |
|
|
|
|
|
|
|
| OAuth2 サーバーに接続するときに使用する TLS 設定。Prometheus v2.43.0 以降が必要です。 |
|
|
|
8.1.305. .spec.remoteWrite[].oauth2.clientId
- 説明
-
clientId
は、OAuth2 クライアントの ID を含む Secret または ConfigMap のキーを指定します。 - 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用するデータを含む ConfigMap。 |
|
| ターゲットに使用するデータを含むシークレット。 |
8.1.306. .spec.remoteWrite[].oauth2.clientId.configMap
- 説明
- ターゲットに使用するデータを含む ConfigMap。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
8.1.307. .spec.remoteWrite[].oauth2.clientId.secret
- 説明
- ターゲットに使用するデータを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.308. .spec.remoteWrite[].oauth2.clientSecret
- 説明
-
clientSecret
は、OAuth2 クライアントのシークレットを含む Secret のキーを指定します。 - 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.309. .spec.remoteWrite[].oauth2.proxyConnectHeader
- 説明
ProxyConnectHeader は、CONNECT リクエスト中にプロキシーに送信するヘッダーをオプションで指定します。
Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。
- 型
-
object
8.1.310. .spec.remoteWrite[].oauth2.proxyConnectHeader{}
- 説明
- 型
-
array
8.1.311. .spec.remoteWrite[].oauth2.proxyConnectHeader{}[]
- 説明
- SecretKeySelector は、シークレットのキーを選択します。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.312. .spec.remoteWrite[].oauth2.tlsConfig
- 説明
- OAuth2 サーバーに接続するときに使用する TLS 設定。Prometheus v2.43.0 以降が必要です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| サーバー証明書の検証に使用される認証局。 |
|
| クライアント認証を行うときに提示するクライアント証明書。 |
|
| ターゲット証明書の検証を無効にします。 |
|
| ターゲットのクライアントキーファイルを含むシークレット。 |
|
| 許容可能な最大 TLS バージョン。 Prometheus v2.41.0 以降が必要です。 |
|
| 許容可能な最小 TLS バージョン。 Prometheus v2.35.0 以降が必要です。 |
|
| ターゲットのホスト名を確認するために使用されます。 |
8.1.313. .spec.remoteWrite[].oauth2.tlsConfig.ca
- 説明
- サーバー証明書の検証に使用される認証局。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用するデータを含む ConfigMap。 |
|
| ターゲットに使用するデータを含むシークレット。 |
8.1.314. .spec.remoteWrite[].oauth2.tlsConfig.ca.configMap
- 説明
- ターゲットに使用するデータを含む ConfigMap。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
8.1.315. .spec.remoteWrite[].oauth2.tlsConfig.ca.secret
- 説明
- ターゲットに使用するデータを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.316. .spec.remoteWrite[].oauth2.tlsConfig.cert
- 説明
- クライアント認証を行うときに提示するクライアント証明書。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用するデータを含む ConfigMap。 |
|
| ターゲットに使用するデータを含むシークレット。 |
8.1.317. .spec.remoteWrite[].oauth2.tlsConfig.cert.configMap
- 説明
- ターゲットに使用するデータを含む ConfigMap。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
8.1.318. .spec.remoteWrite[].oauth2.tlsConfig.cert.secret
- 説明
- ターゲットに使用するデータを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.319. .spec.remoteWrite[].oauth2.tlsConfig.keySecret
- 説明
- ターゲットのクライアントキーファイルを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.320. .spec.remoteWrite[].proxyConnectHeader
- 説明
ProxyConnectHeader は、CONNECT リクエスト中にプロキシーに送信するヘッダーをオプションで指定します。
Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。
- 型
-
object
8.1.321. .spec.remoteWrite[].proxyConnectHeader{}
- 説明
- 型
-
array
8.1.322. .spec.remoteWrite[].proxyConnectHeader{}[]
- 説明
- SecretKeySelector は、シークレットのキーを選択します。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.323. .spec.remoteWrite[].queueConfig
- 説明
- QueueConfig を使用すると、リモート書き込みキューパラメーターを調整できます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| BatchSendDeadline は、サンプルがバッファーで待機する最大時間です。 |
|
| 容量は、ドロップを開始する前にシャードごとにバッファリングするサンプルの数です。 |
|
| MaxBackoff は、最大再試行遅延です。 |
|
| MaxRetries は、回復可能なエラーでバッチを再試行する最大回数です。 |
|
| MaxSamplesPerSend は、送信ごとのサンプルの最大数です。 |
|
| MaxShards は、シャードの最大数、つまり同時実行の量です。 |
|
| MinBackoff は、最初の再試行遅延です。再試行するたびに 2 倍になります。 |
|
| MinShards は、シャードの最小数、つまり同時実行の量です。 |
|
| remote-write ストレージから 429 ステータスコードを受信すると再試行します。 これは 実験的な機能 であり、今後のリリースで重大な変更が加えられる可能性があります。 |
|
| SampleAgeLimit は制限より古いサンプルを削除します。Prometheus v2.50.0 以降が必要です。 |
8.1.324. .spec.remoteWrite[].sigv4
- 説明
sigv4 を使用して、URL に対して AWS の Signature Verification 4 を設定できます。
Prometheus v2.26.0 以降が必要です。
authorization
、basicAuth
、oauth2
、azureAd
と同時に設定することはできません。- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
|
AccessKey は AWS API キーです。指定されていない場合は、環境変数 |
|
| profile は、認証に使用される名前付き AWS プロファイルです。 |
|
| region は AWS リージョンです。空白の場合は、デフォルトの認証情報チェーンのリージョンが使用されます。 |
|
| roleArn は、認証に使用される名前付き AWS プロファイルです。 |
|
|
secretKey は AWS API シークレットです。指定されていない場合は、環境変数 |
8.1.325. .spec.remoteWrite[].sigv4.accessKey
- 説明
-
AccessKey は AWS API キーです。指定されていない場合は、環境変数
AWS_ACCESS_KEY_ID
が使用されます。 - 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.326. .spec.remoteWrite[].sigv4.secretKey
- 説明
-
secretKey は AWS API シークレットです。指定されていない場合は、環境変数
AWS_SECRET_ACCESS_KEY
が使用されます。 - 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.327. .spec.remoteWrite[].tlsConfig
- 説明
- URL に使用する TLS 設定。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| サーバー証明書の検証に使用される認証局。 |
|
| ターゲットに使用する Prometheus コンテナー内の CA 証明書へのパス。 |
|
| クライアント認証を行うときに提示するクライアント証明書。 |
|
| ターゲットの Prometheus コンテナー内のクライアント証明書ファイルへのパス。 |
|
| ターゲット証明書の検証を無効にします。 |
|
| ターゲットの Prometheus コンテナー内のクライアントキーファイルへのパス。 |
|
| ターゲットのクライアントキーファイルを含むシークレット。 |
|
| 許容可能な最大 TLS バージョン。 Prometheus v2.41.0 以降が必要です。 |
|
| 許容可能な最小 TLS バージョン。 Prometheus v2.35.0 以降が必要です。 |
|
| ターゲットのホスト名を確認するために使用されます。 |
8.1.328. .spec.remoteWrite[].tlsConfig.ca
- 説明
- サーバー証明書の検証に使用される認証局。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用するデータを含む ConfigMap。 |
|
| ターゲットに使用するデータを含むシークレット。 |
8.1.329. .spec.remoteWrite[].tlsConfig.ca.configMap
- 説明
- ターゲットに使用するデータを含む ConfigMap。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
8.1.330. .spec.remoteWrite[].tlsConfig.ca.secret
- 説明
- ターゲットに使用するデータを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.331. .spec.remoteWrite[].tlsConfig.cert
- 説明
- クライアント認証を行うときに提示するクライアント証明書。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用するデータを含む ConfigMap。 |
|
| ターゲットに使用するデータを含むシークレット。 |
8.1.332. .spec.remoteWrite[].tlsConfig.cert.configMap
- 説明
- ターゲットに使用するデータを含む ConfigMap。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
8.1.333. .spec.remoteWrite[].tlsConfig.cert.secret
- 説明
- ターゲットに使用するデータを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.334. .spec.remoteWrite[].tlsConfig.keySecret
- 説明
- ターゲットのクライアントキーファイルを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.335. .spec.remoteWrite[].writeRelabelConfigs
- 説明
- リモート書き込み再ラベル付け設定のリスト。
- 型
-
array
8.1.336. .spec.remoteWrite[].writeRelabelConfigs[]
- 説明
RelabelConfig を使用すると、ターゲット、アラート、スクレイピングされたサンプル、リモート書き込みサンプルのラベルセットを動的に書き換えることができます。
詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 正規表現の一致に基づいて実行するアクション。
デフォルト: "Replace" |
|
| ソースラベル値のハッシュを取得するためのモジュラス。
アクションが |
|
| 抽出された値が一致する正規表現。 |
|
| 正規表現が一致する場合に置き換えアクションが実施される置換値。 正規表現キャプチャグループが利用可能です。 |
|
| separator は連結された SourceLabel 間の文字列です。 |
|
| ソースラベルは、既存のラベルから値を選択します。それらのコンテンツは、設定されたセパレータを使用して連結され、設定された正規表現と照合されます。 |
|
| 結果の文字列が置換で書き込まれるラベル。
正規表現キャプチャグループが利用可能です。 |
8.1.337. .spec.resources
- 説明
- 'prometheus' コンテナーのリソースリクエストと制限を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。 これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。 このフィールドは不変です。これはコンテナーにのみ設定できます。 |
|
| ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。 |
|
| limits は、許可されるコンピュートリソースの最大量を示します。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
|
| requests は、必要なコンピュートリソースの最小量を示します。コンテナーで Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
8.1.338. .spec.resources.claims
- 説明
Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。
これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。
このフィールドは不変です。これはコンテナーにのみ設定できます。
- 型
-
array
8.1.339. .spec.resources.claims[]
- 説明
- ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。 |
|
| request は、参照されるクレーム内のリクエストに対して選択された名前です。空の場合、クレームからのすべてのものが利用可能になり、それ以外の場合はこの request の結果のみが利用可能になります。 |
8.1.340. .spec.ruleNamespaceSelector
- 説明
- PrometheusRule 検出に一致する namespace。空のラベルセレクターはすべての namespace に一致します。null ラベルセレクターは現在の namespace にのみ一致します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。 |
8.1.341. .spec.ruleNamespaceSelector.matchExpressions
- 説明
- matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
- 型
-
array
8.1.342. .spec.ruleNamespaceSelector.matchExpressions[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.343. .spec.ruleSelector
- 説明
- ルール評価のために選択される PrometheusRule オブジェクト。ラベルセレクターが空の場合は、全オブジェクトをマッチします。ラベルセレクターが null の場合は、どのオブジェクトもマッチしません。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。 |
8.1.344. .spec.ruleSelector.matchExpressions
- 説明
- matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
- 型
-
array
8.1.345. .spec.ruleSelector.matchExpressions[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.346. .spec.rules
- 説明
- Prometheus ルールのエンジンの設定を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Prometheus ルールのエンジンのパラメーターを定義します。 これらのパラメーターを更新すると、Pod の再起動がトリガーされます。 |
8.1.347. .spec.rules.alert
- 説明
Prometheus ルールのエンジンのパラメーターを定義します。
これらのパラメーターを更新すると、Pod の再起動がトリガーされます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| アラートと復元された 'for' 状態の間の最小期間。 これは、設定された 'for' の期間がグレース期間よりも長く設定されているアラートに対してのみ維持されます。 |
|
| アラートの 'for' の状態を復元するために prometheus の停止を許容する最大時間。 |
|
| Alertmanager にアラートを再送信する前に待機する最小時間。 |
8.1.348. .spec.runtime
- 説明
- RuntimeConfig は Prometheus プロセスの動作の値を設定します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Go ガベージコレクションのターゲットパーセンテージ。この数値を下げると、CPU 使用率が増加する可能性があります。参照: https://tip.golang.org/doc/gc-guide#GOGC |
8.1.349. .spec.scrapeClasses
- 説明
PodMonitors、ServiceMonitors、Probes、ScrapeConfigs などのスクレイピングオブジェクトに公開するスクレイプクラスのリスト。
これは 実験的な機能 であり、今後のリリースで重大な変更が加えられる可能性があります。
- 型
-
array
8.1.350. .spec.scrapeClasses[]
- 説明
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| AttachMetadata は、検出されたターゲットへの追加のメタデータを設定します。スクレイプオブジェクトが独自の設定を定義する場合、その設定はスクレイプクラスの設定よりも優先されます。 |
|
| default は、明示的なスクレイプクラス名が設定されていないすべてのスクレイプオブジェクトにスクレイプが適用されることを示しています。 デフォルトとして設定できるスクレイプクラスは 1 つだけです。 |
|
| metricRelabelings は、取り込み前にすべてのサンプルに適用するラベル再設定ルールを設定します。 Operator は、ここで定義されたスクレイプクラスメトリクスのラベル再設定を追加します。次に、ServiceMonitor、PodMonitor、Probes、および ScrapeConfigs で定義されたターゲット固有のメトリクスのラベル再設定を追加します。その後 Operator は、'.spec.enforcedNamespaceLabel' で指定されている namespace 強制ラベル再設定ルールを追加します。 詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#metric_relabel_configs |
|
| RelabelConfig を使用すると、ターゲット、アラート、スクレイピングされたサンプル、リモート書き込みサンプルのラベルセットを動的に書き換えることができます。 詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config |
|
| スクレイプクラスの名前。 |
|
| ラベルの再設定は、すべてのスクレイプターゲットに適用するラベル再設定ルールを設定します。
Operator は、 詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config |
|
| RelabelConfig を使用すると、ターゲット、アラート、スクレイピングされたサンプル、リモート書き込みサンプルのラベルセットを動的に書き換えることができます。 詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config |
|
| TLSConfig は、スクレイプに使用する TLS 設定を定義します。スクレイプオブジェクトが独自の CA、証明書、キーを定義する場合、それらは対応するスクレイプクラスフィールドよりも優先されます。
現時点では、 |
8.1.351. .spec.scrapeClasses[].attachMetadata
- 説明
- AttachMetadata は、検出されたターゲットへの追加のメタデータを設定します。スクレイプオブジェクトが独自の設定を定義する場合、その設定はスクレイプクラスの設定よりも優先されます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| true に設定すると、Prometheus が検出されたターゲットにノードメタデータをアタッチします。
Prometheus サービスアカウントに、 |
8.1.352. .spec.scrapeClasses[].metricRelabelings
- 説明
metricRelabelings は、取り込み前にすべてのサンプルに適用するラベル再設定ルールを設定します。
Operator は、ここで定義されたスクレイプクラスメトリクスのラベル再設定を追加します。次に、ServiceMonitor、PodMonitor、Probes、および ScrapeConfigs で定義されたターゲット固有のメトリクスのラベル再設定を追加します。その後 Operator は、'.spec.enforcedNamespaceLabel' で指定されている namespace 強制ラベル再設定ルールを追加します。
詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#metric_relabel_configs
- 型
-
array
8.1.353. .spec.scrapeClasses[].metricRelabelings[]
- 説明
RelabelConfig を使用すると、ターゲット、アラート、スクレイピングされたサンプル、リモート書き込みサンプルのラベルセットを動的に書き換えることができます。
詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 正規表現の一致に基づいて実行するアクション。
デフォルト: "Replace" |
|
| ソースラベル値のハッシュを取得するためのモジュラス。
アクションが |
|
| 抽出された値が一致する正規表現。 |
|
| 正規表現が一致する場合に置き換えアクションが実施される置換値。 正規表現キャプチャグループが利用可能です。 |
|
| separator は連結された SourceLabel 間の文字列です。 |
|
| ソースラベルは、既存のラベルから値を選択します。それらのコンテンツは、設定されたセパレータを使用して連結され、設定された正規表現と照合されます。 |
|
| 結果の文字列が置換で書き込まれるラベル。
正規表現キャプチャグループが利用可能です。 |
8.1.354. .spec.scrapeClasses[].relabelings
- 説明
ラベルの再設定は、すべてのスクレイプターゲットに適用するラベル再設定ルールを設定します。
Operator は、
__meta_kubernetes_namespace
や\__meta_kubernetes_service_name
などのいくつかの標準 Kubernetes フィールドのラベル再設定を自動的に追加します。次に、ここで定義されたスクレイプクラスのラベル再設定を追加します。その後 Operator は、スクレイプオブジェクトで定義されたターゲット固有のラベル再設定を追加します。詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
- 型
-
array
8.1.355. .spec.scrapeClasses[].relabelings[]
- 説明
RelabelConfig を使用すると、ターゲット、アラート、スクレイピングされたサンプル、リモート書き込みサンプルのラベルセットを動的に書き換えることができます。
詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 正規表現の一致に基づいて実行するアクション。
デフォルト: "Replace" |
|
| ソースラベル値のハッシュを取得するためのモジュラス。
アクションが |
|
| 抽出された値が一致する正規表現。 |
|
| 正規表現が一致する場合に置き換えアクションが実施される置換値。 正規表現キャプチャグループが利用可能です。 |
|
| separator は連結された SourceLabel 間の文字列です。 |
|
| ソースラベルは、既存のラベルから値を選択します。それらのコンテンツは、設定されたセパレータを使用して連結され、設定された正規表現と照合されます。 |
|
| 結果の文字列が置換で書き込まれるラベル。
正規表現キャプチャグループが利用可能です。 |
8.1.356. .spec.scrapeClasses[].tlsConfig
- 説明
TLSConfig は、スクレイプに使用する TLS 設定を定義します。スクレイプオブジェクトが独自の CA、証明書、キーを定義する場合、それらは対応するスクレイプクラスフィールドよりも優先されます。
現時点では、
caFile
、certFile
、keyFile
フィールドのみがサポートされています。- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| サーバー証明書の検証に使用される認証局。 |
|
| ターゲットに使用する Prometheus コンテナー内の CA 証明書へのパス。 |
|
| クライアント認証を行うときに提示するクライアント証明書。 |
|
| ターゲットの Prometheus コンテナー内のクライアント証明書ファイルへのパス。 |
|
| ターゲット証明書の検証を無効にします。 |
|
| ターゲットの Prometheus コンテナー内のクライアントキーファイルへのパス。 |
|
| ターゲットのクライアントキーファイルを含むシークレット。 |
|
| 許容可能な最大 TLS バージョン。 Prometheus v2.41.0 以降が必要です。 |
|
| 許容可能な最小 TLS バージョン。 Prometheus v2.35.0 以降が必要です。 |
|
| ターゲットのホスト名を確認するために使用されます。 |
8.1.357. .spec.scrapeClasses[].tlsConfig.ca
- 説明
- サーバー証明書の検証に使用される認証局。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用するデータを含む ConfigMap。 |
|
| ターゲットに使用するデータを含むシークレット。 |
8.1.358. .spec.scrapeClasses[].tlsConfig.ca.configMap
- 説明
- ターゲットに使用するデータを含む ConfigMap。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
8.1.359. .spec.scrapeClasses[].tlsConfig.ca.secret
- 説明
- ターゲットに使用するデータを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.360. .spec.scrapeClasses[].tlsConfig.cert
- 説明
- クライアント認証を行うときに提示するクライアント証明書。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用するデータを含む ConfigMap。 |
|
| ターゲットに使用するデータを含むシークレット。 |
8.1.361. .spec.scrapeClasses[].tlsConfig.cert.configMap
- 説明
- ターゲットに使用するデータを含む ConfigMap。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
8.1.362. .spec.scrapeClasses[].tlsConfig.cert.secret
- 説明
- ターゲットに使用するデータを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.363. .spec.scrapeClasses[].tlsConfig.keySecret
- 説明
- ターゲットのクライアントキーファイルを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.364. .spec.scrapeConfigNamespaceSelector
- 説明
ScrapeConfig 検出に一致する namespace。空のラベルセレクターはすべての namespace に一致します。null ラベルセレクターは現在の namespace にのみ一致します。
現在、ScrapeConfig カスタムリソース定義はアルファレベルであることに注意してください。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。 |
8.1.365. .spec.scrapeConfigNamespaceSelector.matchExpressions
- 説明
- matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
- 型
-
array
8.1.366. .spec.scrapeConfigNamespaceSelector.matchExpressions[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.367. .spec.scrapeConfigSelector
- 説明
ターゲット検出のために選択される ScrapeConfigs。ラベルセレクターが空の場合は、全オブジェクトをマッチします。ラベルセレクターが null の場合は、どのオブジェクトもマッチしません。
spec.serviceMonitorSelector
、spec.podMonitorSelector
、spec.probeSelector
、spec.scrapeConfigSelector
が null の場合、Prometheus 設定は管理されません。Prometheus Operator は Prometheus 設定のシークレットが存在することを確認しますが、prometheus.yaml.gz
キーの下に生の gzip 圧縮された Prometheus 設定を提供するのはユーザーの責任です。この動作は 非推奨 であり、カスタムリソース定義の次のメジャーバージョンでは削除されます。代わりにspec.additionalScrapeConfigs
を使用することが推奨されます。現在、ScrapeConfig カスタムリソース定義はアルファレベルであることに注意してください。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。 |
8.1.368. .spec.scrapeConfigSelector.matchExpressions
- 説明
- matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
- 型
-
array
8.1.369. .spec.scrapeConfigSelector.matchExpressions[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.370. .spec.securityContext
- 説明
- SecurityContext は、Pod レベルのセキュリティー属性と一般的なコンテナー設定を保持します。これはデフォルトでデフォルトの PodSecurityContext になります。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| appArmorProfile は、この Pod 内のコンテナーで使用する AppArmor オプションです。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| 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 の場合、このフィールドは設定できないことに注意してください。 |
|
| すべてのコンテナーに適用される SELinux コンテキスト。指定しない場合、コンテナーランタイムはコンテナーごとにランダムな SELinux コンテキストを割り当てます。SecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値がそのコンテナーに優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| この Pod のコンテナーで使用する seccomp オプション。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| コンテナーのプライマリー GID および fsGroup (指定されている場合) に加えて、各コンテナーで実行される最初のプロセスに適用されるグループのリスト。SupplementalGroupsPolicy 機能が有効になっている場合、supplementalGroupsPolicy フィールドは、コンテナーイメージで定義されるグループメンバーシップに加えて、またはその代わりに、それらを追加するかどうかを決定します。これを指定しないと、追加のグループは追加されませんが、supplementalGroupsPolicy フィールドに応じて、コンテナーイメージで定義されたグループメンバーシップは引き続き使用される場合があります。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| 最初のコンテナープロセスの補助グループを計算する方法を定義します。有効な値は "Merge" と "Strict" です。指定しない場合は、"Merge" が使用されます。(Alpha) このフィールドを使用するには、SupplementalGroupsPolicy 機能ゲートを有効にする必要があり、コンテナーランタイムはこの機能のサポートを実装する必要があります。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| Sysctl は、Pod に使用される namespace 付き sysctl のリストを保持します。(コンテナーランタイムによる) サポートされていない sysctl を持つ Pod は起動に失敗する可能性があります。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。 |
|
| Sysctl は、設定するカーネルパラメーターを定義します |
|
| すべてのコンテナーに適用される Windows 固有の設定。指定しない場合、コンテナーの SecurityContext 内のオプションが使用されます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が linux の場合は、このフィールドを設定できないことに注意してください。 |
8.1.371. .spec.securityContext.appArmorProfile
- 説明
- appArmorProfile は、この Pod 内のコンテナーで使用する AppArmor オプションです。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| localhostProfile は、使用する必要があるノードにロードされたプロファイルを示します。プロファイルが機能するには、ノードで事前に設定されている必要があります。プロファイルのロードされた名前と一致する必要があります。タイプが "Localhost" の場合にのみ設定する必要があります。 |
|
| type は、適用される AppArmor プロファイルの種類を示します。有効なオプション: Localhost - ノードに事前にロードされたプロファイル。RuntimeDefault - コンテナーランタイムのデフォルトのプロファイル。制限なし - AppArmor の強制はありません。 |
8.1.372. .spec.securityContext.seLinuxOptions
- 説明
- すべてのコンテナーに適用される SELinux コンテキスト。指定しない場合、コンテナーランタイムはコンテナーごとにランダムな SELinux コンテキストを割り当てます。SecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値がそのコンテナーに優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Level は、コンテナーに適用される SELinux レベルのラベルです。 |
|
| Role は、コンテナーに適用される SELinux ロールラベルです。 |
|
| Type は、コンテナーに適用される SELinux タイプのラベルです。 |
|
| User は、コンテナーに適用される SELinux ユーザーラベルです。 |
8.1.373. .spec.securityContext.seccompProfile
- 説明
- この Pod のコンテナーで使用する seccomp オプション。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
- 型
-
object
- 必須
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| localhostProfile は、ノード上のファイルで定義されたプロファイルを使用する必要があることを示します。プロファイルが機能するには、ノードで事前に設定されている必要があります。kubelet の設定済みの seccomp プロファイルの場所を基準にして、降順のパスである必要があります。タイプが "Localhost" の場合は設定する必要があります。他のタイプには設定しないでください。 |
|
| type は、適用される seccomp プロファイルの種類を示します。有効なオプションは以下のとおりです。 Localhost - ノード上のファイルで定義されたプロファイルを使用する必要があります。RuntimeDefault- コンテナーのランタイムデフォルトプロファイルを使用する必要があります。制限なし - プロファイルを適用しないでください。 |
8.1.374. .spec.securityContext.sysctls
- 説明
- Sysctl は、Pod に使用される namespace 付き sysctl のリストを保持します。(コンテナーランタイムによる) サポートされていない sysctl を持つ Pod は起動に失敗する可能性があります。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
- 型
-
array
8.1.375. .spec.securityContext.sysctls[]
- 説明
- Sysctl は、設定するカーネルパラメーターを定義します
- 型
-
object
- 必須
-
name
-
value
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 設定するプロパティーの名前 |
|
| 設定するプロパティーの値 |
8.1.376. .spec.securityContext.windowsOptions
- 説明
- すべてのコンテナーに適用される Windows 固有の設定。指定しない場合、コンテナーの SecurityContext 内のオプションが使用されます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が linux の場合は、このフィールドを設定できないことに注意してください。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| GMSACredentialSpec は、GMSA アドミッション Webhook (https://github.com/kubernetes-sigs/windows-gmsa) が GMSACredentialSpecName フィールドで指定された GMSA クレデンシャル仕様のコンテンツをインライン化する場所です。 |
|
| GMSACredentialSpecName は、使用する GMSA 認証情報仕様の名前です。 |
|
| hostProcess は、コンテナーを 'Host Process' コンテナーとして実行する必要があるかどうかを決定します。Pod のすべてのコンテナーは、同じ有効な HostProcess 値を持っている必要があります (HostProcess コンテナーと非 HostProcess コンテナーを混在させることはできません)。さらに、HostProcess が true の場合、HostNetwork も true に設定する必要があります。 |
|
| コンテナープロセスのエントリーポイントを実行するための Windows の UserName。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。 |
8.1.377. .spec.serviceMonitorNamespaceSelector
- 説明
- ServicedMonitors 検出に一致する namespace。空のラベルセレクターはすべての namespace に一致します。null ラベルセレクター (デフォルト値) は現在の namespace にのみ一致します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。 |
8.1.378. .spec.serviceMonitorNamespaceSelector.matchExpressions
- 説明
- matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
- 型
-
array
8.1.379. .spec.serviceMonitorNamespaceSelector.matchExpressions[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.380. .spec.serviceMonitorSelector
- 説明
ターゲット検出用に選択される ServiceMonitor。ラベルセレクターが空の場合は、全オブジェクトをマッチします。ラベルセレクターが null の場合は、どのオブジェクトもマッチしません。
spec.serviceMonitorSelector
、spec.podMonitorSelector
、spec.probeSelector
、spec.scrapeConfigSelector
が null の場合、Prometheus 設定は管理されません。Prometheus Operator は Prometheus 設定のシークレットが存在することを確認しますが、prometheus.yaml.gz
キーの下に生の gzip 圧縮された Prometheus 設定を提供するのはユーザーの責任です。この動作は 非推奨 であり、カスタムリソース定義の次のメジャーバージョンでは削除されます。代わりにspec.additionalScrapeConfigs
を使用することが推奨されます。- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。 |
8.1.381. .spec.serviceMonitorSelector.matchExpressions
- 説明
- matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
- 型
-
array
8.1.382. .spec.serviceMonitorSelector.matchExpressions[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.383. .spec.storage
- 説明
- storage は、Prometheus が使用するストレージを定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 非推奨: 今後のリリースで subPath の使用は削除されます。 |
|
|
StatefulSet が使用する EmptyDirVolumeSource。指定した場合、 |
|
| StatefulSet が使用する EphemeralVolumeSource。これは、k8s 1.21 ではベータフィールド、1.15 では GA です。k8s 1.19 以前のバージョンでは、GenericEphemeralVolume フィーチャーゲートを有効にする必要があります。詳細: https://kubernetes.io/docs/concepts/storage/ephemeral-volumes/#generic-ephemeral-volumes |
|
| Prometheus StatefulSets が使用する PVC 仕様を定義します。自動的にプロビジョニングできないボリュームを使用する最も簡単な方法は、手動で作成された PersistentVolumes と一緒にラベルセレクターを使用することです。 |
8.1.384. .spec.storage.emptyDir
- 説明
-
StatefulSet が使用する EmptyDirVolumeSource。指定した場合、
ephemeral
およびvolumeClaimTemplate
よりも優先されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes/#emptydir - 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| medium は、このディレクトリーをバックアップする必要があるストレージメディアのタイプを表します。デフォルトは"" です。これは、ノードのデフォルトのメディアを使用することを意味します。空の文字列 (デフォルト) またはメモリーである必要があります。詳細: https://kubernetes.io/docs/concepts/storage/volumes#emptydir |
|
| sizeLimit は、この EmptyDir ボリュームに必要なローカルストレージの合計量です。サイズ制限はメモリーメディアにも適用されます。メモリーメディア EmptyDir での最大使用量は、ここで指定された SizeLimit と Pod 内のすべてのコンテナーのメモリー制限の合計との間の最小値になります。デフォルトは nil です。これは、制限が未定義であることを意味します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#emptydir |
8.1.385. .spec.storage.ephemeral
- 説明
- StatefulSet が使用する EphemeralVolumeSource。これは、k8s 1.21 ではベータフィールド、1.15 では GA です。k8s 1.19 以前のバージョンでは、GenericEphemeralVolume フィーチャーゲートを有効にする必要があります。詳細: https://kubernetes.io/docs/concepts/storage/ephemeral-volumes/#generic-ephemeral-volumes
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
|
ボリュームをプロビジョニングするためのスタンドアロン PVC を作成するために使用されます。この EphemeralVolumeSource が埋め込まれている Pod が PVC の所有者になります。つまり、PVC は Pod と一緒に削除されます。PVC の名前は Pod が所有していないその名前の既存の PVC は、無関係なボリュームを誤って使用することを避けるために、Pod に使用され ません。Pod の起動は、無関係の PVC が削除されるまでブロックされます。そのような事前に作成された PVC が Pod で使用されることを意図している場合、Pod が存在すると、PVC は Pod への所有者参照で更新する必要があります。通常、これは必要ありませんが、壊れたクラスターを手動で再構築する場合に役立つことがあります。 このフィールドは読み取り専用であり、作成後に Kubernetes が PVC に変更を加えることはありません。 必須です。nil であってはなりません。 |
8.1.386. .spec.storage.ephemeral.volumeClaimTemplate
- 説明
ボリュームをプロビジョニングするためのスタンドアロン PVC を作成するために使用されます。この EphemeralVolumeSource が埋め込まれている Pod が PVC の所有者になります。つまり、PVC は Pod と一緒に削除されます。PVC の名前は
<pod name>-<volume name>
になります。ここで、<volume name>
はPodSpec.Volumes
アレイエントリーからの名前です。連結された名前が PVC に対して有効でない場合 (たとえば、長すぎる場合)、Pod 検証は Pod を拒否します。Pod が所有していないその名前の既存の PVC は、無関係なボリュームを誤って使用することを避けるために、Pod に使用され ません。Pod の起動は、無関係の PVC が削除されるまでブロックされます。そのような事前に作成された PVC が Pod で使用されることを意図している場合、Pod が存在すると、PVC は Pod への所有者参照で更新する必要があります。通常、これは必要ありませんが、壊れたクラスターを手動で再構築する場合に役立つことがあります。
このフィールドは読み取り専用であり、作成後に Kubernetes が PVC に変更を加えることはありません。
必須です。nil であってはなりません。
- 型
-
object
- 必須
-
spec
-
プロパティー | 型 | 説明 |
---|---|---|
|
| PVC の作成時に PVC にコピーされるラベルとアノテーションが含まれる場合があります。他のフィールドは許可されておらず、検証中に拒否されます。 |
|
| PersistentVolumeClaim の仕様。コンテンツ全体が、このテンプレートから作成された PVC に変更されずにコピーされます。PersistentVolumeClaim と同じフィールドがここでも有効です。 |
8.1.387. .spec.storage.ephemeral.volumeClaimTemplate.metadata
- 説明
- PVC の作成時に PVC にコピーされるラベルとアノテーションが含まれる場合があります。他のフィールドは許可されておらず、検証中に拒否されます。
- 型
-
object
8.1.388. .spec.storage.ephemeral.volumeClaimTemplate.spec
- 説明
- PersistentVolumeClaim の仕様。コンテンツ全体が、このテンプレートから作成された PVC に変更されずにコピーされます。PersistentVolumeClaim と同じフィールドがここでも有効です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| accessModes には、ボリュームに割り当てる必要のあるアクセスモードが含まれます。詳細は、https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 を参照してください。 |
|
| dataSource フィールドは、次のいずれかを指定するために使用できます。*既存の VolumeSnapshot オブジェクト (snapshot.storage.k8s.io/VolumeSnapshot)*既存の PVC(PersistentVolumeClaim) プロビジョナーまたは外部コントローラーが指定されたデータソースをサポートできる場合、指定されたデータソースのコンテンツに基づく新しいボリューム。AnyVolumeDataSource フィーチャーゲートが有効になっている場合、dataSource の内容は dataSourceRef にコピーされ、dataSourceRef.namespace が指定されていない場合に dataSourceRef コンテンツが dataSource にコピーされます。namespace が指定されている場合、dataSourceRef は dataSource にコピーされません。 |
|
| 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 フィーチャーゲートを有効にする必要があります。 |
|
| resources は、ボリュームに必要な最小リソースを表します。RecoverVolumeExpansionFailure 機能が有効になっている場合、ユーザーは以前の値よりも低いリソース要件を指定できますが、要求のステータスフィールドに記録された容量よりも大きい必要があります。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources |
|
| selector は、バインドを考慮するボリュームに対するラベルクエリーです。 |
|
| storageClassName は、要求に必要な StorageClass の名前です。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1 |
|
| volumeAttributesClassName は、このクレームで使用される VolumeAttributesClass を設定するために使用できます。指定すると、CSI ドライバーは、対応する VolumeAttributesClass で定義された属性を使用してボリュームを作成または更新します。これは storageClassName とは異なる目的があり、クレームの作成後に変更できます。空の文字列値は、クレームに VolumeAttributesClass が適用されないことを意味しますが、一度設定すると、このフィールドを空の文字列にリセットすることはできません。指定されておらず、PersistentVolumeClaim がバインドされていない場合は、永続ボリュームコントローラーが存在する場合は、デフォルトの VolumeAttributesClass が設定されます。volumeAttributesClass によって参照されるリソースが存在しない場合は、そのようなリソースが存在するまで、この PersistentVolumeClaim は、modifyVolumeStatus フィールドに反映されるように、保留状態に設定されます。詳細は、https://kubernetes.io/docs/concepts/storage/volume-attributes-classes/ (ベータ版) を参照してください。このフィールドを使用するには、VolumeAttributesClass フィーチャーゲートを有効にする必要があります (デフォルトではオフ)。 |
|
| volumeMode は、要求に必要なボリュームのタイプを定義します。Filesystem の値は、要求仕様に含まれていない場合に暗示されます。 |
|
| volumeName は、この要求をサポートする PersistentVolume へのバインディング参照です。 |
8.1.389. .spec.storage.ephemeral.volumeClaimTemplate.spec.dataSource
- 説明
- dataSource フィールドは、次のいずれかを指定するために使用できます。*既存の VolumeSnapshot オブジェクト (snapshot.storage.k8s.io/VolumeSnapshot)*既存の PVC(PersistentVolumeClaim) プロビジョナーまたは外部コントローラーが指定されたデータソースをサポートできる場合、指定されたデータソースのコンテンツに基づく新しいボリューム。AnyVolumeDataSource フィーチャーゲートが有効になっている場合、dataSource の内容は dataSourceRef にコピーされ、dataSourceRef.namespace が指定されていない場合に dataSourceRef コンテンツが dataSource にコピーされます。namespace が指定されている場合、dataSourceRef は dataSource にコピーされません。
- 型
-
object
- 必須
-
kind
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| APIGroup は参照されているリソースのグループです。APIGroup が指定されていない場合は、指定の Kind をコア API グループに設定する必要があります。他のサードパーティータイプには、APIGroup が必要です。 |
|
| kind は参照されているリソースのタイプです。 |
|
| name は、参照されているリソースの名前です。 |
8.1.390. .spec.storage.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 フィーチャーゲートを有効にする必要があります。 |
8.1.391. .spec.storage.ephemeral.volumeClaimTemplate.spec.resources
- 説明
- resources は、ボリュームに必要な最小リソースを表します。RecoverVolumeExpansionFailure 機能が有効になっている場合、ユーザーは以前の値よりも低いリソース要件を指定できますが、要求のステータスフィールドに記録された容量よりも大きい必要があります。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| limits は、許可されるコンピュートリソースの最大量を示します。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
|
| requests は、必要なコンピュートリソースの最小量を示します。コンテナーで Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
8.1.392. .spec.storage.ephemeral.volumeClaimTemplate.spec.selector
- 説明
- selector は、バインドを考慮するボリュームに対するラベルクエリーです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。 |
8.1.393. .spec.storage.ephemeral.volumeClaimTemplate.spec.selector.matchExpressions
- 説明
- matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
- 型
-
array
8.1.394. .spec.storage.ephemeral.volumeClaimTemplate.spec.selector.matchExpressions[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.395. .spec.storage.volumeClaimTemplate
- 説明
- Prometheus StatefulSets が使用する PVC 仕様を定義します。自動的にプロビジョニングできないボリュームを使用する最も簡単な方法は、手動で作成された PersistentVolumes と一緒にラベルセレクターを使用することです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 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 を参照してください。 |
|
| EmbeddedMetadata には、EmbeddedResource に関連するメタデータが含まれています。 |
|
| Pod 作成者によって要求されたボリュームに必要な特性を定義します。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims |
|
| 非推奨: このフィールドは設定されません。 |
8.1.396. .spec.storage.volumeClaimTemplate.metadata
- 説明
- EmbeddedMetadata には、EmbeddedResource に関連するメタデータが含まれています。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| アノテーションは、任意のメタデータを保存し、取得するために外部ツールで設定できる、リソースとともに保存される構造化されていないキー値のマップです。これらはクエリーできないため、オブジェクトを変更する場合に維持する必要があります。詳細: http://kubernetes.io/docs/user-guide/annotations |
|
| オブジェクトの整理と分類 (スコープと選択) に使用できる文字列キーと値のマップ。レプリケーションコントローラーおよびサービスのセレクターと一致する場合があります。詳細: http://kubernetes.io/docs/user-guide/labels |
|
| name は namespace 内で一意である必要があります。リソースの作成時に必要ですが、リソースによっては、クライアントが適切な名前の生成を自動的に要求することを許可する場合があります。name は、主にべき等性と設定定義の作成を目的としています。これを更新することはできません。詳細: http://kubernetes.io/docs/user-guide/identifiers#names |
8.1.397. .spec.storage.volumeClaimTemplate.spec
- 説明
- Pod 作成者によって要求されたボリュームに必要な特性を定義します。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| accessModes には、ボリュームに割り当てる必要のあるアクセスモードが含まれます。詳細は、https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 を参照してください。 |
|
| dataSource フィールドは、次のいずれかを指定するために使用できます。*既存の VolumeSnapshot オブジェクト (snapshot.storage.k8s.io/VolumeSnapshot)*既存の PVC(PersistentVolumeClaim) プロビジョナーまたは外部コントローラーが指定されたデータソースをサポートできる場合、指定されたデータソースのコンテンツに基づく新しいボリューム。AnyVolumeDataSource フィーチャーゲートが有効になっている場合、dataSource の内容は dataSourceRef にコピーされ、dataSourceRef.namespace が指定されていない場合に dataSourceRef コンテンツが dataSource にコピーされます。namespace が指定されている場合、dataSourceRef は dataSource にコピーされません。 |
|
| 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 フィーチャーゲートを有効にする必要があります。 |
|
| resources は、ボリュームに必要な最小リソースを表します。RecoverVolumeExpansionFailure 機能が有効になっている場合、ユーザーは以前の値よりも低いリソース要件を指定できますが、要求のステータスフィールドに記録された容量よりも大きい必要があります。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources |
|
| selector は、バインドを考慮するボリュームに対するラベルクエリーです。 |
|
| storageClassName は、要求に必要な StorageClass の名前です。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1 |
|
| volumeAttributesClassName は、このクレームで使用される VolumeAttributesClass を設定するために使用できます。指定すると、CSI ドライバーは、対応する VolumeAttributesClass で定義された属性を使用してボリュームを作成または更新します。これは storageClassName とは異なる目的があり、クレームの作成後に変更できます。空の文字列値は、クレームに VolumeAttributesClass が適用されないことを意味しますが、一度設定すると、このフィールドを空の文字列にリセットすることはできません。指定されておらず、PersistentVolumeClaim がバインドされていない場合は、永続ボリュームコントローラーが存在する場合は、デフォルトの VolumeAttributesClass が設定されます。volumeAttributesClass によって参照されるリソースが存在しない場合は、そのようなリソースが存在するまで、この PersistentVolumeClaim は、modifyVolumeStatus フィールドに反映されるように、保留状態に設定されます。詳細は、https://kubernetes.io/docs/concepts/storage/volume-attributes-classes/ (ベータ版) を参照してください。このフィールドを使用するには、VolumeAttributesClass フィーチャーゲートを有効にする必要があります (デフォルトではオフ)。 |
|
| volumeMode は、要求に必要なボリュームのタイプを定義します。Filesystem の値は、要求仕様に含まれていない場合に暗示されます。 |
|
| volumeName は、この要求をサポートする PersistentVolume へのバインディング参照です。 |
8.1.398. .spec.storage.volumeClaimTemplate.spec.dataSource
- 説明
- dataSource フィールドは、次のいずれかを指定するために使用できます。*既存の VolumeSnapshot オブジェクト (snapshot.storage.k8s.io/VolumeSnapshot)*既存の PVC(PersistentVolumeClaim) プロビジョナーまたは外部コントローラーが指定されたデータソースをサポートできる場合、指定されたデータソースのコンテンツに基づく新しいボリューム。AnyVolumeDataSource フィーチャーゲートが有効になっている場合、dataSource の内容は dataSourceRef にコピーされ、dataSourceRef.namespace が指定されていない場合に dataSourceRef コンテンツが dataSource にコピーされます。namespace が指定されている場合、dataSourceRef は dataSource にコピーされません。
- 型
-
object
- 必須
-
kind
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| APIGroup は参照されているリソースのグループです。APIGroup が指定されていない場合は、指定の Kind をコア API グループに設定する必要があります。他のサードパーティータイプには、APIGroup が必要です。 |
|
| kind は参照されているリソースのタイプです。 |
|
| name は、参照されているリソースの名前です。 |
8.1.399. .spec.storage.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 フィーチャーゲートを有効にする必要があります。 |
8.1.400. .spec.storage.volumeClaimTemplate.spec.resources
- 説明
- resources は、ボリュームに必要な最小リソースを表します。RecoverVolumeExpansionFailure 機能が有効になっている場合、ユーザーは以前の値よりも低いリソース要件を指定できますが、要求のステータスフィールドに記録された容量よりも大きい必要があります。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| limits は、許可されるコンピュートリソースの最大量を示します。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
|
| requests は、必要なコンピュートリソースの最小量を示します。コンテナーで Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
8.1.401. .spec.storage.volumeClaimTemplate.spec.selector
- 説明
- selector は、バインドを考慮するボリュームに対するラベルクエリーです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。 |
8.1.402. .spec.storage.volumeClaimTemplate.spec.selector.matchExpressions
- 説明
- matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
- 型
-
array
8.1.403. .spec.storage.volumeClaimTemplate.spec.selector.matchExpressions[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.404. .spec.storage.volumeClaimTemplate.status
- 説明
- 非推奨: このフィールドは設定されません。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| accessModes には、PVC をサポートするボリュームが実際に持つアクセスモードが含まれます。詳細は、https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 を参照してください。 |
|
| allocatedResourceStatuses は、指定された PVC に対してサイズが変更になるリソースのステータスを格納します。キー名は標準の Kubernetes ラベル構文に従います。有効な値は次のいずれかです: * 接頭辞のないキー: - ストレージ - ボリュームの容量。* カスタムリソースでは、"example.com/my-custom-resource" などの実装定義の接頭辞付きの名前を使用する必要があります。上記の値以外では、接頭辞のないキーや kubernetes.io 接頭辞を持つキーは予約済みとみなされるため、使用できません。 ClaimResourceStatus は、次のいずれかの状態になります。- ControllerResizeInProgress: サイズ変更コントローラーがコントロールプレーンでボリュームのサイズ変更を開始したときに設定される状態。- ControllerResizeFailed: サイズ変更コントローラーで端末エラーが発生してサイズ変更が失敗したときに設定される状態。- NodeResizePending: サイズ変更コントローラーがボリュームのサイズ変更を完了したが、ノードでさらにボリュームのサイズ変更が必要な場合に設定される状態。- NodeResizeInProgress: kubelet がボリュームのサイズ変更を開始するときに設定される状態。- NodeResizeFailed: kubelet で端末エラーが発生してサイズ変更が失敗した場合に設定される状態。一時的なエラーでは NodeResizeFailed は設定されません。たとえば、容量を増やすために PVC を拡張する場合、このフィールドは次のいずれかの状態になります。- pvc.status.allocatedResourceStatus['storage'] = "ControllerResizeInProgress" - pvc.status.allocatedResourceStatus['storage'] = "ControllerResizeFailed" - pvc.status.allocatedResourceStatus['storage'] = "NodeResizePending" - pvc.status.allocatedResourceStatus['storage'] = "NodeResizeInProgress" - pvc.status.allocatedResourceStatus['storage'] = "NodeResizeFailed" このフィールドが設定されていないと、指定された PVC に対してサイズ変更操作が進行中ではないことを意味します。 以前は不明だった resourceName または ClaimResourceStatus を持つ PVC 更新を受信したコントローラーは、設計された目的のためにその更新を無視する必要があります。たとえば、ボリュームの容量のサイズ変更のみを担当するコントローラーは、PVC に関連付けられている他の有効なリソースを変更する PVC 更新を無視する必要があります。 これはアルファフィールドであるため、RecoverVolumeExpansionFailure 機能を有効にする必要があります。 |
|
| allocatedResources は、PVC に割り当てられたリソース (容量を含む) を追跡します。キー名は標準の Kubernetes ラベル構文に従います。有効な値は次のいずれかです: * 接頭辞のないキー: - ストレージ - ボリュームの容量。* カスタムリソースでは、"example.com/my-custom-resource" などの実装定義の接頭辞付きの名前を使用する必要があります。上記の値以外では、接頭辞のないキーや kubernetes.io 接頭辞を持つキーは予約済みとみなされるため、使用できません。 ここで報告される容量は、ボリューム拡張操作が要求された場合の実際の容量よりも大きくなる可能性があります。ストレージクォータには、allocatedResources と PVC.spec.resources を比較して大きい方の値が使用されます。allocatedResources が設定されていない場合、PVC.spec.resources のみがクォータの計算に使用されます。ボリューム拡張容量要求が下げられ、進行中の拡張操作がなく、実際のボリューム容量が要求された容量以下である場合にのみ、allocatedResources が引き下げられます。 以前は不明だった resourceName を持つ PVC 更新を受信したコントローラーは、設計された目的のため、その更新を無視する必要があります。たとえば、ボリュームの容量のサイズ変更のみを担当するコントローラーは、PVC に関連付けられている他の有効なリソースを変更する PVC 更新を無視する必要があります。 これはアルファフィールドであるため、RecoverVolumeExpansionFailure 機能を有効にする必要があります。 |
|
| capacity は、基礎となるボリュームの実際のリソースを表します。 |
|
| conditions は永続ボリューム要求の現在の条件です。基礎となる永続ボリュームのサイズが変更されていると、条件が 'Resizing' に設定されます。 |
|
| PersistentVolumeClaimCondition での pvc の状態の詳細 |
|
| currentVolumeAttributesClassName は、PVC が使用している VolumeAttributesClass の現在の名前です。これが設定されていないと、この PersistentVolumeClaim には VolumeAttributeClass は適用されません。これはベータフィールドであり、VolumeAttributesClass 機能を有効にする必要があります (デフォルトではオフ)。 |
|
| ModifyVolumeStatus は、ControllerModifyVolume 操作のステータスオブジェクトを表します。これが設定されていない場合、ModifyVolume 操作は試行されません。これはベータフィールドであり、VolumeAttributesClass 機能を有効にする必要があります (デフォルトではオフ)。 |
|
| phase は PersistentVolumeClaim の現在のフェーズを表します。 |
8.1.405. .spec.storage.volumeClaimTemplate.status.conditions
- 説明
- conditions は永続ボリューム要求の現在の条件です。基礎となる永続ボリュームのサイズが変更されていると、条件が 'Resizing' に設定されます。
- 型
-
array
8.1.406. .spec.storage.volumeClaimTemplate.status.conditions[]
- 説明
- PersistentVolumeClaimCondition での pvc の状態の詳細
- 型
-
object
- 必須
-
status
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| lastProbeTime は、条件を調査した時間です。 |
|
| lastTransitionTime は、ある状態から別の状態に最後に遷移した時間です。 |
|
| message は、最後の遷移に関する詳細を示し、人間が判読できるメッセージです。 |
|
| 一意であり、これは、条件の最後の遷移理由を示す、マシンが理解できる短い文字列である必要があります。"Resizing" と報告された場合は、基礎となる永続ボリュームのサイズが変更になっていることを意味します。 |
|
| |
|
| PersistentVolumeClaimConditionType は、PVC の状態を示します。有効な値は次のとおりです。- "Resizing"、"FileSystemResizePending" RecoverVolumeExpansionFailure フィーチャーゲートが有効になっている場合は、さらに次の値が予想されます。- "ControllerResizeError"、"NodeResizeError" VolumeAttributesClass フィーチャーゲートが有効になっている場合は、さらに次の値が予想されます。- "ModifyVolumeError"、"ModifyingVolume" |
8.1.407. .spec.storage.volumeClaimTemplate.status.modifyVolumeStatus
- 説明
- ModifyVolumeStatus は、ControllerModifyVolume 操作のステータスオブジェクトを表します。これが設定されていない場合、ModifyVolume 操作は試行されません。これはベータフィールドであり、VolumeAttributesClass 機能を有効にする必要があります (デフォルトではオフ)。
- 型
-
object
- 必須
-
status
-
プロパティー | 型 | 説明 |
---|---|---|
|
| status は、ControllerModifyVolume 操作のステータスです。状態は次のいずれかになります: - Pending。Pending は、指定された VolumeAttributesClass が存在しないなど、要件が満たされていないため、PersistentVolumeClaim を変更できないことを示します。- InProgress。InProgress は、ボリュームが変更中であることを示します。- Infeasible。Infeasible は、要求が CSI ドライバーによって無効として拒否されたことを示します。エラーを解決するには、有効な VolumeAttributesClass を指定する必要があります。注記: 将来的に新しいステータスが追加される可能性があります。コンシューマーは不明なステータスをチェックし、適切に失敗する必要があります。 |
|
| targetVolumeAttributesClassName は、現在調整中の PVC の VolumeAttributesClass の名前です。 |
8.1.408. .spec.thanos
- 説明
- オプションの Thanos サイドカーの設定を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| AdditionalArgs を使用して、Thanos コンテナーに追加の引数を設定できます。引数はそのまま Thanos コンテナーに渡されますが、引数が無効であったり、指定された Thanos バージョンでサポートされていない場合は問題が発生する可能性があります。引数が競合する場合 (たとえば、Operator によってすでに設定されている引数)、または無効な引数を指定すると、調整は失敗し、エラーが記録されます。 |
|
| AdditionalArgs リストの一部である引数。 |
|
| 非推奨: 代わりに 'image' を使用します。 |
|
| BlockDuration は、Prometheus によって生成される TSDB ブロックのサイズを制御します。デフォルト値は 2h で、アップストリームの Prometheus のデフォルトと一致します。 警告: ブロックの期間を変更すると、メモリーや Thanos コンパクターとの関わり方によっては、Prometheus/Thanos スタック全体のパフォーマンスと効率に影響が及ぶ可能性があります。この値は、最長のスクレイプまたはルール間隔の 120 倍に設定することが推奨されます。たとえば、30s * 120 = 1h です。 |
|
| Prometheus 設定を取得する頻度。 |
|
| Prometheus 設定を取得するときの最大待機時時間。 |
|
| true の場合、Thanos サイドカーは、gRPC エンドポイントの Pod IP アドレスではなく、ループバックインターフェイスをリッスンします。
|
|
| StoreAPI を提供する gRPC サーバーの TLS パラメーターを設定します。
注記: 現在、 |
|
| true の場合、Thanos サイドカーは HTTP エンドポイントの Pod IP アドレスではなく、ループバックインターフェイスをリッスンします。
|
|
|
Thanos のコンテナーイメージ名。指定されている場合、
Prometheus Operator が、設定されている Thanos バージョンを認識するためには、
|
|
|
非推奨: 代わりに |
|
| Thanos サイドカーのログ形式。 |
|
| Thanos サイドカーのログレベル。 |
|
| Thanos サイドカーの StoreAPI によって提供される時間範囲制限の開始を定義します。フィールドの値は、RFC3339 形式の定数時間、または現在の時刻に対する相対的な期間 (-1d や 2h45m など) である必要があります。有効な期間の単位は、ms、s、m、h、d、w、y です。 |
|
| TSDB ブロックをオブジェクトストレージにアップロードするための Thanos サイドカーの設定を定義します。 詳細情報: https://thanos.io/tip/thanos/storage.md/ objectStorageConfigFile はこのフィールドよりも優先されます。 |
|
| TSDB ブロックをオブジェクトストレージにアップロードするための Thanos サイドカーの設定ファイルを定義します。 詳細情報: https://thanos.io/tip/thanos/storage.md/ このフィールドは objectStorageConfig よりも優先されます。 |
|
| ReadyTimeout は、Thanos サイドカーが Prometheus の起動まで待機する最大時間です。 |
|
| Thanos サイドカーのリソースリクエストと制限を定義します。 |
|
| 非推奨: 代わりに 'image' を使用します。イメージダイジェストは、イメージ名の一部として指定できます。 |
|
| 非推奨: 代わりに 'image' を使用します。イメージのタグはイメージ名の一部として指定できます。 |
|
| Thanos サイドカーのトレーシング設定を定義します。
詳細情報: https://thanos.io/tip/thanos/tracing.md/ これは 実験的な機能 であり、今後のリリースで重大な変更が加えられる可能性があります。 |
|
| Thanos サイドカーのトレーシング設定ファイルを定義します。
このフィールドは 詳細情報: https://thanos.io/tip/thanos/tracing.md/ これは 実験的な機能 であり、今後のリリースで重大な変更が加えられる可能性があります。 |
|
| デプロイされている Thanos のバージョン。Operator はこの情報を使用して、Prometheus StatefulSet と設定ファイルを生成します。 指定されていない場合、Operator は、Operator のバージョンがリリースされた時点で利用可能な Thanos の最新アップストリームリリースを想定します。 |
|
| volumeMounts を使用して、Thanos 用の追加の VolumeMounts を設定できます。指定された VolumeMounts は、'thanos-sidecar' コンテナー内の他の VolumeMounts に追加されます。 |
|
| VolumeMount は、コンテナー内でのボリュームのマウントについて説明します。 |
8.1.409. .spec.thanos.additionalArgs
- 説明
- AdditionalArgs を使用して、Thanos コンテナーに追加の引数を設定できます。引数はそのまま Thanos コンテナーに渡されますが、引数が無効であったり、指定された Thanos バージョンでサポートされていない場合は問題が発生する可能性があります。引数が競合する場合 (たとえば、Operator によってすでに設定されている引数)、または無効な引数を指定すると、調整は失敗し、エラーが記録されます。
- 型
-
array
8.1.410. .spec.thanos.additionalArgs[]
- 説明
- AdditionalArgs リストの一部である引数。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 引数の名前 (例: "scrape.discovery-reload-interval")。 |
|
| 引数の値 (例: 30s)。名前のみの引数は空にできます (例: --storage.tsdb.no-lockfile) |
8.1.411. .spec.thanos.grpcServerTlsConfig
- 説明
StoreAPI を提供する gRPC サーバーの TLS パラメーターを設定します。
注記: 現在、
caFile
、certFile
、keyFile
フィールドのみがサポートされています。- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| サーバー証明書の検証に使用される認証局。 |
|
| ターゲットに使用する Prometheus コンテナー内の CA 証明書へのパス。 |
|
| クライアント認証を行うときに提示するクライアント証明書。 |
|
| ターゲットの Prometheus コンテナー内のクライアント証明書ファイルへのパス。 |
|
| ターゲット証明書の検証を無効にします。 |
|
| ターゲットの Prometheus コンテナー内のクライアントキーファイルへのパス。 |
|
| ターゲットのクライアントキーファイルを含むシークレット。 |
|
| 許容可能な最大 TLS バージョン。 Prometheus v2.41.0 以降が必要です。 |
|
| 許容可能な最小 TLS バージョン。 Prometheus v2.35.0 以降が必要です。 |
|
| ターゲットのホスト名を確認するために使用されます。 |
8.1.412. .spec.thanos.grpcServerTlsConfig.ca
- 説明
- サーバー証明書の検証に使用される認証局。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用するデータを含む ConfigMap。 |
|
| ターゲットに使用するデータを含むシークレット。 |
8.1.413. .spec.thanos.grpcServerTlsConfig.ca.configMap
- 説明
- ターゲットに使用するデータを含む ConfigMap。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
8.1.414. .spec.thanos.grpcServerTlsConfig.ca.secret
- 説明
- ターゲットに使用するデータを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.415. .spec.thanos.grpcServerTlsConfig.cert
- 説明
- クライアント認証を行うときに提示するクライアント証明書。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用するデータを含む ConfigMap。 |
|
| ターゲットに使用するデータを含むシークレット。 |
8.1.416. .spec.thanos.grpcServerTlsConfig.cert.configMap
- 説明
- ターゲットに使用するデータを含む ConfigMap。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
8.1.417. .spec.thanos.grpcServerTlsConfig.cert.secret
- 説明
- ターゲットに使用するデータを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.418. .spec.thanos.grpcServerTlsConfig.keySecret
- 説明
- ターゲットのクライアントキーファイルを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.419. .spec.thanos.objectStorageConfig
- 説明
TSDB ブロックをオブジェクトストレージにアップロードするための Thanos サイドカーの設定を定義します。
詳細情報: https://thanos.io/tip/thanos/storage.md/
objectStorageConfigFile はこのフィールドよりも優先されます。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.420. .spec.thanos.resources
- 説明
- Thanos サイドカーのリソースリクエストと制限を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。 これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。 このフィールドは不変です。これはコンテナーにのみ設定できます。 |
|
| ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。 |
|
| limits は、許可されるコンピュートリソースの最大量を示します。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
|
| requests は、必要なコンピュートリソースの最小量を示します。コンテナーで Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
8.1.421. .spec.thanos.resources.claims
- 説明
Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。
これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。
このフィールドは不変です。これはコンテナーにのみ設定できます。
- 型
-
array
8.1.422. .spec.thanos.resources.claims[]
- 説明
- ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリーを参照します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。 |
|
| request は、参照されるクレーム内のリクエストに対して選択された名前です。空の場合、クレームからのすべてのものが利用可能になり、それ以外の場合はこの request の結果のみが利用可能になります。 |
8.1.423. .spec.thanos.tracingConfig
- 説明
Thanos サイドカーのトレーシング設定を定義します。
tracingConfigFile
は、このフィールドよりも優先されます。詳細情報: https://thanos.io/tip/thanos/tracing.md/
これは 実験的な機能 であり、今後のリリースで重大な変更が加えられる可能性があります。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.424. .spec.thanos.volumeMounts
- 説明
- volumeMounts を使用して、Thanos 用の追加の VolumeMounts を設定できます。指定された VolumeMounts は、'thanos-sidecar' コンテナー内の他の VolumeMounts に追加されます。
- 型
-
array
8.1.425. .spec.thanos.volumeMounts[]
- 説明
- VolumeMount は、コンテナー内でのボリュームのマウントを説明します。
- 型
-
object
- 必須
-
mountPath
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ボリュームをマウントする必要があるコンテナー内のパス。':' を含めることはできません。 |
|
| mountPropagation は、マウントがホストからコンテナーに、またはその逆にどのように伝播されるかを決定します。設定されていない場合、MountPropagationNone が使用されます。このフィールドは 1.10 のベータ版です。RecursiveReadOnly が IfPossible または Enabled に設定されている場合、MountPropagation は None または未指定 (デフォルトは None) にする必要があります。 |
|
| ボリュームの名前に一致する必要があります。 |
|
| true の場合は読み取り専用、それ以外の場合は読み取り/書き込み (false または指定なし) でマウントされます。デフォルトは false です。 |
|
| RecursiveReadOnly は、読み取り専用マウントを再帰的に処理するかどうかを指定します。 ReadOnly が false の場合、このフィールドには意味がなく、未指定にする必要があります。 ReadOnly が true で、このフィールドが Disabled に設定されている場合、マウントは再帰的に読み取り専用にはなりません。このフィールドが IfPossible に設定されている場合、コンテナーランタイムでサポートされている場合は、マウントは再帰的に読み取り専用になります。このフィールドが Enabled に設定されている場合で、コンテナーランタイムでサポートされている場合は、マウントが再帰的に読み取り専用になり、そうでない場合は Pod が起動されず、理由を示すエラーが生成されます。 このフィールドが IfPossible または Enabled に設定されている場合、MountPropagation は None に設定する必要があります (または未指定にする必要があります。この場合、デフォルトは None になります)。 このフィールドが指定されていない場合は、無効と同じ扱いになります。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内のパス。デフォルトは "" (ボリュームのルート) です。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内の拡張パス。SubPath と同様に動作しますが、環境変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。デフォルトは "" (ボリュームのルート) です。SubPathExpr と SubPath は相互に排他的です。 |
8.1.426. .spec.tolerations
- 説明
- 指定されている場合、Pod の toleration を定義します。
- 型
-
array
8.1.427. .spec.tolerations[]
- 説明
- この toleration が割り当てられる Pod は、マッチング Operator <operator> を使用してトリプル <key,value,effect> と一致する taint を許容します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| effect は、照合するテイントの効果を示します。空の場合は、すべてのテイント効果に一致します。指定されている場合、許可される値は NoSchedule、PreferNoSchedule、および NoExecute です。 |
|
| key は toleration が適用されるテイントキーです。空の場合は、すべてのテイントキーに一致します。キーが空の場合、Operator は Exists である必要があります。この組み合わせは、すべての値とすべてのキーに一致することを意味します。 |
|
| Operator はキーと値の関係を表します。有効な Operator は Exists および Equal です。デフォルトは Equal です。Exists は、値のワイルドカードと同等であるため、Pod は特定のカテゴリーのすべてのテイントに耐えることができます。 |
|
| tolerationSeconds は、toleration (effect は NoExecute でなければならず、NoExecute 以外の場合このフィールドは無視されます) が taint を許容する期間を表します。デフォルトでは設定されていません。つまり、テイントを永久に許容します (エビクトしないでください)。ゼロ値と負の値は、システムによって 0 (すぐにエビクト) として扱われます。 |
|
| value は、toleration が一致するテイントの値です。Operator が Exists の場合、値は空である必要があります。それ以外の場合は、通常の文字列のみになります。 |
8.1.428. .spec.topologySpreadConstraints
- 説明
- 指定されている場合、Pod のトポロジー分散制約を定義します。
- 型
-
array
8.1.429. .spec.topologySpreadConstraints[]
- 説明
- 型
-
object
- 必須
-
maxSkew
-
topologyKey
-
whenUnsatisfiable
-
プロパティー | 型 | 説明 |
---|---|---|
|
| topologySpreadConstraint の labelSelector に追加する Prometheus Operator マネージドラベルを定義します。 |
|
| 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 に違反するためです。 |
|
| 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) になります。つまり、クラスターは依然として不均衡である可能性がありますが、スケジューラーによってクラスターが さらに 不均衡になることはありません。必須フィールドです。 |
8.1.430. .spec.topologySpreadConstraints[].labelSelector
- 説明
- LabelSelector は、一致する Pod を見つけるために使用されます。このラベルセレクターに一致する Pod は、対応するトポロジードメイン内の Pod の数を決定するためにカウントされます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。 |
8.1.431. .spec.topologySpreadConstraints[].labelSelector.matchExpressions
- 説明
- matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
- 型
-
array
8.1.432. .spec.topologySpreadConstraints[].labelSelector.matchExpressions[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.433. .spec.tracingConfig
- 説明
TracingConfig は Prometheus でトレーシングを設定します。
これは 実験的な機能 であり、今後のリリースで重大な変更が加えられる可能性があります。
- 型
-
object
- 必須
-
endpoint
-
プロパティー | 型 | 説明 |
---|---|---|
|
|
トレースのエクスポートに使用されるクライアント。サポートされる値は |
|
|
サポートされている圧縮タイプの圧縮キー。サポートされている値は |
|
| トレースの送信先となるエンドポイント。<host>:<port> の形式で指定する必要があります。 |
|
| gRPC または HTTP リクエストに関連付けられたヘッダーとして使用されるキーと値のペア。 |
|
| 無効にすると、クライアントはセキュアな接続を使用します。 |
|
| 特定のトレースがサンプリングされる確率を設定します。0 から 1 までの浮動小数点数である必要があります。 |
|
| エクスポーターが各バッチエクスポートを待機する最大時間。 |
|
| トレースを送信するときに使用する TLS 設定。 |
8.1.434. .spec.tracingConfig.tlsConfig
- 説明
- トレースを送信するときに使用する TLS 設定。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| サーバー証明書の検証に使用される認証局。 |
|
| ターゲットに使用する Prometheus コンテナー内の CA 証明書へのパス。 |
|
| クライアント認証を行うときに提示するクライアント証明書。 |
|
| ターゲットの Prometheus コンテナー内のクライアント証明書ファイルへのパス。 |
|
| ターゲット証明書の検証を無効にします。 |
|
| ターゲットの Prometheus コンテナー内のクライアントキーファイルへのパス。 |
|
| ターゲットのクライアントキーファイルを含むシークレット。 |
|
| 許容可能な最大 TLS バージョン。 Prometheus v2.41.0 以降が必要です。 |
|
| 許容可能な最小 TLS バージョン。 Prometheus v2.35.0 以降が必要です。 |
|
| ターゲットのホスト名を確認するために使用されます。 |
8.1.435. .spec.tracingConfig.tlsConfig.ca
- 説明
- サーバー証明書の検証に使用される認証局。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用するデータを含む ConfigMap。 |
|
| ターゲットに使用するデータを含むシークレット。 |
8.1.436. .spec.tracingConfig.tlsConfig.ca.configMap
- 説明
- ターゲットに使用するデータを含む ConfigMap。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
8.1.437. .spec.tracingConfig.tlsConfig.ca.secret
- 説明
- ターゲットに使用するデータを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.438. .spec.tracingConfig.tlsConfig.cert
- 説明
- クライアント認証を行うときに提示するクライアント証明書。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用するデータを含む ConfigMap。 |
|
| ターゲットに使用するデータを含むシークレット。 |
8.1.439. .spec.tracingConfig.tlsConfig.cert.configMap
- 説明
- ターゲットに使用するデータを含む ConfigMap。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
8.1.440. .spec.tracingConfig.tlsConfig.cert.secret
- 説明
- ターゲットに使用するデータを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.441. .spec.tracingConfig.tlsConfig.keySecret
- 説明
- ターゲットのクライアントキーファイルを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.442. .spec.tsdb
- 説明
- ランタイムでのリロードが可能な時系列データベース (TSDB) の設定を定義します。Prometheus v2.39.0 以降または PrometheusAgent v2.54.0 以降が必要です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| TSDB 最大時間に照らした場合に、順序外/範囲外のサンプルがどのくらい古いかを設定します。 サンプルのタイムスタンプが (TSDB.MaxTime - outOfOrderTimeWindow) 以上であれば、順序外/範囲外のサンプルは TSDB に取り込まれます。 これは 実験的な機能 であり、今後のリリースで重大な変更が加えられる可能性があります。 Prometheus v2.39.0 以降または PrometheusAgent v2.54.0 以降が必要です。 |
8.1.443. .spec.volumeMounts
- 説明
volumeMounts を使用して、追加の volumeMounts を設定できます。
VolumeMounts は、StorageSpec オブジェクトの結果として生成される 'prometheus' コンテナー内の他の VolumeMounts に追加されます。
- 型
-
array
8.1.444. .spec.volumeMounts[]
- 説明
- VolumeMount は、コンテナー内でのボリュームのマウントを説明します。
- 型
-
object
- 必須
-
mountPath
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ボリュームをマウントする必要があるコンテナー内のパス。':' を含めることはできません。 |
|
| mountPropagation は、マウントがホストからコンテナーに、またはその逆にどのように伝播されるかを決定します。設定されていない場合、MountPropagationNone が使用されます。このフィールドは 1.10 のベータ版です。RecursiveReadOnly が IfPossible または Enabled に設定されている場合、MountPropagation は None または未指定 (デフォルトは None) にする必要があります。 |
|
| ボリュームの名前に一致する必要があります。 |
|
| true の場合は読み取り専用、それ以外の場合は読み取り/書き込み (false または指定なし) でマウントされます。デフォルトは false です。 |
|
| RecursiveReadOnly は、読み取り専用マウントを再帰的に処理するかどうかを指定します。 ReadOnly が false の場合、このフィールドには意味がなく、未指定にする必要があります。 ReadOnly が true で、このフィールドが Disabled に設定されている場合、マウントは再帰的に読み取り専用にはなりません。このフィールドが IfPossible に設定されている場合、コンテナーランタイムでサポートされている場合は、マウントは再帰的に読み取り専用になります。このフィールドが Enabled に設定されている場合で、コンテナーランタイムでサポートされている場合は、マウントが再帰的に読み取り専用になり、そうでない場合は Pod が起動されず、理由を示すエラーが生成されます。 このフィールドが IfPossible または Enabled に設定されている場合、MountPropagation は None に設定する必要があります (または未指定にする必要があります。この場合、デフォルトは None になります)。 このフィールドが指定されていない場合は、無効と同じ扱いになります。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内のパス。デフォルトは "" (ボリュームのルート) です。 |
|
| コンテナーのボリュームをマウントする必要があるボリューム内の拡張パス。SubPath と同様に動作しますが、環境変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。デフォルトは "" (ボリュームのルート) です。SubPathExpr と SubPath は相互に排他的です。 |
8.1.445. .spec.volumes
- 説明
- volumes を使用して、出力の StatefulSet 定義に追加のボリュームを設定できます。指定されたボリュームは、StorageSpec オブジェクトの結果として生成される他のボリュームに追加されます。
- 型
-
array
8.1.446. .spec.volumes[]
- 説明
- ボリュームは、Pod 内の任意のコンテナーからアクセスできる Pod 内の名前付きボリュームを表します。
- 型
-
object
- 必須
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| awsElasticBlockStore は、kubelet のホストマシンに割り当てられ、Pod に公開される AWS Disk リソースを表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
|
| azureDisk は、ホスト上の Azure Data Disk マウントを表し、Pod へのバインドマウントを表します。 |
|
| azureFile は、ホスト上の Azure File Service マウントを表し、マウントを Pod にバインドします。 |
|
| cephFS は、Pod の有効期間を共有するホストでの Ceph FS マウントを表します。 |
|
| Cinder は、kubelets ホストマシンに接続およびマウントされた Cinder ボリュームを表します。詳細: https://examples.k8s.io/mysql-cinder-pd/README.md |
|
| configMap は、このボリュームに入力する必要がある configMap を表します |
|
| csi (Container Storage Interface) は、特定の外部 CSI ドライバー (ベータ機能) によって処理される一時的なストレージを表します。 |
|
| downwardAPI は、このボリュームに入力する必要がある Pod に関する Downward API を表します |
|
| emptyDir は、Pod の存続期間を共有する一時ディレクトリーを表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#emptydir |
|
| ephemeral は、クラスターストレージドライバーによって処理されるボリュームを表します。ボリュームのライフサイクルは、ボリュームを定義する Pod に関連付けられています。ボリュームは、Pod が起動する前に作成され、Pod が削除されると削除されます。 これは、次の場合に使用します。a)Pod の実行中にのみボリュームが必要、b) スナップショットからの復元や容量追跡などの通常のボリュームの機能が必要、c) ストレージドライバーがストレージクラスを通じて指定される、d) ストレージドライバー PersistentVolumeClaim を介した動的ボリュームプロビジョニングをサポートします (このボリュームタイプと PersistentVolumeClaim の間の接続の詳細は、EphemeralVolumeSource を参照してください)。 個々の Pod のライフサイクルより長く持続するボリュームには、PersistentVolumeClaim またはベンダー固有の API の 1 つを使用します。 CSI ドライバーをそのように使用する場合は、軽量のローカルエフェメラルボリュームに CSI を使用します。詳細は、ドライバーのドキュメントを参照してください。 Pod は、両方のタイプのエフェメラルボリュームとパーシステントボリュームを同時に使用できます。 |
|
| fc は、kubelet のホストマシンに接続されてから Pod に公開されるファイバーチャネルリソースを表します。 |
|
| flexVolume は、exec ベースのプラグインを使用してプロビジョニング/接続される汎用ボリュームリソースを表します。 |
|
| flocker は、kubelet のホストマシンに接続されている Flocker ボリュームを表します。これは、実行中の Flocker 制御サービスによって異なります |
|
| gcePersistentDisk は、kubelet のホストマシンに接続されてから Pod に公開される GCE ディスクリソースを表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
| gitRepo は、特定のリビジョンの git リポジトリーを表します。非推奨:GitRepo は非推奨です。git レポジトリを使用してコンテナーをプロビジョニングするには、Git を使用してレポジトリのクローンを作成する InitContainer に EmptyDir をマウントしてから、Pod のコンテナーに EmptyDir をマウントします。 |
|
| glusterfs は、Pod の存続期間を共有するホスト上の Glusterfs マウントを表します。詳細: https://examples.k8s.io/volumes/glusterfs/README.md |
|
| hostPath は、コンテナーに直接公開されているホストマシン上の既存のファイルまたはディレクトリーを表します。これは通常、ホストマシンの表示を許可されているシステムエージェントまたはその他の特権的なものに使用されます。ほとんどのコンテナーはこれを必要としません。詳細: https://kubernetes.io/docs/concepts/storage/volumes#hostpath |
|
| image は、kubelet のホストマシンにプルおよびマウントされた OCI オブジェクト (コンテナーイメージまたはアーティファクト) を表します。ボリュームは、提供される PullPolicy 値に応じて Pod の起動時に解決されます。 - Always: kubelet は常に参照をプルしようとします。プルが失敗すると、コンテナーの作成は失敗します。- Never: kubelet は参照をプルせず、ローカルイメージまたはアーティファクトのみを使用します。参照が存在しない場合、コンテナーの作成は失敗します。- IfNotPresent: 参照がディスク上にまだ存在しない場合、kubelet はプルします。参照が存在しず、プルが失敗すると、コンテナーの作成は失敗します。 Pod が削除されて再作成されるとボリュームが再度解決され、Pod の再作成時に新しいリモートコンテンツが利用可能になります。Pod の起動中にイメージを解決またはプルできない場合、コンテナーの起動がブロックされ、大幅な遅延が発生する可能性があります。失敗した場合は通常のボリュームバックオフを使用して再試行され、理由とメッセージが Pod で報告されます。このボリュームによってマウントされる可能性のあるオブジェクトのタイプは、ホストマシン上のコンテナーランタイム実装によって定義され、少なくともコンテナーイメージフィールドでサポートされているすべての有効なタイプが含まれている必要があります。OCI オブジェクトは、コンテナーイメージの場合と同じ方法でマニフェストレイヤーをマージすることで、単一ディレクトリー (spec.containers[].volumeMounts.mountPath) にマウントされます。ボリュームは、読み取り専用 (ro) および実行不可ファイル (noexec) としてマウントされます。コンテナーのサブパスマウントはサポートされていません (spec.containers[].volumeMounts.subpath)。spec.securityContext.fsGroupChangePolicy フィールドは、このボリュームタイプには影響しません。 |
|
| iscsi は、kubelet のホストマシンに接続されてから Pod に公開される ISCSI ディスクリソースを表します。詳細: https://examples.k8s.io/volumes/iscsi/README.md |
|
| ボリュームの名前。DNS_LABEL であり、Pod 内で一意である必要があります。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| NFS は、Pod の有効期間を共有するホスト上の NFS マウントを表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#nfs |
|
| persistentVolumeClaimVolumeSource は、同じ namespace 内の PersistentVolumeClaim への参照を表します。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims |
|
| photonPersistentDisk は、kubelets ホストマシンに接続されマウントされた PhotonController 永続ディスクを表します。 |
|
| portworxVolume は、kubelet ホストマシンに接続およびマウントされた portworx ボリュームを表します。 |
|
| オールインワンリソースシークレット、configmaps、および Downward API のアイテム |
|
| quobyte は、Pod の有効期限を共有するホストでの Quobyte マウントを表します |
|
| rbd は、Pod の有効期間を共有するホストの Rados ブロックデバイスマウントを表します。詳細: https://examples.k8s.io/volumes/rbd/README.md |
|
| scaleIO は、Kubernetes ノードに接続およびマウントされた ScaleIO 永続ボリュームを表します。 |
|
| secret は、このボリュームに入力する必要がある Secret を表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#secret |
|
| storageOS は、Kubernetes ノードに接続およびマウントされた StorageOS ボリュームを表します。 |
|
| vsphereVolume は、kubelet ホストマシンに接続およびマウントされた vSphere ボリュームを表します。 |
8.1.447. .spec.volumes[].awsElasticBlockStore
- 説明
- awsElasticBlockStore は、kubelet のホストマシンに割り当てられ、Pod に公開される AWS Disk リソースを表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore
- 型
-
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 |
8.1.448. .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 設定が強制的に実行されます。 |
8.1.449. .spec.volumes[].azureFile
- 説明
- azureFile は、ホスト上の Azure File Service マウントを表し、マウントを Pod にバインドします。
- 型
-
object
- 必須
-
secretName
-
shareName
-
プロパティー | 型 | 説明 |
---|---|---|
|
| readOnly のデフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。 |
|
| secretName は、Azure ストレージアカウント名とキーを含むシークレットの名前です。 |
|
| shareName は Azure 共有名です。 |
8.1.450. .spec.volumes[].cephfs
- 説明
- cephFS は、Pod の有効期間を共有するホストでの Ceph FS マウントを表します。
- 型
-
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 |
|
| secretRef は任意: SecretRef はユーザーの認証シークレットへの参照で、デフォルトは空です。詳細: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
| user 任意: User は rados ユーザー名、デフォルトは admin です。詳細: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
8.1.451. .spec.volumes[].cephfs.secretRef
- 説明
- secretRef は任意: SecretRef はユーザーの認証シークレットへの参照で、デフォルトは空です。詳細: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
8.1.452. .spec.volumes[].cinder
- 説明
- Cinder は、kubelets ホストマシンに接続およびマウントされた Cinder ボリュームを表します。詳細: https://examples.k8s.io/mysql-cinder-pd/README.md
- 型
-
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 |
|
| secretRef は任意: OpenStack への接続に使用されるパラメーターを含むシークレットオブジェクトを指します。 |
|
| cinder 内のボリュームを識別するために使用される volumeID。詳細: https://examples.k8s.io/mysql-cinder-pd/README.md |
8.1.453. .spec.volumes[].cinder.secretRef
- 説明
- secretRef は任意: OpenStack への接続に使用されるパラメーターを含むシークレットオブジェクトを指します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
8.1.454. .spec.volumes[].configMap
- 説明
- configMap は、このボリュームに入力する必要がある configMap を表します
- 型
-
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 かそのキーを定義する必要があるかどうかを指定します。 |
8.1.455. .spec.volumes[].configMap.items
- 説明
- item が指定されていない場合、参照される ConfigMap の Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。ConfigMap に存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。
- 型
-
array
8.1.456. .spec.volumes[].configMap.items[]
- 説明
- 文字列キーをボリューム内のパスにマップします。
- 型
-
object
- 必須
-
key
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key はプロジェクトのキーです。 |
|
| mode は任意: このファイルにアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| path はキーをマップするファイルの相対パスです。絶対的なパスではない可能性があります。パス要素 '..' を含めることはできません。文字列 '..' で始まらない場合があります。 |
8.1.457. .spec.volumes[].csi
- 説明
- csi (Container Storage Interface) は、特定の外部 CSI ドライバー (ベータ機能) によって処理される一時的なストレージを表します。
- 型
-
object
- 必須
-
driver
-
プロパティー | 型 | 説明 |
---|---|---|
|
| driver は、このボリュームを処理する CSI ドライバーの名前です。クラスターに登録されている正しい名前は、管理者に相談してください。 |
|
| マウントする fsType。例: "ext4"、"xfs"、"ntfs"。指定しない場合、空の値が関連する CSI ドライバーに渡され、適用するデフォルトのファイルシステムが決定されます。 |
|
| nodePublishSecretRef は、CSI NodePublishVolume および NodeUnpublishVolume 呼び出しを完了するために CSI ドライバーに渡す機密情報を含むシークレットオブジェクトへの参照です。このフィールドはオプションであり、シークレットが不要な場合は空の場合があります。シークレットオブジェクトに複数のシークレットが含まれている場合、すべてのシークレット参照が渡されます。 |
|
| readOnly は、ボリュームの読み取り専用設定を指定します。デフォルトは false (読み取り/書き込み) です。 |
|
| volumeAttributes は、CSI ドライバーに渡されるドライバー固有のプロパティーを格納します。サポートされている値は、ドライバーのドキュメントを参照してください。 |
8.1.458. .spec.volumes[].csi.nodePublishSecretRef
- 説明
- nodePublishSecretRef は、CSI NodePublishVolume および NodeUnpublishVolume 呼び出しを完了するために CSI ドライバーに渡す機密情報を含むシークレットオブジェクトへの参照です。このフィールドはオプションであり、シークレットが不要な場合は空の場合があります。シークレットオブジェクトに複数のシークレットが含まれている場合、すべてのシークレット参照が渡されます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
8.1.459. .spec.volumes[].downwardAPI
- 説明
- downwardAPI は、このボリュームに入力する必要がある Pod に関する Downward API を表します
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| オプション: デフォルトで作成されたファイルで使用するモードビット。オプション: デフォルトで作成されたファイルのパーミッションを設定するために使用されるモードビット。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。デフォルトは 0644 に設定されます。パス内のディレクトリーはこの設定の影響を受けません。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| items は、Downward API ボリュームファイルのリストです |
|
| DownwardAPIVolumeFile は、Pod フィールドを含むファイルを作成するための情報を表します |
8.1.460. .spec.volumes[].downwardAPI.items
- 説明
- items は、Downward API ボリュームファイルのリストです
- 型
-
array
8.1.461. .spec.volumes[].downwardAPI.items[]
- 説明
- DownwardAPIVolumeFile は、Pod フィールドを含むファイルを作成するための情報を表します
- 型
-
object
- 必須
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 必須: Pod のフィールドを選択します。アノテーション、ラベル、名前、namespace、および UID のみがサポートされています。 |
|
| オプション: このファイルの権限を設定するために使用されるモードビットは、0000 から 0777 までの 8 進数値、または 0 から 511 までの 10 進数値でなければなりません。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| 必須: パスは、作成するファイルの相対パス名です。絶対パスまたは '..' パスを含めることはできません。utf-8 でエンコードする必要があります。相対パスの最初の項目は '..' で始まってはなりません。 |
|
| コンテナーのリソースを選択します。現在、リソースの制限とリクエスト (limits.cpu、limits.memory、requests.cpu、requests.memory) のみがサポートされています。 |
8.1.462. .spec.volumes[].downwardAPI.items[].fieldRef
- 説明
- 必須: Pod のフィールドを選択します。アノテーション、ラベル、名前、namespace、および UID のみがサポートされています。
- 型
-
object
- 必須
-
fieldPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| FieldPath が記述されているスキーマのバージョン。デフォルトは "v1" です。 |
|
| 指定された API バージョンで選択するフィールドのパス。 |
8.1.463. .spec.volumes[].downwardAPI.items[].resourceFieldRef
- 説明
- コンテナーのリソースを選択します。現在、リソースの制限とリクエスト (limits.cpu、limits.memory、requests.cpu、requests.memory) のみがサポートされています。
- 型
-
object
- 必須
-
resource
-
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナー名: ボリュームには必須、env 変数にはオプション |
|
| 公開されたリソースの出力形式を指定します。デフォルトは "1" です。 |
|
| 必須: 選択するリソース |
8.1.464. .spec.volumes[].emptyDir
- 説明
- emptyDir は、Pod の存続期間を共有する一時ディレクトリーを表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#emptydir
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| medium は、このディレクトリーをバックアップする必要があるストレージメディアのタイプを表します。デフォルトは"" です。これは、ノードのデフォルトのメディアを使用することを意味します。空の文字列 (デフォルト) またはメモリーである必要があります。詳細: https://kubernetes.io/docs/concepts/storage/volumes#emptydir |
|
| sizeLimit は、この EmptyDir ボリュームに必要なローカルストレージの合計量です。サイズ制限はメモリーメディアにも適用されます。メモリーメディア EmptyDir での最大使用量は、ここで指定された SizeLimit と Pod 内のすべてのコンテナーのメモリー制限の合計との間の最小値になります。デフォルトは nil です。これは、制限が未定義であることを意味します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#emptydir |
8.1.465. .spec.volumes[].ephemeral
- 説明
ephemeral は、クラスターストレージドライバーによって処理されるボリュームを表します。ボリュームのライフサイクルは、ボリュームを定義する Pod に関連付けられています。ボリュームは、Pod が起動する前に作成され、Pod が削除されると削除されます。
これは、次の場合に使用します。a)Pod の実行中にのみボリュームが必要、b) スナップショットからの復元や容量追跡などの通常のボリュームの機能が必要、c) ストレージドライバーがストレージクラスを通じて指定される、d) ストレージドライバー PersistentVolumeClaim を介した動的ボリュームプロビジョニングをサポートします (このボリュームタイプと PersistentVolumeClaim の間の接続の詳細は、EphemeralVolumeSource を参照してください)。
個々の Pod のライフサイクルより長く持続するボリュームには、PersistentVolumeClaim またはベンダー固有の API の 1 つを使用します。
CSI ドライバーをそのように使用する場合は、軽量のローカルエフェメラルボリュームに CSI を使用します。詳細は、ドライバーのドキュメントを参照してください。
Pod は、両方のタイプのエフェメラルボリュームとパーシステントボリュームを同時に使用できます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
|
ボリュームをプロビジョニングするためのスタンドアロン PVC を作成するために使用されます。この EphemeralVolumeSource が埋め込まれている Pod が PVC の所有者になります。つまり、PVC は Pod と一緒に削除されます。PVC の名前は Pod が所有していないその名前の既存の PVC は、無関係なボリュームを誤って使用することを避けるために、Pod に使用され ません。Pod の起動は、無関係の PVC が削除されるまでブロックされます。そのような事前に作成された PVC が Pod で使用されることを意図している場合、Pod が存在すると、PVC は Pod への所有者参照で更新する必要があります。通常、これは必要ありませんが、壊れたクラスターを手動で再構築する場合に役立つことがあります。 このフィールドは読み取り専用であり、作成後に Kubernetes が PVC に変更を加えることはありません。 必須です。nil であってはなりません。 |
8.1.466. .spec.volumes[].ephemeral.volumeClaimTemplate
- 説明
ボリュームをプロビジョニングするためのスタンドアロン PVC を作成するために使用されます。この EphemeralVolumeSource が埋め込まれている Pod が PVC の所有者になります。つまり、PVC は Pod と一緒に削除されます。PVC の名前は
<pod name>-<volume name>
になります。ここで、<volume name>
はPodSpec.Volumes
アレイエントリーからの名前です。連結された名前が PVC に対して有効でない場合 (たとえば、長すぎる場合)、Pod 検証は Pod を拒否します。Pod が所有していないその名前の既存の PVC は、無関係なボリュームを誤って使用することを避けるために、Pod に使用され ません。Pod の起動は、無関係の PVC が削除されるまでブロックされます。そのような事前に作成された PVC が Pod で使用されることを意図している場合、Pod が存在すると、PVC は Pod への所有者参照で更新する必要があります。通常、これは必要ありませんが、壊れたクラスターを手動で再構築する場合に役立つことがあります。
このフィールドは読み取り専用であり、作成後に Kubernetes が PVC に変更を加えることはありません。
必須です。nil であってはなりません。
- 型
-
object
- 必須
-
spec
-
プロパティー | 型 | 説明 |
---|---|---|
|
| PVC の作成時に PVC にコピーされるラベルとアノテーションが含まれる場合があります。他のフィールドは許可されておらず、検証中に拒否されます。 |
|
| PersistentVolumeClaim の仕様。コンテンツ全体が、このテンプレートから作成された PVC に変更されずにコピーされます。PersistentVolumeClaim と同じフィールドがここでも有効です。 |
8.1.467. .spec.volumes[].ephemeral.volumeClaimTemplate.metadata
- 説明
- PVC の作成時に PVC にコピーされるラベルとアノテーションが含まれる場合があります。他のフィールドは許可されておらず、検証中に拒否されます。
- 型
-
object
8.1.468. .spec.volumes[].ephemeral.volumeClaimTemplate.spec
- 説明
- PersistentVolumeClaim の仕様。コンテンツ全体が、このテンプレートから作成された PVC に変更されずにコピーされます。PersistentVolumeClaim と同じフィールドがここでも有効です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| accessModes には、ボリュームに割り当てる必要のあるアクセスモードが含まれます。詳細は、https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 を参照してください。 |
|
| dataSource フィールドは、次のいずれかを指定するために使用できます。*既存の VolumeSnapshot オブジェクト (snapshot.storage.k8s.io/VolumeSnapshot)*既存の PVC(PersistentVolumeClaim) プロビジョナーまたは外部コントローラーが指定されたデータソースをサポートできる場合、指定されたデータソースのコンテンツに基づく新しいボリューム。AnyVolumeDataSource フィーチャーゲートが有効になっている場合、dataSource の内容は dataSourceRef にコピーされ、dataSourceRef.namespace が指定されていない場合に dataSourceRef コンテンツが dataSource にコピーされます。namespace が指定されている場合、dataSourceRef は dataSource にコピーされません。 |
|
| 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 フィーチャーゲートを有効にする必要があります。 |
|
| resources は、ボリュームに必要な最小リソースを表します。RecoverVolumeExpansionFailure 機能が有効になっている場合、ユーザーは以前の値よりも低いリソース要件を指定できますが、要求のステータスフィールドに記録された容量よりも大きい必要があります。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources |
|
| selector は、バインドを考慮するボリュームに対するラベルクエリーです。 |
|
| storageClassName は、要求に必要な StorageClass の名前です。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1 |
|
| volumeAttributesClassName は、このクレームで使用される VolumeAttributesClass を設定するために使用できます。指定すると、CSI ドライバーは、対応する VolumeAttributesClass で定義された属性を使用してボリュームを作成または更新します。これは storageClassName とは異なる目的があり、クレームの作成後に変更できます。空の文字列値は、クレームに VolumeAttributesClass が適用されないことを意味しますが、一度設定すると、このフィールドを空の文字列にリセットすることはできません。指定されておらず、PersistentVolumeClaim がバインドされていない場合は、永続ボリュームコントローラーが存在する場合は、デフォルトの VolumeAttributesClass が設定されます。volumeAttributesClass によって参照されるリソースが存在しない場合は、そのようなリソースが存在するまで、この PersistentVolumeClaim は、modifyVolumeStatus フィールドに反映されるように、保留状態に設定されます。詳細は、https://kubernetes.io/docs/concepts/storage/volume-attributes-classes/ (ベータ版) を参照してください。このフィールドを使用するには、VolumeAttributesClass フィーチャーゲートを有効にする必要があります (デフォルトではオフ)。 |
|
| volumeMode は、要求に必要なボリュームのタイプを定義します。Filesystem の値は、要求仕様に含まれていない場合に暗示されます。 |
|
| volumeName は、この要求をサポートする PersistentVolume へのバインディング参照です。 |
8.1.469. .spec.volumes[].ephemeral.volumeClaimTemplate.spec.dataSource
- 説明
- dataSource フィールドは、次のいずれかを指定するために使用できます。*既存の VolumeSnapshot オブジェクト (snapshot.storage.k8s.io/VolumeSnapshot)*既存の PVC(PersistentVolumeClaim) プロビジョナーまたは外部コントローラーが指定されたデータソースをサポートできる場合、指定されたデータソースのコンテンツに基づく新しいボリューム。AnyVolumeDataSource フィーチャーゲートが有効になっている場合、dataSource の内容は dataSourceRef にコピーされ、dataSourceRef.namespace が指定されていない場合に dataSourceRef コンテンツが dataSource にコピーされます。namespace が指定されている場合、dataSourceRef は dataSource にコピーされません。
- 型
-
object
- 必須
-
kind
-
name
-
プロパティー | 型 | 説明 |
---|---|---|
|
| APIGroup は参照されているリソースのグループです。APIGroup が指定されていない場合は、指定の Kind をコア API グループに設定する必要があります。他のサードパーティータイプには、APIGroup が必要です。 |
|
| kind は参照されているリソースのタイプです。 |
|
| name は、参照されているリソースの名前です。 |
8.1.470. .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 フィーチャーゲートを有効にする必要があります。 |
8.1.471. .spec.volumes[].ephemeral.volumeClaimTemplate.spec.resources
- 説明
- resources は、ボリュームに必要な最小リソースを表します。RecoverVolumeExpansionFailure 機能が有効になっている場合、ユーザーは以前の値よりも低いリソース要件を指定できますが、要求のステータスフィールドに記録された容量よりも大きい必要があります。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| limits は、許可されるコンピュートリソースの最大量を示します。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
|
| requests は、必要なコンピュートリソースの最小量を示します。コンテナーで Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。リクエストは制限を超えることはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。 |
8.1.472. .spec.volumes[].ephemeral.volumeClaimTemplate.spec.selector
- 説明
- selector は、バインドを考慮するボリュームに対するラベルクエリーです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。 |
8.1.473. .spec.volumes[].ephemeral.volumeClaimTemplate.spec.selector.matchExpressions
- 説明
- matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
- 型
-
array
8.1.474. .spec.volumes[].ephemeral.volumeClaimTemplate.spec.selector.matchExpressions[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.475. .spec.volumes[].fc
- 説明
- fc は、kubelet のホストマシンに接続されてから Pod に公開されるファイバーチャネルリソースを表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。 |
|
| LUN は任意: FC ターゲットの LUN 番号 |
|
| readOnly は任意: デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。 |
|
| targetWWNs は任意: FC ターゲットのワールドワイド名 (WWN) |
|
| wwids は任意: FC ボリュームのワールドワイド ID(wwids)wwids または targetWWN と lun の組み合わせのいずれかを設定する必要がありますが、両方を同時に設定できません。 |
8.1.476. .spec.volumes[].flexVolume
- 説明
- flexVolume は、exec ベースのプラグインを使用してプロビジョニング/接続される汎用ボリュームリソースを表します。
- 型
-
object
- 必須
-
driver
-
プロパティー | 型 | 説明 |
---|---|---|
|
| driver は、このボリュームに使用するドライバーの名前です。 |
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。デフォルトのファイルシステムは FlexVolume スクリプトに依存します。 |
|
| options は任意: このフィールドには追加のコマンドオプションがあれば保持されます。 |
|
| readOnly は任意: デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。 |
|
| secretRef は任意: secretRef は、プラグインスクリプトに渡す機密情報を含むシークレットオブジェクトへの参照です。シークレットオブジェクトが指定されていない場合、これは空になる可能性があります。シークレットオブジェクトに複数のシークレットが含まれている場合、すべてのシークレットがプラグインスクリプトに渡されます。 |
8.1.477. .spec.volumes[].flexVolume.secretRef
- 説明
- secretRef は任意: secretRef は、プラグインスクリプトに渡す機密情報を含むシークレットオブジェクトへの参照です。シークレットオブジェクトが指定されていない場合、これは空になる可能性があります。シークレットオブジェクトに複数のシークレットが含まれている場合、すべてのシークレットがプラグインスクリプトに渡されます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
8.1.478. .spec.volumes[].flocker
- 説明
- flocker は、kubelet のホストマシンに接続されている Flocker ボリュームを表します。これは、実行中の Flocker 制御サービスによって異なります
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
|
datasetName はメタデータとして保存されているデータセットの名前です |
|
| datasetUUID は、データセットの UUID です。これは Flocker データセットの一意の識別子です |
8.1.479. .spec.volumes[].gcePersistentDisk
- 説明
- gcePersistentDisk は、kubelet のホストマシンに接続されてから Pod に公開される GCE ディスクリソースを表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk
- 型
-
object
- 必須
-
pdName
-
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするボリュームのファイルシステムタイプです。ヒント: ファイルシステムタイプがホストオペレーティングシステムでサポートされていることを確認してください。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
| partition は、マウントするボリューム内のパーティションです。省略した場合、デフォルトではボリューム名でマウントします。例: ボリューム/dev/sda1 の場合、パーティションを "1" として指定します。同様に、/dev/sda のボリュームパーティションは "0" です (または、プロパティーを空のままにしておくこともできます)。詳細: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
| pdName は、GCE の PD リソースの一意の名前です。GCE でディスクを識別するために使用されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
| この readOnly は、VolumeMounts で ReadOnly 設定が強制的に指定されます。デフォルトは false です。詳細: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
8.1.480. .spec.volumes[].gitRepo
- 説明
- gitRepo は、特定のリビジョンの git リポジトリーを表します。非推奨:GitRepo は非推奨です。git レポジトリを使用してコンテナーをプロビジョニングするには、Git を使用してレポジトリのクローンを作成する InitContainer に EmptyDir をマウントしてから、Pod のコンテナーに EmptyDir をマウントします。
- 型
-
object
- 必須
-
repository
-
プロパティー | 型 | 説明 |
---|---|---|
|
| directory は、ターゲットディレクトリー名です。'..' を含まない、または..で始まらないようにする必要があります。もしも '。' が提供されている場合、ボリュームディレクトリーは git リポジトリーになります。それ以外の場合、指定されている場合、ボリュームには、指定された名前のサブディレクトリーに git リポジトリーが含まれます。 |
|
| repository は URL です。 |
|
| revision は、指定されたリビジョンのコミットハッシュです。 |
8.1.481. .spec.volumes[].glusterfs
- 説明
- glusterfs は、Pod の存続期間を共有するホスト上の Glusterfs マウントを表します。詳細: https://examples.k8s.io/volumes/glusterfs/README.md
- 型
-
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 |
8.1.482. .spec.volumes[].hostPath
- 説明
- hostPath は、コンテナーに直接公開されているホストマシン上の既存のファイルまたはディレクトリーを表します。これは通常、ホストマシンの表示を許可されているシステムエージェントまたはその他の特権的なものに使用されます。ほとんどのコンテナーはこれを必要としません。詳細: https://kubernetes.io/docs/concepts/storage/volumes#hostpath
- 型
-
object
- 必須
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ホスト上のディレクトリーのパス。パスがシンボリックリンクの場合、実際のパスへのリンクをたどります。詳細: https://kubernetes.io/docs/concepts/storage/volumes#hostpath |
|
| HostPath ボリュームのデフォルトのタイプは "" です。詳細: https://kubernetes.io/docs/concepts/storage/volumes#hostpath |
8.1.483. .spec.volumes[].image
- 説明
image は、kubelet のホストマシンにプルおよびマウントされた OCI オブジェクト (コンテナーイメージまたはアーティファクト) を表します。ボリュームは、提供される PullPolicy 値に応じて Pod の起動時に解決されます。
- Always: kubelet は常に参照をプルしようとします。プルに失敗すると、コンテナーの作成は失敗します。
- Never: kubelet は参照をプルせず、ローカルイメージまたはアーティファクトのみを使用します。参照が存在しない場合は、コンテナーの作成に失敗します。
- IfNotPresent: 参照がディスクに存在しない場合は、kubelet がプルします。参照が存在しず、プルが失敗すると、コンテナーの作成は失敗します。
Pod が削除されて再作成されるとボリュームが再度解決され、Pod の再作成時に新しいリモートコンテンツが利用可能になります。Pod の起動中にイメージを解決またはプルできない場合、コンテナーの起動がブロックされ、大幅な遅延が発生する可能性があります。失敗した場合は通常のボリュームバックオフを使用して再試行され、理由とメッセージが Pod で報告されます。このボリュームによってマウントされる可能性のあるオブジェクトのタイプは、ホストマシン上のコンテナーランタイム実装によって定義され、少なくともコンテナーイメージフィールドでサポートされているすべての有効なタイプが含まれている必要があります。OCI オブジェクトは、コンテナーイメージの場合と同じ方法でマニフェストレイヤーをマージすることで、単一ディレクトリー (spec.containers[].volumeMounts.mountPath) にマウントされます。ボリュームは、読み取り専用 (ro) および実行不可ファイル (noexec) としてマウントされます。コンテナーのサブパスマウントはサポートされていません (spec.containers[].volumeMounts.subpath)。spec.securityContext.fsGroupChangePolicy フィールドは、このボリュームタイプには影響しません。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| OCI オブジェクトをプルするためのポリシー。使用できる値: Always: kubelet は常に参照のプルを試行します。プルに失敗すると、コンテナーの作成は失敗します。Never: kubelet は参照をプルせず、ローカルイメージまたはアーティファクトのみを使用します。参照が存在しない場合は、コンテナーの作成に失敗します。IfNotPresent: 参照がディスクに存在しない場合は、kubelet がプルします。参照が存在しず、プルが失敗すると、コンテナーの作成は失敗します。デフォルトは、:latest タグが指定されている場合は常に、それ以外の場合は IfNotPresent です。 |
|
| 必須: 使用するイメージまたはアーティファクトの参照。pod.spec.containers[*].image と同じように動作します。プルシークレットは、ノード認証情報、SA イメージプルシークレット、および Pod 仕様イメージプルシークレットを検索することで、コンテナーイメージの場合と同じ方法でアセンブルされます。詳細: https://kubernetes.io/docs/concepts/containers/images このフィールドはオプションであり、高レベルの設定管理で、Deployments や StatefulSets などのワークロードコントローラーのコンテナーイメージをデフォルトまたはオーバーライドできます。 |
8.1.484. .spec.volumes[].iscsi
- 説明
- iscsi は、kubelet のホストマシンに接続されてから Pod に公開される ISCSI ディスクリソースを表します。詳細: https://examples.k8s.io/volumes/iscsi/README.md
- 型
-
object
- 必須
-
iqn
-
lun
-
targetPortal
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 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 です。 |
|
| secretRef は、iSCSI ターゲットおよびイニシエーター認証用の CHAP Secret です。 |
|
| targetPortal は iSCSI Target Portal です。ポートがデフォルト以外の場合、ポータルは IP または ip_addr:port のいずれかです (通常は TCP ポート 860 および 3260)。 |
8.1.485. .spec.volumes[].iscsi.secretRef
- 説明
- secretRef は、iSCSI ターゲットおよびイニシエーター認証用の CHAP Secret です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
8.1.486. .spec.volumes[].nfs
- 説明
- NFS は、Pod の有効期間を共有するホスト上の NFS マウントを表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#nfs
- 型
-
object
- 必須
-
path
-
server
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 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 |
8.1.487. .spec.volumes[].persistentVolumeClaim
- 説明
- persistentVolumeClaimVolumeSource は、同じ namespace 内の PersistentVolumeClaim への参照を表します。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims
- 型
-
object
- 必須
-
claimName
-
プロパティー | 型 | 説明 |
---|---|---|
|
| claimName は、このボリュームを使用する Pod と同じ namespace にある PersistentVolumeClaim の名前です。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims |
|
| readOnly は、VolumeMounts の ReadOnly 設定が強制的に指定されます。デフォルト: false |
8.1.488. .spec.volumes[].photonPersistentDisk
- 説明
- photonPersistentDisk は、kubelets ホストマシンに接続されマウントされた PhotonController 永続ディスクを表します。
- 型
-
object
- 必須
-
pdID
-
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。 |
|
| pdID は、Photon Controller の永続ディスクを識別する ID です。 |
8.1.489. .spec.volumes[].portworxVolume
- 説明
- portworxVolume は、kubelet ホストマシンに接続およびマウントされた portworx ボリュームを表します。
- 型
-
object
- 必須
-
volumeID
-
プロパティー | 型 | 説明 |
---|---|---|
|
| fSType は、マウントするファイルシステムタイプを表します。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。 |
|
| readOnly のデフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。 |
|
| volumeID は、Portworx ボリュームを一意に識別します |
8.1.490. .spec.volumes[].projected
- 説明
- オールインワンリソースシークレット、configmaps、および Downward API のアイテム
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| defaultMode は、作成されたファイルにデフォルトでアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。パス内のディレクトリーはこの設定の影響を受けません。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| sources は、ボリュームプロジェクションのリストです。このリストの各エントリーは 1 つのソースを処理します。 |
|
| サポートされている他のボリュームタイプと一緒にデプロイメントされる可能性のあるプロジェクションこれらのフィールドのいずれかを設定する必要があります。 |
8.1.491. .spec.volumes[].projected.sources
- 説明
- sources は、ボリュームプロジェクションのリストです。このリストの各エントリーは 1 つのソースを処理します。
- 型
-
array
8.1.492. .spec.volumes[].projected.sources[]
- 説明
- サポートされている他のボリュームタイプと一緒にデプロイメントされる可能性のあるプロジェクションこれらのフィールドのいずれかを設定する必要があります。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
|
ClusterTrustBundle を使用すると、Pod が自動更新ファイル内の ClusterTrustBundle オブジェクトの アルファ段階。ClusterTrustBundleProjection フィーチャーゲートによってゲートされます。 ClusterTrustBundle オブジェクトは、名前で選択することも、署名者名とラベルセレクターの組み合わせで選択することもできます。 Kubelet は、Pod ファイルシステムに書き込まれた PEM コンテンツの積極的な正規化を実行します。ブロック間コメントやブロックヘッダーなどの難解な PEM 機能は削除されます。証明書は重複排除されます。ファイル内の証明書の順序は任意です。Kubelet は時間の経過に伴い順序を変更する可能性があります。 |
|
| プロジェクトへの configMap データの onfigMap 情報 |
|
| downwardAPI データのプロジェクトへの downwardAPI 情報 |
|
| 投影するシークレットデータに関する情報 |
|
| serviceAccountToken は、投影する serviceAccountToken データに関する情報です。 |
8.1.493. .spec.volumes[].projected.sources[].clusterTrustBundle
- 説明
ClusterTrustBundle を使用すると、Pod が自動更新ファイル内の ClusterTrustBundle オブジェクトの
.spec.trustBundle
フィールドにアクセスできるようになります。アルファ段階。ClusterTrustBundleProjection フィーチャーゲートによってゲートされます。
ClusterTrustBundle オブジェクトは、名前で選択することも、署名者名とラベルセレクターの組み合わせで選択することもできます。
Kubelet は、Pod ファイルシステムに書き込まれた PEM コンテンツの積極的な正規化を実行します。ブロック間コメントやブロックヘッダーなどの難解な PEM 機能は削除されます。証明書は重複排除されます。ファイル内の証明書の順序は任意です。Kubelet は時間の経過に伴い順序を変更する可能性があります。
- 型
-
object
- 必須
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| このラベルセレクターに一致するすべての ClusterTrustBundle を選択します。signerName が設定されている場合にのみ有効です。名前と相互に排他的です。設定されていない場合は、"何も一致しない" と解釈されます。設定されているが空の場合は、"すべてに一致する" と解釈されます。 |
|
| オブジェクト名で単一の ClusterTrustBundle を選択します。signerName および labelSelector とは相互に排他的です。 |
|
| true の場合で、参照された ClusterTrustBundle が利用できない場合は、Pod の起動をブロックしないでください。名前を使用する場合、名前付き ClusterTrustBundle が存在しないことが許可されます。signerName を使用する場合、signerName と labelSelector の組み合わせは、0 個の ClusterTrustBundles と一致できます。 |
|
| バンドルを書き込むためのボリュームルートからの相対パス。 |
|
| この署名者名に一致するすべての ClusterTrustBundle を選択します。名前と相互に排他的です。選択されたすべての ClusterTrustBundle の内容が統合され、重複が排除されます。 |
8.1.494. .spec.volumes[].projected.sources[].clusterTrustBundle.labelSelector
- 説明
- このラベルセレクターに一致するすべての ClusterTrustBundle を選択します。signerName が設定されている場合にのみ有効です。名前と相互に排他的です。設定されていない場合は、"何も一致しない" と解釈されます。設定されているが空の場合は、"すべてに一致する" と解釈されます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。 |
8.1.495. .spec.volumes[].projected.sources[].clusterTrustBundle.labelSelector.matchExpressions
- 説明
- matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
- 型
-
array
8.1.496. .spec.volumes[].projected.sources[].clusterTrustBundle.labelSelector.matchExpressions[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.497. .spec.volumes[].projected.sources[].configMap
- 説明
- プロジェクトへの configMap データの onfigMap 情報
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| item が指定されていない場合、参照される ConfigMap の Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。ConfigMap に存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。 |
|
| 文字列キーをボリューム内のパスにマップします。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 任意。ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
8.1.498. .spec.volumes[].projected.sources[].configMap.items
- 説明
- item が指定されていない場合、参照される ConfigMap の Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。ConfigMap に存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。
- 型
-
array
8.1.499. .spec.volumes[].projected.sources[].configMap.items[]
- 説明
- 文字列キーをボリューム内のパスにマップします。
- 型
-
object
- 必須
-
key
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key はプロジェクトのキーです。 |
|
| mode は任意: このファイルにアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| path はキーをマップするファイルの相対パスです。絶対的なパスではない可能性があります。パス要素 '..' を含めることはできません。文字列 '..' で始まらない場合があります。 |
8.1.500. .spec.volumes[].projected.sources[].downwardAPI
- 説明
- downwardAPI データのプロジェクトへの downwardAPI 情報
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Items は DownwardAPIVolume ファイルのリストです |
|
| DownwardAPIVolumeFile は、Pod フィールドを含むファイルを作成するための情報を表します |
8.1.501. .spec.volumes[].projected.sources[].downwardAPI.items
- 説明
- Items は DownwardAPIVolume ファイルのリストです
- 型
-
array
8.1.502. .spec.volumes[].projected.sources[].downwardAPI.items[]
- 説明
- DownwardAPIVolumeFile は、Pod フィールドを含むファイルを作成するための情報を表します
- 型
-
object
- 必須
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 必須: Pod のフィールドを選択します。アノテーション、ラベル、名前、namespace、および UID のみがサポートされています。 |
|
| オプション: このファイルの権限を設定するために使用されるモードビットは、0000 から 0777 までの 8 進数値、または 0 から 511 までの 10 進数値でなければなりません。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| 必須: パスは、作成するファイルの相対パス名です。絶対パスまたは '..' パスを含めることはできません。utf-8 でエンコードする必要があります。相対パスの最初の項目は '..' で始まってはなりません。 |
|
| コンテナーのリソースを選択します。現在、リソースの制限とリクエスト (limits.cpu、limits.memory、requests.cpu、requests.memory) のみがサポートされています。 |
8.1.503. .spec.volumes[].projected.sources[].downwardAPI.items[].fieldRef
- 説明
- 必須: Pod のフィールドを選択します。アノテーション、ラベル、名前、namespace、および UID のみがサポートされています。
- 型
-
object
- 必須
-
fieldPath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| FieldPath が記述されているスキーマのバージョン。デフォルトは "v1" です。 |
|
| 指定された API バージョンで選択するフィールドのパス。 |
8.1.504. .spec.volumes[].projected.sources[].downwardAPI.items[].resourceFieldRef
- 説明
- コンテナーのリソースを選択します。現在、リソースの制限とリクエスト (limits.cpu、limits.memory、requests.cpu、requests.memory) のみがサポートされています。
- 型
-
object
- 必須
-
resource
-
プロパティー | 型 | 説明 |
---|---|---|
|
| コンテナー名: ボリュームには必須、env 変数にはオプション |
|
| 公開されたリソースの出力形式を指定します。デフォルトは "1" です。 |
|
| 必須: 選択するリソース |
8.1.505. .spec.volumes[].projected.sources[].secret
- 説明
- 投影するシークレットデータに関する情報
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| items が指定されていない場合、参照されるシークレットの Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。シークレットに存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。 |
|
| 文字列キーをボリューム内のパスにマップします。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| オプションフィールドは、シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.506. .spec.volumes[].projected.sources[].secret.items
- 説明
- items が指定されていない場合、参照されるシークレットの Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。シークレットに存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。
- 型
-
array
8.1.507. .spec.volumes[].projected.sources[].secret.items[]
- 説明
- 文字列キーをボリューム内のパスにマップします。
- 型
-
object
- 必須
-
key
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key はプロジェクトのキーです。 |
|
| mode は任意: このファイルにアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| path はキーをマップするファイルの相対パスです。絶対的なパスではない可能性があります。パス要素 '..' を含めることはできません。文字列 '..' で始まらない場合があります。 |
8.1.508. .spec.volumes[].projected.sources[].serviceAccountToken
- 説明
- serviceAccountToken は、投影する serviceAccountToken データに関する情報です。
- 型
-
object
- 必須
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| audience は、トークンの対象オーディエンスです。トークンの受信者は、トークンのオーディエンスで指定された識別子で自分自身を識別する必要があります。そうでない場合は、トークンを拒否する必要があります。対象はデフォルトで API サーバーの識別子に設定されます。 |
|
| expirationSeconds は、サービスアカウントトークンの要求された有効期間です。トークンの有効期限が近づくと、kubelet ボリュームプラグインはサービスアカウントトークンをプロアクティブにローテーションします。トークンが存続時間の 80% より古い場合、またはトークンが 24 時間より古い場合、kubelet はトークンのローテーションを開始します。デフォルトは 1 時間で、少なくとも 10 分である必要があります。 |
|
| path は、トークンのデプロイメント先となるファイルのマウントポイントに対する相対パスです。 |
8.1.509. .spec.volumes[].quobyte
- 説明
- quobyte は、Pod の有効期限を共有するホストでの Quobyte マウントを表します
- 型
-
object
- 必須
-
registry
-
volume
-
プロパティー | 型 | 説明 |
---|---|---|
|
| アクセスできるボリュームをマップするグループ。デフォルトは no group です。 |
|
| ここでの readOnly は、Quobyte ボリュームを読み取り専用のアクセス権限で強制的にマウントします。デフォルトは false です。 |
|
| registry は、host:port ペアの文字列として指定された単一または複数の Quobyte Registry サービスを表し (複数のエントリーはコンマで区切る)、ボリュームの中央レジストリーとして機能します。 |
|
| 動的にプロビジョニングされた Quobyte ボリュームで使用されるバックエンドで指定の Quobyte ボリュームを所有するテナント。値はプラグインにより設定されます。 |
|
| アクセスできるボリュームをマップするグループ。デフォルトは serivceaccount user です。 |
|
| volume は、すでに作成されているクオバイトボリュームを名前で参照する文字列です。 |
8.1.510. .spec.volumes[].rbd
- 説明
- rbd は、Pod の有効期間を共有するホストの Rados ブロックデバイスマウントを表します。詳細: https://examples.k8s.io/volumes/rbd/README.md
- 型
-
object
- 必須
-
image
-
monitors
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 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 |
|
| secretRef は、RBDUser の認証シークレットの名前です。提供されている場合、キーリングをオーバーライドします。デフォルトは nil です。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| user は rados ユーザー名です。これにより、プール内にイメージを作成できます。デフォルトは admin です。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
8.1.511. .spec.volumes[].rbd.secretRef
- 説明
- secretRef は、RBDUser の認証シークレットの名前です。提供されている場合、キーリングをオーバーライドします。デフォルトは nil です。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
8.1.512. .spec.volumes[].scaleIO
- 説明
- scaleIO は、Kubernetes ノードに接続およびマウントされた ScaleIO 永続ボリュームを表します。
- 型
-
object
- 必須
-
gateway
-
secretRef
-
system
-
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。デフォルトは "xfs" です。 |
|
| gateway は、ScaleIO API ゲートウェイのホストアドレスです。 |
|
| protectionDomain は、設定されたストレージの ScaleIO 保護ドメインの名前です。 |
|
| readOnly。デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。 |
|
| secretRef は、ScaleIO ユーザーおよびその他の機密情報の秘密を参照します。これが指定されていない場合、ログイン操作は失敗します。 |
|
| sslEnabled Flag は、ゲートウェイとの SSL 通信を有効/無効にします。デフォルトは false です |
|
| storageMode は、ボリュームのストレージを ThickProvisioned にするか ThinProvisioned にするかを示します。デフォルトは ThinProvisioned です。 |
|
| storagePool は、保護ドメインに関連付けられた ScaleIO ストレージプールです。 |
|
| system は、ScaleIO で設定されたストレージシステムの名前です。 |
|
| volumeName は、このボリュームソースに関連付けられている、ScaleIO システムですでに作成されているボリュームの名前です。 |
8.1.513. .spec.volumes[].scaleIO.secretRef
- 説明
- secretRef は、ScaleIO ユーザーおよびその他の機密情報の秘密を参照します。これが指定されていない場合、ログイン操作は失敗します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
8.1.514. .spec.volumes[].secret
- 説明
- secret は、このボリュームに入力する必要がある Secret を表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#secret
- 型
-
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 |
8.1.515. .spec.volumes[].secret.items
- 説明
- items が指定されていない場合、参照されるシークレットの Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。シークレットに存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。
- 型
-
array
8.1.516. .spec.volumes[].secret.items[]
- 説明
- 文字列キーをボリューム内のパスにマップします。
- 型
-
object
- 必須
-
key
-
path
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key はプロジェクトのキーです。 |
|
| mode は任意: このファイルにアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。 |
|
| path はキーをマップするファイルの相対パスです。絶対的なパスではない可能性があります。パス要素 '..' を含めることはできません。文字列 '..' で始まらない場合があります。 |
8.1.517. .spec.volumes[].storageos
- 説明
- storageOS は、Kubernetes ノードに接続およびマウントされた StorageOS ボリュームを表します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。 |
|
| readOnly のデフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。 |
|
| secretRef は、StorageOS API クレデンシャルを取得するために使用するシークレットを指定します。指定しない場合、デフォルト値が試行されます。 |
|
| volumeName は、人間が判読えきる形式の StorageOS ボリュームの名前です。ボリューム名は namespace 内でのみ一意です。 |
|
| volumeNamespace は、StorageOS 内のボリュームのスコープを指定します。namespace が指定されていない場合は、Pod の namespace が使用されます。これにより、Kubernetes の名前スコープを StorageOS 内にミラーリングして、より緊密に統合することができます。VolumeName を任意の名前に設定して、デフォルトの動作をオーバーライドします。StorageOS 内で namespace を使用していない場合は、"デフォルト" に設定します。StorageOS 内に存在しない namespace が作成されます。 |
8.1.518. .spec.volumes[].storageos.secretRef
- 説明
- secretRef は、StorageOS API クレデンシャルを取得するために使用するシークレットを指定します。指定しない場合、デフォルト値が試行されます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
8.1.519. .spec.volumes[].vsphereVolume
- 説明
- vsphereVolume は、kubelet ホストマシンに接続およびマウントされた vSphere ボリュームを表します。
- 型
-
object
- 必須
-
volumePath
-
プロパティー | 型 | 説明 |
---|---|---|
|
| fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。 |
|
| storagePolicyID は、StoragePolicyName に関連付けられたストレージポリシーベースの管理 (SPBM) プロファイル ID です。 |
|
| storagePolicyName は、ストレージポリシーベースの管理 (SPBM) プロファイル名です。 |
|
| volumePath は、vSphere ボリューム vmdk を識別するパスです。 |
8.1.520. .spec.web
- 説明
- Prometheus Web サーバーの設定を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Web サーバーの HTTP パラメーターを定義します。 |
|
| 同時接続の最大数を定義します。値がゼロの場合、Prometheus は着信接続を一切受け入れません。 |
|
| Prometheus の Web ページのタイトル。 |
|
| HTTPS の TLS パラメーターを定義します。 |
8.1.521. .spec.web.httpConfig
- 説明
- Web サーバーの HTTP パラメーターを定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| HTTP 応答に追加できるヘッダーのリスト。 |
|
| HTTP/2 サポートを有効にします。HTTP/2 は TLS でのみサポートされることに注意してください。TLSConfig が設定されていない場合、HTTP/2 は無効になります。フィールドの値が変わるたびに、ローリング更新がトリガーされます。 |
8.1.522. .spec.web.httpConfig.headers
- 説明
- HTTP 応答に追加できるヘッダーのリスト。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| HTTP 応答に Content-Security-Policy ヘッダーを設定します。空白の場合は設定しません。 |
|
| HTTP 応答に Strict-Transport-Security ヘッダーを設定します。空白の場合は設定しません。このヘッダーは、ブラウザーは同じドメインとサブドメインでホストされている Prometheus やその他のアプリケーションを HTTPS 経由で読み込むよう強制する可能性があるため、注意して使用してください。https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Strict-Transport-Security |
|
| X-Content-Type-Options ヘッダーを HTTP 応答に設定します。空白の場合は設定しません。許可される値は nosniff です。https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Content-Type-Options |
|
| X-Frame-Options ヘッダーを HTTP 応答に設定します。空白の場合は設定しません。許可される値は、deny と sameorigin です。https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Frame-Options |
|
| すべての応答に X-XSS-Protection ヘッダーを設定します。空白の場合は設定しません。https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-XSS-Protection |
8.1.523. .spec.web.tlsConfig
- 説明
- HTTPS の TLS パラメーターを定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| サーバーの TLS 証明書が含まれています。 |
|
|
サーバーの Prometheus コンテナー内にある TLS 証明書ファイルへのパス。 |
|
| TLS1.2 までの TLS バージョンでサポートされている暗号スイートのリスト。空の場合、Go のデフォルトの暗号スイートが使用されます。利用可能な暗号スイートは、go のドキュメントに記載されています: https://golang.org/pkg/crypto/tls/#pkg-constants |
|
| クライアント認証のサーバーポリシー。ClientAuth ポリシーにマップします。clientAuth オプションの詳細については、https://golang.org/pkg/crypto/tls/#ClientAuthType をご覧ください。 |
|
|
サーバーに対するクライアント証明書認証用の CA 証明書ファイルへのパス。 |
|
| サーバーへのクライアント証明書認証用の CA 証明書が含まれています。 |
|
| ECDHE ハンドシェイクで使用される楕円曲線を優先順に使用します。利用可能な曲線は、go のドキュメントに記載されています: https://golang.org/pkg/crypto/tls/#CurveID |
|
|
サーバーの Prometheus コンテナー内にある TLS 鍵ファイルへのパス。 |
|
| サーバーの TLS キーを含むシークレット。 |
|
| 許容可能な最大 TLS バージョン。デフォルトは TLS13 です。 |
|
| 許容可能な最小 TLS バージョン。デフォルトは TLS12 です。 |
|
| サーバーがクライアントの最も優先される暗号スイートを選択するか、サーバーの最も優先される暗号スイートを選択するかを制御します。true の場合、cipherSuites の要素の順序で表されるサーバーの設定が使用されます。 |
8.1.524. .spec.web.tlsConfig.cert
- 説明
- サーバーの TLS 証明書が含まれています。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用するデータを含む ConfigMap。 |
|
| ターゲットに使用するデータを含むシークレット。 |
8.1.525. .spec.web.tlsConfig.cert.configMap
- 説明
- ターゲットに使用するデータを含む ConfigMap。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
8.1.526. .spec.web.tlsConfig.cert.secret
- 説明
- ターゲットに使用するデータを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.527. .spec.web.tlsConfig.client_ca
- 説明
- サーバーへのクライアント証明書認証用の CA 証明書が含まれています。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用するデータを含む ConfigMap。 |
|
| ターゲットに使用するデータを含むシークレット。 |
8.1.528. .spec.web.tlsConfig.client_ca.configMap
- 説明
- ターゲットに使用するデータを含む ConfigMap。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
8.1.529. .spec.web.tlsConfig.client_ca.secret
- 説明
- ターゲットに使用するデータを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.530. .spec.web.tlsConfig.keySecret
- 説明
- サーバーの TLS キーを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
8.1.531. .status
- 説明
- Prometheus クラスターの最新の観測ステータス。read-only詳細: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
- 型
-
object
- 必須
-
availableReplicas
-
paused
-
replicas
-
unavailableReplicas
-
updatedReplicas
-
プロパティー | 型 | 説明 |
---|---|---|
|
| この Prometheus デプロイメントの対象となる利用可能な Pod の総数 (少なくとも minReadySeconds の準備ができています)。 |
|
| Prometheus デプロイメントの現在の状態。 |
|
| Condition は、Prometheus、Alertmanager、または ThanosRuler リソースに関連付けられているリソースの状態を表します。 |
|
| 基になるマネージドオブジェクトに対してアクションが実行されているかどうかを表します。削除アクションのみが実行されます。 |
|
| この Prometheus デプロイメントの対象となる非終了 Pod の総数 (ラベルはセレクターと一致します)。 |
|
| この Prometheus リソースのターゲットとなる Pod を一致させるために使用されるセレクター。 |
|
| リストにはシャードごとに 1 つのエントリーがあります。各エントリーには、シャードのステータスの概要が示されます。 |
|
| |
|
| shards は、観測された最も新しいシャード数です。 |
|
| この Prometheus デプロイメントの対象となる使用できない Pod の総数。 |
|
| この Prometheus デプロイメントの対象であり、目的のバージョン仕様を持つ、終了していない Pod の総数。 |
8.1.532. .status.conditions
- 説明
- Prometheus デプロイメントの現在の状態。
- 型
-
array
8.1.533. .status.conditions[]
- 説明
- Condition は、Prometheus、Alertmanager、または ThanosRuler リソースに関連付けられているリソースの状態を表します。
- 型
-
object
- 必須
-
lastTransitionTime
-
status
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| lastTransitionTime は、現在のステータスプロパティーが最後に更新された時刻です。 |
|
| 条件の最後の遷移の詳細を示す、人間が判読できるメッセージ。 |
|
|
observedGeneration は、それをベースに条件が設定された .metadata.generation を表します。たとえば、 |
|
| 条件の最後の遷移の理由。 |
|
| 条件のステータス。 |
|
| 報告される条件のタイプ。 |
8.1.534. .status.shardStatuses
- 説明
- リストにはシャードごとに 1 つのエントリーがあります。各エントリーには、シャードのステータスの概要が示されます。
- 型
-
array
8.1.535. .status.shardStatuses[]
- 説明
- 型
-
object
- 必須
-
availableReplicas
-
replicas
-
shardID
-
unavailableReplicas
-
updatedReplicas
-
プロパティー | 型 | 説明 |
---|---|---|
|
| このシャードのターゲットとなる利用可能な (準備完了となってから少なくとも minReadySeconds が経過している) Pod の総数。 |
|
| このシャードがターゲットとする Pod の総数。 |
|
| シャードの識別子。 |
|
| このシャードがターゲットとする、使用できない Pod の総数。 |
|
| このシャードがターゲットとする、期待される仕様を持つ終了していない Pod の総数。 |