创建LoadBalancer类型的Service

更新时间：2025-08-21

本文档会详细介绍如何在CCE下创建类型是LoadBalancer的Service。

Kubernetes官方教程：Services

快速开始

当用户创建类型是LoadBalancer的Service，默认情况下，CCE会联动的创建BLB，并为此BLB绑定EIP。

以创建一个简单的Nginx为例：

Plain Text

1---
2kind: Service
3apiVersion: v1
4metadata:
5  name: nginx-service
6spec:
7  selector:
8    app: nginx
9  type: LoadBalancer
10  ports:
11  - name: nginx-port
12    port: 80
13    targetPort: 80
14    protocol: TCP
15---
16apiVersion: apps/v1beta1
17kind: Deployment
18metadata:
19  name: nginx-deployment
20spec:
21  replicas: 1
22  template:
23    metadata:
24      labels:
25        app: nginx
26    spec:
27      containers:
28      - name: nginx
29        image: nginx
30        ports:
31        - containerPort: 80

(1)创建

$ kubectl create -f nginx.yaml

(2)查询EIP

IP 8.8.8.8 即为此Nginx的EIP。

Plain Text

1$ kubectl get svc
2NAME            CLUSTER-IP     EXTERNAL-IP      PORT(S)        AGE
3nginx-service   1.1.1.1        8.8.8.8          80:30274/TCP   5m

(3)查询BLB

Plain Text

1$ kubectl get svc nginx-service -o jsonpath={.metadata.annotations}
2map[service.beta.kubernetes.io/cce-load-balancer-id:lb-xxxxxx]

lb-xxxxxx即为此Service的BLB的id。

(4)访问测试

$ curl -i http://8.8.8.8

高级配置

固定EIP

当用户删除Service并重新创建的时候，EIP会变，这样就需要去更改依赖于此IP的其他所有服务，所以CCE提供一种方式来固定此EIP。

固定EIP的方案：

（1）用户预先百度智能云上购买一个EIP实例
（2）在创建Service时，设置loadBalancerIP为此EIP
（3）创建Service，此时EXTERNAL-IP即为此EIP
（4）删除Service，CCE只会解绑此EIP而不会释放此EIP，用户下次还可以继续使用

示例如下：

Plain Text

1---
2kind: Service
3apiVersion: v1
4metadata:
5  name: nginx-service-eip-with-load-balancer-ip
6spec:
7  selector:
8    app: nginx-eip-with-load-balancer-ip
9  type: LoadBalancer
10  loadBalancerIP: 8.8.8.8
11  ports:
12  - name: nginx-port
13    port: 80
14    targetPort: 80
15    protocol: TCP
16---
17apiVersion: apps/v1beta1
18kind: Deployment
19metadata:
20  name: nginx-deployment-eip-with-load-balancer-ip
21spec:
22  replicas: 1
23  template:
24    metadata:
25      labels:
26        app: nginx-eip-with-load-balancer-ip
27    spec:
28      containers:
29      - name: nginx
30        image: nginx
31        ports:
32        - containerPort: 80

这样查到的EXTERNAL-IP即为此EIP：

Plain Text

1kubectl get svc nginx-service
2NAME                                    TYPE           CLUSTER-IP       EXTERNAL-IP      PORT(S)        AGE
3nginx-service-eip-with-loadBalancerIP   LoadBalancer   1.1.1.1          8.8.8.8          80:30601/TCP   1m

不分配EIP(即VPC内BLB)

用户使用时：
（1）设置Service.Spec.Type=LoadBalancer
（2）为Service添加annotations，即service.beta.kubernetes.io/cce-load-balancer-internal-vpc: "true"

示例如下：

Plain Text

