安装 SonarQube后sonarqube-sonarqube无法启动的问题解决

发布时间 2023-09-27 16:23:02作者: 大师兄啊哈

1. 前言

我的环境:k8s集群(version 1.23.6),安装了Kubesphere(version v3.4)作为可视化界面,最近想要推动团队走CICD,于是在Kubesphere中启用了devops组件,参考:https://kubesphere.io/zh/docs/v3.4/pluggable-components/devops/ 。

组件安装完成后,需要将Sonarqube集成到流水线中,于是又安装了Sonarqube,参考:https://kubesphere.io/zh/docs/v3.4/devops-user-guide/how-to-integrate/sonarqube/ 。

按照步骤走完之后,不出意外的话意外又发生了,有两个工作负载没起来,分别是:

  • sonarqube-sonarqube
  • sonarqube-postgresql

通过查看Kubesphere观察,发现sonarqube-sonarqube一直在重启,于是我把存活探针与就绪探针暂时都去掉了。最后在日志发现报错如:

2020.11.27 09:55:47 INFO  web[][o.sonar.db.Database] Create JDBC data source for jdbc:postgresql://sonarqube-postgresql:5432/sonarDB
2020.11.27 09:55:47 ERROR web[][o.s.s.p.PlatformImpl] Web server startup failed
java.lang.IllegalStateException: Fail to connect to database

可以定位到时Postgresql有问题导致的,于是查看Postgresql服务的日志,发现:

Kubesphere sonarqube postgresql DETAIL:  Role "sonarUser" does not exist

如果分析sonarqube-sonarqube和sonarqube-postgresql这两个工作负载配置文件可以发现,这个用户是sonarqube-postgresql在启动的时候创建的用户名,sonarqube-sonarqube也使用这个用户名去连接sonarqube-postgresql,密码存放在保密字典sonarqube-postgresql中。

通过上面的现象,可以分析出根本原因是sonarqube-postgresql在启动的时候根本没有创建sonarUser这个用户(可以通过sonarqube-postgresql的终端去验证)。

但是为什么sonarqube-postgresql没有成功创建出这个用户呢?

2. 原因分析

首先我把sonarqube-postgresql的两个探针都去掉了,重启,还是报同样的错误。

然后我把env中的POSTGRES_USER,POSTGRES_PASSWORD,POSTGRES_DB这三个值都改成新的值,重启,进入终端,发现还是无法创建用户。

这就很难办,最后通过查询,获得一个关键的信息(参考[1]):

Warning: the Docker specific variables will only have an effect if you start the container with a data directory that is empty; any pre-existing database will be left untouched on container startup.

也就是说,之前第一次启动的时候,sonarqube-postgresql还没有初始化完,就给就绪探针给干掉了,导致只做了部分初始化而没有创建用户,重启的时候由于绑定的pv已经存在数据库了,于是又无法创建用户,整个过程如下:

3. 解决

要解决上面创建用户失败的问题,首先需要延长探针的时间或者直接把探针先去掉,等创建完用户之后,再重新加进去,同时需要先删除已有的数据库,也就是说pv也要删除,要删除pv,必须先删除绑定的pvc,要删除pvc也要先删除绑定的pod,由于stateful的重启策略无法设定为Never,因此无法通过停止pod来删除pvc。套娃套到这里,就只能先保存sonarqube-postgresql的配置(如Postgresql.yaml),然后把这个statefulset先删除了,然后删除pvc和pv。

具体删除通过Kubesphere进行删除即可。

然后删除Postgresql.yaml中的两个探针,重新创建statefulset,可以看到初始化过程还是很久的,在我的机器上差不多用了6分钟,日志如下:

 postgresql 06:38:52.24 
 postgresql 06:38:52.24 Welcome to the Bitnami postgresql container
 postgresql 06:38:52.25 Subscribe to project updates by watching https://github.com/bitnami/bitnami-docker-postgresql
 postgresql 06:38:52.25 Submit issues and feature requests at https://github.com/bitnami/bitnami-docker-postgresql/issues
 postgresql 06:38:52.25 Send us your feedback at containers@bitnami.com
 postgresql 06:38:52.25 
 postgresql 06:38:52.26 INFO  ==> ** Starting PostgreSQL setup **
 postgresql 06:38:52.34 INFO  ==> Validating settings in POSTGRESQL_* env vars..
 postgresql 06:38:52.35 INFO  ==> Loading custom pre-init scripts...
 postgresql 06:38:52.36 INFO  ==> Initializing PostgreSQL database...
 postgresql 06:38:52.50 INFO  ==> postgresql.conf file not detected. Generating it...
 postgresql 06:38:52.51 INFO  ==> pg_hba.conf file not detected. Generating it...
 postgresql 06:38:52.51 INFO  ==> Generating local authentication configuration
 postgresql 06:43:21.36 INFO  ==> Starting PostgreSQL in background...
 postgresql 06:44:38.05 INFO  ==> Creating user sonarUser
 postgresql 06:44:38.14 INFO  ==> Grating access to "sonarUser" to the database "sonarDB"
 postgresql 06:44:38.23 INFO  ==> Configuring replication parameters
 postgresql 06:44:38.28 INFO  ==> Configuring fsync
 postgresql 06:44:38.41 INFO  ==> Loading custom scripts...
 postgresql 06:44:38.42 INFO  ==> Enabling remote connections
 postgresql 06:44:38.44 INFO  ==> Stopping PostgreSQL...
 postgresql 06:44:41.46 INFO  ==> ** PostgreSQL setup finished! **
 postgresql 06:44:41.54 INFO  ==> ** Starting PostgreSQL **

回到sonarqube-sonarqube服务,发现已经可以连接上了,并开始了初始化进程,观察日志:

 2023.09.27 07:16:21 INFO  web[][o.sonar.db.Database] Create JDBC data source for jdbc:postgresql://sonarqube-postgresql:5432/sonarDB
 2023.09.27 07:16:21 INFO  web[][o.s.s.p.ServerFileSystemImpl] SonarQube home: /opt/sonarqube
 2023.09.27 07:16:21 INFO  web[][o.s.s.u.SystemPasscodeImpl] System authentication by passcode is disabled
 2023.09.27 07:16:21 WARN  web[][o.s.s.p.DatabaseServerCompatibility] The database must be manually upgraded. Please backup the database and browse /setup. For more information: https://docs.sonarqube.org/latest/setup/upgrading
 2023.09.27 07:16:21 WARN  app[][startup] ################################################################################
 2023.09.27 07:16:21 WARN  app[][startup] The database must be manually upgraded. Please backup the database and browse /setup. For more information: https://docs.sonarqube.org/latest/setup/upgrading
 2023.09.27 07:16:21 WARN  app[][startup] ################################################################################

连是连上了,但是要升级数据库,开源组件就是让人心累……

4. 参考

[1] SonarQube Community Edition on k8s Role “sonarUser” does not exist