Merge pull request #37079 from windsonsea/configv1b1

[zh] Sync /config-api/kubelet-config.v1beta1.md
2022-09-30 06:38:30 -07:00 · 2022-09-30 06:38:30 -07:00 · 61988004d1
parent bde6ae7ef4 d4be389427
commit 61988004d1
1 changed files with 138 additions and 32 deletions
--- a/content/zh-cn/docs/reference/config-api/kubelet-config.v1beta1.md
+++ b/content/zh-cn/docs/reference/config-api/kubelet-config.v1beta1.md
@ -1467,13 +1467,13 @@ Default: &quot;&quot;
 <td>
   <!--systemReservedCgroup helps the kubelet identify absolute name of top level CGroup used
 to enforce <code>systemReserved</code> compute resource reservation for OS system daemons.
-Refer to <a href="https://git.k8s.io/design-proposals-archive/node/node-allocatable.md">Node Allocatable</a>
+Refer to <a href="https://git.k8s.io/community/contributors/design-proposals/node/node-allocatable.md">Node Allocatable</a>
 doc for more information.
 Default: &quot;&quot;
   -->
   <p><code>systemReservedCgroup</code>帮助 kubelet 识别用来为 OS 系统级守护进程实施
 <code>systemReserved</code>计算资源预留时使用的顶级控制组（CGroup）。
-参考 <a href="https://git.k8s.io/design-proposals-archive/node/node-allocatable.md">Node Allocatable</a>
+参考 <a href="https://git.k8s.io/community/contributors/design-proposals/node/node-allocatable.md">Node Allocatable</a>
 以了解详细信息。</p>
   <p>默认值：&quot;&quot;</p>
 </td>
@ -1485,14 +1485,14 @@ Default: &quot;&quot;
 </td>
 <td>
   <!--kubeReservedCgroup helps the kubelet identify absolute name of top level CGroup used
-to enforce `KubeReserved` compute resource reservation for Kubernetes node system daemons.
-Refer to <a href="https://git.k8s.io/design-proposals-archive/node/node-allocatable.md">Node Allocatable</a>
+to enforce <code>KubeReserved</code> compute resource reservation for Kubernetes node system daemons.
+Refer to <a href="https://git.k8s.io/community/contributors/design-proposals/node/node-allocatable.md">Node Allocatable</a>
 doc for more information.
-Default: ""
+Default: &quot;&quot;
   -->
   <p><code>kubeReservedCgroup</code> 帮助 kubelet 识别用来为 Kubernetes 节点系统级守护进程实施
 <code>kubeReserved</code>计算资源预留时使用的顶级控制组（CGroup）。
-参阅 <a href="https://git.k8s.io/design-proposals-archive/node/node-allocatable.md">Node Allocatable</a>
+参阅 <a href="https://git.k8s.io/community/contributors/design-proposals/node/node-allocatable.md">Node Allocatable</a>
 了解进一步的信息。</p>
   <p>默认值：&quot;&quot;</p>
 </td>
@ -1509,7 +1509,7 @@ If <code>none</code> is specified, no other options may be specified.
 When <code>system-reserved</code> is in the list, systemReservedCgroup must be specified.
 When <code>kube-reserved</code> is in the list, kubeReservedCgroup must be specified.
 This field is supported only when <code>cgroupsPerQOS</code> is set to true.
-Refer to <a href="https://git.k8s.io/design-proposals-archive/node/node-allocatable.md">Node Allocatable</a>
+Refer to <a href="https://git.k8s.io/community/contributors/design-proposals/node/node-allocatable.md">Node Allocatable</a>
 for more information.
 Default: [&quot;pods&quot;]
   -->
