Upgrading a Mesh

Updated on 2024-09-05 GMT+08:00

View PDF

Scenario

You can upgrade a mesh of an earlier version. ASM of the Basic edition supports canary upgrades, and ASM of the Enterprise edition supports in-place patch upgrade.

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

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

NOTE:

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

Procedure

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 meshes to be upgraded is displayed above the list.
- Check whether Upgrade is displayed on the right of the mesh name.
If a service mesh can be upgraded, click its name to go to its details page.
In the navigation pane, choose Mesh Configuration. Then click the Upgrade tab.
Select a proper upgrade mode to upgrade the service mesh according to Upgrade Path.
- Upgrading the Edition
- Updating the Edition Patch
  Click Update Patch. In the dialog box that is displayed, click OK.
  
  Figure 1 Patch update