第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 インスタンスに関連付ける ServiceMonitorPodMonitorProbe、および PrometheusRule オブジェクトを定義します。

Operator はスクレイピングとルールの設定を継続的に調整します。Prometheus Pod で実行されるサイドカーコンテナーが、必要に応じて設定の再読み込みをトリガーします。

object
必須
  • spec

8.1. 仕様

プロパティー説明

apiVersion

string

apiVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。

kind

string

kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できる場合があります。これは更新できません。CamelCase を使用します。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。

metadata

ObjectMeta

標準オブジェクトのメタデータ。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。

spec

object

Prometheus クラスターの望ましい動作の仕様。詳細: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

status

object

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

object

AdditionalAlertManagerConfigs は、追加の Prometheus Alertmanager 設定を含む Secret のキーを指定します。Alertmanager 設定は、Prometheus Operator によって生成された設定に追加されます。これらは、Prometheus の公式ドキュメントに従ってフォーマットする必要があります。

https://prometheus.io/docs/prometheus/latest/configuration/configuration/#alertmanager_config

ユーザーは、設定が有効であることを確認する責任があります

この機能を使用すると、Prometheus のアップグレードが中断される可能性があることに注意してください。アップグレード後に互換性のない AlertManager 設定が Prometheus を壊さないように、Prometheus リリースノートを確認することを推奨します。

additionalAlertRelabelConfigs

object

additionalAlertRelabelConfigs は、追加の Prometheus アラートのラベル再設定の設定を含む Secret のキーを指定します。アラートのラベル再設定の設定は、Prometheus Operator によって生成された設定に追加されます。これらは、Prometheus の公式ドキュメントに従ってフォーマットする必要があります。

https://prometheus.io/docs/prometheus/latest/configuration/configuration/#alert_relabel_configs

ユーザーは、設定が有効であることを確認する責任があります

この機能を使用すると、Prometheus のアップグレードが中断される可能性があることに注意してください。Prometheus のリリースノートを確認して、アップグレード後に互換性のないアラートのラベル変更設定によって Prometheus が破損しないようにすることを推奨します。

additionalArgs

array

additionalArgs を使用すると、'prometheus' コンテナーに追加の引数を設定できます。

これは、専用の設定オプションではまだサポートされていない隠しフラグを有効にする場合などに使用されます。引数はそのまま Prometheus コンテナーに渡されますが、引数が無効であったり、指定された Prometheus バージョンでサポートされていない場合は問題が発生する可能性があります。

引数が競合する場合 (たとえば、Operator によってすでに設定されている引数)、または無効な引数を指定すると、調整は失敗し、エラーが記録されます。

additionalArgs[]

object

AdditionalArgs リストの一部である引数。

additionalScrapeConfigs

object

AdditionalScrapeConfigs を使用すると、追加の Prometheus スクレイプ設定を含むシークレットのキーを指定できます。指定されたスクレープ設定は、Prometheus Operator によって生成された設定に追加されます。指定するジョブ設定は、Prometheus の公式ドキュメント https://prometheus.io/docs/prometheus/latest/configuration/configuration/#scrape_config で指定されている形式である必要があります。スクレイプ設定が追加されると、ユーザーはそれが有効であることを確認する責任があります。この機能を使用すると、Prometheus のアップグレードが中断される可能性があることに注意してください。アップグレード後に互換性のないスクレイプ設定が Prometheus を壊さないように、Prometheus リリースノートを確認することを推奨します。

affinity

object

指定されている場合、Pod のアフィニティースケジューリングルールを定義します。

alerting

object

Alertmanager に関連する設定を定義します。

allowOverlappingBlocks

boolean

AllowOverlappingBlocks は、Prometheus での垂直圧縮と垂直クエリーマージを有効にします。

非推奨: このフラグは、重複ブロックがデフォルトで有効になっている Prometheus 2.39.0 以降では効果がありません。

apiserverConfig

object

APIServerConfig を使用すると、Kuberntees API サーバーにアクセスするためのホストと認証方法を指定できます。null の場合、Prometheus はクラスター内で実行されると想定され、API サーバーが自動的に検出され、Pod の CA 証明書とベアラートークンファイル (/var/run/secrets/kubernetes.io/serviceaccount/) が使用されます。

arbitraryFSAccessThroughSMs

object

true の場合、ServiceMonitor、PodMonitor、および Probe オブジェクトは、'Prometheus' コンテナーのファイルシステム上の任意のファイルを参照することが禁止されます。ServiceMonitor のエンドポイントが bearerTokenFile 値 (例: '/var/run/secrets/kubernetes.io/serviceaccount/token') を指定すると、悪意のあるターゲットは Prometheus のスクレイプ要求内の Prometheus サービスアカウントのトークンにアクセスできるようになります。spec.arbitraryFSAccessThroughSM を 'true' に設定すると、攻撃を防ぐことができます。代わりに、ユーザーは spec.bearerTokenSecret フィールドを使用して認証情報を提供する必要があります。

automountServiceAccountToken

boolean

AutomountServiceAccountToken は、Pod にサービスアカウントトークンを自動的にマウントする必要があるかどうかを示します。このフィールドが設定されていない場合、Operator はデフォルトでサービスアカウントトークンをマウントします。

警告: デフォルトでは、Prometheus は Kubernetes サービスの検出にサービスアカウントトークンを必要とすることに注意してください。ストラトジックマージパッチを使用して、サービスアカウントトークンを 'Prometheus' コンテナーに投影できます。

baseImage

string

非推奨: 代わりに 'spec.image' を使用します。

bodySizeLimit

string

bodySizeLimit は、スクレイプごとのレスポンスボディーのサイズを定義します。Prometheus バージョン 2.45.0 以降でのみ有効です。

グローバル制限は、明示的な制限値を指定しないスクレイプオブジェクトにのみ適用されることに注意してください。すべてのスクレイプオブジェクトに最大制限を適用する場合は、enforcedBodySizeLimit を参照してください。

configMaps

array (string)

ConfigMaps は、Prometheus オブジェクトと同じ namespace にある ConfigMap のリストであり、Prometheus Pod にマウントされます。各 ConfigMap は、configmap-<configmap-name> という名前のボリュームとして StatefulSet 定義に追加されます。configMaps は、'prometheus' コンテナーの /etc/prometheus/configmaps/<configmap-name> にマウントされます。

containers

array

コンテナーを使用すると、追加のコンテナーを挿入したり、Operator が生成したコンテナーを変更したりできます。これを使用すると、Pod に認証プロキシーを追加したり、Operator が生成したコンテナーの動作を変更したりすることができます。ここで説明するコンテナーは、同じ名前を共有し、戦略的マージパッチを介して変更が行われる場合、Operator が生成したコンテナーを変更します。

Operator によって管理されるコンテナーの名前は次のとおりです: * prometheus * config-reloader * thanos-sidecar

コンテナーのオーバーライドは、メンテナーがサポートする範囲外であり、そうすることで、この動作が予告なしにいつでも中断する可能性があることを認めます。

containers[]

object

Pod 内で実行する単一のアプリケーションコンテナー。

disableCompaction

boolean

true の場合、Prometheus 圧縮は無効になります。

dnsConfig

object

Pod の DNS 設定を定義します。

dnsPolicy

string

Pod の DNS ポリシーを定義します。

enableAdminAPI

boolean

Prometheus Web 管理 API へのアクセスを有効にします。

警告: 管理 API を有効にすると、エンドポイントの変更、データの削除、Prometheus のシャットダウンなどが可能になります。これを有効にする場合は注意が必要です。ユーザーは、これらのアクションの実行を許可されたクライアントのみが許可できるように、プロキシーを介して追加の認証許可を追加することを推奨します。

詳細は、https://prometheus.io/docs/prometheus/latest/querying/api/#tsdb-admin-apis を参照してください。

enableFeatures

array (string)

Prometheus 機能フラグへのアクセスを有効にします。デフォルトでは、機能は有効になっていません。

デフォルトで無効になっている機能を有効にすることは、完全にメンテナーのサポート範囲外であり、これを行うと、この動作が予告なしにいつでも中断される可能性があることに同意したものとみなされます。

詳細は https://prometheus.io/docs/prometheus/latest/feature_flags/ を参照してください。

enableRemoteWriteReceiver

boolean

Prometheus を Prometheus リモート書き込みプロトコルのレシーバーとして使用できるようにします。

警告: これは効率的なサンプル取り込み方法とはみなされていません。特定の低ボリュームのユースケースでは注意して使用してください。スクレイピングによる取り込みの代わりに使用して、Prometheus をプッシュベースのメトリクス収集システムに変換するには適していません。詳細は、https://prometheus.io/docs/prometheus/latest/querying/api/#remote-write-receiver を参照してください。

Prometheus v2.33.0 以降が必要です。

enforcedBodySizeLimit

string

定義されている場合、enforcedBodySizeLimit は、Prometheus が受け入れる非圧縮形式のレスポンスボディーのサイズに対するグローバル制限を指定します。この数バイトよりも大きい本文で応答するターゲットは、スクレイプが失敗する原因になります。

Prometheus v2.28.0 以降が必要です。

enforcedBodySizeLimitbodySizeLimit の両方が定義されており、それらがゼロより大きい場合、次のルールが適用されます: * bodySizeLimit 値が定義されていないスクレイプオブジェクトは、グローバルの bodySizeLimit 値 (Prometheus 2.45.0 以降) または enforcedBodySizeLimit 値 (Prometheus v2.45.0 より前) を継承します。Prometheus バージョンが 2.45.0 以降であり、enforcedBodySizeLimitbodySizeLimit より大きい場合、bodySizeLimitenforcedBodySizeLimit に設定されます。* bodySizeLimit 値が enforcedBodySizeLimit 以下のスクレイプオブジェクトは、特定の値を保持します。* bodySizeLimit 値が enforcedBodySizeLimit より大きいスクレイプオブジェクトは、enforcedBodySizeLimit に設定されます。

enforcedKeepDroppedTargets

integer

定義されている場合、enforcedKeepDroppedTargets は、ラベルの再設定によりドロップされてメモリーに保持されるターゲットの数のグローバル制限を指定します。spec.keepDroppedTargets がゼロより大きく、spec.enforcedKeepDroppedTargets より小さい場合を除き、この値は ServiceMonitor、PodMonitor、Probe オブジェクトによって設定された spec.keepDroppedTargets をオーバーライドします。

Prometheus v2.47.0 以降が必要です。

enforcedKeepDroppedTargetskeepDroppedTargets の両方が定義されており、それらがゼロより大きい場合、次のルールが適用されます: * keepDroppedTargets 値が定義されていないスクレイプオブジェクトは、グローバルの keepDroppedTargets 値 (Prometheus 2.45.0 以降) または enforcedKeepDroppedTargets 値 (Prometheus v2.45.0 より前) を継承します。Prometheus バージョンが 2.45.0 以降で、enforcedKeepDroppedTargetskeepDroppedTargets より大きい場合、keepDroppedTargetsenforcedKeepDroppedTargets に設定されます。* keepDroppedTargets 値が enforcedKeepDroppedTargets 以下のスクレイプオブジェクトは、特定の値を保持します。* keepDroppedTargets 値が enforcedKeepDroppedTargets より大きいスクレイプオブジェクトは、enforcedKeepDroppedTargets に設定されます。

enforcedLabelLimit

integer

定義されている場合、enforcedLabelLimit はサンプルごとのラベル数のグローバル制限を指定します。spec.labelLimit がゼロより大きく、spec.enforcedLabelLimit より小さい場合を除き、この値は ServiceMonitor、PodMonitor、Probe オブジェクトによって設定された spec.labelLimit をオーバーライドします。

Prometheus v2.27.0 以降が必要です。

enforcedLabelLimitlabelLimit の両方が定義されており、それらがゼロより大きい場合、次のルールが適用されます: * labelLimit 値が定義されていないスクレイプオブジェクトは、グローバルの labelLimit 値 (Prometheus 2.45.0 以降) または enforcedLabelLimit 値 (Prometheus v2.45.0 より前) を継承します。Prometheus バージョンが 2.45.0 以降であり、enforcedLabelLimitlabelLimit より大きい場合、labelLimitenforcedLabelLimit に設定されます。* labelLimit 値が enforcedLabelLimit 以下のスクレイプオブジェクトは、特定の値を保持します。* labelLimit 値が enforcedLabelLimit より大きいスクレイプオブジェクトは、enforcedLabelLimit に設定されます。

enforcedLabelNameLengthLimit

integer

定義されている場合、enforcedLabelNameLengthLimit はサンプルごとのラベル名の長さに対するグローバル制限を指定します。spec.labelNameLengthLimit がゼロより大きく、spec.enforcedLabelNameLengthLimit より小さい場合を除き、この値は ServiceMonitor、PodMonitor、Probe オブジェクトによって設定された spec.labelNameLengthLimit をオーバーライドします。

Prometheus v2.27.0 以降が必要です。

enforcedLabelNameLengthLimitlabelNameLengthLimit の両方が定義されており、それらがゼロより大きい場合、次のルールが適用されます: * labelNameLengthLimit 値が定義されていないスクレイプオブジェクトは、グローバルの labelNameLengthLimit 値 (Prometheus 2.45.0 以降) または enforcedLabelNameLengthLimit 値 (Prometheus v2.45.0 より前) を継承します。Prometheus バージョンが 2.45.0 以降であり、enforcedLabelNameLengthLimitlabelNameLengthLimit より大きい場合、labelNameLengthLimitenforcedLabelNameLengthLimit に設定されます。* labelNameLengthLimit 値が enforcedLabelNameLengthLimit 以下のスクレイプオブジェクトは、特定の値を保持します。* labelNameLengthLimit 値が enforcedLabelNameLengthLimit より大きいスクレイプオブジェクトは、enforcedLabelNameLengthLimit に設定されます。

enforcedLabelValueLengthLimit

integer

null 以外の場合、enforcedLabelValueLengthLimit はサンプルごとのラベル値の長さに対するグローバル制限を定義します。spec.labelValueLengthLimit が 0 より大きく、spec.enforcedLabelValueLengthLimit より小さい場合を除き、この値は ServiceMonitor、PodMonitor、Probe オブジェクトによって設定された spec.labelValueLengthLimit をオーバーライドします。

Prometheus v2.27.0 以降が必要です。

enforcedLabelValueLengthLimitlabelValueLengthLimit の両方が定義されており、それらがゼロより大きい場合、次のルールが適用されます: * labelValueLengthLimit 値が定義されていないスクレイプオブジェクトは、グローバルの labelValueLengthLimit 値 (Prometheus 2.45.0 以降) または enforcedLabelValueLengthLimit 値 (Prometheus v2.45.0 より前) を継承します。Prometheus バージョンが 2.45.0 以降であり、enforcedLabelValueLengthLimitlabelValueLengthLimit より大きい場合、labelValueLengthLimitenforcedLabelValueLengthLimit に設定されます。* labelValueLengthLimit 値が enforcedLabelValueLengthLimit 以下のスクレイプオブジェクトは、特定の値を保持します。* labelValueLengthLimit 値が enforcedLabelValueLengthLimit より大きいスクレイプオブジェクトは、enforcedLabelValueLengthLimit に設定されます。

enforcedNamespaceLabel

string

空でない場合は、以下にラベルが追加されます。

1.ServiceMonitorPodMonitorProbe、および ScrapeConfig オブジェクトからスクレイプされたすべてのメトリクス。2.PrometheusRule オブジェクトで定義された記録ルールから生成されたすべてのメトリクス。3.PrometheusRule オブジェクトで定義されたアラートルールから生成されたすべてのアラート。4.PrometheusRule オブジェクトで定義された PromQL 式のすべてのベクトルセレクター。

spec.excludedFromEnforcement で参照されるオブジェクトにラベルは追加されません。

ラベルの名前は、このフィールドの値になります。ラベルの値は、ServiceMonitorPodMonitorProbePrometheusRule、または ScrapeConfig オブジェクトの namespace です。

enforcedSampleLimit

integer

定義されている場合、enforcedSampleLimit は受け入れられるスクレイピングされたサンプル数に対するグローバル制限を指定します。spec.sampleLimit が 0 より大きく、spec.enforcedSampleLimit より小さい場合を除き、この値が ServiceMonitor、PodMonitor、Probe オブジェクトによって設定された spec.sampleLimit をオーバーライドします。

これは、管理者がサンプル/シリーズの総数を必要な制限内に保つために使用します。

enforcedSampleLimitsampleLimit の両方が定義されており、それらがゼロより大きい場合、次のルールが適用されます。* sampleLimit 値が定義されていないスクレイプオブジェクトは、グローバルの sampleLimit 値 (Prometheus 2.45.0 以降) または enforcedSampleLimit 値 (Prometheus v2.45.0 より前) を継承します。Prometheus バージョンが 2.45.0 以降であり、enforcedSampleLimitsampleLimit より大きい場合、sampleLimitenforcedSampleLimit に設定されます。* sampleLimit 値が enforcedSampleLimit 以下のスクレイプオブジェクトは、特定の値を保持します。* sampleLimit 値が enforcedSampleLimit より大きいスクレイプオブジェクトは、enforcedSampleLimit に設定されます。

enforcedTargetLimit

integer

定義されている場合、enforcedTargetLimit はスクレイピングされたターゲットの数に対するグローバル制限を指定します。spec.targetLimit がゼロより大きく、spec.enforcedTargetLimit より小さい場合を除き、この値は ServiceMonitor、PodMonitor、Probe オブジェクトによって設定された spec.targetLimit をオーバーライドします。

これは、管理者がターゲットの総数を望ましい制限以下に維持するために使用します。

enforcedTargetLimittargetLimit の両方が定義されており、それらがゼロより大きい場合、次のルールが適用されます: * targetLimit 値が定義されていないスクレイプオブジェクトは、グローバルの targetLimit 値 (Prometheus 2.45.0 以降) または enforcedTargetLimit 値 (Prometheus v2.45.0 より前) を継承します。Prometheus バージョンが 2.45.0 以降であり、enforcedTargetLimittargetLimit より大きい場合、targetLimitenforcedTargetLimit に設定されます。* targetLimit 値が enforcedTargetLimit 以下のスクレイプオブジェクトは、特定の値を保持します。* targetLimit 値が enforcedTargetLimit より大きいスクレイプオブジェクトは、enforcedTargetLimit に設定されます。

evaluationInterval

string

ルール評価の間隔。デフォルト: "30s"

excludedFromEnforcement

array

元の namespace ラベルの適用から除外される PodMonitor、ServiceMonitor、Probe、および PrometheusRule オブジェクトへの参照のリスト。

spec.enforcedNamespaceLabel が true に設定されている場合にのみ適用されます。

excludedFromEnforcement[]

object

ObjectReference は、PodMonitor、ServiceMonitor、Probe、または PrometheusRule オブジェクトを参照します。

exemplars

object

実行時に再読み込み可能な Exemplar 関連の設定。有効にするには、exemplar-storage 機能フラグを有効にする必要があります。

externalLabels

object (string)

外部システム (フェデレーション、リモートストレージ、Alertmanager) と通信するときに、任意の時系列またはアラートに追加するラベル。spec.replicaExternalLabelName および spec.prometheusExternalLabelName で定義されたラベルは、このリストよりも優先されます。

externalUrl

string

Prometheus サービスを外部から使用するための外部 URL。正しい URL を生成するために必要です (たとえば、Prometheus が Ingress リソースの背後でアクセス可能である場合など)。

hostAliases

array

指定された場合に Pod のホストファイルに注入されるホストと IP のオプションのリスト。

hostAliases[]

object

HostAlias は、Pod の hosts ファイルのエントリーとして挿入される IP とホスト名の間のマッピングを保持します。

hostNetwork

boolean

true の場合、ホストのネットワーク namespace を使用します。

