From 7d17693751afd24bb0465696c1c2d6126e5d50cc Mon Sep 17 00:00:00 2001 From: hanans426 <32064961+hanans426@users.noreply.github.com> Date: Wed, 13 Nov 2024 17:38:01 +0800 Subject: [PATCH] add deployment on aliyun (#345) --- .../en/ops/deploy-by-aliyun-computenest.md | 35 +++++++++++++ src/content/docs/latest/en/user/quickstart.md | 5 ++ .../zh-cn/ops/deploy-by-aliyun-computenest.md | 35 +++++++++++++ .../docs/latest/zh-cn/user/quickstart.md | 52 +++++++++---------- 4 files changed, 100 insertions(+), 27 deletions(-) create mode 100644 src/content/docs/latest/en/ops/deploy-by-aliyun-computenest.md create mode 100644 src/content/docs/latest/zh-cn/ops/deploy-by-aliyun-computenest.md diff --git a/src/content/docs/latest/en/ops/deploy-by-aliyun-computenest.md b/src/content/docs/latest/en/ops/deploy-by-aliyun-computenest.md new file mode 100644 index 0000000000..db03db6dc3 --- /dev/null +++ b/src/content/docs/latest/en/ops/deploy-by-aliyun-computenest.md @@ -0,0 +1,35 @@ +--- +title: Rapid deployment through Aliyun ComputeNest +keywords: [deploy,docker compose,docker,ops,aliyun,computenest] +description: How to Use Aliyun ComputeNest to Rapidly Deploy Higress. +custom_edit_url: https://github.com/higress-group/higress-group.github.io/blob/main/i18n/en/docusaurus-plugin-content-docs/current/ops/deploy-by-aliyun-computenest.md +--- + +# Rapid deployment through Aliyun ComputeNest + +Aliyun ComputeNest is an open PaaS platform for service providers and users that provides software delivery, deployment, and operation process standardization capabilities. It supports the integration of software and resources for one-stop delivery, enabling truly out-of-the-box software usage. +Through Aliyun ComputeNest, a one-click deployment solution for Higress is provided, with support for visual configuration parameters for quick deployment of Higress.。 + +> **Note** +> This quick deployment solution is currently based on Docker Compose deployment, and will support cloud-native deployment based on Helm in the future. + +## Deployment steps +- Click the deployment link to enter the service instance deployment page。 + + [![Deploy on AlibabaCloud ComputeNest](https://service-info-public.oss-cn-hangzhou.aliyuncs.com/computenest-en.svg)](https://computenest.console.aliyun.com/service/instance/create/default?type=user&ServiceName=Higress社区版) + +- According to the interface prompt, fill in the parameters to complete the deployment. + Select a resource type and configure an ECS instance password.. + ![image](https://github.com/aliyun-computenest/quickstart-higress/blob/main/docs/img1.jpg) + Configure the Nacos service. If you do not have an independently deployed Nacos service, you can use the built-in Nacos service. + ![image](https://github.com/aliyun-computenest/quickstart-higress/blob/main/docs/img2.jpg) + If the Nacos service is deployed independently, set the IP address of the Nacos service. If authentication is enabled for Nacos, enter the username and password. + ![image](https://github.com/aliyun-computenest/quickstart-higress/blob/main/docs/img3.png) + Finally, configure the zone. You can create a new VPC or use an existing VPC. + ![image](https://github.com/aliyun-computenest/quickstart-higress/blob/main/docs/img4.png) +- After the service instance is created, go to the service instance details page. On the Overview page, you can obtain the login information of the Higress. + ![image](https://github.com/aliyun-computenest/quickstart-higress/blob/main/docs/img5.png) + ![image](https://github.com/aliyun-computenest/quickstart-higress/blob/main/docs/img6.png) + + + diff --git a/src/content/docs/latest/en/user/quickstart.md b/src/content/docs/latest/en/user/quickstart.md index 03d37b4fa5..77caf36b99 100644 --- a/src/content/docs/latest/en/user/quickstart.md +++ b/src/content/docs/latest/en/user/quickstart.md @@ -232,6 +232,11 @@ curl -fsSL https://higress.io/standalone/get-higress.sh | bash -s -- -a --use-bu Note: On Windows, you can use Unix-like shells such as Cygwin, Git Bash to execute the command above. +**One-click deployment：** +We provide a one-click deployment to Alibaba Cloud solution, more convenient operation + +[![Deploy on AlibabaCloud ComputeNest](https://service-info-public.oss-cn-hangzhou.aliyuncs.com/computenest-en.svg)](https://computenest.console.aliyun.com/service/instance/create/default?type=user&ServiceName=Higress社区版) + ### Stage 2: Configuration Open `http://127.0.0.1:8080` in browser. For the first time, you will need to configure the admin credentials. diff --git a/src/content/docs/latest/zh-cn/ops/deploy-by-aliyun-computenest.md b/src/content/docs/latest/zh-cn/ops/deploy-by-aliyun-computenest.md new file mode 100644 index 0000000000..daaaf471fa --- /dev/null +++ b/src/content/docs/latest/zh-cn/ops/deploy-by-aliyun-computenest.md @@ -0,0 +1,35 @@ +--- +title: 通过阿里云计算巢快速部署 +keywords: [deploy,docker compose,docker,ops, 阿里云,计算巢] +description: 如何使用阿里云计算巢实现Higress的快速部署 +custom_edit_url: https://github.com/higress-group/higress-group.github.io/blob/main/i18n/zh-cn/docusaurus-plugin-content-docs/current/ops/deploy-by-aliyun-computenest.md +--- + +# 通过阿里云计算巢快速部署 + +阿里云计算巢是一个开放给服务商和用户的服务管理PaaS平台，提供软件的交付、部署、运维流程标准化等能力，支持软件和资源的一体化交付，真正实现了软件的开箱即用。 +通过阿里云计算巢，提供了一键部署Higress的解决方案，支持可视化配置参数，快速部署Higress。 + +> **注意** +> 本快速部署方案暂时基于Docker Compose部署的，后续将会支持基于Helm进行云原生部署。 + +## 部署步骤 +- 点击部署链接，进入部署页面。 + + [![Deploy on AlibabaCloud ComputeNest](https://service-info-public.oss-cn-hangzhou.aliyuncs.com/computenest.svg)](https://computenest.console.aliyun.com/service/instance/create/default?type=user&ServiceName=Higress社区版) + +- 部署页面中，根据界面提示，填写配置参数并提交订单。 + 选择资源类型并配置ECS实例密码. + ![image](https://github.com/aliyun-computenest/quickstart-higress/blob/main/docs/img1.jpg) + 配置Nacos服务，如果没有独立部署的Nacos服务，可以使用内置的Nacos服务，但不建议生产环境下使用 + ![image](https://github.com/aliyun-computenest/quickstart-higress/blob/main/docs/img2.jpg) + 若有独立部署的Nacos服务，设置Nacos服务的Ip地址，如果Nacos开启了鉴权认证，则需要填写用户名和密码 + ![image](https://github.com/aliyun-computenest/quickstart-higress/blob/main/docs/img3.png) + 最后配置可用区，可选择新建VPC，也可使用已有的VPC. + ![image](https://github.com/aliyun-computenest/quickstart-higress/blob/main/docs/img4.png) +- 等到服务实例部署成功, 进入服务实例详情页，获取Higress的登录信息。 + ![image](https://github.com/aliyun-computenest/quickstart-higress/blob/main/docs/img5.png) + ![image](https://github.com/aliyun-computenest/quickstart-higress/blob/main/docs/img6.png) + + + diff --git a/src/content/docs/latest/zh-cn/user/quickstart.md b/src/content/docs/latest/zh-cn/user/quickstart.md index db9519dc72..2b493eb6bd 100644 --- a/src/content/docs/latest/zh-cn/user/quickstart.md +++ b/src/content/docs/latest/zh-cn/user/quickstart.md @@ -17,16 +17,12 @@ toc_max_heading_level: 4 **Helm 安装命令** ```bash -helm repo add higress.io https://higress.io/helm-charts +helm repo add higress.io https://higress.cn/helm-charts helm install higress -n higress-system higress.io/higress --create-namespace --render-subchart-notes ``` -> 中国大陆用户可以使用以下方法加速安装： -> -> ```bash -> helm repo add higress.cn https://higress.cn/helm-charts -> helm upgrade --install higress -n higress-system higress.cn/higress --create-namespace --render-subchart-notes -> ``` +**Higress 的所有 Docker 镜像都一直使用自己独享的仓库，不受 Docker Hub 境内访问受限的影响** + 获取 Higress Gateway 的 LoadBalancer IP，并记录下来。后续可以通过该 IP 的 80 和 443 端口访问 Higress Gateway。 ```bash @@ -233,34 +229,44 @@ spec: curl http://GatewayIP/foo -H 'host: foo.bar.com' ``` -## 环境二：脱离 K8s 在 Docker Compose 中使用 -> **注意** -> -> Standalone 模式没有大规模生产使用过，目前主要用于本地部署测试的场景，如果生产部署更建议[云原生模式](https://higress.io/zh-cn/docs/ops/deploy-by-helm)部署 +## 环境二：脱离 K8s 使用 ### 阶段一：安装 -**安装命令一：使用独立部署的 Nacos** +如果您是在云上部署，生产环境推荐使用企业版（无需 K8s），开发测试可以使用下面一键部署社区版： + +[![Deploy on AlibabaCloud ComputeNest](https://service-info-public.oss-cn-hangzhou.aliyuncs.com/computenest.svg)](https://computenest.console.aliyun.com/service/instance/create/default?type=user&ServiceName=Higress社区版) + +本地开发可以使用极简方式部署，基于本地文件做配置存储： ```bash -curl -fsSL https://higress.io/standalone/get-higress.sh | bash -s -- -a -c nacos://192.168.0.1:8848 --nacos-username=nacos --nacos-password=nacos +# 创建一个工作目录 +mkdir higress; cd higress +# 启动 higress，配置文件会写到工作目录下 +docker run -d --rm --name higress-ai -v ${PWD}:/data \ + -p 8001:8001 -p 8080:8080 -p 8443:8443 \ + higress-registry.cn-hangzhou.cr.aliyuncs.com/higress/all-in-one:latest + ``` +监听端口说明如下： -请将 `192.168.0.1` 替换为 Nacos 服务器的 IP（如果 Nacos 部署在本机，请不要使用如 `localhost` 或 `127.0.0.1` 的 Loopback 地址），并按需调整 `--nacos-username` 和 `--nacos-password` 的取值。如果 Nacos 服务未开启认证功能，则可以移除这两个参数。 +- 8001 端口：Higress UI 控制台入口 +- 8080 端口：网关 HTTP 协议入口 +- 8443 端口：网关 HTTPS 协议入口 -**安装命令二：使用 Higress 内置 Nacos** +或者使用下面方式，对接 Nacos 做配置存储： ```bash -curl -fsSL https://higress.io/standalone/get-higress.sh | bash -s -- -a --use-builtin-nacos +curl -fsSL https://higress.io/standalone/get-higress.sh | bash -s -- -a -c nacos://192.168.0.1:8848 --nacos-username=nacos --nacos-password=nacos ``` -注：Windows 系统下可以使用 Cygwin、Git Bash 等类 Unix Shell 中执行上述命令。 +请将 `192.168.0.1` 替换为 Nacos 服务器的 IP（如果 Nacos 部署在本机，请不要使用如 `localhost` 或 `127.0.0.1` 的 Loopback 地址），并按需调整 `--nacos-username` 和 `--nacos-password` 的取值。如果 Nacos 服务未开启认证功能，则可以移除这两个参数。 -### 阶段二：配置 -在浏览器中输入`http://127.0.0.1:8080` 进入 Higress 控制台。首次访问时需要先初始化管理员账号。 +### 阶段二：配置 +进入 Higress 控制台。首次访问时需要先初始化管理员账号。 ![image](/img/user/quickstart/zh-cn/init.png) 初始化完成后，界面会自动跳转至登录页面。请使用前面设置的用户名密码登录 Higress 控制台。 @@ -279,11 +285,3 @@ curl -fsSL https://higress.io/standalone/get-higress.sh | bash -s -- -a --use-bu ![image](/img/user/quickstart/zh-cn/route_management_standalone.png) -### 阶段三：请求验证 - -执行以下命令，验证测试路由可以正常工作： - -```bash -# should output a JSON object containing request data -curl http://localhost/get?foo=bar -H 'host: foo.bar.com' -```