Skip to content

Commit 793fb6d

Browse files
authored
Merge pull request #48148 from windsonsea/letfig
[zh] Sync config-api/kubelet-config.v1beta1.md
2 parents 2e19ab1 + 2d3c023 commit 793fb6d

File tree

1 file changed

+76
-41
lines changed

1 file changed

+76
-41
lines changed

content/zh-cn/docs/reference/config-api/kubelet-config.v1beta1.md

Lines changed: 76 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ auto_generated: true
1313
<!--
1414
## Resource Types
1515
-->
16-
## 资源类型
16+
## 资源类型 {#resource-types}
1717

1818
- [CredentialProviderConfig](#kubelet-config-k8s-io-v1beta1-CredentialProviderConfig)
1919
- [KubeletConfiguration](#kubelet-config-k8s-io-v1beta1-KubeletConfiguration)
@@ -97,7 +97,7 @@ JSONOptions 包含为 &quot;json&quot; 日志格式提供的选项。
9797
<td>
9898
<!--
9999
(Members of <code>OutputRoutingOptions</code> are embedded into this type.)
100-
<span class="text-muted">No descrtputRoutingOptions contains options that are supported biption provided.</span>
100+
<span class="text-muted">No description provided.</span>
101101
-->
102102
(<code>OutputRoutingOptions</code> 的成员嵌入到此类型中。)
103103
<span class="text-muted">没有提供描述。</span>
@@ -108,11 +108,13 @@ JSONOptions 包含为 &quot;json&quot; 日志格式提供的选项。
108108

109109
## `LogFormatFactory` {#LogFormatFactory}
110110

111+
<p>
111112
<!--
112113
LogFormatFactory provides support for a certain additional,
113114
non-default log format.
114115
-->
115-
<p>LogFormatFactory 提供了对某些附加的、非默认的日志格式的支持。</p>
116+
LogFormatFactory 提供了对某些附加的、非默认的日志格式的支持。
117+
</p>
116118

117119
## `LoggingConfiguration` {#LoggingConfiguration}
118120

@@ -123,10 +125,12 @@ non-default log format.
123125

124126
- [KubeletConfiguration](#kubelet-config-k8s-io-v1beta1-KubeletConfiguration)
125127

128+
<p>
126129
<!--
127130
LoggingConfiguration contains logging options.
128131
-->
129132
LoggingConfiguration 包含日志选项。
133+
</p>
130134

131135
<table class="table">
132136
<thead><tr><th width="30%"><!--Field-->字段</th><th><!--Description-->描述</th></tr></thead>
@@ -273,8 +277,8 @@ certain global defaults.
273277
<!--
274278
OutputRoutingOptions contains options that are supported by both &quot;text&quot; and &quot;json&quot;.
275279
-->
276-
</p>
277280
OutputRoutingOptions 包含 &quot;text&quot;&quot;json&quot; 支持的选项。
281+
</p>
278282

279283
<table class="table">
280284
<thead><tr><th width="30%">Field</th><th><!--Description-->描述<</th></tr></thead>
@@ -311,7 +315,7 @@ Only available when the LoggingAlphaOptions feature gate is enabled.</p>
311315
</tbody>
312316
</table>
313317

314-
## `TextOptions` {#TextOptions}
318+
## `TextOptions` {#TextOptions}
315319

316320
<!--
317321
**Appears in:**
@@ -327,7 +331,6 @@ TextOptions contains options for logging format &quot;text&quot;.
327331
TextOptions 包含用于记录 &quot;text&quot; 格式的选项。
328332
</p>
329333

330-
331334
<table class="table">
332335
<thead><tr><th width="30%">Field</th><th><!--Description-->描述</th></tr></thead>
333336
<tbody>
@@ -406,10 +409,12 @@ flushFrequency field, and new fields should use metav1.Duration.
406409

407410
- [KubeletConfiguration](#kubelet-config-k8s-io-v1beta1-KubeletConfiguration)
408411

412+
<p>
409413
<!--
410414
TracingConfiguration provides versioned configuration for OpenTelemetry tracing clients.
411415
-->
412-
<p>TracingConfiguration 为 OpenTelemetry 追踪客户端提供版本化的配置信息。</p>
416+
TracingConfiguration 为 OpenTelemetry 追踪客户端提供版本化的配置信息。
417+
</p>
413418

414419
<table class="table">
415420
<thead><tr><th width="30%">字段</th><th>描述</th></tr></thead>
@@ -458,12 +463,14 @@ rate, but otherwise never samples.
458463

459464
- [LoggingConfiguration](#LoggingConfiguration)
460465

466+
<p>
461467
<!--
462468
VModuleConfiguration is a collection of individual file names or patterns
463469
and the corresponding verbosity threshold.
464470
-->
465471
VModuleConfiguration 是一个集合,其中包含一个个文件名(或文件名模式)
466472
及其对应的详细程度阈值。
473+
</p>
467474

468475
## `VerbosityLevel` {#VerbosityLevel}
469476

@@ -479,20 +486,24 @@ VModuleConfiguration 是一个集合,其中包含一个个文件名(或文
479486

480487
- [LoggingConfiguration](#LoggingConfiguration)
481488

489+
<p>
482490
<!--
483491
VerbosityLevel represents a klog or logr verbosity threshold.
484492
-->
485-
<p>VerbosityLevel 表示 klog 或 logr 的详细程度(verbosity)阈值。</p>
493+
VerbosityLevel 表示 klog 或 logr 的详细程度(verbosity)阈值。
494+
</p>
486495

487496
## `CredentialProviderConfig` {#kubelet-config-k8s-io-v1beta1-CredentialProviderConfig}
488497

498+
<p>
489499
<!--
490500
CredentialProviderConfig is the configuration containing information about
491501
each exec credential provider. Kubelet reads this configuration from disk and enables
492502
each provider as specified by the CredentialProvider type.
493503
-->
494504
CredentialProviderConfig 包含有关每个 exec 凭据提供者的配置信息。
495505
Kubelet 从磁盘上读取这些配置信息,并根据 CredentialProvider 类型启用各个提供者。
506+
</p>
496507

497508
<table class="table">
498509
<thead><tr><th width="30%"><!--Field-->字段</th><th><!--Description-->描述</th></tr></thead>
@@ -525,10 +536,12 @@ auth keys, the value from the provider earlier in this list is used.
525536

526537
## `KubeletConfiguration` {#kubelet-config-k8s-io-v1beta1-KubeletConfiguration}
527538

539+
<p>
528540
<!--
529541
KubeletConfiguration contains the configuration for the Kubelet
530542
-->
531543
KubeletConfiguration 中包含 Kubelet 的配置。
544+
</p>
532545

533546
<table class="table">
534547
<thead><tr><th width="30%"><!--Field-->字段</th><th><!--Description-->描述</th></tr></thead>
@@ -1132,8 +1145,8 @@ collected based on being unused for too long.
11321145
Default: &quot;0s&quot; (disabled)
11331146
-->
11341147
<p><code>imageMaximumGCAge</code> 是对未使用镜像进行垃圾收集之前允许其存在的时长。
1135-
此字段的默认值为 &quot;0s&quot;,表示禁用此字段,这意味着镜像不会因为过长时间不使用而被垃圾收集。
1136-
默认值:&quot;0s&quot;(已禁用)</p>
1148+
此字段的默认值为 &quot;0s&quot;,表示禁用此字段,这意味着镜像不会因为过长时间不使用而被垃圾收集。</p>
1149+
<p>默认值:&quot;0s&quot;(已禁用)</p>
11371150
</td>
11381151
</tr>
11391152

@@ -2109,8 +2122,7 @@ Default: &quot;&quot;
21092122
-->
21102123
<p><code>systemReservedCgroup</code> 帮助 kubelet 识别用来为 OS 系统级守护进程实施
21112124
<code>systemReserved</code> 计算资源预留时使用的顶级控制组(CGroup)。
2112-
参考 <a href="https://kubernetes.io/zh-cn/docs/tasks/administer-cluster/reserve-compute-resources/#node-allocatable">Node Allocatable</a>
2113-
以了解详细信息。</p>
2125+
更多细节参阅<a href="https://kubernetes.io/zh-cn/docs/tasks/administer-cluster/reserve-compute-resources/#node-allocatable">节点可分配资源</a>。</p>
21142126
<p>默认值:&quot;&quot;</p>
21152127
</td>
21162128
</tr>
@@ -2129,8 +2141,7 @@ Default: &quot;&quot;
21292141
-->
21302142
<p><code>kubeReservedCgroup</code> 帮助 kubelet 识别用来为 Kubernetes 节点系统级守护进程实施
21312143
<code>kubeReserved</code> 计算资源预留时使用的顶级控制组(CGroup)。
2132-
参阅 <a href="https://kubernetes.io/zh-cn/docs/tasks/administer-cluster/reserve-compute-resources/#node-allocatable">Node Allocatable</a>
2133-
了解进一步的信息。</p>
2144+
更多细节参阅<a href="https://kubernetes.io/zh-cn/docs/tasks/administer-cluster/reserve-compute-resources/#node-allocatable">节点可分配资源</a></p>
21342145
<p>默认值:&quot;&quot;</p>
21352146
</td>
21362147
</tr>
@@ -2158,8 +2169,7 @@ Default: [&quot;pods&quot;]
21582169
<p>如果列表中包含 <code>system-reserved</code>,则必须设置 <code>systemReservedCgroup</code>。</p>
21592170
<p>如果列表中包含 <code>kube-reserved</code>,则必须设置 <code>kubeReservedCgroup</code>。</p>
21602171
<p>这个字段只有在 <code>cgroupsPerQOS</code>被设置为 <code>true</code> 才被支持。</p>
2161-
<p>参阅<a href="https://kubernetes.io/zh-cn/docs/tasks/administer-cluster/reserve-compute-resources/#node-allocatable">Node Allocatable</a>
2162-
了解进一步的信息。</p>
2172+
<p>更多细节参阅<a href="https://kubernetes.io/zh-cn/docs/tasks/administer-cluster/reserve-compute-resources/#node-allocatable">节点可分配资源</a>。</p>
21632173
<p>默认值:[&quot;pods&quot;]</p>
21642174
</td>
21652175
</tr>
@@ -2365,6 +2375,7 @@ Default: nil
23652375
<a href="#kubelet-config-k8s-io-v1beta1-MemoryReservation"><code>[]MemoryReservation</code></a>
23662376
</td>
23672377
<td>
2378+
<p>
23682379
<!--
23692380
reservedMemory specifies a comma-separated list of memory reservations for NUMA nodes.
23702381
The parameter makes sense only in the context of the memory manager feature.
@@ -2378,32 +2389,37 @@ reserved memory from all NUMA nodes should be equal to the amount of memory spec
23782389
by the <a href="https://kubernetes.io/docs/tasks/administer-cluster/reserve-compute-resources/#node-allocatable">node allocatable</a>.
23792390
If at least one node allocatable parameter has a non-zero value, you will need
23802391
to specify at least one NUMA node.
2381-
Also, avoid specifying:</p>
2382-
<ol>
2383-
<li>Duplicates, the same NUMA node, and memory type, but with a different value.</li>
2384-
<li>zero limits for any memory type.</li>
2385-
<li>NUMAs nodes IDs that do not exist under the machine.</li>
2386-
<li>memory types except for memory and hugepages-&lt;size&gt;</li>
2387-
</ol>
2388-
<p>Default: nil</p>
2389-
-->
2390-
<p><code>reservedMemory</code> 给出一个逗号分隔的列表,为 NUMA 节点预留内存。</p>
2391-
<p>此参数仅在内存管理器功能特性语境下有意义。内存管理器不会为容器负载分配预留内存。
2392+
Also, avoid specifying:
2393+
-->
2394+
<code>reservedMemory</code> 给出一个逗号分隔的列表,为 NUMA 节点预留内存。
2395+
此参数仅在内存管理器功能特性语境下有意义。内存管理器不会为容器负载分配预留内存。
23922396
例如,如果你的 NUMA0 节点内存为 10Gi,<code>reservedMemory</code> 设置为在 NUMA0
2393-
上预留 1Gi 内存,内存管理器会认为其上只有 9Gi 内存可供分配。</p>
2394-
<p>你可以设置不同数量的 NUMA 节点和内存类型。你也可以完全忽略这个字段,不过你要清楚,
2397+
上预留 1Gi 内存,内存管理器会认为其上只有 9Gi 内存可供分配。
2398+
你可以设置不同数量的 NUMA 节点和内存类型。你也可以完全忽略这个字段,不过你要清楚,
23952399
所有 NUMA 节点上预留内存的总量要等于通过
2396-
<a href="https://kubernetes.io/docs/tasks/administer-cluster/reserve-compute-resources/#node-allocatable">node allocatable</a>
2397-
设置的内存量。</p>
2398-
<p>如果至少有一个节点可分配参数设置值非零,则你需要设置至少一个 NUMA 节点。</p>
2399-
<p>此外,避免如下设置:</p>
2400+
<a href="https://kubernetes.io/zh-cn/docs/tasks/administer-cluster/reserve-compute-resources/#node-allocatable">节点可分配资源</a>设置的内存量。
2401+
如果至少有一个节点可分配参数设置值非零,则你需要设置至少一个 NUMA 节点。
2402+
此外,避免如下设置:
2403+
</p>
24002404
<ol>
2405+
<!--
2406+
<li>Duplicates, the same NUMA node, and memory type, but with a different value.</li>
2407+
<li>zero limits for any memory type.</li>
2408+
<li>NUMAs nodes IDs that do not exist under the machine.</li>
2409+
<li>memory types except for memory and hugepages-&lt;size&gt;</li>
2410+
</ol>
2411+
-->
24012412
<li>在配置值中存在重复项,NUMA 节点和内存类型相同,但配置值不同,这是不允许的。</li>
24022413
<li>为任何内存类型设置限制值为零。</li>
24032414
<li>NUMA 节点 ID 在宿主系统上不存在。/li>
24042415
<li>除 <code>memory</code> 和 <code>hugepages-&lt;size&gt;</code> 之外的内存类型。</li>
24052416
</ol>
2406-
<p>默认值:nil</p>
2417+
<p>
2418+
<!--
2419+
Default: nil
2420+
-->
2421+
默认值:nil
2422+
</p>
24072423
</td>
24082424
</tr>
24092425

@@ -2415,7 +2431,7 @@ Also, avoid specifying:</p>
24152431
enableProfilingHandler enables profiling via web interface host:port/debug/pprof/
24162432
Default: true
24172433
-->
2418-
<p><code>enableProfilingHandler</code> 启用通过 host:port/debug/pprof/ 接口来执行性能分析。</p>
2434+
<p><code>enableProfilingHandler</code> 启用通过 <code>host:port/debug/pprof/</code> 接口来执行性能分析。</p>
24192435
<p>默认值:true</p>
24202436
</td>
24212437
</tr>
@@ -2428,7 +2444,7 @@ Default: true
24282444
enableDebugFlagsHandler enables flags endpoint via web interface host:port/debug/flags/v
24292445
Default: true
24302446
-->
2431-
<p><code>enableDebugFlagsHandler</code> 启用通过 host:port/debug/flags/v Web
2447+
<p><code>enableDebugFlagsHandler</code> 启用通过 <code>host:port/debug/flags/v Web</code>
24322448
接口上的标志设置。</p>
24332449
<p>默认值:true</p>
24342450
</td>
@@ -2470,7 +2486,7 @@ Default: 0.8
24702486
</tr>
24712487

24722488
<tr><td><code>registerWithTaints</code><br/>
2473-
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#taint-v1-core"><code>[]core/v1.Taint</code></a>
2489+
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.31/#taint-v1-core"><code>[]core/v1.Taint</code></a>
24742490
</td>
24752491
<td>
24762492
<!--
@@ -2563,6 +2579,25 @@ Linux 支持 UNIX 域套接字,而 Windows 支持命名管道和 TCP 端点。
25632579
如果未指定,则使用 containerRuntimeEndpoint 中的值。</p>
25642580
</td>
25652581
</tr>
2582+
<tr><td><code>failCgroupV1</code><br/>
2583+
<code>bool</code>
2584+
</td>
2585+
<td>
2586+
<p>
2587+
<!--
2588+
FailCgroupV1 prevents the kubelet from starting on hosts
2589+
that use cgroup v1. By default, this is set to 'false', meaning
2590+
the kubelet is allowed to start on cgroup v1 hosts unless this
2591+
option is explicitly enabled.
2592+
Default: false
2593+
-->
2594+
<code>failCgroupV1</code> 防止 kubelet 在使用 cgroup v1 的主机上启动。
2595+
默认情况下,此选项设置为 “false”,这意味着除非此选项被显式启用,
2596+
否则 kubelet 被允许在 cgroup v1 主机上启动。
2597+
默认值:false
2598+
</p>
2599+
</td>
2600+
</tr>
25662601
</tbody>
25672602
</table>
25682603

@@ -2585,7 +2620,7 @@ SerializedNodeConfigSource 允许对 `v1.NodeConfigSource` 执行序列化操作
25852620
<tr><td><code>kind</code><br/>string</td><td><code>SerializedNodeConfigSource</code></td></tr>
25862621

25872622
<tr><td><code>source</code><br/>
2588-
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#nodeconfigsource-v1-core"><code>core/v1.NodeConfigSource</code></a>
2623+
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.31/#nodeconfigsource-v1-core"><code>core/v1.NodeConfigSource</code></a>
25892624
</td>
25902625
<td>
25912626
<!--
@@ -2657,8 +2692,8 @@ a single subdomain segment, so *.io does not match *.k8s.io.
26572692
-->
26582693
<p><code>matchImages</code> 中的每个条目都是一个模式字符串,其中可以包含端口号和路径。
26592694
域名部分可以包含统配符,但端口或路径部分不可以。通配符可以用作子域名,例如
2660-
<code>&ast;.k8s.io</code> 或 <code>k8s.&ast;.io</code>,以及顶级域名,如 <code>k8s.&ast;</code>。</p>
2661-
<p>对类似 <code>app&ast;.k8s.io</code> 这类部分子域名的匹配也是支持的。
2695+
<code>&ast;.k8s.io</code> 或 <code>k8s.&ast;.io</code>,以及顶级域名,如 <code>k8s.&ast;</code>。
2696+
对类似 <code>app&ast;.k8s.io</code> 这类部分子域名的匹配也是支持的。
26622697
每个通配符只能用来匹配一个子域名段,所以 <code>&ast;.io</code> 不会匹配 <code>&ast;.k8s.io</code>。</p>
26632698
<!--
26642699
A match exists between an image and a matchImage when all of the below are true:
@@ -3069,7 +3104,7 @@ MemoryReservation 为每个 NUMA 节点设置不同类型的内存预留。
30693104
</tr>
30703105

30713106
<tr><td><code>limits</code> <B><!-- [Required] -->[必需]</B><br/>
3072-
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#resourcelist-v1-core"><code>core/v1.ResourceList</code></a>
3107+
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.31/#resourcelist-v1-core"><code>core/v1.ResourceList</code></a>
30733108
</td>
30743109
<td>
30753110
<!--span class="text-muted">No description provided.</span-->

0 commit comments

Comments
 (0)