通过SonarQube Helm Chart部署时JDBC配置未生效问题排查

环境信息 #

• SonarQube版本：10.4.1社区版
• 扫描器：sonar-scanner-msbuild-4.7.1.2311-net46\SonarScanner.MSBuild.exe
• 插件：无
• 部署方式：通过Helm部署至AWS EKS，使用AWS RDS上的外部PostgreSQL数据库

执行的Helm命令 #

$ helm upgrade --debug --install sonarqube --namespace sandbox --create-namespace -f values.yaml sonarqube/sonarqube

values.yaml配置内容 #

image:
  tag: 10.4.1-{{ .Values.edition }}

persistence:
  enabled: true
  storageClass: "gp2"
  accessMode: ReadWriteOnce
  size: 30Gi
  uid: 1000
  guid: 0
  volumes:
    - name: data
      # emptyDir: {}
    - name: extensions
      # emptyDir: {}
    - name: logs
      # emptyDir: {}
  mounts:
    - name: data
      mountPath: /opt/sonarqube/data-2
    - name: extensions
      mountPath: /opt/sonarqube/extensions-2
    - name: logs
      mountPath: /opt/sonarqube/logs-2

jdbcOverwrite:
  enabled: true
  jdbcUrl: 'jdbc:postgresql://<my_DB_endpoint>.us-east-1.rds.amazonaws.com/sonar_sandbox?socketTimeout=1500'
  jdbcUsername: "postgres"
  jdbcPassword: <my_DB_password>

postgresql:
  enabled: false

问题现象 #

执行Helm命令后生成的ConfigMap不正确，Pod日志显示SonarQube仍使用默认的数据库URL、用户名和密码：

2024.05.19 18:49:31 INFO web[][o.s.d.DefaultDatabase] Create JDBC data source for jdbc:postgresql://%!s(<nil>):5432/sonarDB

Pod虽能运行，但SonarQube初始化失败。已确认可通过values.yaml中的凭证手动连接PostgreSQL数据库，且卸载重装Helm Chart后问题依旧。

可能的原因分析 #

1. Helm模板变量解析失败：image.tag中的{{ .Values.edition }}变量未被正确赋值，社区版应明确指定image.tag: 10.4.1-community，避免变量解析异常导致后续配置被忽略。
2. ConfigMap未注入自定义配置：执行kubectl get configmap sonarqube-sonarqube -n sandbox -o yaml检查生成的ConfigMap，确认jdbcUrl、jdbcUsername、jdbcPassword是否已写入SonarQube配置项。若未出现，说明jdbcOverwrite配置未被Chart模板正确处理。
3. 自定义存储挂载路径冲突：修改后的mounts路径（如/opt/sonarqube/data-2）可能干扰了SonarQube默认配置文件的加载流程，导致外部数据库配置未生效。建议暂时恢复默认挂载路径验证。
4. Helm Chart版本不兼容：使用的SonarQube Helm Chart版本可能与10.4.1版本的SonarQube不匹配，导致jdbcOverwrite参数无法被识别。需确认Chart版本与SonarQube版本的兼容性，换用对应版本的Chart重新部署。
5. 占位符未替换或格式错误：检查<my_DB_endpoint>和<my_DB_password>是否已替换为实际值；若密码包含特殊字符，需用引号正确包裹或转义，否则会导致配置解析失败，触发默认数据库设置。

内容的提问来源于stack exchange，提问作者hyperwiser