有効にする場合は、必ずセキュリティー上の影響を必ず理解した上で有効にしてください (https://kubernetes.io/docs/concepts/configuration/overview/)。

hostNetwork が有効になっている場合、DNS ポリシーが ClusterFirstWithHostNet に自動的に設定されます (.spec.DNSPolicy が別の値に設定されている場合を除く)。

ignoreNamespaceSelectors

boolean

true の場合、すべての PodMonitor、ServiceMonitor、および Probe オブジェクトの spec.namespaceSelector は無視されます。PodMonitor、ServiceMonitor、および Probe オブジェクトの namespace 内のターゲットのみを検出します。

image

string

Prometheus のコンテナーイメージ名。指定されている場合、spec.baseImagespec.tag、および spec.sha フィールドよりも優先されます。

Prometheus Operator が設定されている Prometheus のバージョンを認識するためには、spec.version が指定されている必要があります。

spec.imagespec.baseImage のいずれも定義されていない場合、Operator は、Operator がリリースされた時点で利用可能な Prometheus の最新アップストリームバージョンを使用します。

imagePullPolicy

string

'prometheus', 'init-config-reloader'、'config-reloader' コンテナーのイメージプルポリシー。詳細は、https://kubernetes.io/docs/concepts/containers/images/#image-pull-policy を参照してください。

imagePullSecrets

array

レジストリーからイメージをプルするために使用する、同じ namespace 内の Secret へのオプションの参照リスト。http://kubernetes.io/docs/user-guide/images#specifying-imagepullsecrets-on-a-pod を参照してください。

imagePullSecrets[]

object

LocalObjectReference には、同じ namespace 内で参照オブジェクトを見つけるのに十分な情報が含まれます。

initContainers

array

InitContainers を使用して、Pod 定義に initContainers を注入できます。これらは、たとえば、外部ソースから Prometheus 設定に注入するためのシークレットをフェッチするために使用できます。initContainer の実行中にエラーが発生すると、Pod が再起動します。詳細: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/ ここで説明する InitContainers は、同じ名前を共有し、戦略的なマージパッチを介して変更が行われる場合は、オペレーターが生成した init コンテナーを変更します。

Operator によって管理される init コンテナー名は次のとおりです: * init-config-reloader

init コンテナーのオーバーライドは、メンテナーがサポートする範囲外であり、そうすることで、この動作が予告なしにいつでも中断する可能性があることを認めます。

initContainers[]

object

Pod 内で実行する単一のアプリケーションコンテナー。

keepDroppedTargets

integer

再ラベル付けによって削除され、メモリーに保持されるターゲットの数に対するスクレイプごとの制限。0 は制限がないことを意味します。

Prometheus v2.47.0 以降が必要です。

グローバル制限は、明示的な制限値を指定しないスクレイプオブジェクトにのみ適用されることに注意してください。すべてのスクレイプオブジェクトに最大制限を適用する場合は、enforcedKeepDroppedTargets を参照してください。

labelLimit

integer

サンプルに受け入れられるラベルの数のスクレープごとの制限。Prometheus バージョン 2.45.0 以降でのみ有効です。

グローバル制限は、明示的な制限値を指定しないスクレイプオブジェクトにのみ適用されることに注意してください。すべてのスクレイプオブジェクトに最大制限を適用する場合は、enforcedLabelLimit を参照してください。

labelNameLengthLimit

integer

サンプルで受け入れられるラベル名の長さのスクレープごとの制限。Prometheus バージョン 2.45.0 以降でのみ有効です。

グローバル制限は、明示的な制限値を指定しないスクレイプオブジェクトにのみ適用されることに注意してください。すべてのスクレイプオブジェクトに最大制限を適用する場合は、enforcedLabelNameLengthLimit を参照してください。

labelValueLengthLimit

integer

サンプルに受け入れられるラベル値の長さのスクレープごとの制限。Prometheus バージョン 2.45.0 以降でのみ有効です。

グローバル制限は、明示的な制限値を指定しないスクレイプオブジェクトにのみ適用されることに注意してください。すべてのスクレイプオブジェクトに最大制限を適用する場合は、enforcedLabelValueLengthLimit を参照してください。

listenLocal

boolean

true の場合、Prometheus サーバーは Pod IP のアドレスではなくループバックアドレスをリッスンします。

logFormat

string

Prometheus および config-reloader サイドカーのログレベルのログ形式。

logLevel

string

Prometheus と config-reloader サイドカーのログレベル。

maximumStartupDurationSeconds

integer

Prometheus コンテナーのスタートアッププローブが失敗と判断されるまでに待機する最大時間を定義します。WAL 再生が完了すると、スタートアッププローブは成功を返します。設定する場合、値は 60 (秒) より大きくする必要があります。それ以外の場合は 600 秒 (15 分) になります。

minReadySeconds

integer

新しく作成された Pod が使用可能であると見なされるために、コンテナーがクラッシュすることなく準備完了になるまでの最小秒数。デフォルトは 0 です (Pod は準備ができ次第利用可能と見なされます)

これは、Kubernetes 1.22 から 1.24 までのアルファフィールドであり、StatefulSetMinReadySeconds フィーチャーゲートを有効にする必要があります。

nodeSelector

object (string)

Pod がどのノードにスケジュールされるかを定義します。

otlp

object

OTLP レシーバーの機能に関する設定。Prometheus v2.55.0 以降が必要です。

overrideHonorLabels

boolean

true の場合、Prometheus は、ServiceMonitor、PodMonitor、および ScrapeConfig オブジェクトから作成されたすべてのターゲットに対して、スクレイピングされたデータ内のラベルの名前を “exported_” に変更することでラベルの競合を解決します。それ以外の場合は、サービスまたは Pod モニターの HonorLabels フィールドが適用されます。実際には、overrideHonorLaels:true はすべての ServiceMonitor、PodMonitor、および ScrapeConfig オブジェクトに対して honorLabels:false を適用します。

overrideHonorTimestamps

boolean

true の場合、Prometheus はサービスおよび Pod モニターから作成されたすべてのターゲットのタイムスタンプを無視します。それ以外の場合は、サービスまたは Pod モニターの HonorTimestamps フィールドが適用されます。

paused

boolean

Prometheus のデプロイメントが一時停止されると、基になるオブジェクトに対して削除以外のアクションは実行されません。

persistentVolumeClaimRetentionPolicy

object

このフィールドは、StatefulSet のライフサイクル中に PVC を削除するかどうか、および削除する場合はその方法を制御します。デフォルトの動作では、すべての PVC が保持されます。これは、Kubernetes 1.23 から 1.26 までのアルファフィールドであり、1.26 以降ではベータフィールドです。StatefulSetAutoDeletePVC フィーチャーゲートを有効にする必要があります。

podMetadata

object

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" アノテーション。

podMonitorNamespaceSelector

object

PodMonitors 検出に一致する namespace。空のラベルセレクターはすべての namespace に一致します。null ラベルセレクター (デフォルト値) は現在の namespace にのみ一致します。

podMonitorSelector

object

ターゲット検出のために選択される PodMonitor。ラベルセレクターが空の場合は、全オブジェクトをマッチします。ラベルセレクターが null の場合は、どのオブジェクトもマッチしません。

spec.serviceMonitorSelectorspec.podMonitorSelectorspec.probeSelectorspec.scrapeConfigSelector が null の場合、Prometheus 設定は管理されません。Prometheus Operator は Prometheus 設定のシークレットが存在することを確認しますが、prometheus.yaml.gz キーの下に生の gzip 圧縮された Prometheus 設定を提供するのはユーザーの責任です。この動作は 非推奨 であり、カスタムリソース定義の次のメジャーバージョンでは削除されます。代わりに spec.additionalScrapeConfigs を使用することが推奨されます。

podTargetLabels

array (string)

PodTargetLabels は、すべての PodMonitor および ServiceMonitor オブジェクトの spec.podTargetLabels フィールドに追加されます。

portName

string

Pod および管理サービスに使用されるポート名。デフォルト: "web"

priorityClassName

string

Pod に割り当てられた優先度クラス。

probeNamespaceSelector

object

プローブ検出に一致する namespace。空のラベルセレクターはすべての namespace に一致します。null ラベルセレクターは現在の namespace にのみ一致します。

probeSelector

object

ターゲット検出のために選択されるプローブ。ラベルセレクターが空の場合は、全オブジェクトをマッチします。ラベルセレクターが null の場合は、どのオブジェクトもマッチしません。

spec.serviceMonitorSelectorspec.podMonitorSelectorspec.probeSelectorspec.scrapeConfigSelector が null の場合、Prometheus 設定は管理されません。Prometheus Operator は Prometheus 設定のシークレットが存在することを確認しますが、prometheus.yaml.gz キーの下に生の gzip 圧縮された Prometheus 設定を提供するのはユーザーの責任です。この動作は 非推奨 であり、カスタムリソース定義の次のメジャーバージョンでは削除されます。代わりに spec.additionalScrapeConfigs を使用することが推奨されます。

prometheusExternalLabelName

string

Prometheus インスタンス名を示すために使用される Prometheus 外部ラベルの名前。フィールドが空の文字列 ("") に設定されている場合、外部ラベルは 追加されません

デフォルト: "prometheus"

prometheusRulesExcludedFromEnforce

array

namespace ラベルの強制が適用されない PrometheusRule オブジェクトのリストを定義します。これは、spec.enforcedNamespaceLabel が true に設定されている場合にのみ関連します。非推奨: 代わりに spec.excludedFromEnforcement を使用します。

prometheusRulesExcludedFromEnforce[]

object

PrometheusRuleExcludeConfig を使用すると、ユーザーは、アラートとメトリックの namespace ラベルを適用するときに、除外された PrometheusRule 名とその namespace を無視するように設定できます。

query

object

QuerySpec は、Promethus クエリーサービスの設定を定義します。

queryLogFile

string

queryLogFile は、PromQL クエリーがログに記録されるファイルを指定します。

ファイル名に空のパスが含まれる場合 (例: 'query.log')、Prometheus Pod はファイルを /var/log/prometheus の emptyDir ボリュームにマウントします。完全なパスが指定されている場合 (例: '/var/log/prometheus/query.log')、指定されたディレクトリーにボリュームをマウントし、書き込み可能にする必要があります。これは、セキュリティー上の理由から、Prometheus コンテナーが読み取り専用のルートファイルシステムで実行されるためです。または、場所を標準 I/O ストリーム (例: /dev/stdout) に設定して、クエリー情報をデフォルトの Prometheus ログストリームに記録することもできます。

reloadStrategy

string

Prometheus 設定をリロードするために使用されるストラテジーを定義します。指定されていない場合、設定は /-/reload HTTP エンドポイントを使用してリロードされます。

remoteRead

array

リモート読み取り設定のリストを定義します。

remoteRead[]

object

RemoteReadSpec は、Prometheus がリモートエンドポイントからサンプルを読み戻すための設定を定義します。

remoteWrite

array

リモート書き込み設定のリストを定義します。

remoteWrite[]

object

RemoteWriteSpec は、Prometheus からリモートエンドポイントにサンプルを書き込むための設定を定義します。

remoteWriteReceiverMessageVersions

array (string)

リモート書き込みを受信するときに受け入れる protobuf メッセージバージョンのリスト。

Prometheus v2.54.0 以降が必要です。

replicaExternalLabelName

string

レプリカ名を示すために使用される Prometheus 外部ラベルの名前。フィールドが空の文字列 ("") に設定されている場合、外部ラベルは 追加されません

デフォルト: "prometheus_replica"

replicas

integer

Prometheus デプロイメント用にデプロイする各シャードのレプリカの数。spec.replicasspec.shards を掛けたものが、作成される Pod の合計数になります。

デフォルト: 1

resources

object

'prometheus' コンテナーのリソースリクエストと制限を定義します。

retention

string

Prometheus データを保持する期間。

デフォルト: spec.retentionspec.retentionSize が空の場合は "24h"。

retentionSize

string

Prometheus データで使用される最大バイト数。

routePrefix

string

ルート接頭辞 Prometheus は、の HTTP ハンドラーを登録します。

spec.externalURL を使用ており、プロキシーがリクエストの HTTP ルートを書き換え、実際の ExternalURL は引き続き true であるが、サーバーが別のルート接頭辞でリクエストを処理する場合に便利です。たとえば、kubectl プロキシー で使用します。

ruleNamespaceSelector

object

PrometheusRule 検出に一致する namespace。空のラベルセレクターはすべての namespace に一致します。null ラベルセレクターは現在の namespace にのみ一致します。

ruleQueryOffset

string

この特定のグループのルール評価タイムスタンプを、指定期間だけ過去にオフセットすることを定義します。Prometheus v2.53.0 以降が必要です。

ruleSelector

object

ルール評価のために選択される PrometheusRule オブジェクト。ラベルセレクターが空の場合は、全オブジェクトをマッチします。ラベルセレクターが null の場合は、どのオブジェクトもマッチしません。

rules

object

Prometheus ルールのエンジンの設定を定義します。

runtime

object

RuntimeConfig は Prometheus プロセスの動作の値を設定します。

sampleLimit

integer

SampleLimit は、受け入れられるスクレイプされたサンプルの数に対するスクレイプごとの制限を定義します。Prometheus バージョン 2.45.0 以降でのみ有効です。

グローバル制限は、明示的な制限値を指定しないスクレイプオブジェクトにのみ適用されることに注意してください。すべてのスクレイプオブジェクトに最大制限を適用する場合は、enforcedSampleLimit を参照してください。

scrapeClasses

array

PodMonitors、ServiceMonitors、Probes、ScrapeConfigs などのスクレイピングオブジェクトに公開するスクレイプクラスのリスト。

これは 実験的な機能 であり、今後のリリースで重大な変更が加えられる可能性があります。

scrapeClasses[]

object

 

scrapeConfigNamespaceSelector

object

ScrapeConfig 検出に一致する namespace。空のラベルセレクターはすべての namespace に一致します。null ラベルセレクターは現在の namespace にのみ一致します。

現在、ScrapeConfig カスタムリソース定義はアルファレベルであることに注意してください。

scrapeConfigSelector

object

ターゲット検出のために選択される ScrapeConfigs。ラベルセレクターが空の場合は、全オブジェクトをマッチします。ラベルセレクターが null の場合は、どのオブジェクトもマッチしません。

spec.serviceMonitorSelectorspec.podMonitorSelectorspec.probeSelectorspec.scrapeConfigSelector が null の場合、Prometheus 設定は管理されません。Prometheus Operator は Prometheus 設定のシークレットが存在することを確認しますが、prometheus.yaml.gz キーの下に生の gzip 圧縮された Prometheus 設定を提供するのはユーザーの責任です。この動作は 非推奨 であり、カスタムリソース定義の次のメジャーバージョンでは削除されます。代わりに spec.additionalScrapeConfigs を使用することが推奨されます。

現在、ScrapeConfig カスタムリソース定義はアルファレベルであることに注意してください。

scrapeInterval

string

連続するスクレイプの間隔。

デフォルト: "30s"

scrapeProtocols

array (string)

スクレイピング中にネゴシエートするプロトコル。これは、Prometheus でサポートされているプロトコルを (優先度が高いものから低いものへ) 優先度順にクライアントに通知します。

設定されていない場合、Prometheus はデフォルト値を使用します。

Prometheus v2.49.0 以降が必要です。

scrapeTimeout

string

スクレイプリクエストがタイムアウトするまでの待機秒数。

secrets

array (string)

シークレットは、Prometheus オブジェクトと同じ namespace にあるシークレットのリストであり、Prometheus Pod にマウントされます。各シークレットは、secret-<secret-name> という名前のボリュームとして StatefulSet 定義に追加されます。シークレットは、'prometheus' コンテナーの /etc/prometheus/secrets/<secret-name> にマウントされます。

securityContext

object

SecurityContext は、Pod レベルのセキュリティー属性と一般的なコンテナー設定を保持します。これはデフォルトでデフォルトの PodSecurityContext になります。

serviceAccountName

string

ServiceAccountName は、Prometheus Pod の実行に使用する ServiceAccount の名前です。

serviceDiscoveryRole

string

ServiceMonitor オブジェクトおよび Alertmanager エンドポイントからターゲットを検出するために使用するサービス検出ロールを定義します。

設定する場合、"Endpoints" または "EndpointSlice" のいずれかの値を指定する必要があります。設定されていない場合、Operator は "Endpoints" ロールを想定します。

serviceMonitorNamespaceSelector

object

ServicedMonitors 検出に一致する namespace。空のラベルセレクターはすべての namespace に一致します。null ラベルセレクター (デフォルト値) は現在の namespace にのみ一致します。

serviceMonitorSelector

object

ターゲット検出用に選択される ServiceMonitor。ラベルセレクターが空の場合は、全オブジェクトをマッチします。ラベルセレクターが null の場合は、どのオブジェクトもマッチしません。

spec.serviceMonitorSelectorspec.podMonitorSelectorspec.probeSelectorspec.scrapeConfigSelector が null の場合、Prometheus 設定は管理されません。Prometheus Operator は Prometheus 設定のシークレットが存在することを確認しますが、prometheus.yaml.gz キーの下に生の gzip 圧縮された Prometheus 設定を提供するのはユーザーの責任です。この動作は 非推奨 であり、カスタムリソース定義の次のメジャーバージョンでは削除されます。代わりに spec.additionalScrapeConfigs を使用することが推奨されます。

sha

string

非推奨: 代わりに 'spec.image' を使用します。イメージのダイジェストはイメージ名の一部として指定できます。

shards

integer

ターゲットの分散先となるシャードの数。spec.replicasspec.shards を掛けたものが、作成される Pod の合計数になります。

シャードを縮小しても、データは残りのインスタンスに再シャーディングされないことに注意してください。手動で移動する必要があります。シャードを増やしてもデータはリシャードされませんが、同じインスタンスから引き続き使用できます。グローバルにクエリーを実行するには、Thanos サイドカーと Thanos クエリアを使用するか、中央の場所にデータをリモートで書き込みます。

シャーディングは、PodMonitor および ServiceMonitor の address ターゲットメタラベルと、プローブの param_target の内容に対して実行されます。

デフォルト: 1

storage

object

storage は、Prometheus が使用するストレージを定義します。

tag

string

非推奨: 代わりに 'spec.image' を使用します。イメージのタグはイメージ名の一部として指定できます。

targetLimit

integer

TargetLimit は、受け入れられるスクレイプされたターゲットの数の制限を定義します。Prometheus バージョン 2.45.0 以降でのみ有効です。

グローバル制限は、明示的な制限値を指定しないスクレイプオブジェクトにのみ適用されることに注意してください。すべてのスクレイプオブジェクトに最大制限を適用する場合は、enforcedTargetLimit を参照してください。

thanos

object

オプションの Thanos サイドカーの設定を定義します。

tolerations

array

指定されている場合、Pod の toleration を定義します。

tolerations[]

object

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

topologySpreadConstraints

array

指定されている場合、Pod のトポロジー分散制約を定義します。

topologySpreadConstraints[]

object

 

tracingConfig

object

TracingConfig は Prometheus でトレーシングを設定します。

これは 実験的な機能 であり、今後のリリースで重大な変更が加えられる可能性があります。

tsdb

object

ランタイムでのリロードが可能な時系列データベース (TSDB) の設定を定義します。Prometheus v2.39.0 以降または PrometheusAgent v2.54.0 以降が必要です。

version

string

デプロイされている Prometheus のバージョン。Operator はこの情報を使用して、Prometheus StatefulSet と設定ファイルを生成します。

指定されていない場合、Operator はその Operator バージョンがリリースされた時点で利用可能な Prometheus の最新アップストリームバージョンを想定します。

volumeMounts

array

volumeMounts を使用して、追加の volumeMounts を設定できます。

VolumeMounts は、StorageSpec オブジェクトの結果として生成される 'prometheus' コンテナー内の他の VolumeMounts に追加されます。

volumeMounts[]

object

VolumeMount は、コンテナー内でのボリュームのマウントを説明します。

volumes

array

volumes を使用して、出力の StatefulSet 定義に追加のボリュームを設定できます。指定されたボリュームは、StorageSpec オブジェクトの結果として生成される他のボリュームに追加されます。

volumes[]

object

ボリュームは、Pod 内の任意のコンテナーからアクセスできる Pod 内の名前付きボリュームを表します。

walCompression

boolean

Snappy を使用してログ先行書き込み (WAL) の圧縮を設定します。

Prometheus 2.20.0 以降では、デフォルトで WAL 圧縮が有効になっています。

Prometheus v2.11.0 以降が必要です。

web

object

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

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

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

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.4. .spec.additionalArgs

説明

additionalArgs を使用すると、'prometheus' コンテナーに追加の引数を設定できます。

これは、専用の設定オプションではまだサポートされていない隠しフラグを有効にする場合などに使用されます。引数はそのまま Prometheus コンテナーに渡されますが、引数が無効であったり、指定された Prometheus バージョンでサポートされていない場合は問題が発生する可能性があります。

引数が競合する場合 (たとえば、Operator によってすでに設定されている引数)、または無効な引数を指定すると、調整は失敗し、エラーが記録されます。

array

8.1.5. .spec.additionalArgs[]

説明
AdditionalArgs リストの一部である引数。
object
必須
  • name
プロパティー説明

name

string

引数の名前 (例: "scrape.discovery-reload-interval")。

value

string

引数の値 (例: 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
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.7. .spec.affinity

説明
指定されている場合、Pod のアフィニティースケジューリングルールを定義します。
object
プロパティー説明

nodeAffinity

object

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

podAffinity

object

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

podAntiAffinity

object

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

8.1.8. .spec.affinity.nodeAffinity

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

preferredDuringSchedulingIgnoredDuringExecution

array

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

preferredDuringSchedulingIgnoredDuringExecution[]

object

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

requiredDuringSchedulingIgnoredDuringExecution

object

このフィールドで指定されたアフィニティー要件がスケジュール時に満たされない場合、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
プロパティー説明

preference

object

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

weight

integer

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

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

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

matchExpressions

array

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

matchExpressions[]

object

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

matchFields

array

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

matchFields[]

object

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

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

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

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

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

key

string

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

operator

string

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

values

array (string)

文字列値の配列。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
プロパティー説明

key

string

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

operator

string

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

values

array (string)

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

8.1.16. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution

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

nodeSelectorTerms

array

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

nodeSelectorTerms[]

object

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

matchExpressions

array

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

matchExpressions[]

object

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

matchFields

array

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

matchFields[]

object

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

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

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

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

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

key

string

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

operator

string

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

values

array (string)

文字列値の配列。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
プロパティー説明

key

string

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

operator

string

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

values

array (string)

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

8.1.23. .spec.affinity.podAffinity

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

preferredDuringSchedulingIgnoredDuringExecution

array

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

preferredDuringSchedulingIgnoredDuringExecution[]

object

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

requiredDuringSchedulingIgnoredDuringExecution

array

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

requiredDuringSchedulingIgnoredDuringExecution[]

object

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

8.1.24. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution

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

8.1.25. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[]

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

podAffinityTerm

object

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

weight

integer

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

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

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

labelSelector

object

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

matchLabelKeys

array (string)

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

mismatchLabelKeys

array (string)

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

namespaceSelector

object

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

namespace

array (string)

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

topologyKey

string

この 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

array

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

matchExpressions[]

object

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

matchLabels

object (string)

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

string

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

operator

string

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

values

array (string)

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

array

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

matchExpressions[]

object

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

matchLabels

object (string)

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

string

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

operator

string

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

values

array (string)

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

labelSelector

object

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

matchLabelKeys

array (string)

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

mismatchLabelKeys

array (string)

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

namespaceSelector

object

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

namespace

array (string)

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

topologyKey

string

この Pod は、指定された namespace の labelSelector と一致する Pod と同じ場所 (affinity) または異なる場所 (anti-affinity) に配置します。同じ場所とは、topologyKey キーが含まれるラベルの値が一致し、選択した Pod のいずれかが実行されているノード上で実行されていることを意味します。空の topologyKey は許可されていません。

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

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

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

object (string)

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

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

string

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

operator

string

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

values

array (string)

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

array

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

matchExpressions[]

object

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

matchLabels

object (string)

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

string

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

operator

string

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

values

array (string)

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

8.1.41. .spec.affinity.podAntiAffinity

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

preferredDuringSchedulingIgnoredDuringExecution

array

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

preferredDuringSchedulingIgnoredDuringExecution[]

object

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

requiredDuringSchedulingIgnoredDuringExecution

array

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

requiredDuringSchedulingIgnoredDuringExecution[]

object

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

8.1.42. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution

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

8.1.43. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[]

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

podAffinityTerm

object

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

weight

integer

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

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

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

labelSelector

object

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

matchLabelKeys

array (string)

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

mismatchLabelKeys

array (string)

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

namespaceSelector

object

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

namespace

array (string)

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

topologyKey

string

この 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

array

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

matchExpressions[]

object

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

matchLabels

object (string)

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

string

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

operator

string

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

values

array (string)

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

array

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

matchExpressions[]

object

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

matchLabels

object (string)

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

string

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

operator

string

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

values

array (string)

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

labelSelector

object

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

matchLabelKeys

array (string)

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

mismatchLabelKeys

array (string)

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

namespaceSelector

object

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

namespace

array (string)

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

topologyKey

string

この Pod は、指定された namespace の labelSelector と一致する Pod と同じ場所 (affinity) または異なる場所 (anti-affinity) に配置します。同じ場所とは、topologyKey キーが含まれるラベルの値が一致し、選択した Pod のいずれかが実行されているノード上で実行されていることを意味します。空の topologyKey は許可されていません。

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

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

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

object (string)

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

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

string

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

operator

string

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

values

array (string)

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

array

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

matchExpressions[]

object

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

matchLabels

object (string)

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

string

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

operator

string

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

values

array (string)

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

8.1.59. .spec.alerting

説明
Alertmanager に関連する設定を定義します。
object
必須
  • alertmanagers
プロパティー説明

alertmanagers

array

Prometheus がアラートを送信する Alertmanager エンドポイント。

alertmanagers[]

object

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

alertRelabelings

array

特定の Alertmanager にアラートを送信する前に適用されるラベル再設定の設定。Prometheus v2.51.0 以降が必要です。

alertRelabelings[]

object

RelabelConfig を使用すると、ターゲット、アラート、スクレイピングされたサンプル、リモート書き込みサンプルのラベルセットを動的に書き換えることができます。

詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config

apiVersion

string

Prometheus がアラートの送信に使用する Alertmanager API のバージョン。"v1" または "v2" を使用できます。

authorization

object

Alertmanager の認可セクション。

basicAuthbearerTokenFilesigv4 と同時に設定することはできません。

basicAuth

object

Alertmanager の BasicAuth 設定。

bearerTokenFileauthorizationsigv4 と同時に設定することはできません。

bearerTokenFile

string

Alertmanager のベアラートークンを読み取るファイル。

basicAuthauthorization、または sigv4 と同時に設定することはできません。

非推奨: 今後のリリースで削除される予定です。authorization の使用を優先してください。

enableHttp2

boolean

HTTP2 を有効にするかどうか。

name

string

namespace 内のエンドポイントオブジェクトの名前。

namespace

string

エンドポイントオブジェクトの namespace。

設定されていない場合、Prometheus オブジェクトの namespace でオブジェクトが検出されます。

pathPrefix

string

HTTP パスアラートの接頭辞はにプッシュされます。

port

integer-or-string

Alertmanager API が公開されるポート。

relabelings

array

検出された Alertmanagers に適用されるラベル再設定の設定。

relabelings[]

object

RelabelConfig を使用すると、ターゲット、アラート、スクレイピングされたサンプル、リモート書き込みサンプルのラベルセットを動的に書き換えることができます。

詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config

scheme

string

アラートを発するときに使用するスキーム。

sigv4

object

sigv4 を使用して、URL に対して AWS の Signature Verification 4 を設定できます。

Prometheus v2.48.0 以降が必要です。

basicAuthbearerTokenFileauthorization と同時に設定することはできません。

timeout

string

タイムアウトは、アラートをプッシュするときのターゲットごとの Alertmanager タイムアウトです。

tlsConfig

object

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

action

string

正規表現の一致に基づいて実行するアクション。

Uppercase および Lowercase アクションには Prometheus v2.36.0 以降が必要です。DropEqual および KeepEqual アクションには Prometheus v2.41.0 以降が必要です。

デフォルト: "Replace"

modulus

integer

ソースラベル値のハッシュを取得するためのモジュラス。

アクションが HashMod の場合にのみ適用されます。

regex

string

抽出された値が一致する正規表現。

replacement

string

正規表現が一致する場合に置き換えアクションが実施される置換値。

正規表現キャプチャグループが利用可能です。

separator

string

separator は連結された SourceLabel 間の文字列です。

sourceLabels

array (string)

ソースラベルは、既存のラベルから値を選択します。それらのコンテンツは、設定されたセパレータを使用して連結され、設定された正規表現と照合されます。

targetLabel

string

結果の文字列が置換で書き込まれるラベル。

ReplaceHashModLowercaseUppercaseKeepEqualDropEqual アクションでは必須です。

正規表現キャプチャグループが利用可能です。

8.1.64. .spec.alerting.alertmanagers[].authorization

説明

Alertmanager の認可セクション。

basicAuthbearerTokenFilesigv4 と同時に設定することはできません。

object
プロパティー説明

credentials

object

認証の認証情報を含む、namespace 内の Secret のキーを選択します。

type

string

認証タイプを定義します。この値は大文字と小文字を区別しません。

"Basic" はサポートされている値ではありません。

デフォルト: "Bearer"

8.1.65. .spec.alerting.alertmanagers[].authorization.credentials

説明
認証の認証情報を含む、namespace 内の Secret のキーを選択します。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.66. .spec.alerting.alertmanagers[].basicAuth

説明

Alertmanager の BasicAuth 設定。

bearerTokenFileauthorizationsigv4 と同時に設定することはできません。

object
プロパティー説明

password

object

password は、認証用のパスワードを含むシークレットのキーを指定します。

username

object

username は、認証用のユーザー名を含むシークレットのキーを指定します。

8.1.67. .spec.alerting.alertmanagers[].basicAuth.password

説明
password は、認証用のパスワードを含むシークレットのキーを指定します。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.68. .spec.alerting.alertmanagers[].basicAuth.username

説明
username は、認証用のユーザー名を含むシークレットのキーを指定します。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

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

action

string

正規表現の一致に基づいて実行するアクション。

Uppercase および Lowercase アクションには Prometheus v2.36.0 以降が必要です。DropEqual および KeepEqual アクションには Prometheus v2.41.0 以降が必要です。

デフォルト: "Replace"

modulus

integer

ソースラベル値のハッシュを取得するためのモジュラス。

アクションが HashMod の場合にのみ適用されます。

regex

string

抽出された値が一致する正規表現。

replacement

string

正規表現が一致する場合に置き換えアクションが実施される置換値。

正規表現キャプチャグループが利用可能です。

separator

string

separator は連結された SourceLabel 間の文字列です。

sourceLabels

array (string)

ソースラベルは、既存のラベルから値を選択します。それらのコンテンツは、設定されたセパレータを使用して連結され、設定された正規表現と照合されます。

targetLabel

string

結果の文字列が置換で書き込まれるラベル。

ReplaceHashModLowercaseUppercaseKeepEqualDropEqual アクションでは必須です。

正規表現キャプチャグループが利用可能です。

8.1.71. .spec.alerting.alertmanagers[].sigv4

説明

sigv4 を使用して、URL に対して AWS の Signature Verification 4 を設定できます。

Prometheus v2.48.0 以降が必要です。

basicAuthbearerTokenFileauthorization と同時に設定することはできません。

object
プロパティー説明

accessKey

object

AccessKey は AWS API キーです。指定されていない場合は、環境変数 AWS_ACCESS_KEY_ID が使用されます。

profile

string

profile は、認証に使用される名前付き AWS プロファイルです。

region

string

region は AWS リージョンです。空白の場合は、デフォルトの認証情報チェーンのリージョンが使用されます。

roleArn

string

roleArn は、認証に使用される名前付き AWS プロファイルです。

secretKey

object

secretKey は AWS API シークレットです。指定されていない場合は、環境変数 AWS_SECRET_ACCESS_KEY が使用されます。

8.1.72. .spec.alerting.alertmanagers[].sigv4.accessKey

説明
AccessKey は AWS API キーです。指定されていない場合は、環境変数 AWS_ACCESS_KEY_ID が使用されます。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.73. .spec.alerting.alertmanagers[].sigv4.secretKey

説明
secretKey は AWS API シークレットです。指定されていない場合は、環境変数 AWS_SECRET_ACCESS_KEY が使用されます。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.74. .spec.alerting.alertmanagers[].tlsConfig

説明
Alertmanager に使用する TLS 設定。
object
プロパティー説明

ca

object

サーバー証明書の検証に使用される認証局。

caFile

string

ターゲットに使用する Prometheus コンテナー内の CA 証明書へのパス。

cert

object

クライアント認証を行うときに提示するクライアント証明書。

certFile

string

ターゲットの Prometheus コンテナー内のクライアント証明書ファイルへのパス。

insecureSkipVerify

boolean

ターゲット証明書の検証を無効にします。

keyFile

string

ターゲットの Prometheus コンテナー内のクライアントキーファイルへのパス。

keySecret

object

ターゲットのクライアントキーファイルを含むシークレット。

maxVersion

string

許容可能な最大 TLS バージョン。

Prometheus v2.41.0 以降が必要です。

minVersion

string

許容可能な最小 TLS バージョン。

Prometheus v2.35.0 以降が必要です。

serverName

string

ターゲットのホスト名を確認するために使用されます。

8.1.75. .spec.alerting.alertmanagers[].tlsConfig.ca

説明
サーバー証明書の検証に使用される認証局。
object
プロパティー説明

configMap

object

ターゲットに使用するデータを含む ConfigMap。

secret

object

ターゲットに使用するデータを含むシークレット。

8.1.76. .spec.alerting.alertmanagers[].tlsConfig.ca.configMap

説明
ターゲットに使用するデータを含む ConfigMap。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

8.1.77. .spec.alerting.alertmanagers[].tlsConfig.ca.secret

説明
ターゲットに使用するデータを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.78. .spec.alerting.alertmanagers[].tlsConfig.cert

説明
クライアント認証を行うときに提示するクライアント証明書。
object
プロパティー説明

configMap

object

ターゲットに使用するデータを含む ConfigMap。

secret

object

ターゲットに使用するデータを含むシークレット。

8.1.79. .spec.alerting.alertmanagers[].tlsConfig.cert.configMap

説明
ターゲットに使用するデータを含む ConfigMap。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

8.1.80. .spec.alerting.alertmanagers[].tlsConfig.cert.secret

説明
ターゲットに使用するデータを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.81. .spec.alerting.alertmanagers[].tlsConfig.keySecret

説明
ターゲットのクライアントキーファイルを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.82. .spec.apiserverConfig

説明
APIServerConfig を使用すると、Kuberntees API サーバーにアクセスするためのホストと認証方法を指定できます。null の場合、Prometheus はクラスター内で実行されると想定され、API サーバーが自動的に検出され、Pod の CA 証明書とベアラートークンファイル (/var/run/secrets/kubernetes.io/serviceaccount/) が使用されます。
object
必須
  • host
プロパティー説明

authorization

object

API サーバーの認可セクション。

basicAuthbearerTokenbearerTokenFile と同時に設定することはできません。

basicAuth

object

API サーバーの BasicAuth 設定。

authorizationbearerTokenbearerTokenFile と同時に設定することはできません。

bearerToken

string

警告: トークン値がクリアテキストで表示されるため、このフィールドは使用しないでください。authorization の使用を優先してください。

非推奨: 今後のリリースで削除される予定です。

bearerTokenFile

string

apiserver にアクセスするためのベアラトークンを読み取るためのファイル。

basicAuthauthorizationbearerToken と同時に設定することはできません。

非推奨: 今後のリリースで削除される予定です。authorization の使用を優先してください。

host

string

ホスト名または IP アドレスとオプションのポート番号で構成される Kubernetes API アドレス。

tlsConfig

object

API サーバーに使用する TLS 設定。

8.1.83. .spec.apiserverConfig.authorization

説明

API サーバーの認可セクション。

basicAuthbearerTokenbearerTokenFile と同時に設定することはできません。

object
プロパティー説明

credentials

object

認証の認証情報を含む、namespace 内の Secret のキーを選択します。

credentialsFile

string

シークレットを読み取るファイル。credentials とは相互に排他的です。

type

string

認証タイプを定義します。この値は大文字と小文字を区別しません。

"Basic" はサポートされている値ではありません。

デフォルト: "Bearer"

8.1.84. .spec.apiserverConfig.authorization.credentials

説明
認証の認証情報を含む、namespace 内の Secret のキーを選択します。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.85. .spec.apiserverConfig.basicAuth

説明

API サーバーの BasicAuth 設定。

authorizationbearerTokenbearerTokenFile と同時に設定することはできません。

object
プロパティー説明

password

object

password は、認証用のパスワードを含むシークレットのキーを指定します。

username

object

username は、認証用のユーザー名を含むシークレットのキーを指定します。

8.1.86. .spec.apiserverConfig.basicAuth.password

説明
password は、認証用のパスワードを含むシークレットのキーを指定します。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.87. .spec.apiserverConfig.basicAuth.username

説明
username は、認証用のユーザー名を含むシークレットのキーを指定します。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.88. .spec.apiserverConfig.tlsConfig

説明
API サーバーに使用する TLS 設定。
object
プロパティー説明

ca

object

サーバー証明書の検証に使用される認証局。

caFile

string

ターゲットに使用する Prometheus コンテナー内の CA 証明書へのパス。

cert

object

クライアント認証を行うときに提示するクライアント証明書。

certFile

string

ターゲットの Prometheus コンテナー内のクライアント証明書ファイルへのパス。

insecureSkipVerify

boolean

ターゲット証明書の検証を無効にします。

keyFile

string

ターゲットの Prometheus コンテナー内のクライアントキーファイルへのパス。

keySecret

object

ターゲットのクライアントキーファイルを含むシークレット。

maxVersion

string

許容可能な最大 TLS バージョン。

Prometheus v2.41.0 以降が必要です。

minVersion

string

許容可能な最小 TLS バージョン。

Prometheus v2.35.0 以降が必要です。

serverName

string

ターゲットのホスト名を確認するために使用されます。

8.1.89. .spec.apiserverConfig.tlsConfig.ca

説明
サーバー証明書の検証に使用される認証局。
object
プロパティー説明

configMap

object

ターゲットに使用するデータを含む ConfigMap。

secret

object

ターゲットに使用するデータを含むシークレット。

8.1.90. .spec.apiserverConfig.tlsConfig.ca.configMap

説明
ターゲットに使用するデータを含む ConfigMap。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

8.1.91. .spec.apiserverConfig.tlsConfig.ca.secret

説明
ターゲットに使用するデータを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.92. .spec.apiserverConfig.tlsConfig.cert

説明
クライアント認証を行うときに提示するクライアント証明書。
object
プロパティー説明

configMap

object

ターゲットに使用するデータを含む ConfigMap。

secret

object

ターゲットに使用するデータを含むシークレット。

8.1.93. .spec.apiserverConfig.tlsConfig.cert.configMap

説明
ターゲットに使用するデータを含む ConfigMap。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

8.1.94. .spec.apiserverConfig.tlsConfig.cert.secret

説明
ターゲットに使用するデータを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.95. .spec.apiserverConfig.tlsConfig.keySecret

説明
ターゲットのクライアントキーファイルを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

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

deny

boolean

 

8.1.97. .spec.containers

説明

コンテナーを使用すると、追加のコンテナーを挿入したり、Operator が生成したコンテナーを変更したりできます。これを使用すると、Pod に認証プロキシーを追加したり、Operator が生成したコンテナーの動作を変更したりすることができます。ここで説明するコンテナーは、同じ名前を共有し、戦略的マージパッチを介して変更が行われる場合、Operator が生成したコンテナーを変更します。

Operator によって管理されるコンテナーの名前は次のとおりです: * prometheus * config-reloader * thanos-sidecar

コンテナーのオーバーライドは、メンテナーがサポートする範囲外であり、そうすることで、この動作が予告なしにいつでも中断する可能性があることを認めます。

array

8.1.98. .spec.containers[]

説明
Pod 内で実行する単一のアプリケーションコンテナー。
object
必須
  • name
プロパティー説明

args

array (string)

エントリーポイントへの引数。これが指定されていない場合は、コンテナーイメージの 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

command

array (string)

エントリーポイント配列。シェル内では実行されません。これが指定されていない場合は、コンテナーイメージの 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

env

array

コンテナーに設定する環境変数のリスト。これを更新することはできません。

env[]

object

EnvVar は、コンテナーに存在する環境変数を表します。

envFrom

array

コンテナー内の環境変数に入力するソースのリスト。ソース内で定義されたキーは C_IDENTIFIER である必要があります。無効なキーはすべて、コンテナーの起動時にイベントとして報告されます。キーが複数のソースに存在する場合、最後のソースに関連付けられた値が優先されます。重複キーを持つ環境によって定義された値が優先されます。これを更新することはできません。

envFrom[]

object

EnvFromSource は、一連の ConfigMap のソースを表します

image

string

コンテナーイメージ名詳細: https://kubernetes.io/docs/concepts/containers/images このフィールドはオプションであり、高レベルの設定管理で、Deployments や StatefulSets などのワークロードコントローラーのコンテナーイメージをデフォルトまたはオーバーライドできます。

imagePullPolicy

string

イメージプルポリシーAlways、Never、IfNotPresent のいずれか。デフォルトは、:latest タグが指定されている場合は常に、それ以外の場合は IfNotPresent です。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/containers/images#updating-images

lifecycle

object

コンテナーのライフサイクルイベントに対応して管理システムが実行する必要のあるアクション。これを更新することはできません。

livenessProbe

object

コンテナーの活性度の定期的な調査。プローブが失敗した場合、コンテナーは再起動されます。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

name

string

DNS_LABEL として指定されたコンテナーの名前。Pod 内の各コンテナーには、一意の名前 (DNS_LABEL) が必要です。これを更新することはできません。

ports

array

コンテナーから公開するポートのリスト。ここでポートを指定しなくても、そのポートが公開されるのを防ぐことはできません。コンテナー内のデフォルトの "0.0.0.0" アドレスをリッスンしているポートは、ネットワークからアクセスできます。戦略的マージパッチを使用してこの配列を変更すると、データが破損する可能性があります。詳細は、https://github.com/kubernetes/kubernetes/issues/108255 を参照してください。これを更新することはできません。

ports[]

object

ContainerPort は、単一のコンテナー内のネットワークポートを表します。

readinessProbe

object

コンテナーサービスの準備状況の定期的な調査。プローブが失敗すると、コンテナーはサービスエンドポイントから削除されます。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

resizePolicy

array

コンテナーのリソースサイズ変更ポリシー。

resizePolicy[]

object

ContainerResizePolicy は、コンテナーのリソースサイズ変更ポリシーを表します。

resources

object

このコンテナーに必要なコンピューティングリソース。これを更新することはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。

restartPolicy

string

RestartPolicy は、Pod 内の個々のコンテナーの再起動動作を定義します。このフィールドは init コンテナーに対してのみ設定でき、許可される値は "Always" のみです。init 以外のコンテナーの場合、またはこのフィールドが指定されていない場合、再起動の動作は Pod の再起動ポリシーとコンテナータイプによって定義されます。init コンテナーの RestartPolicy を "Always" に設定すると、次の効果が得られます: この init コンテナーは、すべての通常のコンテナーが終了するまで、終了時に継続的に再起動されます。すべての通常のコンテナーが完了すると、restartPolicy が "Always" のすべての init コンテナーがシャットダウンされます。このライフサイクルは通常の init コンテナーとは異なり、多くの場合、"sidecar" コンテナーと呼ばれます。この init コンテナーは、引き続き init コンテナーシーケンス内で開始されますが、次の init コンテナーに進む前にコンテナーが完了するのを待機しません。代わりに、この init コンテナーが起動した直後、または任意の startupProbe が正常に完了した後に、次の init コンテナーが起動します。

securityContext

object

SecurityContext は、コンテナーを実行する必要があるセキュリティーオプションを定義します。設定されている場合、SecurityContext のフィールドは PodSecurityContext の同等のフィールドをオーバーライドします。詳細: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/

startupProbe

object

StartupProbe は、Pod が正常に初期化されたことを示します。指定した場合、これが正常に完了するまで、他のプローブは実行されません。このプローブが失敗すると、livenessProbe が失敗したかのように、Pod が再起動されます。これは、Pod のライフサイクルの開始時に、定常状態の操作中よりもデータのロードやキャッシュのウォームアップに長い時間がかかる可能性がある場合に、さまざまなプローブパラメーターを提供するために使用できます。これは更新できません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

stdin

boolean

このコンテナーがコンテナーランタイムで stdin にバッファーを割り当てる必要があるかどうか。これが設定されていない場合、コンテナー内の stdin からの読み取りは常に EOF になります。デフォルトは false です。

stdinOnce

boolean

コンテナーランタイムが、単一の接続によって開かれた後に stdin チャネルを閉じる必要があるかどうか。stdin が true の場合、stdin ストリームは複数の接続セッションにわたって開いたままになります。stdinOnce が true に設定されている場合、stdin はコンテナーの起動時に開かれ、最初のクライアントが stdin に接続するまで空になり、クライアントが切断されるまで開いたままでデータを受け入れます。切断されると、stdin は閉じられ、コンテナーが再起動されるまで閉じられたままになります。。このフラグが false の場合、stdin から読み取るコンテナープロセスは EOF を受信しません。デフォルトは false です。

terminationMessagePath

string

オプション: コンテナーの終了メッセージが書き込まれるファイルがコンテナーのファイルシステムにマウントされるパス。書き込まれるメッセージは、アサーション失敗メッセージなどの簡単な最終ステータスを目的としています。4096 バイトを超える場合、ノードによって切り捨てられます。すべてのコンテナーの合計メッセージ長は 12kb に制限されます。デフォルトは/dev/termination-log です。これを更新することはできません。

terminationMessagePolicy

string

終了メッセージの入力方法を示します。ファイルは、terminationMessagePath の内容を使用して、成功と失敗の両方でコンテナーステータスメッセージを入力します。終了メッセージファイルが空で、コンテナーがエラーで終了した場合、FallbackToLogsOnError はコンテナーログ出力の最後のチャンクを使用します。ログ出力は、2048 バイトまたは 80 行のいずれか小さい方に制限されます。デフォルトは File です。これを更新することはできません。

tty

boolean

このコンテナーがそれ自体に TTY を割り当てる必要があるかどうかには、'stdin' が true である必要もあります。デフォルトは false です。

volumeDevices

array

volumeDevices は、コンテナーによって使用されるブロックデバイスのリストです。

volumeDevices[]

object

volumeDevice は、コンテナー内の raw ブロックデバイスのマッピングを記述します。

volumeMounts

array

コンテナーのファイルシステムにマウントする Pod ボリューム。これを更新することはできません。

volumeMounts[]

object

VolumeMount は、コンテナー内でのボリュームのマウントを説明します。

workingDir

string

コンテナーの作業ディレクトリー。指定しない場合、コンテナーランタイムのデフォルトが使用されます。これは、コンテナーイメージで設定されている可能性があります。これを更新することはできません。

8.1.99. .spec.containers[].env

説明
コンテナーに設定する環境変数のリスト。これを更新することはできません。
array

8.1.100. .spec.containers[].env[]

説明
EnvVar は、コンテナーに存在する環境変数を表します。
object
必須
  • name
プロパティー説明

name

string

環境変数の名前。C_IDENTIFIER でなければなりません。

value

string

変数参照 $(VAR_NAME) は、コンテナー内で以前に定義された環境変数と任意のサービス環境変数を使用してデプロイメントされます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、"(VAR_NAME)" は文字列リテラル "$(VAR_NAME)" を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。デフォルトは "" です。

valueFrom

object

環境変数の値のソースです。値が空でない場合は使用できません。

8.1.101. .spec.containers[].env[].valueFrom

説明
環境変数の値のソースです。値が空でない場合は使用できません。
object
プロパティー説明

configMapKeyRef

object

ConfigMap のキーを選択します。

fieldRef

object

Pod のフィールドを選択します。metadata.name、metadata.namespace、metadata.labels['<KEY>']metadata.annotations['<KEY>']、spec.nodeName、spec.serviceAccountName、status.hostIP、status.podIP、status.podIPs がサポートされています。

resourceFieldRef

object

コンテナーのリソースを選択します。現在、リソースの制限とリクエスト (limits.cpu、limits.memory、limits.ephemeral-storage、requests.cpu、requests.memory、requests.ephemeral-storage) のみがサポートされています。

secretKeyRef

object

Pod の namespace でシークレットのキーを選択します

8.1.102. .spec.containers[].env[].valueFrom.configMapKeyRef

説明
ConfigMap のキーを選択します。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

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

apiVersion

string

FieldPath が記述されているスキーマのバージョン。デフォルトは "v1" です。

fieldPath

string

指定された 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
プロパティー説明

containerName

string

コンテナー名: ボリュームには必須、env 変数にはオプション

divisor

integer-or-string

公開されたリソースの出力形式を指定します。デフォルトは "1" です。

resource

string

必須: 選択するリソース

8.1.105. .spec.containers[].env[].valueFrom.secretKeyRef

説明
Pod の namespace でシークレットのキーを選択します
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.106. .spec.containers[].envFrom

説明
コンテナー内の環境変数に入力するソースのリスト。ソース内で定義されたキーは C_IDENTIFIER である必要があります。無効なキーはすべて、コンテナーの起動時にイベントとして報告されます。キーが複数のソースに存在する場合、最後のソースに関連付けられた値が優先されます。重複キーを持つ環境によって定義された値が優先されます。これを更新することはできません。
array

8.1.107. .spec.containers[].envFrom[]

説明
EnvFromSource は、一連の ConfigMap のソースを表します
object
プロパティー説明

configMapRef

object

選択する ConfigMap

prefix

string

ConfigMap の各キーの前に追加するオプションの識別子。C_IDENTIFIER でなければなりません。

secretRef

object

から選択する秘密

8.1.108. .spec.containers[].envFrom[].configMapRef

説明
選択する ConfigMap
object
プロパティー説明

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap を定義する必要があるかどうかを指定します

8.1.109. .spec.containers[].envFrom[].secretRef

説明
から選択する秘密
object
プロパティー説明

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットを定義する必要があるかどうかを指定します

8.1.110. .spec.containers[].lifecycle

説明
コンテナーのライフサイクルイベントに対応して管理システムが実行する必要のあるアクション。これを更新することはできません。
object
プロパティー説明

postStart

object

PostStart は、コンテナーが作成された直後に呼び出されます。ハンドラーに障害が発生した場合、コンテナーは終了し、再始動ポリシーに従って再始動されます。フックが完了するまでのコンテナーブロックの他の管理。詳細: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks

preStop

object

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

object

Exec は実行するアクションを指定します。

httpGet

object

HTTPGet は、実行する http リクエストを指定します。

sleep

object

Sleep は、コンテナーが終了されるまでのスリープ期間を表します。

tcpSocket

object

非推奨。TCPSocket は LifecycleHandler としてサポートされておらず、後方互換性を確保するために保持されています。このフィールドは検証されず、tcp ハンドラーが指定されている場合、ライフサイクルフックは実行時に失敗します。

8.1.112. .spec.containers[].lifecycle.postStart.exec

説明
Exec は実行するアクションを指定します。
object
プロパティー説明

command

array (string)

コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。

8.1.113. .spec.containers[].lifecycle.postStart.httpGet

説明
HTTPGet は、実行する http リクエストを指定します。
object
必須
  • port
プロパティー説明

host

string

接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。

httpHeaders

array

リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。

httpHeaders[]

object

HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します

path

string

HTTP サーバーでアクセスするパス。

port

integer-or-string

コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。

scheme

string

ホストへの接続に使用するスキーム。デフォルトは 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
プロパティー説明

name

string

ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。

value

string

ヘッダーフィールド値

8.1.116. .spec.containers[].lifecycle.postStart.sleep

説明
Sleep は、コンテナーが終了されるまでのスリープ期間を表します。
object
必須
プロパティー説明

integer

Seconds はスリープする秒数です。

8.1.117. .spec.containers[].lifecycle.postStart.tcpSocket

説明
非推奨。TCPSocket は LifecycleHandler としてサポートされておらず、後方互換性を確保するために保持されています。このフィールドは検証されず、tcp ハンドラーが指定されている場合、ライフサイクルフックは実行時に失敗します。
object
必須
  • port
プロパティー説明

host

string

オプション: 接続するホスト名。デフォルトは Pod IP です。

port

integer-or-string

コンテナーでアクセスするポートの番号または名前。番号は 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

object

Exec は実行するアクションを指定します。

httpGet

object

HTTPGet は、実行する http リクエストを指定します。

sleep

object

Sleep は、コンテナーが終了されるまでのスリープ期間を表します。

tcpSocket

object

非推奨。TCPSocket は LifecycleHandler としてサポートされておらず、後方互換性を確保するために保持されています。このフィールドは検証されず、tcp ハンドラーが指定されている場合、ライフサイクルフックは実行時に失敗します。

8.1.119. .spec.containers[].lifecycle.preStop.exec

説明
Exec は実行するアクションを指定します。
object
プロパティー説明

command

array (string)

コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。

8.1.120. .spec.containers[].lifecycle.preStop.httpGet

説明
HTTPGet は、実行する http リクエストを指定します。
object
必須
  • port
プロパティー説明

host

string

接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。

httpHeaders

array

リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。

httpHeaders[]

object

HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します

path

string

HTTP サーバーでアクセスするパス。

port

integer-or-string

コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。

scheme

string

ホストへの接続に使用するスキーム。デフォルトは 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
プロパティー説明

name

string

ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。

value

string

ヘッダーフィールド値

8.1.123. .spec.containers[].lifecycle.preStop.sleep

説明
Sleep は、コンテナーが終了されるまでのスリープ期間を表します。
object
必須
プロパティー説明

integer

Seconds はスリープする秒数です。

8.1.124. .spec.containers[].lifecycle.preStop.tcpSocket

説明
非推奨。TCPSocket は LifecycleHandler としてサポートされておらず、後方互換性を確保するために保持されています。このフィールドは検証されず、tcp ハンドラーが指定されている場合、ライフサイクルフックは実行時に失敗します。
object
必須
  • port
プロパティー説明

host

string

オプション: 接続するホスト名。デフォルトは Pod IP です。

port

integer-or-string

コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。

8.1.125. .spec.containers[].livenessProbe

説明
コンテナーの活性度の定期的な調査。プローブが失敗した場合、コンテナーは再起動されます。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
object
プロパティー説明

exec

object

Exec は実行するアクションを指定します。

failureThreshold

integer

正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。

grpc

object

GRPC は、GRPC ポートに関連するアクションを指定します。

httpGet

object

HTTPGet は、実行する http リクエストを指定します。

initialDelaySeconds

integer

コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

integer

プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。

successThreshold

integer

失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。

tcpSocket

object

TCPSocket は、TCP ポートを含むアクションを指定します。

terminationGracePeriodSeconds

integer

プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。

timeoutSeconds

integer

プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

8.1.126. .spec.containers[].livenessProbe.exec

説明
Exec は実行するアクションを指定します。
object
プロパティー説明

command

array (string)

コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。

8.1.127. .spec.containers[].livenessProbe.grpc

説明
GRPC は、GRPC ポートに関連するアクションを指定します。
object
必須
  • port
プロパティー説明

port

integer

gRPC サービスのポート番号。番号は 1〜65535 の範囲である必要があります。

service

string

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

host

string

接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。

httpHeaders

array

リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。

httpHeaders[]

object

HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します

path

string

HTTP サーバーでアクセスするパス。

port

integer-or-string

コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。

scheme

string

ホストへの接続に使用するスキーム。デフォルトは HTTP です。

8.1.129. .spec.containers[].livenessProbe.httpGet.httpHeaders

説明
リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
array

8.1.130. .spec.containers[].livenessProbe.httpGet.httpHeaders[]

説明
HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
object
必須
  • name
  • value
プロパティー説明

name

string

ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。

value

string

ヘッダーフィールド値

8.1.131. .spec.containers[].livenessProbe.tcpSocket

説明
TCPSocket は、TCP ポートを含むアクションを指定します。
object
必須
  • port
プロパティー説明

host

string

オプション: 接続するホスト名。デフォルトは Pod IP です。

port

integer-or-string

コンテナーでアクセスするポートの番号または名前。番号は 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
プロパティー説明

containerPort

integer

Pod の IP アドレスで公開するポートの数。これは有効なポート番号である必要があります、0<x<65536。

hostIP

string

外部ポートをバインドするホスト IP。

hostPort

integer

ホストで公開するポートの数。指定する場合、これは有効なポート番号、0<x<65536 である必要があります。HostNetwork が指定されている場合、これは ContainerPort と一致する必要があります。ほとんどのコンテナーはこれを必要としません。

name

string

指定する場合、これは IANA_SVC_NAME であり、Pod 内で一意である必要があります。Pod 内の名前付きポートにはそれぞれ一意の名前を付ける必要があります。サービスが参照できるポートの名前。

protocol

string

ポートのプロトコル。UDP、TCP、または SCTP である必要があります。デフォルトは "TCP" です。

8.1.134. .spec.containers[].readinessProbe

説明
コンテナーサービスの準備状況の定期的な調査。プローブが失敗すると、コンテナーはサービスエンドポイントから削除されます。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
object
プロパティー説明

exec

object

Exec は実行するアクションを指定します。

failureThreshold

integer

正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。

grpc

object

GRPC は、GRPC ポートに関連するアクションを指定します。

httpGet

object

HTTPGet は、実行する http リクエストを指定します。

initialDelaySeconds

integer

コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

integer

プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。

successThreshold

integer

失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。

tcpSocket

object

TCPSocket は、TCP ポートを含むアクションを指定します。

terminationGracePeriodSeconds

integer

プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。

timeoutSeconds

integer

プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

8.1.135. .spec.containers[].readinessProbe.exec

説明
Exec は実行するアクションを指定します。
object
プロパティー説明

command

array (string)

コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。

8.1.136. .spec.containers[].readinessProbe.grpc

説明
GRPC は、GRPC ポートに関連するアクションを指定します。
object
必須
  • port
プロパティー説明

port

integer

gRPC サービスのポート番号。番号は 1〜65535 の範囲である必要があります。

service

string

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

host

string

接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。

httpHeaders

array

リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。

httpHeaders[]

object

HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します

path

string

HTTP サーバーでアクセスするパス。

port

integer-or-string

コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。

scheme

string

ホストへの接続に使用するスキーム。デフォルトは HTTP です。

8.1.138. .spec.containers[].readinessProbe.httpGet.httpHeaders

説明
リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
array

8.1.139. .spec.containers[].readinessProbe.httpGet.httpHeaders[]

説明
HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
object
必須
  • name
  • value
プロパティー説明

name

string

ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。

value

string

ヘッダーフィールド値

8.1.140. .spec.containers[].readinessProbe.tcpSocket

説明
TCPSocket は、TCP ポートを含むアクションを指定します。
object
必須
  • port
プロパティー説明

host

string

オプション: 接続するホスト名。デフォルトは Pod IP です。

port

integer-or-string

コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。

8.1.141. .spec.containers[].resizePolicy

説明
コンテナーのリソースサイズ変更ポリシー。
array

8.1.142. .spec.containers[].resizePolicy[]

説明
ContainerResizePolicy は、コンテナーのリソースサイズ変更ポリシーを表します。
object
必須
  • resourceName
  • restartPolicy
プロパティー説明

resourceName

string

このリソースサイズ変更ポリシーが適用されるリソースの名前。対応している値は、cpu、memory です。

restartPolicy

string

指定されたリソースのサイズが変更されたときに適用する再起動ポリシー。指定しない場合、デフォルトの NotRequired が設定されます。

8.1.143. .spec.containers[].resources

説明
このコンテナーに必要なコンピューティングリソース。これを更新することはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。
object
プロパティー説明

claims

array

Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。

これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。

このフィールドは不変です。これはコンテナーにのみ設定できます。

claims[]

object

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

limits

integer-or-string

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

requests

integer-or-string

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

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

string

name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。

request

string

request は、参照されるクレーム内のリクエストに対して選択された名前です。空の場合、クレームからのすべてのものが利用可能になり、それ以外の場合はこの request の結果のみが利用可能になります。

8.1.146. .spec.containers[].securityContext

説明
SecurityContext は、コンテナーを実行する必要があるセキュリティーオプションを定義します。設定されている場合、SecurityContext のフィールドは PodSecurityContext の同等のフィールドをオーバーライドします。詳細: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/
object
プロパティー説明

allowPrivilegeEscalation

boolean

AllowPrivilegeEscalation は、プロセスがその親プロセスよりも多くの特権を取得できるかどうかを制御します。このブール値は、no_new_privs フラグがコンテナープロセスに設定されるかどうかを直接制御します。コンテナーが 1) 特権で実行されており、CAP_SYS_ADMIN が割り当てられている場合、2) AllowPrivilegeEscalation は常に true です。spec.os.name が windows の場合は、このフィールドは設定できないことに注意してください。

