diff --git a/content/zh/docs/reference/config-api/kube-proxy-config.v1alpha1.md b/content/zh/docs/reference/config-api/kube-proxy-config.v1alpha1.md index 1c89395b51..d0c388f054 100644 --- a/content/zh/docs/reference/config-api/kube-proxy-config.v1alpha1.md +++ b/content/zh/docs/reference/config-api/kube-proxy-config.v1alpha1.md @@ -41,7 +41,8 @@ KubeProxyConfiguration 包含用来配置 Kubernetes 代理服务器的所有配 - featureGates 是一个功能特性名称到布尔值的映射表,用来启用或者禁用测试性质的功能特性。 +

featureGates 字段是一个功能特性名称到布尔值的映射表, + 用来启用或者禁用测试性质的功能特性。

bindAddress [必需]
@@ -52,8 +53,8 @@ KubeProxyConfiguration 包含用来配置 Kubernetes 代理服务器的所有配 bindAddress is the IP address for the proxy server to serve on (set to 0.0.0.0 for all interfaces) --> - bindAddress 是代理服务器提供服务时所用 IP 地址(设置为 0.0.0.0 -时意味着在所有网络接口上提供服务)。 +

bindAddress 字段是代理服务器提供服务时所用 IP 地址(设置为 0.0.0.0 +时意味着在所有网络接口上提供服务)。

healthzBindAddress [必需]
@@ -64,8 +65,8 @@ for all interfaces) healthzBindAddress is the IP address and port for the health check server to serve on, defaulting to 0.0.0.0:10256 --> - healthzBindAddress 是健康状态检查服务器提供服务时所使用的的 IP 地址和端口, - 默认设置为 '0.0.0.0:10256'。 +

healthzBindAddress 字段是健康状态检查服务器提供服务时所使用的的 IP 地址和端口, + 默认设置为 '0.0.0.0:10256'。

metricsBindAddress [必需]
@@ -76,8 +77,8 @@ defaulting to 0.0.0.0:10256 metricsBindAddress is the IP address and port for the metrics server to serve on, defaulting to 127.0.0.1:10249 (set to 0.0.0.0 for all interfaces) --> - metricsBindAddress 是度量值服务器提供服务时所使用的的 IP 地址和端口, - 默认设置为 '127.0.0.1:10249'(设置为 0.0.0.0 意味着在所有接口上提供服务)。 +

metricsBindAddress 字段是度量值服务器提供服务时所使用的的 IP 地址和端口, + 默认设置为 '127.0.0.1:10249'(设置为 0.0.0.0 意味着在所有接口上提供服务)。

bindAddressHardFail [必需]
@@ -87,7 +88,8 @@ defaulting to 127.0.0.1:10249 (set to 0.0.0.0 for all interfaces) - bindAddressHardFail 设置为 true 时,kube-proxy 将无法绑定到某端口这类问题视为致命错误并直接退出。 +

bindAddressHardFail 字段设置为 true 时, + kube-proxy 将无法绑定到某端口这类问题视为致命错误并直接退出。

enableProfiling [必需]
@@ -98,8 +100,8 @@ defaulting to 127.0.0.1:10249 (set to 0.0.0.0 for all interfaces) enableProfiling enables profiling via web interface on /debug/pprof handler. Profiling handlers will be handled by metrics server. --> - enableProfiling 通过 '/debug/pprof' 处理程序在 Web 界面上启用性能分析。 - 性能分析处理程序将由度量值服务器执行。 +

enableProfiling 字段通过 '/debug/pprof' 处理程序在 Web 界面上启用性能分析。 + 性能分析处理程序将由度量值服务器执行。

clusterCIDR [必需]
@@ -111,8 +113,9 @@ Profiling handlers will be handled by metrics server. bridge traffic coming from outside of the cluster. If not provided, no off-cluster bridging will be performed. --> - clusterCIDR 是集群中 Pods 所使用的 CIDR 范围。这一地址范围用于对来自集群外的请求 - 流量进行桥接。如果未设置,则 kube-proxy 不会对非集群内部的流量做桥接。 +

clusterCIDR 字段是集群中 Pods 所使用的 CIDR 范围。 + 这一地址范围用于对来自集群外的请求流量进行桥接。 + 如果未设置,则 kube-proxy 不会对非集群内部的流量做桥接。

