Merge pull request #2124 from 24sama/master

Add a kubekey internal loadbalancer usage doc in zh docs

content/zh/docs/installing-on-linux/high-availability-configurations/internal-ha-configuration.md

@@ -0,0 +1,194 @@
+---
+title: "使用 KubeKey 内置 HAproxy 创建高可用集群"
+keywords: 'KubeSphere, Kubernetes, KubeKey, 高可用, 安装'
+description: '如何使用 KubeKey 内置的 HAproxy 安装一个高可用的 KubeSphere 与 Kubernetes 集群。'
+linkTitle: "使用 KubeKey 内置 HAproxy 创建高可用集群"
+weight: 3150
+---
+
+[KubeKey](https://github.com/kubesphere/kubekey) 作为一种集群安装工具，从版本 v1.2.0 开始，提供了内置高可用模式，支持一键部署高可用集群环境。KubeKey 的高可用模式实现方式称作本地负载均衡模式。具体表现为 KubeKey 会在每一个工作节点上部署一个负载均衡器（HAproxy），所有主节点的 Kubernetes 组件连接其本地的 kube-apiserver ，而所有工作节点的 Kubernetes 组件通过由 KubeKey 部署的负载均衡器反向代理到多个主节点的 kube-apiserver 。这种模式相较于专用到负载均衡器来说效率有所降低，因为会引入额外的健康检查机制，但是如果当前环境无法提供外部负载均衡器或者虚拟 IP（VIP）时这将是一种更实用、更有效、更方便的高可用部署模式。
+
+本教程演示了在 Linux 上安装 KubeSphere 时，使用 KubeKey 内置高可用模式部署的大体配置。
+
+## 架构
+
+在您开始操作前，请确保准备了 6 台 Linux 机器，其中 3 台充当主节点，另外 3 台充当工作节点。下图展示了内置高可用模式的架构图。有关系统和网络要求的更多信息，请参见[多节点安装](../../../installing-on-linux/introduction/multioverview/#步骤1准备-linux-主机)。
+
+![高可用架构](/images/docs/zh-cn/installing-on-linux/introduction/internal-ha-configuration/internalLoadBalancer.png)
+
+## 下载 KubeKey
+
+请按照以下步骤下载 KubeKey。
+
+{{< tabs >}}
+
+{{< tab "如果您能正常访问 GitHub 和 Googleapis" >}}
+
+从 [GitHub Release Page](https://github.com/kubesphere/kubekey/releases) 下载 KubeKey 或直接使用以下命令。
+
+```bash
+curl -sfL https://get-kk.kubesphere.io | VERSION=v1.2.0 sh -
+```
+
+{{</ tab >}}
+
+{{< tab "如果您访问 GitHub 和 Googleapis 受限" >}}
+
+先执行以下命令以确保您从正确的区域下载 KubeKey。
+
+```bash
+export KKZONE=cn
+```
+
+执行以下命令下载 KubeKey：
+
+```bash
+curl -sfL https://get-kk.kubesphere.io | VERSION=v1.2.0 sh -
+```
+
+{{< notice note >}}
+
+在您下载 KubeKey 后，如果您将其传至新的机器，且访问 Googleapis 同样受限，在您执行以下步骤之前请务必再次执行 `export KKZONE=cn` 命令。
+
+{{</ notice >}}
+
+{{</ tab >}}
+
+{{</ tabs >}}
+
+{{< notice note >}}
+
+执行以上命令会下载最新版 KubeKey (v1.2.0)，您可以修改命令中的版本号下载指定版本。
+
+{{</ notice >}}
+
+为 `kk` 添加可执行权限：
+
+```bash
+chmod +x kk
+```
+
+创建包含默认配置的示例配置文件。这里使用 Kubernetes v1.21.5 作为示例。
+
+```bash
+./kk create config --with-kubesphere v3.2.0 --with-kubernetes v1.21.5
+```
+
+{{< notice note >}}
+
+- 安装 KubeSphere 3.2.0 的建议 Kubernetes 版本：v1.19.x、v1.20.x、v1.21.x 或 v1.22.x（实验性支持）。如果不指定 Kubernetes 版本，KubeKey 将默认安装 Kubernetes v1.21.5。有关受支持的 Kubernetes 版本的更多信息，请参见[支持矩阵](../../../installing-on-linux/introduction/kubekey/#支持矩阵)。
+
+- 如果您在这一步的命令中不添加标志 `--with-kubesphere`，则不会部署 KubeSphere，只能使用配置文件中的 `addons` 字段安装，或者在您后续使用 `./kk create cluster` 命令时再次添加这个标志。
+
+- 如果您添加标志 `--with-kubesphere` 时不指定 KubeSphere 版本，则会安装最新版本的 KubeSphere。
+
+{{</ notice >}}
+
+## 部署 KubeSphere 和 Kubernetes
+
+运行以上命令后，会创建一个配置文件 `config-sample.yaml`。编辑该文件以添加机器信息、配置负载均衡器和其他内容。
+
+{{< notice note >}}
+
+如果您自定义文件名，文件名称可能会不同。
+
+{{</ notice >}}
+
+### config-sample.yaml 示例
+
+```yaml
+spec:
+  hosts:
+  - {name: master1, address: 192.168.0.2, internalAddress: 192.168.0.2, user: ubuntu, password: Testing123}
+  - {name: master2, address: 192.168.0.3, internalAddress: 192.168.0.3, user: ubuntu, password: Testing123}
+  - {name: master3, address: 192.168.0.4, internalAddress: 192.168.0.4, user: ubuntu, password: Testing123}
+  - {name: node1, address: 192.168.0.5, internalAddress: 192.168.0.5, user: ubuntu, password: Testing123}
+  - {name: node2, address: 192.168.0.6, internalAddress: 192.168.0.6, user: ubuntu, password: Testing123}
+  - {name: node3, address: 192.168.0.7, internalAddress: 192.168.0.7, user: ubuntu, password: Testing123}
+  roleGroups:
+    etcd:
+    - master1
+    - master2
+    - master3
+    master:
+    - master1
+    - master2
+    - master3
+    worker:
+    - node1
+    - node2
+    - node3
+```
+
+有关该配置文件中不同字段的更多信息，请参见 [Kubernetes 集群配置](../../../installing-on-linux/introduction/vars/)和[多节点安装](../../../installing-on-linux/introduction/multioverview/#2-编辑配置文件)。
+
+### 开启内置高可用模式
+
+```yaml
+spec:
+  controlPlaneEndpoint:
+    ##Internal loadbalancer for apiservers
+    internalLoadbalancer: haproxy
+    
+    domain: lb.kubesphere.local
+    address: ""
+    port: 6443
+```
+
+{{< notice note >}}
+
+- 开启内置高可用模式，需要将 `internalLoadbalancer` 字段取消注释。
+- `config-sample.yaml` 文件中的 `address` 和 `port` 应缩进两个空格。
+- 负载均衡器默认的内部访问域名是 `lb.kubesphere.local`。
+
+{{</ notice >}}
+
+### 持久化存储插件配置
+
+在生产环境中，您需要准备持久化存储并在 `config-sample.yaml` 中配置存储插件（例如 CSI），以明确您想使用哪一种存储服务。有关更多信息，请参见[持久化存储配置](../../../installing-on-linux/persistent-storage-configurations/understand-persistent-storage/)。
+
+### 启用可插拔组件（可选）
+
+自 v2.1.0 起，KubeSphere 解耦了一些核心功能组件。您可以在安装之前或者之后启用这些可插拔组件。如果您不启用这些组件，KubeSphere 将默认以最小化安装。
+
+您可以根据您的需求来启用任意可插拔组件。强烈建议您安装这些可插拔组件，以便体验 KubeSphere 提供的全栈特性和功能。启用前，请确保您的机器有足够的 CPU 和内存。有关详情请参见[启用可插拔组件](../../../pluggable-components/)。
+
+### 开始安装
+
+配置完成后，您可以执行以下命令来开始安装：
+
+```bash
+./kk create cluster -f config-sample.yaml
+```
+
+### 验证安装
+
+1. 运行以下命令查看安装日志。
+
+   ```bash
+   kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l app=ks-install -o jsonpath='{.items[0].metadata.name}') -f
+   ```
+
+2. 若您看到以下信息，您的高可用集群便已创建成功。
+
+   ```bash
+   #####################################################
+   ###              Welcome to KubeSphere!           ###
+   #####################################################
+   
+   Console: http://192.168.0.3:30880
+   Account: admin
+   Password: P@88w0rd
+   
+   NOTES：
+     1. After you log into the console, please check the
+        monitoring status of service components in
+        the "Cluster Management". If any service is not
+        ready, please wait patiently until all components
+        are up and running.
+     2. Please change the default password after login.
+   
+   #####################################################
+   https://kubesphere.io             2020-xx-xx xx:xx:xx
+   #####################################################
+   ```

content/zh/docs/installing-on-linux/introduction/kubekey.md

@@ -27,6 +27,7 @@ KubeKey 的几种使用场景：
 - 以前基于 ansible 的安装程序依赖于许多软件，例如 Python。KubeKey 由 Go 语言开发，可以消除在多种环境中出现的问题，确保成功安装。
 - KubeKey 支持多种安装选项，例如 [All-in-One](../../../quick-start/all-in-one-on-linux/)、[多节点安装](../multioverview/)以及[离线安装](../air-gapped-installation/)。
 - KubeKey 使用 Kubeadm 在节点上尽可能多地并行安装 Kubernetes 集群，使安装更简便，提高效率。与旧版的安装程序相比，它极大地节省了安装时间。
+- KubeKey 提供[内置高可用模式](../../high-availability-configurations/internal-ha-configuration/)，支持一键安装高可用 Kubernetes 集群。
 - KubeKey 旨在将集群作为对象来进行安装，即 CaaO。
 
 ## 下载 KubeKey