Spring Cloud Gateway系列【11】网关管理API

前言

Spring Cloud Gateway 提供了很多API 用来管理网关，在org.springframework.cloud.gateway.actuate包中，可以看到提供了一些访问API。

管理API

需要配置spring-boot-starter-actuator，公开这些访问端点，首先添加Pom:

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-actuator</artifactId>
        </dependency>

然后在YML中公开这些端点：

management:
  endpoint:
    health:
      # 是否显示health详细信息
      show-details: always
      show-components: always
    gateway:
      enabled: true
  endpoints:
    # Web端点的配置属性
    web:
      exposure:
        #  开放端点的ID集合（eg:['health','info','beans','env']），配置为“*”表示全部
        include: '*'

1. 查询所有路由

可以通过 GET /actuator/gateway/routes查询到所有路由信息：

https://localhost:8443/actuator/gateway/routes

示例如下：

[
    {
        "predicate": "Paths: [/app-service001/**], match trailing slash: true",
        "metadata": {
            "nacos.instanceId": "192.168.58.1#9000#DEFAULT#DEFAULT_GROUP@@app-service001",
            "nacos.weight": "1.0",
            "nacos.cluster": "DEFAULT",
            "nacos.ephemeral": "true",
            "nacos.healthy": "true",
            "preserved.register.source": "SPRING_CLOUD",
            "secure": "true"
        },
        "route_id": "ReactiveCompositeDiscoveryClient_app-service001",
        "filters": [
            "[[RewritePath /app-service001/?(?<remaining>.*) = '/${remaining}'], order = 1]"
        ],
        "uri": "lb://app-service001",
        "order": 0
    }
]

2. 查询过滤器

可以通过 GET /actuator/gateway/globalfilters查询到已注入的所有全局过滤器：

https://localhost:8443/actuator/gateway/globalfilters

示例如下：

{
    "org.springframework.cloud.gateway.filter.NettyWriteResponseFilter@1fb2eec": -1,
    "org.springframework.cloud.gateway.filter.RouteToRequestUrlFilter@2a0b901c": 10000,
    "org.springframework.cloud.gateway.filter.AdaptCachedBodyGlobalFilter@4026461d": -2147482648,
    "org.springframework.cloud.gateway.filter.ForwardPathFilter@6544899b": 0,
    "org.springframework.cloud.gateway.filter.WebsocketRoutingFilter@6da54910": 2147483646,
    "org.springframework.cloud.gateway.filter.RemoveCachedBodyFilter@4c18516": -2147483648,
    "org.springframework.cloud.gateway.filter.ReactiveLoadBalancerClientFilter@752b69e3": 10150,
    "org.springframework.cloud.gateway.filter.GatewayMetricsFilter@1bd8afc8": 0,
    "org.springframework.cloud.gateway.filter.NettyRoutingFilter@15605d83": 2147483647,
    "org.springframework.cloud.gateway.filter.ForwardRoutingFilter@3d104c9b": 2147483647
}

可以通过 GET /actuator/gateway/routefilters查询到已注入的所有网关过滤器：

https://localhost:8443/actuator/gateway/routefilters

示例如下：

