All Products
Search
Document Center

Container Service for Kubernetes:Manage the ALB Ingress controller component

Last Updated:Feb 26, 2026

ACK serverless clusters provide a managed ALB Ingress Controller based on Layer 7 forwarding rules of the Application Load Balancer (ALB). This topic describes how to install, upgrade, and uninstall the ALB Ingress Controller in ACK serverless clusters.

Install the ALB Ingress controller

Note

For more information about the regions that support this add-on, see Regions and zones.

Install the controller during cluster creation

When you create an ACK serverless cluster, on the Component Configurations page, select ALB Ingress in the Ingress section. Then, for ALB Instance, select Create or None as needed.

ALB Cloud-native Gateway Instance Source

Description

Result

New

Installs the ALB Ingress Controller component and creates an ALB instance.

You can create an Intranet or Intranet ALB instance. For more information about billing, see ALB billing rules.

The controller automatically creates an AlbConfig object and a corresponding IngressClass resource that are named alb. In the AlbConfig object, a listener is configured on port 80 over HTTP by default. For more information about listener extensions, see Create an HTTPS listener.

Do Not Create Now

Does not create an ALB instance. Only the ALB Ingress Controller component is installed.

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

Install on an existing cluster

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

  2. On the Clusters page, find the one you want to manage and click its name. In the left navigation pane, click Add-ons.

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

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

    Instance source

    Description

    Result

    (Recommended) New

    • Network Type: Create an Internet or Intranet ALB instance based on your requirements. For billing details, see ALB billing rules.

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

    • vSwitch: Displays the vSwitches that correspond to the zones supported by Application Load Balancer (ALB) in this virtual private cloud (VPC). You must specify two vSwitches in different zones. If you specify none, two available vSwitches are automatically selected. Alternatively, click Create vSwitch to create new vSwitches.

    The Controller automatically creates an AlbConfig named alb and a corresponding IngressClass resource. By default, the AlbConfig is configured with an HTTP listener on port 80. For more information about listener extensions, see Create an HTTPS listener.

    (Recommended) Existing

    Select an existing ALB instance from the drop-down list. Basic ALB instances are not supported. See Reuse an existing ALB instance.

    (Optional) None

    Installs only the ALB Ingress controller. No ALB instance is created.

    Important

    The controller does not create the related resources. You must 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, find the one you want to manage and click its name. In the left navigation pane, click Add-ons.

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

    Note

    If the ALB Ingress Controller section does not display an Upgrade button, the component is already updated to the latest version.

  4. In the Update dialog box, click OK.

Uninstall the ALB Ingress controller

Important
  • Before you uninstall the add-on, delete the AlbConfig from the cluster. The ALB Ingress controller automatically releases the corresponding ALB instance.

  • After you uninstall the ALB Ingress controller:

    • If an AlbConfig is not deleted from the cluster, the corresponding ALB instance is not released and continues to incur fees.

    • If you manually delete the AlbConfig after the controller is uninstalled, the ALB instance cannot be released. This is because the reconciliation operation cannot be completed without the controller. To resolve this issue, you must reinstall the add-on, delete the AlbConfig to release the corresponding ALB instance, and then uninstall the add-on.

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

  2. On the Clusters page, find the one you want to manage and click its name. 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.