diff --git a/content/zh/docs/application-store/built-in-apps/nginx-app.md b/content/zh/docs/application-store/built-in-apps/nginx-app.md new file mode 100644 index 000000000..dc77acbc0 --- /dev/null +++ b/content/zh/docs/application-store/built-in-apps/nginx-app.md @@ -0,0 +1,82 @@ +--- +title: "在 KubeSphere 中部署 NGINX" +keywords: 'KubeSphere, Kubernetes, 安装, NGINX' +description: '如何从 KubeSphere 应用商店部署 NGINX' +linkTitle: "在 KubeSphere 中部署 NGINX" +weight: 14270 +--- + +[NGINX](https://www.nginx.com/) 是一个开源软件应用，用于 Web 服务、反向代理、缓存、负载均衡、流媒体等。 + +本教程演示如何从 KubeSphere 应用商店部署 NGINX。 + +## 准备工作 + +- 请确保[已启用 OpenPitrix 系统](../../../pluggable-components/app-store/)。 +- 您需要创建一个企业空间、一个项目和一个用户帐户 (`project-regular`) 供本教程操作使用。该帐户需要是平台普通用户，并邀请至项目中赋予 `operator` 角色作为项目操作员。本教程中，请以 `project-regular` 身份登录控制台，在企业空间 `demo-workspace` 中的 `demo-project` 项目中进行操作。有关更多信息，请参见[创建企业空间、项目、帐户和角色](../../../quick-start/create-workspace-and-project/)。 + +## 动手实验 + +### 步骤 1：从应用商店中部署 NGINX + +1. 在 `demo-project` 项目的**概览**页面，点击左上角的**应用商店**。 + + ![应用商店](/images/docs/zh-cn/appstore/built-in-apps/nginx-app/app-store.PNG) + +2. 找到 NGINX，点击**应用信息**页面上的**部署**。 + + ![应用商店中的 Nginx](/images/docs/zh-cn/appstore/built-in-apps/nginx-app/nginx-in-app-store.PNG) + + ![部署 Nginx](/images/docs/zh-cn/appstore/built-in-apps/nginx-app/deploy-nginx.PNG) + +3. 设置名称并选择应用版本。请确保将 NGINX 部署在 `demo-project` 中，点击**下一步**。 + + ![确认部署](/images/docs/zh-cn/appstore/built-in-apps/nginx-app/confirm-deployment.PNG) + +4. 在**应用配置**页面，指定要为该应用部署的副本数量，根据需要启用应用路由 (Ingress)。操作完成后，点击**部署**。 + + ![编辑 Nginx 配置](/images/docs/zh-cn/appstore/built-in-apps/nginx-app/edit-config-nginx.PNG) + + ![清单文件](/images/docs/zh-cn/appstore/built-in-apps/nginx-app/manifest-file.PNG) + + {{< notice note >}} + + 要为 NGINX 指定更多值，请打开右上角的拨动开关，查看 YAML 格式的应用清单文件，编辑其配置。 + + {{}} + +5. 稍等片刻待 NGINX 启动并运行。 + + ![Nginx 运行中](/images/docs/zh-cn/appstore/built-in-apps/nginx-app/nginx-running.PNG) + +### 步骤 2：访问 NGINX + +要从集群外部访问 NGINX，您需要先通过 NodePort 暴露该应用。 + +1. 转到**服务**页面，点击 NGINX 的服务名称。 + + ![Nginx 服务](/images/docs/zh-cn/appstore/built-in-apps/nginx-app/nginx-service.PNG) + +2. 在服务详情页面，点击**更多操作**，在下拉菜单中选择**编辑外网访问**。 + + ![编辑外网访问](/images/docs/zh-cn/appstore/built-in-apps/nginx-app/edit-internet-access.PNG) + +3. **访问方式**选择 **NodePort**，然后点击**确定**。有关更多信息，请参见[项目网关](../../../project-administration/project-gateway/)。 + + ![nodeport](/images/docs/zh-cn/appstore/built-in-apps/nginx-app/nodeport.PNG) + +4. 在**服务端口**下，您可以查看已暴露的端口。 + + ![暴露端口](/images/docs/zh-cn/appstore/built-in-apps/nginx-app/exposed-port.PNG) + +5. 通过 `{$NodeIP}:{$Nodeport}` 访问 NGINX。 + + ![访问 Nginx](/images/docs/zh-cn/appstore/built-in-apps/nginx-app/access-nginx.PNG) + + {{< notice note >}} + + 取决于您的 Kubernetes 集群的部署位置，您可能需要在安全组中放行端口并配置相关的端口转发规则。 + + {{}} + +6. 有关更多信息，请参见 [NGINX 官方文档](https://docs.nginx.com/?_ga=2.48327718.1445131049.1605510038-1186152749.1605510038)。 diff --git a/content/zh/docs/application-store/built-in-apps/在kubesphere中部署Nginx.md b/content/zh/docs/application-store/built-in-apps/在kubesphere中部署Nginx.md deleted file mode 100644 index 713438967..000000000 --- a/content/zh/docs/application-store/built-in-apps/在kubesphere中部署Nginx.md +++ /dev/null @@ -1,74 +0,0 @@ ---- -title: "在 KubeSphere 中部署 Nginx" -keywords: 'Nginx，应用商店，OpenPitrix，Kubernetes' -description: '使用 KubeSphere 应用商店部署 Nginx 至 Kubernetes' - - -weight: 14270 ---- - -本文介绍在 **kubesphere** 中通过应用商店部署 **Nginx** 的操作步骤。 - -## 前提条件 - -- 已安装了 **OpenPitrix**（应用商店）功能组件。若未开启**应用商店**功能组件，可参考[开启组件](https://kubesphere.io/docs/pluggable-components/app-store/)进行开启。 -- 已创建了单集群企业空间、单集群项目和普通用户 `project-regular` 账号。 -- 使用项目管理员 `project-admin` 邀请项目普通用户 `project-regular` 加入项目并授予 `operator` 角色。 - -## 操作说明 - -1. 使用 `project-regular` 账号进入已创建的项目 `demo-project ` 后，选择**应用负载**，点击**应用**，点击 **部署新应用**，然后在弹窗中选择 **来自应用商店**。 - - ![image-20201021143257502](https://sh1a.qingstor.com/ks-website-image/pic/image-20201021143257502.png) - -2. 进入应用商店页面。 - - ![image-20201026100924696](https://sh1a.qingstor.com/ks-website-image/pic/image-20201026100924696.png) - -3. 选择并点击 **nginx** 应用，进入应用信息页面。 - - ![image-20201026101911123](https://sh1a.qingstor.com/ks-website-image/pic/image-20201026101911123.png) - - 在**应用详情**--**配置文件**中，可以查看 **Nginx** 应用的 **helm chart** 的配置文件。 - - ![image-20201026101940403](https://sh1a.qingstor.com/ks-website-image/pic/image-20201026101940403.png) - -4. 点击页面右上角的**部署**按钮，进入基本信息设置页面。 - - 在此页面中，你可进行如下设置： - - - 在应用名称输入框中，可修改应用名称； - - 当应用包含多个版本时，可点击应用版本下拉框，选择所需的版本进行部署； - - 在描述信息中，可设置部署应用的描述信息； - - 点击部署位置，可选择应用部署的企业空间和项目。 - - ![image-20201026102012448](https://sh1a.qingstor.com/ks-website-image/pic/image-20201026102012448.png) - -5. 点击**下一步**，进入到应用配置页面。 - - 目前，支持 2 种配置方式：可视化配置和 yaml 配置。通过点击 **YAML** 按钮，来实现配置方式的转换。 - - 在应用配置页面中，可设置 nginx 的副本数，并设置是否开启 Ingress。 - - ![image-20201026102039163](https://sh1a.qingstor.com/ks-website-image/pic/image-20201026102039163.png) - - ![image-20201026102122480](https://sh1a.qingstor.com/ks-website-image/pic/image-20201026102122480.png) - -6. 点击**部署**，自动跳转到 `demo-project` 的应用列表页面。 - - 在应用列表中，可以查看应用状态为**创建中**； - - 待应用部署完成后，应用的状态会更新为**活跃**状态。 - - ![image-20201026101525181](https://sh1a.qingstor.com/ks-website-image/pic/image-20201026101525181.png) - -## 使用 Nginx - -1. 在服务列表中，选择 nginx 应用对应的服务，设置外网访问方式为 **nodeport**。示例中，nodeport 为 31034。 - - ![image-20201026110147496](https://sh1a.qingstor.com/ks-website-image/pic/image-20201026110147496.png) - -2. 可以通过 < kubesphere 集群 IP > : < nodeport 端口> 来访问 nginx。 - - ![image-20201026110323363](https://sh1a.qingstor.com/ks-website-image/pic/image-20201026110323363.png) - diff --git a/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/access-nginx.PNG b/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/access-nginx.PNG new file mode 100644 index 000000000..67000dd9a Binary files /dev/null and b/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/access-nginx.PNG differ diff --git a/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/app-store.PNG b/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/app-store.PNG new file mode 100644 index 000000000..a71e1538f Binary files /dev/null and b/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/app-store.PNG differ diff --git a/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/confirm-deployment.PNG b/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/confirm-deployment.PNG new file mode 100644 index 000000000..868764489 Binary files /dev/null and b/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/confirm-deployment.PNG differ diff --git a/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/deploy-nginx.PNG b/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/deploy-nginx.PNG new file mode 100644 index 000000000..0370d3a13 Binary files /dev/null and b/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/deploy-nginx.PNG differ diff --git a/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/edit-config-nginx.PNG b/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/edit-config-nginx.PNG new file mode 100644 index 000000000..d3259fec1 Binary files /dev/null and b/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/edit-config-nginx.PNG differ diff --git a/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/edit-internet-access.PNG b/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/edit-internet-access.PNG new file mode 100644 index 000000000..4fc2cc0d4 Binary files /dev/null and b/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/edit-internet-access.PNG differ diff --git a/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/exposed-port.PNG b/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/exposed-port.PNG new file mode 100644 index 000000000..ff9449c5a Binary files /dev/null and b/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/exposed-port.PNG differ diff --git a/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/manifest-file.PNG b/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/manifest-file.PNG new file mode 100644 index 000000000..1cc5e7fde Binary files /dev/null and b/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/manifest-file.PNG differ diff --git a/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/nginx-in-app-store.PNG b/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/nginx-in-app-store.PNG new file mode 100644 index 000000000..930fbc9eb Binary files /dev/null and b/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/nginx-in-app-store.PNG differ diff --git a/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/nginx-running.PNG b/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/nginx-running.PNG new file mode 100644 index 000000000..60473e439 Binary files /dev/null and b/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/nginx-running.PNG differ diff --git a/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/nginx-service.PNG b/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/nginx-service.PNG new file mode 100644 index 000000000..b87559316 Binary files /dev/null and b/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/nginx-service.PNG differ diff --git a/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/nodeport.PNG b/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/nodeport.PNG new file mode 100644 index 000000000..3644e59d5 Binary files /dev/null and b/static/images/docs/zh-cn/appstore/built-in-apps/nginx-app/nodeport.PNG differ