Sonar升级遇到的那些事儿

时间:2023-12-10 18:52:38
目录
背景
如何升级
如何回滚
问题解决
参考

背景

目前我们用SonarQube版本是4.0,这次准备升级到最新版本5.1, 以便支持以后的JavaScript的项目。

如何升级

我们可以直接跨越版本升级,而不需要逐个版本去升级。

1. 升级之前需要备份一下数据库, 我的是mysql, 用mysqldump这个命令即可。

mysqldump -u Username -p DBScheme > Snoar_backup.sql

2. 停掉SonarQube server

bin/<SYSTEM>/sonar stop

到安装目录bin下面执行stop 命令, 我的是进入/sonar/sonarqube-4.0/bin/linux-x86-64目录下 运行./sonar.sh stop

或者直接执行/sonar/sonarqube-4.0/bin/linux-x86-64/sonar.sh stop

3. 下载最新的SonarQube包并且解压unzip到某一个新目录下, 下载地址:http://www.sonarqube.org/downloads/

4. 参考旧SonarQube的配置更新如下两个配置文件

/sonar/sonarqube-4.0/conf/sonar.properties
/sonar/sonarqube-4.0/conf/wrapper.conf

注意:不要拿旧文件直接覆盖这两个文件。(来自官网)

5. 拷贝下面目录里的插件到新的SonarQube相应目录下

/sonar/sonarqube-4.0/extensions/plugins

注意:关于插件的兼容性问题,请参考Compatibility Matrix

有些插件会导致你无法启动新的SonarQube server, 比如我遇到的sonar-jacoco-plugin, Deprecated since Java Plugin version 2.4 embedding directly the support of JaCoCo.

java plugin 2.4 之后集成了JaCoCo

6. 如果用的定制化的JDBC Driver, 同样要拷贝到新SonarQube相应目录下

/sonar/sonarqube-4.0/extensions/jdbc-driver

7. 启动新SonarQube的server

/sonar/sonarqube-5.1/bin/linux-x86-64/sonar.sh start

8. 登陆Web端 http://localhost:9000/setup 配置,然后就可以进入新版本SonarQube了http://localhost:9000

如何回滚

如果发现更新失败或者有问题,按如下方式回滚

1. 回滚数据库

mysql -hHost -uUsername -pPassword sonar < /home/wadexu/Snoar_backup.sql

2. 确保旧的SonarQube配置文件指向这个数据库

3. 启动旧的SonarQube server

/sonar/sonarqube-4.0/bin/linux-x86-64/sonar.sh start

问题解决

1. 插件问题,能更新的都下载最新的放到此目录下

/sonar/sonarqube-5.1/extensions/plugins

我的插件列表如下

-rwxr-xr-x 1 root root 2634077 May 22 02:43 sonar-java-plugin-3.3.jar
-rwxr-xr-x 1 root root 1349308 May 22 02:43 sonar-javascript-plugin-2.5.jar

新的Java plugin 取代了以前这些插件

 sonar-checkstyle-plugin.jar
sonar-findbugs-plugin.jar
sonar-pmd-plugin.jar

2. 升级之后登陆http://localhost:9000 会自动跳转到http://localhost:9000/maintenance 并提示Sonar is under maintenance. Please check back later.

--需要手动登陆http://localhost:9000/setup 做一些设置

3. 老的项目运行新SoanrQube之后,不显示单元测试结果,覆盖率之类的了。

原因是新的java plugin集成了JaCoCo, 但是需要做一些配置才可以生效。

我的是Maven项目, 配置pom.xml如下

    <dependency>
<groupId>org.codehaus.sonar-plugins.java</groupId>
<artifactId>sonar-jacoco-listeners</artifactId>
<version>1.2</version>
<scope>test</scope>
</dependency>
    <build>
<finalName>test</finalName>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>2.4.2</version>
<configuration>
<skipTests>false</skipTests>
<properties>
<property>
<name>listener</name>
<value>org.sonar.java.jacoco.JUnitListener</value>
</property>
</properties>
</configuration>
</plugin>
</plugins>
</build>

运行

mvn clean org.jacoco:jacoco-maven-plugin:prepare-agent install sonar:sonar -Dsonar.jdbc.url=jdbc:mysql://10.46.10.20:3306/sonar -Dsonar.jdbc.username=sonar -Dsonar.jdbc.password=sonar -Dsonar.host.url=http://10.46.10.20:9000

SonarQube结果:

Sonar升级遇到的那些事儿

4. 插件安装,只需要把下载的jar 放到/sonarqube-5.1/extensions/plugins 目录下,重启SonarQube server即可。

5. 由于我安装了JavaScript plugin, 对于Web项目,默认quailty 都会扫所有的.java, .js代码

如果想要排除webapp下的代码,设置如下Settings->General Setting->Exclusions->Files, Source File Exclusions=src/main/webapp/**

可以针对某个项目设置 也可以Global设置

6. Code Coverage 也可以排除,一种方式在Sonar里设置Settings->General Setting->Exclusions->Code Coverage

例如Coverage Exclusions = com/demo/test/entity/*.java

另一种方式是在Maven项目里配置pom.xml文件,如下

 <properties>
<java-version>1.7</java-version>
<org.springframework-version>4.1.5.RELEASE</org.springframework-version>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<sonar.exclusions>
com/demo/test/constant/*,com/demo/test/entity/*
</sonar.exclusions>
</properties>

7. 如果你想Sonar集成JavaScript写的项目,可以用这个插件grunt-sonar-runner

module.exports = function (grunt) {

  // configuration
grunt.initConfig({ sonarRunner: {
analysis: {
options: {
debug: true,
separator: '\n',
sonar: {
host: {
url: 'http://10.46.10.101:9000'
},
jdbc: {
url: 'jdbc:mysql://10.46.10.101:3306/sonar',
username: 'sonar',
password: 'sonar'
}, projectKey: 'sonar:grunt-sonar-runner:0.1.0',
projectName: 'Grunt Sonar Runner',
projectVersion: '0.10',
sources: ['app'].join(','),
language: 'js',
sourceEncoding: 'UTF-8'
}
}
}
} }); // plugins
grunt.loadNpmTasks('grunt-sonar-runner'); // tasks
grunt.registerTask('coverage', ['sonarRunner:analysis']);
};

参考

SonarQube官方升级站点: http://docs.sonarqube.org/display/SONAR/Upgrading

SonarQube Release 5.1 Upgrade Notes: http://docs.sonarqube.org/display/SONAR/Release+5.1+Upgrade+Notes