前提需要安装Docker / Docker Compose
安装 Higress
基于 Docker Compose 部署时,Higress 网关由如下几个服务组成:
- apiserver:基础设施服务。负责模拟 K8s 的 API Server;
- controller:控制面服务一号。负责配置收集整合所有的配置数据和服务列表;
- pilot:控制面服务一号。负责下发网关路由数据;
- gateway:数据面服务。负责承载实际的网关请求;
- console:Higress 网关控制台
安装命令--cd到你想安装到路径,例如:cd /data
curl -fsSL https://higress.io/standalone/get-higress.sh | bash -s -- [DESTINATION] [OPTIONS...]
安装参数
参数名 | 参数说明 | 默认值 |
---|---|---|
DESTINATION | 目标安装目录 | ./higress |
-a --auto-run | 配置完成后自动启动 Higress 网关 | 无 |
-c CONFIG_URL --config-url CONFIG_URL | 配置服务的 URL。 - 若使用独立部署的 Nacos 服务,URL 格式为:nacos://192.168.0.1:8848 - 若在本地磁盘上保存配置,URL 格式为:file://opt/higress/conf | 无 |
--use-builtin-nacos | 使用内置的 Nacos 服务。不建议用于生产环境。如果设置本参数,则无需设置-c 参数 | 无 |
--nacos-ns=NACOS_NAMESPACE | 用于保存 Higress 配置的 Nacos 命名空间 ID | higress-system |
--nacos-username=NACOS_USERNAME | 用于访问 Nacos 的用户名。仅用于 Nacos 启动了认证的情况下 | 无 |
--nacos-password=NACOS_PASSWORD | 用于访问 Nacos 的用户密码。仅用于 Nacos 启动了认证的情况下 | 无 |
-k KEY --data-enc-key=KEY | 用于加密敏感配置数据的密钥。长度必须为 32 个字符。若未设置,Higress 将自动生成一个随机的密钥。若需集群部署,此项必须设置 | 随机字符串 |
-p CONSOLE_PASSWORD --console-password=CONSOLE_PASSWORD | 后续用户访问 Higress Console 的密码(用户名固定为admin ) | 随机字符串 |
--nacos-port=NACOS_PORT | 内置 NACOS 服务在服务器本地监听的端口 | 8848 |
--gateway-http-port=GATEWAY_HTTP_PORT | Higress Gateway 在服务器本地监听的 HTTP 端口 | 80 |
--gateway-https-port=GATEWAY_HTTPS_PORT | Higress Gateway 在服务器本地监听的 HTTPS 端口 | 443 |
--gateway-metrics-port=GATEWAY_METRIC_PORT | Higress Gateway 在服务器本地监听的用于暴露运行指标端口 | 15020 |
--console-port=CONSOLE_PORT | Higress Console 在服务器本地监听的端口 | 8080 |
-r --rerun | 在 Higress 已配置完成后重新执行配置流程 | 无 |
-h --help | 显示帮助信息 | 无 |
执行上面命令后可能会报这样的错误,即使你安装了docker compose 能输出出版本号:
docker: 'compose' is not a docker command.
不要慌,higress文件其实已经下载下来了.
直接使用命令安装:
1.第一次需要先执行配置
/data/higress/bin/configure.sh
其中可以选择使用file/nacos保存配置,里面端口号自己看着调整就行
安装成功结果
Higress is configured successfully.
Usage:
Start: /data/higress/bin/startup.sh
Stop: /data/higress/bin/shutdown.sh
View Component Statuses: /data/higress/bin/status.sh
View Logs: /data/higress/bin/logs.sh
Re-configure: /data/higress/bin/configure.sh -r
Note:
Higress Console Username: admin
Higress Console Password: xxxxxx配置中设置的密码
Happy Higressing!
启动 ---会启动一些镜像服务--higress-xxx
/data/higress/bin/startup.sh
控制台地址: localhost:8080默认的,如果上面使用默认的
进入控制台,配置下面4项
1.域名管理--设置域名
2.服务来源--因为我这服务是docer注册的服务导致路由不生效,这里使用网关IP:端口号进行配置
固定地址 | getway-ip | 网关ip:端口 |
3.服务列表--自动找到
4.路由配置
测试路径格式:
http://域名/应用程序服务路径(网关的访问格式)
官方文档:https://higress.io/zh-cn/docs/ops/deploy-by-docker-compose
官方配demo控制台:
Higress Console