使用 Nacos 做注册中心

应用配置具体参考Nacos Spring Cloud 快速开始进行应用配置

不指定命名空间

如果 application.properties 中没有指定 Nacos 命名空间，例如：

  1. server.port=8080
  2. spring.application.name=my-service
  5. spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848

则 Higress 的 McpBridge 中亦无需指定命名空间：

  1. apiVersion: networking.higress.io/v1
  2. kind: McpBridge
  3. metadata:
  4.   name: default
  5.   namespace: higress-system
  6. spec:
  7.   registries:
  8.     # 定义一个名为 my-nacos  的服务来源
  9.   - name: my-nacos
  10.     # 注册中心类型是 Nacos 2.x，支持 gRPC 协议
  11.     type: nacos2
  12.     # 注册中心的访问地址，可以是域名或者IP
  13.     domain: 127.0.0.1
  14.     # 注册中心的访问端口，Nacos 默认都是 8848
  15.     port: 8848
  16.     # Nacos 服务分组
  17.     nacosGroups:
  18.     - DEFAULT_GROUP

配置 Ingress 转发到这个服务(假设/api前缀的路由都转发给这个服务)需要做如下配置：

  1. apiVersion: networking.k8s.io/v1
  2. kind: Ingress
  3. metadata:
  4.   annotations:
  5.     higress.io/destination: my-service.DEFAULT-GROUP.public.nacos
  6.   name: demo
  7.   namespace: default
  8. spec:
  9.   rules:
  10.   - http:
  11.       paths:
  12.       - backend:
  13.           resource:
  14.             apiGroup: networking.higress.io
  15.             kind: McpBridge
  16.             name: default
  17.         path: /api
  18.         pathType: Prefix

注意这里通过注解higress.io/destination指定路由最终要转发到的目标服务。

对于 Nacos 来源的服务，这里的目标服务格式为：“服务名称.服务分组.命名空间ID.nacos”，注意这里需要遵循 DNS 域名格式，因此服务分组中的下划线’_‘被转换成了横杠’-‘。命名空间未指定时，这里默认值为”public”。

指定命名空间、服务分组等信息

如果 application.properties 中指定了 Nacos 命名空间，服务分组等信息，例如：

  1. server.port=8080
  2. spring.application.name=my-service
  5. spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848
  6. spring.cloud.nacos.discovery.namespace=d8ac64f3-xxxx-xxxx-xxxx-47a814ecf358
  7. spring.cloud.nacos.discovery.group=custom-group

则 Higress 的 McpBridge 做相应配置即可

  1. apiVersion: networking.higress.io/v1
  2. kind: McpBridge
  3. metadata:
  4.   name: default
  5.   namespace: higress-system
  6. spec:
  7.   registries:
  8.     # 定义一个名为 my-nacos  的服务来源
  9.   - name: my-nacos
  10.     # 注册中心类型是 Nacos 2.x，支持 gRPC 协议
  11.     type: nacos2
  12.     # 注册中心的访问地址，可以是域名或者IP
  13.     domain: 127.0.0.1
  14.     # 注册中心的访问端口，Nacos 默认都是 8848
  15.     port: 8848
  16.     # Nacos 命名空间 ID
  17.     nacosNamespaceId: d8ac64f3-xxxx-xxxx-xxxx-47a814ecf358
  18.     # Nacos 服务分组
  19.     nacosGroups:
  20.     - custom-group

配置 Ingress 转发到这个服务(假设/api前缀的路由都转发给这个服务)需要做如下配置：

  1. apiVersion: networking.k8s.io/v1
  2. kind: Ingress
  3. metadata:
  4.   annotations:
  5.     higress.io/destination: my-service.custom-group.d8ac64f3-xxxx-xxxx-xxxx-47a814ecf358.nacos
  6.   name: demo
  7.   namespace: default
  8. spec:
  9.   rules:
  10.   - http:
  11.       paths:
  12.       - backend:
  13.           resource:
  14.             apiGroup: networking.higress.io
  15.             kind: McpBridge
  16.             name: default
  17.         path: /api
  18.         pathType: Prefix

