Merge pull request #25607 from tengqm/zh-sync-ref-kubeadm

[zh] Sync changes to kubeadm reference

Author: k8s-ci-robot

content/zh/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_kubeconfig_user.md

@@ -2,19 +2,16 @@
 <!--
 ### Synopsis
 -->
-
 ### 概要
 
 <!--
 Output a kubeconfig file for an additional user.
 -->
-
 为其他用户输出 kubeconfig 文件。
 
 <!--
 Alpha Disclaimer: this command is currently alpha.
 -->
-
 Alpha 免责声明：此命令当前为 Alpha 功能。
 
 ```
@@ -23,19 +20,22 @@ kubeadm alpha kubeconfig user [flags]
 
 <!--
 ### Examples # Output a kubeconfig file for an additional user named foo
--->
 
+```
+  # Output a kubeconfig file for an additional user named foo using a kubeadm config file bar
+  kubeadm alpha kubeconfig user --client-name=foo --config=bar
+```
+-->
 ### 示例
 
 ```
-# 为名为 foo 的其他用户输出 kubeconfig 文件
-kubeadm alpha kubeconfig user --client-name=foo
+# 使用名为 bar 的 kubeadm 配置文件为名为 foo 的另一用户输出 kubeconfig 文件
+kubeadm alpha kubeconfig user --client-name=foo --config=bar
 ```
 
 <!--
 ### Options
 -->
-
 ### 选项
 
    <table style="width: 100%; table-layout: fixed;">
@@ -46,60 +46,26 @@ kubeadm alpha kubeconfig user --client-name=foo
 <tbody>
 
 <tr>
-<td colspan="2">--apiserver-advertise-address string</td>
-</tr>
-<tr>
-<td></td><td style="line-height: 130%; word-wrap: break-word;">
-<!--
-The IP address the API server is accessible on
--->
-可通过以下网址访问 API 服务器的 IP 地址
-</td>
-</tr>
-
-<tr>
-<td colspan="2">
-<!--
---apiserver-bind-port int32&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Default: 6443
--->
---apiserver-bind-port int32&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;默认值: 6443
-</td>
-</tr>
-<tr>
-<td></td><td style="line-height: 130%; word-wrap: break-word;">
-<!--
-The port the API server is accessible on
--->
-可通过其访问 API 服务器的端口
-</td>
-</tr>
-
-<tr>
-<td colspan="2">
-<!--
---cert-dir string&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Default: "/etc/kubernetes/pki"
--->
---cert-dir string&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;默认值: "/etc/kubernetes/pki"
-</td>
+<td colspan="2">--client-name string</td>
 </tr>
 <tr>
 <td></td><td style="line-height: 130%; word-wrap: break-word;">
 <!--
-The path where certificates are stored
+The name of user. It will be used as the CN if client certificates are created
 -->
-证书存储的路径
+用户名。如果生成客户端证书，则用作其 CN。
 </td>
 </tr>
 
 <tr>
-<td colspan="2">--client-name string</td>
+<td colspan="2">--config string</td>
 </tr>
 <tr>
 <td></td><td style="line-height: 130%; word-wrap: break-word;">
 <!--
-The name of user. It will be used as the CN if client certificates are created
+Path to a kubeadm configuration file.
 -->
-用户名。如果创建了客户端证书，它将用作 CN。
+指向 kubeadm 配置文件的路径
 </td>
 </tr>
 
@@ -123,13 +89,14 @@ user 操作的帮助命令
 <!--
 The orgnizations of the client certificate. It will be used as the O if client certificates are created
 -->
-客户端证书的组织。如果创建了客户端证书，它将用作 O。
+客户端证书的组织。如果创建客户端证书，此值将用作其 O 字段值。
 </td>
 </tr>
 
 <tr>
 <td colspan="2">--token string</td>
 </tr>
+
 <tr>
 <td></td><td style="line-height: 130%; word-wrap: break-word;">
 <!--
@@ -145,7 +112,6 @@ The token that should be used as the authentication mechanism for this kubeconfi
 <!--
 ### Options inherited from parent commands
 -->
-
 ### 从父命令继承的选项
 
    <table style="width: 100%; table-layout: fixed;">

content/zh/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_control-plane_all.md

@@ -2,13 +2,11 @@
 <!--
 ### Synopsis
 -->
-
 ### 概要
 
 <!--
 Generate all static Pod manifest files
 -->
-
 生成所有的静态 Pod 清单文件
 
 ```
@@ -17,27 +15,27 @@ kubeadm init phase control-plane all [flags]
 
 <!--
 ### Examples
