tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
容器服务
    文档
    Download PDF

    Service 扩展协议

    最后更新时间：2023-05-23 10:31:58
    下载PDF

      Service 默认支持的协议

      Service 是 Kubernetes 暴露应用程序到集群外的一种机制与抽象，您可以通过 Serivce 访问集群内的应用程序。
      注意
      在 直连场景 下接入时，使用扩展协议没有任何限制，支持 TCP 和 UDP 协议混用。
      在非直连场景下，ClusterIP 和 NodePort 模式支持混用。但是，对于 LoadBalancer 类型的 Service，社区目前仅支持同类型协议的使用。
      当 LoadBalancer 声明为 TCP 时，端口可以使用扩展协议的能力，将负载均衡的协议变更为 TCP_SSL、HTTP 或 HTTPS。
      当 LoadBalancer 声明为 UDP 时，端口可以使用扩展协议的能力，将负载均衡的协议变更为 UDP。

      TKE 扩展 Service 转发协议

      在原生的 Service 支持的协议规则上，存在部分场景需要在 Service 上同时支持 TCP 和 UDP 混合，且需 Service 能够支持 TCP SSL、HTTP、HTTPS 协议。TKE 针对 LoadBalancer 模式扩展了更多协议的支持。

      前置说明

      扩展协议仅对 LoadBalancer 模式的 Service 生效。
      扩展协议通过注解 Annotation 的形式描述协议与端口的关系。
      扩展协议与注解 Annotation 关系如下：
      当扩展协议注解中没有覆盖 Service Spec 中描述的端口时，Service Spec 按照用户描述配置。
      当扩展协议注解中描述的端口在 Service Spec 中不存在时，忽略该配置。
      当扩展协议注解中描述的端口在 Service Spec 中存在时，覆盖用户在 Service Spec 中声明的协议配置。

      注解名称

      service.cloud.tencent.com/specify-protocol

      扩展协议注解示例

      TCP_SSL 示例
      HTTP 示例
      HTTPS 示例
      TCP/UDP混合示例
      混合示例
      QUIC
      {"80":{"protocol":["TCP_SSL"],"tls":"cert-secret"}}
      {"80":{"protocol":["HTTP"],"hosts":{"a.tencent.com":{},"b.tencent.com":{}}}}
       {"80":{"protocol":["HTTPS"],"hosts":{"a.tencent.com":{"tls":"cert-secret-a"},"b.tencent.com":{"tls":"cert-secret-b"}}}}
      {"80":{"protocol":["TCP","UDP"]}} # 仅直连模式支持，详情见https://www.tencentcloud.com/document/product/457/36837 
       {"80":{"protocol":["TCP_SSL","UDP"],"tls":"cert-secret"}} # 仅直连模式支持，详情见https://www.tencentcloud.com/document/product/457/36837 
      {"80":{"protocol":["QUIC"],"tls":"cert-secret"}}
      注意
      TCP_SSL 和 HTTPS 中的字段 cert-secret，表示使用该协议需要指定一个证书，证书是 Opaque 类型的 Secret，Secret 的 Key 为 qcloud_cert_id，Value 是证书 ID。详情见 Ingress 证书配置。

      扩展协议使用说明

      扩展协议YAML使用说明
      扩展协议控制台使用说明
      apiVersion: v1
      kind: Service
      metadata:
        annotations:  
          service.cloud.tencent.com/specify-protocol: '{"80":{"protocol":["TCP_SSL"],"tls":"cert-secret"}}' # 若要使用别的协议，修改该键值对的值为上述内容
        name: test
         ....
      在创建 Service 时，若以“公网LB”或“内网LB”的形式暴露服务，非 直连模式 情况下，“端口映射”中，仅支持 TCP 和 TCP SSL 一起使用。如下图所示：
      
      当 Service 为“仅在集群内访问（ClusterIP）”或“主机端口访问（NodePort）”模式时，支持任意协议混用。
      直连模式，支持任意协议混用。

      案例说明

      原生 Service 不支持协议混用，TKE 经过特殊改造后，在 直连场景 中支持混合协议的使用。
      需注意的是，YAML 中仍使用相同的协议，但可以通过 Annotation 明确每个端口的协议类型。如下示例展示了 80 端口使用 TCP 协议，8080 端口使用 UDP 协议。
      apiVersion: v1
      kind: Service
      metadata:
        annotations:
          service.cloud.tencent.com/direct-access: "true"  #TKE Serverless 集群默认是直连模式，TKE 集群请务必先参照文档开启直连模式。
          service.cloud.tencent.com/specify-protocol: '{"80":{"protocol":["TCP"]},"8080":{"protocol":["UDP"]}}'   # 指定 80 端口 TCP 协议，8080 端口 UDP 协议。
        name: nginx
      spec:
        externalTrafficPolicy: Cluster
        ports:
        - name: tcp-80-80
          nodePort: 32150
          port: 80
          protocol: TCP 
          targetPort: 80
        - name: udp-8080-8080
          nodePort: 31082
          port: 8080
          protocol: TCP # 注意，因为 Kubernetes Service Controller 限制，只能使用同类型协议。
          targetPort: 8080 
        selector:
          k8s-app: nginx
          qcloud-app: nginx
        sessionAffinity: None
        type: LoadBalancer
      
      联系我们

      联系我们，为您的业务提供专属服务。

      联系我们
      技术支持

      如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

      提交工单
      7x24 电话支持
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      隐私条款服务条款缓存条款