Upgrading SonarQube
Upgrading SonarQube is a relatively straightforward process, but the complexity can increase based on:
The installation method you have used. How old your SonarQube version is. If you're upgrading to a major version. If possible, you should test out the upgrade in a test environment before updating your production instance. Your test environment should mimic your production environment as closely as possible.
You can read the official upgrade documentation for more information.
TOC
Upgrade Path
The table below contains the complete upgrade path. When upgrading, you need to upgrade the Operator and SonarQube instance versions in sequence.
| No | Alauda Build of SonarQube Operator Version |
|---|---|
| 1 | 2025.1.z |
In the version numbers above, the .z indicates the latest available patch version for that minor release.
When performing an upgrade, you should always use the most recent patch version to ensure you benefit from the latest security updates and bug fixes.
The latest patch versions for each release can be found in the Release Notes.
If your SonarQube version is lower than 2025.1.0, please refer to the SonarQube Data Migration to complete the upgrade.
Upgrade Steps
To safely upgrade your SonarQube version to a new version, please note the following:
- Before upgrading the SonarQube instance, please complete the data backup of the instance.
- Upgrading SonarQube takes some time, depending on the SonarQube data size and the version gap between the current version and target version (number of upgrades)
- The instance will be unavailable during the upgrade process.
When upgrading, you need to upgrade the version and instance version in sequence according to the upgrade path. Upgrading the Operator will not automatically upgrade the instance version, and the upgraded Operator will not manage old SonarQube instances, so you need to manually trigger the instance upgrade in time.
Upgrading Instances
Upgrading Instances via UI
Go to the Administrator -> Marketplace -> Operator Hub page, switch to the target cluster and enter the Alauda Build of SonarQube Operator details page, click on the instance name you want to upgrade to enter the instance details page, and click the upgrade button on the instance details page.
Upgrading Instances via YAML
Go to the Administrator -> Clusters -> Resources page, switch to the target cluster and search for the sonarqube resource type, edit the instance resource you want to upgrade, modify the spec.version field to the desired instance version, and save it.