Skip to content

Commit f8fbaac

Browse files
committed
[zh] Sync four files in tools/kubeadm/
1 parent 3502384 commit f8fbaac

File tree

4 files changed

+114
-50
lines changed

4 files changed

+114
-50
lines changed

content/zh-cn/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm.md

Lines changed: 38 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -57,8 +57,7 @@ as Ansible or Terraform.
5757
To follow this guide, you need:
5858
5959
- One or more machines running a deb/rpm-compatible Linux OS; for example: Ubuntu or CentOS.
60-
- 2 GiB or more of RAM per machine--any less leaves little room for your
61-
apps.
60+
- 2 GiB or more of RAM per machine--any less leaves little room for your apps.
6261
- At least 2 CPUs on the machine that you use as a control-plane node.
6362
- Full network connectivity among all machines in the cluster. You can use either a
6463
public or a private network.
@@ -92,7 +91,7 @@ The `kubeadm` tool's overall feature state is General Availability (GA). Some su
9291
still under active development. The implementation of creating the cluster may change
9392
slightly as the tool evolves, but the overall implementation should be pretty stable.
9493
-->
95-
`kubeadm` 工具的整体功能状态为一般可用性(GA)。一些子功能仍在积极开发中
94+
`kubeadm` 工具的整体特性状态为正式发布(GA)。一些子特性仍在积极开发中
9695
随着工具的发展,创建集群的实现可能会略有变化,但总体实现应相当稳定。
9796

9897
{{< note >}}
@@ -132,16 +131,18 @@ Any commands under `kubeadm alpha` are, by definition, supported on an alpha lev
132131
#### 安装组件 {#component-installation}
133132

134133
<!--
135-
Install a {{< glossary_tooltip term_id="container-runtime" text="container runtime" >}} and kubeadm on all the hosts.
136-
For detailed instructions and other prerequisites, see [Installing kubeadm](/docs/setup/production-environment/tools/kubeadm/install-kubeadm/).
134+
Install a {{< glossary_tooltip term_id="container-runtime" text="container runtime" >}}
135+
and kubeadm on all the hosts. For detailed instructions and other prerequisites, see
136+
[Installing kubeadm](/docs/setup/production-environment/tools/kubeadm/install-kubeadm/).
137137
-->
138138
在所有主机上安装{{< glossary_tooltip term_id="container-runtime" text="容器运行时" >}}和 kubeadm。
139139
详细说明和其他前提条件,请参见[安装 kubeadm](/zh-cn/docs/setup/production-environment/tools/kubeadm/install-kubeadm/)
140140