hostnameOverride [必需]
@@ -122,7 +125,8 @@ no off-cluster bridging will be performed. - hostnameOverride 非空时,所给的字符串(而不是实际的主机名)将被用作 kube-proxy 的标识。 +

hostnameOverride 字段非空时, + 所给的字符串(而不是实际的主机名)将被用作 kube-proxy 的标识。

clientConnection [必需]
@@ -133,7 +137,8 @@ no off-cluster bridging will be performed. clientConnection specifies the kubeconfig file and client connection settings for the proxy server to use when communicating with the apiserver. --> - clientConnection 给出代理服务器与 API 服务器通信时要使用的 kubeconfig 文件和客户端链接设置。 +

clientConnection 字段给出代理服务器与 API + 服务器通信时要使用的 kubeconfig 文件和客户端链接设置。

iptables [必需]
@@ -143,7 +148,7 @@ server to use when communicating with the apiserver. - iptables 字段包含与 iptables 相关的配置选项。 +

iptables 字段字段包含与 iptables 相关的配置选项。

ipvs [必需]
@@ -153,7 +158,7 @@ server to use when communicating with the apiserver. - ipvs 中包含与 ipvs 相关的配置选项。 +

ipvs 字段中包含与 ipvs 相关的配置选项。

oomScoreAdj [必需]
@@ -164,8 +169,8 @@ server to use when communicating with the apiserver. oomScoreAdj is the oom-score-adj value for kube-proxy process. Values must be within the range [-1000, 1000] --> - oomScoreAdj 是为 kube-proxy 进程所设置的 oom-score-adj 值。 - 此设置值必须介于 [-1000, 1000] 范围内。 +

oomScoreAdj 字段是为 kube-proxy 进程所设置的 oom-score-adj 值。 + 此设置值必须介于 [-1000, 1000] 范围内。

mode [必需]
@@ -175,7 +180,7 @@ the range [-1000, 1000] - mode 用来设置将使用的代理模式。 +

mode 字段用来设置将使用的代理模式。

portRange [必需]
@@ -186,20 +191,20 @@ the range [-1000, 1000] portRange is the range of host ports (beginPort-endPort, inclusive) that may be consumed in order to proxy service traffic. If unspecified (0-0) then ports will be randomly chosen. --> - portRange 是主机端口的范围,形式为 ‘beginPort-endPort’(包含边界), - 用来设置代理服务所使用的端口。如果未指定(即‘0-0’),则代理服务会随机选择端口号。 +

portRange 字段是主机端口的范围,形式为 ‘beginPort-endPort’(包含边界), + 用来设置代理服务所使用的端口。如果未指定(即‘0-0’),则代理服务会随机选择端口号。

udpIdleTimeout [必需]
-meta/v1.Duration +meta/v1.Duration - udpIdleTimeout 用来设置 UDP 链接保持活跃的时长(例如,'250ms'、'2s')。 - 此值必须大于 0。此字段仅适用于 mode 值为 'userspace' 的场合。 +

udpIdleTimeout 字段用来设置 UDP 链接保持活跃的时长(例如,'250ms'、'2s')。 + 此值必须大于 0。此字段仅适用于 mode 值为 'userspace' 的场合。

conntrack [必需]
@@ -209,18 +214,18 @@ Must be greater than 0. Only applicable for proxyMode=userspace. - conntrack 包含与 conntrack 相关的配置选项。 +

conntrack 字段包含与 conntrack 相关的配置选项。

configSyncPeriod [必需]
-meta/v1.Duration +meta/v1.Duration - configSyncPeriod 是从 API 服务器刷新配置的频率。此值必须大于 0。 +

configSyncPeriod 字段是从 API 服务器刷新配置的频率。此值必须大于 0。

nodePortAddresses [必需]
@@ -236,13 +241,15 @@ If set it to "127.0.0.0/8", kube-proxy will only select the loopback interface f If set it to a non-zero IP block, kube-proxy will filter that down to just the IPs that applied to the node. An empty string slice is meant to select all network interfaces. --> - nodePortAddresses 是 kube-proxy 进程的 --nodeport-addresses 命令行参数设置。 +

