kubernetes
/
website
mirror of https://github.com/kubernetes/website.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

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

[zh] Sync changes to kubeadm reference
This commit is contained in:
Kubernetes Prow Robot 2020-12-19 04:38:25 -08:00 committed by GitHub
parent 5bba8bf55a e944fb1476
commit 2b0f838af7
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
10 changed files with 623 additions and 424 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -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;">

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

@ -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>

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

@ -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>

29
content/zh/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_control-plane_controller-manager.md
View File

@ -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;">

23
content/zh/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_control-plane_scheduler.md
View File

@ -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;">

16
content/zh/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_upload-certs.md
View File

@ -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;">

725
content/zh/docs/reference/setup-tools/kubeadm/implementation-details.md
View File

File diff suppressed because it is too large Load Diff

24
content/zh/docs/reference/setup-tools/kubeadm/kubeadm-alpha.md
View File

@ -4,11 +4,6 @@ content_type: concept
weight: 90
---
<!--
reviewers:
- mikedanese
- luxas
- jbeda
title: kubeadm alpha
content_type: concept
weight: 90
@ -19,8 +14,8 @@ weight: 90
`kubeadm alpha` provides a preview of a set of features made available for gathering feedback
from the community. Please try it out and give us feedback!
-->
`kubeadm alpha` 提供了一组可用于收集社区反馈的功能的预览。
请尝试一下这些功能并给我们反馈！
`kubeadm alpha` 提供了一组可用于收集社区反馈的预览性质功能。
请试用这些功能并给我们提供反馈！
{{< /caution >}}
## kubeadm alpha kubeconfig user {#cmd-phase-kubeconfig}
@ -47,7 +42,6 @@ Use the following command to enable the DynamicKubeletConfiguration feature.
{{< tab name="enable-dynamic" include="generated/kubeadm_alpha_kubelet_config_enable-dynamic.md" />}}
{{< /tabs >}}
## kubeadm alpha selfhosting pivot {#cmd-selfhosting}
<!--
@ -61,7 +55,6 @@ The subcommand `pivot` can be used to convert a static Pod-hosted control plane
[Documentation](/docs/setup/production-environment/tools/kubeadm/self-hosting/)
-->
{{< tabs name="selfhosting" >}}
{{< tab name="selfhosting" include="generated/kubeadm_alpha_selfhosting.md" />}}
{{< tab name="pivot" include="generated/kubeadm_alpha_selfhosting_pivot.md" />}}
@ -74,6 +67,13 @@ The subcommand `pivot` can be used to convert a static Pod-hosted control plane
* [kubeadm join](/docs/reference/setup-tools/kubeadm/kubeadm-join/) to connect a node to the cluster
* [kubeadm reset](/docs/reference/setup-tools/kubeadm/kubeadm-reset/) to revert any changes made to this host by `kubeadm init` or `kubeadm join`
-->
* [kubeadm init](/zh/docs/reference/setup-tools/kubeadm/kubeadm-init/) 引导 Kubernetes 控制平面节点
* [kubeadm join](/zh/docs/reference/setup-tools/kubeadm/kubeadm-join/) 将节点连接到集群
* [kubeadm reset](/zh/docs/reference/setup-tools/kubeadm/kubeadm-reset/) 会还原 `kubeadm init` 或 `kubeadm join` 操作对主机所做的任何更改。
* 用来启动引导 Kubernetes 控制平面节点的
[kubeadm init](/zh/docs/reference/setup-tools/kubeadm/kubeadm-init/)
命令
* 用来将节点连接到集群的
[kubeadm join](/zh/docs/reference/setup-tools/kubeadm/kubeadm-join/)
命令
* 用来还原 `kubeadm init` 或 `kubeadm join` 操作对主机所做的任何更改的
[kubeadm reset](/zh/docs/reference/setup-tools/kubeadm/kubeadm-reset/)
命令

58
content/zh/docs/reference/setup-tools/kubeadm/kubeadm-init.md
View File

