文档首页/ 云容器引擎 CCE_Autopilot集群/ 用户指南/ 网络/ 服务（Service）/ 负载均衡（LoadBalancer）/ 创建负载均衡类型的服务

更新时间：2025-12-30 GMT+08:00

查看PDF

创建负载均衡类型的服务

操作场景

负载均衡（LoadBalancer）类型的服务可以通过弹性负载均衡（ELB）从公网访问到工作负载，与弹性IP方式相比提供了高可靠的保障。负载均衡访问方式由公网弹性负载均衡服务地址以及设置的访问端口组成，例如“10.117.117.117:80”。

在使用CCE Autopilot集群 + 独享型ELB实例时，支持ELB直通Pod，使部署在容器中的业务时延降低、性能无损耗。

从集群外部访问时，从ELB直接转发到Pod；集群内部访问可通过Service转发到Pod。

图1 ELB直通容器
点击放大

约束与限制

自动创建的ELB实例建议不要被其他资源使用，否则会在删除时被占用，导致资源残留。
CCE Autopilot集群仅支持选择独享型ELB网络类型，且独享型ELB网络类型必须支持私网（有私有IP地址）。如果需要Service支持HTTP，则独享型ELB规格需要为网络型（TCP/UDP/TLS）和应用型（HTTP/HTTPS）。

创建负载均衡类型的服务

登录CCE控制台，单击集群名称进入集群。
在左侧导航栏中选择“服务”，在右上角单击“创建服务”。

设置基础配置参数。

参数	说明
访问类型	选择“负载均衡”。
服务名称	自定义服务名称，可与工作负载名称保持一致。
命名空间	工作负载所在命名空间。
选择器	您可以添加Pod标签的键值，Service将会根据标签与工作负载的Pod进行关联，将流量导向包含该标签的Pod。您也可以引用已有工作负载的标签，单击“引用负载标签”，在弹出的窗口中选择负载，然后单击“确定”。

设置负载均衡配置参数。

ELB类型仅支持“独享型”。独享型ELB支持网络型（TCP/UDP/TLS）、应用型（HTTP/HTTPS）、网络型（TCP/UDP/TLS）&应用型类型（HTTP/HTTPS）。

参数	说明
负载均衡器	选择弹性负载均衡的类型及创建方式。选择已有：仅支持选择与集群在同一个VPC下的ELB实例。如果没有可选的ELB实例，请单击“创建负载均衡器”跳转到ELB控制台创建。自动创建：自动创建的负载均衡实例将创建到集群所在的VPC，具体配置如表1所示。

表1 ELB配置
ELB类型	配置
独享型ELB配置	基础配置规格：弹性规格：适用于业务用量波动较大的场景，按实际使用量收取每小时使用的容量费用。固定规格：适用于业务用量较为稳定的场景，按固定规格折算收取每小时使用的容量费用。可用区：可以选择在多个可用区创建负载均衡实例，提高服务的可用性。如果业务需要考虑容灾能力，建议选择多个可用区。实例名称：请填写ELB名称。企业项目：该参数仅对开通企业项目的企业客户账号显示。企业项目是一种云资源管理方式，企业项目管理服务提供统一的云资源按项目管理，以及项目内的资源管理、成员管理。资源标签：通过为资源添加标签，可以对资源进行自定义标记，实现资源的分类。您可以在TMS中创建“预定义标签”，预定义标签对所有支持标签功能的服务资源可见，通过使用预定义标签可以提升标签创建和迁移效率。v1.27.5-r0、v1.28.3-r0及以上版本集群支持。网络配置前端子网：用于分配ELB实例对外服务的IP地址。后端子网：用于与后端服务建立连接的IP地址。弹性公网IP：选择“自动创建”时，可配置公网带宽的计费方式及带宽大小。

填写访问设置参数。

