All Products
Search

This Product

    Container Compute Service:Manage the ALB Ingress controller

    Document Center

    Container Compute Service:Manage the ALB Ingress controller

    Last Updated:Dec 05, 2025

    The Application Load Balancer (ALB) Ingress controller is a managed component for Container Compute Service (ACS) clusters that controls traffic forwarding based on the Layer 7 forwarding rules of ALB. This topic describes how to install, upgrade, and uninstall the ALB Ingress controller in an ACS cluster.

    Install the ALB Ingress controller

    Note

    For more information about the regions that support this component, see Regions and zones that support ALB.

    Installation during cluster creation

    1. Log on to the ACS console and click Create Kubernetes Cluster.

    2. In the Component Configurations > Ingress section, select ALB Ingress.

      Note

      For more information about other configurations, see Create an ACS cluster.

    Install the ALB Ingress controller in an existing cluster

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

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

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

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

      Instance source

      Description

      Result

      (Recommended) New

      • Network Type: You can create a 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 do not specify any, two available vSwitches are automatically selected. You can also 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

      You can select an existing ALB instance from the drop-down list. Basic ALB instances are not supported. For more information, 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.

    What to do next

    After you install the ALB Ingress controller component, the cluster automatically creates an AlbConfig custom resource definition (CRD). You can then perform the following operations:

    • View the component YAML file: On the component card, click the image icon and select View in YAML to view the YAML file of the component's custom resource definition (CRD).

    • Enable component logs: On the component card, click the image icon, select Enable Log Collection, and then click OK. After the operation is complete, you can select View Logs or Disable Logging.

      Note

      To enable access logs for a specific ALB instance, navigate to Operations > Log Center > Network Component Logs in the navigation pane on the left of the ACS console. On the ALB Ingress page, click the Data Import Management tab and enable access logs for the specified ALB instance.

    • Create custom resources: For more information about how to create AlbConfig and IngressClass custom resources, see Quick Start for ALB Ingresses.

    Upgrade the ALB Ingress controller

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

    2. On the Clusters page, click the name of the target 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.

    4. In the Update dialog box, click OK.

    Uninstall the ALB Ingress controller

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

    2. On the Clusters page, click the name of the target 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.

    Important

    Each AlbConfig custom resource corresponds to an ALB instance. If you no longer plan to use ALB Ingress, you must first delete the AlbConfig custom resources in the cluster. This automatically releases the corresponding ALB instances. After the instances are released, you can uninstall the ALB Ingress controller component. In the following scenarios, you must manually delete resources to avoid extra charges:

    • If you uninstall the ALB Ingress controller component, any remaining AlbConfig custom resources and their corresponding ALB instances are not released. You must manually delete these resources to avoid charges.

    • If you delete the AlbConfig custom resources after you uninstall the ALB Ingress controller component, the corresponding ALB instances are not released. You must manually delete the instances to avoid charges.

    References

    • For more information about the ALB Ingress controller component and its release notes, see ALB Ingress Controller.