All Products
Search
Document Center

Microservices Engine:Install and update the Microservices Governance component

Last Updated:Mar 10, 2026

Microservices Engine (MSE) delivers service governance capabilities through the ack-onepilot component, which runs inside your Container Service for Kubernetes (ACK) cluster. Installing and keeping ack-onepilot up to date gives you access to the latest service governance features.

If your cluster still uses the deprecated ack-mse-pilot component, migrate to ack-onepilot. See Migrate from ack-mse-pilot to ack-onepilot.

Prerequisites

Before you begin, make sure that you have:

  • An ACK cluster

  • Permissions to manage cluster add-ons

  • (Migration only) A backup of any environment variables configured for ack-mse-pilot

Note

If the ack-mse-pilot component is installed in your cluster, uninstall it before you install ack-onepilot. See Migrate from ack-mse-pilot to ack-onepilot for the full procedure.

Install ack-onepilot

  1. Log on to the ACK 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 Logs and Monitoring tab, find the ack-onepilot card, and then click Install.

  5. In the Parameters dialog box, confirm the parameters and click OK.

    Installation takes about 2 minutes.

Update ack-onepilot

Update ack-onepilot to the latest version to access new service governance features and bug fixes.

  1. Log on to the ACK 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 ack-onepilot, and click Update in the Actions column.

  5. In the Update Release panel, select the latest version, and click OK.

    The update takes about 2 minutes.

Migrate from ack-mse-pilot to ack-onepilot

The ack-mse-pilot component is deprecated. If it is still installed in your cluster, replace it with ack-onepilot by following these steps.

Important

Back up the environment variables of your ack-mse-pilot component before you uninstall it. You may need to restore these variables when you configure ack-onepilot.

Step 1: Back up environment variables

Record all environment variables configured for the ack-mse-pilot component. You will need these values when you configure ack-onepilot in Step 3.

Step 2: Uninstall ack-mse-pilot

  1. Log on to the ACK 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 ack-mse-pilot, and click Delete in the Actions column.

  5. In the Delete message, click OK.

Step 3: Install ack-onepilot

  1. Follow the steps in Install ack-onepilot to install the component.

  2. If you backed up environment variables from ack-mse-pilot in Step 1, apply them to the ack-onepilot configuration during installation.