Container Service for Kubernetes (ACK) and serverless Kubernetes (ASK) clusters offer the NGINX Ingress controller. This topic describes how to install, upgrade, configure, and uninstall the NGINX Ingress controller in ACK and ASK clusters.
The open source Ingress-NGINX project will no longer be maintained after March 2026. As a result, Container Service for Kubernetes will stop maintaining the NGINX Ingress controller add-on. Be aware of the risks involved. For more details, see [Product Announcement] Discontinuation of Maintenance for the NGINX Ingress Controller Add-on.
Contents
Install the NGINX Ingress controller
If you are creating a new cluster, use Method 1. If you have an existing cluster that does not have the NGINX Ingress controller installed, use Method 2 to install the add-on.
Method 1: Install during cluster creation
When you create an ACK or serverless Kubernetes (ASK) cluster, select Nginx Ingress in the Ingress section on the Component Configurations page. For more information, see Create an ACK Pro cluster or Create a cluster.
In this section, you can create an Internet-facing or internal-facing Server Load Balancer (SLB) instance and select its specifications.
Method 2: Install from the Add-ons page
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 Add-ons page, click the Networking tab. Find the NGINX Ingress controller card and click Install in the lower-right corner.
- In the Install Comment NGINX Ingress controller dialog box, configure the parameters and click OK.
Related operations
After you install the NGINX Ingress controller, you can manage it on the Add-ons page. On the Networking tab, use the buttons on the NGINX Ingress controller card to upgrade, configure, or uninstall the add-on.
Note the following when you upgrade or configure the add-on:
- Before you upgrade or configure the add-on, the system automatically runs a precheck. The NGINX Ingress controller will fail this check if its settings do not meet the upgrade or configuration requirements, or if it is in an unhealthy state. You must fix these issues before you can proceed.
- If the Upgrade button is not available on the NGINX Ingress controller card, the add-on is up to date. For more information about upgrade notes and step-by-step instructions, see Upgrade the NGINX Ingress controller.