使用 ZooKeeper 做注册中心

使用 Zookeeper 做注册中心时，注意必须配置spring.cloud.zookeeper.discovery.preferIpAddress=true，否则注册到注册中心中到地址为主机名称，而不是IP。

不指定注册根路径

如果 application.properties 中未指定注册根路径信息，例如：

  1. spring.application.name=my-service
  2. spring.cloud.zookeeper.connect-string=127.0.0.1:2181
  3. spring.cloud.zookeeper.discovery.preferIpAddress=true
  4. spring.cloud.zookeeper.discovery.enabled=true
  5. spring.cloud.zookeeper.discovery.register=true

则 Higress 的 McpBridge 中亦无需指定zkServicePath：

  1. apiVersion: networking.higress.io/v1
  2. kind: McpBridge
  3. metadata:
  4.   name: default
  5.   namespace: higress-system
  6. spec:
  7.   registries:
  8.     # 定义一个名为 my-zk  的服务来源
  9.   - name: my-zk
  10.     # 注册中心类型是 ZooKeeper
  11.     type: zookeeper
  12.     # 注册中心的访问地址，可以是域名或者IP
  13.     domain: 127.0.0.1
  14.     # 注册中心的访问端口
  15.     port: 2181

配置 Ingress 转发到这个服务(假设/api前缀的路由都转发给这个服务)需要做如下配置：

  1. apiVersion: networking.k8s.io/v1
  2. kind: Ingress
  3. metadata:
  4.   annotations:
  5.     higress.io/destination: my-service.services.zookeeper
  6.   name: demo
  7.   namespace: default
  8. spec:
  9.   rules:
  10.   - http:
  11.       paths:
  12.       - backend:
  13.           resource:
  14.             apiGroup: networking.higress.io
  15.             kind: McpBridge
  16.             name: default
  17.         path: /api
  18.         pathType: Prefix

注意对于 ZooKeeper 来源的服务，这里的目标服务格式为：“服务名称.服务注册根路径.zookeeper”，SpringCloud 在未指定服务注册根路径的情况下，根路径默认是”services”

指定注册根路径

如果 application.properties 中指定了注册根路径信息，例如：

  1. spring.application.name=my-service
  2. spring.cloud.zookeeper.connect-string=127.0.0.1:2181
  3. spring.cloud.zookeeper.discovery.preferIpAddress=true
  4. spring.cloud.zookeeper.discovery.enabled=true
  5. spring.cloud.zookeeper.discovery.register=true
  6. spring.cloud.zookeeper.discovery.root=my-services-root

则 Higress 的 McpBridge 中亦需指定zkServicePath：

  1. apiVersion: networking.higress.io/v1
  2. kind: McpBridge
  3. metadata:
  4.   name: default
  5.   namespace: higress-system
  6. spec:
  7.   registries:
  8.     # 定义一个名为 my-zk  的服务来源
  9.   - name: my-zk
  10.     # 注册中心类型是 ZooKeeper
  11.     type: zookeeper
  12.     # 注册中心的访问地址，可以是域名或者IP
  13.     domain: 127.0.0.1
  14.     # 注册中心的访问端口
  15.     port: 2181
  16.     # 对应 spring.cloud.zookeeper.discovery.root 配置字段
  17.     zkServicePath:
  18.     - my-services-root

配置 Ingress 转发到这个服务(假设/api前缀的路由都转发给这个服务)需要做如下配置：

  1. apiVersion: networking.k8s.io/v1
  2. kind: Ingress
  3. metadata:
  4.   annotations:
  5.     higress.io/destination: my-service.my-services-root.zookeeper
  6.   name: demo
  7.   namespace: default
  8. spec:
  9.   rules:
  10.   - http:
  11.       paths:
  12.       - backend:
  13.           resource:
  14.             apiGroup: networking.higress.io
  15.             kind: McpBridge
  16.             name: default
  17.         path: /api
  18.         pathType: Prefix

注意如果 spring.cloud.zookeeper.discovery.root 中包含了下划线，需要被替换为横杠，因为目标服务整体格式需要满足 DNS 域名规范