参数	说明
服务亲和	选择将外部流量路由到集群范围的端点。集群级别：集群下所有节点的IP+节点端口均可以访问到此服务关联的负载，服务访问会因路由跳转导致一定性能损失，且无法获取到客户端源IP。
健康检查	设置负载均衡的健康检查配置。全局检查：全局检查仅支持使用相同协议的端口，无法对多个使用不同协议的端口生效。如果您需要配置多个不同的协议端口，建议使用“自定义检查”。自定义检查：在端口配置中对多种不同协议的端口设置健康检查。
端口配置	协议：请根据业务的协议类型选择。容器端口：工作负载程序实际监听的端口，需用户确定。例如nginx默认使用80端口。服务端口：Service使用的端口，端口范围为1-65535。监听器前端协议：ELB监听器的前端协议，是客户端与负载均衡监听器建立流量分发连接所使用的协议。当选择独享型负载均衡器类型时，包含“应用型（HTTP/HTTPS）”方可支持配置HTTP/HTTPS；包含“网络型（TCP/UDP/TLS）”方可支持配置TLS。健康检查：健康检查选项设置为“自定义检查”时，可以为不同协议的端口配置健康检查，参数说明请参见表2。

参数

说明

服务亲和

选择将外部流量路由到集群范围的端点。

集群级别：集群下所有节点的IP+节点端口均可以访问到此服务关联的负载，服务访问会因路由跳转导致一定性能损失，且无法获取到客户端源IP。

健康检查

设置负载均衡的健康检查配置。

全局检查：全局检查仅支持使用相同协议的端口，无法对多个使用不同协议的端口生效。如果您需要配置多个不同的协议端口，建议使用“自定义检查”。
自定义检查：在端口配置中对多种不同协议的端口设置健康检查。

端口配置

协议：请根据业务的协议类型选择。
容器端口：工作负载程序实际监听的端口，需用户确定。例如nginx默认使用80端口。
服务端口：Service使用的端口，端口范围为1-65535。
监听器前端协议：ELB监听器的前端协议，是客户端与负载均衡监听器建立流量分发连接所使用的协议。当选择独享型负载均衡器类型时，包含“应用型（HTTP/HTTPS）”方可支持配置HTTP/HTTPS；包含“网络型（TCP/UDP/TLS）”方可支持配置TLS。
健康检查：健康检查选项设置为“自定义检查”时，可以为不同协议的端口配置健康检查，参数说明请参见表2。

表2 健康检查参数
参数	说明
协议	当端口配置中的协议为TCP时，支持TCP和HTTP协议。检查路径（仅HTTP健康检查协议支持）：指定健康检查的URL地址。检查路径只能以/开头，长度范围为1-80。当端口配置中的协议为UDP时，支持UDP协议。
端口	使用业务端口：健康检查默认使用业务端口（Service的NodePort和容器端口）作为健康检查的端口。重新指定端口：重新指定端口会为服务增加一个名为cce-healthz的服务端口配置。容器端口：使用独享型负载均衡关联ENI实例时，容器端口作为健康检查的检查端口。取值范围为1-65535。
检查周期（秒）	每次健康检查响应的最大间隔时间，取值范围为1-50。
超时时间（秒）	每次健康检查响应的最大超时时间，取值范围为1-50。
最大重试次数	健康检查最大的重试次数，取值范围为1-10。

单击“创建”，创建Service。

您可以在创建工作负载时通过kubectl命令行设置Service访问方式。本节以nginx为例，说明kubectl命令实现负载均衡 ( LoadBalancer )访问的方法。

请参见通过kubectl连接集群，使用kubectl连接集群。

创建并编辑nginx-deployment.yaml以及nginx-elb-svc.yaml文件。

其中，nginx-deployment.yaml和nginx-elb-svc.yaml为自定义名称，您可以随意命名。

vi nginx-deployment.yaml

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx
spec:
  replicas: 1
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - image: nginx 
        name: nginx
      imagePullSecrets:
      - name: default-secret

vi nginx-elb-svc.yaml

apiVersion: v1 
kind: Service 
metadata: 
  name: nginx
  annotations:
    kubernetes.io/elb.id: <your_elb_id>                         # ELB ID，替换为实际值
    kubernetes.io/elb.class: performance                   # 负载均衡器类型
    kubernetes.io/elb.lb-algorithm: ROUND_ROBIN                   # 负载均衡器算法
    kubernetes.io/elb.session-affinity-mode: SOURCE_IP          # 会话保持类型为源IP
    kubernetes.io/elb.session-affinity-option: '{"persistence_timeout": "30"}'     # 会话保持时间（分钟）
    kubernetes.io/elb.health-check-flag: 'on'                   # 开启ELB健康检查功能
    kubernetes.io/elb.health-check-option: '{
      "protocol":"TCP",
      "delay":"5",
      "timeout":"10",
      "max_retries":"3"
    }'
