All Products
Search
Document Center

Container Service for Kubernetes:Manage the MSE Ingress Controller add-on

Last Updated:Jun 24, 2026

Alibaba Cloud ACK managed clusters, ACK Serverless clusters, and ACS clusters provide a managed MSE Ingress Controller based on the MSE cloud-native gateway. This topic describes how to install, upgrade, and uninstall the MSE Ingress Controller add-on in ACK managed clusters, ACK Serverless clusters, and ACS clusters.

Install the MSE Ingress Controller add-on

Note

The MSE Ingress Controller add-on can be installed in ACK managed clusters, ACK Serverless clusters, and ACS clusters.

Method 1: Install the add-on during cluster creation

  • When you create an ACK managed cluster or an ACK Serverless cluster, in the Component Configurations step, select MSE Ingress in the Ingress section. For more information about how to create a cluster, see Create an ACK managed cluster and Create an ACK Serverless cluster.

    For Source of MSE cloud-native gateway instance, select Create new or Use existing. If you select Create new, the system automatically creates a pay-as-you-go professional edition MSE cloud-native gateway instance that has two 2-core, 4 GiB nodes, and a standard slb.s2.small Cloud Load Balancer instance. Set network type to public network. In the service discovery section, you can select Install NodeLocal DNSCache. After installation, you must enable DNS configuration injection to activate this feature.

  • When you create an ACS cluster, in the Component Configurations section, select MSE Ingress for the Ingress parameter. For more information about how to create an ACS cluster, see Create an ACS cluster.

    For Source of MSE cloud-native gateway instance, select Create new. This selection automatically creates a pay-as-you-go professional edition MSE cloud-native gateway instance with two 2-core, 4 GiB nodes. Set network type to public network.

Method 2: Install the add-on from the Add-ons page

  1. ACK managed and Serverless

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

    2. On the Clusters page, click the name of your cluster. In the left navigation pane, click Components and Add-ons.

    ACS

    1. Log on to the ACS console. In the left navigation pane, click Clusters.

    2. On the Clusters page, click the name of the target cluster. In the left navigation pane, click Add-ons.

  2. On the Add-ons page, enter mse in the search box. On the MSE Ingress Controller card, click Install.

Method 3: Install the add-on from the Ingresses page

ACK managed and Serverless

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

  2. On the Clusters page, click the name of your cluster. In the left navigation pane, click Network > Ingresses.

  3. On the Routes page, click Create Ingress. In the Create Ingress panel, set Gateway Type to MSE Ingress. If the add-on is not installed, click Start Installation in the prompt that appears.

ACS

  1. Log on to the ACS console. In the left navigation pane, click Clusters.

  2. On the Clusters page, click the name of the target cluster. In the left navigation pane, choose Network > Ingresses.

  3. On the Routes page, click Create Ingress. In the Create Ingress panel, set Gateway Type to MSE Ingress. Click Start Installation in the prompt that appears below the Gateway Type field.

Upgrade the MSE Ingress Controller add-on

  1. ACK managed and Serverless

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

    2. On the Clusters page, click the name of your cluster. In the left navigation pane, click Components and Add-ons.

    ACS

    1. Log on to the ACS console. In the left navigation pane, click Clusters.

    2. On the Clusters page, click the name of the target cluster. In the left navigation pane, click Add-ons.

  2. On the Add-ons page, click the Network tab. On the MSE Ingress Controller card, click Upgrade.

    Note

    If the Upgrade button is not visible, the add-on is up to date.

  3. In the Upgrade Component panel, click OK.

Uninstall the MSE Ingress Controller add-on

  1. ACK managed and Serverless

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

    2. On the Clusters page, click the name of your cluster. In the left navigation pane, click Components and Add-ons.

    ACS

    1. Log on to the ACS console. In the left navigation pane, click Clusters.

    2. On the Clusters page, click the name of the target cluster. In the left navigation pane, click Add-ons.

  2. On the Add-ons page, click the Network tab. In the lower-right corner of the MSE Ingress Controller card, click Uninstall.

  3. In the Uninstall Component panel, click OK.