Docs

Volcengine Kubernetes Engine

CLB

Creating CLB services through kubectl

VKE supports creating LoadBalancer Services. This topic describes how to create a LoadBalancer Service through a YAML file.

Warning

Before configuring a LoadBalancer Service, be sure to carefully read Considerations for using LoadBalancer services.

Prerequisites

A cluster has been created. For more details, see Creating clusters.

The kubectl tool is installed on your computer. For details, please see Installation and settings of kubectl.

The target cluster has been connected by using kubectl. For details, please see Connecting to a cluster.

Deployments have been created. For details, see Creating Deployments, Creating StatefulSets, and Creating DaemonSets.

tip

Currently, only Deployment, StatefulSet, and DaemonSet are supported.

Procedure

Create a YAML file for the Service. Here is an example file named service-demo.yaml :

apiVersion: v1
kind: Service
metadata:
name: service-demo
spec:
selector:
app: nginx
ipFamilyPolicy: PreferDualStack
ipFamilies:
- IPv6
- IPv4
ports:
- name: rule
protocol: TCP
port: 80
targetPort: 80
type: LoadBalancer

Warning

The system will create a CLB instance correspondingly based on the default settings when using the YAML file above to create a LoadBalancer service in an IPv4 cluster. If a custom CLB is required, we recommend using annotations to create it. For details, see Using annotations to configure LoadBalancer services.

Dual-stack clusters do not support CLB instances of PUBLIC type. Therefore, when creating a LoadBalancer Service in a dual-stack cluster with a YAML file, add the annotation service.beta.kubernetes.io/volcengine-loadbalancer-address-type: "PRIVATE" to specify the CLB type as PRIVATE.

Execute the following command to create a service.

kubectl apply -f service-demo.yaml

Validating results

Execute the following command to view the service created.

The expected output is as follows. EXTERNAL-IP indicates the public IP address of the CLB to which the Service is attached.

Run the following command to view the details of the created Service.

The information below is what will be printed on the screen. The Annotation on the screen displays the information about the CLB, including CLB instance ID, subnet ID, and EIP billing model. You can search for the CLB instance by its ID on the LoadBalancer console page.

tip

For details about LoadBalancer service annotations, see Using annotations to configure LoadBalancer services.

Last updated: 2026.07.24 14:51:36