Merge pull request #53334 from my-git9/npe-13689

[zh-cn]sync kubectl/kubectl.md

Author: k8s-ci-robot

content/zh-cn/docs/reference/kubectl/kubectl.md

@@ -277,7 +277,8 @@ kubectl [flags]
       <td colspan="2">--log-flush-frequency duration&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;默认值：5s</td>
     </tr>
     <tr>
-      <td></td><td style="line-height: 130%; word-wrap: break-word;">
+      <td></td>
+      <td style="line-height: 130%; word-wrap: break-word;">
       <!--
       Maximum number of seconds between log flushes
       -->
@@ -288,7 +289,8 @@ kubectl [flags]
       <td colspan="2">--logtostderr&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;默认值：true</td>
     </tr>
     <tr>
-      <td></td><td style="line-height: 130%; word-wrap: break-word;">
+      <td></td>
+      <td style="line-height: 130%; word-wrap: break-word;">
       <!--
       log to standard error instead of files
       -->
@@ -299,7 +301,8 @@ kubectl [flags]
       <td colspan="2">--match-server-version</td>
     </tr>
     <tr>
-      <td></td><td style="line-height: 130%; word-wrap: break-word;">
+      <td></td>
+      <td style="line-height: 130%; word-wrap: break-word;">
       <!--
       Require server version to match client version
       -->
@@ -310,7 +313,8 @@ kubectl [flags]
       <td colspan="2">-n, --namespace string</td>
     </tr>
     <tr>
-      <td></td><td style="line-height: 130%; word-wrap: break-word;">
+      <td></td>
+      <td style="line-height: 130%; word-wrap: break-word;">
       <!--
       If present, the namespace scope for this CLI request
       -->
@@ -320,7 +324,8 @@ kubectl [flags]
       <td colspan="2">--one-output</td>
     </tr>
     <tr>
-      <td></td><td style="line-height: 130%; word-wrap: break-word;">
+      <td></td>
+      <td style="line-height: 130%; word-wrap: break-word;">
       <!--
       If true, only write logs to their native severity level (vs also writing to each lower severity level)
       -->
@@ -332,7 +337,8 @@ kubectl [flags]
       <td colspan="2">--password string</td>
     </tr>
     <tr>
-      <td></td><td style="line-height: 130%; word-wrap: break-word;">
+      <td></td>
+      <td style="line-height: 130%; word-wrap: break-word;">
       <!--
       Password for basic authentication to the API server
       -->
@@ -343,7 +349,8 @@ kubectl [flags]
       <td colspan="2">--profile string&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;默认值："none"</td>
     </tr>
     <tr>
-      <td></td><td style="line-height: 130%; word-wrap: break-word;">
+      <td></td>
+      <td style="line-height: 130%; word-wrap: break-word;">
       <!--
       Name of profile to capture. One of (none|cpu|heap|goroutine|threadcreate|block|mutex)
       -->
@@ -354,7 +361,8 @@ kubectl [flags]
       <td colspan="2">--profile-output string&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;默认值："profile.pprof"</td>
     </tr>
     <tr>
-      <td></td><td style="line-height: 130%; word-wrap: break-word;">
+      <td></td>
+      <td style="line-height: 130%; word-wrap: break-word;">
       <!--
       Name of the file to write the profile to
       -->
@@ -365,18 +373,21 @@ kubectl [flags]
       <td colspan="2">--request-timeout string&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;默认值："0"</td>
     </tr>
     <tr>
-      <td></td><td style="line-height: 130%; word-wrap: break-word;">
+      <td></td>
+      <td style="line-height: 130%; word-wrap: break-word;">
       <!--
       The length of time to wait before giving up on a single server request. Non-zero values should contain a corresponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't timeout requests.
       -->
-      放弃单个服务器请求之前的等待时间，非零值需要包含相应时间单位（例如：1s、2m、3h）。零值则表示不做超时要求。
+      放弃单个服务器请求之前的等待时间，非零值需要包含相应时间单位（例如：1s、2m、3h）。
+      零值则表示不做超时要求。
       </td>
     </tr>
     <tr>
       <td colspan="2">-s, --server string</td>
     </tr>
     <tr>
-      <td></td><td style="line-height: 130%; word-wrap: break-word;">
+      <td></td>
+      <td style="line-height: 130%; word-wrap: break-word;">
       <!--
       The address and port of the Kubernetes API server
       -->