@ -1520,7 +1520,7 @@ Default: [&quot;pods&quot;]
   <p>如果列表中包含<code>system-reserved</code>，则必须设置<code>systemReservedCgroup</code>。</p>
   <p>如果列表中包含<code>kube-reserved</code>，则必须设置<code>kubeReservedCgroup</code>。</p>
   <p>这个字段只有在<code>cgroupsPerQOS</code>被设置为<code>true</code>才被支持。</p>
-   <p>参阅<a href="https://git.k8s.io/design-proposals-archive/node/node-allocatable.md">Node Allocatable</a>
+   <p>参阅<a href="https://git.k8s.io/community/contributors/design-proposals/node/node-allocatable.md">Node Allocatable</a>
 了解进一步的信息。</p>
   <p>默认值：[&quot;pods&quot;]</p>
 </td>
@ -1575,7 +1575,7 @@ Default: &quot;quot;
 <code>bool</code>
 </td>
 <td>
-   <!--kernelMemcgNotification, if set, instructs the the kubelet to integrate with the
+   <!--kernelMemcgNotification, if set, instructs the kubelet to integrate with the
 kernel memcg notification for determining if memory eviction thresholds are
 exceeded rather than polling.
 Default: false
@ -1832,6 +1832,37 @@ Default: true
   <p>默认值：true</p>
 </td>
 </tr>
+<tr><td><code>tracing</code><br/>
+<a href="#TracingConfiguration"><code>TracingConfiguration</code></a>
+</td>
+<td>
+   <!-- Tracing specifies the versioned configuration for OpenTelemetry tracing clients.
+See http://kep.k8s.io/2832 for more details. -->
+   <p>tracing 为 OpenTelemetry 追踪客户端设置版本化的配置信息。
+参阅 http://kep.k8s.io/2832 了解更多细节。</p>
+</td>
+</tr>
+<tr><td><code>localStorageCapacityIsolation</code><br/>
+<code>bool</code>
+</td>
+<td>
+   <!-- LocalStorageCapacityIsolation enables local ephemeral storage isolation feature. The default setting is true.
+This feature allows users to set request/limit for container's ephemeral storage and manage it in a similar way
+as cpu and memory. It also allows setting sizeLimit for emptyDir volume, which will trigger pod eviction if disk
+usage from the volume exceeds the limit.
+This feature depends on the capability of detecting correct root file system disk usage. For certain systems,
+such as kind rootless, if this capability cannot be supported, the feature LocalStorageCapacityIsolation should be
+disabled. Once disabled, user should not set request/limit for container's ephemeral storage, or sizeLimit for emptyDir.
+Default: true -->
+   <p>localStorageCapacityIsolation 启用本地临时存储隔离特性。默认设置为 true。
+此特性允许用户为容器的临时存储设置请求/限制，并以类似的方式管理 cpu 和 memory 的请求/限制。
+此特性还允许为 emptyDir 卷设置 sizeLimit，如果卷所用的磁盘超过此限制将触发 Pod 驱逐。
+此特性取决于准确测定根文件系统磁盘用量的能力。对于 kind rootless 这类系统，
+如果不支持此能力，则 LocalStorageCapacityIsolation 特性应被禁用。
+一旦禁用，用户不应该为容器的临时存储设置请求/限制，也不应该为 emptyDir 设置 sizeLimit。
+默认值：true</p>
+</td>
+</tr>
 </tbody>
 </table>

@ -2443,9 +2474,10 @@ FormatOptions 包含为不同日志格式提供的选项。
 <a href="#JSONOptions"><code>JSONOptions</code></a>
 </td>
 <td>
-   <p><!--[Experimental] JSON contains options for logging format &quot;json&quot;.-->
-   [试验功能] <code>json</code> 包含为 &quot;json&quot; 日志格式提供的选项。
-   </p>
+   <!-- [Alpha] JSON contains options for logging format &quot;json&quot;.
+Only available when the LoggingAlphaOptions feature gate is enabled. -->
+   <p>[Alpha] JSON 包含记录 &quot;json&quot; 格式日志的选项。
+只有 LoggingAlphaOptions 特性门控被启用时才可用。</p>
 </td>
 </tr>
 </tbody>
