升级 SonarQube
升级 SonarQube 是一个相对简单的过程，但复杂度可能会因以下因素而增加：
- 您使用的安装方式。
- 您的 SonarQube 版本有多旧。
- 是否升级到主版本。
如果可能，您应先在测试环境中进行升级测试，然后再更新生产实例。您的测试环境应尽可能模拟生产环境。
您可以阅读官方升级文档了解更多信息。
目录
升级路径
下表包含完整的升级路径。升级时，您需要按顺序升级 Operator 和 SonarQube 实例版本。
| 序号 | Alauda Build of SonarQube Operator 版本 |
|---|---|
| 1 | 2025.1.z |
INFO
上述版本号中的 .z 表示该次要版本的最新补丁版本。
执行升级时，您应始终使用最新的补丁版本，以确保获得最新的安全更新和错误修复。
每个版本的最新补丁版本可在Release Notes中找到。
WARNING
如果您的 SonarQube 版本低于 2025.1.0，请参考SonarQube 数据迁移完成升级。
升级步骤
WARNING
为了安全地将 SonarQube 版本升级到新版本，请注意以下事项：
- 在升级 SonarQube 实例之前，请完成实例的数据备份。
- 升级 SonarQube 需要一定时间，具体取决于 SonarQube 数据大小以及当前版本与目标版本之间的版本差距（升级次数）。
- 升级过程中实例将不可用。
升级时，您需要根据升级路径按顺序升级 版本和实例版本。升级 Operator 不会自动升级实例版本，且升级后的 Operator 不会管理旧的 SonarQube 实例，因此您需要及时手动触发实例升级。
升级实例
通过 UI 升级实例
进入 Administrator -> Marketplace -> Operator Hub 页面，切换到目标集群，进入 Alauda Build of SonarQube Operator 详情页，点击要升级的实例名称进入实例详情页，点击实例详情页上的升级按钮。
通过 YAML 升级实例
进入 Administrator -> Clusters -> Resources 页面，切换到目标集群，搜索 sonarqube 资源类型，编辑要升级的实例资源，修改 spec.version 字段为目标实例版本，保存即可。