1---
2kind: Service
3apiVersion: v1
4metadata:
5  name: nginx-service-blb-internal-vpc
6  annotations:
7    service.beta.kubernetes.io/cce-load-balancer-internal-vpc: "true"
8spec:
9  selector:
10    app: nginx-blb-internal-vpc
11  type: LoadBalancer
12  ports:
13  - name: nginx-port
14    port: 80
15    targetPort: 80
16    protocol: TCP
17---
18apiVersion: apps/v1beta1
19kind: Deployment
20metadata:
21  name: nginx-deployment-blb-internal-vpc
22spec:
23  replicas: 1
24  template:
25    metadata:
26      labels:
27        app: nginx-blb-internal-vpc
28    spec:
29      containers:
30      - name: nginx
31        image: nginx
32        ports:
33        - containerPort: 80

这样查到的EXTERNAL-IP只能在VPC内访问：

Plain Text

1kubectl get svc nginx-service
2NAME                             TYPE           CLUSTER-IP       EXTERNAL-IP      PORT(S)        AGE
3nginx-service-blb-internal-vpc   LoadBalancer   1.1.1.1          2.2.2.2          80:30601/TCP   1m

注：此内网BLB只能在一个VPC内的集群间正常使用；在使用同一个集群内的内网BLB时，会存在问题，建议在同一个集群内直接使用Service的ClusterIP

自定义EIP配置

EIP支持配置类型：

预付费（Prepaid）

项目	限制
公网带宽	1-200Mbps，Int
购买时长	[1,2,3,4,5,6,7,8,9,12,24,36]，时间单位，month

后付费（Postpaid）

计费方式	公网带宽	费用举例
按使用流量计费（ByTraffic）	1~1000Mbps，Int	配置费用：￥0.00032/分钟；流量费用：￥0.76/GB
按使用带宽计费（ByBandwidth）	1-200Mbps，Int	配置费用（1Mbps为例）：￥0.00094/分钟

使用方式： 在创建Service时设置相应Annotation如下：

Plain Text

1// 付费方式，默认：Postpaid；可选：Postpaid、Prepaid
2service.beta.kubernetes.io/cce-elastic-ip-payment-timing:"Postpaid"
3// 计费方式，默认：ByTraffic；可选：ByTraffic、ByBandwidth
4service.beta.kubernetes.io/cce-elastic-ip-billing-method:"ByTraffic"
5// 公网带宽，单位为Mbps，默认：1000或者200；对于prepay以及bandwidth类型的EIP，限制为为1~200之间的整数，对于traffic类型的EIP，限制为1~1000之前的整数。
6service.beta.kubernetes.io/cce-elastic-ip-bandwidth-in-mbps:"1000"
7// 对于预付费，必须设置时长，[1,2,3,4,5,6,7,8,9,12,24,36]，单位月；对于后付费，此设置无效
8service.beta.kubernetes.io/cce-elastic-ip-reservation-length:"36"

后付费举例：

Plain Text

1kind: Service
2apiVersion: v1
3metadata:
4  name: nginx-service
5  annotations:
6    service.beta.kubernetes.io/cce-elastic-ip-payment-timing: "Postpaid"
7    service.beta.kubernetes.io/cce-elastic-ip-billing-method: "ByTraffic"
8    service.beta.kubernetes.io/cce-elastic-ip-bandwidth-in-mbps: "200"
9spec:
10  selector:
11    app: nginx
12  type: LoadBalancer
13  ports:
14  - name: http
15    port: 80
16    targetPort: 80

预付费举例（请确定余额充足，否则会失败）：

Plain Text

1kind: Service
2apiVersion: v1
3metadata:
4  name: nginx-service
5  annotations:
6    service.beta.kubernetes.io/cce-elastic-ip-payment-timing: "Prepaid"
7    service.beta.kubernetes.io/cce-elastic-ip-bandwidth-in-mbps: "10"
8    service.beta.kubernetes.io/cce-elastic-ip-reservation-length:"1"
9spec:
10  selector:
11    app: nginx
12  type: LoadBalancer
13  ports:
14  - name: http
15    port: 80
16    targetPort: 80

说明事项 默认配置：默认为：后付费+按流量+1000M带宽。

固定EIP：不支持对固定EIP的配置进行更新，请用户自行到控制台修改。

