CCE Ingress NGINX Controller Description

Component introduction

The CCE Ingress Nginx Controller manages ingress resources within Kubernetes clusters, offering optimizations for certain parameters based on the Kubernetes community’s Ingress Nginx Controller.

Component function

The controller leverages Nginx as a reverse proxy and load balancer to manage the semantics and functionality of Kubernetes Ingress.

• Beyond the configurations provided by Kubernetes Ingress, it offers a wide range of custom configuration options, enabling users to implement more versatile and detailed load balancing strategies.
• The component includes a load balancer service. After deployment, CCE will associate and create an application BLB to manage traffic ingress to the component’s Pods within the cluster.

Application scenarios

When BLB ingress cannot meet requirements, you can use Nginx Ingress to achieve more flexible and fine-grained load balancing strategies.

Usage restrictions

• When operating with Nginx Ingress, data traffic passes through the component’s Pods. To ensure resources are not monopolized by other Pods, the component should be deployed in a separate node group.

Install component

1. Sign in to the Baidu AI Cloud official website and enter the management console.
2. Select Product Tour > Containers > Baidu Container Engine and click to enter the CCE management console.
3. Click Cluster Management > Cluster List in the left navigation bar.
4. Click on the target cluster name in the Cluster List page to navigate to the cluster management page.
5. On the Cluster Management page, click O&M & Management > Component Management.
6. Select the CCE Ingress Nginx Controller component from the component management list and click Install, then complete the relevant configurations in the pop-up box.

7. Click the OK button to complete the component installation.
8. You can click Add Instance again to create multiple Nginx Ingress Controllers with different configurations to meet different service access scenarios. When creating an ingress resource object, select the IngressClass to specify the corresponding Nginx Ingress Controller for it.

Uninstall component

The component management console does not currently support uninstalling installed Nginx Ingress Controller instances. If you want to uninstall, you can find the target instance in Helm > Helm Instances and delete it

Deploy components using Baidu AI Cloud templates

The CCE Ingress NGINX Controller component has many configuration items, but the configurations available in the component management function are limited. You can also find the cce-ingress-nginx-controller template in Helm > Helm Templates for deployment and configuration modification.

If you want to deploy the component in the cluster independently and achieve linkage with component management, the following conditions must be met during Helm deployment:

1. The Helm Instance Name is {ingress-class}-ngx-control.
2. The deployment parameter fullnameOverride is {ingress-class}-ngx-control.

Among them, the value of {ingress-class} is consistent with the controller.ingressClass parameter in the deployment parameters, as shown in the figure:

Deployment status

After installing the CCE Ingress NGINX Controller component, several resource objects will be deployed in the Kubernetes cluster. The actual deployment content may vary depending on the chosen configuration.

• Some objects are only deployed in the cluster when relevant deployment parameters are enabled. The names and namespaces of some objects depend on the deployment configuration of the plugin.

Version records