add zh pages

This commit is contained in:
Karen Bradshaw
2020-06-01 09:23:39 -04:00
parent 21fd0a12f9
commit 4b35d4d401
303 changed files with 2764 additions and 2439 deletions
@@ -1,17 +1,17 @@
---
title: 使用 Kops 安装 Kubernetes
content_template: templates/concept
content_type: concept
weight: 20
---
<!--
---
title: Installing Kubernetes with kops
content_template: templates/concept
content_type: concept
weight: 20
---
-->
{{% capture overview %}}
<!-- overview -->
<!--
This quickstart shows you how to easily install a Kubernetes cluster on AWS.
@@ -46,9 +46,9 @@ a building block. kops builds on the kubeadm work.
-->
如果您有不同的观点,您可能更喜欢使用 [kubeadm](/docs/admin/kubeadm/) 作为构建工具来构建自己的集群。kops 建立在 kubeadm 工作的基础上。
{{% /capture %}}
{{% capture body %}}
<!-- body -->
<!--
## Creating a cluster
@@ -335,9 +335,10 @@ See the [list of add-ons](/docs/concepts/cluster-administration/addons/) to expl
* Slack Channel: [#kops-users](https://kubernetes.slack.com/messages/kops-users/)
* [GitHub Issues](https://github.com/kubernetes/kops/issues)
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
<!--
* Learn more about Kubernetes [concepts](/docs/concepts/) and [`kubectl`](/docs/user-guide/kubectl-overview/).
@@ -348,4 +349,4 @@ See the [list of add-ons](/docs/concepts/cluster-administration/addons/) to expl
* 了解 `kops` [高级用法](https://github.com/kubernetes/kops)。
* 请参阅 `kops` [文档](https://github.com/kubernetes/kops) 获取教程、最佳做法和高级配置选项。
{{% /capture %}}
@@ -1,6 +1,6 @@
---
title: 使用 kubeadm 定制控制平面配置
content_template: templates/concept
content_type: concept
weight: 40
---
<!--
@@ -8,12 +8,12 @@ weight: 40
reviewers:
- sig-cluster-lifecycle
title: Customizing control plane configuration with kubeadm
content_template: templates/concept
content_type: concept
weight: 40
---
-->
{{% capture overview %}}
<!-- overview -->
{{< feature-state for_k8s_version="1.12" state="stable" >}}
@@ -55,9 +55,9 @@ You can generate a `ClusterConfiguration` object with default values by running
您可以通过运行 `kubeadm config print init-defaults` 并将输出保存到您选择的文件中,以默认值形式生成 `ClusterConfiguration` 对象。
{{< /note >}}
{{% /capture %}}
{{% capture body %}}
<!-- body -->
<!--
## APIServer flags
@@ -135,4 +135,4 @@ scheduler:
kubeconfig: /home/johndoe/kubeconfig.yaml
```
{{% /capture %}}
@@ -2,7 +2,7 @@
reviewers:
- sig-cluster-lifecycle
title: 高可用拓扑选项
content_template: templates/concept
content_type: concept
weight: 50
---
<!--
@@ -10,12 +10,12 @@ weight: 50
reviewers:
- sig-cluster-lifecycle
title: Options for Highly Available topology
content_template: templates/concept
content_type: concept
weight: 50
---
-->
{{% capture overview %}}
<!-- overview -->
<!--
This page explains the two options for configuring the topology of your highly available (HA) Kubernetes clusters.
@@ -48,9 +48,9 @@ for more details.
kubeadm 静态引导 etcd 集群。 阅读 etcd [集群指南](https://github.com/etcd-io/etcd/blob/release-3.4/Documentation/op-guide/clustering.md#static)以获得更多详细信息。
{{< /note >}}
{{% /capture %}}
{{% capture body %}}
<!-- body -->
<!--
## Stacked etcd topology
@@ -138,13 +138,14 @@ A minimum of three hosts for control plane nodes and three hosts for etcd nodes
-->
[外部 etcd 拓扑](/images/kubeadm/kubeadm-ha-topology-external-etcd.svg)
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
<!--
- [Set up a highly available cluster with kubeadm](/docs/setup/production-environment/tools/kubeadm/high-availability/)
-->
- [使用 kubeadm 设置高可用集群](/docs/setup/production-environment/tools/kubeadm/high-availability/)
{{% /capture %}}
@@ -2,7 +2,7 @@
reviewers:
- sig-cluster-lifecycle
title: 利用 kubeadm 创建高可用集群
content_template: templates/task
content_type: task
weight: 60
---
@@ -11,12 +11,12 @@ weight: 60
reviewers:
- sig-cluster-lifecycle
title: Creating Highly Available clusters with kubeadm
content_template: templates/task
content_type: task
weight: 60
---
-->
{{% capture overview %}}
<!-- overview -->
<!--
This page explains two different approaches to setting up a highly available Kubernetes
@@ -57,9 +57,10 @@ LoadBalancer, or with dynamic PersistentVolumes.
这篇文档没有讲述在云提供商上运行集群的问题。在云环境中,此处记录的方法不适用于类型为 LoadBalancer 的服务对象,或者具有动态的 PersistentVolumes。
{{< /caution >}}
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
<!--
For both methods you need this infrastructure:
@@ -92,9 +93,9 @@ For the external etcd cluster only, you also need:
- 给 etcd 成员使用的另外三台机器
{{% /capture %}}
{{% capture steps %}}
<!-- steps -->
<!-- ## First steps for both methods -->
## 这两种方法的第一步
@@ -731,4 +732,4 @@ the creation of additional nodes could fail due to a lack of required SANs.
mv /home/${USER}/etcd-ca.key /etc/kubernetes/pki/etcd/ca.key
```
{{% /capture %}}
@@ -1,6 +1,6 @@
---
title: 安装 kubeadm
content_template: templates/task
content_type: task
weight: 10
card:
name: setup
@@ -10,7 +10,7 @@ card:
<!--
---
title: Installing kubeadm
content_template: templates/task
content_type: task
weight: 10
card:
name: setup
@@ -19,7 +19,7 @@ card:
---
-->
{{% capture overview %}}
<!-- overview -->
<!--
<img src="https://raw.githubusercontent.com/kubernetes/kubeadm/master/logos/stacked/color/kubeadm-stacked-color.png" align="right" width="150px">This page shows how to install the `kubeadm` toolbox.
@@ -28,9 +28,10 @@ For information how to create a cluster with kubeadm once you have performed thi
<img src="https://raw.githubusercontent.com/kubernetes/kubeadm/master/logos/stacked/color/kubeadm-stacked-color.png" align="right" width="150px">本页面显示如何安装 `kubeadm` 工具箱。
有关在执行此安装过程后如何使用 kubeadm 创建集群的信息,请参见[使用 kubeadm 创建集群](/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm/) 页面。
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
<!--
* One or more machines running one of:
@@ -63,9 +64,9 @@ For information how to create a cluster with kubeadm once you have performed thi
* 开启机器上的某些端口。请参见[这里](#check-required-ports) 了解更多详细信息。
* 禁用交换分区。为了保证 kubelet 正常工作,您 **必须** 禁用交换分区。
{{% /capture %}}
{{% capture steps %}}
<!-- steps -->
<!--
## Verify the MAC address and product_uuid are unique for every node
@@ -507,11 +508,12 @@ If you are running into difficulties with kubeadm, please consult our [troublesh
如果您在使用 kubeadm 时遇到困难,请参阅我们的[故障排查文档](/docs/setup/production-environment/tools/kubeadm/troubleshooting-kubeadm/)。
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
<!--
* [Using kubeadm to Create a Cluster](/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm/)
-->
* [使用 kubeadm 创建集群](/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm/)
{{% /capture %}}
@@ -2,7 +2,7 @@
reviewers:
- sig-cluster-lifecycle
title: 使用 kubeadm 配置集群中的每个 kubelet
content_template: templates/concept
content_type: concept
weight: 80
---
<!--
@@ -10,12 +10,12 @@ weight: 80
reviewers:
- sig-cluster-lifecycle
title: Configuring each kubelet in your cluster using kubeadm
content_template: templates/concept
content_type: concept
weight: 80
---
-->
{{% capture overview %}}
<!-- overview -->
{{< feature-state for_k8s_version="1.11" state="stable" >}}
@@ -46,9 +46,9 @@ kubeadm CLI 工具的生命周期与 [kubelet](/docs/reference/command-line-tool
集群中涉及的所有 kubelet 的一些配置细节都必须相同,而其他配置方面则需要基于每个 kubelet 进行设置,以适应给定机器的不同特性,例如操作系统、存储和网络。
您可以手动地管理 kubelet 的配置,但是 [kubeadm 现在提供一种 `KubeletConfiguration` API 类型,用于集中管理 kubelet 的配置](#configure-kubelets-using-kubeadm)。
{{% /capture %}}
{{% capture body %}}
<!-- body -->
<!--
## Kubelet configuration patterns
@@ -378,4 +378,4 @@ Kubernetes 版本对应的 DEB 和 RPM 软件包是:
| `kubernetes-cni` | 将官方的 CNI 二进制文件安装到 `/opt/cni/bin` 目录中 |
| `cri-tools` | 从 [cri-tools git 仓库](https://github.com/kubernetes-incubator/cri-tools)中安装 `/usr/bin/crictl` 二进制文件。 |
{{% /capture %}}
@@ -2,7 +2,7 @@
reviewers:
- sig-cluster-lifecycle
title: 配置您的 kubernetes 集群以自托管控制平台
content_template: templates/concept
content_type: concept
weight: 100
---
<!--
@@ -10,12 +10,12 @@ weight: 100
reviewers:
- sig-cluster-lifecycle
title: Configuring your kubernetes cluster to self-host the control plane
content_template: templates/concept
content_type: concept
weight: 100
---
-->
{{% capture overview %}}
<!-- overview -->
<!--
### Self-hosting the Kubernetes control plane {#self-hosting}
@@ -38,9 +38,9 @@ To create a self-hosted cluster see the
-->
要创建自托管集群,请参见 [kubeadm alpha 自托管枢纽](/docs/reference/setup-tools/kubeadm/kubeadm-alpha/#cmd-selfhosting) 命令。
{{% /capture %}}
{{% capture body %}}
<!-- body -->
<!--
#### Caveats
@@ -130,5 +130,5 @@ In summary, `kubeadm alpha selfhosting` works as follows:
-->
1. 当原始静态控制平面停止时,新的自托管控制平面能够绑定到侦听端口并变为活动状态。
{{% /capture %}}
@@ -1,6 +1,6 @@
---
title: 使用 kubeadm 创建一个高可用 etcd 集群
content_template: templates/task
content_type: task
weight: 70
---
@@ -9,12 +9,12 @@ weight: 70
reviewers:
- sig-cluster-lifecycle
title: Set up a High Availability etcd cluster with kubeadm
content_template: templates/task
content_type: task
weight: 70
---
-->
{{% capture overview %}}
<!-- overview -->
{{< note >}}
<!--
@@ -37,9 +37,10 @@ when using kubeadm to set up a kubernetes cluster.
-->
默认情况下,kubeadm 运行单成员的 etcd 集群,该集群由控制面节点上的 kubelet 以静态 Pod 的方式进行管理。由于 etcd 集群只包含一个成员且不能在任一成员不可用时保持运行,所以这不是一种高可用设置。本任务,将告诉您如何在使用 kubeadm 创建一个 kubernetes 集群时创建一个外部 etcd:有三个成员的高可用 etcd 集群。
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
<!--
* Three hosts that can talk to each other over ports 2379 and 2380. This document assumes these default ports. However, they are configurable through the kubeadm config file.
@@ -61,9 +62,9 @@ when using kubeadm to set up a kubernetes cluster.
-->
[工具箱]: /docs/setup/production-environment/tools/kubeadm/install-kubeadm/
{{% /capture %}}
{{% capture steps %}}
<!-- steps -->
<!--
## Setting up the cluster
@@ -413,9 +414,10 @@ kubeadm 包含生成下述证书所需的所有必要的密码学工具;在这
-->
- 将 `${HOST0}` 设置为要测试的主机的 IP 地址
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
<!--
Once your have a working 3 member etcd cluster, you can continue setting up a
@@ -424,5 +426,5 @@ kubeadm](/docs/setup/independent/high-availability/).
-->
一旦拥有了一个正常工作的 3 成员的 etcd 集群,你就可以基于[使用 kubeadm 的外部 etcd 方法](/docs/setup/independent/high-availability/),继续部署一个高可用的控制平面。
{{% /capture %}}
@@ -1,17 +1,17 @@
---
title: 对 kubeadm 进行故障排查
content_template: templates/concept
content_type: concept
weight: 20
---
<!--
---
title: Troubleshooting kubeadm
content_template: templates/concept
content_type: concept
weight: 20
---
-->
{{% capture overview %}}
<!-- overview -->
<!--
As with any program, you might run into an error installing or running kubeadm.
@@ -39,9 +39,9 @@ If your problem is not listed below, please follow the following steps:
或者在 [StackOverflow](https://stackoverflow.com/questions/tagged/kubernetes) 上提问。
请加入相关标签,例如 `#kubernetes``#kubeadm`,这样其他人可以帮助您。
{{% /capture %}}
{{% capture body %}}
<!-- body -->
<!--
## `ebtables` or some similar executable not found during installation
@@ -647,4 +647,4 @@ kubectl taint nodes NODE_NAME node-role.kubernetes.io/master:NoSchedule-
kubectl taint nodes NODE_NAME node-role.kubernetes.io/master:NoSchedule-
```
{{% /capture %}}