Spring Cloud插件

您可以将Spring Cloud业务应用接入ASM,从而可以使用云原生化的服务治理能力,不需要业务做任何代码修改,即可管理Spring Cloud业务服务。可以通过启用SpringCloud插件来开启服务网格ASM的SpringCloud应用支持能力。此插件必须配置为全局生效

重要

作为示例,您可以参考管理Spring Cloud服务,使用ASM管理SpringCloud服务,并按照步骤一:ASM控制面开启SpringCloud能力支持中的步骤启用此插件即可开启SpringCloud能力支持。

因为需要拦截注册流程,您需要在Deployment创建之前启用此插件并全局生效。若某些业务Deployment先于EnvoyFilter创建,您需要滚动更新该业务Deployment。

版本及配置参数说明

SpringCloud插件共有v1和v2两个版本,其中v2版本需要ASM版本在1.13.4.32及以上才可使用,并需要使用者提供与v1版本不同的参数来进行插件配置。

v1版本

v1版本的插件仅适用于Nacos注册中心,可在所有支持插件中心的ASM版本中使用。

配置字段

名称

数据类型

填写要求

默认值

描述

port_number

string

选填

8848

该参数规定Envoy过滤器需要拦截的Nacos服务端口,Nacos的默认服务端口为8848,如果您是自建的Nacos Server且对端口有修改,则需要指定自定义端口。

v2版本

v2版本的插件可适用于所有SpringCloud版本和注册中心,但需要ASM版本在1.13.4.32及以上才可以使用。

配置字段

名称

数据类型

填写要求

默认值

描述

provider_port_number

string

选填

ALL

该参数规定SpringCloud服务的端口(如"8070"),若不同SpringCloud服务端口不统一,可不配置此参数或将此参数配置为"ALL"。

pod_cidrs

string array

必填

["10.0.128.0/18"]

ACK或ASK集群的Pod CIDR。您可以登录容器服务管理控制台,在集群信息页面的基本信息页签下查看Pod CIDR。若容器网络插件采用Terway ,您可以在集群信息页面的集群资源页签查看Pod虚拟交换机对应的CIDR进行配置。该参数为必填,默认值仅为一个示例值。

插件升级须知

由于SpringCloud插件的v2和v1版本实现原理不同,所需配置参数不同,在从v1版本升级至v2版本之前,必须要先更新插件参数、并加入v2版本所需参数后,才可正常升级插件。 比如,升级前需要确保插件参数类似如下形式:

port_number: '8848'
provider_port_number: '8070'
pod_cidrs:
  - 10.0.128.0/18