appArmorProfile

object

appArmorProfile は、このコンテナーで使用する AppArmor オプションです。設定されている場合、このプロファイルによって Pod の appArmorProfile がオーバーライドされます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

capabilities

object

コンテナーの実行時に追加/削除する機能。デフォルトは、コンテナーランタイムによって付与されるデフォルトの機能セットです。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

privileged

boolean

コンテナーを特権モードで実行します。特権コンテナー内のプロセスは、基本的にホスト上の root と同等です。デフォルトは false です。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

procMount

string

procMount は、コンテナーに使用する proc マウントのタイプを示します。デフォルト値は Default で、読み取り専用パスおよびマスクされたパスのコンテナーランタイムのデフォルトを使用します。これには、ProcMountType 機能フラグを有効にする必要があります。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

readOnlyRootFilesystem

boolean

このコンテナーに読み取り専用のルートファイルシステムがあるかどうか。デフォルトは false です。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

runAsGroup

integer

コンテナープロセスのエントリーポイントを実行するための GID。設定されていない場合は、実行時のデフォルトを使用します。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

runAsNonRoot

boolean

コンテナーが root 以外のユーザーとして実行される必要があることを示します。true の場合、Kubelet は実行時にイメージを検証して、イメージが UID 0(ルート) として実行されないことを確認し、実行される場合はコンテナーの開始に失敗します。未設定または false の場合、そのような検証は実行されません。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。

runAsUser

integer

コンテナープロセスのエントリーポイントを実行するための UID。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

seLinuxOptions

object

コンテナーに適用される SELinux コンテキスト。指定しない場合、コンテナーランタイムはコンテナーごとにランダムな SELinux コンテキストを割り当てます。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

seccompProfile

object

このコンテナーで使用する seccomp オプション。Pod とコンテナーの両方のレベルで seccomp オプションが提供されている場合、コンテナーオプションは Pod オプションを上書きします。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

windowsOptions

object

すべてのコンテナーに適用される 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

string

localhostProfile は、使用する必要があるノードにロードされたプロファイルを示します。プロファイルが機能するには、ノードで事前に設定されている必要があります。プロファイルのロードされた名前と一致する必要があります。タイプが "Localhost" の場合にのみ設定する必要があります。

type

string

type は、適用される AppArmor プロファイルの種類を示します。有効なオプション: Localhost - ノードに事前にロードされたプロファイル。RuntimeDefault - コンテナーランタイムのデフォルトのプロファイル。制限なし - AppArmor の強制はありません。

8.1.148. .spec.containers[].securityContext.capabilities

説明
コンテナーの実行時に追加/削除する機能。デフォルトは、コンテナーランタイムによって付与されるデフォルトの機能セットです。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
object
プロパティー説明

add

array (string)

追加された機能

drop

array (string)

削除された機能

8.1.149. .spec.containers[].securityContext.seLinuxOptions

説明
コンテナーに適用される SELinux コンテキスト。指定しない場合、コンテナーランタイムはコンテナーごとにランダムな SELinux コンテキストを割り当てます。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
object
プロパティー説明

level

string

Level は、コンテナーに適用される SELinux レベルのラベルです。

role

string

Role は、コンテナーに適用される SELinux ロールラベルです。

type

string

Type は、コンテナーに適用される SELinux タイプのラベルです。

user

string

User は、コンテナーに適用される SELinux ユーザーラベルです。

8.1.150. .spec.containers[].securityContext.seccompProfile

説明
このコンテナーで使用する seccomp オプション。Pod とコンテナーの両方のレベルで seccomp オプションが提供されている場合、コンテナーオプションは Pod オプションを上書きします。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
object
必須
  • type
プロパティー説明

localhostProfile

string

localhostProfile は、ノード上のファイルで定義されたプロファイルを使用する必要があることを示します。プロファイルが機能するには、ノードで事前に設定されている必要があります。kubelet の設定済みの seccomp プロファイルの場所を基準にして、降順のパスである必要があります。タイプが "Localhost" の場合は設定する必要があります。他のタイプには設定しないでください。

type

string

type は、適用される seccomp プロファイルの種類を示します。有効なオプションは以下のとおりです。

Localhost - ノード上のファイルで定義されたプロファイルを使用する必要があります。RuntimeDefault- コンテナーのランタイムデフォルトプロファイルを使用する必要があります。制限なし - プロファイルを適用しないでください。

8.1.151. .spec.containers[].securityContext.windowsOptions

説明
すべてのコンテナーに適用される Windows 固有の設定。指定しない場合、PodSecurityContext のオプションが使用されます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が linux の場合は、このフィールドを設定できないことに注意してください。
object
プロパティー説明

gmsaCredentialSpec

string

GMSACredentialSpec は、GMSA アドミッション Webhook (https://github.com/kubernetes-sigs/windows-gmsa) が GMSACredentialSpecName フィールドで指定された GMSA クレデンシャル仕様のコンテンツをインライン化する場所です。

gmsaCredentialSpecName

string

GMSACredentialSpecName は、使用する GMSA 認証情報仕様の名前です。

hostProcess

boolean

hostProcess は、コンテナーを 'Host Process' コンテナーとして実行する必要があるかどうかを決定します。Pod のすべてのコンテナーは、同じ有効な HostProcess 値を持っている必要があります (HostProcess コンテナーと非 HostProcess コンテナーを混在させることはできません)。さらに、HostProcess が true の場合、HostNetwork も true に設定する必要があります。

runAsUserName

string

コンテナープロセスのエントリーポイントを実行するための 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

object

Exec は実行するアクションを指定します。

failureThreshold

integer

正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。

grpc

object

GRPC は、GRPC ポートに関連するアクションを指定します。

httpGet

object

HTTPGet は、実行する http リクエストを指定します。

initialDelaySeconds

integer

コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

integer

プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。

successThreshold

integer

失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。

tcpSocket

object

TCPSocket は、TCP ポートを含むアクションを指定します。

terminationGracePeriodSeconds

integer

プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。

timeoutSeconds

integer

プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

8.1.153. .spec.containers[].startupProbe.exec

説明
Exec は実行するアクションを指定します。
object
プロパティー説明

command

array (string)

コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。

8.1.154. .spec.containers[].startupProbe.grpc

説明
GRPC は、GRPC ポートに関連するアクションを指定します。
object
必須
  • port
プロパティー説明

port

integer

gRPC サービスのポート番号。番号は 1〜65535 の範囲である必要があります。

service

string

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

host

string

接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。

httpHeaders

array

リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。

httpHeaders[]

object

HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します

path

string

HTTP サーバーでアクセスするパス。

port

integer-or-string

コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。

scheme

string

ホストへの接続に使用するスキーム。デフォルトは HTTP です。

8.1.156. .spec.containers[].startupProbe.httpGet.httpHeaders

説明
リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
array

8.1.157. .spec.containers[].startupProbe.httpGet.httpHeaders[]

説明
HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
object
必須
  • name
  • value
プロパティー説明

name

string

ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。

value

string

ヘッダーフィールド値

8.1.158. .spec.containers[].startupProbe.tcpSocket

説明
TCPSocket は、TCP ポートを含むアクションを指定します。
object
必須
  • port
プロパティー説明

host

string

オプション: 接続するホスト名。デフォルトは Pod IP です。

port

integer-or-string

コンテナーでアクセスするポートの番号または名前。番号は 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

string

devicePath は、デバイスがマップされるコンテナー内のパスです。

name

string

name は、Pod 内の persistentVolumeClaim の名前と一致する必要があります

8.1.161. .spec.containers[].volumeMounts

説明
コンテナーのファイルシステムにマウントする Pod ボリューム。これを更新することはできません。
array

8.1.162. .spec.containers[].volumeMounts[]

説明
VolumeMount は、コンテナー内でのボリュームのマウントを説明します。
object
必須
  • mountPath
  • name
プロパティー説明

mountPath

string

ボリュームをマウントする必要があるコンテナー内のパス。':' を含めることはできません。

mountPropagation

string

mountPropagation は、マウントがホストからコンテナーに、またはその逆にどのように伝播されるかを決定します。設定されていない場合、MountPropagationNone が使用されます。このフィールドは 1.10 のベータ版です。RecursiveReadOnly が IfPossible または Enabled に設定されている場合、MountPropagation は None または未指定 (デフォルトは None) にする必要があります。

name

string

ボリュームの名前に一致する必要があります。

readOnly

boolean

true の場合は読み取り専用、それ以外の場合は読み取り/書き込み (false または指定なし) でマウントされます。デフォルトは false です。

recursiveReadOnly

string

RecursiveReadOnly は、読み取り専用マウントを再帰的に処理するかどうかを指定します。

ReadOnly が false の場合、このフィールドには意味がなく、未指定にする必要があります。

ReadOnly が true で、このフィールドが Disabled に設定されている場合、マウントは再帰的に読み取り専用にはなりません。このフィールドが IfPossible に設定されている場合、コンテナーランタイムでサポートされている場合は、マウントは再帰的に読み取り専用になります。このフィールドが Enabled に設定されている場合で、コンテナーランタイムでサポートされている場合は、マウントが再帰的に読み取り専用になり、そうでない場合は Pod が起動されず、理由を示すエラーが生成されます。

このフィールドが IfPossible または Enabled に設定されている場合、MountPropagation は None に設定する必要があります (または未指定にする必要があります。この場合、デフォルトは None になります)。

このフィールドが指定されていない場合は、無効と同じ扱いになります。

subPath

string

コンテナーのボリュームをマウントする必要があるボリューム内のパス。デフォルトは "" (ボリュームのルート) です。

subPathExpr

string

コンテナーのボリュームをマウントする必要があるボリューム内の拡張パス。SubPath と同様に動作しますが、環境変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。デフォルトは "" (ボリュームのルート) です。SubPathExpr と SubPath は相互に排他的です。

8.1.163. .spec.dnsConfig

説明
Pod の DNS 設定を定義します。
object
プロパティー説明

nameservers

array (string)

DNS ネームサーバーの IP アドレスのリスト。これは、DNSPolicy から生成されたベースネームサーバーに追加されます。

options

array

DNS リゾルバーオプションのリスト。これは、DNSPolicy から生成された基本オプションとマージされます。オプションで指定された解決オプションは、ベース DNS ポリシーに表示されるものをオーバーライドします。

options[]

object

PodDNSConfigOption は、Pod の DNS リゾルバーオプションを定義します。

searches

array (string)

ホスト名ルックアップ用の DNS 検索ドメインのリスト。これは、DNSPolicy から生成された基本検索パスに追加されます。

8.1.164. .spec.dnsConfig.options

説明
DNS リゾルバーオプションのリスト。これは、DNSPolicy から生成された基本オプションとマージされます。オプションで指定された解決オプションは、ベース DNS ポリシーに表示されるものをオーバーライドします。
array

8.1.165. .spec.dnsConfig.options[]

説明
PodDNSConfigOption は、Pod の DNS リゾルバーオプションを定義します。
object
必須
  • name
プロパティー説明

name

string

名前は必須であり、一意である必要があります。

value

string

値は任意です。

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

group

string

参照先のグループ。指定しない場合は、デフォルトで monitoring.coreos.com になります。

name

string

参照先の名前。設定されていない場合は、namespace 内のすべてのリソースが一致します。

namespace

string

参照先の namespace。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

resource

string

参照先のリソース。

8.1.168. .spec.exemplars

説明
実行時に再読み込み可能な Exemplar 関連の設定。有効にするには、exemplar-storage 機能フラグを有効にする必要があります。
object
プロパティー説明

maxSize

integer

すべてのシリーズでメモリーに保存されるエグザンプラーの最大数。

エグザンプラーをスクレイピングするには、spec.enableFeature オプションを使用して exemplar-storage 自体を有効にする必要があることに注意してください。

設定されていない場合、Prometheus はデフォルト値を使用します。値が 0 または 0 未満の場合、ストレージは無効になります。

8.1.169. .spec.hostAliases

説明
指定された場合に Pod のホストファイルに注入されるホストと IP のオプションのリスト。
array

8.1.170. .spec.hostAliases[]

説明
HostAlias は、Pod の hosts ファイルのエントリーとして挿入される IP とホスト名の間のマッピングを保持します。
object
必須
  • hostnames
  • ip
プロパティー説明

hostnames

array (string)

上記の IP アドレスのホスト名。

ip

string

ホストファイルエントリーの 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
プロパティー説明

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: 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
プロパティー説明

args

array (string)

エントリーポイントへの引数。これが指定されていない場合は、コンテナーイメージの 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

command

array (string)

エントリーポイント配列。シェル内では実行されません。これが指定されていない場合は、コンテナーイメージの 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

env

array

コンテナーに設定する環境変数のリスト。これを更新することはできません。

env[]

object

EnvVar は、コンテナーに存在する環境変数を表します。

envFrom

array

コンテナー内の環境変数に入力するソースのリスト。ソース内で定義されたキーは C_IDENTIFIER である必要があります。無効なキーはすべて、コンテナーの起動時にイベントとして報告されます。キーが複数のソースに存在する場合、最後のソースに関連付けられた値が優先されます。重複キーを持つ環境によって定義された値が優先されます。これを更新することはできません。

envFrom[]

object

EnvFromSource は、一連の ConfigMap のソースを表します

image

string

コンテナーイメージ名詳細: https://kubernetes.io/docs/concepts/containers/images このフィールドはオプションであり、高レベルの設定管理で、Deployments や StatefulSets などのワークロードコントローラーのコンテナーイメージをデフォルトまたはオーバーライドできます。

imagePullPolicy

string

イメージプルポリシーAlways、Never、IfNotPresent のいずれか。デフォルトは、:latest タグが指定されている場合は常に、それ以外の場合は IfNotPresent です。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/containers/images#updating-images

lifecycle

object

コンテナーのライフサイクルイベントに対応して管理システムが実行する必要のあるアクション。これを更新することはできません。

livenessProbe

object

コンテナーの活性度の定期的な調査。プローブが失敗した場合、コンテナーは再起動されます。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

name

string

DNS_LABEL として指定されたコンテナーの名前。Pod 内の各コンテナーには、一意の名前 (DNS_LABEL) が必要です。これを更新することはできません。

ports

array

コンテナーから公開するポートのリスト。ここでポートを指定しなくても、そのポートが公開されるのを防ぐことはできません。コンテナー内のデフォルトの "0.0.0.0" アドレスをリッスンしているポートは、ネットワークからアクセスできます。戦略的マージパッチを使用してこの配列を変更すると、データが破損する可能性があります。詳細は、https://github.com/kubernetes/kubernetes/issues/108255 を参照してください。これを更新することはできません。

ports[]

object

ContainerPort は、単一のコンテナー内のネットワークポートを表します。

readinessProbe

object

コンテナーサービスの準備状況の定期的な調査。プローブが失敗すると、コンテナーはサービスエンドポイントから削除されます。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

resizePolicy

array

コンテナーのリソースサイズ変更ポリシー。

resizePolicy[]

object

ContainerResizePolicy は、コンテナーのリソースサイズ変更ポリシーを表します。

resources

object

このコンテナーに必要なコンピューティングリソース。これを更新することはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。

restartPolicy

string

RestartPolicy は、Pod 内の個々のコンテナーの再起動動作を定義します。このフィールドは init コンテナーに対してのみ設定でき、許可される値は "Always" のみです。init 以外のコンテナーの場合、またはこのフィールドが指定されていない場合、再起動の動作は Pod の再起動ポリシーとコンテナータイプによって定義されます。init コンテナーの RestartPolicy を "Always" に設定すると、次の効果が得られます: この init コンテナーは、すべての通常のコンテナーが終了するまで、終了時に継続的に再起動されます。すべての通常のコンテナーが完了すると、restartPolicy が "Always" のすべての init コンテナーがシャットダウンされます。このライフサイクルは通常の init コンテナーとは異なり、多くの場合、"sidecar" コンテナーと呼ばれます。この init コンテナーは、引き続き init コンテナーシーケンス内で開始されますが、次の init コンテナーに進む前にコンテナーが完了するのを待機しません。代わりに、この init コンテナーが起動した直後、または任意の startupProbe が正常に完了した後に、次の init コンテナーが起動します。

securityContext

object

SecurityContext は、コンテナーを実行する必要があるセキュリティーオプションを定義します。設定されている場合、SecurityContext のフィールドは PodSecurityContext の同等のフィールドをオーバーライドします。詳細: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/

startupProbe

object

StartupProbe は、Pod が正常に初期化されたことを示します。指定した場合、これが正常に完了するまで、他のプローブは実行されません。このプローブが失敗すると、livenessProbe が失敗したかのように、Pod が再起動されます。これは、Pod のライフサイクルの開始時に、定常状態の操作中よりもデータのロードやキャッシュのウォームアップに長い時間がかかる可能性がある場合に、さまざまなプローブパラメーターを提供するために使用できます。これは更新できません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

stdin

boolean

このコンテナーがコンテナーランタイムで stdin にバッファーを割り当てる必要があるかどうか。これが設定されていない場合、コンテナー内の stdin からの読み取りは常に EOF になります。デフォルトは false です。

stdinOnce

boolean

コンテナーランタイムが、単一の接続によって開かれた後に stdin チャネルを閉じる必要があるかどうか。stdin が true の場合、stdin ストリームは複数の接続セッションにわたって開いたままになります。stdinOnce が true に設定されている場合、stdin はコンテナーの起動時に開かれ、最初のクライアントが stdin に接続するまで空になり、クライアントが切断されるまで開いたままでデータを受け入れます。切断されると、stdin は閉じられ、コンテナーが再起動されるまで閉じられたままになります。。このフラグが false の場合、stdin から読み取るコンテナープロセスは EOF を受信しません。デフォルトは false です。

terminationMessagePath

string

オプション: コンテナーの終了メッセージが書き込まれるファイルがコンテナーのファイルシステムにマウントされるパス。書き込まれるメッセージは、アサーション失敗メッセージなどの簡単な最終ステータスを目的としています。4096 バイトを超える場合、ノードによって切り捨てられます。すべてのコンテナーの合計メッセージ長は 12kb に制限されます。デフォルトは/dev/termination-log です。これを更新することはできません。

terminationMessagePolicy

string

終了メッセージの入力方法を示します。ファイルは、terminationMessagePath の内容を使用して、成功と失敗の両方でコンテナーステータスメッセージを入力します。終了メッセージファイルが空で、コンテナーがエラーで終了した場合、FallbackToLogsOnError はコンテナーログ出力の最後のチャンクを使用します。ログ出力は、2048 バイトまたは 80 行のいずれか小さい方に制限されます。デフォルトは File です。これを更新することはできません。

tty

boolean

このコンテナーがそれ自体に TTY を割り当てる必要があるかどうかには、'stdin' が true である必要もあります。デフォルトは false です。

volumeDevices

array

volumeDevices は、コンテナーによって使用されるブロックデバイスのリストです。

volumeDevices[]

object

volumeDevice は、コンテナー内の raw ブロックデバイスのマッピングを記述します。

volumeMounts

array

コンテナーのファイルシステムにマウントする Pod ボリューム。これを更新することはできません。

volumeMounts[]

object

VolumeMount は、コンテナー内でのボリュームのマウントを説明します。

workingDir

string

コンテナーの作業ディレクトリー。指定しない場合、コンテナーランタイムのデフォルトが使用されます。これは、コンテナーイメージで設定されている可能性があります。これを更新することはできません。

8.1.175. .spec.initContainers[].env

説明
コンテナーに設定する環境変数のリスト。これを更新することはできません。
array

8.1.176. .spec.initContainers[].env[]

説明
EnvVar は、コンテナーに存在する環境変数を表します。
object
必須
  • name
プロパティー説明

name

string

環境変数の名前。C_IDENTIFIER でなければなりません。

value

string

変数参照 $(VAR_NAME) は、コンテナー内で以前に定義された環境変数と任意のサービス環境変数を使用してデプロイメントされます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、"(VAR_NAME)" は文字列リテラル "$(VAR_NAME)" を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。デフォルトは "" です。

valueFrom

object

環境変数の値のソースです。値が空でない場合は使用できません。

8.1.177. .spec.initContainers[].env[].valueFrom

説明
環境変数の値のソースです。値が空でない場合は使用できません。
object
プロパティー説明

configMapKeyRef

object

ConfigMap のキーを選択します。

fieldRef

object

Pod のフィールドを選択します。metadata.name、metadata.namespace、metadata.labels['<KEY>']metadata.annotations['<KEY>']、spec.nodeName、spec.serviceAccountName、status.hostIP、status.podIP、status.podIPs がサポートされています。

resourceFieldRef

object

コンテナーのリソースを選択します。現在、リソースの制限とリクエスト (limits.cpu、limits.memory、limits.ephemeral-storage、requests.cpu、requests.memory、requests.ephemeral-storage) のみがサポートされています。

secretKeyRef

object

Pod の namespace でシークレットのキーを選択します

8.1.178. .spec.initContainers[].env[].valueFrom.configMapKeyRef

説明
ConfigMap のキーを選択します。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

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

apiVersion

string

FieldPath が記述されているスキーマのバージョン。デフォルトは "v1" です。

fieldPath

string

指定された 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
プロパティー説明

containerName

string

コンテナー名: ボリュームには必須、env 変数にはオプション

divisor

integer-or-string

公開されたリソースの出力形式を指定します。デフォルトは "1" です。

resource

string

必須: 選択するリソース

8.1.181. .spec.initContainers[].env[].valueFrom.secretKeyRef

説明
Pod の namespace でシークレットのキーを選択します
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.182. .spec.initContainers[].envFrom

説明
コンテナー内の環境変数に入力するソースのリスト。ソース内で定義されたキーは C_IDENTIFIER である必要があります。無効なキーはすべて、コンテナーの起動時にイベントとして報告されます。キーが複数のソースに存在する場合、最後のソースに関連付けられた値が優先されます。重複キーを持つ環境によって定義された値が優先されます。これを更新することはできません。
array

8.1.183. .spec.initContainers[].envFrom[]

説明
EnvFromSource は、一連の ConfigMap のソースを表します
object
プロパティー説明

configMapRef

object

選択する ConfigMap

prefix

string

ConfigMap の各キーの前に追加するオプションの識別子。C_IDENTIFIER でなければなりません。

secretRef

object

から選択する秘密

8.1.184. .spec.initContainers[].envFrom[].configMapRef

説明
選択する ConfigMap
object
プロパティー説明

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap を定義する必要があるかどうかを指定します

8.1.185. .spec.initContainers[].envFrom[].secretRef

説明
から選択する秘密
object
プロパティー説明

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットを定義する必要があるかどうかを指定します

8.1.186. .spec.initContainers[].lifecycle

説明
コンテナーのライフサイクルイベントに対応して管理システムが実行する必要のあるアクション。これを更新することはできません。
object
プロパティー説明

postStart

object

PostStart は、コンテナーが作成された直後に呼び出されます。ハンドラーに障害が発生した場合、コンテナーは終了し、再始動ポリシーに従って再始動されます。フックが完了するまでのコンテナーブロックの他の管理。詳細: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks

preStop

object

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

object

Exec は実行するアクションを指定します。

httpGet

object

HTTPGet は、実行する http リクエストを指定します。

sleep

object

Sleep は、コンテナーが終了されるまでのスリープ期間を表します。

tcpSocket

object

非推奨。TCPSocket は LifecycleHandler としてサポートされておらず、後方互換性を確保するために保持されています。このフィールドは検証されず、tcp ハンドラーが指定されている場合、ライフサイクルフックは実行時に失敗します。

8.1.188. .spec.initContainers[].lifecycle.postStart.exec

説明
Exec は実行するアクションを指定します。
object
プロパティー説明

command

array (string)

コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。

8.1.189. .spec.initContainers[].lifecycle.postStart.httpGet

説明
HTTPGet は、実行する http リクエストを指定します。
object
必須
  • port
プロパティー説明

host

string

接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。

httpHeaders

array

リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。

httpHeaders[]

object

HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します

path

string

HTTP サーバーでアクセスするパス。

port

integer-or-string

コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。

scheme

string

ホストへの接続に使用するスキーム。デフォルトは 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
プロパティー説明

name

string

ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。

value

string

ヘッダーフィールド値

8.1.192. .spec.initContainers[].lifecycle.postStart.sleep

説明
Sleep は、コンテナーが終了されるまでのスリープ期間を表します。
object
必須
プロパティー説明

integer

Seconds はスリープする秒数です。

8.1.193. .spec.initContainers[].lifecycle.postStart.tcpSocket

説明
非推奨。TCPSocket は LifecycleHandler としてサポートされておらず、後方互換性を確保するために保持されています。このフィールドは検証されず、tcp ハンドラーが指定されている場合、ライフサイクルフックは実行時に失敗します。
object
必須
  • port
プロパティー説明

host

string

オプション: 接続するホスト名。デフォルトは Pod IP です。

port

integer-or-string

コンテナーでアクセスするポートの番号または名前。番号は 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

object

Exec は実行するアクションを指定します。

httpGet

object

HTTPGet は、実行する http リクエストを指定します。

sleep

object

Sleep は、コンテナーが終了されるまでのスリープ期間を表します。

tcpSocket

object

非推奨。TCPSocket は LifecycleHandler としてサポートされておらず、後方互換性を確保するために保持されています。このフィールドは検証されず、tcp ハンドラーが指定されている場合、ライフサイクルフックは実行時に失敗します。

8.1.195. .spec.initContainers[].lifecycle.preStop.exec

説明
Exec は実行するアクションを指定します。
object
プロパティー説明

command

array (string)

コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。

8.1.196. .spec.initContainers[].lifecycle.preStop.httpGet

説明
HTTPGet は、実行する http リクエストを指定します。
object
必須
  • port
プロパティー説明

host

string

接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。

httpHeaders

array

リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。

httpHeaders[]

object

HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します

path

string

HTTP サーバーでアクセスするパス。

port

integer-or-string

コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。

scheme

string

ホストへの接続に使用するスキーム。デフォルトは 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
プロパティー説明

name

string

ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。

value

string

ヘッダーフィールド値

8.1.199. .spec.initContainers[].lifecycle.preStop.sleep

説明
Sleep は、コンテナーが終了されるまでのスリープ期間を表します。
object
必須
プロパティー説明

integer

Seconds はスリープする秒数です。

8.1.200. .spec.initContainers[].lifecycle.preStop.tcpSocket

説明
非推奨。TCPSocket は LifecycleHandler としてサポートされておらず、後方互換性を確保するために保持されています。このフィールドは検証されず、tcp ハンドラーが指定されている場合、ライフサイクルフックは実行時に失敗します。
object
必須
  • port
プロパティー説明

host

string

オプション: 接続するホスト名。デフォルトは Pod IP です。

port

integer-or-string

コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。

8.1.201. .spec.initContainers[].livenessProbe

説明
コンテナーの活性度の定期的な調査。プローブが失敗した場合、コンテナーは再起動されます。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
object
プロパティー説明

exec

object

Exec は実行するアクションを指定します。

failureThreshold

integer

正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。

grpc

object

GRPC は、GRPC ポートに関連するアクションを指定します。

httpGet

object

HTTPGet は、実行する http リクエストを指定します。

initialDelaySeconds

integer

コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

integer

プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。

successThreshold

integer

失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。

tcpSocket

object

TCPSocket は、TCP ポートを含むアクションを指定します。

terminationGracePeriodSeconds

integer

プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。

timeoutSeconds

integer

プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

8.1.202. .spec.initContainers[].livenessProbe.exec

説明
Exec は実行するアクションを指定します。
object
プロパティー説明

command

array (string)

コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。

8.1.203. .spec.initContainers[].livenessProbe.grpc

説明
GRPC は、GRPC ポートに関連するアクションを指定します。
object
必須
  • port
プロパティー説明

port

integer

gRPC サービスのポート番号。番号は 1〜65535 の範囲である必要があります。

service

string

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

host

string

接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。

httpHeaders

array

リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。

httpHeaders[]

object

HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します

path

string

HTTP サーバーでアクセスするパス。

port

integer-or-string

コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。

scheme

string

ホストへの接続に使用するスキーム。デフォルトは HTTP です。

8.1.205. .spec.initContainers[].livenessProbe.httpGet.httpHeaders

説明
リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
array

8.1.206. .spec.initContainers[].livenessProbe.httpGet.httpHeaders[]

説明
HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
object
必須
  • name
  • value
プロパティー説明

name

string

ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。

value

string

ヘッダーフィールド値

8.1.207. .spec.initContainers[].livenessProbe.tcpSocket

説明
TCPSocket は、TCP ポートを含むアクションを指定します。
object
必須
  • port
プロパティー説明

host

string

オプション: 接続するホスト名。デフォルトは Pod IP です。

port

integer-or-string

コンテナーでアクセスするポートの番号または名前。番号は 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
プロパティー説明

containerPort

integer

Pod の IP アドレスで公開するポートの数。これは有効なポート番号である必要があります、0<x<65536。

hostIP

string

外部ポートをバインドするホスト IP。

hostPort

integer

ホストで公開するポートの数。指定する場合、これは有効なポート番号、0<x<65536 である必要があります。HostNetwork が指定されている場合、これは ContainerPort と一致する必要があります。ほとんどのコンテナーはこれを必要としません。

name

string

指定する場合、これは IANA_SVC_NAME であり、Pod 内で一意である必要があります。Pod 内の名前付きポートにはそれぞれ一意の名前を付ける必要があります。サービスが参照できるポートの名前。

protocol

string

ポートのプロトコル。UDP、TCP、または SCTP である必要があります。デフォルトは "TCP" です。

8.1.210. .spec.initContainers[].readinessProbe

説明
コンテナーサービスの準備状況の定期的な調査。プローブが失敗すると、コンテナーはサービスエンドポイントから削除されます。これを更新することはできません。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
object
プロパティー説明

exec

object

Exec は実行するアクションを指定します。

failureThreshold

integer

正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。

grpc

object

GRPC は、GRPC ポートに関連するアクションを指定します。

httpGet

object

HTTPGet は、実行する http リクエストを指定します。

initialDelaySeconds

integer

コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

integer

プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。

successThreshold

integer

失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。

tcpSocket

object

TCPSocket は、TCP ポートを含むアクションを指定します。

terminationGracePeriodSeconds

integer

プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。

timeoutSeconds

integer

プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

8.1.211. .spec.initContainers[].readinessProbe.exec

説明
Exec は実行するアクションを指定します。
object
プロパティー説明

command

array (string)

コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。

8.1.212. .spec.initContainers[].readinessProbe.grpc

説明
GRPC は、GRPC ポートに関連するアクションを指定します。
object
必須
  • port
プロパティー説明

port

integer

gRPC サービスのポート番号。番号は 1〜65535 の範囲である必要があります。

service

string

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

host

string

接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。

httpHeaders

array

リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。

httpHeaders[]

object

HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します

path

string

HTTP サーバーでアクセスするパス。

port

integer-or-string

コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。

scheme

string

ホストへの接続に使用するスキーム。デフォルトは HTTP です。

8.1.214. .spec.initContainers[].readinessProbe.httpGet.httpHeaders

説明
リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
array

8.1.215. .spec.initContainers[].readinessProbe.httpGet.httpHeaders[]

説明
HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
object
必須
  • name
  • value
プロパティー説明

name

string

ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。

value

string

ヘッダーフィールド値

8.1.216. .spec.initContainers[].readinessProbe.tcpSocket

説明
TCPSocket は、TCP ポートを含むアクションを指定します。
object
必須
  • port
プロパティー説明

host

string

オプション: 接続するホスト名。デフォルトは Pod IP です。

port

integer-or-string

コンテナーでアクセスするポートの番号または名前。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。

8.1.217. .spec.initContainers[].resizePolicy

説明
コンテナーのリソースサイズ変更ポリシー。
array

8.1.218. .spec.initContainers[].resizePolicy[]

説明
ContainerResizePolicy は、コンテナーのリソースサイズ変更ポリシーを表します。
object
必須
  • resourceName
  • restartPolicy
プロパティー説明

resourceName

string

このリソースサイズ変更ポリシーが適用されるリソースの名前。対応している値は、cpu、memory です。

restartPolicy

string

指定されたリソースのサイズが変更されたときに適用する再起動ポリシー。指定しない場合、デフォルトの NotRequired が設定されます。

8.1.219. .spec.initContainers[].resources

説明
このコンテナーに必要なコンピューティングリソース。これを更新することはできません。詳細は、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。
object
プロパティー説明

claims

array

Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。

これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。

このフィールドは不変です。これはコンテナーにのみ設定できます。

claims[]

object

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

limits

integer-or-string

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

requests

integer-or-string

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

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

string

name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。

request

string

request は、参照されるクレーム内のリクエストに対して選択された名前です。空の場合、クレームからのすべてのものが利用可能になり、それ以外の場合はこの request の結果のみが利用可能になります。

8.1.222. .spec.initContainers[].securityContext

説明
SecurityContext は、コンテナーを実行する必要があるセキュリティーオプションを定義します。設定されている場合、SecurityContext のフィールドは PodSecurityContext の同等のフィールドをオーバーライドします。詳細: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/
object
プロパティー説明

allowPrivilegeEscalation

boolean

AllowPrivilegeEscalation は、プロセスがその親プロセスよりも多くの特権を取得できるかどうかを制御します。このブール値は、no_new_privs フラグがコンテナープロセスに設定されるかどうかを直接制御します。コンテナーが 1) 特権で実行されており、CAP_SYS_ADMIN が割り当てられている場合、2) AllowPrivilegeEscalation は常に true です。spec.os.name が windows の場合は、このフィールドは設定できないことに注意してください。

