Deploy & Configure the ALB Ingress Controller - ACK Serverless

The ALB Ingress Controller is a managed add-on for ACK serverless clusters. It watches Ingress resources in your cluster and configures Application Load Balancer (ALB) Layer 7 routing rules to match. Use this topic to install, upgrade, or uninstall the add-on.

Note

For supported regions, see Regions and zones.

How it works

When you install the ALB Ingress Controller, it manages an ALB instance through two Kubernetes resources:

AlbConfig — declares which ALB instance the controller manages and how listeners are configured.
IngressClass — links Ingress resources to the ALB Ingress Controller so the controller knows which Ingress objects to reconcile.

When you select New or Existing during installation, the controller creates these resources automatically. When you select None, you create them manually after installation.

Install the ALB Ingress controller

Install during cluster creation

On the Component Configurations page, go to the Ingress section and select ALB Ingress.

For ALB Instance, choose an option based on your needs:

ALB Cloud-native gateway instance source	Description	Result
New	Installs the ALB Ingress Controller and creates an ALB instance. Choose Internet for public access or Intranet for internal access. For billing details, see ALB billing rules.	The controller automatically creates an `AlbConfig` object and an `IngressClass` resource, both named `alb`. A listener on port 80 over HTTP is configured by default. To add an HTTPS listener, see Create an HTTPS listener.
Do Not Create Now	Installs only the controller. No ALB instance is created.	The controller does not create any resources. Manually create an AlbConfig object and an IngressClass resource before creating Ingress objects.

Install on an existing cluster

Log on to the ACK console. In the left navigation pane, click Clusters.
On the Clusters page, click the name of the cluster you want to manage. In the left navigation pane, click Add-ons.
On the Add-ons page, click the Networking tab. On the ALB Ingress Controller card, click Install in the lower-right corner.

In the Install ALB Ingress Controller dialog box, for ALB Instance, choose an option based on your needs:

Instance source	Description	Result
(Recommended) New	Creates a new ALB instance alongside the controller. Configure: Network Type (Internet or Intranet), VPC (defaults to the cluster VPC), and vSwitch (two vSwitches in different zones are required; if none are specified, two available vSwitches are selected automatically). For billing details, see ALB billing rules. To create new vSwitches, click Create vSwitch.	The controller automatically creates an `AlbConfig` named `alb` and a corresponding `IngressClass` resource. A listener on port 80 over HTTP is configured by default. To add an HTTPS listener, see Create an HTTPS listener.
(Recommended) Existing	Reuses an existing ALB instance. Select it from the drop-down list. Basic ALB instances are not supported. For details, see Reuse an existing ALB instance.	—
(Optional) None	Installs only the controller. No ALB instance is created.	The controller does not create any resources. Manually create an AlbConfig and an IngressClass before creating Ingress objects.

Click OK.

Upgrade the ALB Ingress controller

Log on to the ACK console. In the left navigation pane, click Clusters.
On the Clusters page, click the name of the cluster you want to manage. In the left navigation pane, click Add-ons.
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 already at the latest version.
In the Update dialog box, click OK.

Uninstall the ALB Ingress controller

Important

Delete the AlbConfig object from the cluster *before* uninstalling the add-on. When the controller is still running, deleting AlbConfig triggers it to release the associated ALB instance automatically. If you uninstall the controller first and then delete AlbConfig, the controller is no longer running and cannot complete the reconciliation that releases the ALB instance. The instance continues to run and incur fees. To recover from this state, reinstall the add-on, delete AlbConfig to release the ALB instance, and then uninstall the add-on again.

Log on to the ACK console. In the left navigation pane, click Clusters.
On the Clusters page, click the name of the cluster you want to manage. In the left navigation pane, click Add-ons.
On the Add-ons page, click the Networking tab. In the ALB Ingress Controller section, click Uninstall.
In the Uninstall dialog box, click OK.

Container Service for Kubernetes:Manage the ALB Ingress controller component