{
    "[RemoveRequestHeaderGatewayFilterFactory@454bcbbf configClass = AbstractGatewayFilterFactory.NameConfig]": null,
    "[RedirectToGatewayFilterFactory@624b3544 configClass = RedirectToGatewayFilterFactory.Config]": null,
    "[RequestHeaderToRequestUriGatewayFilterFactory@4d4c1ba9 configClass = AbstractGatewayFilterFactory.NameConfig]": null,
    "[SetRequestHostHeaderGatewayFilterFactory@ceb7701 configClass = SetRequestHostHeaderGatewayFilterFactory.Config]": null,
    "[RequestSizeGatewayFilterFactory@2017f6e6 configClass = RequestSizeGatewayFilterFactory.RequestSizeConfig]": null,
    "[SetStatusGatewayFilterFactory@76a362a4 configClass = SetStatusGatewayFilterFactory.Config]": null,
    "[RemoveResponseHeaderGatewayFilterFactory@27e199ce configClass = AbstractGatewayFilterFactory.NameConfig]": null,
    "[SetResponseHeaderGatewayFilterFactory@5e193ef5 configClass = AbstractNameValueGatewayFilterFactory.NameValueConfig]": null,
    "[StripPrefixGatewayFilterFactory@5627cb29 configClass = StripPrefixGatewayFilterFactory.Config]": null,
    "[AddRequestParameterGatewayFilterFactory@30b3d899 configClass = AbstractNameValueGatewayFilterFactory.NameValueConfig]": null,
    "[RewriteLocationResponseHeaderGatewayFilterFactory@21274afe configClass = RewriteLocationResponseHeaderGatewayFilterFactory.Config]": null,
    "[PreserveHostHeaderGatewayFilterFactory@20256a0b configClass = Object]": null,
    "[RetryGatewayFilterFactory@7364f68 configClass = RetryGatewayFilterFactory.RetryConfig]": null,
    "[RewritePathGatewayFilterFactory@1c3b6963 configClass = RewritePathGatewayFilterFactory.Config]": null,
    "[RewriteResponseHeaderGatewayFilterFactory@106c988 configClass = RewriteResponseHeaderGatewayFilterFactory.Config]": null,
    "[MapRequestHeaderGatewayFilterFactory@34c76167 configClass = MapRequestHeaderGatewayFilterFactory.Config]": null,
    "[RemoveRequestParameterGatewayFilterFactory@2c9fdb64 configClass = AbstractGatewayFilterFactory.NameConfig]": null,
    "[AddRequestHeaderGatewayFilterFactory@559991f5 configClass = AbstractNameValueGatewayFilterFactory.NameValueConfig]": null,
    "[SetPathGatewayFilterFactory@55a0f011 configClass = SetPathGatewayFilterFactory.Config]": null,
    "[ModifyRequestBodyGatewayFilterFactory@61d60e38 configClass = ModifyRequestBodyGatewayFilterFactory.Config]": null,
    "[SecureHeadersGatewayFilterFactory@7ea42c82 configClass = SecureHeadersGatewayFilterFactory.Config]": null,
    "[SetRequestHeaderGatewayFilterFactory@39133244 configClass = AbstractNameValueGatewayFilterFactory.NameValueConfig]": null,
    "[AddResponseHeaderGatewayFilterFactory@78d92eef configClass = AbstractNameValueGatewayFilterFactory.NameValueConfig]": null,
    "[SaveSessionGatewayFilterFactory@61da0413 configClass = Object]": null,
    "[PrefixPathGatewayFilterFactory@71531dd7 configClass = PrefixPathGatewayFilterFactory.Config]": null,
    "[ModifyResponseBodyGatewayFilterFactory@404ced67 configClass = ModifyResponseBodyGatewayFilterFactory.Config]": null,
    "[DedupeResponseHeaderGatewayFilterFactory@6e95973c configClass = DedupeResponseHeaderGatewayFilterFactory.Config]": null,
    "[RequestHeaderSizeGatewayFilterFactory@115c946b configClass = RequestHeaderSizeGatewayFilterFactory.Config]": null
}

3. 刷新路由缓存

可以通过 POST /actuator/gateway/refresh清除路由缓存。该请求返回200，但没有响应正文。

4. 查询单个路由信息

可以通过 GET /actuator/gateway/routes/{id} 检索单个路由的信息。

https://localhost:8443/actuator/gateway/routes/ReactiveCompositeDiscoveryClient_app-service001

结果如下：

{
    "predicate": "Paths: [/app-service001/**], match trailing slash: true",
    "metadata": {
        "nacos.instanceId": "192.168.58.1#9000#DEFAULT#DEFAULT_GROUP@@app-service001",
        "nacos.weight": "1.0",
        "nacos.cluster": "DEFAULT",
        "nacos.ephemeral": "true",
        "nacos.healthy": "true",
        "preserved.register.source": "SPRING_CLOUD",
        "secure": "true"
    },
    "route_id": "ReactiveCompositeDiscoveryClient_app-service001",
    "filters": [
        "[[RewritePath /app-service001/?(?<remaining>.*) = '/${remaining}'], order = 1]"
    ],
    "uri": "lb://app-service001",
    "order": 0
}

5. 创建和删除路由

要创建路由 ，请创建POST /gateway/routes/{id_route_to_create}，带有指定路由字段的JSON格式请求。

要删除路由，请创建一个DELETE /gateway/routes/{id_route_to_delete}请求。

一般不这么干，所以不演示了。。。