This section describes how to upgrade extensions.

When a new version of an extension is available, you can upgrade it on the extension details page in the Extensions Center.

attention Attention

In versions prior to KubeSphere v4.2.0, the image tag was explicitly configured during extension installation. However, starting from KubeSphere v4.2.0, the image tag follows the extension version, using the default value by default, and does not require manual configuration.

Therefore, when upgrading an extension, it is crucial to confirm whether the image tag configuration meets expectations. New versions typically use new image tags. If you explicitly specify an old image tag in your configuration, it may result in pulling the old version image after the upgrade, preventing you from obtaining the latest features or fixes.

To ensure a smooth upgrade, please follow these recommendations:

  1. Check and remove manually set image tags, or update them to the image tags required for the new version.

  2. It is recommended to use the default configuration to automatically obtain the image tag matching the current version.

For the configuration paths of image tags for each extension, please refer to the upgrade instructions on the details page of each extension in the Extensions Center.

Prerequisites

You need to have the platform-admin role in the KubeSphere platform. For more information, refer to Users and Platform Roles.

Steps

  1. Log in to the KubeSphere web console with a user who has the platform-admin role.

  2. Click Extensions Center.

  3. Click the name of the installed extension to go to its details page.

  4. Click more under the extension icon and select Update.

  5. In the Update dialog box, follow the extension installation process to complete the upgrade.