appArmorProfile

object

appArmorProfile は、このコンテナーで使用する AppArmor オプションです。設定されている場合、このプロファイルによって Pod の appArmorProfile がオーバーライドされます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

capabilities

object

コンテナーの実行時に追加/削除する機能。デフォルトは、コンテナーランタイムによって付与されるデフォルトの機能セットです。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

privileged

boolean

コンテナーを特権モードで実行します。特権コンテナー内のプロセスは、基本的にホスト上の root と同等です。デフォルトは false です。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

procMount

string

procMount は、コンテナーに使用する proc マウントのタイプを示します。デフォルト値は Default で、読み取り専用パスおよびマスクされたパスのコンテナーランタイムのデフォルトを使用します。これには、ProcMountType 機能フラグを有効にする必要があります。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

readOnlyRootFilesystem

boolean

このコンテナーに読み取り専用のルートファイルシステムがあるかどうか。デフォルトは false です。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

runAsGroup

integer

コンテナープロセスのエントリーポイントを実行するための GID。設定されていない場合は、実行時のデフォルトを使用します。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

runAsNonRoot

boolean

コンテナーが root 以外のユーザーとして実行される必要があることを示します。true の場合、Kubelet は実行時にイメージを検証して、イメージが UID 0(ルート) として実行されないことを確認し、実行される場合はコンテナーの開始に失敗します。未設定または false の場合、そのような検証は実行されません。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。

runAsUser

integer

コンテナープロセスのエントリーポイントを実行するための UID。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

seLinuxOptions

object

コンテナーに適用される SELinux コンテキスト。指定しない場合、コンテナーランタイムはコンテナーごとにランダムな SELinux コンテキストを割り当てます。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

seccompProfile

object

このコンテナーで使用する seccomp オプション。Pod とコンテナーの両方のレベルで seccomp オプションが提供されている場合、コンテナーオプションは Pod オプションを上書きします。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

windowsOptions

object

すべてのコンテナーに適用される 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

string

localhostProfile は、使用する必要があるノードにロードされたプロファイルを示します。プロファイルが機能するには、ノードで事前に設定されている必要があります。プロファイルのロードされた名前と一致する必要があります。タイプが "Localhost" の場合にのみ設定する必要があります。

type

string

type は、適用される AppArmor プロファイルの種類を示します。有効なオプション: Localhost - ノードに事前にロードされたプロファイル。RuntimeDefault - コンテナーランタイムのデフォルトのプロファイル。制限なし - AppArmor の強制はありません。

8.1.224. .spec.initContainers[].securityContext.capabilities

説明
コンテナーの実行時に追加/削除する機能。デフォルトは、コンテナーランタイムによって付与されるデフォルトの機能セットです。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
object
プロパティー説明

add

array (string)

追加された機能

drop

array (string)

削除された機能

8.1.225. .spec.initContainers[].securityContext.seLinuxOptions

説明
コンテナーに適用される SELinux コンテキスト。指定しない場合、コンテナーランタイムはコンテナーごとにランダムな SELinux コンテキストを割り当てます。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
object
プロパティー説明

level

string

Level は、コンテナーに適用される SELinux レベルのラベルです。

role

string

Role は、コンテナーに適用される SELinux ロールラベルです。

type

string

Type は、コンテナーに適用される SELinux タイプのラベルです。

user

string

User は、コンテナーに適用される SELinux ユーザーラベルです。

8.1.226. .spec.initContainers[].securityContext.seccompProfile

説明
このコンテナーで使用する seccomp オプション。Pod とコンテナーの両方のレベルで seccomp オプションが提供されている場合、コンテナーオプションは Pod オプションを上書きします。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
object
必須
  • type
プロパティー説明

localhostProfile

string

localhostProfile は、ノード上のファイルで定義されたプロファイルを使用する必要があることを示します。プロファイルが機能するには、ノードで事前に設定されている必要があります。kubelet の設定済みの seccomp プロファイルの場所を基準にして、降順のパスである必要があります。タイプが "Localhost" の場合は設定する必要があります。他のタイプには設定しないでください。

type

string

type は、適用される seccomp プロファイルの種類を示します。有効なオプションは以下のとおりです。

Localhost - ノード上のファイルで定義されたプロファイルを使用する必要があります。RuntimeDefault- コンテナーのランタイムデフォルトプロファイルを使用する必要があります。制限なし - プロファイルを適用しないでください。

8.1.227. .spec.initContainers[].securityContext.windowsOptions

説明
すべてのコンテナーに適用される Windows 固有の設定。指定しない場合、PodSecurityContext のオプションが使用されます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が linux の場合は、このフィールドを設定できないことに注意してください。
object
プロパティー説明

gmsaCredentialSpec

string

