diff --git a/.hugo_build.lock b/.hugo_build.lock new file mode 100644 index 000000000..e69de29bb diff --git a/content/zh/docs/installing-on-linux/high-availability-configurations/internal-ha-configuration.md b/content/zh/docs/installing-on-linux/high-availability-configurations/internal-ha-configuration.md new file mode 100644 index 000000000..a7154e93e --- /dev/null +++ b/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 "如果您访问 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 note >}} + +执行以上命令会下载最新版 KubeKey (v1.2.0)，您可以修改命令中的版本号下载指定版本。 + +{{}} + +为 `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。 + +{{}} + +## 部署 KubeSphere 和 Kubernetes + +运行以上命令后，会创建一个配置文件 `config-sample.yaml`。编辑该文件以添加机器信息、配置负载均衡器和其他内容。 + +{{< notice note >}} + +如果您自定义文件名，文件名称可能会不同。 + +{{}} + +### 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`。 + +{{}} + +### 持久化存储插件配置 + +在生产环境中，您需要准备持久化存储并在 `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 + ##################################################### + ``` diff --git a/content/zh/docs/installing-on-linux/introduction/kubekey.md b/content/zh/docs/installing-on-linux/introduction/kubekey.md index fa1dcbe44..984ee11bb 100644 --- a/content/zh/docs/installing-on-linux/introduction/kubekey.md +++ b/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 diff --git a/static/images/docs/zh-cn/installing-on-linux/introduction/internal-ha-configuration/internalLoadBalancer.png b/static/images/docs/zh-cn/installing-on-linux/introduction/internal-ha-configuration/internalLoadBalancer.png new file mode 100644 index 000000000..cafe6ad34 Binary files /dev/null and b/static/images/docs/zh-cn/installing-on-linux/introduction/internal-ha-configuration/internalLoadBalancer.png differ