云原生网关部署新范式丨 Higress 发布 1.1 版本，支持脱离 K8s 部署

news2024/12/27 12:13:13

作者：澄潭

版本特性

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://<nacos_addr>: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

调用链路：

在这里插入图片描述