Merge pull request #1815 from serenashe/u2

Update docs: Minimal KS on K8s-3.1.1
This commit is contained in:
KubeSphere CI Bot 2021-07-16 10:48:37 +08:00 committed by GitHub
commit 11032e7263
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
5 changed files with 25 additions and 19 deletions

View File

@ -6,13 +6,16 @@ linkTitle: "Minimal KubeSphere on Kubernetes"
weight: 2200
---
In addition to installing KubeSphere on a Linux machine, you can also deploy it on existing Kubernetes clusters directly. This tutorial demonstrates the general steps of completing a minimal KubeSphere installation on Kubernetes. For more information, see [Installing on Kubernetes](../../installing-on-kubernetes/).
In addition to installing KubeSphere on a Linux machine, you can also deploy it on existing Kubernetes clusters. This tutorial demonstrates the general steps of completing a minimal KubeSphere installation on Kubernetes. For more information, see [Installing on Kubernetes](../../installing-on-kubernetes/).
## Prerequisites
- To install KubeSphere v3.1.1 on Kubernetes, your Kubernetes version must be v1.17.x, v1.18.x, v1.19.x or v1.20.x.
- Make sure your machine meets the minimal hardware requirement: CPU > 1 Core, Memory > 2 GB.
- A **default** Storage Class in your Kubernetes cluster needs to be configured before the installation.
{{< notice note >}}
- To install KubeSphere v3.1.0 on Kubernetes, your Kubernetes version must be v1.17.x, v1.18.x, v1.19.x or v1.20.x.
- Make sure your machine meets the minimal hardware requirement: CPU > 1 Core, Memory > 2 G.
- A **default** Storage Class in your Kubernetes cluster needs to be configured before the installation.
- The CSR signing feature is activated in `kube-apiserver` when it is started with the `--cluster-signing-cert-file` and `--cluster-signing-key-file` parameters. See [RKE installation issue](https://github.com/kubesphere/kubesphere/issues/1925#issuecomment-591698309).
- For more information about the prerequisites of installing KubeSphere on Kubernetes, see [Prerequisites](../../installing-on-kubernetes/introduction/prerequisites/).
@ -24,23 +27,23 @@ In addition to installing KubeSphere on a Linux machine, you can also deploy it
## Deploy KubeSphere
After you make sure your machine meets the prerequisites, you can follow the steps below to install KubeSphere.
After you make sure your machine meets the conditions, perform the following steps to install KubeSphere.
1. Execute the following commands:
1. Run the following commands to start installation:
```bash
kubectl apply -f https://github.com/kubesphere/ks-installer/releases/download/v3.1.0/kubesphere-installer.yaml
kubectl apply -f https://github.com/kubesphere/ks-installer/releases/download/v3.1.1/kubesphere-installer.yaml
kubectl apply -f https://github.com/kubesphere/ks-installer/releases/download/v3.1.0/cluster-configuration.yaml
kubectl apply -f https://github.com/kubesphere/ks-installer/releases/download/v3.1.1/cluster-configuration.yaml
```
2. Inspect the logs of installation:
2. After KubeSphere is successfully installed, you can run the following command to view the installation logs:
```bash
kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l app=ks-install -o jsonpath='{.items[0].metadata.name}') -f
```
3. Use `kubectl get pod --all-namespaces` to see whether all Pods are running normally in relevant namespaces of KubeSphere. If they are, check the port (`30880` by default) of the console through the following command:
3. Use `kubectl get pod --all-namespaces` to see whether all Pods are running normally in relevant namespaces of KubeSphere. If they are, check the port (`30880` by default) of the console by running the following command:
```bash
kubectl get svc/ks-console -n kubesphere-system
@ -54,7 +57,7 @@ After you make sure your machine meets the prerequisites, you can follow the ste
## Enable Pluggable Components (Optional)
The guide above is used only for the minimal installation by default. To enable other components in KubeSphere, see [Enable Pluggable Components](../../pluggable-components/) for more details.
This guide is used only for the minimal installation by default. For more information about how to enable other components in KubeSphere, see [Enable Pluggable Components](../../pluggable-components/).
## Code Demonstration
<script src="https://asciinema.org/a/362122.js" id="asciicast-362122" async></script>

View File

@ -8,12 +8,15 @@ weight: 2200
除了在 Linux 机器上安装 KubeSphere 之外,您还可以将其直接部署在现有的 Kubernetes 集群上。本快速入门指南将引导您完成在 Kubernetes 上最小化安装 KubeSphere 的一般性步骤。有关更多信息,请参见[在 Kubernetes 上安装 KubeSphere](../../installing-on-kubernetes/)。
## Prerequisites
- 如需在 Kubernetes 上安装 KubeSphere v3.1.1,您的 Kubernetes 版本必须为1.17.x、1.18.x、1.19.x 或 1.20.x。
- 确保您的机器满足最低硬件要求CPU > 1 核,内存 > 2 GB。
- 在安装之前,需要配置 Kubernetes 集群中的**默认**存储类型。
{{< notice note >}}
- 如需在 Kubernetes 上安装 KubeSphere v3.1.0,您的 Kubernetes 版本必须为1.17.x、1.18.x、1.19.x 或 1.20.x
- 确保您的机器满足最低硬件要求CPU > 1 核,内存 > 2 G
- 在安装之前,需要配置 Kubernetes 集群中的**默认**存储类型;
- 当使用 `--cluster-signing-cert-file``--cluster-signing-key-file` 参数启动时,在 `kube-apiserver` 中会激活 CSR 签名功能。请参见 [RKE 安装问题](https://github.com/kubesphere/kubesphere/issues/1925#issuecomment-591698309)
- 当使用 `--cluster-signing-cert-file``--cluster-signing-key-file` 参数启动时,在 `kube-apiserver` 中会激活 CSR 签名功能。请参见 [RKE 安装问题](https://github.com/kubesphere/kubesphere/issues/1925#issuecomment-591698309)。
- 有关在 Kubernetes 上安装 KubeSphere 的准备工作,请参见[准备工作](../../installing-on-kubernetes/introduction/prerequisites/)。
{{</ notice >}}
@ -22,12 +25,12 @@ weight: 2200
确保您的机器满足安装的前提条件之后,可以按照以下步骤安装 KubeSphere。
1. 执行以下命令:
1. 执行以下命令开始安装
```bash
kubectl apply -f https://github.com/kubesphere/ks-installer/releases/download/v3.1.0/kubesphere-installer.yaml
kubectl apply -f https://github.com/kubesphere/ks-installer/releases/download/v3.1.1/kubesphere-installer.yaml
kubectl apply -f https://github.com/kubesphere/ks-installer/releases/download/v3.1.0/cluster-configuration.yaml
kubectl apply -f https://github.com/kubesphere/ks-installer/releases/download/v3.1.1/cluster-configuration.yaml
```
2. 检查安装日志:
@ -46,7 +49,7 @@ weight: 2200
5. 登录控制台后,您可以在**服务组件**中检查不同组件的状态。如果要使用相关服务,可能需要等待某些组件启动并运行。
![KubeSphere 组件](/images/docs/zh-cn/quickstart/minimal-kubesphere-on-k8s/kubesphere-components-zh.png)
![kubesphere-components](/images/docs/zh-cn/quickstart/minimal-kubesphere-on-k8s/kubesphere-components.png)
## 启用可插拔组件(可选)

Binary file not shown.

Before

Width:  |  Height:  |  Size: 91 KiB

After

Width:  |  Height:  |  Size: 396 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 235 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 949 KiB