Update multioverview guide

Signed-off-by: Sherlock113 <sherlockxu@yunify.com>
This commit is contained in:
Sherlock113 2021-05-08 15:53:10 +08:00
parent 89f583cb4d
commit 0880acac65
2 changed files with 41 additions and 25 deletions

View File

@ -23,7 +23,7 @@ A multi-node cluster is composed of at least one master node and one worker node
## Step 1: Prepare Linux Hosts
Please see the requirements for hardware and operating system shown below. To get started with multi-node installation in this demo, you need to prepare at least three hosts according to the following requirements. It is possible to install [KubeSphere Container Platform](https://kubesphere.io/) on two nodes with enough resources planned.
Please see the requirements for hardware and operating system shown below. To get started with multi-node installation in this tutorial, you need to prepare at least three hosts according to the following requirements. It is possible to install the [KubeSphere Container Platform](https://kubesphere.io/) on two nodes if they have sufficient resources.
### System requirements
@ -56,7 +56,7 @@ The path `/var/lib/docker` is mainly used to store the container data, and will
### Dependency requirements
KubeKey can install Kubernetes and KubeSphere together. The dependency that needs to be installed may be different based on the Kubernetes version to be installed. You can refer to the list below to see if you need to install relevant dependencies on your node in advance.
KubeKey can install Kubernetes and KubeSphere together. The dependency that needs to be installed may be different based on the Kubernetes version to be installed. You can refer to the list below to see if you need to install relevant dependencies on your node in advance.
| Dependency | Kubernetes Version ≥ 1.18 | Kubernetes Version < 1.18 |
| ----------- | ------------------------- | ------------------------- |
@ -212,13 +212,21 @@ List all your machines under `hosts` and add their detailed information as above
`internalAddress`: The private IP address of the instance.
- In this tutorial, port 22 is the default port of SSH so you do not need to add it in the YAML file. Otherwise, you need to add the port number after the IP address. For example:
At the same time, you must provide the login information used to connect to each instance. Here are some examples:
- For password login:
```yaml
hosts:
- {name: master, address: 192.168.0.2, internalAddress: 192.168.0.2, port: 8022, user: ubuntu, password: Testing123}
```
{{< notice note >}}
In this tutorial, port `22` is the default port of SSH so you do not need to add it in the YAML file. Otherwise, you need to add the port number after the IP address as above.
{{</ notice >}}
- For the default root user:
```yaml
@ -236,7 +244,7 @@ List all your machines under `hosts` and add their detailed information as above
{{< notice tip >}}
- Before you install KubeSphere, you can use the information provided under `hosts` (for example, IP addresses and passwords) to test the network connection between the taskbox and other instances using SSH.
- Make sure port 6443 is not being used by other services before the installation. Otherwise, it may cause conflicts as the default port of the API server is 6443.
- Make sure port `6443` is not being used by other services before the installation. Otherwise, it may cause conflicts as the default port of the API server is `6443`.
{{</ notice >}}
@ -254,11 +262,7 @@ The `controlPlaneEndpoint` is where you provide your external load balancer info
You can customize persistent storage plugins (e.g. NFS Client, Ceph RBD, and GlusterFS) by specifying storage under the field `addons` in `config-sample.yaml`. For more information, see [Persistent Storage Configurations](../../../installing-on-linux/persistent-storage-configurations/understand-persistent-storage/).
{{< notice note >}}
KubeKey will install [OpenEBS](https://openebs.io/) to provision [LocalPV](https://kubernetes.io/docs/concepts/storage/volumes/#local) for development and testing environment by default, which is convenient for new users. In this example of multi-node installation, the default storage class (local volume) is used. For production, please use NFS/Ceph/GlusterFS/CSI or commercial products as persistent storage solutions.
{{</ notice >}}
KubeKey will install [OpenEBS](https://openebs.io/) to provision [LocalPV](https://kubernetes.io/docs/concepts/storage/volumes/#local) for development and testing environment by default, which is convenient for new users. In this example of multi-node installation, the default storage class (local volume) is used. For production, you can use NFS/Ceph/GlusterFS/CSI or commercial products as persistent storage solutions.
{{< notice tip >}}
@ -309,11 +313,11 @@ https://kubesphere.io 20xx-xx-xx xx:xx:xx
#####################################################
```
Now, you will be able to access the web console of KubeSphere at `http://{IP}:30880` (e.g. you can use the EIP) with the account and password `admin/P@88w0rd`.
Now, you will be able to access the web console of KubeSphere at `<NodeIP>:30880` with the default account and password (`admin/P@88w0rd`).
{{< notice note >}}
To access the console, you may need to configure port forwarding rules depending on your environment. Please also make sure port 30880 is opened in your security group.
To access the console, you may need to configure port forwarding rules depending on your environment. Please also make sure port `30880` is opened in your security group.
{{</ notice >}}
@ -323,7 +327,11 @@ To access the console, you may need to configure port forwarding rules depending
KubeKey doesn't enable kubectl autocompletion. See the content below and turn it on:
**Prerequisite**: make sure bash-autocompletion is installed and works.
{{< notice note >}}
Make sure bash-autocompletion is installed and works.
{{</ notice >}}
```bash
# Install bash-completion
@ -338,5 +346,5 @@ kubectl completion bash >/etc/bash_completion.d/kubectl
Detailed information can be found [here](https://kubernetes.io/docs/tasks/tools/install-kubectl/#enabling-shell-autocompletion).
## Demo
## Code Demonstration
<script src="https://asciinema.org/a/368752.js" id="asciicast-368752" async></script>

View File

@ -25,7 +25,7 @@ weight: 3120
## 步骤 1准备 Linux 主机
请参见下表列出的硬件和操作系统要求。若要开始本节演示中的多节点安装,您需要按照下列要求准备至少三台主机。如果计划的资源足够,也可以将 KubeSphere 安装在两个节点上。
请参见下表列出的硬件和操作系统要求。在本教程所演示多节点安装示例中,您需要按照下列要求准备至少三台主机。如果您节点的资源充足,也可以将 [KubeSphere 容器平台](https://kubesphere.com.cn/)安装在两个节点上。
### 系统要求
@ -214,13 +214,21 @@ spec:
`internalAddress`:实例的私有 IP 地址。
- 在本教程中,端口 22 是 SSH 的默认端口,因此您无需将它添加至该 YAML 文件中。否则,您需要在 IP 地址后添加对应端口号。例如:
此外,您必须提供用于连接至每台实例的登录信息,以下示例供您参考:
- 使用密码登录示例:
```yaml
hosts:
- {name: master, address: 192.168.0.2, internalAddress: 192.168.0.2, port: 8022, user: ubuntu, password: Testing123}
```
{{< notice note >}}
在本教程中,端口 `22` 是 SSH 的默认端口,因此您无需将它添加至该 YAML 文件中。否则,您需要在 IP 地址后添加对应端口号,如上所示。
{{</ notice >}}
- 默认 root 用户示例:
```yaml
@ -238,7 +246,7 @@ spec:
{{< notice tip >}}
- 在安装 KubeSphere 之前,您可以使用 `hosts` 下提供的信息(例如 IP 地址和密码)通过 SSH 的方式测试任务机和其他实例之间的网络连接。
- 在安装前,请确保端口 6443 没有被其他服务占用否则在安装时会产生冲突6443 为 API 服务器的默认端口)。
- 在安装前,请确保端口 `6443` 没有被其他服务占用,否则在安装时会产生冲突(`6443` 为 API 服务器的默认端口)。
{{</ notice >}}
@ -256,11 +264,7 @@ spec:
您可以在 `config-sample.yaml``addons` 字段下指定存储,从而自定义持久化存储插件,例如 NFS 客户端、Ceph RBD、GlusterFS 等。有关更多信息,请参见[持久化存储配置](../../../installing-on-linux/persistent-storage-configurations/understand-persistent-storage/)。
{{< notice note >}}
KubeSphere 会默认安装 [OpenEBS](https://openebs.io/),为开发和测试环境配置 [LocalPV](https://kubernetes.io/docs/concepts/storage/volumes/#local),方便新用户使用。在本多节点安装示例中,使用了默认存储类型(本地存储卷)。对于生产环境,请使用 NFS/Ceph/GlusterFS/CSI 或者商业存储产品作为持久化存储解决方案。
{{</ notice >}}
KubeSphere 会默认安装 [OpenEBS](https://openebs.io/),为开发和测试环境配置 [LocalPV](https://kubernetes.io/docs/concepts/storage/volumes/#local),方便新用户使用。在本多节点安装示例中,使用了默认存储类型(本地存储卷)。对于生产环境,您可以使用 NFS/Ceph/GlusterFS/CSI 或者商业存储产品作为持久化存储解决方案。
{{< notice tip >}}
@ -311,11 +315,11 @@ https://kubesphere.io 20xx-xx-xx xx:xx:xx
#####################################################
```
现在,您可以通过 `http://{IP}:30880`(例如,您可以使用 EIP使用帐户和密码 `admin/P@88w0rd` 访问 KubeSphere 的 Web 控制台。
现在,您可以通过 `<NodeIP:30880` 使用默认帐户和密码 (`admin/P@88w0rd`) 访问 KubeSphere 的 Web 控制台。
{{< notice note >}}
若要访问控制台,您可能需要根据您的环境配置端口转发规则。还请确保在您的安全组中打开了端口 30880。
若要访问控制台,您可能需要根据您的环境配置端口转发规则。还请确保在您的安全组中打开了端口 `30880`
{{</ notice >}}
@ -325,7 +329,11 @@ https://kubesphere.io 20xx-xx-xx xx:xx:xx
KubeKey 不会启用 kubectl 自动补全功能,请参见以下内容并将其打开:
**准备工作**:请确保已安装 bash-autocompletion 并可以正常工作。
{{< notice note >}}
请确保已安装 bash-autocompletion 并可以正常工作。
{{</ notice >}}
```bash
# Install bash-completion
@ -340,5 +348,5 @@ kubectl completion bash >/etc/bash_completion.d/kubectl
详细信息[见此](https://kubernetes.io/docs/tasks/tools/install-kubectl/#enabling-shell-autocompletion)。
## 演示
## 代码演示
<script src="https://asciinema.org/a/364501.js" id="asciicast-364501" async></script>