Gateway与ListenerSet参数配置

前提条件

集群版本已支持ELB Gateway功能。

约束与限制

在Gateway、ListenerSet中的listeners字段中配置域名和证书无效，需要在ListenerConfiguration中配置。

架构与关联机制

• 核心Gateway资源：定义基本网关属性，可以包含默认监听器或直接引用外部ListenerSet。
• ListenerSet扩展：当监听器数量较多或由不同团队独立维护时，可通过创建ListenerSet资源并显式关联到指定Gateway上，动态向ELB附加监听端口。

创建Gateway后自动创建ELB

1. 创建Gateway关联CCE管理的GatewayClass

   apiVersion: gateway.networking.k8s.io/v1
   kind: Gateway                      # 资源类型为 Gateway
   metadata:
     name: cce-gateway              # Gateway 名称
     namespace: default
   spec:
     gatewayClassName: cce-shared-internal  # GatewayClass 名称
     listeners:
       - name: http
         protocol: HTTP               # 协议
         port: 80                     # 监听端口

   

   在Gateway中的listeners里配置域名和证书无效，需要在listenerConfig中配置。

2. 使用ListenerSet
   1. Gateway开启ListenerSet

      同命名空间：

      apiVersion: gateway.networking.k8s.io/v1
      kind: Gateway
      metadata:
        name: parent-gateway
        namespace: default
      spec:
        gatewayClassName: cce-shared-internal
        # 必填：开启 ListenerSet 挂载许可
        allowedListeners:
          namespaces:
            from: Same       # 可选: Same (仅同命名空间), All (跨所有命名空间), Selector (按 Label 筛选)
        listeners:
          - name: default-http
            port: 80
            protocol: HTTP

      指定命名空间：

      apiVersion: gateway.networking.k8s.io/v1
      kind: Gateway
      metadata:
        name: parent-gateway
        namespace: default
      spec:
        gatewayClassName: cce-shared-internal
        # 必填：开启 ListenerSet 挂载许可
        allowedListeners:
          namespaces:
            from: Selector
            selector:
              matchExpressions:
                - key: kubernetes.io/metadata.name       #指定允许 ns-a、ns-b 和 ns-c 这三个特定命名空间挂载
                  operator: In
                  values:
                    - ns-a
                    - ns-b
                    - ns-c
        listeners:
          - name: default-http
            port: 80
            protocol: HTTP

   2. ListenerSet关联Gateway

      apiVersion: gateway.networking.k8s.io/v1
      kind: ListenerSet
      metadata:
        name: app-team-listeners
        namespace: default
      spec:
        # 绑定到目标 Gateway
        parentRef:
          group: gateway.networking.k8s.io
          kind: Gateway
          name: parent-gateway
          namespace: default      #Gateway的命名空间，同命名空间可不填
        # 定义该集合下的专属监听规则
        listeners:
          - name: https-app
            port: 443
            protocol: HTTPS

      HTTPS协议的监听器需要在lsconfig中配置证书，详见监听器参数配置（lsconfig）。

3. 配置HTTPRoute关联Service后，可访问后端服务。

创建Gateway后关联已有ELB

1. 创建Gateway关联已有ELB

   apiVersion: gateway.networking.k8s.io/v1
   kind: Gateway                      # 资源类型为 Gateway
   metadata:
     name: cce-gateway              # Gateway 名称
     namespace: default
   spec:
     gatewayClassName: cce-existing-elb  # 使用已有ELB的GatewayClass
     addresses:
       - type: gateway.cce.io/loadbalancer-id
         value: "<ELB实例ID>"
     listeners:
       - name: http
         protocol: HTTP               # 协议
         port: 80                     # 监听端口

2. 配置HTTPRoute关联Service后，可访问后端服务

配置Gateway/ListenerSet跨命名空间绑定HTTPRoute

挂载控制机制说明

• 默认行为：默认情况下，Gateway和ListenerSet仅允许与自身位于同一命名空间（Same）的HTTPRoute进行绑定。
• 跨命名空间挂载：若需允许其他命名空间的HTTPRoute挂载，需要在指定的Listener中显式配置allowedRoutes.namespaces控制策略。

Gateway主要参数

matchLabels与matchExpressions的结果取AND。空LabelSelector（两个字段都不填）匹配所有对象；nil LabelSelector匹配无对象。在Gateway场景中，当from为Selector时此字段必填，用于筛选允许的命名空间集合。

ListenerSet主要参数