产品动态
公告
产品发布记录
Service 扩展协议
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
扩展协议注解示例
{"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 证书配置。扩展协议使用说明
apiVersion: v1kind: Servicemetadata:annotations:service.cloud.tencent.com/specify-protocol: '{"80":{"protocol":["TCP_SSL"],"tls":"cert-secret"}}' # 若要使用别的协议，修改该键值对的值为上述内容name: test....
案例说明
需注意的是，YAML 中仍使用相同的协议，但可以通过 Annotation 明确每个端口的协议类型。如下示例展示了 80 端口使用 TCP 协议，8080 端口使用 UDP 协议。
apiVersion: v1kind: Servicemetadata: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: nginxspec:externalTrafficPolicy: Clusterports:- name: tcp-80-80nodePort: 32150port: 80protocol: TCPtargetPort: 80- name: udp-8080-8080nodePort: 31082port: 8080protocol: TCP # 注意，因为 Kubernetes Service Controller 限制，只能使用同类型协议。targetPort: 8080selector:k8s-app: nginxqcloud-app: nginxsessionAffinity: Nonetype: LoadBalancer
文档反馈