容器服务 Service 扩展协议-TKE 标准集群指南-文档中心-腾讯云

Service 默认支持的协议
 Service 是 Kubernetes 暴露应用程序到集群外的一种机制与抽象，您可以通过 Service 访问集群内的应用程序。
注意：
在 直连场景 下接入时，使用扩展协议没有任何限制，支持 TCP 和 UDP 协议混用。
在非直连场景下，ClusterIP 和 NodePort 模式支持混用。但是，对于 LoadBalancer 类型的 Service，社区目前仅支持同类型协议的使用。
当 LoadBalancer 声明为 TCP 时，端口可以使用扩展协议的能力，将负载均衡的协议变更为 TCP_SSL、HTTP 或 HTTPS。
当 LoadBalancer 声明为 UDP 时，端口可以使用扩展协议的能力，将负载均衡的协议变更为 QUIC。
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://cloud.tencent.com/document/product/457/41897 
 {"80":{"protocol":["TCP_SSL","UDP"],"tls":"cert-secret"}} # 仅直连模式支持，详情见https://cloud.tencent.com/document/product/457/41897 
{"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
﻿
Service 扩展协议

本页目录：

Service 默认支持的协议

TKE 扩展 Service 转发协议

前置说明

注解名称

扩展协议注解示例

扩展协议使用说明

案例说明
