Container Service for Kubernetes:Use ALB Ingresses to configure hybrid server groups, associate ECS instances with an ALB instance deployed in a different region, and associate on-premises servers with an ALB instance

Table of contents

• Usage notes

• Scenario 1: Forward requests to multiple Services in an ACK cluster or ACK Serverless cluster

• Scenario 2: Forward requests to the pods deployed in an ACK cluster or ACK Serverless cluster and ECS instances deployed outside the cluster

• Scenario 3: Forward requests to the pods in a cluster and ECS instances in a VPC deployed in a different region

• Scenario 4: Forward requests to the pods in a cluster and on-premises servers

Usage notes

• The Service name in the alb.ingress.kubernetes.io/actions.<Service name> annotation must be the same as that below the backend field in the rules section.

• When you configure server groups, you must set the Service port name below the backend field in the rules section to use-annotation.

• You can use the alb.ingress.kubernetes.io/actions.<Service name> annotation to associate multiple server groups with an ALB instance.

• You can associate up to five server groups with a basic ALB instance.

• The ServerGroupID setting prevails when you use both the ServerGroupID and ServiceName+ServicePort settings to associate server groups.

Scenario 1: Forward requests to multiple Services in an ACK cluster or ACK Serverless cluster

Prerequisites

• A VPC named VPC1 is created in a region. Two vSwitches named VSW1 and VSW2 are created in different zones of VPC1. For more information, see Create and manage a VPC and Create and manage a vSwitch.

• A Container Service for Kubernetes (ACK) cluster or ACK Serverless cluster is created in VPC1. For more information, see Create an ACK managed cluster and Create an ACK Serverless cluster.

• The ALB Ingress controller is installed in the ACK cluster or ACK Serverless cluster. For more information, see Manage the ALB Ingress controller.

• An ALB instance is created from an ALBConfig in the ACK cluster or ACK Serverless cluster and Services named tea-svc and coffee-svc are deployed in the cluster. For more information, see Access Services by using an ALB Ingress.

Scenario

In the following figure, the ServiceName+ServicePort setting is used to associate multiple server groups with the ALB Ingress. Multiple forwarding rules are configured for the ALB Ingress to forward requests to different Services in the cluster.

Procedure

1. Configure an ALB Ingress.

   Create a file named tea-ingress.yaml and add the following content to the file. Deploy this file to forward requests to multiple Services in the cluster.

   # Forward requests to different Services based on the hostname and path of the requests and specify the weight of each Service. 
   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: tea-ingress
     annotations:
       alb.ingress.kubernetes.io/actions.forward: |
          [{
              "type": "ForwardGroup",
              "ForwardConfig": {
                "ServerGroups" : [{
                  "ServiceName": "tea-svc",
                  "Weight": 80,
                  "ServicePort": 80
                },
                {
                  "ServiceName": "coffee-svc",
                  "Weight": 20,
                  "ServicePort": 80
                }]
              }
          }]
   spec:
     ingressClassName: alb
     rules:
      - host: demo.domain.ingress.top
        http:
         paths:
         - path: /path
           pathType: Prefix
           backend:
             service:
               name: forward
               port:
                 name: use-annotation

2. Access the Service by using a CLI. For more information, see the Step 4: Access the Services section of the "Access Services by using an ALB Ingress" topic.

Scenario 2: Forward requests to the pods deployed in an ACK cluster or ACK Serverless cluster and ECS instances deployed outside the cluster

Prerequisites

• A VPC named VPC1 is created in a region. For more information, see Create and manage a VPC.

• An ACK cluster or ACK Serverless cluster is created in VPC1. For more information, see Create an ACK managed cluster and Create an ACK Serverless cluster.

• At least one ECS instance is created in VPC1, and a web service is deployed on the ECS instance. For more information, see Create an instance on the Custom Launch tab and Build an LNMP stack on an ECS instance that runs Alibaba Cloud Linux 2 or 3.

• A server group is created. For more information, see Create and manage server groups.

• The ECS instance is added to the server group that you created. For more information, see Create and manage server groups.