nodePortAddresses 字段是 kube-proxy 进程的 + --nodeport-addresses 命令行参数设置。 此值必须是合法的 IP 段。所给的 IP 段会作为参数来选择 NodePort 类型服务所使用的接口。 如果有人希望将本地主机(Localhost)上的服务暴露给本地访问,同时暴露在某些其他网络接口上 以实现某种目标,可以使用 IP 段的列表。 - 如果此值被设置为 "127.0.0.0/8",则 kube-proxy 将仅为 NodePort 服务选择本地回路(loopback)接口。 + 如果此值被设置为 "127.0.0.0/8",则 kube-proxy 将仅为 NodePort + 服务选择本地回路(loopback)接口。 如果此值被设置为非零的 IP 段,则 kube-proxy 会对 IP 作过滤,仅使用适用于当前节点的 IP 地址。 - 空的字符串列表意味着选择所有网络接口。 + 空的字符串列表意味着选择所有网络接口。

winkernel [必需]
@@ -252,7 +259,7 @@ An empty string slice is meant to select all network interfaces. - winkernel 包含与 winkernel 相关的配置选项。 +

winkernel 字段包含与 winkernel 相关的配置选项。

showHiddenMetricsForVersion [必需]
@@ -262,8 +269,8 @@ An empty string slice is meant to select all network interfaces. - showHiddenMetricsForVersion 给出的是一个 Kubernetes 版本号字符串,用来设置你希望 - 显示隐藏度量值的版本。 +

showHiddenMetricsForVersion 字段给出的是一个 Kubernetes 版本号字符串, + 用来设置你希望显示隐藏度量值的版本。

detectLocalMode [必需]
@@ -273,7 +280,66 @@ An empty string slice is meant to select all network interfaces. - detectLocalMode 用来确定检测本地流量的方式,默认为 LocalModeClusterCIDR。 +

detectLocalMode 字段用来确定检测本地流量的方式,默认为 LocalModeClusterCIDR。

+ + +detectLocal [必需]
+DetectLocalConfiguration + + + +

detectLocal 字段包含与 DetectLocalMode 相关的可选配置设置。

+ + + + + +## `DetectLocalConfiguration` {#kubeproxy-config-k8s-io-v1alpha1-DetectLocalConfiguration} + + +**出现在:** + +- [KubeProxyConfiguration](#kubeproxy-config-k8s-io-v1alpha1-KubeProxyConfiguration) + + +DetectLocalConfiguration 包含与 DetectLocalMode 选项相关的可选设置。 + + + + + + + + + + @@ -306,8 +372,8 @@ KubeProxyConntrackConfiguration 包含为 Kubernetes 代理服务器提供的 co maxPerCore is the maximum number of NAT connections to track per CPU core (0 to leave the limit as-is and ignore min). --> - maxPerCore 是每个 CPU 核所跟踪的 NAT 链接个数上限 - (0 意味着保留当前上限限制并忽略 min 字段设置值)。 +

maxPerCore 字段是每个 CPU 核所跟踪的 NAT 链接个数上限 + (0 意味着保留当前上限限制并忽略 min 字段设置值)。

@@ -378,8 +444,8 @@ KubeProxyIPTablesConfiguration 包含用于 Kubernetes 代理服务器的、与 masqueradeBit is the bit of the iptables fwmark space to use for SNAT if using the pure iptables proxy mode. Values must be within the range [0, 31]. --> - masqueradeBit 是 iptables fwmark 空间中的具体一位,用来在纯 iptables 代理模式下 - 设置 SNAT。此值必须介于 [0, 31](含边界值)。 +

masqueradeBit 字段是 iptables fwmark 空间中的具体一位, + 用来在纯 iptables 代理模式下设置 SNAT。此值必须介于 [0, 31](含边界值)。

@@ -438,25 +505,25 @@ KubeProxyIPVSConfiguration 包含用于 Kubernetes 代理服务器的、与 ipvs @@ -558,7 +625,7 @@ KubeProxyWinkernelConfiguration 包含 Kubernetes 代理服务器的 Windows/HNS networkName is the name of the network kube-proxy will use to create endpoints and policies --> - networkName 是 kube-proxy 用来创建端点和策略的网络名称。 +

networkName 字段是 kube-proxy 用来创建端点和策略的网络名称。

