升级 SonarQube 工具

平台版本升级后，若提示有新的工具链版本，您可根据实际情况升级工具。

提示：

• 平台版本升级后，若有新版本则需要根据业务场景手动升级。

升级至9.9.5

提示：

• 当 SonarQube 中存量数据较多时，该步骤可能会消耗较长时间，由于升级过程中涉及到数据库版本升级和 Sonarqube 自身数据版本的升级，因此当数据量较大，例如达到 10GB 以上时，总的升级时间将可能达到 2-3 小时。

操作步骤

1. 在左侧导航栏中，单击 工具链管理 > 实例管理。

2. 若实例名称右侧显示 ，单击 实例名称。

3. 单击 操作 > 升级。

   升级过程中，单击 图标实时查看实例更新状态。

升级至9.9.5.1

提示：

• 该版本及后续的版本中将不再支持内置的单点数据库，因此升级至该版本前需要提前准备好一个外部 postgresql（支持版本为postgresql 11 至 15 ），确保该 postgresql 中有一个空数据库以及足够的存储空间。在触发升级后，原数据库中的数据将自动迁移到用户提供的新数据库中。

• 升级过程中或升级完成后，查看实例组件列表，可查看到一个后缀名为sonarqube-pre-migration的 Job，点击查看其日志，即可查看数据迁移过程中的步骤与报错日志（出现任意报错时，该 Job 将主动退出并显著告知失败，如果Job成功，则意味着迁移顺利完成，不会有报错日志）。

• 由于涉及到数据迁移，对于一个 10GB 以上的数据库，该步骤通常需要消耗 20 分钟以上的时间

• 该版本只能由 9.9.5 升级而来，其他版本需要先升级至 9.9.5，再执行本小节的内容升级到 9.9.5.1

操作步骤

1. 提前准备好一个版本介于 11.x 和 15.x 之间的 Postgresql 数据库，可访问平台的数据服务 (Data Service) > ** Postgresql** 进行创建。 创建postgresql实例

2. 在左侧导航栏中，单击 工具链管理 > 实例管理。

3. 若实例名称右侧显示 ，单击 实例名称。

4. 单击 操作 > 升级。

5. 升级至该版本需要填写数据库保密字典，若暂无保密字典，则点击创建，然后在弹出的页面中填写保密字典表单，类型选择 Opaque ，并在配置项中新增和填写如下字段：

   字段	描述
   host	数据库的连接地址
   port	数据库的连接端口
   username	数据库账户用户名
   password	数据库账户密码
   database	数据库库名，对应数据库应当存在且为空
   sslmode	连接数据库是否开启 SSL ？填写enable开启或disable禁用，默认为开启

   数据服务中创建的 Postgresql 实例默认开启了 SSL 连接，如果使用数据服务的 Postgresql 实例，请将 sslmode 设置为 enable ，其他情况下，请根据服务端的配置确认服务端是否支持 SSL 连接。

   填写并提交完成 Secret 创建后，回到 SonarQube 升级页面使用该 Secret 继续升级。

   升级过程中，单击 图标实时查看实例升级状态。当出现如下报错信息时，意味着您的**数据库 Secret 存在问题。

   报错信息	描述
   required postgres database name, got empty dbname from provided secret	没有填写 database 名字，需要用户指定一个已存在的空 database
   Connection refused. Check your host and port in the given secret	创建连接失败，检查地址和端口是否错误
   Authentication failed. Check your username and password in the given secret	服务端拒绝连接，检查用户名或密码是否错误
   SSL is not enabled on the server, please change ‘sslmode’ to ‘disable’ in secret if this server is the right one to connect	服务端不支持SSL连接，请将sslmode设置为disable
   server ask for a ssl connection, please change ‘sslmode’ to ’enable’ in secret if this server is the right one to connect	服务端强制要求SSL连接，请将sslmode设置为enable
   get secret “ns/secret” failed, please check if exist	获取 secret 失败，检查 secret 是否创建成功

   请根据报错信息检查并更正对应 secret 内的信息。更正完成后，组件将在 1 分钟内重新检查该 secret 内的信息，如果正确无误，将继续完成安装。

   等待部署状态为 已部署 后，单击工具访问地址，若能成功登录工具，说明操作成功。