Configuring the Priorities of Forwarding Rules for LoadBalancer Ingresses

Prerequisites

• A CCE standard or Turbo cluster is available, and the cluster version meets the following requirements:
  • v1.23: v1.23.15-r0 or later
  • v1.25: v1.25.10-r0-r0 or later
  • v1.27: v1.27.7-r0 or later
  • v1.28: v1.28.5-r0 or later
  • v1.29: v1.29.1-r10 or later
  • Other clusters of later versions
• An available workload has been deployed in the cluster for external access. If no workload is available, deploy a workload by referring to Creating a Deployment, Creating a StatefulSet, or Creating a DaemonSet.
• A Service for external access has been configured for the workload. Services Supported by LoadBalancer Ingresses lists the Service types supported by LoadBalancer ingresses.

Notes and Constraints

Ingresses support prioritizing forwarding rules only when dedicated load balancers are used.

Using kubectl

1. Use kubectl to access the cluster. For details, see Connecting to a Cluster Using kubectl.
2. Create a YAML file named ingress-test.yaml. The file name can be customized.

   vi ingress-test.yaml

   The following shows an example configuration using an existing load balancer:

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: test
     namespace: default
     annotations:
       kubernetes.io/elb.port: '88'
       kubernetes.io/elb.id: 2c623150-17bf-45f1-ae6f-384b036f547e    # ID of an existing load balancer
       kubernetes.io/elb.class: performance    # Load balancer type
       kubernetes.io/elb.ingress-order: '1'    # Priority of a forwarding rule of different ingresses
       kubernetes.io/elb.rule-priority-enabled: 'true'   # The forwarding rules of an ingress are sorted based on the forwarding rule sequence in paths.
   spec:
     rules:
       - host: ''
         http:
           paths:
             - path: /test1
               backend:
                 service:
                   name: test1
                   port:
                     number: 8081
               property:
                 ingress.beta.kubernetes.io/url-match-mode: STARTS_WITH
               pathType: ImplementationSpecific
             - path: /test2
               backend:
                 service:
                   name: test2
                   port:
                     number: 8081
               property:
                 ingress.beta.kubernetes.io/url-match-mode: STARTS_WITH
               pathType: ImplementationSpecific
     ingressClassName: cce

   Table 1 Annotations for configuring the priorities of forwarding rules

   Parameter	Type	Description
   kubernetes.io/elb.ingress-order	String	Specifies the sequence of forwarding rules of different ingresses. The value ranges from 1 to 1000. A smaller value indicates a higher priority. The priority of a forwarding rule must be unique under the same load balancer listener. This parameter is available only for dedicated load balancers. NOTE: When this annotation is configured, the kubernetes.io/elb.rule-priority-enabled annotation is enabled by default. The forwarding rules of each ingress will be sorted.
   kubernetes.io/elb.rule-priority-enabled	String	This parameter can only be set to true, indicating to sort the forwarding rules of an ingress. The priorities of the forwarding rules are determined based on the sequence in which they are added during ingress creation. A forwarding rule added earlier indicates a higher priority. If this parameter is not configured, the default sorting of the forwarding rules on the load balancer will be used. After this parameter is enabled, it cannot be disabled. This parameter is available only for dedicated load balancers.

3. Create an ingress.

   kubectl create -f ingress-test.yaml

   If information similar to the following is displayed, the ingress has been created:

   ingress/ingress-test created

4. Check the created ingress.

   kubectl get ingress

   If information similar to the following is displayed, the ingress has been created:

   NAME          CLASS    HOSTS     ADDRESS          PORTS   AGE
   ingress-test  cce      *         121.**.**.**     88      10s