+ + + + + + @@ -665,6 +756,12 @@ this always falls back to the userspace proxy. - [KubeProxyConfiguration](#kubeproxy-config-k8s-io-v1alpha1-KubeProxyConfiguration) +- [KubeSchedulerConfiguration](#kubescheduler-config-k8s-io-v1beta2-KubeSchedulerConfiguration) + +- [KubeSchedulerConfiguration](#kubescheduler-config-k8s-io-v1beta3-KubeSchedulerConfiguration) + +- [GenericControllerManagerConfiguration](#controllermanager-config-k8s-io-v1alpha1-GenericControllerManagerConfiguration) + @@ -681,7 +778,7 @@ ClientConnectionConfiguration 包含构造客户端所需要的细节信息。 - kubeconfig 是指向一个 KubeConfig 文件的路径。 +

kubeconfig 字段是指向一个 KubeConfig 文件的路径。

+ + +
字段描述
bridgeInterface [必需]
+string +
+ +

bridgeInterface 字段是一个表示单个桥接接口名称的字符串参数。 + Kube-proxy 将来自这个给定桥接接口的流量视为本地流量。 + 如果 DetectLocalMode 设置为 LocalModeBridgeInterface,则应设置该参数。

+
interfaceNamePrefix [必需]
+string +
+ +

interfaceNamePrefix 字段是一个表示单个接口前缀名称的字符串参数。 + Kube-proxy 将来自一个或多个与给定前缀匹配的接口流量视为本地流量。 + 如果 DetectLocalMode 设置为 LocalModeInterfaceNamePrefix,则应设置该参数。

min [必需]
@@ -318,24 +384,24 @@ per CPU core (0 to leave the limit as-is and ignore min). min is the minimum value of connect-tracking records to allocate, regardless of conntrackMaxPerCore (set maxPerCore=0 to leave the limit as-is). --> - min 给出要分配的链接跟踪记录个数下限。 - 设置此值时会忽略 maxPerCore 的值(将 maxPerCore 设置为 0 时不会调整上限值)。 +

min 字段给出要分配的链接跟踪记录个数下限。 + 设置此值时会忽略 maxPerCore 的值(将 maxPerCore 设置为 0 时不会调整上限值)。

tcpEstablishedTimeout [必需]
-meta/v1.Duration +meta/v1.Duration
- tcpEstablishedTimeout 给出空闲 TCP 连接的保留时间(例如,'2s')。 - 此值必须大于 0。 +

tcpEstablishedTimeout 字段给出空闲 TCP 连接的保留时间(例如,'2s')。 + 此值必须大于 0。

tcpCloseWaitTimeout [必需]
-meta/v1.Duration +meta/v1.Duration
- tcpCloseWaitTimeout 用来设置空闲的、处于 CLOSE_WAIT 状态的 conntrack 条目 +

tcpCloseWaitTimeout 字段用来设置空闲的、处于 CLOSE_WAIT 状态的 conntrack 条目 保留在 conntrack 表中的时间长度(例如,'60s')。 - 此设置值必须大于 0。 + 此设置值必须大于 0。

masqueradeAll [必需]
@@ -389,30 +455,31 @@ the pure iptables proxy mode. Values must be within the range [0, 31]. - masqueradeAll 用来通知 kube-proxy 在使用纯 iptables 代理模式时对所有流量执行 - SNAT 操作。 +

masqueradeAll 字段用来通知 kube-proxy + 在使用纯 iptables 代理模式时对所有流量执行 SNAT 操作。

syncPeriod [必需]
-meta/v1.Duration +meta/v1.Duration
- syncPeriod 给出 iptables 规则的刷新周期(例如,'5s'、'1m'、'2h22m')。 - 此值必须大于 0。 +

syncPeriod 字段给出 iptables + 规则的刷新周期(例如,'5s'、'1m'、'2h22m')。此值必须大于 0。

minSyncPeriod [必需]
-meta/v1.Duration +meta/v1.Duration
- minSyncPeriod 给出 iptables 规则被刷新的最小周期(例如,'5s'、'1m'、'2h22m')。 +

minSyncPeriod 字段给出 iptables + 规则被刷新的最小周期(例如,'5s'、'1m'、'2h22m')。

syncPeriod [必需]
-meta/v1.Duration +meta/v1.Duration
- syncPeriod 给出 ipvs 规则的刷新周期(例如,'5s'、'1m'、'2h22m')。 - 此值必须大于 0。 +

syncPeriod 字段给出 ipvs 规则的刷新周期(例如,'5s'、'1m'、'2h22m')。 + 此值必须大于 0。

minSyncPeriod [必需]
-meta/v1.Duration +meta/v1.Duration
- minSyncPeriod 给出 ipvs 规则被刷新的最小周期(例如,'5s'、'1m'、'2h22m')。 +

minSyncPeriod 字段给出 ipvs 规则被刷新的最小周期(例如,'5s'、'1m'、'2h22m')。

scheduler [必需]
@@ -466,7 +533,7 @@ KubeProxyIPVSConfiguration 包含用于 Kubernetes 代理服务器的、与 ipvs - IPVS 调度器。 +

IPVS 调度器。

excludeCIDRs [必需]
@@ -477,7 +544,7 @@ KubeProxyIPVSConfiguration 包含用于 Kubernetes 代理服务器的、与 ipvs excludeCIDRs is a list of CIDR's which the ipvs proxier should not touch when cleaning up ipvs services. --> - excludeCIDRs 取值为一个 CIDR 列表,ipvs 代理程序在清理 IPVS 服务时不应触碰这些 IP 地址。 +

excludeCIDRs 字段取值为一个 CIDR 列表,ipvs 代理程序在清理 IPVS 服务时不应触碰这些 IP 地址。

strictARP [必需]
@@ -488,44 +555,44 @@ when cleaning up ipvs services. strict ARP configure arp_ignore and arp_announce to avoid answering ARP queries from kube-ipvs0 interface --> - strictARP 用来配置 arp_ignore 和 arp_announce,以避免(错误地)响应来自 kube-ipvs0 接口的 - ARP 查询请求。 +

strictARP 字段用来配置 arp_ignore 和 arp_announce,以避免(错误地)响应来自 kube-ipvs0 接口的 + ARP 查询请求。

tcpTimeout [必需]
-meta/v1.Duration +meta/v1.Duration
- tcpTimeout 是用于设置空闲 IPVS TCP 会话的超时值。 - 默认值为 0,意味着使用系统上当前的超时值设置。 +

tcpTimeout 字段是用于设置空闲 IPVS TCP 会话的超时值。 + 默认值为 0,意味着使用系统上当前的超时值设置。

tcpFinTimeout [必需]
-meta/v1.Duration +meta/v1.Duration
- tcpFinTimeout 用来设置 IPVS TCP 会话在收到 FIN 之后的超时值。 - 默认值为 0,意味着使用系统上当前的超时值设置。 +

tcpFinTimeout 字段用来设置 IPVS TCP 会话在收到 FIN 之后的超时值。 + 默认值为 0,意味着使用系统上当前的超时值设置。

udpTimeout [必需]
-meta/v1.Duration +meta/v1.Duration
- udpTimeout 用来设置 IPVS UDP 包的超时值。 - 默认值为 0,意味着使用系统上当前的超时值设置。 +

udpTimeout 字段用来设置 IPVS UDP 包的超时值。 + 默认值为 0,意味着使用系统上当前的超时值设置。

sourceVip [必需]
@@ -569,7 +636,7 @@ to create endpoints and policies sourceVip is the IP address of the source VIP endoint used for NAT when loadbalancing --> - sourceVip 是执行负载均衡时进行 NAT 转换所使用的源端 VIP 端点 IP 地址。 +

sourceVip 字段是执行负载均衡时进行 NAT 转换所使用的源端 VIP 端点 IP 地址。

enableDSR [必需]
@@ -580,7 +647,31 @@ NAT when loadbalancing enableDSR tells kube-proxy whether HNS policies should be created with DSR --> - enableDSR 通知 kube-proxy 是否使用 DSR 来创建 HNS 策略。 +

enableDSR 字段通知 kube-proxy 是否使用 DSR 来创建 HNS 策略。

+
rootHnsEndpointName [必需]
+string +
+ +

rootHnsEndpointName + 字段是附加到用于根网络命名空间二层桥接的 hnsendpoint 的名称。

+
forwardHealthCheckVip [必需]
+bool +
+ +

forwardHealthCheckVip + 字段为 Windows 上的健康检查端口转发服务 VIP。

acceptContentTypes [必需]
@@ -692,9 +789,9 @@ ClientConnectionConfiguration 包含构造客户端所需要的细节信息。 acceptContentTypes defines the Accept header sent by clients when connecting to a server, overriding the default value of 'application/json'. This field will control all connections to the server used by a particular client. --> - acceptContentTypes 定义客户端在连接到服务器时所发送的 Accept 头部字段。 +

acceptContentTypes 字段定义客户端在连接到服务器时所发送的 Accept 头部字段。 此设置值会覆盖默认配置 'application/json'。 - 此字段会控制某特定客户端与指定服务器的所有链接。 + 此字段会控制某特定客户端与指定服务器的所有链接。

contentType [必需]
@@ -704,7 +801,7 @@ default value of 'application/json'. This field will control all connections to - contentType 是从此客户端向服务器发送数据时使用的内容类型(Content Type)。 +

contentType 字段是从此客户端向服务器发送数据时使用的内容类型(Content Type)。

qps [必需]
@@ -714,7 +811,7 @@ default value of 'application/json'. This field will control all connections to - qps 控制此连接上每秒钟可以发送的查询请求个数。 +

qps 字段控制此连接上每秒钟可以发送的查询请求个数。

burst [必需]
@@ -724,7 +821,55 @@ default value of 'application/json'. This field will control all connections to - 允许客户端超出其速率限制时可以临时累积的额外查询个数。 +

burst 字段允许客户端超出其速率限制时可以临时累积的额外查询个数。

+
+ +## `DebuggingConfiguration` {#DebuggingConfiguration} + + +**出现在:** + +- [KubeSchedulerConfiguration](#kubescheduler-config-k8s-io-v1beta2-KubeSchedulerConfiguration) + +- [KubeSchedulerConfiguration](#kubescheduler-config-k8s-io-v1beta3-KubeSchedulerConfiguration) + +- [GenericControllerManagerConfiguration](#controllermanager-config-k8s-io-v1alpha1-GenericControllerManagerConfiguration) + + +DebuggingConfiguration 包含调试相关功能的配置。 + + + + + + + + + + @@ -754,7 +899,7 @@ FormatOptions 包含不同日志记录格式的配置选项。 - [实验特性] json 字段包含 “JSON” 日志格式的配置选项。 +

[实验特性] json 字段包含 "JSON" 日志格式的配置选项。

@@ -772,7 +917,7 @@ FormatOptions 包含不同日志记录格式的配置选项。 -JSONOptions 包含“json”日志格式的配置选项。 +JSONOptions 包含 "json" 日志格式的配置选项。
字段描述
enableProfiling [Required]
+bool +
+ +

enableProfiling 字段通过位于 host:port/debug/pprof/ + 的 Web 接口启用性能分析。

+
enableContentionProfiling [Required]
+bool +
+ +

enableContentionProfiling 字段在 enableProfiling + 为 true 时允许执行锁竞争分析。

@@ -788,8 +933,8 @@ JSONOptions 包含“json”日志格式的配置选项。 info messages go to stdout, with buffering. The default is to write both to stdout, without buffering. --> - [实验特性] splitStream 将信息类型的信息输出到标准输出,错误信息重定向到标准 - 错误输出,并提供缓存。默认行为是将二者都输出到标准输出且不提供缓存。 +

[实验特性] splitStream 字段将信息类型的信息输出到标准输出,错误信息重定向到标准 + 错误输出,并提供缓存。默认行为是将二者都输出到标准输出且不提供缓存。

+ + +
字段描述
infoBufferSize [必需]
@@ -800,8 +945,220 @@ both to stdout, without buffering. [Experimental] InfoBufferSize sets the size of the info stream when using split streams. The default is zero, which disables buffering. --> - [实验特性] infoBufferSize 设置在使用分离数据流时 info 数据流的缓冲区大小。 - 默认值为 0,意味着不提供缓存。 +

[实验特性] infoBufferSize 字段设置在使用分离数据流时 info 数据流的缓冲区大小。 + 默认值为 0,意味着不提供缓存。

+
+ +## `LeaderElectionConfiguration` {#LeaderElectionConfiguration} + + +**出现在:** + +- [KubeSchedulerConfiguration](#kubescheduler-config-k8s-io-v1beta2-KubeSchedulerConfiguration) + +- [KubeSchedulerConfiguration](#kubescheduler-config-k8s-io-v1beta3-KubeSchedulerConfiguration) + +- [GenericControllerManagerConfiguration](#controllermanager-config-k8s-io-v1alpha1-GenericControllerManagerConfiguration) + + +LeaderElectionConfiguration 为能够支持领导者选举的组件定义其领导者选举客户端的配置。 + + + + + + + + + + + + + + + + + + + + + + + + + + + +
字段描述
leaderElect [必需]
+bool +
+ +

+ leaderElect 字段允许领导者选举客户端在进入主循环执行之前先获得领导者角色。 + 运行多副本组件时启用此功能有助于提高可用性。 +

+
leaseDuration [必需]
+meta/v1.Duration +
+ +

+ leaseDuration 字段是非领导角色候选者在观察到需要领导席位更新时要等待的时间; + 只有经过所设置时长才可以尝试去获得一个仍处于领导状态但需要被刷新的席位。 + 这里的设置值本质上意味着某个领导者在被另一个候选者替换掉之前可以停止运行的最长时长。 + 只有当启用了领导者选举时此字段有意义。 +

+
renewDeadline [必需]
+meta/v1.Duration +
+ +

+ renewDeadline 字段设置的是当前领导者在停止扮演领导角色之前需要刷新领导状态的时间间隔。 + 此值必须小于或等于租约期限的长度。只有到启用了领导者选举时此字段才有意义。 +

+
retryPeriod [必需]
+meta/v1.Duration +
+ +

+ retryPeriod 字段是客户端在连续两次尝试获得或者刷新领导状态之间需要等待的时长。 + 只有当启用了领导者选举时此字段才有意义。 +

+
resourceLock [必需]
+string +
+ +

resourceLock 字段给出在领导者选举期间要作为锁来使用的资源对象类型。

+
resourceName [必需]
+string +
+ +

resourceName 字段给出在领导者选举期间要作为锁来使用的资源对象名称。

+
resourceNamespace [必需]
+string +
+ +

resourceNamespace 字段给出在领导者选举期间要作为锁来使用的资源对象所在名字空间。

+
+ +## `LoggingConfiguration` {#LoggingConfiguration} + + +**出现在:** + +- [KubeletConfiguration](#kubelet-config-k8s-io-v1beta1-KubeletConfiguration) + + +LoggingConfiguration 包含日志选项。 +参考 [Logs Options](https://github.com/kubernetes/component-base/blob/master/logs/options.go) 以了解更多信息。 + + + + + + + + + + + + + + + + + + + @@ -816,9 +1173,12 @@ using split streams. The default is zero, which disables buffering. --> (`[]k8s.io/component-base/config/v1alpha1.VModuleItem` 的别名) +**出现在:** + +- [LoggingConfiguration](#LoggingConfiguration) + VModuleConfiguration 是一组文件名或文件名模式,及其对应的日志详尽程度阈值配置。 -
字段描述
format [必需]
+string +
+ +

format 字段设置日志消息的结构。默认的格式取值为 text

+
flushFrequency [必需]
+time.Duration +
+ +

对日志进行清洗的最大间隔纳秒数(例如,1s = 1000000000)。 + 如果所选的日志后端在写入日志消息时不提供缓存,则此配置会被忽略。

+
verbosity [必需]
+uint32 +
+ +

verbosity 字段用来确定日志消息记录的详细程度阈值。 + 默认值为 0,意味着仅记录最重要的消息。 + 数值越大,额外的消息越多。错误消息总是被记录下来。

+
vmodule [必需]
+VModuleConfiguration +
+ +

vmodule 字段会在单个文件层面重载 verbosity 阈值的设置。 + 这一选项仅支持 "text" 日志格式。

+
options [Required]
+FormatOptions +
+ +

[实验特性] options 字段中包含特定于不同日志格式的配置参数。 + 只有针对所选格式的选项会被使用,但是合法性检查时会查看所有选项配置。