All Products
Search
Document Center

Container Service for Kubernetes:Manage the ALB Ingress controller

Last Updated:Aug 26, 2026

ACK Serverless clusters provide a managed ALB Ingress controller that uses the Layer 7 forwarding rules of Application Load Balancer (ALB). This topic describes how to install, upgrade, and uninstall the ALB Ingress controller in an ACK Serverless cluster.

Install the ALB Ingress controller

During cluster creation

When you create an ACK Serverless cluster, on the Component Configurations page, select ALB Ingress in the Ingress section. Then, under ALB Instance, select Create or None based on your requirements.

Gateway source

Description

Result

New

Installs the ALB Ingress controller and creates an associated ALB instance.

You can create an Intranet or Intranet ALB instance based on your requirements. For billing details, see ALB billing rules.

The controller automatically creates an AlbConfig object named alb and the corresponding IngressClass resource. The AlbConfig object defines a default listener that uses HTTP on port 80. To learn how to add more listeners, see Create an HTTPS listener.

None

Installs only the ALB Ingress controller without creating an ALB instance.

Important

The controller does not create these resources. You must manually create an AlbConfig object and an IngressClass resource.

For an existing cluster

Install on an existing cluster

  1. Log on to the ACK console. In the left navigation pane, click Clusters.

  2. On the Clusters page, click the name of your cluster. In the left navigation pane, click Add-ons.

  3. On the Add-ons page, click the Networking tab. In the Networking section, click Install on the ALB Ingress Controller card.

  4. In the Install ALB Ingress Controller dialog box, select New, Existing, or None for ALB Instance, configure the remaining parameters, and click OK.

    Instance source

    Description

    Result

    (Recommended)New

    • Network Type: Create an Internet or Private Network ALB instance as needed. For more information about billing, see ALB billing.

    • VPC: The default value is the VPC of the cluster.

    • vSwitch: Displays the virtual switches in the zones that the ALB instance supports within this VPC. Specify two vSwitches in different zones. If you do not specify vSwitches, the system automatically selects two active vSwitches. You can also click Create vSwitch to create a new vSwitch.

    The Controller automatically creates an AlbConfig resource named alb and a corresponding IngressClass resource. The AlbConfig includes a default listener that uses the HTTP protocol on port 80. For more information about listener extensions, see Configure ALB instances with AlbConfig.

    (Recommended)Existing

    Select an existing ALB instance from the drop-down list. Basic Edition ALB instances are not supported. For more information, see Configure ALB instances with AlbConfig.

    (Optional)None

    Does not create an ALB instance. Installs only the ALB Ingress Controller component.

    Important

    The Controller does not create the corresponding resources. Manually create an AlbConfig and an IngressClass.

Upgrade the ALB Ingress controller

  1. Log on to the ACK console. In the left navigation pane, click Clusters.

  2. On the Clusters page, click the name of your cluster. In the left navigation pane, click Add-ons.

  3. On the Add-ons page, click the Networking tab. In the ALB Ingress Controller section, click Upgrade.

    Note

    If no Upgrade button appears, the controller is at the latest version.

  4. In the Upgrade dialog box, click OK.

Uninstall the ALB Ingress controller

Important

Delete the AlbConfig in the cluster before uninstalling the controller. The ALB Ingress Controller then automatically releases the corresponding ALB instance.

  • If undeleted AlbConfig remains in the cluster, the corresponding ALB instance is not released and continues to incur fees.

  • Subsequent AlbConfig deletion fails because the controller is no longer present. To recover, reinstall the controller, delete the AlbConfig to release the ALB instance, then uninstall the controller.

  1. Log on to the ACK console. In the left navigation pane, click Clusters.

  2. On the Clusters page, click the name of your cluster. In the left navigation pane, click Add-ons.

  3. On the Add-ons page, click the Networking tab. In the ALB Ingress Controller section, click Uninstall.

  4. In the Uninstall dialog box, click OK.