ACK One provides a fully managed ALB Ingress controller for registered clusters. The controller is based on Application Load Balancer (ALB) layer 7 forwarding rules. This topic explains how to install and uninstall the controller.
Prerequisites
Before you begin, make sure you have:
-
An ACK One registered cluster with a self-managed Kubernetes cluster in your data center connected to it. For more information, see Create an ACK One registered cluster.
-
A kubeconfig file for the registered cluster and kubectl access configured. For more information, see Obtain the cluster kubeconfig and connect to the registered cluster using kubectl.
ALB Ingress is only available in regions and zones that support Application Load Balancer. Verify that your cluster is in a supported region before proceeding. For the full list, see Regions and zones that support ALB.
Install the ALB Ingress controller
Choose the method that fits your workflow:
-
onectl CLI — best for automation, scripting, and CI/CD pipelines.
-
ACK console — best for one-time setup or when you prefer a visual interface.
Use onectl
-
Install onectl on your on-premises machine. For more information, see Use onectl to manage registered clusters.
-
Run the following command:
onectl addon install alb-ingress-controllerThe expected output is:
Addon alb-ingress-controller, version **** installed.
Use the console
-
Log on to the ACK console. In the left navigation pane, click Clusters.
-
On the Clusters page, click the name of your cluster. In the left navigation pane, click Add-ons.
-
On the Network tab, find ALB Ingress controller and click Install.
Uninstall the ALB Ingress controller
Use onectl
Run the following command:
onectl addon uninstall alb-ingress-controllerThe expected output is:
Addon alb-ingress-controller uninstalled.Use the console
-
Log on to the ACK console. In the left navigation pane, click Clusters.
-
On the Clusters page, click the name of your cluster. In the left navigation pane, click Add-ons.
-
On the Network tab, find ALB Ingress controller and click Uninstall.
What's next
-
To route requests from different URLs to different Services in your cluster, see Access Services by using an ALB Ingress.
-
For advanced configurations such as domain-name-based and URL-path-based routing (Exact, ImplementationSpecific, and Prefix), health checks, and canary releases, see Advanced ALB Ingress configurations.