Updated on 2025-03-07 GMT+08:00

Upgrading a Service Mesh

Scenarios

You can upgrade a service mesh of an earlier version. Service meshes of the Basic edition supports canary upgrades.

Upgrade Impact

  • During the upgrade, the data plane proxy of the new version is automatically injected. Service pods will be restarted in the rolling mode, which may temporarily interrupt services.
  • Do not perform operations including but not limited to creating a grayscale release task or configuring a traffic rule during the upgrade.

Upgrade Path

Service Mesh Edition

Source Version

Target Version

Upgrade Mode

Basic edition

1.8.4-r1

1.8.6-r2

Patch update

1.8.4-r2

1.8.6-r2

Patch update

1.8.4-r3

1.8.6-r2

Patch update

1.8.4-r4

1.8.6-r2

Patch update

1.8.4-r5

1.8.6-r2

Patch update

For details about the features of each version, see Features in v1.3, Features in v1.6, and Features in v1.8.

Procedure

  1. Log in to the ASM console and check whether the meshes need to be upgraded. The specific steps are as follows:

    • Check whether a message indicating the service mesh to be upgraded is displayed above the list.

    • Check whether Upgrade is displayed on the right of the service mesh name.

    If a service mesh can be upgraded, click its name to go to its details page.

  2. In the navigation pane, choose Mesh Configuration. Then, click the Upgrade tab.
  3. Select a proper upgrade mode to upgrade the service mesh according to Upgrade Path.

    • Upgrading the Version of the Basic Edition

      Click Upgrade Mesh. The system automatically diagnoses the upgrade. After all items pass the check, click Upgrade.

    • Updating the Patch of the Enterprise Edition

      Click Update Patch. In the dialog box that is displayed, click OK.