spec:
  selector: 
     app: nginx
  ports: 
  - name: service0 
    port: 80     #访问Service的端口，也是负载均衡上的监听器端口。
    protocol: TCP 
    targetPort: 80  #Service访问目标容器的端口，此端口与容器中运行的应用强相关
    nodePort: 31128  #节点的端口号，如不指定，将在30000-32767范围内随机生成一个端口号
  type: LoadBalancer

上述示例通过Annotation（注解）实现负载均衡的一些高级功能，例如会话保持、健康检查等，对应的说明请参见表3。

除本示例中的功能外，如需了解更多高级功能相关注解及示例，请参见使用Annotation配置负载均衡。

表3 annotations参数
参数	是否必填	参数类型	描述
kubernetes.io/elb.id	是	String	为负载均衡实例的ID。在关联已有ELB时需填写。获取方法：在ELB控制台，单击ELB的名称，在ELB详情页的“基本信息”页签下找到“ID”字段复制即可。
kubernetes.io/elb.class	是	String	取值如下： performance：独享型负载均衡。说明：负载均衡类型的服务对接已有的独享型ELB时，网络类型必须支持私网（有私有IP地址）。
kubernetes.io/elb.lb-algorithm	否	String	后端云服务器组的负载均衡算法，默认值为“ROUND_ROBIN”。取值范围： ROUND_ROBIN：加权轮询算法。 LEAST_CONNECTIONS：加权最少连接算法。 SOURCE_IP：源IP算法。说明：当该字段的取值为SOURCE_IP时，后端云服务器组绑定的后端云服务器的权重设置（weight字段）无效，且不支持开启会话保持。
kubernetes.io/elb.session-affinity-mode	否	String	支持基于源IP地址的简单会话保持，即来自同一IP地址的访问请求转发到同一台后端服务器上。不启用：不填写该参数。开启会话保持：仅前端协议为TCP/UDP的监听器支持，会话保持类型支持源IP地址，参数取值为“SOURCE_IP”。说明：当kubernetes.io/elb.lb-algorithm设置为“SOURCE_IP”（源IP算法）时，不支持开启会话保持。
kubernetes.io/elb.session-affinity-option	否	表4 Object	ELB会话保持配置选项，可设置会话保持的超时时间。
kubernetes.io/elb.health-check-flag	否	String	是否开启ELB健康检查功能。开启：空值或"on" 关闭："off" 开启时需同时填写kubernetes.io/elb.health-check-option字段。
kubernetes.io/elb.health-check-option	否	表5 Object	ELB健康检查配置选项。

表4 elb.session-affinity-option字段数据结构说明
参数	是否必填	参数类型	描述
persistence_timeout	是	String	当elb.session-affinity-mode是“SOURCE_IP”时生效，设置会话保持的超时时间（分钟）。默认值为："60"，取值范围：1-60。

表5 elb.health-check-option字段数据结构说明
参数	是否必填	参数类型	描述
delay	否	String	健康检查间隔（秒）。默认值：5，取值范围：1-50
timeout	否	String	健康检查的超时时间（秒）。默认值：10，取值范围1-50
max_retries	否	String	健康检查的最大重试次数。默认值：3，取值范围1-10
protocol	否	String	健康检查的协议。取值范围：“TCP”或者“HTTP”
path	否	String	健康检查的URL，协议是“HTTP”时配置。默认值：“/” 取值范围：1-80字符

创建工作负载。

kubectl create -f nginx-deployment.yaml

回显如下，表示工作负载已创建完成。
```
deployment/nginx created
```
kubectl get pod

回显如下，工作负载状态为Running状态，表示工作负载已运行中。
```
NAME                     READY     STATUS             RESTARTS   AGE
nginx-2601814895-c1xhw   1/1       Running            0          6s
```

创建服务。

kubectl create -f nginx-elb-svc.yaml

回显如下，表示服务已创建。

service/nginx created

kubectl get svc

回显如下，表示工作负载访问方式已设置成功，工作负载可访问。

NAME         TYPE           CLUSTER-IP       EXTERNAL-IP   PORT(S)        AGE
kubernetes   ClusterIP      10.247.0.1       <none>        443/TCP        3d
nginx        LoadBalancer   10.247.130.196   10.78.42.242   80:31540/TCP   51s

在浏览器中输入访问地址，例如输入10.78.42.242:80。10.78.42.242为负载均衡实例IP地址，80为对应界面上的访问端口。

可成功访问nginx。

图2 通过负载均衡访问nginx