@@ -387,7 +398,8 @@ kubectl [flags]
       <td colspan="2">--skip-headers</td>
     </tr>
     <tr>
-      <td></td><td style="line-height: 130%; word-wrap: break-word;">
+      <td></td>
+      <td style="line-height: 130%; word-wrap: break-word;">
       <!--
       If true, avoid header prefixes in the log messages
       -->
@@ -398,7 +410,8 @@ kubectl [flags]
       <td colspan="2">--skip-log-headers</td>
     </tr>
     <tr>
-      <td></td><td style="line-height: 130%; word-wrap: break-word;">
+      <td></td>
+      <td style="line-height: 130%; word-wrap: break-word;">
       <!--
       If true, avoid headers when opening log files
       -->
@@ -409,7 +422,8 @@ kubectl [flags]
       <td colspan="2">--stderrthreshold severity&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;默认值：2</td>
     </tr>
     <tr>
-      <td></td><td style="line-height: 130%; word-wrap: break-word;">
+      <td></td>
+      <td style="line-height: 130%; word-wrap: break-word;">
       <!--
       logs at or above this threshold go to stderr
       -->
@@ -420,7 +434,8 @@ kubectl [flags]
       <td colspan="2">--token string</td>
     </tr>
     <tr>
-      <td></td><td style="line-height: 130%; word-wrap: break-word;">
+      <td></td>
+      <td style="line-height: 130%; word-wrap: break-word;">
       <!--
       Bearer token for authentication to the API server
       -->
@@ -431,7 +446,8 @@ kubectl [flags]
       <td colspan="2">--user string</td>
     </tr>
     <tr>
-      <td></td><td style="line-height: 130%; word-wrap: break-word;">
+      <td></td>
+      <td style="line-height: 130%; word-wrap: break-word;">
       <!--
       The name of the kubeconfig user to use
       -->
@@ -453,7 +469,8 @@ kubectl [flags]
       <td colspan="2">-v, --v Level</td>
     </tr>
     <tr>
-      <td></td><td style="line-height: 130%; word-wrap: break-word;">
+      <td></td>
+      <td style="line-height: 130%; word-wrap: break-word;">
       <!--
       number for the log level verbosity
       -->
@@ -464,7 +481,8 @@ kubectl [flags]
       <td colspan="2">--version version[=true]</td>
     </tr>
     <tr>
-      <td></td><td style="line-height: 130%; word-wrap: break-word;">
+      <td></td>
+      <td style="line-height: 130%; word-wrap: break-word;">
       <!--
       Print version information and quit
       -->
@@ -475,7 +493,8 @@ kubectl [flags]
       <td colspan="2">--vmodule moduleSpec</td>
     </tr>
     <tr>
-      <td></td><td style="line-height: 130%; word-wrap: break-word;">
+      <td></td>
+      <td style="line-height: 130%; word-wrap: break-word;">
       <!--
       comma-separated list of pattern=N settings for file-filtered logging
       -->
@@ -498,7 +517,8 @@ kubectl [flags]
 <td colspan="2">KUBECONFIG</td>
 </tr>
 <tr>
-<td></td><td style="line-height: 130%; word-wrap: break-word;">
+<td></td>
+<td style="line-height: 130%; word-wrap: break-word;">
 <!--
 Path to the kubectl configuration ("kubeconfig") file. Default: "$HOME/.kube/config"
 -->
@@ -510,49 +530,54 @@ kubectl 的配置 ("kubeconfig") 文件的路径。默认值："$HOME/.kube/conf
 <td colspan="2">KUBECTL_COMMAND_HEADERS</td>
 </tr>
 <tr>
-<td></td><td style="line-height: 130%; word-wrap: break-word;">
+<td></td>
+<td style="line-height: 130%; word-wrap: break-word;">
 <!--
 When set to false, turns off extra HTTP headers detailing invoked kubectl command (Kubernetes version v1.22 or later)
 -->
-设置为 false 时，将关闭额外的 HTTP 标头，不再详细说明被调用的 kubectl 命令（此变量适用于 Kubernetes v1.22 或更高版本）
+设置为 false 时，将关闭额外的 HTTP 标头，不再详细说明被调用的 kubectl
+命令（此变量适用于 Kubernetes v1.22 或更高版本）
 </td>
 </tr>
 
 <tr>
 <td colspan="2">KUBECTL_EXPLAIN_OPENAPIV3</td>
 </tr>
 <tr>