• The alb.ingress.kubernetes.io/actions.<Service name> annotation is used to configure forwarding rules and associate the server group with the ALB Ingress.

Scenario

In the following figure, the ALB Ingress is used to forward requests to the pods deployed in the cluster and the ECS instance deployed outside the cluster. To do this, you need to create a server group in the ALB console or by calling the ALB API, and add the ECS instance to the server group. Then, record the server group ID and specify the ID in the configuration of the ALB Ingress.

Procedure

1. Configure an ALB Ingress.

   Create a file named tea-ingress.yaml and add the following content to the file. Deploy this file to forward requests to the pods in the cluster and the ECS instance outside the cluster.

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: tea-ingress
     annotations:
       alb.ingress.kubernetes.io/actions.forward: |
          [{
              "type": "ForwardGroup",
              "ForwardConfig": {
                "ServerGroups" : [{
                  "ServiceName": "tea-svc",
                  "Weight": 30,
                  "ServicePort": 80
                },
                {
                  "ServiceName": "coffee-svc",
                  "Weight": 20,
                  "ServicePort": 80
                },
                {
                  "ServerGroupID": "sgp-71aexb9y93ypo*****",
                  "Weight": 30
                },
                {
                  "ServerGroupID": "sgp-slygpbvm2cydo*****",
                  "Weight": 20
                }]
              }
          }]
   spec:
     ingressClassName: alb
     rules:
      - host: demo.domain.ingress.top
        http:
         paths:
         - path: /path
           pathType: Prefix
           backend:
             service:
               name: forward
               port:
                 name: use-annotation

2. Access the Service by using a CLI. For more information, see Access Services by using an ALB Ingress.

Scenario 3: Forward requests to the pods in a cluster and ECS instances in a VPC deployed in a different region

Prerequisites

• Two VPCs are created in different regions. vSwitches are created in different zones of each VPC. For example, VPC1 is created in the China (Chengdu) region and VPC2 is created in the China (Hangzhou) region.

  • VSW1 and VSW2 are created in VPC1. VSW1 is deployed in Zone A and VSW2 is deployed in Zone B.

  • VSW3 and VSW4 are created in VPC2. VSW3 is deployed in Zone H and VSW4 is deployed in Zone I.

  For more information, see Create and manage a VPC and Create and manage a vSwitch.

• An ACK cluster or ACK Serverless cluster is created in VPC1, and an ALB instance is created from an ALBConfig in the cluster. For more information, see Create an ACK managed cluster and Access Services by using an ALB Ingress.

• At least one ECS instance is created in VPC2, and a web service is deployed on the ECS instance. For more information, see Create an instance on the Custom Launch tab and Build an LNMP stack on an ECS instance that runs Alibaba Cloud Linux 2 or 3.

• A CEN instance is created and a bandwidth plan is associated with the CEN instance. For more information, see CEN instances and the Purchase a bandwidth plan section of the "Work with a bandwidth plan" topic.

• A transit router is created in the China (Chengdu) region. Another transit router is created in the China (Hangzhou) region. For more information, see the Create a transit router section of the "Transit routers".

Scenario

In the following figure, the ALB Ingress is used to forward requests to the pods in the cluster and the ECS instance in a VPC deployed in a different region. To do this, you need to create a CEN instance, attach VPC1 and VPC2 to the CEN instance, and add the ECS instance in VPC2 to a server group. Then, record the server group ID and specify the ID in the configuration of the ALB Ingress.

For example, an ACK cluster or ACK Serverless cluster is created in VPC1 in the China (Chengdu) region and an ALB instance is created from an ALBConfig in VPC1. You can use ALB together with CEN to forward requests to the ECS instance in VPC2 in the China (Hangzhou) region.

Procedure

1. Configure a CEN instance and create inter-region VPC connections.

   For more information, see Specify an ECS instance in a VPC as a backend server of ALB in a different region.

   Note

   You do not need to configure listeners in the ALB console for the ALB instance used by the ALB Ingress. You can perform Step 3 to configure listeners.