用户更新Service EIP的配置（即手动编辑annotation）：支持更新的配置有：公网带宽

预付费：

（1）对于预付费，由于EIP API的限制，目前不支持自动续费，需要用户自行到console上续费。

（2）对于预付费，不需要设置计费方式

（3）删除Service时，预付费EIP不会释放，到期后才会释放

UDP-Service

修改spec.ports.protocol为UDP即可使用UDP Service的功能，举例如下：

Plain Text

1---
2apiVersion: v1
3kind: Service
4metadata:
5  name: udp-server-demo-svc
6  labels:
7    app: udp-server-demo
8spec:
9  type: LoadBalancer
10  ports:
11  - name: udp-server-demo-port
12    port: 3005
13    targetPort: 3005
14    protocol: UDP
15  selector:
16    app: udp-server-demo
17---
18apiVersion: extensions/v1beta1
19kind: Deployment
20metadata:
21  name: udp-server-demo
22  labels:
23    app: udp-server-demo
24spec:
25  replicas: 1
26  selector:
27    matchLabels:
28      app: udp-server-demo
29  template:
30    metadata:
31      labels:
32        app: udp-server-demo
33    spec:
34      containers:
35      - name: udp-server-demo
36        image: hub.baidubce.com/jpaas-public/udp-server-demo:latest
37        ports:
38        - containerPort: 3005
39          protocol: UDP

（1）部署udp测试服务

Plain Text

1$ kubectl apply -f udp.yaml

（2）UDP Service创建成功

Plain Text

1$ kubectl get svc
2NAME                  TYPE           CLUSTER-IP       EXTERNAL-IP      PORT(S)          AGE
3kubernetes            ClusterIP      172.16.0.1       <none>           443/TCP          6h
4udp-server-demo-svc   LoadBalancer   172.16.122.139   10.10.10.10      3005:31441/UDP   1m

（3）查看服务日志

Plain Text

1$ kubectl logs -f udp-server-demo-6fdf5d796f-h6595
2Received: HealthCheck
3Get Health Check, response OK
4Received: HealthCheck
5Get Health Check, response OK
6Received: HealthCheck
7Get Health Check, response OK

注：根据百度云负载均衡BLB的要求，对于监听UDP的服务，一定要通过UDP健康检查，BLB才会把流量转发到后端，所以需要用户的后端UDP服务响应健康检查字符串，详见：UDP健康检查介绍

为Service的BLB指定子网

为方便用户管理网络相关资源，支持创建Service时为BLB指定子网用户使用时：

（1）设置Service.Spec.Type=LoadBalancer

（2）为Service添加annotations，指定子网ID，即service.beta.kubernetes.io/cce-load-balancer-subnet-id: "sbn-*"

示例如下：

YAML

1---
2kind: Service
3apiVersion: v1
4metadata:
5  name: nginx-service-blb-subnet-id
6  annotations:
7    service.beta.kubernetes.io/cce-load-balancer-subnet-id: "sbn-123456"
8spec:
9  selector:
10    app: nginx
11  type: LoadBalancer
12  ports:
13  - name: nginx-port
14    port: 80
15    targetPort: 80
16    protocol: TCP
17---
18apiVersion: apps/v1beta1
19kind: Deployment
20metadata:
21  name: nginx-deployment-blb-subnet-id
22spec:
23  replicas: 1
24  template:
25    metadata:
26      labels:
27        app: nginx
28    spec:
29      containers:
30      - name: nginx
31        image: nginx
32        ports:
33        - containerPort: 80

部署服务后，可以去百度智能云BLB页面查询创建的BLB所在的子网进行验证 注：仅支持在创建Service时指定子网，不支持创建Service之后编辑Service添加或修改该annotation

EFK日志采集系统部署指南

Prometheus监控系统部署指南

容器引擎 CCE

容器引擎 CCE

创建LoadBalancer类型的Service

快速开始

高级配置

固定EIP

不分配EIP(即VPC内BLB)

自定义EIP配置

UDP-Service

为Service的BLB指定子网