All Products
Search
Document Center

Container Service for Kubernetes:Manage the NGINX Ingress controller

Last Updated:May 06, 2025

Container Service for Kubernetes (ACK) provides the NGINX Ingress controller. This topic describes how to install, upgrade, configure, and uninstall the NGINX Ingress controller.

Install the NGINX Ingress controller

If you do not have an existing cluster, use Method 1 to install the NGINX Ingress controller. If you use an existing cluster that does not have the NGINX Ingress controller installed, use Method 2 to install the NGINX Ingress controller in the cluster. Example:

Install the NGINX Ingress controller when you create a cluster

When you create an ACK cluster, select Nginx Ingress in the Ingress section of the Component Configurations step. You can specify the source, type, and specification of the SLB instance used by the NGINX Ingress controller.

Install the NGINX Ingress controller on the Add-ons page

  1. Log on to the ACK console. In the left-side navigation pane, click Clusters.

  2. On the Clusters page, find the cluster that you want to manage and click its name. In the left-side pane, choose Operations > Add-ons.

  3. On the Add-ons page, click the Networking tab. Find the Nginx Ingress Controller card and click Install.

  4. In the Install Nginx Ingress Controller dialog box, configure the parameters and click OK.

Uninstall the NGINX Ingress controller (optional)

  1. Log on to the ACK console. In the left-side navigation pane, click Clusters.

  2. On the Clusters page, find the cluster that you want to manage and click its name. In the left-side pane, choose Operations > Add-ons.

  3. On the Add-ons page, click the Networking tab. Find the Nginx Ingress Controller card and click Uninstall.

  4. In the Uninstall dialog box, click OK.

What to do next

After you install the NGINX Ingress controller, you can upgrade and configure the component in the Nginx Ingress Controller card on the Networking tab of the Add-ons page.

When you upgrade or configure the NGINX Ingress controller, take note of the following items:

  • Before you upgrade or configure the NGINX Ingress controller, the system automatically performs a precheck to check whether the status of the component meets the requirements. If the NGINX Ingress controller is in an unhealthy state or the configuration of the NGINX Ingress controller does not meet the requirements, the NGINX Ingress controller fails to pass the precheck. You must fix the relevant issues before you can upgrade or configure the NGINX Ingress controller.

  • If the Upgrade button is not displayed in the Nginx Ingress Controller section, the installed NGINX Ingress controller is of the latest version. For more information about the upgrade notes and usage notes for the NGINX Ingress controller, see Update the NGINX Ingress controller.