All Products
Search

This Product

    Container Service for Kubernetes:Manage the ALB Ingress controller

    Document Center

    Container Service for Kubernetes:Manage the ALB Ingress controller

    Last Updated:Jun 15, 2026

    Install, upgrade, or uninstall the ALB Ingress controller to route Layer 7 traffic to ACK clusters.

    Install the ALB Ingress controller

    Choose one of the following methods:

    • Creating a new cluster: Configure the controller as part of cluster creation.

    • Using an existing cluster: Install the controller from the Add-ons page after the cluster is running.

    Install during cluster creation

    When creating an ACK managed or dedicated cluster, go to the Ingress section and select ALB Ingress.

    Set ALB Instance to New, Existing, or None:

    Instance source Description What gets created
    (Recommended) New Create an ALB instance:
    - Network Type: Internet or Intranet
    - VPC: defaults to the cluster VPC
    - vSwitch: two vSwitches in different zones; auto-selected if blank. To create vSwitches, click Create vSwitch.
    See ALB billing rules.    		 An AlbConfig named alb and a corresponding IngressClass resource. Default: HTTP listener on port 80. To add HTTPS, see Create an HTTPS listener.
    (Recommended) Existing Select an existing ALB instance. Basic ALB instances are not supported. See Reuse an existing ALB instance. An AlbConfig named alb and a corresponding IngressClass resource, bound to the selected ALB instance.
    (Optional) None Install the controller without creating an ALB instance. Use this when specifying ALB instances in Ingress YAML. No ALB instance or related resources are created. You must manually create an AlbConfig and IngressClass.

    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. See the table above for details.

    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.

    Next steps

    References