diff --git a/content/en/docs/pluggable-components/app-store.md b/content/en/docs/pluggable-components/app-store.md index 62d540ed7..61fd72ff2 100644 --- a/content/en/docs/pluggable-components/app-store.md +++ b/content/en/docs/pluggable-components/app-store.md @@ -30,7 +30,7 @@ When you implement multi-node installation of KubeSphere on Linux, you need to c ``` {{< notice note >}} -If you adopt [All-in-one Installation](../../quick-start/all-in-one-on-linux/), you do not need to create a config-sample.yaml file as you can create a cluster directly. Generally, the all-in-one mode is for users who are new to KubeSphere and look to get familiar with the system. If you want to enable App Store in this mode (e.g. for testing purpose), refer to the following section to see how App Store can be installed after installation. +If you adopt [All-in-one Installation](../../quick-start/all-in-one-on-linux/), you do not need to create a config-sample.yaml file as you can create a cluster directly. Generally, the all-in-one mode is for users who are new to KubeSphere and look to get familiar with the system. If you want to enable App Store in this mode (e.g. for testing purpose), refer to [the following section](#enable-app-store-after-installation) to see how App Store can be installed after installation. {{}} 2. In this file, navigate to `openpitrix` and change `false` to `true` for `enabled`. Save the file after you finish. diff --git a/content/zh/docs/pluggable-components/app-store.md b/content/zh/docs/pluggable-components/app-store.md index ae03130fa..822374ed9 100644 --- a/content/zh/docs/pluggable-components/app-store.md +++ b/content/zh/docs/pluggable-components/app-store.md @@ -9,106 +9,100 @@ weight: 3515 ## 什么是 KubeSphere 应用商店 -作为一个开源的、以应用为中心的容器平台，KubeSphere 在 [OpenPitrix](https://github.com/openpitrix/openpitrix) 的基础上，为用户提供了一个基于 Helm 的应用商店，用于应用生命周期管理，这是一个开源的基于网络的系统，用于打包、部署和管理不同类型的应用。KubeSphere 应用商店允许 ISV、开发者和用户在一站式服务中只需点击几下就可以上传、测试、部署和发布应用。 +作为一个开源的、以应用为中心的容器平台，KubeSphere 在 [OpenPitrix](https://github.com/openpitrix/openpitrix) 的基础上，为用户提供了一个基于 Helm 的应用商店，用于应用生命周期管理。OpenPitrix 是一个开源的 Web 平台，用于打包、部署和管理不同类型的应用。KubeSphere 应用商店允许 ISV、开发者和用户在一站式服务中只需点击几下就可以上传、测试、部署和发布应用。 -对内，KubeSphere 应用商店可以作为不同团队共享数据、中间件和办公应用的场所。对外，有利于制定行业标准的建设和交付。默认情况下，应用商店中有 15 个应用。启用该功能后，可以通过应用模板添加更多应用。 +对内，KubeSphere 应用商店可以作为不同团队共享数据、中间件和办公应用的场所。对外，有利于制定行业标准的建设和交付。默认情况下，应用商店中内置了 15 个应用。启用该功能后，可以通过应用模板添加更多应用。 ![应用商店](https://ap3.qingstor.com/kubesphere-website/docs/20200828170503.png) -有关更多信息，请参阅应用商店。 +有关更多信息，请参阅[应用商店](../../application-store/)。 ## 在安装前启用应用商店 ### 在 Linux 上安装 -当您在 Linux 上安装 KubeSphere 时，你需要创建一个配置文件，该文件列出了所有 KubeSphere 组件。 +当您在 Linux 上安装多节点 KubeSphere 时，首先需要创建一个配置文件，该文件列出了所有 KubeSphere 组件。 -1. 基于[在 Linux 上安装 KubeSphere](.../.../installing-on-linux/introduction/multioverview/) 的教程，您创建了一个默认文件 **config-sample.yaml**。通过执行以下命令修改该文件： +1. 基于在 [Linux 上安装 KubeSphere](../../installing-on-linux/introduction/multioverview/) 的教程，创建了一个默认文件 **config-sample.yaml**，通过执行以下命令修改该文件： -```bash -vi config-sample.yaml -``` + ```bash + vi config-sample.yaml + ``` -{{< notice note >}} + {{< notice note >}} +如果采用 [All-in-one 安装](../../quick-start/all-in-one-on-linux/)，则不需要创建 `config-sample.yaml` 文件，因为可以直接创建集群。一般来说，All-in-one 模式是为那些刚刚接触 KubeSphere 并希望熟悉系统的用户准备的，如果您想在这个模式下启用应用商店（比如出于测试的目的），可以参考[下面的部分](#在安装后启用应用商店)安装后如何启用应用商店。 + {{}} -如果采用 [All-in-one 安装](.../.../quick-start/all-in-one-on-linux/)，则不需要创建 `config-sample.yaml` 文件，因为可以直接创建集群。一般来说，All-in-one 模式是为那些刚刚接触 KubeSphere 并希望熟悉系统的用户准备的。如果您想在这个模式下启用应用商店（比如出于测试的目的），可以参考下面的部分，看看安装后如何启用应用商店。 +2. 在该文件中，搜寻到`openpitrix`，并将`enabled`的`false`改为`true`，完成后保存文件。 -{{}} + ```bash + openpitrix: + enabled: true # Change "false" to "true" + ``` -2. 在该文件中，搜寻到 `openpitrix`，并将 `enabled` 的 `false` 改为 `true`。完成后保存文件。 +3. 使用配置文件创建集群： -```bash -openpitrix: - enabled: true # Change "false" to "true" -``` - -3. 使用配置文件创建一个集群： - -```bash -./kk create cluster -f config-sample.yaml -``` + ```bash + ./kk create cluster -f config-sample.yaml + ``` ### 在 Kubernetes 上安装 -在 Kubernetes 上安装 KubeSphere 时，需要下载文件 [cluster-configuration.yaml](https://raw.githubusercontent.com/kubesphere/ks-installer/master/deploy/cluster-configuration.yaml) 进行集群设置。如果要安装应用商店，不要直接使用 `kubectl apply -f` 对这个文件进行设置。 +在已有 Kubernetes 集群上安装 KubeSphere 时，需要部署 [ks-installer](https://github.com/kubesphere/ks-installer/) 的两个 yaml 文件，如下面所示。 -1. 参照[在 Kubernetes 上安装 KubeSphere](.../.../installing-on-kubernetes/introduction/overview/) 的教程，先对文件 [kubesphere-installer.yaml](https://raw.githubusercontent.com/kubesphere/ks-installer/master/deploy/kubesphere-installer.yaml) 执行 `kubectl apply -f`。之后，为了启用应用商店，创建一个本地文件 `cluster-configuration.yaml`。 +1. 首先下载 [cluster-configuration.yaml](https://github.com/kubesphere/ks-installer/releases/download/v3.0.0/cluster-configuration.yaml) 文件，然后打开并开始编辑。 -```bash -vi cluster-configuration.yaml -``` + ```bash + vi cluster-configuration.yaml + ``` -2. 将 [cluster-configuration.yaml](https://github.com/kubesphere/ks-installer/releases/download/v3.0.0/cluster-configuration.yaml) 文件中的所有内容复制到刚才创建的本地文件中。 - -3. 在这个本地 `cluster-configuration.yaml` 文件中，搜寻到 `openpitrix`，并将 `enabled` 的 `false` 改为 `true`，启用它们。完成后保存文件。 +2. 在这个本地 `cluster-configuration.yaml` 文件中，搜寻到 `openpitrix`，并将 `enabled` 的 `false` 改为 `true`，完成后保存文件。 -```bash -openpitrix: - enabled: true # Change "false" to "true" -``` + ```bash + openpitrix: + enabled: true # Change "false" to "true" + ``` -4. 执行以下命令开始安装： +3. 执行以下命令开始安装： -```bash -kubectl apply -f cluster-configuration.yaml -``` + ```bash + kubectl apply -f https://github.com/kubesphere/ks-installer/releases/download/v3.0.0/kubesphere-installer.yaml + + kubectl apply -f cluster-configuration.yaml + ``` ## 在安装后启用应用商店 -1. 以 `admin` 身份登录控制台。点击左上角的**平台管理**，选择**集群管理**。 +1. 以`admin`身份登录控制台，点击左上角的**平台管理**，选择**集群管理**。 -![集群管理](https://ap3.qingstor.com/kubesphere-website/docs/20200828111130.png) + ![集群管理](https://ap3.qingstor.com/kubesphere-website/docs/20200828111130.png) -2. 点击 **自定义资源 CRD**，在搜索栏中输入 `clusterconfiguration`。点击结果查看其详细页面。 +2. 点击 **自定义资源 CRD**，在搜索栏中输入`clusterconfiguration`，点击结果查看其详细页面。 -{{< notice info >}} + {{< notice info >}} +自定义资源定义（CRD）允许用户在不增加额外的 API 服务器的情况下创建一种新的资源类型，用户可以像使用其它 Kubernetes 内置对象一样使用这些自定义资源。 + {{}} -自定义资源定义（CRD）允许用户在不增加另一个 API 服务器的情况下创建一种新的资源类型。他们可以像其他任何本地 Kubernetes 对象一样使用这些资源。 +3. 在**资源列表**中，点击`ks-installer`右边的三个点，选择**编辑 YAML**。 -{{}} + ![编辑 YAML](https://ap3.qingstor.com/kubesphere-website/docs/20200827182002.png) -3. 在**资源列表**中，点击 `ks-installer` 右边的三个点，选择**编辑 YAML**。 +4. 在这个 YAML 文件中，搜寻到`openpitrix`，将`enabled`的`false`改为`true`。完成后，点击右下角的**更新**，保存配置。 -![编辑 YAML](https://ap3.qingstor.com/kubesphere-website/docs/20200827182002.png) - -4. 在这个 YAML 文件中，搜寻到 `openpitrix`，将 `enabled` 的 `false` 改为 `true`。完成后，点击右下角的**更新**，保存配置。 - -```bash -openpitrix: - enabled: true # Change "false" to "true" -``` + ```bash + openpitrix: + enabled: true # Change "false" to "true" + ``` 5. 您可以通过执行以下命令，使用 Web Kubectl 工具来检查安装过程： -```bash -kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l app=ks-install -o jsonpath='{.items[0].metadata.name}') -f -``` - -{{< notice tip >}} + ```bash + kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l app=ks-install -o jsonpath='{.items[0].metadata.name}') -f + ``` + {{< notice tip >}} 您可以通过点击控制台右下角的锤子图标找到 Kubectl 工具。 - -{{}} + {{}} ## 验证组件的安装 @@ -116,7 +110,7 @@ kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l app= {{< tab "在仪表板中验证组件的安装" >}} -进入**服务组件**，检查 **OpenPitrix** 的状态。您可能会看到如下图片： +进入**服务组件**，检查 **OpenPitrix** 的状态，可以看到如下类似图片： ![openpitrix](https://ap3.qingstor.com/kubesphere-website/docs/20200829124018.png) @@ -130,7 +124,7 @@ kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l app= kubectl get pod -n openpitrix-system ``` -如果组件运行成功，输出结果可能如下： +如果组件运行成功，输出结果如下： ```bash NAME READY STATUS RESTARTS AGE diff --git a/content/zh/docs/quick-start/enable-pluggable-components.md b/content/zh/docs/quick-start/enable-pluggable-components.md index b9b583b6d..9c10090eb 100644 --- a/content/zh/docs/quick-start/enable-pluggable-components.md +++ b/content/zh/docs/quick-start/enable-pluggable-components.md @@ -138,7 +138,7 @@ KubeSphere Web 控制台使用户更方便来查看和使用不同的资源。 ##################################################### ``` -7. 在 **服务组件** 中可以查看不同组件的状态。 +7. 在**服务组件**中可以查看不同组件的状态。 ![components](/images/docs/quickstart/kubesphere-components-zh.png)