-<td></td><td style="line-height: 130%; word-wrap: break-word;">
+<td></td>
+<td style="line-height: 130%; word-wrap: break-word;">
 <!--
 Toggles whether calls to `kubectl explain` use the new OpenAPIv3 data source available. OpenAPIV3 is enabled by default since Kubernetes 1.24.
 -->
-切换对 `kubectl explain` 的调用是否使用可用的新 OpenAPIv3 数据源。OpenAPIV3 自 Kubernetes 1.24 起默认被启用。
+切换对 <code>kubectl explain</code> 的调用是否使用可用的新 OpenAPIv3 数据源。OpenAPIV3 自 Kubernetes 1.24 起默认被启用。
 </td>
 </tr>
 
 <tr>
 <td colspan="2">KUBECTL_ENABLE_CMD_SHADOW</td>
 </tr>
 <tr>
-<td></td><td style="line-height: 130%; word-wrap: break-word;">
+<td></td>
+<td style="line-height: 130%; word-wrap: break-word;">
 <!--
 When set to true, external plugins can be used as subcommands for builtin commands if subcommand does not exist. In alpha stage, this feature can only be used for create command(e.g. kubectl create networkpolicy).
 -->
 当设置为 true 时，如果子命令不存在，外部插件可以用作内置命令的子命令。
-此功能处于 alpha 阶段，只能用于 create 命令（例如 kubectl create networkpolicy）。
+此功能处于 alpha 阶段，只能用于 create 命令（例如 <code>kubectl create networkpolicy</code>）。
 </td>
 </tr>
 
 <tr>
 <td colspan="2">KUBECTL_PORT_FORWARD_WEBSOCKETS</td>
 </tr>
 <tr>
-<td></td><td style="line-height: 130%; word-wrap: break-word;">
+<td></td>
+<td style="line-height: 130%; word-wrap: break-word;">
 <!--
 When set to true, the kubectl port-forward command will attempt to stream using the websockets protocol.
 If the upgrade to websockets fails, the commands will fallback to use the current SPDY protocol.
 -->
-当设置为 true 时，`kubectl port-forward` 命令将尝试使用 WebSocket 协议进行流式传输。
+当设置为 true 时，<code>kubectl port-forward</code> 命令将尝试使用 WebSocket 协议进行流式传输。
 如果升级到 WebSocket 失败，命令将回退到使用当前的 SPDY 协议。
 </td>
 </tr>
@@ -561,7 +586,8 @@ If the upgrade to websockets fails, the commands will fallback to use the curren
 <td colspan="2">KUBECTL_REMOTE_COMMAND_WEBSOCKETS</td>
 </tr>
 <tr>
-<td></td><td style="line-height: 130%; word-wrap: break-word;">
+<td></td>
+<td style="line-height: 130%; word-wrap: break-word;">
 <!--
 When set to true, the kubectl exec, cp, and attach commands will attempt to stream using the websockets protocol. If the upgrade to websockets fails, the commands will fallback to use the current SPDY protocol.
 -->
@@ -574,14 +600,28 @@ When set to true, the kubectl exec, cp, and attach commands will attempt to stre
 <td colspan="2">KUBECTL_KUBERC</td>
 </tr>
 <tr>
-<td></td><td style="line-height: 130%; word-wrap: break-word;">
+<td></td>
+<td style="line-height: 130%; word-wrap: break-word;">
 <!--
 When set to true, kuberc file is taken into account to define user specific preferences.
 -->
 当设置为 true 时，kuberc 文件会被纳入考虑，用于定义用户特定偏好设置。
 </td>
 </tr>
 
+<tr>
+<td colspan="2">KUBECTL_KYAML</td>
+</tr>
+<tr>
+<td></td>
+<td style="line-height: 130%; word-wrap: break-word;">
+<!--
+When set to true, kubectl is capable of producing Kubernetes-specific dialect of YAML output format.
+-->
+当设置为 true 时，kubectl 可以生成 Kubernetes 特定的 YAML 输出格式。
+</td>
+</tr>
+
 </tbody>
 </table>