2. Add the ECS instance in VPC2 to a server group of the ALB instance.

   For more information, see the Add backend servers section of the "Create and manage server groups".

3. Use the alb.ingress.kubernetes.io/actions.<Service name> annotation to configure forwarding rules, associate the server group with the ALB Ingress, and forward requests to the pods in the cluster and the ECS instance in VPC2.

   Create a file named tea-ingress.yaml and add the following content to the file:

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: tea-ingress
     annotations:
       alb.ingress.kubernetes.io/actions.forward: |
          [{
              "type": "ForwardGroup",
              "ForwardConfig": {
                "ServerGroups" :  [{
                  "ServiceName": "tea-svc",
                  "Weight": 30,
                  "ServicePort": 80
                },
                {
                  "ServiceName": "coffee-svc",
                  "Weight": 20,
                  "ServicePort": 80
                },
                {
                  "ServerGroupID": "sgp-71aexb9y93ypo*****",
                  "Weight": 30
                },
                {
                  "ServerGroupID": "sgp-slygpbvm2cydo*****",
                  "Weight": 20
                }]
              }
          }]
   spec:
     ingressClassName: alb
     rules:
      - host: demo.domain.ingress.top
        http:
         paths:
         - path: /path
           pathType: Prefix
           backend:
             service:
               name: forward
               port:
                 name: use-annotation

Scenario 4: Forward requests to the pods in a cluster and on-premises servers

Prerequisites

• A CEN instance is created and a transit router is created for the CEN instance. For more information, see CEN instances and the Create a transit router section of the "Transit routers" topic.

• An Express Connect circuit and a virtual border router (VBR) are created. For more information, see Create and manage a dedicated connection over an Express Connect circuit and Create and manage a VBR.

Usage notes

For more information about the usage notes for associating on-premises servers with ALB instances, see the Precautions section of the "Add on-premises servers to an ALB instance within the same region" topic.

Scenario

In the following figure, the ALB Ingress is used to forward requests to the pods in the cluster and on-premises servers. To do this, you need to configure a CEN instance, an Express Connect circuit, and a VBR, and add on-premises servers to a server group. Then, record the server group ID and specify the ID in the configuration of the ALB Ingress.

For example, an ACK cluster or ACK Serverless cluster is deployed in VPC1 in the China (Chengdu) region and an ALB instance is created from an ALBConfig in the VPC. You can use a combination of ALB, CEN, VBRs, and Express Connect to forward requests to the on-premises servers in the region. The following figure shows the combination.

Procedure

1. Configure a CEN instance, attach the VBR and VPC1 in which the ALB instance resides to the transit router, and use the VBR to connect the data center to Alibaba Cloud. For more information, see Add on-premises servers to an ALB instance within the same region.

   Note

   You do not need to configure listeners in the ALB console for the ALB instance used by the ALB Ingress. You can perform Step 3 to configure listeners.

2. Use the alb.ingress.kubernetes.io/actions.<Service name> annotation to configure forwarding rules, associate the server group with the ALB Ingress, and forward requests to the pods in the cluster and on-premises servers.

   Create a file named tea-ingress.yaml and add the following content to the file:

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: tea-ingress
     annotations:
       alb.ingress.kubernetes.io/actions.forward: |
          [{
              "type": "ForwardGroup",
              "ForwardConfig": {
                "ServerGroups" :  [{
                  "ServiceName": "tea-svc",
                  "Weight": 30,
                  "ServicePort": 80
                },
                {
                  "ServiceName": "coffee-svc",
                  "Weight": 20,
                  "ServicePort": 80
                },
                {
                  "ServerGroupID": "sgp-ihydxb9y93ypo*****",
                  "Weight": 30
                },
                {
                  "ServerGroupID": "sgp-pd0ipbvm2cydo*****",
                  "Weight": 20
                }]
              }
          }]
   spec:
     ingressClassName: alb
     rules:
      - host: demo.domain.ingress.top
        http:
         paths:
         - path: /path
           pathType: Prefix
           backend:
             service:
               name: forward
               port:
                 name: use-annotation