Skip to content

Commit 32d7f88

Browse files
my-git9my-git9
committed
[zh-cn]sync kube-controller-manager-config.v1alpha1.md
Signed-off-by: xin.li <[email protected]>
1 parent 0af6b58 commit 32d7f88

File tree

1 file changed

+266
-1
lines changed

1 file changed

+266
-1
lines changed

‎content/zh-cn/docs/reference/config-api/kube-controller-manager-config.v1alpha1.md

Lines changed: 266 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,269 @@ auto_generated: true
1515
- [LeaderMigrationConfiguration](#controllermanager-config-k8s-io-v1alpha1-LeaderMigrationConfiguration)
1616
- [KubeControllerManagerConfiguration](#kubecontrollermanager-config-k8s-io-v1alpha1-KubeControllerManagerConfiguration)
1717

18+
## `ClientConnectionConfiguration` {#ClientConnectionConfiguration}
19+
20+
<!--
21+
**Appears in:**
22+
-->
23+
**出现在：**
24+
25+
- [GenericControllerManagerConfiguration](#controllermanager-config-k8s-io-v1alpha1-GenericControllerManagerConfiguration)
26+
27+
<p>
28+
<!--
29+
ClientConnectionConfiguration contains details for constructing a client.
30+
-->
31+
ClientConnectionConfiguration 包含构建客户端的详细信息。
32+
</p>
33+
34+
<table class="table">
35+
<thead><tr><th width="30%"><!--Field-->字段</th><th><!--Description-->描述</th></tr></thead>
36+
<tbody>
37+
38+
<tr><td><code>kubeconfig</code> <B><!--[Required]-->[必需]</B><br/>
39+
<code>string</code>
40+
</td>
41+
<td>
42+
<p>
43+
<!--
44+
kubeconfig is the path to a KubeConfig file.
45+
-->
46+
kubeconfig 是指向 KubeConfig 文件的路径。
47+
</p>
48+
</td>
49+
</tr>
50+
<tr><td><code>acceptContentTypes</code> <B><!--[Required]-->[必需]</B><br/>
51+
<code>string</code>
52+
</td>
53+
<td>
54+
<p>
55+
<!--
56+
acceptContentTypes defines the Accept header sent by clients when connecting to a server, overriding the
57+
default value of 'application/json'. This field will control all connections to the server used by a particular
58+
client.
59+
-->
60+
acceptContentTypes 定义了客户端在连接服务器时发送的 Accept 请求头，
61+
覆盖默认值 application/json。此字段将控制特定客户端与服务器之间的所有连接。
62+
</p>
63+
</td>
64+
</tr>
65+
<tr><td><code>contentType</code> <B><!--[Required]-->[必需]</B><br/>
66+
<code>string</code>
67+
</td>
68+
<td>
69+
<p>
70+
<!--
71+
contentType is the content type used when sending data to the server from this client.
72+
-->
73+
contentType 是此客户端向服务器发送数据时使用的内容类型。
74+
</p>
75+
</td>
76+
</tr>
77+
<tr><td><code>qps</code> <B><!--[Required]-->[必需]</B><br/>
78+
<code>float32</code>
79+
</td>
80+
<td>
81+
<p>
82+
<!--
83+
qps controls the number of queries per second allowed for this connection.
84+
-->
85+
qps 控制此连接每秒允许的查询数量。
86+
</p>
87+
</td>
88+
</tr>
89+
<tr><td><code>burst</code> <B><!--[Required]-->[必需]</B><br/>
90+
<code>int32</code>
91+
</td>
92+
<td>
93+
<p>
94+
<!--
95+
burst allows extra queries to accumulate when a client is exceeding its rate.
96+
-->
97+
burst 允许在客户端超出其速率限制时累积额外的查询。
98+
</p>
99+
</td>
100+
</tr>
101+
</tbody>
102+
</table>
103+
104+
## `DebuggingConfiguration` {#DebuggingConfiguration}
105+
106+
<!--
107+
**Appears in:**
108+
-->
109+
**出现在：**
110+
111+
- [GenericControllerManagerConfiguration](#controllermanager-config-k8s-io-v1alpha1-GenericControllerManagerConfiguration)
112+
113+
<p>
114+
<!--
115+
DebuggingConfiguration holds configuration for Debugging related features.
116+
-->
117+
DebuggingConfiguration 包含与调试相关功能的配置。
118+
</p>
119+
120+
<table class="table">
121+
<thead><tr><th width="30%"><!--Field-->字段</th><th><!--Description-->描述</th></tr></thead>
122+
<tbody>
123+
124+
<tr><td><code>enableProfiling</code> <B><!--[Required]-->[必需]</B><br/>
125+
<code>bool</code>
126+
</td>
127+
<td>
128+
<p>
129+
<!--
130+
enableProfiling enables profiling via web interface host:port/debug/pprof/
131+
-->
132+
enableProfiling 启用通过 Web 接口 host:port/debug/pprof/ 进行性能分析（profiling）。
133+
</p>
134+
</td>
135+
</tr>
136+
<tr><td><code>enableContentionProfiling</code> <B><!--[Required]-->[必需]</B><br/>
137+
<code>bool</code>
138+
</td>
139+
<td>
140+
<p>
141+
<!--
142+
enableContentionProfiling enables block profiling, if
143+
enableProfiling is true.
144+
-->
145+
如果 enableProfiling 为 true，enableContentionProfiling 启用阻塞分析（block profiling）。
146+
</p>
147+
</td>
148+
</tr>
149+
</tbody>
150+
</table>
151+
152+
## `LeaderElectionConfiguration` {#LeaderElectionConfiguration}
153+
154+
<!--
155+
**Appears in:**
156+
-->
157+
**出现在：**
158+
159+
- [GenericControllerManagerConfiguration](#controllermanager-config-k8s-io-v1alpha1-GenericControllerManagerConfiguration)
160+
161+
<p>
162+
<!--
163+
LeaderElectionConfiguration defines the configuration of leader election
164+
clients for components that can run with leader election enabled.
165+
-->
166+
LeaderElectionConfiguration 定义了启用 leader 选举的组件的 leader 选举客户端配置。
167+
</p>
168+
169+
<table class="table">
170+
<thead><tr><th width="30%"><!--Field-->字段</th><th><!--Description-->描述</th></tr></thead>
171+
<tbody>
172+
173+
<tr><td><code>leaderElect</code> <B><!--[Required]-->[必需]</B><br/>
174+
<code>bool</code>
175+
</td>
176+
<td>
177+
<p>
178+
<!--
179+
leaderElect enables a leader election client to gain leadership
180+
before executing the main loop. Enable this when running replicated
181+
components for high availability.
182+
-->
183+
leaderElect 启用 leader 选举客户端在执行主循环之前获取领导权。
184+
在为了高可用性而运行组件副本时启用此特性。
185+
</p>
186+
</td>
187+
</tr>
188+
<tr><td><code>leaseDuration</code> <B><!--[Required]-->[必需]</B><br/>
189+
<a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration"><code>meta/v1.Duration</code></a>
190+
</td>
191+
<td>
192+
<p>
193+
<!--
194+
leaseDuration is the duration that non-leader candidates will wait
195+
after observing a leadership renewal until attempting to acquire
196+
leadership of a led but unrenewed leader slot. This is effectively the
197+
maximum duration that a leader can be stopped before it is replaced
198+
by another candidate. This is only applicable if leader election is
199+
enabled.
200+
-->
201+
leaseDuration 是非领导者候选人在观察到领导权更新后，等待尝试获取领导权的时间。
202+
这实际上是领导者在被另一个候选人取代之前可以停止的最大时长。
203+
此设置仅在启用了 leader 选举时适用。
204+
</p>
205+
</td>
206+
</tr>
207+
<tr><td><code>renewDeadline</code> <B><!--[Required]-->[必需]</B><br/>
208+
<a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration"><code>meta/v1.Duration</code></a>
209+
</td>
210+
<td>
211+
<p>
212+
<!--
213+
renewDeadline is the interval between attempts by the acting master to
214+
renew a leadership slot before it stops leading. This must be less
215+
than or equal to the lease duration. This is only applicable if leader
216+
election is enabled.
217+
-->
218+
renewDeadline 是当前领导者尝试刷新领导权的时间间隔，如果在此时间内未能成功刷新，
219+
它将停止担任领导者。此值必须小于或等于 leaseDuration。
220+
此设置仅在启用了 leader 选举时适用。
221+
</p>
222+
</td>
223+
</tr>
224+
<tr><td><code>retryPeriod</code> <B><!--[Required]-->[必需]</B><br/>
225+
<a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration"><code>meta/v1.Duration</code></a>
226+
</td>
227+
<td>
228+
<p>
229+
<!--
230+
retryPeriod is the duration the clients should wait between attempting
231+
acquisition and renewal of a leadership. This is only applicable if
232+
leader election is enabled.
233+
-->
234+
retryPeriod 是客户端在尝试获取和刷新领导权之间应等待的时间间隔。
235+
此设置仅在启用了 leader 选举时适用。
236+
</p>
237+
</td>
238+
</tr>
239+
<tr><td><code>resourceLock</code> <B><!--[Required]-->[必需]</B><br/>
240+
<code>string</code>
241+
</td>
242+
<td>
243+
<p>
244+
<!--
245+
resourceLock indicates the resource object type that will be used to lock
246+
during leader election cycles.
247+
-->
248+
resourceLock 指示在 leader 选举周期中用于锁定的资源对象类型。
249+
</p>
250+
</td>
251+
</tr>
252+
<tr><td><code>resourceName</code> <B><!--[Required]-->[必需]</B><br/>
253+
<code>string</code>
254+
</td>
255+
<td>
256+
<p>
257+
<!--
258+
resourceName indicates the name of resource object that will be used to lock
259+
during leader election cycles.
260+
-->
261+
resourceName 指示在 leader 选举周期中用于锁定的资源对象的名称。
262+
</p>
263+
</td>
264+
</tr>
265+
<tr><td><code>resourceNamespace</code> <B><!--[Required]-->[必需]</B><br/>
266+
<code>string</code>
267+
</td>
268+
<td>
269+
<p>
270+
<!--
271+
resourceName indicates the namespace of resource object that will be used to lock
272+
during leader election cycles.
273+
-->
274+
resourceNamespace 指示在 leader 选举周期中用于锁定的资源对象所在的命名空间。
275+
</p>
276+
</td>
277+
</tr>
278+
</tbody>
279+
</table>
280+
18281
## `NodeControllerConfiguration` {#NodeControllerConfiguration}
19282

20283
<!--
@@ -2071,10 +2334,12 @@ Nodelifecyclecontrolerconfiguration 包含描述 NodeLifecycleController 的元
20712334
nodeMontiorGracePeriod is the amount of time which we allow a running node to be
20722335
unresponsive before marking it unhealthy. Must be N times more than kubelet's
20732336
nodeStatusUpdateFrequency, where N means number of retries allowed for kubelet
2074-
to post node status.
2337+
to post node status. This value should also be greater than the sum of
2338+
HTTP2_PING_TIMEOUT_SECONDS and HTTP2_READ_IDLE_TIMEOUT_SECONDS.
20752339
-->
20762340
nodeMontiorGracePeriod 是在将运行中的节点标记为不健康之前允许其无响应的时长。
20772341
必须是 kubelet 的 nodeStatusUpdateFrequency 的 N 倍，其中 N 表示允许 kubelet 发布节点状态的重试次数。
2342+
此值还应大于 `HTTP2_PING_TIMEOUT_SECONDS` 和 `HTTP2_READ_IDLE_TIMEOUT_SECONDS` 之和。
20782343
</p>
20792344
</td>
20802345
</tr>

0 commit comments

Comments
 (0)