All Products
Search
Document Center

Microservices Engine:Migrate the MSE Ingress Controller component from the Marketplace page to the Add-ons page

Last Updated:Jul 17, 2026

The MSE Ingress Controller component on the Marketplace page has reached end of life (EOL). Migrate it to the Add-ons page in the Container Service for Kubernetes (ACK) console to continue receiving updates.

Notes on migration

Note

This migration applies only if you installed the MSE Ingress Controller from the Marketplace page.

The MSE Ingress Controller is a control plane for managing MSE cloud-native gateways and their configurations. It does not handle service requests directly. Because it operates as a traffic bypass, migrating the component does not affect business continuity.

Important

During the migration, operations are performed only on the MSE Ingress Controller component. Do not delete MseIngressConfig CustomResourceDefinition (CRD) configurations in your cluster. Each MseIngressConfig CRD maps one-to-one with an MSE cloud-native gateway. Deleting a CRD also deletes the associated gateway.

Procedure

Step 1: Uninstall the ack-mse-ingress-controller component on the Marketplace page

  1. Log on to the managed ACK console, ACK Serverless console, or ACS console.

  2. In the left-side navigation pane, click Clusters. Then, click the name of the cluster that you want to manage.

  3. In the left-side navigation pane, choose Applications > Helm.

  4. On the Helm page, find the ack-mse-ingress-controller component and click Delete in the Actions column.

  5. In the Delete application dialog box, click OK.

    The ack-mse-ingress-controller component is uninstalled.

Step 2: Install the MSE Ingress Controller component on the Add-ons page

  1. Log on to the managed ACK console, ACK Serverless console, or ACS console.

  2. In the left-side navigation pane, click Clusters. Then, click the name of the cluster that you want to manage.

  3. In the left-side navigation pane, choose Operations > Add-ons.

  4. On the Add-ons page, click the Networking tab. In the lower-right corner of the MSE Ingress Controller component card, click Install.

  5. In the Install Component MSE Ingress Controller dialog box, configure Source of MSE Cloud-Native Gateway Instance and Network Type, and then click OK.

    Each MseIngressConfig CRD maps one-to-one with an MSE cloud-native gateway. If you select Cascade Delete SLB Instance, the associated SLB instance is deleted when you delete an MseIngressConfig CRD.
  6. After the installation is complete, the MSE Ingress Controller card displays Installed in the upper-right corner. You can navigate to Application and click mse-ingress-controller to view configuration details.