@ -2475,13 +2507,15 @@ JSONOptions 包含为 &quot;json&quot; 日志格式提供的选项。
 </td>
 <td>
   <p>
-   <!--[Experimental] SplitStream redirects error messages to stderr while
+   <!--[Alpha] SplitStream redirects error messages to stderr while
 info messages go to stdout, with buffering. The default is to write
-both to stdout, without buffering.
+both to stdout, without buffering. Only available when
+the LoggingAlphaOptions feature gate is enabled.
   -->
-   [试验功能] <code>splitStream</code> 将错误信息重定向到标准错误输出（stderr），
+   [Alpha] <code>splitStream</code> 将错误信息重定向到标准错误输出（stderr），
 而将提示信息重定向到标准输出（stdout），并为二者提供缓存。
 默认设置是将二者都写出到标准输出，并且不提供缓存。
+只有 LoggingAlphaOptions 特性门控被启用时才可用。
   </p>
 </td>
 </tr>
@ -2491,16 +2525,25 @@ both to stdout, without buffering.
 </td>
 <td>
   <p>
-   <!--[Experimental] InfoBufferSize sets the size of the info stream when
-using split streams. The default is zero, which disables buffering.-->
-   [试验功能] <code>infoBufferSize</coe> 在分离数据流时用来设置提示数据流的大小。
-默认值为 0，相当于禁止缓存。
+   <!--[Alpha] InfoBufferSize sets the size of the info stream when
+using split streams. The default is zero, which disables buffering.
+Only available when the LoggingAlphaOptions feature gate is enabled.-->
+   [Alpha] <code>infoBufferSize</code> 在分离数据流时用来设置提示数据流的大小。
+默认值为 0，相当于禁止缓存。只有 LoggingAlphaOptions 特性门控被启用时才可用。
   </p>
 </td>
 </tr>
 </tbody>
 </table>

+## `LogFormatFactory`     {#LogFormatFactory}
+
+<!--
+LogFormatFactory provides support for a certain additional,
+non-default log format.
+-->
+<p>LogFormatFactory 提供了对某些附加的、非默认的日志格式的支持。</p>
+
 ## `LoggingConfiguration`     {#LoggingConfiguration}

 <!--