@ -6,7 +6,6 @@ weight: 20
<!--
reviewers:
- mikedanese
- luxas
- jbeda
title: kubeadm init
@ -20,7 +19,6 @@ This command initializes a Kubernetes control-plane node.
-->
此命令初始化一个 Kubernetes 控制平面节点。
<!-- body -->
{{< include "generated/kubeadm_init.md" >}}
@ -44,7 +42,7 @@ following steps:
-->
1. 在做出变更前运行一系列的预检项来验证系统状态。一些检查项目仅仅触发警告，
其它的则会被视为错误并且退出 kubeadm，除非问题得到解决或者用户指定了
`--ignore-preflight-errors=<list-of-errors>` 参数。
`--ignore-preflight-errors=<错误列表>` 参数。
<!--
1. Generates a self-signed CA to set up identities for each component in the cluster. The user can provide their
@ -98,7 +96,7 @@ following steps:
[kubeadm token](/docs/reference/setup-tools/kubeadm/kubeadm-token/) docs.
-->
6. 生成令牌，将来其他节点可使用该令牌向控制平面注册自己。
如文档 [kubeadm token](/zh/docs/reference/setup-tools/kubeadm/kubeadm-token/) 所述，
如 [kubeadm token](/zh/docs/reference/setup-tools/kubeadm/kubeadm-token/) 文档所述，
用户可以选择通过 `--token` 提供令牌。
<!--
@ -120,13 +118,13 @@ following steps:
和 [TLS 启动引导](/zh/docs/reference/command-line-tools-reference/kubelet-tls-bootstrapping/)
这两份文档中描述的机制加入到集群中，kubeadm 会执行所有的必要配置：
- 创建一份 ConfigMap 提供添加集群节点所需的信息，并为该 ConfigMap 设置相关的 RBAC 访问规则。
- 创建一个 ConfigMap 提供添加集群节点所需的信息，并为该 ConfigMap 设置相关的 RBAC 访问规则。
- 使得 Bootstrap Tokens 可以访问 CSR 签名 API。
- 允许启动引导令牌访问 CSR 签名 API。
- 配置自动签发新的 CSR 请求。
获取更多信息，请查看[kubeadm join](/zh/docs/reference/setup-tools/kubeadm/kubeadm-join/)。
更多相关信息，请查看 [kubeadm join](/zh/docs/reference/setup-tools/kubeadm/kubeadm-join/)。
<!--
1. Installs a DNS server (CoreDNS) and the kube-proxy addon components via the API server.
@ -151,12 +149,11 @@ following steps:
<!--
### Using init phases with kubeadm {#init-phases}
Kubeadm allows you to create a control-plane node in phases using the `kubeadm init phase` command.
-->
### 在 kubeadm 中使用 init phases {#init-phases}
<!--
Kubeadm allows you to create a control-plane node in phases using the `kubeadm init phase` command.
-->
Kubeadm 允许你使用 `kubeadm init phase` 命令分阶段创建控制平面节点。
<!--
@ -249,15 +246,17 @@ the [kubeadm config migrate](/docs/reference/setup-tools/kubeadm/kubeadm-config/
For more information on the fields and usage of the configuration you can navigate to our API reference
page and pick a version from [the list](https://godoc.org/k8s.io/kubernetes/cmd/kubeadm/app/apis/kubeadm#pkg-subdirectories).
-->
可以使用 [kubeadm config print](/zh/docs/reference/setup-tools/kubeadm/kubeadm-config/)命令打印出默认配置。
可以使用 [kubeadm config print](/zh/docs/reference/setup-tools/kubeadm/kubeadm-config/)
命令打印出默认配置。
如果你的配置没有使用最新版本，
**推荐**使用 [kubeadm config migrate](/zh/docs/reference/setup-tools/kubeadm/kubeadm-config/)
命令进行迁移。
有关配置的字段和用法的更多信息，
你可以导航到我们的 API 参考页面并从
[列表](https://godoc.org/k8s.io/kubernetes/cmd/kubeadm/app/apis/kubeadm#pkg-subdirectories)中选择一个版本。
你可以访问 API 参考页面并从
[列表](https://godoc.org/k8s.io/kubernetes/cmd/kubeadm/app/apis/kubeadm#pkg-subdirectories)
中选择一个版本。
<!--
### Adding kube-proxy parameters {#kube-proxy}
@ -367,7 +366,7 @@ The following command can be used to generate a new key on demand:
以下命令可用于按需生成新密钥：
```shell
kubeadm alpha certs certificate-key
kubeadm certs certificate-key
```
<!-- ### Certificate management with kubeadm -->
@ -379,7 +378,8 @@ For detailed information on certificate management with kubeadm see
The document includes information about using external CA, custom certificates
and certificate renewal.
-->
有关使用 kubeadm 进行证书管理的详细信息，请参阅[使用 kubeadm 进行证书管理](/zh/docs/tasks/administer-cluster/kubeadm/kubeadm-certs/)。
有关使用 kubeadm 进行证书管理的详细信息，请参阅
[使用 kubeadm 进行证书管理](/zh/docs/tasks/administer-cluster/kubeadm/kubeadm-certs/)。
该文档包括有关使用外部 CA，自定义证书和证书更新的信息。
<!--
@ -450,7 +450,8 @@ kubeadm config images pull
<!--
All images that kubeadm requires such as `k8s.gcr.io/kube-*`, `k8s.gcr.io/etcd` and `k8s.gcr.io/pause` support multiple architectures.
-->
kubeadm 需要的所有镜像，例如 `k8s.gcr.io/kube-*`、`k8s.gcr.io/etcd` 和 `k8s.gcr.io/pause` 都支持多种架构。
kubeadm 需要的所有镜像，例如 `k8s.gcr.io/kube-*`、`k8s.gcr.io/etcd` 和 `k8s.gcr.io/pause`
都支持多种架构。
<!--
### Automating kubeadm
@ -464,14 +465,16 @@ token distribution for easier automation. To implement this automation, you must
know the IP address that the control-plane node will have after it is started,
or use a DNS name or an address of a load balancer.
-->
不必像文档[kubeadm 基础教程](/zh/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm/)所述，
将从 `kubeadm init` 取得的令牌复制到每个节点，你可以并行地分发令牌以实现简单自动化。要实现自动化，
你必须知道控制平面节点启动后将拥有的 IP 地址，或使用 DNS 名称或负载均衡器的地址。
除了像文档 [kubeadm 基础教程](/zh/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm/)
中所描述的那样，将从 `kubeadm init` 取得的令牌复制到每个节点，
你还可以并行地分发令牌以实现简单自动化。
要实现自动化，你必须知道控制平面节点启动后将拥有的 IP 地址，或使用 DNS 名称或负载均衡器的地址。
<!--
1. Generate a token. This token must have the form `<6 character string>.<16
character string>`. More formally, it must match the regex: `[a-z0-9]{6}\.[a-z0-9]{16}`.
kubeadm can generate a token for you: -->
kubeadm can generate a token for you:
-->
1. 生成一个令牌。这个令牌必须具有以下格式：`< 6 个字符的字符串>.< 16 个字符的字符串>`。
更加正式的说法是，它必须符合以下正则表达式：`[a-z0-9]{6}\.[a-z0-9]{16}`。
@ -494,7 +497,7 @@ As they come up they should find each other and form the cluster. The same `-tok
3. 当加入其他控制平面节点时，可以对 `--certificate-key` 执行类似的操作。可以使用以下方式生成密钥：
```shell
kubeadm alpha certs certificate-key
kubeadm certs certificate-key
```
<!--
@ -512,7 +515,7 @@ provisioned). For details, see the [kubeadm join](/docs/reference/setup-tools/ku
-->
注意这种搭建集群的方式在安全保证上会有一些宽松，因为这种方式不允许使用 `--discovery-token-ca-cert-hash`
来验证根 CA 的哈希值（因为当配置节点的时候，它还没有被生成）。
更多信息请参阅[kubeadm join](/zh/docs/reference/setup-tools/kubeadm/kubeadm-join/)文档。
更多信息请参阅 [kubeadm join](/zh/docs/reference/setup-tools/kubeadm/kubeadm-join/)文档。
## {{% heading "whatsnext" %}}
@ -523,8 +526,11 @@ provisioned). For details, see the [kubeadm join](/docs/reference/setup-tools/ku
* [kubeadm upgrade](/docs/reference/setup-tools/kubeadm/kubeadm-upgrade/) to upgrade a Kubernetes cluster to a newer version
* [kubeadm reset](/docs/reference/setup-tools/kubeadm/kubeadm-reset/) to revert any changes made to this host by `kubeadm init` or `kubeadm join`
-->
* 进一步阅读了解[kubeadm init phase](/zh/docs/reference/setup-tools/kubeadm/kubeadm-init-phase/)
* [kubeadm join](/zh/docs/reference/setup-tools/kubeadm/kubeadm-join/)启动一个 Kubernetes 工作节点并且将其加入到集群
* [kubeadm upgrade](/zh/docs/reference/setup-tools/kubeadm/kubeadm-upgrade/)将 Kubernetes 集群升级到新版本
* [kubeadm reset](/zh/docs/reference/setup-tools/kubeadm/kubeadm-reset/)使用 `kubeadm init` 或 `kubeadm join` 来恢复对节点的变更
* 进一步阅读了解 [kubeadm init phase](/zh/docs/reference/setup-tools/kubeadm/kubeadm-init-phase/)
* [kubeadm join](/zh/docs/reference/setup-tools/kubeadm/kubeadm-join/)
启动一个 Kubernetes 工作节点并且将其加入到集群
* [kubeadm upgrade](/zh/docs/reference/setup-tools/kubeadm/kubeadm-upgrade/)
将 Kubernetes 集群升级到新版本
* [kubeadm reset](/zh/docs/reference/setup-tools/kubeadm/kubeadm-reset/)
恢复 `kubeadm init` 或 `kubeadm join` 命令对节点所作的变更

18
content/zh/docs/reference/setup-tools/kubeadm/kubeadm-version.md
View File

@ -1,21 +1,23 @@
---
reviewers:
- mikedanese
- luxas
- jbeda
title: kubeadm version
content_type: concept
weight: 80
---
<!--
reviewers:
- luxas
- jbeda
title: kubeadm version
content_type: concept
weight: 80
-->
<!-- overview -->
<!--
This command prints the version of kubeadm.
-->
此命令用来查询 kubeadm 的版本。
此命令用来输出 kubeadm 的版本。
<!-- body -->
{{< include "generated/kubeadm_version.md" >}}