--->
-<!--
+
+
+```
 # Generates all static Pod manifest files for control plane components,
 # functionally equivalent to what is generated by kubeadm init.
 # Generates all static Pod manifest files using options read from a configuration file.
+```
 -->
-
 ### 示例
 
 ```
-# 为 etcd 生成静态 Pod 清单文件，其功能等效于 kubeadm init 生成的文件。
+# 为控制平面组件生成静态 Pod 清单文件，其功能等效于 kubeadm init 生成的文件。
 kubeadm init phase control-plane all
 
-# 使用从配置文件读取的选项为 etcd 生成静态 Pod 清单文件。
+# 使用从某配置文件中读取的选项为生成静态 Pod 清单文件。
 kubeadm init phase control-plane all --config config.yaml
 ```
 
 <!--
 ### Options
 -->
-
 ### 选项
 
    <table style="width: 100%; table-layout: fixed;">
@@ -60,19 +58,15 @@ API 服务器所公布的其正在监听的 IP 地址。如果未设置，将使
 </tr>
 
 <tr>
-<td colspan="2">
-<!--
---apiserver-bind-port int32&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Default: 6443
--->
---apiserver-bind-port int32&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;默认值：6443
-</td>
+<!-- td colspan="2">--apiserver-bind-port int32&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Default: 6443</td -->
+<td colspan="2">--apiserver-bind-port int32&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;默认值：6443</td>
 </tr>
 <tr>
 <td></td><td style="line-height: 130%; word-wrap: break-word;">
 <!--
 Port for the API Server to bind to.
 -->
-要绑定到 API 服务器的端口。
+API 服务器要绑定的端口。
 </td>
 </tr>
 
@@ -84,7 +78,8 @@ Port for the API Server to bind to.
 <!--
 A set of extra flags to pass to the API Server or override default ones in form of &lt;flagname&gt;=&lt;value&gt;
 -->
-传递给 API 服务器一组额外的参数或者以 &lt;flagname&gt;=&lt;value&gt; 的形式覆盖默认值。
+形式为 &lt;flagname&gt;=&lt;value&gt; 的一组额外参数，用来传递给 API 服务器，
+或者覆盖其默认配置值
 </td>
 </tr>
 
@@ -137,7 +132,25 @@ Specify a stable IP address or DNS name for the control plane.
 <!--
 A set of extra flags to pass to the Controller Manager or override default ones in form of &lt;flagname&gt;=&lt;value&gt;
 -->
-传递给控制管理器（Controller Manager）一组额外的标志或者以 &lt;flagname&gt;=&lt;value&gt; 的形式覆盖默认值。
+一组形式为 &lt;flagname&gt;=&lt;value&gt; 的额外参数，用来传递给控制管理器（Controller Manager）
+或覆盖其默认设置值
+</td>
+</tr>
+
+<tr>
+<td colspan="2">--experimental-patches string</td>
+</tr>
+<tr>
+<td></td><td style="line-height: 130%; word-wrap: break-word;">
+<!--
+Path to a directory that contains files named "target[suffix][+patchtype].extension". For example, "kube-apiserver0+merge.yaml" or just "etcd.json". "patchtype" can be one of "strategic", "merge" or "json" and they match the patch formats supported by kubectl. The default "patchtype" is "strategic". "extension" must be either "json" or "yaml". "suffix" is an optional string that can be used to determine which patches are applied first alpha-numerically.
+-->
+包含名为 "target[suffix][+patchtype].extension" 的文件的目录。
+例如，"kube-apiserver0+merge.yaml" 或者 "etcd.json"。
+"patchtype" 可以是 "strategic"、"merge" 或 "json" 之一，分别与 kubectl
+所支持的 patch 格式相匹配。默认的 "patchtype" 是 "strategic"。
+"extension" 必须是 "json" 或 "yaml"。
+"suffix" 是一个可选的字符串，用来确定按字母顺序排序时首先应用哪些 patch。
 </td>
 </tr>
 
@@ -149,7 +162,7 @@ A set of extra flags to pass to the Controller Manager or override default ones
 <!--
 A set of key=value pairs that describe feature gates for various features. Options are:<br/>IPv6DualStack=true|false (ALPHA - default=false)<br/>PublicKeysECDSA=true|false (ALPHA - default=false)
 -->
-一组用来描述各种功能特性的键值（key=value）对。选项是：
+一组用来描述各种特性门控的键值（key=value）对。选项是：
 <br/>IPv6DualStack=true|false (ALPHA - 默认=false)
 <br/>PublicKeysECDSA=true|false (ALPHA - 默认=false)
 </td>
