[zh] Sync changes to kubeadm reference

This PR syncs changes made to kubeadm reference in 1.20.
This commit is contained in:
Qiming Teng
2020-12-14 16:10:04 +08:00
parent fa83273ca5
commit e944fb1476
10 changed files with 623 additions and 499 deletions
@@ -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;">
@@ -45,52 +45,6 @@ kubeadm alpha kubeconfig user --client-name=foo
</colgroup>
<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>
</tr>
<tr>
<td></td><td style="line-height: 130%; word-wrap: break-word;">
<!--
The path where certificates are stored
-->
证书存储的路径
</td>
</tr>
<tr>
<td colspan="2">--client-name string</td>
</tr>
@@ -99,7 +53,19 @@ The path where certificates are stored
<!--
The name of user. It will be used as the CN if client certificates are created
-->
用户名。如果创建了客户端证书,它将用作 CN。
用户名。如果生成客户端证书,用作 CN。
</td>
</tr>
<tr>
<td colspan="2">--config string</td>
</tr>
<tr>
<td></td><td style="line-height: 130%; word-wrap: break-word;">
<!--
Path to a kubeadm configuration file.
-->
指向 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;">
@@ -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>
@@ -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>
@@ -2,13 +2,11 @@
<!--
### Synopsis
-->
### 概要
<!--
Generates the kube-controller-manager static Pod manifest
-->
生成 kube-controller-manager 静态 Pod 清单
```
@@ -18,7 +16,6 @@ kubeadm init phase control-plane controller-manager [flags]
<!--
### Options
-->
### 选项
<table style="width: 100%; table-layout: fixed;">
@@ -29,12 +26,8 @@ kubeadm init phase control-plane controller-manager [flags]
<tbody>
<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">--cert-dir string&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Default: "/etc/kubernetes/pki"</td -->
<td colspan="2">--cert-dir string&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;默认值:"/etc/kubernetes/pki"</td>
</tr>
<tr>
<td></td><td style="line-height: 130%; word-wrap: break-word;">
@@ -65,7 +58,20 @@ kubeadm 配置文件的路径。
<!--
A set of extra flags to pass to the Controller Manager or override default ones in form of &lt;flagname&gt;=&lt;value&gt;
-->
一组额外的参数以 &lt;flagname&gt;=&lt; 形式传递给 Controller Manager 或者覆盖默认参数
一组 &lt;flagname&gt;=&lt; 形式的额外参数,传递给控制器管理器(Controller Manager
或者覆盖其默认配置值
</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>
@@ -123,7 +129,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>
@@ -133,7 +139,6 @@ Specify range of IP addresses for the pod network. If set, the control plane wil
<!--
### Options inherited from parent commands
-->
### 从父命令继承的选项
<table style="width: 100%; table-layout: fixed;">
@@ -2,13 +2,11 @@
<!--
### Synopsis
-->
### 概要
<!--
Generates the kube-scheduler static Pod manifest
-->
生成 kube-scheduler 静态 Pod 清单
```
@@ -18,7 +16,6 @@ kubeadm init phase control-plane scheduler [flags]
<!--
### Options
-->
### 选项
<table style="width: 100%; table-layout: fixed;">
@@ -57,6 +54,22 @@ kubeadm 配置文件的路径。
</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>
<tr>
<td colspan="2">-h, --help</td>
</tr>
@@ -111,7 +124,8 @@ Choose a specific Kubernetes version for the control plane.
<!--
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 或者覆盖默认参数
一组 &lt;flagname&gt;=&lt;value&gt; 形式的额外参数,用来传递给调度器
或者覆盖其默认参数配置
</td>
</tr>
@@ -121,7 +135,6 @@ A set of extra flags to pass to the Scheduler or override default ones in form o
<!--
### Options inherited from parent commands
-->
### 继承于父命令的选项
<table style="width: 100%; table-layout: fixed;">
@@ -2,13 +2,11 @@
<!--
### Synopsis
-->
### 概要
<!--
This command is not meant to be run on its own. See list of available subcommands.
-->
此命令并非设计用来单独运行。请参阅可用子命令列表。
```
@@ -18,7 +16,6 @@ kubeadm init phase upload-certs [flags]
<!--
### Options
-->
### 选项
<table style="width: 100%; table-layout: fixed;">
@@ -64,6 +61,18 @@ upload-certs 操作的帮助命令
</td>
</tr>
<tr>
<!-- td colspan="2">--kubeconfig string&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Default: "/etc/kubernetes/admin.conf"</td -->
<td colspan="2">--kubeconfig string&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;默认值:"/etc/kubernetes/admin.conf"</td>
</tr>
<tr>
<!-- td></td><td style="line-height: 130%; word-wrap: break-word;">The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations can be searched for an existing kubeconfig file.</td -->
<td></td><td style="line-height: 130%; word-wrap: break-word;">
用来与集群通信的 kubeconfig 文件。
如果此标志未设置,则可以在一组标准的位置搜索现有的 kubeconfig 文件。
</td>
</tr>
<tr>
<td colspan="2">--skip-certificate-key-print</td>
</tr>
@@ -94,7 +103,6 @@ Upload control-plane certificates to the kubeadm-certs Secret.
<!--
### Options inherited from parent commands
-->
### 从父命令继承的选项
<table style="width: 100%; table-layout: fixed;">