作者:澄潭
版本特性
Higress 1.1.0 版本已经 Release,K8s 环境下可以使用以下命令将 Higress 升级到最新版本:
kubectl apply -f https://github.com/alibaba/higress/releases/download/v1.1.0/customresourcedefinitions.gen.yaml
helm repo update
helm upgrade higress -n higress-system higress.io/higress
下面介绍该版本的核心特性:
支持非 K8s 部署
在 K8s 部署模式下,Higress 已经支持基于 Nacos 进行服务发现,可以打通 Spring Cloud/Dubbo 等微服务生态。Nacos 作为微服务生态的集大成者,既可以作为注册中心,又可以作为配置中心,在非 K8s 环境下,如果将路由、插件等配置存入 Nacos 中,用户只需一个 Higress 和一个 Nacos 即可搞定一切:
在 1.1 版本中,Higress 就实现了这个能力,如上图所示,在这个架构中,Nacos 同时可以作为路由配置来源和服务 IP 来源,因为在 Nacos 中存储路由配置也是用了 Ingress API 这套基础 API 抽象,目前 Higress 在 K8s 上可以实现的能力,基于这套架构一样可以搞定。
使用一行命令即可完成非 K8s 环境下的部署(兼容 macOS 和 Linux,Windows 需要安装 Cygwin):
curl -fsSL https://higress.io/standalone/get-higress.sh | bash -s -- -c nacos://:8848
-c 参数用于指定非 K8s 场景下的配置存储来源,以 Nacos 为例,通过 nacos:// 指定即可,这种模式下,Higress 的所有配置都将存储在 Nacos 中,后续还将支持 ETCD/Consul等配置来源。
更多的参数可以通过 -h 参数查看,具体如下:
Usage: bash [DIR] [OPTIONS...]
Install Higress (standalone version) into the DIR (the current directory by default).
-c, --config-url=URL URL of the Nacos service
format: nacos://192.168.0.1:8848
--use-builtin-nacos use the built-in Nacos service instead of
an external one
--nacos-ns=NACOS-NAMESPACE
the ID of Nacos namespace to store configurations
default to "higress-system" if unspecified
--nacos-username=NACOS-USERNAME
the username used to access Nacos
only needed if auth is enabled in Nacos
--nacos-password=NACOS-PASSWORD
the password used to access Nacos
only needed if auth is enabled in Nacos
-k, --data-enc-key=KEY the key used to encrypt sensitive configurations
MUST contain 32 characters
A random key will be generated if unspecified
-p, --console-password=CONSOLE-PASSWORD
the password to be used to visit Higress Console
default to "admin" if unspecified
-h, --help give this help list
启动成功后,本机端口占用情况如下:
- 80 端口:Higress Gateway 暴露,用于 HTTP 协议代理
- 443 端口:Higress Gateway 暴露,用于 HTTPS 协议代理
- 15020 端口:Higress Gateway 暴露,用于暴露 Prometheus 指标 (http://node_ip:15020/stats/prometheus)
- 8080 端口:Higress Console 暴露,用于 Higress 控制台管理
让我们在本地启动一个 SpringCloud 服务注册到这个 Nacos 上:
在 Higress 控制台的服务列表也可以看到这个服务(Higress 默认配置监听启动参数指定的 Nacos 的 public 命名空间,可以在服务来源中新增其他命名空间):
创建路由指向这个服务:
测试路由成功:
Http to Dubbo 配置简化
在之前的版本里,使用 Http to Dubbo 的能力,需要开启 Istio CRD,然后通过 Envoyfilter 进行配置;新版本 Higress 增加了 Http2Rpc 这个 CRD,实现了 Http to Dubbo 的配置简化。
假设我们现在已经部署了如下一个 Dubbo 服务,其服务名为com.alibaba.nacos.example.dubbo.service.DemoService,并指定了该服务的 version 为“1.0.0”,group 为“dev”:
interface:
package com.alibaba.nacos.example.dubbo.service;
public interface DemoService {
String sayName(String name);
}
implement:
@DubboService(version = "${demo.service.version}", group = "${demo.service.group}")
public class DefaultService implements DemoService {
@Value("${demo.service.name}")
private String serviceName;
public String sayName(String name) {
RpcContext rpcContext = RpcContext.getContext();
return String.format("Service [name :%s , port : %d] %s("%s") : Hello,%s",
serviceName,
rpcContext.getLocalPort(),
rpcContext.getMethodName(),
name,
name);
}
}
创建 Http2Rpc CRD
apiVersion: networking.higress.io/v1
kind: Http2Rpc
metadata:
name: httproute-http2rpc-demo
namespace: higress-system
spec:
dubbo:
service: com.alibaba.nacos.example.dubbo.service.DemoService
version: 1.0.0
group: dev
methods:
- serviceMethod: sayName
headersAttach: "*"
httpMethods:
- "GET"
httpPath: "/dubbo/sayName"
params:
- paramKey: name
paramSource: QUERY
paramType: "java.lang.String"
创建 Ingress 关联 Http2Rpc
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
annotations:
higress.io/destination: providers:com.alibaba.nacos.example.dubbo.service.DemoService:1.0.0:dev.DEFAULT-GROUP.public.nacos
higress.io/rpc-destination-name: httproute-http2rpc-demo
name: httproute-http2rpc-demo-ingress
namespace: higress-system
spec:
ingressClassName: higress
rules:
- http:
paths:
- backend:
resource:
apiGroup: networking.higress.io
kind: McpBridge
name: default
path: /dubbo
pathType: Prefix
通过以上配置,我们就可以执行以下 curl 命令来调用这个 dubbo 服务了:
$curl "localhost/dubbo/sayName?name=abc"
{"result":"Service [name :demoService , port : 20880] sayName("abc") : Hello,abc"}
支持 SkyWalking Tracing 配置
对 Higress 的全局配置 ConfigMap 对象 higress-config 做如下配置即可开启 SkyWalking Tracing:
apiVersion: v1
data:
higress: |-
tracing:
enable: true
sampling: 100
timeout: 500
skywalking:
service: skywalking-oap-server.op-system.svc.cluster.local
port: 11800
...
...
kind: ConfigMap
metadata:
name: higress-config
namespace: higress-system
调用链路:
调用链路拓扑:
后续版本 Roadmap
目前确定的后续版本核心功能如下,欢迎在:github.com/alibaba/hig… 下提出你期待的功能,我们将实时更新后续 Roadmap。
社区近期活动
Wasm 插件编程挑战赛,赢取 12w 奖金池
了解详情:tianchi.aliyun.com/competition…