141141
{{< note >}}
142142
<!--
143143
If you have already installed kubeadm, see the first two steps of the
144-
[Upgrading Linux nodes](/docs/tasks/administer-cluster/kubeadm/upgrading-linux-nodes) document for instructions on how to upgrade kubeadm.
144+
[Upgrading Linux nodes](/docs/tasks/administer-cluster/kubeadm/upgrading-linux-nodes)
145+
document for instructions on how to upgrade kubeadm.
145146
146147
When you upgrade, the kubelet restarts every few seconds as it waits in a crashloop for
147148
kubeadm to tell it what to do. This crashloop is expected and normal.
@@ -243,9 +244,8 @@ certificate files is reflected. See
243244
for more details on this topic.
244245
-->
245246
你分配给控制平面组件的 IP 地址将成为其 X.509 证书的使用者备用名称字段的一部分。
246-
更改这些 IP 地址将需要签署新的证书并重启受影响的组件,
247-
以便反映证书文件中的变化。有关此主题的更多细节参见
248-
[手动续期证书](/zh-cn/docs/tasks/administer-cluster/kubeadm/kubeadm-certs/#manual-certificate-renewal)
247+
更改这些 IP 地址将需要签署新的证书并重启受影响的组件,以便反映证书文件中的变化。
248+
有关此主题的更多细节参见[手动续期证书](/zh-cn/docs/tasks/administer-cluster/kubeadm/kubeadm-certs/#manual-certificate-renewal)
249249

250250
{{< warning >}}
251251
<!--
@@ -311,13 +311,13 @@ communicates with).
311311

312312
<!--
313313
1. (Recommended) If you have plans to upgrade this single control-plane `kubeadm` cluster
314-
to [high availability](/docs/setup/production-environment/tools/kubeadm/high-availability/)
315-
you should specify the `--control-plane-endpoint` to set the shared endpoint for all control-plane nodes.
316-
Such an endpoint can be either a DNS name or an IP address of a load-balancer.
314+
to [high availability](/docs/setup/production-environment/tools/kubeadm/high-availability/)
315+
you should specify the `--control-plane-endpoint` to set the shared endpoint for all control-plane nodes.
316+
Such an endpoint can be either a DNS name or an IP address of a load-balancer.
317317
1. Choose a Pod network add-on, and verify whether it requires any arguments to
318-
be passed to `kubeadm init`. Depending on which
319-
third-party provider you choose, you might need to set the `--pod-network-cidr` to
320-
a provider-specific value. See [Installing a Pod network add-on](#pod-network).
318+
be passed to `kubeadm init`. Depending on which
319+
third-party provider you choose, you might need to set the `--pod-network-cidr` to
320+
a provider-specific value. See [Installing a Pod network add-on](#pod-network).
321321
-->
322322
1. (推荐)如果计划将单个控制平面 kubeadm 集群升级成[高可用](/zh-cn/docs/setup/production-environment/tools/kubeadm/high-availability/)
323323
你应该指定 `--control-plane-endpoint` 为所有控制平面节点设置共享端点。
@@ -328,9 +328,9 @@ a provider-specific value. See [Installing a Pod network add-on](#pod-network).
328328

329329
<!--
330330
1. (Optional) `kubeadm` tries to detect the container runtime by using a list of well
331-
known endpoints. To use different container runtime or if there are more than one installed
332-
on the provisioned node, specify the `--cri-socket` argument to `kubeadm`. See
333-
[Installing a runtime](/docs/setup/production-environment/tools/kubeadm/install-kubeadm/#installing-runtime).
331+
known endpoints. To use different container runtime or if there are more than one installed
332+
on the provisioned node, specify the `--cri-socket` argument to `kubeadm`. See
333+
[Installing a runtime](/docs/setup/production-environment/tools/kubeadm/install-kubeadm/#installing-runtime).
334334
-->
335335
3. (可选)`kubeadm` 试图通过使用已知的端点列表来检测容器运行时。
336336
使用不同的容器运行时或在预配置的节点上安装了多个容器运行时,请为 `kubeadm init` 指定 `--cri-socket` 参数。
@@ -351,7 +351,7 @@ kubeadm init <args>
351351
### 关于 apiserver-advertise-address 和 ControlPlaneEndpoint 的注意事项 {#considerations-about-apiserver-advertise-address-and-controlplaneendpoint}
352352

353353
<!--
354-
While `--apiserver-advertise-address` can be used to set the advertise address for this particular
354+
While `--apiserver-advertise-address` can be used to set the advertised address for this particular
355355
control-plane node's API server, `--control-plane-endpoint` can be used to set the shared endpoint
356356
for all control-plane nodes.
357357
-->
@@ -377,7 +377,7 @@ Here is an example mapping:
377377
<!--
378378
Where `192.168.0.102` is the IP address of this node and `cluster-endpoint` is a custom DNS name that maps to this IP.
379379
This will allow you to pass `--control-plane-endpoint=cluster-endpoint` to `kubeadm init` and pass the same DNS name to
380-
`kubeadm join`. Later you can modify `cluster-endpoint` to point to the address of your load-balancer in an
380+
`kubeadm join`. Later you can modify `cluster-endpoint` to point to the address of your load-balancer in a
381381
high availability scenario.
382382
-->
383383
其中 `192.168.0.102` 是此节点的 IP 地址,`cluster-endpoint` 是映射到该 IP 的自定义 DNS 名称。
@@ -678,7 +678,8 @@ The `node-role.kubernetes.io/control-plane` label is such a restricted label and
678678
a privileged client after a node has been created. To do that manually you can do the same by using `kubectl label`
679679
and ensure it is using a privileged kubeconfig such as the kubeadm managed `/etc/kubernetes/admin.conf`.
680680
-->
681-
默认情况下,kubeadm 启用 [NodeRestriction](/zh-cn/docs/reference/access-authn-authz/admission-controllers/#noderestriction)
681+
默认情况下,kubeadm 启用
682+
[NodeRestriction](/zh-cn/docs/reference/access-authn-authz/admission-controllers/#noderestriction)
682683
准入控制器来限制 kubelet 在节点注册时可以应用哪些标签。准入控制器文档描述 kubelet `--node-labels` 选项允许使用哪些标签。
683684
其中 `node-role.kubernetes.io/control-plane` 标签就是这样一个受限制的标签,
684685
kubeadm 在节点创建后使用特权客户端手动应用此标签。
@@ -737,8 +738,8 @@ kubectl label nodes --all node.kubernetes.io/exclude-from-external-load-balancer
737738
<!--
738739
### Adding more control plane nodes
739740
740-
See [Creating Highly Available Clusters with kubeadm](/docs/setup/production-environment/tools/kubeadm/high-availability/) for steps on creating a high availability kubeadm cluster by adding more control plane
741-
nodes.
741+
See [Creating Highly Available Clusters with kubeadm](/docs/setup/production-environment/tools/kubeadm/high-availability/)
742+
for steps on creating a high availability kubeadm cluster by adding more control plane nodes.
742743
743744
### Adding worker nodes {#join-nodes}
744745
@@ -750,7 +751,7 @@ the `kubeadm join` command:
750751
* [Adding Linux worker nodes](/docs/tasks/administer-cluster/kubeadm/adding-linux-nodes/)
751752
* [Adding Windows worker nodes](/docs/tasks/administer-cluster/kubeadm/adding-windows-nodes/)
752753
-->
753-
### 添加更多控制平面节点
754+
### 添加更多控制平面节点 {#adding-more-control-plane-nodes}
754755

755756
请参阅[使用 kubeadm 创建高可用性集群](/zh-cn/docs/setup/production-environment/tools/kubeadm/high-availability/)
756757
了解通过添加更多控制平面节点创建高可用性 kubeadm 集群的步骤。
@@ -821,7 +822,7 @@ admin.conf 文件为用户提供了对集群的超级用户特权。
821822
### (可选)将 API 服务器代理到本地主机 {#optional-proxying-api-server-to-localhost}
822823

823824
<!--
824-
If you want to connect to the API Server from outside the cluster you can use
825+
If you want to connect to the API Server from outside the cluster, you can use
825826
`kubectl proxy`:
826827
-->
827828
如果你要从集群外部连接到 API 服务器,则可以使用 `kubectl proxy`
@@ -887,7 +888,8 @@ kubeadm reset
887888
```
888889

889890
<!--
890-
The reset process does not reset or clean up iptables rules or IPVS tables. If you wish to reset iptables, you must do so manually:
891+
The reset process does not reset or clean up iptables rules or IPVS tables.
892+
If you wish to reset iptables, you must do so manually:
891893
-->
892894
重置过程不会重置或清除 iptables 规则或 IPVS 表。如果你希望重置 iptables,则必须手动进行:
893895

@@ -903,6 +905,7 @@ If you want to reset the IPVS tables, you must run the following command:
903905
```bash
904906
ipvsadm -C
905907
```
908+
906909
<!--
907910
Now remove the node:
908911
@@ -996,6 +999,7 @@ the same version as kubeadm or three version older.
996999

9971000
<!--
9981001
Example:
1002+
9991003
* kubeadm is at {{< skew currentVersion >}}
10001004
* kubelet on the host must be at {{< skew currentVersion >}}, {{< skew currentVersionAddMinor -1 >}},
10011005
{{< skew currentVersionAddMinor -2 >}} or {{< skew currentVersionAddMinor -3 >}}
@@ -1047,11 +1051,13 @@ MINOR 版本或比后者新一个 MINOR 版本。
10471051

10481052
<!--
10491053
Example for `kubeadm upgrade`:
1054+
10501055
* kubeadm version {{< skew currentVersionAddMinor -1 >}} was used to create or upgrade the node
10511056
* The version of kubeadm used for upgrading the node must be at {{< skew currentVersionAddMinor -1 >}}
1052-
or {{< skew currentVersion >}}
1057+
or {{< skew currentVersion >}}
10531058
-->
10541059
`kubeadm upgrade` 的例子:
1060+
10551061
* 用于创建或升级节点的 kubeadm 版本为 {{< skew currentVersionAddMinor -1 >}}。
10561062
* 用于升级节点的 kubeadm 版本必须为 {{< skew currentVersionAddMinor -1 >}} 或 {{< skew currentVersion >}}。
10571063

@@ -1096,8 +1102,8 @@ Workarounds:
10961102
[Options for Highly Available topology](/docs/setup/production-environment/tools/kubeadm/ha-topology/) to pick a cluster
10971103
topology that provides [high-availability](/docs/setup/production-environment/tools/kubeadm/high-availability/).
10981104
-->
1099-
* 使用多个控制平面节点。你可以阅读
1100-
[可选的高可用性拓扑](/zh-cn/docs/setup/production-environment/tools/kubeadm/ha-topology/)选择集群拓扑提供的
1105+
* 使用多个控制平面节点。
1106+
你可以阅读[可选的高可用性拓扑](/zh-cn/docs/setup/production-environment/tools/kubeadm/ha-topology/)选择集群拓扑提供的
11011107
[高可用性](/zh-cn/docs/setup/production-environment/tools/kubeadm/high-availability/)
11021108

11031109
<!--
@@ -1107,8 +1113,7 @@ Workarounds:
11071113

11081114
<!--
11091115
kubeadm deb/rpm packages and binaries are built for amd64, arm (32-bit), arm64, ppc64le, and s390x
1110-
following the [multi-platform
1111-
proposal](https://git.k8s.io/design-proposals-archive/multi-platform.md).
1116+
following the [multi-platform proposal](https://git.k8s.io/design-proposals-archive/multi-platform.md).
11121117
-->
11131118
kubeadm deb/rpm 软件包和二进制文件是为 amd64、arm (32-bit)、arm64、ppc64le 和 s390x
11141119
构建的遵循[多平台提案](https://git.k8s.io/design-proposals-archive/multi-platform.md)
@@ -1141,9 +1146,9 @@ If you are running into difficulties with kubeadm, please consult our
11411146
<!-- discussion -->
11421147

11431148
<!--
1144-
## What's next {#whats-next}
1149+
## {{% heading "whatsnext" %}}
11451150
-->
1146-
## 下一步 {#whats-next}
1151+
## {{% heading "whatsnext" %}}
11471152

11481153
<!--
11491154
* Verify that your cluster is running properly with [Sonobuoy](https://github.com/heptio/sonobuoy)

content/zh-cn/docs/setup/production-environment/tools/kubeadm/ha-topology.md

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,8 @@ You should carefully consider the advantages and disadvantages of each topology
3737

3838
{{< note >}}
3939
<!--
40-
kubeadm bootstraps the etcd cluster statically. Read the etcd [Clustering Guide](https://github.com/etcd-io/etcd/blob/release-3.4/Documentation/op-guide/clustering.md#static)
40+
kubeadm bootstraps the etcd cluster statically. Read the etcd
41+
[Clustering Guide](https://github.com/etcd-io/etcd/blob/release-3.4/Documentation/op-guide/clustering.md#static)
4142
for more details.
4243
-->
4344
kubeadm 静态引导 etcd 集群。
@@ -111,13 +112,19 @@ on control plane nodes when using `kubeadm init` and `kubeadm join --control-pla
111112
## 外部 etcd 拓扑 {#external-etcd-topology}
112113

113114
<!--
114-
An HA cluster with external etcd is a [topology](https://en.wikipedia.org/wiki/Network_topology) where the distributed data storage cluster provided by etcd is external to the cluster formed by the nodes that run control plane components.
115+
An HA cluster with external etcd is a [topology](https://en.wikipedia.org/wiki/Network_topology)
116+
where the distributed data storage cluster provided by etcd is external to the cluster formed by
117+
the nodes that run control plane components.
115118
-->
116119
具有外部 etcd 的 HA 集群是一种这样的[拓扑](https://zh.wikipedia.org/wiki/%E7%BD%91%E7%BB%9C%E6%8B%93%E6%89%91)
117120
其中 etcd 分布式数据存储集群在独立于控制平面节点的其他节点上运行。
118121

119122
<!--
120-
Like the stacked etcd topology, each control plane node in an external etcd topology runs an instance of the `kube-apiserver`, `kube-scheduler`, and `kube-controller-manager`. And the `kube-apiserver` is exposed to worker nodes using a load balancer. However, etcd members run on separate hosts, and each etcd host communicates with the `kube-apiserver` of each control plane node.
123+
Like the stacked etcd topology, each control plane node in an external etcd topology runs
124+
an instance of the `kube-apiserver`, `kube-scheduler`, and `kube-controller-manager`.
125+
And the `kube-apiserver` is exposed to worker nodes using a load balancer. However,
126+
etcd members run on separate hosts, and each etcd host communicates with the
127+
`kube-apiserver` of each control plane node.
121128
-->
122129
就像堆叠的 etcd 拓扑一样,外部 etcd 拓扑中的每个控制平面节点都会运行
123130
`kube-apiserver``kube-scheduler``kube-controller-manager` 实例。
@@ -134,7 +141,8 @@ the cluster redundancy as much as the stacked HA topology.
134141

135142
<!--
136143
However, this topology requires twice the number of hosts as the stacked HA topology.
137-
A minimum of three hosts for control plane nodes and three hosts for etcd nodes are required for an HA cluster with this topology.
144+
A minimum of three hosts for control plane nodes and three hosts for etcd nodes are
145+
required for an HA cluster with this topology.
138146
-->
139147
但此拓扑需要两倍于堆叠 HA 拓扑的主机数量。
140148
具有此拓扑的 HA 集群至少需要三个用于控制平面节点的主机和三个用于 etcd 节点的主机。

0 commit comments

Comments
 (0)