diff --git a/content/en/docs/quick-start/minimal-kubesphere-on-k8s.md b/content/en/docs/quick-start/minimal-kubesphere-on-k8s.md index 0f1f9b67d..ed55cf005 100644 --- a/content/en/docs/quick-start/minimal-kubesphere-on-k8s.md +++ b/content/en/docs/quick-start/minimal-kubesphere-on-k8s.md @@ -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 diff --git a/content/zh/docs/quick-start/minimal-kubesphere-on-k8s.md b/content/zh/docs/quick-start/minimal-kubesphere-on-k8s.md index 0a876d9fb..ce6ce06ff 100644 --- a/content/zh/docs/quick-start/minimal-kubesphere-on-k8s.md +++ b/content/zh/docs/quick-start/minimal-kubesphere-on-k8s.md @@ -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/)。 {{}} @@ -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) ## 启用可插拔组件（可选） diff --git a/static/images/docs/quickstart/minimal-installation-on-k8s/kubesphere-components.png b/static/images/docs/quickstart/minimal-installation-on-k8s/kubesphere-components.png index 9fbc16df5..b63d95e76 100644 Binary files a/static/images/docs/quickstart/minimal-installation-on-k8s/kubesphere-components.png and b/static/images/docs/quickstart/minimal-installation-on-k8s/kubesphere-components.png differ diff --git a/static/images/docs/zh-cn/quickstart/minimal-kubesphere-on-k8s/kubesphere-components-zh.png b/static/images/docs/zh-cn/quickstart/minimal-kubesphere-on-k8s/kubesphere-components-zh.png deleted file mode 100644 index 526eed742..000000000 Binary files a/static/images/docs/zh-cn/quickstart/minimal-kubesphere-on-k8s/kubesphere-components-zh.png and /dev/null differ diff --git a/static/images/docs/zh-cn/quickstart/minimal-kubesphere-on-k8s/kubesphere-components.png b/static/images/docs/zh-cn/quickstart/minimal-kubesphere-on-k8s/kubesphere-components.png new file mode 100644 index 000000000..88ea89f8d Binary files /dev/null and b/static/images/docs/zh-cn/quickstart/minimal-kubesphere-on-k8s/kubesphere-components.png differ