All Products
Search
Document Center

Container Service for Kubernetes:Manage the NGINX Ingress controller

Last Updated:Jul 02, 2024

Container Service for Kubernetes (ACK) clusters and ACK Serverless clusters provide the NGINX Ingress controller. This topic describes how to install, update, configure, and uninstall the NGINX Ingress controller in ACK clusters and ACK Serverless clusters.

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:

Method 1: Install the NGINX Ingress controller when you create a cluster

When you create an ACK cluster or ACK Serverless cluster, select Nginx Ingress in the Ingress section of the Component Configurations wizard page. For more information, see Create an ACK Pro cluster or Create an ACK Serverless cluster.

You can specify whether to create an Internet-facing Server Load Balancer (SLB) instance or internal-facing SLB instance in the Ingress section. You can also specify the specification of the SLB instance.

ingress

Method 2: 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 update and configure the component in the Nginx Ingress Controller card on the Networking tab of the Add-ons page.

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

  • Before you update 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 update 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 update notes and usage notes for the NGINX Ingress controller, see Update the NGINX Ingress controller.