GMSACredentialSpec は、GMSA アドミッション Webhook (https://github.com/kubernetes-sigs/windows-gmsa) が GMSACredentialSpecName フィールドで指定された GMSA クレデンシャル仕様のコンテンツをインライン化する場所です。

gmsaCredentialSpecName

string

GMSACredentialSpecName は、使用する GMSA 認証情報仕様の名前です。

hostProcess

boolean

hostProcess は、コンテナーを 'Host Process' コンテナーとして実行する必要があるかどうかを決定します。Pod のすべてのコンテナーは、同じ有効な HostProcess 値を持っている必要があります (HostProcess コンテナーと非 HostProcess コンテナーを混在させることはできません)。さらに、HostProcess が true の場合、HostNetwork も true に設定する必要があります。

runAsUserName

string

コンテナープロセスのエントリーポイントを実行するための 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

object

Exec は実行するアクションを指定します。

failureThreshold

integer

正常に実行された後に失敗とみなされるプローブの連続失敗回数の最小値。デフォルトは 3 です。最小値は 1 です。

grpc

object

GRPC は、GRPC ポートに関連するアクションを指定します。

httpGet

object

HTTPGet は、実行する http リクエストを指定します。

initialDelaySeconds

integer

コンテナーが起動してから liveness プローブが開始されるまでの秒数。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

integer

プローブを実行する頻度 (秒単位)。デフォルトは 10 秒です。最小値は 1 です。

successThreshold

integer

失敗後に、プローブが正常とみなされるための最小の連続成功回数。デフォルトは 1 です。活気と起動のために 1 でなければなりません。最小値は 1 です。

tcpSocket

object

TCPSocket は、TCP ポートを含むアクションを指定します。

terminationGracePeriodSeconds

integer

プローブの障害時に Pod が正常に終了する必要がある秒単位のオプションの期間。猶予期間とは、Pod で実行されているプロセスに終了シグナルが送信されてから、kill シグナルでプロセスを強制的に終了するまでの期間 (秒単位) です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、Pod の terminationGracePeriodSeconds が使用されます。それ以外の場合、この値は Pod 仕様によって提供される値をオーバーライドします。値は負の値ではない整数にする必要があります。値ゼロは、キル信号を介してすぐに停止することを示します (シャットダウンする機会はありません)。これはベータフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最小値は 1 です。未設定の場合は spec.terminationGracePeriodSeconds が使用されます。

timeoutSeconds

integer

プローブがタイムアウトするまでの秒数。デフォルトは 1 秒です。最小値は 1 です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

8.1.229. .spec.initContainers[].startupProbe.exec

説明
Exec は実行するアクションを指定します。
object
プロパティー説明

command

array (string)

コマンドはコンテナー内で実行するコマンドラインであり、コマンドの作業ディレクトリーはコンテナーのファイルシステムのルート ('/') です。コマンドは単純に実行され、シェル内では実行されないため、従来のシェル命令 ('|' など) は機能しません。シェルを使用するには、そのシェルを明示的に呼び出す必要があります。終了ステータス 0 はライブ/正常として扱われ、ゼロ以外は異常として扱われます。

8.1.230. .spec.initContainers[].startupProbe.grpc

説明
GRPC は、GRPC ポートに関連するアクションを指定します。
object
必須
  • port
プロパティー説明

port

integer

gRPC サービスのポート番号。番号は 1〜65535 の範囲である必要があります。

service

string

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

host

string

接続するホスト名。デフォルトは Pod IP です。代わりに、httpHeaders で "ホスト" を設定することを推奨します。

httpHeaders

array

リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。

httpHeaders[]

object

HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します

path

string

HTTP サーバーでアクセスするパス。

port

integer-or-string

コンテナーでアクセスするポートの名前または番号。番号は 1〜65535 の範囲である必要があります。名前は IANA_SVC_NAME である必要があります。

scheme

string

ホストへの接続に使用するスキーム。デフォルトは HTTP です。

8.1.232. .spec.initContainers[].startupProbe.httpGet.httpHeaders

説明
リクエストに設定するカスタムヘッダー。HTTP ではヘッダーを繰り返すことができます。
array

8.1.233. .spec.initContainers[].startupProbe.httpGet.httpHeaders[]

説明
HTTPHeader は、HTTP プローブで使用されるカスタムヘッダーを記述します
object
必須
  • name
  • value
プロパティー説明

name

string

ヘッダーフィールド名。これは出力時に正規化されるため、大文字/小文字の名前は同じヘッダーとして認識されます。

value

string

ヘッダーフィールド値

8.1.234. .spec.initContainers[].startupProbe.tcpSocket

説明
TCPSocket は、TCP ポートを含むアクションを指定します。
object
必須
  • port
プロパティー説明

host

string

オプション: 接続するホスト名。デフォルトは Pod IP です。

port

integer-or-string

コンテナーでアクセスするポートの番号または名前。番号は 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

string

devicePath は、デバイスがマップされるコンテナー内のパスです。

name

string

name は、Pod 内の persistentVolumeClaim の名前と一致する必要があります

8.1.237. .spec.initContainers[].volumeMounts

説明
コンテナーのファイルシステムにマウントする Pod ボリューム。これを更新することはできません。
array

8.1.238. .spec.initContainers[].volumeMounts[]

説明
VolumeMount は、コンテナー内でのボリュームのマウントを説明します。
object
必須
  • mountPath
  • name
プロパティー説明

mountPath

string

ボリュームをマウントする必要があるコンテナー内のパス。':' を含めることはできません。

mountPropagation

string

mountPropagation は、マウントがホストからコンテナーに、またはその逆にどのように伝播されるかを決定します。設定されていない場合、MountPropagationNone が使用されます。このフィールドは 1.10 のベータ版です。RecursiveReadOnly が IfPossible または Enabled に設定されている場合、MountPropagation は None または未指定 (デフォルトは None) にする必要があります。

name

string

ボリュームの名前に一致する必要があります。

readOnly

boolean

true の場合は読み取り専用、それ以外の場合は読み取り/書き込み (false または指定なし) でマウントされます。デフォルトは false です。

recursiveReadOnly

string

RecursiveReadOnly は、読み取り専用マウントを再帰的に処理するかどうかを指定します。

ReadOnly が false の場合、このフィールドには意味がなく、未指定にする必要があります。

ReadOnly が true で、このフィールドが Disabled に設定されている場合、マウントは再帰的に読み取り専用にはなりません。このフィールドが IfPossible に設定されている場合、コンテナーランタイムでサポートされている場合は、マウントは再帰的に読み取り専用になります。このフィールドが Enabled に設定されている場合で、コンテナーランタイムでサポートされている場合は、マウントが再帰的に読み取り専用になり、そうでない場合は Pod が起動されず、理由を示すエラーが生成されます。

このフィールドが IfPossible または Enabled に設定されている場合、MountPropagation は None に設定する必要があります (または未指定にする必要があります。この場合、デフォルトは None になります)。

このフィールドが指定されていない場合は、無効と同じ扱いになります。

subPath

string

コンテナーのボリュームをマウントする必要があるボリューム内のパス。デフォルトは "" (ボリュームのルート) です。

subPathExpr

string

コンテナーのボリュームをマウントする必要があるボリューム内の拡張パス。SubPath と同様に動作しますが、環境変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。デフォルトは "" (ボリュームのルート) です。SubPathExpr と SubPath は相互に排他的です。

8.1.239. .spec.otlp

説明
OTLP レシーバーの機能に関する設定。Prometheus v2.55.0 以降が必要です。
object
プロパティー説明

promoteResourceAttributes

array (string)

メトリクスラベルにプロモートする必要がある OpenTelemetry 属性のリスト。デフォルトは none です。

8.1.240. .spec.persistentVolumeClaimRetentionPolicy

説明
このフィールドは、StatefulSet のライフサイクル中に PVC を削除するかどうか、および削除する場合はその方法を制御します。デフォルトの動作では、すべての PVC が保持されます。これは、Kubernetes 1.23 から 1.26 までのアルファフィールドであり、1.26 以降ではベータフィールドです。StatefulSetAutoDeletePVC フィーチャーゲートを有効にする必要があります。
object
プロパティー説明

whenDeleted

string

WhenDeleted は、StatefulSet が削除されたときに、StatefulSet VolumeClaimTemplates から作成された PVC に何が起こるかを指定します。Retain のデフォルトポリシーでは、PVC は StatefulSet の削除の影響を受けません。Delete ポリシーにより、このような PVC が削除されます。

whenScaled

string

WhenScaled は、StatefulSet がスケールダウンされたときに StatefulSet VolumeClaimTemplates から作成された PVC に何が起こるかを指定します。Retain のデフォルトポリシーでは、PVC はスケールダウンの影響を受けません。Delete ポリシーにより、レプリカ数を超える追加の Pod の関連付けられた 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
プロパティー説明

annotations

object (string)

アノテーションは、任意のメタデータを保存し、取得するために外部ツールで設定できる、リソースとともに保存される構造化されていないキー値のマップです。これらはクエリーできないため、オブジェクトを変更する場合に維持する必要があります。詳細: http://kubernetes.io/docs/user-guide/annotations

labels

object (string)

オブジェクトの整理と分類 (スコープと選択) に使用できる文字列キーと値のマップ。レプリケーションコントローラーおよびサービスのセレクターと一致する場合があります。詳細: http://kubernetes.io/docs/user-guide/labels

name

string

name は namespace 内で一意である必要があります。リソースの作成時に必要ですが、リソースによっては、クライアントが適切な名前の生成を自動的に要求することを許可する場合があります。name は、主にべき等性と設定定義の作成を目的としています。これを更新することはできません。詳細: http://kubernetes.io/docs/user-guide/identifiers#names

8.1.242. .spec.podMonitorNamespaceSelector

説明
PodMonitors 検出に一致する namespace。空のラベルセレクターはすべての namespace に一致します。null ラベルセレクター (デフォルト値) は現在の namespace にのみ一致します。
object
プロパティー説明

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

object (string)

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

string

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

operator

string

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

values

array (string)

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

8.1.245. .spec.podMonitorSelector

説明

ターゲット検出のために選択される PodMonitor。ラベルセレクターが空の場合は、全オブジェクトをマッチします。ラベルセレクターが null の場合は、どのオブジェクトもマッチしません。

spec.serviceMonitorSelectorspec.podMonitorSelectorspec.probeSelectorspec.scrapeConfigSelector が null の場合、Prometheus 設定は管理されません。Prometheus Operator は Prometheus 設定のシークレットが存在することを確認しますが、prometheus.yaml.gz キーの下に生の gzip 圧縮された Prometheus 設定を提供するのはユーザーの責任です。この動作は 非推奨 であり、カスタムリソース定義の次のメジャーバージョンでは削除されます。代わりに spec.additionalScrapeConfigs を使用することが推奨されます。

object
プロパティー説明

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

object (string)

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

string

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

operator

string

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

values

array (string)

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

8.1.248. .spec.probeNamespaceSelector

説明
プローブ検出に一致する namespace。空のラベルセレクターはすべての namespace に一致します。null ラベルセレクターは現在の namespace にのみ一致します。
object
プロパティー説明

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

object (string)

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

string

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

operator

string

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

values

array (string)

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

8.1.251. .spec.probeSelector

説明

ターゲット検出のために選択されるプローブ。ラベルセレクターが空の場合は、全オブジェクトをマッチします。ラベルセレクターが null の場合は、どのオブジェクトもマッチしません。

spec.serviceMonitorSelectorspec.podMonitorSelectorspec.probeSelectorspec.scrapeConfigSelector が null の場合、Prometheus 設定は管理されません。Prometheus Operator は Prometheus 設定のシークレットが存在することを確認しますが、prometheus.yaml.gz キーの下に生の gzip 圧縮された Prometheus 設定を提供するのはユーザーの責任です。この動作は 非推奨 であり、カスタムリソース定義の次のメジャーバージョンでは削除されます。代わりに spec.additionalScrapeConfigs を使用することが推奨されます。

object
プロパティー説明

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

object (string)

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

string

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

operator

string

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

values

array (string)

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

ruleName

string

除外される PrometheusRule オブジェクトの名前。

ruleNamespace

string

除外された PrometheusRule オブジェクトの namespace。

8.1.256. .spec.query

説明
QuerySpec は、Promethus クエリーサービスの設定を定義します。
object
プロパティー説明

lookbackDelta

string

デルタの違いにより、式の評価中にメトリックを取得できます。

maxConcurrency

integer

一度に実行できる同時クエリーの数。

maxSamples

integer

1 つのクエリーがメモリーにロードできるサンプルの最大数。これより多くのサンプルをメモリーにロードするとクエリーは失敗するため、クエリーが返すことができるサンプルの数も制限されることに注意してください。

timeout

string

クエリーが中止されるまでにかかる最大時間。

8.1.257. .spec.remoteRead

説明
リモート読み取り設定のリストを定義します。
array

8.1.258. .spec.remoteRead[]

説明
RemoteReadSpec は、Prometheus がリモートエンドポイントからサンプルを読み戻すための設定を定義します。
object
必須
  • url
プロパティー説明

authorization

object

URL の認可セクション。

Prometheus v2.26.0 以降が必要です。

basicAuth または oauth2 と同時に設定することはできません。

basicAuth

object

URL の BasicAuth 設定。

authorization または oauth2 と同時に設定することはできません。

bearerToken

string

警告: トークン値がクリアテキストで表示されるため、このフィールドは使用しないでください。authorization の使用を優先してください。

非推奨: 今後のリリースで削除される予定です。

bearerTokenFile

string

URL のベアラートークンの読み取り先となるファイル。

非推奨: 今後のリリースで削除される予定です。authorization の使用を優先してください。

filterExternalLabels

boolean

リモート読み取りエンドポイントのセレクターとして外部ラベルを使用するかどうか。

Prometheus v2.34.0 以降が必要です。

followRedirects

boolean

HTTP リクエストが HTTP 3xx リダイレクトに従うかどうかを設定します。

Prometheus v2.26.0 以降が必要です。

headers

object (string)

各リモート読み取り要求と併せて送信されるカスタム HTTP ヘッダー。Prometheus 自体によって設定されたヘッダーは上書きできないことに注意してください。Prometheus バージョン 2.26.0 以降でのみ有効です。

name

string

リモート読み取りキューの名前。指定する場合は一意である必要があります。この名前は、読み取り設定を区別するためにメトリックとロギングで使用されます。

Prometheus v2.15.0 以降が必要です。

noProxy

string

noProxy は、プロキシーから除外する IP、CIDR 表記、ドメイン名が含まれる場合があるコンマ区切りの文字列です。IP およびドメイン名にはポート番号を含まれる場合があります。

Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。

oauth2

object

URL の OAuth2 設定。

Prometheus v2.27.0 以降が必要です。

authorization または basicAuth と同時に設定することはできません。

proxyConnectHeader

object

ProxyConnectHeader は、CONNECT リクエスト中にプロキシーに送信するヘッダーをオプションで指定します。

Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。

proxyConnectHeader{}

array

 

proxyConnectHeader{}[]

object

SecretKeySelector は、シークレットのキーを選択します。

proxyFromEnvironment

boolean

環境変数 (HTTP_PROXY、HTTPS_PROXY、NO_PROXY) によって定義されたプロキシー設定を使用するかどうか。

Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。

proxyUrl

string

proxyURL は、使用する HTTP プロキシーサーバーを定義します。

readRecent

boolean

ローカルストレージに完全なデータが必要な時間範囲のクエリーに対して読み取りを行う必要があるかどうか。

remoteTimeout

string

リモート読み取りエンドポイントへの要求のタイムアウト。

requiredMatchers

object (string)

リモート読み取りエンドポイントを照会するためにセレクターに存在する必要がある等式マッチャーのオプションのリスト。

tlsConfig

object

URL に使用する TLS 設定。

url

string

クエリーの実行元となるエンドポイントの URL。

8.1.259. .spec.remoteRead[].authorization

説明

URL の認可セクション。

Prometheus v2.26.0 以降が必要です。

basicAuth または oauth2 と同時に設定することはできません。

object
プロパティー説明

credentials

object

認証の認証情報を含む、namespace 内の Secret のキーを選択します。

credentialsFile

string

シークレットを読み取るファイル。credentials とは相互に排他的です。

type

string

認証タイプを定義します。この値は大文字と小文字を区別しません。

"Basic" はサポートされている値ではありません。

デフォルト: "Bearer"

8.1.260. .spec.remoteRead[].authorization.credentials

説明
認証の認証情報を含む、namespace 内の Secret のキーを選択します。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.261. .spec.remoteRead[].basicAuth

説明

URL の BasicAuth 設定。

authorization または oauth2 と同時に設定することはできません。

object
プロパティー説明

password

object

password は、認証用のパスワードを含むシークレットのキーを指定します。

username

object

username は、認証用のユーザー名を含むシークレットのキーを指定します。

8.1.262. .spec.remoteRead[].basicAuth.password

説明
password は、認証用のパスワードを含むシークレットのキーを指定します。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.263. .spec.remoteRead[].basicAuth.username

説明
username は、認証用のユーザー名を含むシークレットのキーを指定します。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.264. .spec.remoteRead[].oauth2

説明

URL の OAuth2 設定。

Prometheus v2.27.0 以降が必要です。

authorization または basicAuth と同時に設定することはできません。

object
必須
  • clientId
  • clientSecret
  • tokenUrl
プロパティー説明

clientId

object

clientId は、OAuth2 クライアントの ID を含む Secret または ConfigMap のキーを指定します。

clientSecret

object

clientSecret は、OAuth2 クライアントのシークレットを含む Secret のキーを指定します。

endpointParams

object (string)

endpointParams は、トークン URL に追加する HTTP パラメーターを設定します。

noProxy

string

noProxy は、プロキシーから除外する IP、CIDR 表記、ドメイン名が含まれる場合があるコンマ区切りの文字列です。IP およびドメイン名にはポート番号を含まれる場合があります。

Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。

proxyConnectHeader

object

ProxyConnectHeader は、CONNECT リクエスト中にプロキシーに送信するヘッダーをオプションで指定します。

Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。

proxyConnectHeader{}

array

 

proxyConnectHeader{}[]

object

SecretKeySelector は、シークレットのキーを選択します。

proxyFromEnvironment

boolean

環境変数 (HTTP_PROXY、HTTPS_PROXY、NO_PROXY) によって定義されたプロキシー設定を使用するかどうか。

Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。

proxyUrl

string

proxyURL は、使用する HTTP プロキシーサーバーを定義します。

scopes

array (string)

scopes は、トークン要求に使用される OAuth2 スコープを定義します。

tlsConfig

object

OAuth2 サーバーに接続するときに使用する TLS 設定。Prometheus v2.43.0 以降が必要です。

tokenUrl

string

tokenURL は、トークンを取得する URL を設定します。

8.1.265. .spec.remoteRead[].oauth2.clientId

説明
clientId は、OAuth2 クライアントの ID を含む Secret または ConfigMap のキーを指定します。
object
プロパティー説明

configMap

object

ターゲットに使用するデータを含む ConfigMap。

secret

object

ターゲットに使用するデータを含むシークレット。

8.1.266. .spec.remoteRead[].oauth2.clientId.configMap

説明
ターゲットに使用するデータを含む ConfigMap。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

8.1.267. .spec.remoteRead[].oauth2.clientId.secret

説明
ターゲットに使用するデータを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.268. .spec.remoteRead[].oauth2.clientSecret

説明
clientSecret は、OAuth2 クライアントのシークレットを含む Secret のキーを指定します。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

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

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.272. .spec.remoteRead[].oauth2.tlsConfig

説明
OAuth2 サーバーに接続するときに使用する TLS 設定。Prometheus v2.43.0 以降が必要です。
object
プロパティー説明

ca

object

サーバー証明書の検証に使用される認証局。

cert

object

クライアント認証を行うときに提示するクライアント証明書。

insecureSkipVerify

boolean

ターゲット証明書の検証を無効にします。

keySecret

object

ターゲットのクライアントキーファイルを含むシークレット。

maxVersion

string

許容可能な最大 TLS バージョン。

Prometheus v2.41.0 以降が必要です。

minVersion

string

許容可能な最小 TLS バージョン。

Prometheus v2.35.0 以降が必要です。

serverName

string

ターゲットのホスト名を確認するために使用されます。

8.1.273. .spec.remoteRead[].oauth2.tlsConfig.ca

説明
サーバー証明書の検証に使用される認証局。
object
プロパティー説明

configMap

object

ターゲットに使用するデータを含む ConfigMap。

secret

object

ターゲットに使用するデータを含むシークレット。

8.1.274. .spec.remoteRead[].oauth2.tlsConfig.ca.configMap

説明
ターゲットに使用するデータを含む ConfigMap。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

8.1.275. .spec.remoteRead[].oauth2.tlsConfig.ca.secret

説明
ターゲットに使用するデータを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.276. .spec.remoteRead[].oauth2.tlsConfig.cert

説明
クライアント認証を行うときに提示するクライアント証明書。
object
プロパティー説明

configMap

object

ターゲットに使用するデータを含む ConfigMap。

secret

object

ターゲットに使用するデータを含むシークレット。

8.1.277. .spec.remoteRead[].oauth2.tlsConfig.cert.configMap

説明
ターゲットに使用するデータを含む ConfigMap。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

8.1.278. .spec.remoteRead[].oauth2.tlsConfig.cert.secret

説明
ターゲットに使用するデータを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.279. .spec.remoteRead[].oauth2.tlsConfig.keySecret

説明
ターゲットのクライアントキーファイルを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

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

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.283. .spec.remoteRead[].tlsConfig

説明
URL に使用する TLS 設定。
object
プロパティー説明

ca

object

サーバー証明書の検証に使用される認証局。

caFile

string

ターゲットに使用する Prometheus コンテナー内の CA 証明書へのパス。

cert

object

クライアント認証を行うときに提示するクライアント証明書。

certFile

string

ターゲットの Prometheus コンテナー内のクライアント証明書ファイルへのパス。

insecureSkipVerify

boolean

ターゲット証明書の検証を無効にします。

keyFile

string

ターゲットの Prometheus コンテナー内のクライアントキーファイルへのパス。

keySecret

object

ターゲットのクライアントキーファイルを含むシークレット。

maxVersion

string

許容可能な最大 TLS バージョン。

Prometheus v2.41.0 以降が必要です。

minVersion

string

許容可能な最小 TLS バージョン。

Prometheus v2.35.0 以降が必要です。

serverName

string

ターゲットのホスト名を確認するために使用されます。

8.1.284. .spec.remoteRead[].tlsConfig.ca

説明
サーバー証明書の検証に使用される認証局。
object
プロパティー説明

configMap

object

ターゲットに使用するデータを含む ConfigMap。

secret

object

ターゲットに使用するデータを含むシークレット。

8.1.285. .spec.remoteRead[].tlsConfig.ca.configMap

説明
ターゲットに使用するデータを含む ConfigMap。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

8.1.286. .spec.remoteRead[].tlsConfig.ca.secret

説明
ターゲットに使用するデータを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.287. .spec.remoteRead[].tlsConfig.cert

説明
クライアント認証を行うときに提示するクライアント証明書。
object
プロパティー説明

configMap

object

ターゲットに使用するデータを含む ConfigMap。

secret

object

ターゲットに使用するデータを含むシークレット。

8.1.288. .spec.remoteRead[].tlsConfig.cert.configMap

説明
ターゲットに使用するデータを含む ConfigMap。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

8.1.289. .spec.remoteRead[].tlsConfig.cert.secret

説明
ターゲットに使用するデータを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.290. .spec.remoteRead[].tlsConfig.keySecret

説明
ターゲットのクライアントキーファイルを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.291. .spec.remoteWrite

説明
リモート書き込み設定のリストを定義します。
array

8.1.292. .spec.remoteWrite[]

説明
RemoteWriteSpec は、Prometheus からリモートエンドポイントにサンプルを書き込むための設定を定義します。
object
必須
  • url
プロパティー説明

authorization

object

URL の認可セクション。

Prometheus v2.26.0 以降が必要です。

sigv4basicAuthoauth2azureAd と同時に設定することはできません。

azureAd

object

URL の AzureAD。

Prometheus 2.45.0 以降が必要です。

authorizationbasicAuthoauth2sigv4 と同時に設定することはできません。

basicAuth

object

URL の BasicAuth 設定。

sigv4authorizationoauth2azureAd と同時に設定することはできません。

bearerToken

string

警告: トークン値がクリアテキストで表示されるため、このフィールドは使用しないでください。authorization の使用を優先してください。

非推奨: 今後のリリースで削除される予定です。

bearerTokenFile

string

URL のベアラートークンを読み取るファイル。

非推奨: 今後のリリースで削除される予定です。authorization の使用を優先してください。

enableHTTP2

boolean

HTTP2 を有効にするかどうか。

followRedirects

boolean

HTTP リクエストが HTTP 3xx リダイレクトに従うかどうかを設定します。

Prometheus v2.26.0 以降が必要です。

headers

object (string)

各リモート書き込み要求とともに送信されるカスタム HTTP ヘッダー。Prometheus 自体によって設定されたヘッダーは上書きできないことに注意してください。

Prometheus v2.25.0 以降が必要です。

messageVersion

string

エンドポイントに書き込むときに使用するリモート書き込みメッセージのバージョン。

Version1.0 は、Remote Write 1.0 で導入された Prometheus.WriteRequest protobuf メッセージに対応しています。Version2.0 は、Remote Write 2.0 で導入された io.prometheus.write.v2.Request protobuf メッセージに対応しています。

Version2.0 を選択すると、スクレイピングしたメトリクスのメタデータを WAL に追加するように、Prometheus が自動的に設定されます。

このフィールドを設定する前に、サポートされるメッセージバージョンについて、リモートストレージプロバイダーに問い合わせてください。

Prometheus v2.54.0 以降が必要です。

metadataConfig

object

metadataConfig は、リモートストレージへのシリーズメタデータの送信を設定します。

name

string

リモート書き込みキューの名前。指定する場合は一意である必要があります。この名前は、キューを区別するためにメトリックとロギングで使用されます。

Prometheus v2.15.0 以降が必要です。

noProxy

string

noProxy は、プロキシーから除外する IP、CIDR 表記、ドメイン名が含まれる場合があるコンマ区切りの文字列です。IP およびドメイン名にはポート番号を含まれる場合があります。

Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。

oauth2

object

URL の OAuth2 設定。

Prometheus v2.27.0 以降が必要です。

sigv4authorizationbasicAuthazureAd と同時に設定することはできません。

proxyConnectHeader

object

ProxyConnectHeader は、CONNECT リクエスト中にプロキシーに送信するヘッダーをオプションで指定します。

Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。

proxyConnectHeader{}

array

 

proxyConnectHeader{}[]

object

SecretKeySelector は、シークレットのキーを選択します。

proxyFromEnvironment

boolean

環境変数 (HTTP_PROXY、HTTPS_PROXY、NO_PROXY) によって定義されたプロキシー設定を使用するかどうか。

Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。

proxyUrl

string

proxyURL は、使用する HTTP プロキシーサーバーを定義します。

queueConfig

object

QueueConfig を使用すると、リモート書き込みキューパラメーターを調整できます。

remoteTimeout

string

リモート書き込みエンドポイントへの要求のタイムアウト。

sendExemplars

boolean

リモート書き込みによるエグザンプラーの送信を有効にします。エグザンプラーをスクレイピングするには、spec.enableFeatures オプションを使用して exemplar-storage 自体を有効にする必要があることに注意してください。

Prometheus v2.27.0 以降が必要です。

sendNativeHistograms

boolean

リモート書き込みによるネイティブヒストグラム (スパースヒストグラムとも呼ばれる) の送信を有効にします。

Prometheus v2.40.0 以降が必要です。

sigv4

object

sigv4 を使用して、URL に対して AWS の Signature Verification 4 を設定できます。

Prometheus v2.26.0 以降が必要です。

authorizationbasicAuthoauth2azureAd と同時に設定することはできません。

tlsConfig

object

URL に使用する TLS 設定。

url

string

サンプルの送信先のエンドポイントの URL。

writeRelabelConfigs

array

リモート書き込み再ラベル付け設定のリスト。

writeRelabelConfigs[]

object

RelabelConfig を使用すると、ターゲット、アラート、スクレイピングされたサンプル、リモート書き込みサンプルのラベルセットを動的に書き換えることができます。

詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config

8.1.293. .spec.remoteWrite[].authorization

説明

URL の認可セクション。

Prometheus v2.26.0 以降が必要です。

sigv4basicAuthoauth2azureAd と同時に設定することはできません。

object
プロパティー説明

credentials

object

認証の認証情報を含む、namespace 内の Secret のキーを選択します。

credentialsFile

string

シークレットを読み取るファイル。credentials とは相互に排他的です。

type

string

認証タイプを定義します。この値は大文字と小文字を区別しません。

"Basic" はサポートされている値ではありません。

デフォルト: "Bearer"

8.1.294. .spec.remoteWrite[].authorization.credentials

説明
認証の認証情報を含む、namespace 内の Secret のキーを選択します。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.295. .spec.remoteWrite[].azureAd

説明

URL の AzureAD。

Prometheus 2.45.0 以降が必要です。

authorizationbasicAuthoauth2sigv4 と同時に設定することはできません。

object
プロパティー説明

cloud

string

Azure クラウド。オプションは、'AzurePublic'、'AzureChina'、'AzureGovernment' です。

managedIdentity

object

managedIdentity は、Azure ユーザーが割り当てたマネージド ID を定義します。oauth または sdk と同時に設定することはできません。

oauth

object

oauth は、認証に使用される oauth 設定を定義します。managedIdentity または sdk と同時に設定することはできません。

Prometheus v2.48.0 以降が必要です。

sdk

object

SDK は、認証に使用される Azure SDK 設定を定義します。https://learn.microsoft.com/en-us/azure/developer/go/azure-sdk-authentication を参照してください。oauth または managedIdentity と同時に設定することはできません。

Prometheus 2.52.0 以降が必要です。

8.1.296. .spec.remoteWrite[].azureAd.managedIdentity

説明
managedIdentity は、Azure ユーザーが割り当てたマネージド ID を定義します。oauth または sdk と同時に設定することはできません。
object
必須
  • clientId
プロパティー説明

clientId

string

クライアント ID

8.1.297. .spec.remoteWrite[].azureAd.oauth

説明

oauth は、認証に使用される oauth 設定を定義します。managedIdentity または sdk と同時に設定することはできません。

Prometheus v2.48.0 以降が必要です。

object
必須
  • clientId
  • clientSecret
  • tenantId
プロパティー説明

clientId

string

clientID は、認証に使用されている Azure Active Directory アプリケーションの clientId です。

clientSecret

object

clientSecret は、認証に使用される Azure Active Directory アプリケーションのクライアントシークレットを含む Secret のキーを指定します。

tenantId

string

tenantId は、認証に使用されている Azure Active Directory アプリケーションのテナント ID です。

8.1.298. .spec.remoteWrite[].azureAd.oauth.clientSecret

説明
clientSecret は、認証に使用される Azure Active Directory アプリケーションのクライアントシークレットを含む Secret のキーを指定します。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

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

tenantId

string

tenantId は、認証に使用されている Azure Active Directory アプリケーションのテナント ID です。

8.1.300. .spec.remoteWrite[].basicAuth

説明

URL の BasicAuth 設定。

sigv4authorizationoauth2azureAd と同時に設定することはできません。

object
プロパティー説明

password

object

password は、認証用のパスワードを含むシークレットのキーを指定します。

username

object

username は、認証用のユーザー名を含むシークレットのキーを指定します。

8.1.301. .spec.remoteWrite[].basicAuth.password

説明
password は、認証用のパスワードを含むシークレットのキーを指定します。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.302. .spec.remoteWrite[].basicAuth.username

説明
username は、認証用のユーザー名を含むシークレットのキーを指定します。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.303. .spec.remoteWrite[].metadataConfig

説明
metadataConfig は、リモートストレージへのシリーズメタデータの送信を設定します。
object
プロパティー説明

send

boolean

メトリクスメタデータをリモートストレージに送信するかどうかを定義します。

sendInterval

string

メトリクスメタデータをリモートストレージに送信する頻度を定義します。

8.1.304. .spec.remoteWrite[].oauth2

説明

URL の OAuth2 設定。

Prometheus v2.27.0 以降が必要です。

sigv4authorizationbasicAuthazureAd と同時に設定することはできません。

object
必須
  • clientId
  • clientSecret
  • tokenUrl
プロパティー説明

clientId

object

clientId は、OAuth2 クライアントの ID を含む Secret または ConfigMap のキーを指定します。

clientSecret

object

clientSecret は、OAuth2 クライアントのシークレットを含む Secret のキーを指定します。

endpointParams

object (string)

endpointParams は、トークン URL に追加する HTTP パラメーターを設定します。

noProxy

string

noProxy は、プロキシーから除外する IP、CIDR 表記、ドメイン名が含まれる場合があるコンマ区切りの文字列です。IP およびドメイン名にはポート番号を含まれる場合があります。

Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。

proxyConnectHeader

object

ProxyConnectHeader は、CONNECT リクエスト中にプロキシーに送信するヘッダーをオプションで指定します。

Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。

proxyConnectHeader{}

array

 

proxyConnectHeader{}[]

object

SecretKeySelector は、シークレットのキーを選択します。

proxyFromEnvironment

boolean

環境変数 (HTTP_PROXY、HTTPS_PROXY、NO_PROXY) によって定義されたプロキシー設定を使用するかどうか。

Prometheus v2.43.0 以降または Alertmanager 0.25.0 以降が必要です。

proxyUrl

string

proxyURL は、使用する HTTP プロキシーサーバーを定義します。

scopes

array (string)

scopes は、トークン要求に使用される OAuth2 スコープを定義します。

tlsConfig

object

OAuth2 サーバーに接続するときに使用する TLS 設定。Prometheus v2.43.0 以降が必要です。

tokenUrl

string

tokenURL は、トークンを取得する URL を設定します。

8.1.305. .spec.remoteWrite[].oauth2.clientId

説明
clientId は、OAuth2 クライアントの ID を含む Secret または ConfigMap のキーを指定します。
object
プロパティー説明

configMap

object

ターゲットに使用するデータを含む ConfigMap。

secret

object

ターゲットに使用するデータを含むシークレット。

8.1.306. .spec.remoteWrite[].oauth2.clientId.configMap

説明
ターゲットに使用するデータを含む ConfigMap。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

8.1.307. .spec.remoteWrite[].oauth2.clientId.secret

説明
ターゲットに使用するデータを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.308. .spec.remoteWrite[].oauth2.clientSecret

説明
clientSecret は、OAuth2 クライアントのシークレットを含む Secret のキーを指定します。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

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

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.312. .spec.remoteWrite[].oauth2.tlsConfig

説明
OAuth2 サーバーに接続するときに使用する TLS 設定。Prometheus v2.43.0 以降が必要です。
object
プロパティー説明

ca

object

サーバー証明書の検証に使用される認証局。

cert

object

クライアント認証を行うときに提示するクライアント証明書。

insecureSkipVerify

boolean

ターゲット証明書の検証を無効にします。

keySecret

object

ターゲットのクライアントキーファイルを含むシークレット。

maxVersion

string

許容可能な最大 TLS バージョン。

Prometheus v2.41.0 以降が必要です。

minVersion

string

許容可能な最小 TLS バージョン。

Prometheus v2.35.0 以降が必要です。

serverName

string

ターゲットのホスト名を確認するために使用されます。

8.1.313. .spec.remoteWrite[].oauth2.tlsConfig.ca

説明
サーバー証明書の検証に使用される認証局。
object
プロパティー説明

configMap

object

ターゲットに使用するデータを含む ConfigMap。

secret

object

ターゲットに使用するデータを含むシークレット。

8.1.314. .spec.remoteWrite[].oauth2.tlsConfig.ca.configMap

説明
ターゲットに使用するデータを含む ConfigMap。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

8.1.315. .spec.remoteWrite[].oauth2.tlsConfig.ca.secret

説明
ターゲットに使用するデータを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.316. .spec.remoteWrite[].oauth2.tlsConfig.cert

説明
クライアント認証を行うときに提示するクライアント証明書。
object
プロパティー説明

configMap

object

ターゲットに使用するデータを含む ConfigMap。

secret

object

ターゲットに使用するデータを含むシークレット。

8.1.317. .spec.remoteWrite[].oauth2.tlsConfig.cert.configMap

説明
ターゲットに使用するデータを含む ConfigMap。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

8.1.318. .spec.remoteWrite[].oauth2.tlsConfig.cert.secret

説明
ターゲットに使用するデータを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.319. .spec.remoteWrite[].oauth2.tlsConfig.keySecret

説明
ターゲットのクライアントキーファイルを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

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

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.323. .spec.remoteWrite[].queueConfig

説明
QueueConfig を使用すると、リモート書き込みキューパラメーターを調整できます。
object
プロパティー説明

batchSendDeadline

string

BatchSendDeadline は、サンプルがバッファーで待機する最大時間です。

capacity

integer

容量は、ドロップを開始する前にシャードごとにバッファリングするサンプルの数です。

maxBackoff

string

MaxBackoff は、最大再試行遅延です。

maxRetries

integer

MaxRetries は、回復可能なエラーでバッチを再試行する最大回数です。

maxSamplesPerSend

integer

MaxSamplesPerSend は、送信ごとのサンプルの最大数です。

maxShards

integer

MaxShards は、シャードの最大数、つまり同時実行の量です。

minBackoff

string

MinBackoff は、最初の再試行遅延です。再試行するたびに 2 倍になります。

minShards

integer

MinShards は、シャードの最小数、つまり同時実行の量です。

retryOnRateLimit

boolean

remote-write ストレージから 429 ステータスコードを受信すると再試行します。

これは 実験的な機能 であり、今後のリリースで重大な変更が加えられる可能性があります。

sampleAgeLimit

string

SampleAgeLimit は制限より古いサンプルを削除します。Prometheus v2.50.0 以降が必要です。

8.1.324. .spec.remoteWrite[].sigv4

説明

sigv4 を使用して、URL に対して AWS の Signature Verification 4 を設定できます。

Prometheus v2.26.0 以降が必要です。

authorizationbasicAuthoauth2azureAd と同時に設定することはできません。

object
プロパティー説明

accessKey

object

AccessKey は AWS API キーです。指定されていない場合は、環境変数 AWS_ACCESS_KEY_ID が使用されます。

profile

string

profile は、認証に使用される名前付き AWS プロファイルです。

region

string

region は AWS リージョンです。空白の場合は、デフォルトの認証情報チェーンのリージョンが使用されます。

roleArn

string

roleArn は、認証に使用される名前付き AWS プロファイルです。

secretKey

object

secretKey は AWS API シークレットです。指定されていない場合は、環境変数 AWS_SECRET_ACCESS_KEY が使用されます。

8.1.325. .spec.remoteWrite[].sigv4.accessKey

説明
AccessKey は AWS API キーです。指定されていない場合は、環境変数 AWS_ACCESS_KEY_ID が使用されます。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.326. .spec.remoteWrite[].sigv4.secretKey

説明
secretKey は AWS API シークレットです。指定されていない場合は、環境変数 AWS_SECRET_ACCESS_KEY が使用されます。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.327. .spec.remoteWrite[].tlsConfig

説明
URL に使用する TLS 設定。
object
プロパティー説明

ca

object

サーバー証明書の検証に使用される認証局。

caFile

string

ターゲットに使用する Prometheus コンテナー内の CA 証明書へのパス。

cert

object

クライアント認証を行うときに提示するクライアント証明書。

certFile

string

ターゲットの Prometheus コンテナー内のクライアント証明書ファイルへのパス。

insecureSkipVerify

boolean

ターゲット証明書の検証を無効にします。

keyFile

string

ターゲットの Prometheus コンテナー内のクライアントキーファイルへのパス。

keySecret

object

ターゲットのクライアントキーファイルを含むシークレット。

maxVersion

string

許容可能な最大 TLS バージョン。

Prometheus v2.41.0 以降が必要です。

minVersion

string

許容可能な最小 TLS バージョン。

Prometheus v2.35.0 以降が必要です。

serverName

string

ターゲットのホスト名を確認するために使用されます。

8.1.328. .spec.remoteWrite[].tlsConfig.ca

説明
サーバー証明書の検証に使用される認証局。
object
プロパティー説明

configMap

object

ターゲットに使用するデータを含む ConfigMap。

secret

object

ターゲットに使用するデータを含むシークレット。

8.1.329. .spec.remoteWrite[].tlsConfig.ca.configMap

説明
ターゲットに使用するデータを含む ConfigMap。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

8.1.330. .spec.remoteWrite[].tlsConfig.ca.secret

説明
ターゲットに使用するデータを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.331. .spec.remoteWrite[].tlsConfig.cert

説明
クライアント認証を行うときに提示するクライアント証明書。
object
プロパティー説明

configMap

object

ターゲットに使用するデータを含む ConfigMap。

secret

object

ターゲットに使用するデータを含むシークレット。

8.1.332. .spec.remoteWrite[].tlsConfig.cert.configMap

説明
ターゲットに使用するデータを含む ConfigMap。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

8.1.333. .spec.remoteWrite[].tlsConfig.cert.secret

説明
ターゲットに使用するデータを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.334. .spec.remoteWrite[].tlsConfig.keySecret

説明
ターゲットのクライアントキーファイルを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

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

action

string

正規表現の一致に基づいて実行するアクション。

Uppercase および Lowercase アクションには Prometheus v2.36.0 以降が必要です。DropEqual および KeepEqual アクションには Prometheus v2.41.0 以降が必要です。

デフォルト: "Replace"

modulus

integer

ソースラベル値のハッシュを取得するためのモジュラス。

アクションが HashMod の場合にのみ適用されます。

regex

string

抽出された値が一致する正規表現。

replacement

string

正規表現が一致する場合に置き換えアクションが実施される置換値。

正規表現キャプチャグループが利用可能です。

separator

string

separator は連結された SourceLabel 間の文字列です。

sourceLabels

array (string)

ソースラベルは、既存のラベルから値を選択します。それらのコンテンツは、設定されたセパレータを使用して連結され、設定された正規表現と照合されます。

targetLabel

string

結果の文字列が置換で書き込まれるラベル。

ReplaceHashModLowercaseUppercaseKeepEqualDropEqual アクションでは必須です。

正規表現キャプチャグループが利用可能です。

8.1.337. .spec.resources

説明
'prometheus' コンテナーのリソースリクエストと制限を定義します。
object
プロパティー説明

claims

array

Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。

これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。

このフィールドは不変です。これはコンテナーにのみ設定できます。

claims[]

object

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

limits

integer-or-string

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

requests

integer-or-string

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

8.1.338. .spec.resources.claims

説明

Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。

これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。

このフィールドは不変です。これはコンテナーにのみ設定できます。

array

8.1.339. .spec.resources.claims[]

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

name

string

name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。

request

string

request は、参照されるクレーム内のリクエストに対して選択された名前です。空の場合、クレームからのすべてのものが利用可能になり、それ以外の場合はこの request の結果のみが利用可能になります。

8.1.340. .spec.ruleNamespaceSelector

説明
PrometheusRule 検出に一致する namespace。空のラベルセレクターはすべての namespace に一致します。null ラベルセレクターは現在の namespace にのみ一致します。
object
プロパティー説明

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

object (string)

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

string

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

operator

string

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

values

array (string)

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

8.1.343. .spec.ruleSelector

説明
ルール評価のために選択される PrometheusRule オブジェクト。ラベルセレクターが空の場合は、全オブジェクトをマッチします。ラベルセレクターが null の場合は、どのオブジェクトもマッチしません。
object
プロパティー説明

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

object (string)

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

string

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

operator

string

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

values

array (string)

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

8.1.346. .spec.rules

説明
Prometheus ルールのエンジンの設定を定義します。
object
プロパティー説明

alert

object

Prometheus ルールのエンジンのパラメーターを定義します。

これらのパラメーターを更新すると、Pod の再起動がトリガーされます。

8.1.347. .spec.rules.alert

説明

Prometheus ルールのエンジンのパラメーターを定義します。

これらのパラメーターを更新すると、Pod の再起動がトリガーされます。

object
プロパティー説明

forGracePeriod

string

アラートと復元された 'for' 状態の間の最小期間。

これは、設定された 'for' の期間がグレース期間よりも長く設定されているアラートに対してのみ維持されます。

forOutageTolerance

string

アラートの 'for' の状態を復元するために prometheus の停止を許容する最大時間。

resendDelay

string

Alertmanager にアラートを再送信する前に待機する最小時間。

8.1.348. .spec.runtime

説明
RuntimeConfig は Prometheus プロセスの動作の値を設定します。
object
プロパティー説明

goGC

integer

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

object

AttachMetadata は、検出されたターゲットへの追加のメタデータを設定します。スクレイプオブジェクトが独自の設定を定義する場合、その設定はスクレイプクラスの設定よりも優先されます。

default

boolean

default は、明示的なスクレイプクラス名が設定されていないすべてのスクレイプオブジェクトにスクレイプが適用されることを示しています。

デフォルトとして設定できるスクレイプクラスは 1 つだけです。

metricRelabelings

array

metricRelabelings は、取り込み前にすべてのサンプルに適用するラベル再設定ルールを設定します。

Operator は、ここで定義されたスクレイプクラスメトリクスのラベル再設定を追加します。次に、ServiceMonitor、PodMonitor、Probes、および ScrapeConfigs で定義されたターゲット固有のメトリクスのラベル再設定を追加します。その後 Operator は、'.spec.enforcedNamespaceLabel' で指定されている namespace 強制ラベル再設定ルールを追加します。

詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#metric_relabel_configs

metricRelabelings[]

object

RelabelConfig を使用すると、ターゲット、アラート、スクレイピングされたサンプル、リモート書き込みサンプルのラベルセットを動的に書き換えることができます。

詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config

name

string

スクレイプクラスの名前。

relabelings

array

ラベルの再設定は、すべてのスクレイプターゲットに適用するラベル再設定ルールを設定します。

Operator は、__meta_kubernetes_namespace\__meta_kubernetes_service_name などのいくつかの標準 Kubernetes フィールドのラベル再設定を自動的に追加します。次に、ここで定義されたスクレイプクラスのラベル再設定を追加します。その後 Operator は、スクレイプオブジェクトで定義されたターゲット固有のラベル再設定を追加します。

詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config

relabelings[]

object

RelabelConfig を使用すると、ターゲット、アラート、スクレイピングされたサンプル、リモート書き込みサンプルのラベルセットを動的に書き換えることができます。

詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config

tlsConfig

object

TLSConfig は、スクレイプに使用する TLS 設定を定義します。スクレイプオブジェクトが独自の CA、証明書、キーを定義する場合、それらは対応するスクレイプクラスフィールドよりも優先されます。

現時点では、caFilecertFilekeyFile フィールドのみがサポートされています。

8.1.351. .spec.scrapeClasses[].attachMetadata

説明
AttachMetadata は、検出されたターゲットへの追加のメタデータを設定します。スクレイプオブジェクトが独自の設定を定義する場合、その設定はスクレイプクラスの設定よりも優先されます。
object
プロパティー説明

node

boolean

true に設定すると、Prometheus が検出されたターゲットにノードメタデータをアタッチします。

Prometheus サービスアカウントに、Nodes オブジェクトに対する list および watch 権限が必要です。

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

action

string

正規表現の一致に基づいて実行するアクション。

Uppercase および Lowercase アクションには Prometheus v2.36.0 以降が必要です。DropEqual および KeepEqual アクションには Prometheus v2.41.0 以降が必要です。

デフォルト: "Replace"

modulus

integer

ソースラベル値のハッシュを取得するためのモジュラス。

アクションが HashMod の場合にのみ適用されます。

regex

string

抽出された値が一致する正規表現。

replacement

string

正規表現が一致する場合に置き換えアクションが実施される置換値。

正規表現キャプチャグループが利用可能です。

separator

string

separator は連結された SourceLabel 間の文字列です。

sourceLabels

array (string)

ソースラベルは、既存のラベルから値を選択します。それらのコンテンツは、設定されたセパレータを使用して連結され、設定された正規表現と照合されます。

targetLabel

string

結果の文字列が置換で書き込まれるラベル。

ReplaceHashModLowercaseUppercaseKeepEqualDropEqual アクションでは必須です。

正規表現キャプチャグループが利用可能です。

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

action

string

正規表現の一致に基づいて実行するアクション。

Uppercase および Lowercase アクションには Prometheus v2.36.0 以降が必要です。DropEqual および KeepEqual アクションには Prometheus v2.41.0 以降が必要です。

デフォルト: "Replace"

modulus

integer

ソースラベル値のハッシュを取得するためのモジュラス。

アクションが HashMod の場合にのみ適用されます。

regex

string

抽出された値が一致する正規表現。

replacement

string

正規表現が一致する場合に置き換えアクションが実施される置換値。

正規表現キャプチャグループが利用可能です。

separator

string

separator は連結された SourceLabel 間の文字列です。

sourceLabels

array (string)

ソースラベルは、既存のラベルから値を選択します。それらのコンテンツは、設定されたセパレータを使用して連結され、設定された正規表現と照合されます。

targetLabel

string

結果の文字列が置換で書き込まれるラベル。

ReplaceHashModLowercaseUppercaseKeepEqualDropEqual アクションでは必須です。

正規表現キャプチャグループが利用可能です。

8.1.356. .spec.scrapeClasses[].tlsConfig

説明

TLSConfig は、スクレイプに使用する TLS 設定を定義します。スクレイプオブジェクトが独自の CA、証明書、キーを定義する場合、それらは対応するスクレイプクラスフィールドよりも優先されます。

現時点では、caFilecertFilekeyFile フィールドのみがサポートされています。

object
プロパティー説明

ca

object

サーバー証明書の検証に使用される認証局。

caFile

string

ターゲットに使用する Prometheus コンテナー内の CA 証明書へのパス。

cert

object

クライアント認証を行うときに提示するクライアント証明書。

certFile

string

ターゲットの Prometheus コンテナー内のクライアント証明書ファイルへのパス。

insecureSkipVerify

boolean

ターゲット証明書の検証を無効にします。

keyFile

string

ターゲットの Prometheus コンテナー内のクライアントキーファイルへのパス。

keySecret

object

ターゲットのクライアントキーファイルを含むシークレット。

maxVersion

string

許容可能な最大 TLS バージョン。

Prometheus v2.41.0 以降が必要です。

minVersion

string

許容可能な最小 TLS バージョン。

Prometheus v2.35.0 以降が必要です。

serverName

string

ターゲットのホスト名を確認するために使用されます。

8.1.357. .spec.scrapeClasses[].tlsConfig.ca

説明
サーバー証明書の検証に使用される認証局。
object
プロパティー説明

configMap

object

ターゲットに使用するデータを含む ConfigMap。

secret

object

ターゲットに使用するデータを含むシークレット。

8.1.358. .spec.scrapeClasses[].tlsConfig.ca.configMap

説明
ターゲットに使用するデータを含む ConfigMap。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

8.1.359. .spec.scrapeClasses[].tlsConfig.ca.secret

説明
ターゲットに使用するデータを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.360. .spec.scrapeClasses[].tlsConfig.cert

説明
クライアント認証を行うときに提示するクライアント証明書。
object
プロパティー説明

configMap

object

ターゲットに使用するデータを含む ConfigMap。

secret

object

ターゲットに使用するデータを含むシークレット。

8.1.361. .spec.scrapeClasses[].tlsConfig.cert.configMap

説明
ターゲットに使用するデータを含む ConfigMap。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

8.1.362. .spec.scrapeClasses[].tlsConfig.cert.secret

説明
ターゲットに使用するデータを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.363. .spec.scrapeClasses[].tlsConfig.keySecret

説明
ターゲットのクライアントキーファイルを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.364. .spec.scrapeConfigNamespaceSelector

説明

ScrapeConfig 検出に一致する namespace。空のラベルセレクターはすべての namespace に一致します。null ラベルセレクターは現在の namespace にのみ一致します。

現在、ScrapeConfig カスタムリソース定義はアルファレベルであることに注意してください。

object
プロパティー説明

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

object (string)

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

string

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

operator

string

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

values

array (string)

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

8.1.367. .spec.scrapeConfigSelector

説明

ターゲット検出のために選択される ScrapeConfigs。ラベルセレクターが空の場合は、全オブジェクトをマッチします。ラベルセレクターが null の場合は、どのオブジェクトもマッチしません。

spec.serviceMonitorSelectorspec.podMonitorSelectorspec.probeSelectorspec.scrapeConfigSelector が null の場合、Prometheus 設定は管理されません。Prometheus Operator は Prometheus 設定のシークレットが存在することを確認しますが、prometheus.yaml.gz キーの下に生の gzip 圧縮された Prometheus 設定を提供するのはユーザーの責任です。この動作は 非推奨 であり、カスタムリソース定義の次のメジャーバージョンでは削除されます。代わりに spec.additionalScrapeConfigs を使用することが推奨されます。

現在、ScrapeConfig カスタムリソース定義はアルファレベルであることに注意してください。

object
プロパティー説明

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

object (string)

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

string

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

operator

string

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

values

array (string)

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

8.1.370. .spec.securityContext

説明
SecurityContext は、Pod レベルのセキュリティー属性と一般的なコンテナー設定を保持します。これはデフォルトでデフォルトの PodSecurityContext になります。
object
プロパティー説明

appArmorProfile

object

appArmorProfile は、この Pod 内のコンテナーで使用する AppArmor オプションです。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

fsGroup

integer

Pod の全コンテナーに適用される特別な補助グループです。一部のボリュームタイプでは、Kubelet がそのボリュームの所有権を Pod が所有するように変更できます。

1.所有する GID は FSGroup2 になります。setgid ビットが設定されます (ボリュームに作成された新しいファイルは FSGroup によって所有されます)3。許可ビットは rw-rw---- と OR 演算されます

設定されていないと、Kubelet はボリュームの所有権および権限を変更しません。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

fsGroupChangePolicy

string

fsGroupChangePolicy は、Pod 内部で公開する前にボリュームの所有権とアクセス権を変更する動作を定義します。このフィールドは、fsGroup ベースの所有権 (および権限) をサポートするボリュームタイプにのみ適用されます。secret、configmaps、emptydir などのエフェメラルボリュームタイプには影響しません。有効な値は "OnRootMismatch" と "Always" です。指定しない場合は "Always" を使用します。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

runAsGroup

integer

コンテナープロセスのエントリーポイントを実行するための GID。設定されていない場合は、実行時のデフォルトを使用します。SecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値がそのコンテナーに優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

runAsNonRoot

boolean

コンテナーが root 以外のユーザーとして実行される必要があることを示します。true の場合、Kubelet は実行時にイメージを検証して、イメージが UID 0(ルート) として実行されないことを確認し、実行される場合はコンテナーの開始に失敗します。未設定または false の場合、そのような検証は実行されません。SecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。

runAsUser

integer

コンテナープロセスのエントリーポイントを実行するための UID。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。SecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値がそのコンテナーに優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

seLinuxOptions

object

すべてのコンテナーに適用される SELinux コンテキスト。指定しない場合、コンテナーランタイムはコンテナーごとにランダムな SELinux コンテキストを割り当てます。SecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値がそのコンテナーに優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

seccompProfile

object

この Pod のコンテナーで使用する seccomp オプション。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

supplementalGroups

配列 (整数)

コンテナーのプライマリー GID および fsGroup (指定されている場合) に加えて、各コンテナーで実行される最初のプロセスに適用されるグループのリスト。SupplementalGroupsPolicy 機能が有効になっている場合、supplementalGroupsPolicy フィールドは、コンテナーイメージで定義されるグループメンバーシップに加えて、またはその代わりに、それらを追加するかどうかを決定します。これを指定しないと、追加のグループは追加されませんが、supplementalGroupsPolicy フィールドに応じて、コンテナーイメージで定義されたグループメンバーシップは引き続き使用される場合があります。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

supplementalGroupsPolicy

string

最初のコンテナープロセスの補助グループを計算する方法を定義します。有効な値は "Merge" と "Strict" です。指定しない場合は、"Merge" が使用されます。(Alpha) このフィールドを使用するには、SupplementalGroupsPolicy 機能ゲートを有効にする必要があり、コンテナーランタイムはこの機能のサポートを実装する必要があります。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

sysctls

array

Sysctl は、Pod に使用される namespace 付き sysctl のリストを保持します。(コンテナーランタイムによる) サポートされていない sysctl を持つ Pod は起動に失敗する可能性があります。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。

sysctls[]

object

Sysctl は、設定するカーネルパラメーターを定義します

windowsOptions

object

すべてのコンテナーに適用される 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

string

localhostProfile は、使用する必要があるノードにロードされたプロファイルを示します。プロファイルが機能するには、ノードで事前に設定されている必要があります。プロファイルのロードされた名前と一致する必要があります。タイプが "Localhost" の場合にのみ設定する必要があります。

type

string

type は、適用される AppArmor プロファイルの種類を示します。有効なオプション: Localhost - ノードに事前にロードされたプロファイル。RuntimeDefault - コンテナーランタイムのデフォルトのプロファイル。制限なし - AppArmor の強制はありません。

8.1.372. .spec.securityContext.seLinuxOptions

説明
すべてのコンテナーに適用される SELinux コンテキスト。指定しない場合、コンテナーランタイムはコンテナーごとにランダムな SELinux コンテキストを割り当てます。SecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値がそのコンテナーに優先されます。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
object
プロパティー説明

level

string

Level は、コンテナーに適用される SELinux レベルのラベルです。

role

string

Role は、コンテナーに適用される SELinux ロールラベルです。

type

string

Type は、コンテナーに適用される SELinux タイプのラベルです。

user

string

User は、コンテナーに適用される SELinux ユーザーラベルです。

8.1.373. .spec.securityContext.seccompProfile

説明
この Pod のコンテナーで使用する seccomp オプション。spec.os.name が Windows の場合、このフィールドは設定できないことに注意してください。
object
必須
  • type
プロパティー説明

localhostProfile

string

localhostProfile は、ノード上のファイルで定義されたプロファイルを使用する必要があることを示します。プロファイルが機能するには、ノードで事前に設定されている必要があります。kubelet の設定済みの seccomp プロファイルの場所を基準にして、降順のパスである必要があります。タイプが "Localhost" の場合は設定する必要があります。他のタイプには設定しないでください。

type

string

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

name

string

設定するプロパティーの名前

value

string

設定するプロパティーの値

8.1.376. .spec.securityContext.windowsOptions

説明
すべてのコンテナーに適用される Windows 固有の設定。指定しない場合、コンテナーの SecurityContext 内のオプションが使用されます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。spec.os.name が linux の場合は、このフィールドを設定できないことに注意してください。
object
プロパティー説明

gmsaCredentialSpec

string

GMSACredentialSpec は、GMSA アドミッション Webhook (https://github.com/kubernetes-sigs/windows-gmsa) が GMSACredentialSpecName フィールドで指定された GMSA クレデンシャル仕様のコンテンツをインライン化する場所です。

gmsaCredentialSpecName

string

GMSACredentialSpecName は、使用する GMSA 認証情報仕様の名前です。

hostProcess

boolean

hostProcess は、コンテナーを 'Host Process' コンテナーとして実行する必要があるかどうかを決定します。Pod のすべてのコンテナーは、同じ有効な HostProcess 値を持っている必要があります (HostProcess コンテナーと非 HostProcess コンテナーを混在させることはできません)。さらに、HostProcess が true の場合、HostNetwork も true に設定する必要があります。

runAsUserName

string

コンテナープロセスのエントリーポイントを実行するための Windows の UserName。指定されていない場合、デフォルトでイメージメタデータで指定されたユーザーになります。PodSecurityContext で設定することもできます。SecurityContext と PodSecurityContext の両方で設定されている場合、SecurityContext で指定された値が優先されます。

8.1.377. .spec.serviceMonitorNamespaceSelector

説明
ServicedMonitors 検出に一致する namespace。空のラベルセレクターはすべての namespace に一致します。null ラベルセレクター (デフォルト値) は現在の namespace にのみ一致します。
object
プロパティー説明

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

object (string)

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

string

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

operator

string

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

values

array (string)

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

8.1.380. .spec.serviceMonitorSelector

説明

ターゲット検出用に選択される ServiceMonitor。ラベルセレクターが空の場合は、全オブジェクトをマッチします。ラベルセレクターが null の場合は、どのオブジェクトもマッチしません。

spec.serviceMonitorSelectorspec.podMonitorSelectorspec.probeSelectorspec.scrapeConfigSelector が null の場合、Prometheus 設定は管理されません。Prometheus Operator は Prometheus 設定のシークレットが存在することを確認しますが、prometheus.yaml.gz キーの下に生の gzip 圧縮された Prometheus 設定を提供するのはユーザーの責任です。この動作は 非推奨 であり、カスタムリソース定義の次のメジャーバージョンでは削除されます。代わりに spec.additionalScrapeConfigs を使用することが推奨されます。

object
プロパティー説明

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

object (string)

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

string

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

operator

string

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

values

array (string)

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

8.1.383. .spec.storage

説明
storage は、Prometheus が使用するストレージを定義します。
object
プロパティー説明

disableMountSubPath

boolean

非推奨: 今後のリリースで subPath の使用は削除されます。

emptyDir

object

StatefulSet が使用する EmptyDirVolumeSource。指定した場合、ephemeral および volumeClaimTemplate よりも優先されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes/#emptydir

ephemeral

object

StatefulSet が使用する EphemeralVolumeSource。これは、k8s 1.21 ではベータフィールド、1.15 では GA です。k8s 1.19 以前のバージョンでは、GenericEphemeralVolume フィーチャーゲートを有効にする必要があります。詳細: https://kubernetes.io/docs/concepts/storage/ephemeral-volumes/#generic-ephemeral-volumes

volumeClaimTemplate

object

Prometheus StatefulSets が使用する PVC 仕様を定義します。自動的にプロビジョニングできないボリュームを使用する最も簡単な方法は、手動で作成された PersistentVolumes と一緒にラベルセレクターを使用することです。

8.1.384. .spec.storage.emptyDir

説明
StatefulSet が使用する EmptyDirVolumeSource。指定した場合、ephemeral および volumeClaimTemplate よりも優先されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes/#emptydir
object
プロパティー説明

medium

string

medium は、このディレクトリーをバックアップする必要があるストレージメディアのタイプを表します。デフォルトは"" です。これは、ノードのデフォルトのメディアを使用することを意味します。空の文字列 (デフォルト) またはメモリーである必要があります。詳細: https://kubernetes.io/docs/concepts/storage/volumes#emptydir

sizeLimit

integer-or-string

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

volumeClaimTemplate

object

ボリュームをプロビジョニングするためのスタンドアロン 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 であってはなりません。

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

metadata

object

PVC の作成時に PVC にコピーされるラベルとアノテーションが含まれる場合があります。他のフィールドは許可されておらず、検証中に拒否されます。

spec

object

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

array (string)

accessModes には、ボリュームに割り当てる必要のあるアクセスモードが含まれます。詳細は、https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 を参照してください。

dataSource

object

dataSource フィールドは、次のいずれかを指定するために使用できます。*既存の VolumeSnapshot オブジェクト (snapshot.storage.k8s.io/VolumeSnapshot)*既存の PVC(PersistentVolumeClaim) プロビジョナーまたは外部コントローラーが指定されたデータソースをサポートできる場合、指定されたデータソースのコンテンツに基づく新しいボリューム。AnyVolumeDataSource フィーチャーゲートが有効になっている場合、dataSource の内容は dataSourceRef にコピーされ、dataSourceRef.namespace が指定されていない場合に dataSourceRef コンテンツが dataSource にコピーされます。namespace が指定されている場合、dataSourceRef は dataSource にコピーされません。

dataSourceRef

object

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

object

resources は、ボリュームに必要な最小リソースを表します。RecoverVolumeExpansionFailure 機能が有効になっている場合、ユーザーは以前の値よりも低いリソース要件を指定できますが、要求のステータスフィールドに記録された容量よりも大きい必要があります。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources

selector

object

selector は、バインドを考慮するボリュームに対するラベルクエリーです。

storageClassName

string

storageClassName は、要求に必要な StorageClass の名前です。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1

volumeAttributesClassName

string

volumeAttributesClassName は、このクレームで使用される VolumeAttributesClass を設定するために使用できます。指定すると、CSI ドライバーは、対応する VolumeAttributesClass で定義された属性を使用してボリュームを作成または更新します。これは storageClassName とは異なる目的があり、クレームの作成後に変更できます。空の文字列値は、クレームに VolumeAttributesClass が適用されないことを意味しますが、一度設定すると、このフィールドを空の文字列にリセットすることはできません。指定されておらず、PersistentVolumeClaim がバインドされていない場合は、永続ボリュームコントローラーが存在する場合は、デフォルトの VolumeAttributesClass が設定されます。volumeAttributesClass によって参照されるリソースが存在しない場合は、そのようなリソースが存在するまで、この PersistentVolumeClaim は、modifyVolumeStatus フィールドに反映されるように、保留状態に設定されます。詳細は、https://kubernetes.io/docs/concepts/storage/volume-attributes-classes/ (ベータ版) を参照してください。このフィールドを使用するには、VolumeAttributesClass フィーチャーゲートを有効にする必要があります (デフォルトではオフ)。

volumeMode

string

volumeMode は、要求に必要なボリュームのタイプを定義します。Filesystem の値は、要求仕様に含まれていない場合に暗示されます。

volumeName

string

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

string

APIGroup は参照されているリソースのグループです。APIGroup が指定されていない場合は、指定の Kind をコア API グループに設定する必要があります。他のサードパーティータイプには、APIGroup が必要です。

kind

string

kind は参照されているリソースのタイプです。

name

string

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

string

APIGroup は参照されているリソースのグループです。APIGroup が指定されていない場合は、指定の Kind をコア API グループに設定する必要があります。他のサードパーティータイプには、APIGroup が必要です。

kind

string

kind は参照されているリソースのタイプです。

name

string

name は、参照されているリソースの名前です。

namespace

string

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

integer-or-string

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

requests

integer-or-string

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

8.1.392. .spec.storage.ephemeral.volumeClaimTemplate.spec.selector

説明
selector は、バインドを考慮するボリュームに対するラベルクエリーです。
object
プロパティー説明

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

object (string)

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

string

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

operator

string

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

values

array (string)

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

8.1.395. .spec.storage.volumeClaimTemplate

説明
Prometheus StatefulSets が使用する PVC 仕様を定義します。自動的にプロビジョニングできないボリュームを使用する最も簡単な方法は、手動で作成された PersistentVolumes と一緒にラベルセレクターを使用することです。
object
プロパティー説明

apiVersion

string

apiVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。

kind

string

kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できる場合があります。これは更新できません。CamelCase を使用します。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。

metadata

object

EmbeddedMetadata には、EmbeddedResource に関連するメタデータが含まれています。

spec

object

Pod 作成者によって要求されたボリュームに必要な特性を定義します。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims

status

object

非推奨: このフィールドは設定されません。

8.1.396. .spec.storage.volumeClaimTemplate.metadata

説明
EmbeddedMetadata には、EmbeddedResource に関連するメタデータが含まれています。
object
プロパティー説明

annotations

object (string)

アノテーションは、任意のメタデータを保存し、取得するために外部ツールで設定できる、リソースとともに保存される構造化されていないキー値のマップです。これらはクエリーできないため、オブジェクトを変更する場合に維持する必要があります。詳細: http://kubernetes.io/docs/user-guide/annotations

labels

object (string)

オブジェクトの整理と分類 (スコープと選択) に使用できる文字列キーと値のマップ。レプリケーションコントローラーおよびサービスのセレクターと一致する場合があります。詳細: http://kubernetes.io/docs/user-guide/labels

name

string

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

array (string)

accessModes には、ボリュームに割り当てる必要のあるアクセスモードが含まれます。詳細は、https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 を参照してください。

dataSource

object

dataSource フィールドは、次のいずれかを指定するために使用できます。*既存の VolumeSnapshot オブジェクト (snapshot.storage.k8s.io/VolumeSnapshot)*既存の PVC(PersistentVolumeClaim) プロビジョナーまたは外部コントローラーが指定されたデータソースをサポートできる場合、指定されたデータソースのコンテンツに基づく新しいボリューム。AnyVolumeDataSource フィーチャーゲートが有効になっている場合、dataSource の内容は dataSourceRef にコピーされ、dataSourceRef.namespace が指定されていない場合に dataSourceRef コンテンツが dataSource にコピーされます。namespace が指定されている場合、dataSourceRef は dataSource にコピーされません。

dataSourceRef

object

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

object

resources は、ボリュームに必要な最小リソースを表します。RecoverVolumeExpansionFailure 機能が有効になっている場合、ユーザーは以前の値よりも低いリソース要件を指定できますが、要求のステータスフィールドに記録された容量よりも大きい必要があります。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources

selector

object

selector は、バインドを考慮するボリュームに対するラベルクエリーです。

storageClassName

string

storageClassName は、要求に必要な StorageClass の名前です。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1

volumeAttributesClassName

string

volumeAttributesClassName は、このクレームで使用される VolumeAttributesClass を設定するために使用できます。指定すると、CSI ドライバーは、対応する VolumeAttributesClass で定義された属性を使用してボリュームを作成または更新します。これは storageClassName とは異なる目的があり、クレームの作成後に変更できます。空の文字列値は、クレームに VolumeAttributesClass が適用されないことを意味しますが、一度設定すると、このフィールドを空の文字列にリセットすることはできません。指定されておらず、PersistentVolumeClaim がバインドされていない場合は、永続ボリュームコントローラーが存在する場合は、デフォルトの VolumeAttributesClass が設定されます。volumeAttributesClass によって参照されるリソースが存在しない場合は、そのようなリソースが存在するまで、この PersistentVolumeClaim は、modifyVolumeStatus フィールドに反映されるように、保留状態に設定されます。詳細は、https://kubernetes.io/docs/concepts/storage/volume-attributes-classes/ (ベータ版) を参照してください。このフィールドを使用するには、VolumeAttributesClass フィーチャーゲートを有効にする必要があります (デフォルトではオフ)。

volumeMode

string

volumeMode は、要求に必要なボリュームのタイプを定義します。Filesystem の値は、要求仕様に含まれていない場合に暗示されます。

volumeName

string

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

string

APIGroup は参照されているリソースのグループです。APIGroup が指定されていない場合は、指定の Kind をコア API グループに設定する必要があります。他のサードパーティータイプには、APIGroup が必要です。

kind

string

kind は参照されているリソースのタイプです。

name

string

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

string

APIGroup は参照されているリソースのグループです。APIGroup が指定されていない場合は、指定の Kind をコア API グループに設定する必要があります。他のサードパーティータイプには、APIGroup が必要です。

kind

string

kind は参照されているリソースのタイプです。

name

string

name は、参照されているリソースの名前です。

namespace

string

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

integer-or-string

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

requests

integer-or-string

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

8.1.401. .spec.storage.volumeClaimTemplate.spec.selector

説明
selector は、バインドを考慮するボリュームに対するラベルクエリーです。
object
プロパティー説明

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

object (string)

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

string

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

operator

string

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

values

array (string)

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

8.1.404. .spec.storage.volumeClaimTemplate.status

説明
非推奨: このフィールドは設定されません。
object
プロパティー説明

accessModes

array (string)

accessModes には、PVC をサポートするボリュームが実際に持つアクセスモードが含まれます。詳細は、https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 を参照してください。

allocatedResourceStatuses

object (string)

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

integer-or-string

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

integer-or-string

capacity は、基礎となるボリュームの実際のリソースを表します。

conditions

array

conditions は永続ボリューム要求の現在の条件です。基礎となる永続ボリュームのサイズが変更されていると、条件が 'Resizing' に設定されます。

conditions[]

object

PersistentVolumeClaimCondition での pvc の状態の詳細

currentVolumeAttributesClassName

string

currentVolumeAttributesClassName は、PVC が使用している VolumeAttributesClass の現在の名前です。これが設定されていないと、この PersistentVolumeClaim には VolumeAttributeClass は適用されません。これはベータフィールドであり、VolumeAttributesClass 機能を有効にする必要があります (デフォルトではオフ)。

modifyVolumeStatus

object

ModifyVolumeStatus は、ControllerModifyVolume 操作のステータスオブジェクトを表します。これが設定されていない場合、ModifyVolume 操作は試行されません。これはベータフィールドであり、VolumeAttributesClass 機能を有効にする必要があります (デフォルトではオフ)。

phase

string

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

string

lastProbeTime は、条件を調査した時間です。

lastTransitionTime

string

lastTransitionTime は、ある状態から別の状態に最後に遷移した時間です。

message

string

message は、最後の遷移に関する詳細を示し、人間が判読できるメッセージです。

reason

string

一意であり、これは、条件の最後の遷移理由を示す、マシンが理解できる短い文字列である必要があります。"Resizing" と報告された場合は、基礎となる永続ボリュームのサイズが変更になっていることを意味します。

status

string

 

type

string

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

string

status は、ControllerModifyVolume 操作のステータスです。状態は次のいずれかになります: - Pending。Pending は、指定された VolumeAttributesClass が存在しないなど、要件が満たされていないため、PersistentVolumeClaim を変更できないことを示します。- InProgress。InProgress は、ボリュームが変更中であることを示します。- Infeasible。Infeasible は、要求が CSI ドライバーによって無効として拒否されたことを示します。エラーを解決するには、有効な VolumeAttributesClass を指定する必要があります。注記: 将来的に新しいステータスが追加される可能性があります。コンシューマーは不明なステータスをチェックし、適切に失敗する必要があります。

targetVolumeAttributesClassName

string

targetVolumeAttributesClassName は、現在調整中の PVC の VolumeAttributesClass の名前です。

8.1.408. .spec.thanos

説明
オプションの Thanos サイドカーの設定を定義します。
object
プロパティー説明

additionalArgs

array

AdditionalArgs を使用して、Thanos コンテナーに追加の引数を設定できます。引数はそのまま Thanos コンテナーに渡されますが、引数が無効であったり、指定された Thanos バージョンでサポートされていない場合は問題が発生する可能性があります。引数が競合する場合 (たとえば、Operator によってすでに設定されている引数)、または無効な引数を指定すると、調整は失敗し、エラーが記録されます。

additionalArgs[]

object

AdditionalArgs リストの一部である引数。

baseImage

string

非推奨: 代わりに 'image' を使用します。

blockSize

string

BlockDuration は、Prometheus によって生成される TSDB ブロックのサイズを制御します。デフォルト値は 2h で、アップストリームの Prometheus のデフォルトと一致します。

警告: ブロックの期間を変更すると、メモリーや Thanos コンパクターとの関わり方によっては、Prometheus/Thanos スタック全体のパフォーマンスと効率に影響が及ぶ可能性があります。この値は、最長のスクレイプまたはルール間隔の 120 倍に設定することが推奨されます。たとえば、30s * 120 = 1h です。

getConfigInterval

string

Prometheus 設定を取得する頻度。

getConfigTimeout

string

Prometheus 設定を取得するときの最大待機時時間。

grpcListenLocal

boolean

true の場合、Thanos サイドカーは、gRPC エンドポイントの Pod IP アドレスではなく、ループバックインターフェイスをリッスンします。

listenLocal が true の場合は効果がありません。

grpcServerTlsConfig

object

StoreAPI を提供する gRPC サーバーの TLS パラメーターを設定します。

注記: 現在、caFilecertFilekeyFile フィールドのみがサポートされています。

httpListenLocal

boolean

true の場合、Thanos サイドカーは HTTP エンドポイントの Pod IP アドレスではなく、ループバックインターフェイスをリッスンします。

listenLocal が true の場合は効果がありません。

image

string

Thanos のコンテナーイメージ名。指定されている場合、spec.thanos.baseImagespec.thanos.tag、および spec.thanos.sha フィールドよりも優先されます。

Prometheus Operator が、設定されている Thanos バージョンを認識するためには、spec.thanos.version を指定する必要があります。

spec.thanos.imagespec.thanos.baseImage のいずれも定義されていない場合、Operator は、Operator がリリースされた時点で利用可能な最新アップストリームバージョンの Thanos を使用します。

listenLocal

boolean

非推奨: 代わりに grpcListenLocalhttpListenLocal を使用します。

logFormat

string

Thanos サイドカーのログ形式。

logLevel

string

Thanos サイドカーのログレベル。

minTime

string

Thanos サイドカーの StoreAPI によって提供される時間範囲制限の開始を定義します。フィールドの値は、RFC3339 形式の定数時間、または現在の時刻に対する相対的な期間 (-1d や 2h45m など) である必要があります。有効な期間の単位は、ms、s、m、h、d、w、y です。

objectStorageConfig

object

TSDB ブロックをオブジェクトストレージにアップロードするための Thanos サイドカーの設定を定義します。

詳細情報: https://thanos.io/tip/thanos/storage.md/

objectStorageConfigFile はこのフィールドよりも優先されます。

objectStorageConfigFile

string

TSDB ブロックをオブジェクトストレージにアップロードするための Thanos サイドカーの設定ファイルを定義します。

詳細情報: https://thanos.io/tip/thanos/storage.md/

このフィールドは objectStorageConfig よりも優先されます。

readyTimeout

string

ReadyTimeout は、Thanos サイドカーが Prometheus の起動まで待機する最大時間です。

resources

object

Thanos サイドカーのリソースリクエストと制限を定義します。

sha

string

非推奨: 代わりに 'image' を使用します。イメージダイジェストは、イメージ名の一部として指定できます。

tag

string

非推奨: 代わりに 'image' を使用します。イメージのタグはイメージ名の一部として指定できます。

tracingConfig

object

Thanos サイドカーのトレーシング設定を定義します。

tracingConfigFile は、このフィールドよりも優先されます。

詳細情報: https://thanos.io/tip/thanos/tracing.md/

これは 実験的な機能 であり、今後のリリースで重大な変更が加えられる可能性があります。

tracingConfigFile

string

Thanos サイドカーのトレーシング設定ファイルを定義します。

このフィールドは tracingConfig よりも優先されます。

詳細情報: https://thanos.io/tip/thanos/tracing.md/

これは 実験的な機能 であり、今後のリリースで重大な変更が加えられる可能性があります。

version

string

デプロイされている Thanos のバージョン。Operator はこの情報を使用して、Prometheus StatefulSet と設定ファイルを生成します。

指定されていない場合、Operator は、Operator のバージョンがリリースされた時点で利用可能な Thanos の最新アップストリームリリースを想定します。

volumeMounts

array

volumeMounts を使用して、Thanos 用の追加の VolumeMounts を設定できます。指定された VolumeMounts は、'thanos-sidecar' コンテナー内の他の VolumeMounts に追加されます。

volumeMounts[]

object

VolumeMount は、コンテナー内でのボリュームのマウントについて説明します。

8.1.409. .spec.thanos.additionalArgs

説明
AdditionalArgs を使用して、Thanos コンテナーに追加の引数を設定できます。引数はそのまま Thanos コンテナーに渡されますが、引数が無効であったり、指定された Thanos バージョンでサポートされていない場合は問題が発生する可能性があります。引数が競合する場合 (たとえば、Operator によってすでに設定されている引数)、または無効な引数を指定すると、調整は失敗し、エラーが記録されます。
array

8.1.410. .spec.thanos.additionalArgs[]

説明
AdditionalArgs リストの一部である引数。
object
必須
  • name
プロパティー説明

name

string

引数の名前 (例: "scrape.discovery-reload-interval")。

value

string

引数の値 (例: 30s)。名前のみの引数は空にできます (例: --storage.tsdb.no-lockfile)

8.1.411. .spec.thanos.grpcServerTlsConfig

説明

StoreAPI を提供する gRPC サーバーの TLS パラメーターを設定します。

注記: 現在、caFilecertFilekeyFile フィールドのみがサポートされています。

object
プロパティー説明

ca

object

サーバー証明書の検証に使用される認証局。

caFile

string

ターゲットに使用する Prometheus コンテナー内の CA 証明書へのパス。

cert

object

クライアント認証を行うときに提示するクライアント証明書。

certFile

string

ターゲットの Prometheus コンテナー内のクライアント証明書ファイルへのパス。

insecureSkipVerify

boolean

ターゲット証明書の検証を無効にします。

keyFile

string

ターゲットの Prometheus コンテナー内のクライアントキーファイルへのパス。

keySecret

object

ターゲットのクライアントキーファイルを含むシークレット。

maxVersion

string

許容可能な最大 TLS バージョン。

Prometheus v2.41.0 以降が必要です。

minVersion

string

許容可能な最小 TLS バージョン。

Prometheus v2.35.0 以降が必要です。

serverName

string

ターゲットのホスト名を確認するために使用されます。

8.1.412. .spec.thanos.grpcServerTlsConfig.ca

説明
サーバー証明書の検証に使用される認証局。
object
プロパティー説明

configMap

object

ターゲットに使用するデータを含む ConfigMap。

secret

object

ターゲットに使用するデータを含むシークレット。

8.1.413. .spec.thanos.grpcServerTlsConfig.ca.configMap

説明
ターゲットに使用するデータを含む ConfigMap。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

8.1.414. .spec.thanos.grpcServerTlsConfig.ca.secret

説明
ターゲットに使用するデータを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.415. .spec.thanos.grpcServerTlsConfig.cert

説明
クライアント認証を行うときに提示するクライアント証明書。
object
プロパティー説明

configMap

object

ターゲットに使用するデータを含む ConfigMap。

secret

object

ターゲットに使用するデータを含むシークレット。

8.1.416. .spec.thanos.grpcServerTlsConfig.cert.configMap

説明
ターゲットに使用するデータを含む ConfigMap。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

8.1.417. .spec.thanos.grpcServerTlsConfig.cert.secret

説明
ターゲットに使用するデータを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.418. .spec.thanos.grpcServerTlsConfig.keySecret

説明
ターゲットのクライアントキーファイルを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.419. .spec.thanos.objectStorageConfig

説明

TSDB ブロックをオブジェクトストレージにアップロードするための Thanos サイドカーの設定を定義します。

詳細情報: https://thanos.io/tip/thanos/storage.md/

objectStorageConfigFile はこのフィールドよりも優先されます。

object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.420. .spec.thanos.resources

説明
Thanos サイドカーのリソースリクエストと制限を定義します。
object
プロパティー説明

claims

array

Claims には、spec.resourceClaims で定義され、このコンテナーによって使用されるリソースの名前がリストされます。

これはアルファフィールドであり、DynamicResourceAllocation フィーチャーゲートを有効にする必要があります。

このフィールドは不変です。これはコンテナーにのみ設定できます。

claims[]

object

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

limits

integer-or-string

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

requests

integer-or-string

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

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

string

name は、このフィールドが使用される Pod の pod.spec.resourceClaims に含まれる、1 つのエントリーの名前と一致する必要があります。これにより、そのリソースがコンテナー内で利用可能になります。

request

string

request は、参照されるクレーム内のリクエストに対して選択された名前です。空の場合、クレームからのすべてのものが利用可能になり、それ以外の場合はこの request の結果のみが利用可能になります。

8.1.423. .spec.thanos.tracingConfig

説明

Thanos サイドカーのトレーシング設定を定義します。

tracingConfigFile は、このフィールドよりも優先されます。

詳細情報: https://thanos.io/tip/thanos/tracing.md/

これは 実験的な機能 であり、今後のリリースで重大な変更が加えられる可能性があります。

object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.424. .spec.thanos.volumeMounts

説明
volumeMounts を使用して、Thanos 用の追加の VolumeMounts を設定できます。指定された VolumeMounts は、'thanos-sidecar' コンテナー内の他の VolumeMounts に追加されます。
array

8.1.425. .spec.thanos.volumeMounts[]

説明
VolumeMount は、コンテナー内でのボリュームのマウントを説明します。
object
必須
  • mountPath
  • name
プロパティー説明

mountPath

string

ボリュームをマウントする必要があるコンテナー内のパス。':' を含めることはできません。

mountPropagation

string

mountPropagation は、マウントがホストからコンテナーに、またはその逆にどのように伝播されるかを決定します。設定されていない場合、MountPropagationNone が使用されます。このフィールドは 1.10 のベータ版です。RecursiveReadOnly が IfPossible または Enabled に設定されている場合、MountPropagation は None または未指定 (デフォルトは None) にする必要があります。

name

string

ボリュームの名前に一致する必要があります。

readOnly

boolean

true の場合は読み取り専用、それ以外の場合は読み取り/書き込み (false または指定なし) でマウントされます。デフォルトは false です。

recursiveReadOnly

string

RecursiveReadOnly は、読み取り専用マウントを再帰的に処理するかどうかを指定します。

ReadOnly が false の場合、このフィールドには意味がなく、未指定にする必要があります。

ReadOnly が true で、このフィールドが Disabled に設定されている場合、マウントは再帰的に読み取り専用にはなりません。このフィールドが IfPossible に設定されている場合、コンテナーランタイムでサポートされている場合は、マウントは再帰的に読み取り専用になります。このフィールドが Enabled に設定されている場合で、コンテナーランタイムでサポートされている場合は、マウントが再帰的に読み取り専用になり、そうでない場合は Pod が起動されず、理由を示すエラーが生成されます。

このフィールドが IfPossible または Enabled に設定されている場合、MountPropagation は None に設定する必要があります (または未指定にする必要があります。この場合、デフォルトは None になります)。

このフィールドが指定されていない場合は、無効と同じ扱いになります。

subPath

string

コンテナーのボリュームをマウントする必要があるボリューム内のパス。デフォルトは "" (ボリュームのルート) です。

subPathExpr

string

コンテナーのボリュームをマウントする必要があるボリューム内の拡張パス。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

string

effect は、照合するテイントの効果を示します。空の場合は、すべてのテイント効果に一致します。指定されている場合、許可される値は NoSchedule、PreferNoSchedule、および NoExecute です。

key

string

key は toleration が適用されるテイントキーです。空の場合は、すべてのテイントキーに一致します。キーが空の場合、Operator は Exists である必要があります。この組み合わせは、すべての値とすべてのキーに一致することを意味します。

operator

string

Operator はキーと値の関係を表します。有効な Operator は Exists および Equal です。デフォルトは Equal です。Exists は、値のワイルドカードと同等であるため、Pod は特定のカテゴリーのすべてのテイントに耐えることができます。

tolerationSeconds

integer

tolerationSeconds は、toleration (effect は NoExecute でなければならず、NoExecute 以外の場合このフィールドは無視されます) が taint を許容する期間を表します。デフォルトでは設定されていません。つまり、テイントを永久に許容します (エビクトしないでください)。ゼロ値と負の値は、システムによって 0 (すぐにエビクト) として扱われます。

value

string

value は、toleration が一致するテイントの値です。Operator が Exists の場合、値は空である必要があります。それ以外の場合は、通常の文字列のみになります。

8.1.428. .spec.topologySpreadConstraints

説明
指定されている場合、Pod のトポロジー分散制約を定義します。
array

8.1.429. .spec.topologySpreadConstraints[]

説明
object
必須
  • maxSkew
  • topologyKey
  • whenUnsatisfiable
プロパティー説明

additionalLabelSelectors

string

topologySpreadConstraint の labelSelector に追加する Prometheus Operator マネージドラベルを定義します。

labelSelector

object

LabelSelector は、一致する Pod を見つけるために使用されます。このラベルセレクターに一致する Pod は、対応するトポロジードメイン内の Pod の数を決定するためにカウントされます。

matchLabelKeys

array (string)

MatchLabelKeys は、分散を計算する Pod を選択するための Pod ラベルキーのセットです。このようなキーは受信 Pod のラベルから値を検索するために使用され、このキーと値のラベルは labelSelector と AND 演算されて、受信 Pod の分散が計算される既存の Pod のグループを選択します。同じキーが MatchLabelKeys と LabelSelector の両方に存在することはできません。LabelSelector が設定されていないと、MatchLabelKeys は設定できません。受信 Pod ラベルに存在しないキーは無視されます。null または空のリストは、labelSelector とのみ一致することを意味します。

これはベータフィールドであり、MatchLabelKeysInPodTopologySpread フィーチャーゲートを有効にする必要があります (デフォルトで有効)。

maxSkew

integer

MaxSkew は、Pod が不均一に分布している可能性の程度を表します。whenUnsatisfiable = DoNotSchedule の場合、これは、ターゲットトポロジー内の一致する Pod の数とグローバル最小値との間の最大許容差です。グローバル最小値は、適格なドメイン内で一致する Pod の最小数です。または、適格なドメインの数が MinDomains 未満の場合はゼロになります。たとえば、3 ゾーンクラスターでは、MaxSkew が 1 に設定され、同じ labelSelector を持つ Pod は 2/2/1 に分散されます。この場合、グローバル最小値は 1 です。| zone1 | zone2 | zone3 | | P P | P P | P | - MaxSkew が 1 の場合、受信 Pod は 2/2/2 になるように zone 3 にのみスケジュールできます。これを zone1(zone2) にスケジュールすると、zone1(zone2) の ActualSkew(3-1) が MaxSkew(1) に違反します。- MaxSkew が 2 の場合、受信 Pod を任意のゾーンにスケジュールできます。whenUnsatisfiable = ScheduleAnyway の場合、それを満たすトポロジーに高い優先順位を与えるために使用されます。必須フィールドです。デフォルト値は 1 で、0 は許可されていません。

minDomains

integer

MinDomains は、対象となるドメインの最小数を示します。トポロジーキーが一致する適格なドメインの数が minDomains より少ない場合、Pod Topology Spread は "グローバル最小値" を 0 として扱い、スキューの計算が実行されます。また、トポロジーキーが一致する適格なドメインの数が minDomains の数以上の場合、この値はスケジュールに影響しません。その結果、対象となるドメインの数が minDomains より少ない場合、スケジューラーはそれらのドメインに対して maxSkew を超える Pod をスケジュールしません。値が nil の場合、制約は MinDomains が 1 と等しいかのように動作します。有効な値は 0 より大きい整数です。値が nil でない場合、WhenUnsatisfiable は DoNotSchedule でなければなりません。

たとえば、3 ゾーンクラスターの場合、MaxSkew は 2 に設定され、MinDomains は 5 に設定され、同じ labelSelector を持つ Pod は 2/2/2 に分散されます ( | zone1 | zone2 | zone3 | | P P | P | P | P P | P P | P P | P |)。ドメインの数は 5 (MinDomains 未満) であるため、"global minimum" は 0 として扱われます。このような場合、同じ labelSelector を持つ新しい Pod をスケジュールすることはできません。新しい Pod が 3 つのゾーンのいずれかにスケジュールされている場合、スキューは 3(3 - 0) と計算され、MaxSkew に違反するためです。

nodeAffinityPolicy

string

nodeAffinityPolicy は、Pod トポロジーの分散スキューを計算するときに Pod の nodeAffinity/nodeSelector をどのように扱うかを示します。オプションは - Honor: nodeAffinity/nodeSelector に一致するノードのみが計算に含まれます。- Ignore: nodeAffinity/nodeSelector は無視されます。すべてのノードが計算に含まれます。

この値が nil の場合、この動作は Honor ポリシーと同じです。これは、NodeInclusionPolicyInPodTopologySpread 機能フラグによってデフォルトで有効になるベータレベルの機能です。

nodeTaintsPolicy

string

NodeTaintsPolicy は、Pod トポロジースプレッドスキューを計算するときにノードのテイントを処理する方法を示します。オプション: - Honor: テイントのないノードと、受信 Pod が許容範囲でテイントがあるノードが含まれます。- Ignore: ノードのテイントは無視されます。すべてのノードが含まれます。

この値が nil の場合、この動作は Ignore ポリシーと同じです。これは、NodeInclusionPolicyInPodTopologySpread 機能フラグによってデフォルトで有効になるベータレベルの機能です。

topologyKey

string

TopologyKey は、ノードラベルのキーです。このキーと同じ値のラベルを持つノードは、同じトポロジーにあると見なされます。各 <key, value> を "バケット" と見なし、バランスの取れた数の Pod を各バケットに配置しようとします。ドメインをトポロジーの特定のインスタンスとして定義します。また、ノードが nodeAffinityPolicy および nodeTaintsPolicy の要件を満たすドメインとして、適格なドメインを定義します。たとえば、TopologyKey が "kubernetes.io/hostname" の場合、各ノードはそのトポロジーのドメインです。また、TopologyKey が "topology.kubernetes.io/zone" の場合は、各ゾーンがそのトポロジーのドメインになります。必須フィールドです。

whenUnsatisfiable

string

WhenUnsatisfiable は、スプレッドの制約を満たさない場合に Pod を処理する方法を示します。-DoNotSchedule (デフォルト) は、スケジューラーにスケジュールしないように指示します。--ScheduleAnyway は、任意の場所で Pod をスケジュールするようにスケジューラーに指示しますが、スキューを減らすのに役立つトポロジーに高い優先順位を与えます。受信 Pod に対する制約は、対象となる Pod へのノード割り当て候補すべてがトポロジーの一部の "MaxSkew" に違反する場合に、"Unsatisfiable" とみなされます。たとえば、3 ゾーンクラスターでは、MaxSkew は 1 に設定され、labelSelector が同じ Pod は 3/1/1 ( | zone1 | zone2 | zone3 | | P P P | P | P |) に分散されます。WhenUnsatisfiable が DoNotSchedule に設定されている場合、zone2(zone3) の ActualSkew(2-1) が MaxSkew(1) を満たすため、受信 Pod は zone2(zone3) にのみスケジュールして 3/2/1(3/1/2) になります。つまり、クラスターは依然として不均衡である可能性がありますが、スケジューラーによってクラスターが さらに 不均衡になることはありません。必須フィールドです。

8.1.430. .spec.topologySpreadConstraints[].labelSelector

説明
LabelSelector は、一致する Pod を見つけるために使用されます。このラベルセレクターに一致する Pod は、対応するトポロジードメイン内の Pod の数を決定するためにカウントされます。
object
プロパティー説明

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

object (string)

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

8.1.431. .spec.topologySpreadConstraints[].labelSelector.matchExpressions

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

8.1.432. .spec.topologySpreadConstraints[].labelSelector.matchExpressions[]

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

key

string

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

operator

string

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

values

array (string)

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

8.1.433. .spec.tracingConfig

説明

TracingConfig は Prometheus でトレーシングを設定します。

これは 実験的な機能 であり、今後のリリースで重大な変更が加えられる可能性があります。

object
必須
  • endpoint
プロパティー説明

clientType

string

トレースのエクスポートに使用されるクライアント。サポートされる値は http または grpc です。

圧縮

string

サポートされている圧縮タイプの圧縮キー。サポートされている値は gzip のみです。

endpoint

string

トレースの送信先となるエンドポイント。<host>:<port> の形式で指定する必要があります。

headers

object (string)

gRPC または HTTP リクエストに関連付けられたヘッダーとして使用されるキーと値のペア。

insecure

boolean

無効にすると、クライアントはセキュアな接続を使用します。

samplingFraction

integer-or-string

特定のトレースがサンプリングされる確率を設定します。0 から 1 までの浮動小数点数である必要があります。

timeout

string

エクスポーターが各バッチエクスポートを待機する最大時間。

tlsConfig

object

トレースを送信するときに使用する TLS 設定。

8.1.434. .spec.tracingConfig.tlsConfig

説明
トレースを送信するときに使用する TLS 設定。
object
プロパティー説明

ca

object

サーバー証明書の検証に使用される認証局。

caFile

string

ターゲットに使用する Prometheus コンテナー内の CA 証明書へのパス。

cert

object

クライアント認証を行うときに提示するクライアント証明書。

certFile

string

ターゲットの Prometheus コンテナー内のクライアント証明書ファイルへのパス。

insecureSkipVerify

boolean

ターゲット証明書の検証を無効にします。

keyFile

string

ターゲットの Prometheus コンテナー内のクライアントキーファイルへのパス。

keySecret

object

ターゲットのクライアントキーファイルを含むシークレット。

maxVersion

string

許容可能な最大 TLS バージョン。

Prometheus v2.41.0 以降が必要です。

minVersion

string

許容可能な最小 TLS バージョン。

Prometheus v2.35.0 以降が必要です。

serverName

string

ターゲットのホスト名を確認するために使用されます。

8.1.435. .spec.tracingConfig.tlsConfig.ca

説明
サーバー証明書の検証に使用される認証局。
object
プロパティー説明

configMap

object

ターゲットに使用するデータを含む ConfigMap。

secret

object

ターゲットに使用するデータを含むシークレット。

8.1.436. .spec.tracingConfig.tlsConfig.ca.configMap

説明
ターゲットに使用するデータを含む ConfigMap。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

8.1.437. .spec.tracingConfig.tlsConfig.ca.secret

説明
ターゲットに使用するデータを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.438. .spec.tracingConfig.tlsConfig.cert

説明
クライアント認証を行うときに提示するクライアント証明書。
object
プロパティー説明

configMap

object

ターゲットに使用するデータを含む ConfigMap。

secret

object

ターゲットに使用するデータを含むシークレット。

8.1.439. .spec.tracingConfig.tlsConfig.cert.configMap

説明
ターゲットに使用するデータを含む ConfigMap。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

8.1.440. .spec.tracingConfig.tlsConfig.cert.secret

説明
ターゲットに使用するデータを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.441. .spec.tracingConfig.tlsConfig.keySecret

説明
ターゲットのクライアントキーファイルを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.442. .spec.tsdb

説明
ランタイムでのリロードが可能な時系列データベース (TSDB) の設定を定義します。Prometheus v2.39.0 以降または PrometheusAgent v2.54.0 以降が必要です。
object
プロパティー説明

outOfOrderTimeWindow

string

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

mountPath

string

ボリュームをマウントする必要があるコンテナー内のパス。':' を含めることはできません。

mountPropagation

string

mountPropagation は、マウントがホストからコンテナーに、またはその逆にどのように伝播されるかを決定します。設定されていない場合、MountPropagationNone が使用されます。このフィールドは 1.10 のベータ版です。RecursiveReadOnly が IfPossible または Enabled に設定されている場合、MountPropagation は None または未指定 (デフォルトは None) にする必要があります。

name

string

ボリュームの名前に一致する必要があります。

readOnly

boolean

true の場合は読み取り専用、それ以外の場合は読み取り/書き込み (false または指定なし) でマウントされます。デフォルトは false です。

recursiveReadOnly

string

RecursiveReadOnly は、読み取り専用マウントを再帰的に処理するかどうかを指定します。

ReadOnly が false の場合、このフィールドには意味がなく、未指定にする必要があります。

ReadOnly が true で、このフィールドが Disabled に設定されている場合、マウントは再帰的に読み取り専用にはなりません。このフィールドが IfPossible に設定されている場合、コンテナーランタイムでサポートされている場合は、マウントは再帰的に読み取り専用になります。このフィールドが Enabled に設定されている場合で、コンテナーランタイムでサポートされている場合は、マウントが再帰的に読み取り専用になり、そうでない場合は Pod が起動されず、理由を示すエラーが生成されます。

このフィールドが IfPossible または Enabled に設定されている場合、MountPropagation は None に設定する必要があります (または未指定にする必要があります。この場合、デフォルトは None になります)。

このフィールドが指定されていない場合は、無効と同じ扱いになります。

subPath

string

コンテナーのボリュームをマウントする必要があるボリューム内のパス。デフォルトは "" (ボリュームのルート) です。

subPathExpr

string

コンテナーのボリュームをマウントする必要があるボリューム内の拡張パス。SubPath と同様に動作しますが、環境変数参照 $(VAR_NAME) は、コンテナーの環境を使用してデプロイメントされます。デフォルトは "" (ボリュームのルート) です。SubPathExpr と SubPath は相互に排他的です。

8.1.445. .spec.volumes

説明
volumes を使用して、出力の StatefulSet 定義に追加のボリュームを設定できます。指定されたボリュームは、StorageSpec オブジェクトの結果として生成される他のボリュームに追加されます。
array

8.1.446. .spec.volumes[]

説明
ボリュームは、Pod 内の任意のコンテナーからアクセスできる Pod 内の名前付きボリュームを表します。
object
必須
  • name
プロパティー説明

awsElasticBlockStore

object

awsElasticBlockStore は、kubelet のホストマシンに割り当てられ、Pod に公開される AWS Disk リソースを表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

azureDisk

object

azureDisk は、ホスト上の Azure Data Disk マウントを表し、Pod へのバインドマウントを表します。

azureFile

object

azureFile は、ホスト上の Azure File Service マウントを表し、マウントを Pod にバインドします。

cephfs

object

cephFS は、Pod の有効期間を共有するホストでの Ceph FS マウントを表します。

cinder

object

Cinder は、kubelets ホストマシンに接続およびマウントされた Cinder ボリュームを表します。詳細: https://examples.k8s.io/mysql-cinder-pd/README.md

configMap

object

configMap は、このボリュームに入力する必要がある configMap を表します

csi

object

csi (Container Storage Interface) は、特定の外部 CSI ドライバー (ベータ機能) によって処理される一時的なストレージを表します。

downwardAPI

object

downwardAPI は、このボリュームに入力する必要がある Pod に関する Downward API を表します

emptyDir

object

emptyDir は、Pod の存続期間を共有する一時ディレクトリーを表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#emptydir

ephemeral

object

ephemeral は、クラスターストレージドライバーによって処理されるボリュームを表します。ボリュームのライフサイクルは、ボリュームを定義する Pod に関連付けられています。ボリュームは、Pod が起動する前に作成され、Pod が削除されると削除されます。

これは、次の場合に使用します。a)Pod の実行中にのみボリュームが必要、b) スナップショットからの復元や容量追跡などの通常のボリュームの機能が必要、c) ストレージドライバーがストレージクラスを通じて指定される、d) ストレージドライバー PersistentVolumeClaim を介した動的ボリュームプロビジョニングをサポートします (このボリュームタイプと PersistentVolumeClaim の間の接続の詳細は、EphemeralVolumeSource を参照してください)。