@ -2511,12 +2554,9 @@ using split streams. The default is zero, which disables buffering.-->
 - [KubeletConfiguration](#kubelet-config-k8s-io-v1beta1-KubeletConfiguration)

 <!--
-LoggingConfiguration contains logging options
-Refer [Logs Options](https://github.com/kubernetes/component-base/blob/master/logs/options.go) for more information.
+LoggingConfiguration contains logging options.
 -->
 LoggingConfiguration 包含日志选项。
-参考 [Logs Options](https://github.com/kubernetes/component-base/blob/master/logs/options.go)
-以了解更多信息。

 <table class="table">
 <thead><tr><th width="30%"><!--Field-->字段</th><th><!--Description-->描述</th></tr></thead>
@ -2541,8 +2581,8 @@ default value of format is `text`-->
  <p>
  <!--
   Maximum number of nanoseconds (i.e. 1s = 1000000000) between log
-   flushes.  Ignored if the selected logging backend writes log
-   messages without buffering.
+flushes. Ignored if the selected logging backend writes log
+messages without buffering.
  -->
   对日志进行清洗的最大间隔纳秒数（例如，1s = 1000000000）。
   如果所选的日志后端在写入日志消息时不提供缓存，则此配置会被忽略。
@ -2551,7 +2591,7 @@ default value of format is `text`-->
 </tr>

 <tr><td><code>verbosity</code> <B>[必需]</B><br/>
-<code>uint32</code>
+<a href="#VerbosityLevel"><code>VerbosityLevel</code></a>
 </td>
 <td>
  <p>
@ -2583,23 +2623,70 @@ Only supported for &quot;text&quot; log format.-->
 </td>
 <td>
  <p>
-  <!--[Experimental] Options holds additional parameters that are specific
+  <!--[Alpha] Options holds additional parameters that are specific
 to the different logging formats. Only the options for the selected
-format get used, but all of them get validated.-->
-  [试验功能] <code>options</code> 中包含特定于不同日志格式的配置参数。
-只有针对所选格式的选项会被使用，但是合法性检查时会查看所有选项配置。
+format get used, but all of them get validated.
+Only available when the LoggingAlphaOptions feature gate is enabled.-->
+  [Alpha] <code>options</code> 中包含特定于不同日志格式的附加参数。
+只有针对所选格式的选项会被使用，但是合法性检查时会查看所有参数。
+只有 LoggingAlphaOptions 特性门控被启用时才可用。
  </p>
 </td>
 </tr>
 </tbody>
 </table>

+## `TracingConfiguration`     {#TracingConfiguration}
+
+<!--
+**Appears in:**
+-->
+**出现在：**
+
+- [KubeletConfiguration](#kubelet-config-k8s-io-v1beta1-KubeletConfiguration)
+
+<!--
+TracingConfiguration provides versioned configuration for OpenTelemetry tracing clients.
+-->
+<p>TracingConfiguration 为 OpenTelemetry 追踪客户端提供版本化的配置信息。</p>
+
+
+<table class="table">
+<thead><tr><th width="30%">字段</th><th>描述</th></tr></thead>
+<tbody>
+    
+  
+<tr><td><code>endpoint</code><br/>
+<code>string</code>
+</td>
+<td>
+   <!-- Endpoint of the collector this component will report traces to.
+The connection is insecure, and does not currently support TLS.
+Recommended is unset, and endpoint is the otlp grpc default, localhost:4317. -->
+   <p>采集器的 endpoint，此组件将向其报告追踪链路。
+此连接不安全，目前不支持 TLS。推荐不设置，endpoint 是 otlp grpc 默认值，localhost:4317。</p>
+</td>
+</tr>
+<tr><td><code>samplingRatePerMillion</code><br/>
+<code>int32</code>
+</td>
+<td>
+   <!-- SamplingRatePerMillion is the number of samples to collect per million spans.
+Recommended is unset. If unset, sampler respects its parent span's sampling
+rate, but otherwise never samples. -->
+   <p>samplingRatePerMillion 是每百万 span 要采集的样本数。推荐不设置。
+如果不设置，则采样器优先使用其父级 span 的采样率，否则不采样。</p>
+</td>
+</tr>
+</tbody>
+</table>
+
 ## `VModuleConfiguration`     {#VModuleConfiguration}

 <!--
-(Alias of `[]k8s.io/component-base/config/v1alpha1.VModuleItem`)
+(Alias of `[]k8s.io/component-base/logs/api/v1.VModuleItem`)
 -->
-（`[]k8s.io/component-base/config/v1alpha1.VModuleItem` 类型的别名）
+（`[]k8s.io/component-base/logs/api/v1.VModuleItem` 的别名）

 <!--
 **Appears in:**
@ -2615,3 +2702,22 @@ and the corresponding verbosity threshold.
 VModuleConfiguration 是一个集合，其中包含一个个文件名（或文件名模式）
 及其对应的详细程度阈值。

+## `VerbosityLevel`     {#VerbosityLevel}
+    
+<!--
+(Alias of `uint32`)
+-->
+（`uint32` 的别名）
+
+<!--
+**Appears in:**
+-->
+**出现在：**
+
+- [LoggingConfiguration](#LoggingConfiguration)
+
+<!--
+VerbosityLevel represents a klog or logr verbosity threshold.
+-->
+<p>VerbosityLevel 表示 klog 或 logr 的详细程度（verbosity）阈值。</p>
+