@@ -209,7 +222,7 @@ Choose a specific Kubernetes version for the control plane.
 <!--
 Specify range of IP addresses for the pod network. If set, the control plane will automatically allocate CIDRs for every node.
 -->
-指定 Pod 网络的 IP 地址范围。如果已设置，控制平面将自动地为每个节点分配 CIDR。
+指定 Pod 网络的 IP 地址范围。如果设置了此标志，控制平面将自动地为每个节点分配 CIDR。
 </td>
 </tr>
 
@@ -221,6 +234,9 @@ Specify range of IP addresses for the pod network. If set, the control plane wil
 <!--
 A set of extra flags to pass to the Scheduler or override default ones in form of &lt;flagname&gt;=&lt;value&gt;
 -->
+一组形式为 &lt;flagname&gt;=&lt;value&gt; 的额外参数，用来传递给调度器（Scheduler）
+或覆盖其默认设置值
+
 传递给调度器（scheduler）一组额外的参数或者以 &lt;flagname&gt;=&lt;value&gt; 形式覆盖其默认值。
 </td>
 </tr>
@@ -248,7 +264,6 @@ Use alternative range of IP address for service VIPs.
 <!--
 ### Options inherited from parent commands
 -->
-
 ### 从父指令继承的选项
 
    <table style="width: 100%; table-layout: fixed;">
@@ -272,3 +287,4 @@ Use alternative range of IP address for service VIPs.
 
 </tbody>
 </table>
+

content/zh/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_control-plane_apiserver.md

@@ -1,13 +1,11 @@
 <!-- 
 ### Synopsis 
 -->
-
 ### 概要
 
 <!-- 
 Generates the kube-apiserver static Pod manifest 
 -->
-
 生成 kube-apiserver 静态 Pod 清单
 
 ```
@@ -17,7 +15,6 @@ kubeadm init phase control-plane apiserver [flags]
 <!-- 
 ### Options 
 -->
-
 ### 选项
 
    <table style="width: 100%; table-layout: fixed;">
@@ -64,7 +61,8 @@ Port for the API Server to bind to.
 <!--
 A set of extra flags to pass to the API Server or override default ones in form of &lt;flagname&gt;=&lt;value&gt;
 -->
-一组额外的参数以 &lt;flagname&gt;=&lt;value&gt; 形式传递给 API 服务器或者覆盖默认参数
+一组 &lt;flagname&gt;=&lt;value&gt; 形式的额外参数，用来传递给 API 服务器
+或者覆盖其默认参数配置
 </td>
 </tr>
 
@@ -109,6 +107,18 @@ Specify a stable IP address or DNS name for the control plane.
 </td>
 </tr>
 
+<tr>
+<td></td><td style="line-height: 130%; word-wrap: break-word;">
+<!--Path to a directory that contains files named "target[suffix][+patchtype].extension". For example, "kube-apiserver0+merge.yaml" or just "etcd.json". "patchtype" can be one of "strategic", "merge" or "json" and they match the patch formats supported by kubectl. The default "patchtype" is "strategic". "extension" must be either "json" or "yaml". "suffix" is an optional string that can be used to determine which patches are applied first alpha-numerically.-->
+包含名为 "target[suffix][+patchtype].extension" 的文件的目录。
+例如，"kube-apiserver0+merge.yaml" 或者 "etcd.json"。
+"patchtype" 可以是 "strategic"、"merge" 或 "json" 之一，分别与 kubectl
+所支持的 patch 格式相匹配。默认的 "patchtype" 是 "strategic"。
+"extension" 必须是 "json" 或 "yaml"。
+"suffix" 是一个可选的字符串，用来确定按字母顺序排序时首先应用哪些 patch。
+</td>
+</tr>
+
 <tr>
 <td colspan="2">--feature-gates string</td>
 </tr>
@@ -117,7 +127,7 @@ Specify a stable IP address or DNS name for the control plane.
 <!--
 A set of key=value pairs that describe feature gates for various features. Options are:<br/>IPv6DualStack=true|false (ALPHA - default=false)<br/>PublicKeysECDSA=true|false (ALPHA - default=false)
 -->
-一组键值对，用于描述各种特征的特征事项。选项是：
+一组键值对，用于描述各种功能特性的特性门控。选项是：
 <br/>IPv6DualStack=true|false (ALPHA - 默认=false)
 <br/>PublicKeysECDSA=true|false (ALPHA - 默认=false)
 </td>