個々の Pod のライフサイクルより長く持続するボリュームには、PersistentVolumeClaim またはベンダー固有の API の 1 つを使用します。

CSI ドライバーをそのように使用する場合は、軽量のローカルエフェメラルボリュームに CSI を使用します。詳細は、ドライバーのドキュメントを参照してください。

Pod は、両方のタイプのエフェメラルボリュームとパーシステントボリュームを同時に使用できます。

fc

object

fc は、kubelet のホストマシンに接続されてから Pod に公開されるファイバーチャネルリソースを表します。

flexVolume

object

flexVolume は、exec ベースのプラグインを使用してプロビジョニング/接続される汎用ボリュームリソースを表します。

flocker

object

flocker は、kubelet のホストマシンに接続されている Flocker ボリュームを表します。これは、実行中の Flocker 制御サービスによって異なります

gcePersistentDisk

object

gcePersistentDisk は、kubelet のホストマシンに接続されてから Pod に公開される GCE ディスクリソースを表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

gitRepo

object

gitRepo は、特定のリビジョンの git リポジトリーを表します。非推奨:GitRepo は非推奨です。git レポジトリを使用してコンテナーをプロビジョニングするには、Git を使用してレポジトリのクローンを作成する InitContainer に EmptyDir をマウントしてから、Pod のコンテナーに EmptyDir をマウントします。

