Registered clusters of Container Service for Kubernetes (ACK) provide the fully-managed Application Load Balancer (ALB) Ingress controller that uses ALB Layer 7 forwarding rules. This topic describes how to install the ALB Ingress controller in a registered cluster and how to uninstall it from a registered cluster.
Prerequisites
An external Kubernetes cluster is registered in the Container Service for Kubernetes (ACK) console. For more information, see Create a registered cluster and register an external cluster with ACK.
A kubectl client is connected to the registered cluster. For more information, see Obtain the kubeconfig file of a cluster and use kubectl to connect to the cluster.
Limits
To access Services in a registered cluster through ALB Ingresses, make sure that the registered cluster resides in the region and zone supported by ALB. For more information about the regions and zones that ALB supports, see Supported regions and zones.
Install the ALB Ingress controller
Use onectl
Install onectl on your on-premises machine. For more information, see Use onectl to manage registered clusters.
Run the following command to install the ALB Ingress controller:
onectl addon install alb-ingress-controllerExpected output:
Addon alb-ingress-controller, version **** installed.
Use the console
Log on to the ACK console. In the left-side navigation pane, click Clusters.
On the Clusters page, click the name of the cluster that you want to manage and choose in the left-side navigation pane.
Click the Networking tab, find ALB Ingress Controller, and then click Install.
Uninstall the ALB Ingress controller
Use onectl
Run the following command to uninstall the ALB Ingress controller:
onectl addon uninstall alb-ingress-controllerExpected output:
Addon alb-ingress-controller uninstalled.Use the console
Log on to the ACK console. In the left-side navigation pane, click Clusters.
On the Clusters page, click the name of the cluster that you want to manage and choose in the left-side navigation pane.
Click the Networking tab, find ALB Ingress Controller, and then click Uninstall.
References
You can configure Ingress rules to access different Services in a cluster through different URLs. For more information, see Access Services by using an ALB Ingress.
For more information about how to use ALB Ingresses to forward requests based on domain names, forward requests without domain names, forward requests based on URL paths (Exact, ImplementationSpecific, and Prefix), configure health checks, and perform canary releases, see Advanced ALB Ingress configurations.