All Products
Search
Document Center

Container Service for Kubernetes:Manage the ALB Ingress controller

Last Updated:Aug 05, 2025

ACK Serverless clusters provide the managed ALB Ingress controller based on Layer 7 forwarding rules of 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 the ALB Ingress controller, see Regions and zones.

Install the controller during cluster creation

When creating an ACK Serverless cluster, on the Component Configurations step, select ALB Ingress in the Ingress section. Then, in the Gateway Source section, select New or None as needed.

Gateway Source

Description

Result

New

Installs the ALB Ingress controller and creates an ALB instance.

You can create a Internet-facing or intranet-facing ALB instance. For billing details, see Billing rules.

The controller will automatically create an AlbConfig named alb and the corresponding IngressClass resource. In AlbConfig, a listener with port 80 and HTTP is configured by default. For more information about listener extensions, see Create an HTTP listener.

None

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

The controller will not create the corresponding resources. You must manually create an AlbConfig and an IngressClass.

Install the controller for existing clusters

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

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

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

  4. In the Install ALB Ingress Controller dialog box, select New, Existing, or None for the Gateway Source as appropriate, and click OK.

    Instance source

    Description

    Result

    New (Recommended)

    • Network Type: You can create an ALB instance for Internet or Intranet as needed. For billing details, see Billing rules.

    • VPC: This value is the same as the VPC in which the cluster resides and cannot be modified.

    • vSwitch: The vSwitches corresponding to the zones supported by ALB under this VPC are displayed. You need to select two vSwitches in different zones. Otherwise, two available vSwitches will be automatically selected. You can also create a new vSwitch by clicking Create vSwitch.

    The controller will automatically create an AlbConfig named alb and the corresponding IngressClass resource. In AlbConfig, a listener with port 80 and HTTP is configured by default. For more information about listener extensions, see Create an HTTP listener.

    Existing (Recommended)

    You can select an existing ALB instance from the drop-down menu for reuse. Basic ALB instances are not supported. For more information, see Reuse an existing ALB instance.

    None (Optional)

    Only the ALB Ingress controller is installed. No ALB instance is created.

    Important

    The controller will not create the corresponding resources. You must manually create an AlbConfig and an IngressClass.

Upgrade the ALB Ingress controller

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

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

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

    Note

    If the Upgrade button is not displayed for ALB Ingress Controller, this indicates that the latest version is already installed and no upgrade is required.

  4. In the Upgrade message, click OK.

Uninstall the ALB Ingress controller

Important
  • Before uninstalling the component, ensure that you delete the AlbConfig in the cluster. The ALB Ingress controller component will automatically release the associated ALB instance.

  • After uninstalling the ALB Ingress controller component:

    • If AlbConfig remains in the cluster, the corresponding ALB instance will not be released and will continue to incur charges.

    • Manually deleting AlbConfig may prevent the ALB instance from being released. Without controller support, the tuning operation cannot be completed. In this case, we recommend that you reinstall the component, delete the AlbConfig to ensure the ALB instance is released, then uninstall the component.

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

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

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

  4. In the Uninstall message, click OK.