glusterfs

object

glusterfs は、Pod の存続期間を共有するホスト上の Glusterfs マウントを表します。詳細: https://examples.k8s.io/volumes/glusterfs/README.md

hostPath

object

hostPath は、コンテナーに直接公開されているホストマシン上の既存のファイルまたはディレクトリーを表します。これは通常、ホストマシンの表示を許可されているシステムエージェントまたはその他の特権的なものに使用されます。ほとんどのコンテナーはこれを必要としません。詳細: https://kubernetes.io/docs/concepts/storage/volumes#hostpath

image

object

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

object

iscsi は、kubelet のホストマシンに接続されてから Pod に公開される ISCSI ディスクリソースを表します。詳細: https://examples.k8s.io/volumes/iscsi/README.md

name

string

ボリュームの名前。DNS_LABEL であり、Pod 内で一意である必要があります。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

nfs

object

NFS は、Pod の有効期間を共有するホスト上の NFS マウントを表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#nfs

persistentVolumeClaim

object

persistentVolumeClaimVolumeSource は、同じ namespace 内の PersistentVolumeClaim への参照を表します。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims

photonPersistentDisk

object

photonPersistentDisk は、kubelets ホストマシンに接続されマウントされた PhotonController 永続ディスクを表します。

portworxVolume

object

portworxVolume は、kubelet ホストマシンに接続およびマウントされた portworx ボリュームを表します。

projected

object

オールインワンリソースシークレット、configmaps、および Downward API のアイテム

quobyte

object

quobyte は、Pod の有効期限を共有するホストでの Quobyte マウントを表します

rbd

object

rbd は、Pod の有効期間を共有するホストの Rados ブロックデバイスマウントを表します。詳細: https://examples.k8s.io/volumes/rbd/README.md

scaleIO

object

scaleIO は、Kubernetes ノードに接続およびマウントされた ScaleIO 永続ボリュームを表します。

secret

object

secret は、このボリュームに入力する必要がある Secret を表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#secret

storageos

object

storageOS は、Kubernetes ノードに接続およびマウントされた StorageOS ボリュームを表します。

vsphereVolume

object

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

string

fsType は、マウントするボリュームのファイルシステムタイプです。ヒント: ファイルシステムタイプがホストオペレーティングシステムでサポートされていることを確認してください。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

partition

integer

partition は、マウントするボリューム内のパーティションです。省略した場合、デフォルトではボリューム名でマウントします。例: ボリューム/dev/sda1 の場合、パーティションを "1" として指定します。同様に、/dev/sda のボリュームパーティションは "0" です (または、プロパティーを空のままにしておくこともできます)。

readOnly

boolean

readOnly 値 true は、VolumeMounts の readOnly 設定を強制的に実行します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

volumeID

string

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

string

cachingMode はホストキャッシュモードです (None, Read Only, Read Write)。

diskName

string

diskName は、Blob ストレージ内のデータディスクの名前です。

diskURI

string

diskURI は、BLOB ストレージ内のデータディスクの URI です

fsType

string

fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。

kind

string

kind での期待値は、Shared (ストレージアカウントごとに複数のブロブディスク)、Dedicated (ストレージアカウントごとにブロブ 1 つ)、Managed (Azure の管理データディスク (管理対象のアベイラビリティーセットのみ)) です。デフォルトは Shared です。

readOnly

boolean

readOnly。デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。

8.1.449. .spec.volumes[].azureFile

説明
azureFile は、ホスト上の Azure File Service マウントを表し、マウントを Pod にバインドします。
object
必須
  • secretName
  • shareName
プロパティー説明

readOnly

boolean

readOnly のデフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。

secretName

string

secretName は、Azure ストレージアカウント名とキーを含むシークレットの名前です。

shareName

string

shareName は Azure 共有名です。

8.1.450. .spec.volumes[].cephfs

説明
cephFS は、Pod の有効期間を共有するホストでの Ceph FS マウントを表します。
object
必須
  • monitors
プロパティー説明

monitors

array (string)

monitors は必須: Monitors は Ceph モニターのコレクションです。詳細: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

path

string

パスは任意: 完全な Ceph ツリーではなく、マウントされたルートとして使用されます。デフォルトは / です。

readOnly

boolean

readOnly は任意: デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。詳細: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

secretFile

string

secretFile は任意: SecretFile はユーザーのキーリングへのパスです。デフォルトは /etc/ceph/user.secret です。詳細: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

secretRef

object

secretRef は任意: SecretRef はユーザーの認証シークレットへの参照で、デフォルトは空です。詳細: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

user

string

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

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: 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

string

fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。詳細: https://examples.k8s.io/mysql-cinder-pd/README.md

readOnly

boolean

readOnly のデフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。詳細: https://examples.k8s.io/mysql-cinder-pd/README.md

secretRef

object

secretRef は任意: OpenStack への接続に使用されるパラメーターを含むシークレットオブジェクトを指します。

volumeID

string

cinder 内のボリュームを識別するために使用される volumeID。詳細: https://examples.k8s.io/mysql-cinder-pd/README.md

8.1.453. .spec.volumes[].cinder.secretRef

説明
secretRef は任意: OpenStack への接続に使用されるパラメーターを含むシークレットオブジェクトを指します。
object
プロパティー説明

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

8.1.454. .spec.volumes[].configMap

説明
configMap は、このボリュームに入力する必要がある configMap を表します
object
プロパティー説明

defaultMode

integer

defaultMode は任意: デフォルトで、作成されたファイルのアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。デフォルトは 0644 に設定されます。パス内のディレクトリーはこの設定の影響を受けません。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。

items

array

item が指定されていない場合、参照される ConfigMap の Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。ConfigMap に存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。

items[]

object

文字列キーをボリューム内のパスにマップします。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

任意。ConfigMap かそのキーを定義する必要があるかどうかを指定します。

8.1.455. .spec.volumes[].configMap.items

説明
item が指定されていない場合、参照される ConfigMap の Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。ConfigMap に存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。
array

8.1.456. .spec.volumes[].configMap.items[]

説明
文字列キーをボリューム内のパスにマップします。
object
必須
  • key
  • path
プロパティー説明

key

string

key はプロジェクトのキーです。

mode

integer

mode は任意: このファイルにアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。

path

string

path はキーをマップするファイルの相対パスです。絶対的なパスではない可能性があります。パス要素 '..' を含めることはできません。文字列 '..' で始まらない場合があります。

8.1.457. .spec.volumes[].csi

説明
csi (Container Storage Interface) は、特定の外部 CSI ドライバー (ベータ機能) によって処理される一時的なストレージを表します。
object
必須
  • driver
プロパティー説明

driver

string

driver は、このボリュームを処理する CSI ドライバーの名前です。クラスターに登録されている正しい名前は、管理者に相談してください。

fsType

string

マウントする fsType。例: "ext4"、"xfs"、"ntfs"。指定しない場合、空の値が関連する CSI ドライバーに渡され、適用するデフォルトのファイルシステムが決定されます。

nodePublishSecretRef

object

nodePublishSecretRef は、CSI NodePublishVolume および NodeUnpublishVolume 呼び出しを完了するために CSI ドライバーに渡す機密情報を含むシークレットオブジェクトへの参照です。このフィールドはオプションであり、シークレットが不要な場合は空の場合があります。シークレットオブジェクトに複数のシークレットが含まれている場合、すべてのシークレット参照が渡されます。

readOnly

boolean

readOnly は、ボリュームの読み取り専用設定を指定します。デフォルトは false (読み取り/書き込み) です。

volumeAttributes

object (string)

volumeAttributes は、CSI ドライバーに渡されるドライバー固有のプロパティーを格納します。サポートされている値は、ドライバーのドキュメントを参照してください。

8.1.458. .spec.volumes[].csi.nodePublishSecretRef

説明
nodePublishSecretRef は、CSI NodePublishVolume および NodeUnpublishVolume 呼び出しを完了するために CSI ドライバーに渡す機密情報を含むシークレットオブジェクトへの参照です。このフィールドはオプションであり、シークレットが不要な場合は空の場合があります。シークレットオブジェクトに複数のシークレットが含まれている場合、すべてのシークレット参照が渡されます。
object
プロパティー説明

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

8.1.459. .spec.volumes[].downwardAPI

説明
downwardAPI は、このボリュームに入力する必要がある Pod に関する Downward API を表します
object
プロパティー説明

defaultMode

integer

オプション: デフォルトで作成されたファイルで使用するモードビット。オプション: デフォルトで作成されたファイルのパーミッションを設定するために使用されるモードビット。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。デフォルトは 0644 に設定されます。パス内のディレクトリーはこの設定の影響を受けません。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。

items

array

items は、Downward API ボリュームファイルのリストです

items[]

object

DownwardAPIVolumeFile は、Pod フィールドを含むファイルを作成するための情報を表します

8.1.460. .spec.volumes[].downwardAPI.items

説明
items は、Downward API ボリュームファイルのリストです
array

8.1.461. .spec.volumes[].downwardAPI.items[]

説明
DownwardAPIVolumeFile は、Pod フィールドを含むファイルを作成するための情報を表します
object
必須
  • path
プロパティー説明

fieldRef

object

必須: Pod のフィールドを選択します。アノテーション、ラベル、名前、namespace、および UID のみがサポートされています。

mode

integer

オプション: このファイルの権限を設定するために使用されるモードビットは、0000 から 0777 までの 8 進数値、または 0 から 511 までの 10 進数値でなければなりません。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。

path

string

必須: パスは、作成するファイルの相対パス名です。絶対パスまたは '..' パスを含めることはできません。utf-8 でエンコードする必要があります。相対パスの最初の項目は '..' で始まってはなりません。

resourceFieldRef

object

コンテナーのリソースを選択します。現在、リソースの制限とリクエスト (limits.cpu、limits.memory、requests.cpu、requests.memory) のみがサポートされています。

8.1.462. .spec.volumes[].downwardAPI.items[].fieldRef

説明
必須: Pod のフィールドを選択します。アノテーション、ラベル、名前、namespace、および UID のみがサポートされています。
object
必須
  • fieldPath
プロパティー説明

apiVersion

string

FieldPath が記述されているスキーマのバージョン。デフォルトは "v1" です。

fieldPath

string

指定された API バージョンで選択するフィールドのパス。

8.1.463. .spec.volumes[].downwardAPI.items[].resourceFieldRef

説明
コンテナーのリソースを選択します。現在、リソースの制限とリクエスト (limits.cpu、limits.memory、requests.cpu、requests.memory) のみがサポートされています。
object
必須
  • resource
プロパティー説明

containerName

string

コンテナー名: ボリュームには必須、env 変数にはオプション

divisor

integer-or-string

公開されたリソースの出力形式を指定します。デフォルトは "1" です。

resource

string

必須: 選択するリソース

8.1.464. .spec.volumes[].emptyDir

説明
emptyDir は、Pod の存続期間を共有する一時ディレクトリーを表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#emptydir
object
プロパティー説明

medium

string

medium は、このディレクトリーをバックアップする必要があるストレージメディアのタイプを表します。デフォルトは"" です。これは、ノードのデフォルトのメディアを使用することを意味します。空の文字列 (デフォルト) またはメモリーである必要があります。詳細: https://kubernetes.io/docs/concepts/storage/volumes#emptydir

sizeLimit

integer-or-string

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

volumeClaimTemplate

object

ボリュームをプロビジョニングするためのスタンドアロン 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 であってはなりません。

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

metadata

object

PVC の作成時に PVC にコピーされるラベルとアノテーションが含まれる場合があります。他のフィールドは許可されておらず、検証中に拒否されます。

spec

object

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

array (string)

accessModes には、ボリュームに割り当てる必要のあるアクセスモードが含まれます。詳細は、https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 を参照してください。

dataSource

object

dataSource フィールドは、次のいずれかを指定するために使用できます。*既存の VolumeSnapshot オブジェクト (snapshot.storage.k8s.io/VolumeSnapshot)*既存の PVC(PersistentVolumeClaim) プロビジョナーまたは外部コントローラーが指定されたデータソースをサポートできる場合、指定されたデータソースのコンテンツに基づく新しいボリューム。AnyVolumeDataSource フィーチャーゲートが有効になっている場合、dataSource の内容は dataSourceRef にコピーされ、dataSourceRef.namespace が指定されていない場合に dataSourceRef コンテンツが dataSource にコピーされます。namespace が指定されている場合、dataSourceRef は dataSource にコピーされません。

dataSourceRef

object

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

object

resources は、ボリュームに必要な最小リソースを表します。RecoverVolumeExpansionFailure 機能が有効になっている場合、ユーザーは以前の値よりも低いリソース要件を指定できますが、要求のステータスフィールドに記録された容量よりも大きい必要があります。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources

selector

object

selector は、バインドを考慮するボリュームに対するラベルクエリーです。

storageClassName

string

storageClassName は、要求に必要な StorageClass の名前です。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1

volumeAttributesClassName

string

volumeAttributesClassName は、このクレームで使用される VolumeAttributesClass を設定するために使用できます。指定すると、CSI ドライバーは、対応する VolumeAttributesClass で定義された属性を使用してボリュームを作成または更新します。これは storageClassName とは異なる目的があり、クレームの作成後に変更できます。空の文字列値は、クレームに VolumeAttributesClass が適用されないことを意味しますが、一度設定すると、このフィールドを空の文字列にリセットすることはできません。指定されておらず、PersistentVolumeClaim がバインドされていない場合は、永続ボリュームコントローラーが存在する場合は、デフォルトの VolumeAttributesClass が設定されます。volumeAttributesClass によって参照されるリソースが存在しない場合は、そのようなリソースが存在するまで、この PersistentVolumeClaim は、modifyVolumeStatus フィールドに反映されるように、保留状態に設定されます。詳細は、https://kubernetes.io/docs/concepts/storage/volume-attributes-classes/ (ベータ版) を参照してください。このフィールドを使用するには、VolumeAttributesClass フィーチャーゲートを有効にする必要があります (デフォルトではオフ)。

volumeMode

string

volumeMode は、要求に必要なボリュームのタイプを定義します。Filesystem の値は、要求仕様に含まれていない場合に暗示されます。

volumeName

string

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

string

APIGroup は参照されているリソースのグループです。APIGroup が指定されていない場合は、指定の Kind をコア API グループに設定する必要があります。他のサードパーティータイプには、APIGroup が必要です。

kind

string

kind は参照されているリソースのタイプです。

name

string

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

string

APIGroup は参照されているリソースのグループです。APIGroup が指定されていない場合は、指定の Kind をコア API グループに設定する必要があります。他のサードパーティータイプには、APIGroup が必要です。

kind

string

kind は参照されているリソースのタイプです。

name

string

name は、参照されているリソースの名前です。

namespace

string

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

integer-or-string

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

requests

integer-or-string

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

8.1.472. .spec.volumes[].ephemeral.volumeClaimTemplate.spec.selector

説明
selector は、バインドを考慮するボリュームに対するラベルクエリーです。
object
プロパティー説明

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

object (string)

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

string

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

operator

string

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

values

array (string)

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

8.1.475. .spec.volumes[].fc

説明
fc は、kubelet のホストマシンに接続されてから Pod に公開されるファイバーチャネルリソースを表します。
object
プロパティー説明

fsType

string

fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。

lun

integer

LUN は任意: FC ターゲットの LUN 番号

readOnly

boolean

readOnly は任意: デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。

targetWWNs

array (string)

targetWWNs は任意: FC ターゲットのワールドワイド名 (WWN)

wwids

array (string)

wwids は任意: FC ボリュームのワールドワイド ID(wwids)wwids または targetWWN と lun の組み合わせのいずれかを設定する必要がありますが、両方を同時に設定できません。

8.1.476. .spec.volumes[].flexVolume

説明
flexVolume は、exec ベースのプラグインを使用してプロビジョニング/接続される汎用ボリュームリソースを表します。
object
必須
  • driver
プロパティー説明

driver

string

driver は、このボリュームに使用するドライバーの名前です。

fsType

string

fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。デフォルトのファイルシステムは FlexVolume スクリプトに依存します。

options

object (string)

options は任意: このフィールドには追加のコマンドオプションがあれば保持されます。

readOnly

boolean

readOnly は任意: デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。

secretRef

object

secretRef は任意: secretRef は、プラグインスクリプトに渡す機密情報を含むシークレットオブジェクトへの参照です。シークレットオブジェクトが指定されていない場合、これは空になる可能性があります。シークレットオブジェクトに複数のシークレットが含まれている場合、すべてのシークレットがプラグインスクリプトに渡されます。

8.1.477. .spec.volumes[].flexVolume.secretRef

説明
secretRef は任意: secretRef は、プラグインスクリプトに渡す機密情報を含むシークレットオブジェクトへの参照です。シークレットオブジェクトが指定されていない場合、これは空になる可能性があります。シークレットオブジェクトに複数のシークレットが含まれている場合、すべてのシークレットがプラグインスクリプトに渡されます。
object
プロパティー説明

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

8.1.478. .spec.volumes[].flocker

説明
flocker は、kubelet のホストマシンに接続されている Flocker ボリュームを表します。これは、実行中の Flocker 制御サービスによって異なります
object
プロパティー説明

datasetName

string

datasetName はメタデータとして保存されているデータセットの名前です Flocker のデータセット上の名前は非推奨として扱うようにしてください。

datasetUUID

string

datasetUUID は、データセットの UUID です。これは Flocker データセットの一意の識別子です

8.1.479. .spec.volumes[].gcePersistentDisk

説明
gcePersistentDisk は、kubelet のホストマシンに接続されてから Pod に公開される GCE ディスクリソースを表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk
object
必須
  • pdName
プロパティー説明

fsType

string

fsType は、マウントするボリュームのファイルシステムタイプです。ヒント: ファイルシステムタイプがホストオペレーティングシステムでサポートされていることを確認してください。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

partition

integer

partition は、マウントするボリューム内のパーティションです。省略した場合、デフォルトではボリューム名でマウントします。例: ボリューム/dev/sda1 の場合、パーティションを "1" として指定します。同様に、/dev/sda のボリュームパーティションは "0" です (または、プロパティーを空のままにしておくこともできます)。詳細: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

pdName

string

pdName は、GCE の PD リソースの一意の名前です。GCE でディスクを識別するために使用されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

readOnly

boolean

この 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

string

directory は、ターゲットディレクトリー名です。'..' を含まない、または..で始まらないようにする必要があります。もしも '。' が提供されている場合、ボリュームディレクトリーは git リポジトリーになります。それ以外の場合、指定されている場合、ボリュームには、指定された名前のサブディレクトリーに git リポジトリーが含まれます。

repository

string

repository は URL です。

revision

string

revision は、指定されたリビジョンのコミットハッシュです。

8.1.481. .spec.volumes[].glusterfs

説明
glusterfs は、Pod の存続期間を共有するホスト上の Glusterfs マウントを表します。詳細: https://examples.k8s.io/volumes/glusterfs/README.md
object
必須
  • endpoints
  • path
プロパティー説明

endpoints

string

endpoints は、Glusterfs トポロジーの詳細を示すエンドポイント名です。詳細: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

path

string

path は Glusterfs ボリュームパスです。詳細: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

readOnly

boolean

この 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
プロパティー説明

path

string

ホスト上のディレクトリーのパス。パスがシンボリックリンクの場合、実際のパスへのリンクをたどります。詳細: https://kubernetes.io/docs/concepts/storage/volumes#hostpath

type

string

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

pullPolicy

string

OCI オブジェクトをプルするためのポリシー。使用できる値: Always: kubelet は常に参照のプルを試行します。プルに失敗すると、コンテナーの作成は失敗します。Never: kubelet は参照をプルせず、ローカルイメージまたはアーティファクトのみを使用します。参照が存在しない場合は、コンテナーの作成に失敗します。IfNotPresent: 参照がディスクに存在しない場合は、kubelet がプルします。参照が存在しず、プルが失敗すると、コンテナーの作成は失敗します。デフォルトは、:latest タグが指定されている場合は常に、それ以外の場合は IfNotPresent です。

reference

string

必須: 使用するイメージまたはアーティファクトの参照。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

boolean

chapAuthDiscovery は、iSCSI 検出 CHAP 認証をサポートするかどうかを定義します。

chapAuthSession

boolean

chapAuthSession は、iSCSI セッション CHAP 認証をサポートするかどうかを定義します。

fsType

string

fsType は、マウントするボリュームのファイルシステムタイプです。ヒント: ファイルシステムタイプがホストオペレーティングシステムでサポートされていることを確認してください。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes#iscsi

initiatorName

string

initiatorName は、カスタムの iSCSI イニシエーター名です。iscsiInterface と同時に initiatorName を指定すると、接続用に新しい iSCSI インターフェイス <target portal>:<volume name> が作成されます。

iqn

string

iqn は、ターゲットの iSCSI 修飾名です。

iscsiInterface

string

iscsiInterface は、iSCSI トランスポートを使用するインターフェイス名です。デフォルトは 'default' (tcp) です。

lun

integer

lun は、iSCSI ターゲット Lun 番号を表します。

portals

array (string)

ポータルは iSCSI ターゲットポータルリストです。ポートがデフォルト以外の場合、ポータルは IP または ip_addr:port のいずれかです (通常は TCP ポート 860 および 3260)。

readOnly

boolean

この readOnly は、VolumeMounts で ReadOnly 設定が強制的に指定されます。デフォルトは false です。

secretRef

object

secretRef は、iSCSI ターゲットおよびイニシエーター認証用の CHAP Secret です。

targetPortal

string

targetPortal は iSCSI Target Portal です。ポートがデフォルト以外の場合、ポータルは IP または ip_addr:port のいずれかです (通常は TCP ポート 860 および 3260)。

8.1.485. .spec.volumes[].iscsi.secretRef

説明
secretRef は、iSCSI ターゲットおよびイニシエーター認証用の CHAP Secret です。
object
プロパティー説明

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: 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
プロパティー説明

path

string

NFS サーバーがエクスポートしているパス。詳細: https://kubernetes.io/docs/concepts/storage/volumes#nfs

readOnly

boolean

ここで readOnly を指定すると、NFS エクスポートが読み取り専用権限で強制的にマウントされます。デフォルトは false です。詳細: https://kubernetes.io/docs/concepts/storage/volumes#nfs

server

string

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

string

claimName は、このボリュームを使用する Pod と同じ namespace にある PersistentVolumeClaim の名前です。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims

readOnly

boolean

readOnly は、VolumeMounts の ReadOnly 設定が強制的に指定されます。デフォルト: false

8.1.488. .spec.volumes[].photonPersistentDisk

説明
photonPersistentDisk は、kubelets ホストマシンに接続されマウントされた PhotonController 永続ディスクを表します。
object
必須
  • pdID
プロパティー説明

fsType

string

fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。

pdID

string

pdID は、Photon Controller の永続ディスクを識別する ID です。

8.1.489. .spec.volumes[].portworxVolume

説明
portworxVolume は、kubelet ホストマシンに接続およびマウントされた portworx ボリュームを表します。
object
必須
  • volumeID
プロパティー説明

fsType

string

fSType は、マウントするファイルシステムタイプを表します。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。

readOnly

boolean

readOnly のデフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。

volumeID

string

volumeID は、Portworx ボリュームを一意に識別します

8.1.490. .spec.volumes[].projected

説明
オールインワンリソースシークレット、configmaps、および Downward API のアイテム
object
プロパティー説明

defaultMode

integer

defaultMode は、作成されたファイルにデフォルトでアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。パス内のディレクトリーはこの設定の影響を受けません。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。

sources

array

sources は、ボリュームプロジェクションのリストです。このリストの各エントリーは 1 つのソースを処理します。

sources[]

object

サポートされている他のボリュームタイプと一緒にデプロイメントされる可能性のあるプロジェクションこれらのフィールドのいずれかを設定する必要があります。

8.1.491. .spec.volumes[].projected.sources

説明
sources は、ボリュームプロジェクションのリストです。このリストの各エントリーは 1 つのソースを処理します。
array

8.1.492. .spec.volumes[].projected.sources[]

説明
サポートされている他のボリュームタイプと一緒にデプロイメントされる可能性のあるプロジェクションこれらのフィールドのいずれかを設定する必要があります。
object
プロパティー説明

clusterTrustBundle

object

ClusterTrustBundle を使用すると、Pod が自動更新ファイル内の ClusterTrustBundle オブジェクトの .spec.trustBundle フィールドにアクセスできるようになります。

アルファ段階。ClusterTrustBundleProjection フィーチャーゲートによってゲートされます。

ClusterTrustBundle オブジェクトは、名前で選択することも、署名者名とラベルセレクターの組み合わせで選択することもできます。

Kubelet は、Pod ファイルシステムに書き込まれた PEM コンテンツの積極的な正規化を実行します。ブロック間コメントやブロックヘッダーなどの難解な PEM 機能は削除されます。証明書は重複排除されます。ファイル内の証明書の順序は任意です。Kubelet は時間の経過に伴い順序を変更する可能性があります。

configMap

object

プロジェクトへの configMap データの onfigMap 情報

downwardAPI

object

downwardAPI データのプロジェクトへの downwardAPI 情報

secret

object

投影するシークレットデータに関する情報

serviceAccountToken

object

serviceAccountToken は、投影する serviceAccountToken データに関する情報です。

8.1.493. .spec.volumes[].projected.sources[].clusterTrustBundle

説明

ClusterTrustBundle を使用すると、Pod が自動更新ファイル内の ClusterTrustBundle オブジェクトの .spec.trustBundle フィールドにアクセスできるようになります。

アルファ段階。ClusterTrustBundleProjection フィーチャーゲートによってゲートされます。

ClusterTrustBundle オブジェクトは、名前で選択することも、署名者名とラベルセレクターの組み合わせで選択することもできます。

Kubelet は、Pod ファイルシステムに書き込まれた PEM コンテンツの積極的な正規化を実行します。ブロック間コメントやブロックヘッダーなどの難解な PEM 機能は削除されます。証明書は重複排除されます。ファイル内の証明書の順序は任意です。Kubelet は時間の経過に伴い順序を変更する可能性があります。

object
必須
  • path
プロパティー説明

labelSelector

object

このラベルセレクターに一致するすべての ClusterTrustBundle を選択します。signerName が設定されている場合にのみ有効です。名前と相互に排他的です。設定されていない場合は、"何も一致しない" と解釈されます。設定されているが空の場合は、"すべてに一致する" と解釈されます。

name

string

オブジェクト名で単一の ClusterTrustBundle を選択します。signerName および labelSelector とは相互に排他的です。

optional

boolean

true の場合で、参照された ClusterTrustBundle が利用できない場合は、Pod の起動をブロックしないでください。名前を使用する場合、名前付き ClusterTrustBundle が存在しないことが許可されます。signerName を使用する場合、signerName と labelSelector の組み合わせは、0 個の ClusterTrustBundles と一致できます。

path

string

バンドルを書き込むためのボリュームルートからの相対パス。

signerName

string

この署名者名に一致するすべての ClusterTrustBundle を選択します。名前と相互に排他的です。選択されたすべての ClusterTrustBundle の内容が統合され、重複が排除されます。

8.1.494. .spec.volumes[].projected.sources[].clusterTrustBundle.labelSelector

説明
このラベルセレクターに一致するすべての ClusterTrustBundle を選択します。signerName が設定されている場合にのみ有効です。名前と相互に排他的です。設定されていない場合は、"何も一致しない" と解釈されます。設定されているが空の場合は、"すべてに一致する" と解釈されます。
object
プロパティー説明

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

object (string)

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

string

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

operator

string

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

values

array (string)

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

8.1.497. .spec.volumes[].projected.sources[].configMap

説明
プロジェクトへの configMap データの onfigMap 情報
object
プロパティー説明

items

array

item が指定されていない場合、参照される ConfigMap の Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。ConfigMap に存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。

items[]

object

文字列キーをボリューム内のパスにマップします。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

任意。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

string

key はプロジェクトのキーです。

mode

integer

mode は任意: このファイルにアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。

path

string

path はキーをマップするファイルの相対パスです。絶対的なパスではない可能性があります。パス要素 '..' を含めることはできません。文字列 '..' で始まらない場合があります。

8.1.500. .spec.volumes[].projected.sources[].downwardAPI

説明
downwardAPI データのプロジェクトへの downwardAPI 情報
object
プロパティー説明

items

array

Items は DownwardAPIVolume ファイルのリストです

items[]

object

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

fieldRef

object

必須: Pod のフィールドを選択します。アノテーション、ラベル、名前、namespace、および UID のみがサポートされています。

mode

integer

オプション: このファイルの権限を設定するために使用されるモードビットは、0000 から 0777 までの 8 進数値、または 0 から 511 までの 10 進数値でなければなりません。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。

path

string

必須: パスは、作成するファイルの相対パス名です。絶対パスまたは '..' パスを含めることはできません。utf-8 でエンコードする必要があります。相対パスの最初の項目は '..' で始まってはなりません。

resourceFieldRef

object

コンテナーのリソースを選択します。現在、リソースの制限とリクエスト (limits.cpu、limits.memory、requests.cpu、requests.memory) のみがサポートされています。

8.1.503. .spec.volumes[].projected.sources[].downwardAPI.items[].fieldRef

説明
必須: Pod のフィールドを選択します。アノテーション、ラベル、名前、namespace、および UID のみがサポートされています。
object
必須
  • fieldPath
プロパティー説明

apiVersion

string

FieldPath が記述されているスキーマのバージョン。デフォルトは "v1" です。

fieldPath

string

指定された API バージョンで選択するフィールドのパス。

8.1.504. .spec.volumes[].projected.sources[].downwardAPI.items[].resourceFieldRef

説明
コンテナーのリソースを選択します。現在、リソースの制限とリクエスト (limits.cpu、limits.memory、requests.cpu、requests.memory) のみがサポートされています。
object
必須
  • resource
プロパティー説明

containerName

string

コンテナー名: ボリュームには必須、env 変数にはオプション

divisor

integer-or-string

公開されたリソースの出力形式を指定します。デフォルトは "1" です。

resource

string

必須: 選択するリソース

8.1.505. .spec.volumes[].projected.sources[].secret

説明
投影するシークレットデータに関する情報
object
プロパティー説明

items

array

items が指定されていない場合、参照されるシークレットの Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。シークレットに存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。

items[]

object

文字列キーをボリューム内のパスにマップします。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

オプションフィールドは、シークレットかそのキーを定義する必要があるかどうかを指定します。

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

string

key はプロジェクトのキーです。

mode

integer

mode は任意: このファイルにアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。

path

string

path はキーをマップするファイルの相対パスです。絶対的なパスではない可能性があります。パス要素 '..' を含めることはできません。文字列 '..' で始まらない場合があります。

8.1.508. .spec.volumes[].projected.sources[].serviceAccountToken

説明
serviceAccountToken は、投影する serviceAccountToken データに関する情報です。
object
必須
  • path
プロパティー説明

audience

string

audience は、トークンの対象オーディエンスです。トークンの受信者は、トークンのオーディエンスで指定された識別子で自分自身を識別する必要があります。そうでない場合は、トークンを拒否する必要があります。対象はデフォルトで API サーバーの識別子に設定されます。

expirationSeconds

integer

expirationSeconds は、サービスアカウントトークンの要求された有効期間です。トークンの有効期限が近づくと、kubelet ボリュームプラグインはサービスアカウントトークンをプロアクティブにローテーションします。トークンが存続時間の 80% より古い場合、またはトークンが 24 時間より古い場合、kubelet はトークンのローテーションを開始します。デフォルトは 1 時間で、少なくとも 10 分である必要があります。

path

string

path は、トークンのデプロイメント先となるファイルのマウントポイントに対する相対パスです。

8.1.509. .spec.volumes[].quobyte

説明
quobyte は、Pod の有効期限を共有するホストでの Quobyte マウントを表します
object
必須
  • registry
  • volume
プロパティー説明

group

string

アクセスできるボリュームをマップするグループ。デフォルトは no group です。

readOnly

boolean

ここでの readOnly は、Quobyte ボリュームを読み取り専用のアクセス権限で強制的にマウントします。デフォルトは false です。

registry

string

registry は、host:port ペアの文字列として指定された単一または複数の Quobyte Registry サービスを表し (複数のエントリーはコンマで区切る)、ボリュームの中央レジストリーとして機能します。

tenant

string

動的にプロビジョニングされた Quobyte ボリュームで使用されるバックエンドで指定の Quobyte ボリュームを所有するテナント。値はプラグインにより設定されます。

user

string

アクセスできるボリュームをマップするグループ。デフォルトは serivceaccount user です。

volume

string

volume は、すでに作成されているクオバイトボリュームを名前で参照する文字列です。

8.1.510. .spec.volumes[].rbd

説明
rbd は、Pod の有効期間を共有するホストの Rados ブロックデバイスマウントを表します。詳細: https://examples.k8s.io/volumes/rbd/README.md
object
必須
  • image
  • monitors
プロパティー説明

fsType

string

fsType は、マウントするボリュームのファイルシステムタイプです。ヒント: ファイルシステムタイプがホストオペレーティングシステムでサポートされていることを確認してください。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes#rbd

image

string

image は rados イメージ名です。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

keyring

string

keyring は、RBDUser のキーリングへのパスです。デフォルトは/etc/ceph/keyring です。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

monitors

array (string)

monitors は Ceph モニターのコレクションです。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

pool

string

pool は rados プール名です。デフォルトは rbd です。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

readOnly

boolean

この readOnly は、VolumeMounts で ReadOnly 設定が強制的に指定されます。デフォルトは false です。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

secretRef

object

secretRef は、RBDUser の認証シークレットの名前です。提供されている場合、キーリングをオーバーライドします。デフォルトは nil です。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

user

string

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

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: 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

string

fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。デフォルトは "xfs" です。

gateway

string

gateway は、ScaleIO API ゲートウェイのホストアドレスです。

protectionDomain

string

protectionDomain は、設定されたストレージの ScaleIO 保護ドメインの名前です。

readOnly

boolean

readOnly。デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。

secretRef

object

secretRef は、ScaleIO ユーザーおよびその他の機密情報の秘密を参照します。これが指定されていない場合、ログイン操作は失敗します。

sslEnabled

boolean

sslEnabled Flag は、ゲートウェイとの SSL 通信を有効/無効にします。デフォルトは false です

storageMode

string

storageMode は、ボリュームのストレージを ThickProvisioned にするか ThinProvisioned にするかを示します。デフォルトは ThinProvisioned です。

storagePool

string

storagePool は、保護ドメインに関連付けられた ScaleIO ストレージプールです。

system

string

system は、ScaleIO で設定されたストレージシステムの名前です。

volumeName

string

volumeName は、このボリュームソースに関連付けられている、ScaleIO システムですでに作成されているボリュームの名前です。

8.1.513. .spec.volumes[].scaleIO.secretRef

説明
secretRef は、ScaleIO ユーザーおよびその他の機密情報の秘密を参照します。これが指定されていない場合、ログイン操作は失敗します。
object
プロパティー説明

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: 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

integer

defaultMode は任意: デフォルトで、作成されたファイルのアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。デフォルトは 0644 に設定されます。パス内のディレクトリーはこの設定の影響を受けません。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。

items

array

items が指定されていない場合、参照されるシークレットの Data フィールドのそれぞれのキーと値のペアはボリュームにデプロイメントされ、名前がキーであり、内容が値になります。指定されている場合、リスト表示されるキーは指定されたパスにデプロイメントされ、リストされていないキーはありません。シークレットに存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。

items[]

object

文字列キーをボリューム内のパスにマップします。

optional

boolean

optional フィールド。シークレットかそのキーを定義する必要があるかどうかを指定します。

secretName

string

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

string

key はプロジェクトのキーです。

mode

integer

mode は任意: このファイルにアクセス許可を設定するために使用されるモードビットです。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。

path

string

path はキーをマップするファイルの相対パスです。絶対的なパスではない可能性があります。パス要素 '..' を含めることはできません。文字列 '..' で始まらない場合があります。

8.1.517. .spec.volumes[].storageos

説明
storageOS は、Kubernetes ノードに接続およびマウントされた StorageOS ボリュームを表します。
object
プロパティー説明

fsType

string

fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。

readOnly

boolean

readOnly のデフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。

secretRef

object

secretRef は、StorageOS API クレデンシャルを取得するために使用するシークレットを指定します。指定しない場合、デフォルト値が試行されます。

volumeName

string

volumeName は、人間が判読えきる形式の StorageOS ボリュームの名前です。ボリューム名は namespace 内でのみ一意です。

volumeNamespace

string

volumeNamespace は、StorageOS 内のボリュームのスコープを指定します。namespace が指定されていない場合は、Pod の namespace が使用されます。これにより、Kubernetes の名前スコープを StorageOS 内にミラーリングして、より緊密に統合することができます。VolumeName を任意の名前に設定して、デフォルトの動作をオーバーライドします。StorageOS 内で namespace を使用していない場合は、"デフォルト" に設定します。StorageOS 内に存在しない namespace が作成されます。

8.1.518. .spec.volumes[].storageos.secretRef

説明
secretRef は、StorageOS API クレデンシャルを取得するために使用するシークレットを指定します。指定しない場合、デフォルト値が試行されます。
object
プロパティー説明

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

8.1.519. .spec.volumes[].vsphereVolume

説明
vsphereVolume は、kubelet ホストマシンに接続およびマウントされた vSphere ボリュームを表します。
object
必須
  • volumePath
プロパティー説明

fsType

string

fsType は、マウントするファイルシステムタイプです。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例: "ext4"、"xfs"、"ntfs"。指定されていない場合、暗黙的に "ext4" であると推測されます。

storagePolicyID

string

storagePolicyID は、StoragePolicyName に関連付けられたストレージポリシーベースの管理 (SPBM) プロファイル ID です。

storagePolicyName

string

storagePolicyName は、ストレージポリシーベースの管理 (SPBM) プロファイル名です。

volumePath

string

volumePath は、vSphere ボリューム vmdk を識別するパスです。

8.1.520. .spec.web

説明
Prometheus Web サーバーの設定を定義します。
object
プロパティー説明

httpConfig

object

Web サーバーの HTTP パラメーターを定義します。

maxConnections

integer

同時接続の最大数を定義します。値がゼロの場合、Prometheus は着信接続を一切受け入れません。

pageTitle

string

Prometheus の Web ページのタイトル。

tlsConfig

object

HTTPS の TLS パラメーターを定義します。

8.1.521. .spec.web.httpConfig

説明
Web サーバーの HTTP パラメーターを定義します。
object
プロパティー説明

headers

object

HTTP 応答に追加できるヘッダーのリスト。

http2

boolean

HTTP/2 サポートを有効にします。HTTP/2 は TLS でのみサポートされることに注意してください。TLSConfig が設定されていない場合、HTTP/2 は無効になります。フィールドの値が変わるたびに、ローリング更新がトリガーされます。

8.1.522. .spec.web.httpConfig.headers

説明
HTTP 応答に追加できるヘッダーのリスト。
object
プロパティー説明

contentSecurityPolicy

string

HTTP 応答に Content-Security-Policy ヘッダーを設定します。空白の場合は設定しません。

strictTransportSecurity

string

HTTP 応答に Strict-Transport-Security ヘッダーを設定します。空白の場合は設定しません。このヘッダーは、ブラウザーは同じドメインとサブドメインでホストされている Prometheus やその他のアプリケーションを HTTPS 経由で読み込むよう強制する可能性があるため、注意して使用してください。https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Strict-Transport-Security

xContentTypeOptions

string

X-Content-Type-Options ヘッダーを HTTP 応答に設定します。空白の場合は設定しません。許可される値は nosniff です。https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Content-Type-Options

xFrameOptions

string

X-Frame-Options ヘッダーを HTTP 応答に設定します。空白の場合は設定しません。許可される値は、deny と sameorigin です。https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Frame-Options

xXSSProtection

string

すべての応答に 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
プロパティー説明

cert

object

サーバーの TLS 証明書が含まれています。

certFile

string

サーバーの Prometheus コンテナー内にある TLS 証明書ファイルへのパス。cert と相互に排他的です。

cipherSuites

array (string)

TLS1.2 までの TLS バージョンでサポートされている暗号スイートのリスト。空の場合、Go のデフォルトの暗号スイートが使用されます。利用可能な暗号スイートは、go のドキュメントに記載されています: https://golang.org/pkg/crypto/tls/#pkg-constants

clientAuthType

string

クライアント認証のサーバーポリシー。ClientAuth ポリシーにマップします。clientAuth オプションの詳細については、https://golang.org/pkg/crypto/tls/#ClientAuthType をご覧ください。

clientCAFile

string

サーバーに対するクライアント証明書認証用の CA 証明書ファイルへのパス。client_ca と相互に排他的です。

client_ca

object

サーバーへのクライアント証明書認証用の CA 証明書が含まれています。

curvePreferences

array (string)

ECDHE ハンドシェイクで使用される楕円曲線を優先順に使用します。利用可能な曲線は、go のドキュメントに記載されています: https://golang.org/pkg/crypto/tls/#CurveID

keyFile

string

サーバーの Prometheus コンテナー内にある TLS 鍵ファイルへのパス。keySecret と相互に排他的です。

keySecret

object

サーバーの TLS キーを含むシークレット。

maxVersion

string

許容可能な最大 TLS バージョン。デフォルトは TLS13 です。

minVersion

string

許容可能な最小 TLS バージョン。デフォルトは TLS12 です。

preferServerCipherSuites

boolean

サーバーがクライアントの最も優先される暗号スイートを選択するか、サーバーの最も優先される暗号スイートを選択するかを制御します。true の場合、cipherSuites の要素の順序で表されるサーバーの設定が使用されます。

8.1.524. .spec.web.tlsConfig.cert

説明
サーバーの TLS 証明書が含まれています。
object
プロパティー説明

configMap

object

ターゲットに使用するデータを含む ConfigMap。

secret

object

ターゲットに使用するデータを含むシークレット。

8.1.525. .spec.web.tlsConfig.cert.configMap

説明
ターゲットに使用するデータを含む ConfigMap。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

8.1.526. .spec.web.tlsConfig.cert.secret

説明
ターゲットに使用するデータを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.527. .spec.web.tlsConfig.client_ca

説明
サーバーへのクライアント証明書認証用の CA 証明書が含まれています。
object
プロパティー説明

configMap

object

ターゲットに使用するデータを含む ConfigMap。

secret

object

ターゲットに使用するデータを含むシークレット。

8.1.528. .spec.web.tlsConfig.client_ca.configMap

説明
ターゲットに使用するデータを含む ConfigMap。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

8.1.529. .spec.web.tlsConfig.client_ca.secret

説明
ターゲットに使用するデータを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

8.1.530. .spec.web.tlsConfig.keySecret

説明
サーバーの TLS キーを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

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

availableReplicas

integer

この Prometheus デプロイメントの対象となる利用可能な Pod の総数 (少なくとも minReadySeconds の準備ができています)。

conditions

array

Prometheus デプロイメントの現在の状態。

conditions[]

object

Condition は、Prometheus、Alertmanager、または ThanosRuler リソースに関連付けられているリソースの状態を表します。

paused

boolean

基になるマネージドオブジェクトに対してアクションが実行されているかどうかを表します。削除アクションのみが実行されます。

replicas

integer

この Prometheus デプロイメントの対象となる非終了 Pod の総数 (ラベルはセレクターと一致します)。

selector

string

この Prometheus リソースのターゲットとなる Pod を一致させるために使用されるセレクター。

shardStatuses

array

リストにはシャードごとに 1 つのエントリーがあります。各エントリーには、シャードのステータスの概要が示されます。

shardStatuses[]

object

 

shards

integer

shards は、観測された最も新しいシャード数です。

unavailableReplicas

integer

この Prometheus デプロイメントの対象となる使用できない Pod の総数。

updatedReplicas

integer

この Prometheus デプロイメントの対象であり、目的のバージョン仕様を持つ、終了していない Pod の総数。

8.1.532. .status.conditions

説明
Prometheus デプロイメントの現在の状態。
array

8.1.533. .status.conditions[]

説明
Condition は、Prometheus、Alertmanager、または ThanosRuler リソースに関連付けられているリソースの状態を表します。
object
必須
  • lastTransitionTime
  • status
  • type
プロパティー説明

lastTransitionTime

string

lastTransitionTime は、現在のステータスプロパティーが最後に更新された時刻です。

message

string

条件の最後の遷移の詳細を示す、人間が判読できるメッセージ。

observedGeneration

integer

observedGeneration は、それをベースに条件が設定された .metadata.generation を表します。たとえば、.metadata.generation が現在 12 で、.status.conditions[].observedGeneration が 9 の場合、インスタンスの現在の状態に対して条件が古くなっています。

reason

string

条件の最後の遷移の理由。

status

string

条件のステータス。

type

string

報告される条件のタイプ。

8.1.534. .status.shardStatuses

説明
リストにはシャードごとに 1 つのエントリーがあります。各エントリーには、シャードのステータスの概要が示されます。
array

8.1.535. .status.shardStatuses[]

説明
object
必須
  • availableReplicas
  • replicas
  • shardID
  • unavailableReplicas
  • updatedReplicas
プロパティー説明

availableReplicas

integer

このシャードのターゲットとなる利用可能な (準備完了となってから少なくとも minReadySeconds が経過している) Pod の総数。

replicas

integer

このシャードがターゲットとする Pod の総数。

shardID

string

シャードの識別子。

unavailableReplicas

integer

このシャードがターゲットとする、使用できない Pod の総数。

updatedReplicas

integer

このシャードがターゲットとする、期待される仕様を持つ終了していない Pod の総数。

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.