简介
SonarQube(原名Sonar)是一个开源的代码质量管理系统,可以扫描项目中重复代码、编码标准、单元测试、代码覆盖率、代码复杂度、潜在Bug、注释等.
支持Java、C/C++、C#、PHP、Flex、Groovy、JavaScript、Python等多种语言.
代码扫码的好处在于通过配置规则扫描代码设计缺陷和代码优化从而提高代码的质量.
本文介绍使用docker技术搭建SonarQube环境并扫描代码.
环境搭建快速启动
这种方式启动sonarqube是没有数据存储的,docker重新加载后数据不会reload数据.
docker run
-
d
--
name sonarqube
-
p
9000
:
9000
-
p
9092
:
9092
sonarqube:
lts
浏览器打开
:
0.0
.
0.0
:
9000
帐号密码
:
admin、admin
全配置启动docker启动mysql
docker run
--
name mysql
-
5.6
-
v
/
Users
/
xinxi
/
mysql:
/
var
/
lib
/
mysql
-
e MYSQL_ROOT_PASSWORD
=
123321
-
p
8888
:
3306
-
d
mysql:
5.6
sonarqube不支持mysql5.5版本,最低支持5.6版本
[color=rgb(0, 105, 214) !important]
docker启动sonarqube
- db_sonar数据库需要手动先创建,否则会报找不到
- 本地搭建ip地址不能写localhost,需要写内网ip
docker run
-
d
--
name Sonarqube
-
p
8185
:
9000
-
p
8186
:
9092
-
e
"SONARQUBE_JDBC_USERNAME=root"
-
e
"SONARQUBE_JDBC_PASSWORD=123321"
-
e
"SONARQUBE_JDBC_URL=jdbc:mysql://192.168.129.25:8888/
db_sonar?useUnicode=true&characterEncoding=utf8"
-
d
sonarqube:
lts
效果
启动成功以后,第一次页登录成功后会设置token,这个token是以后被扫描代码工程中需要配置的,用于通过token的方式连接Sonarqube平台传数据结果
[color=rgb(0, 105, 214) !important]
Android项目配置
[color=rgb(0, 105, 214) !important]
Android项目是使用gradle管理插件,所以需要配置gradle文件.
在项目根目录的gradle配置如下:
buildscript
{
repositories
{
maven
{
url
"https://plugins.gradle.org/m2/"
}
}
dependencies
{
classpath
"org.sonarsource.scanner.gradle:sonarqube-gradle-plugin:2.5"
}
}
plugins
{
# 添加插件信息
id
"org.sonarqube"
version
"2.6-rc1"
}
apply
plugin:
"org.sonarqube"
gradle sonarqube \
-
Dsonar
.
host
.
url
=
http:
//localhost:8186 \
-
Dsonar
.
login
=
a1cf2c8dbdc187441c3f908b79b562404b9a4f6b
另外配置方式是在gradle.properties配置文件
[color=rgb(0, 105, 214) !important]
[color=rgb(0, 105, 214) !important]
扫描结果
[color=rgb(0, 105, 214) !important]
[color=rgb(0, 105, 214) !important]
mvn项目配置运行命令mvn
sonar:
sonar
-
Dsonar
.
host
.
url
=
http:
//localhost:9000 -Dsonar.login=c8ce928f1497f1fa5591cdcf5357aa4e44920796
扫描结果
[color=rgb(0, 105, 214) !important]
iOS项目配置安装先需要安装如下工具
brew tap oclint
/
formulae
brew install oclint
brew install sonar
-
scanner
brew install gcovr
项目配置
需要在项目根目录增加run-sonar.sh和sonar-project.properties两个文件
具体配置请参考[color=rgb(0, 105, 214) !important]
[color=rgb(0, 105, 214) !important]
运行命令在项目根目录下
,
sh run
-
sonar
.
sh
踩坑
[color=rgb(0, 105, 214) !important]
通过sonarqube安装的oc插件是收费的,下载免费的oc插件.
[color=rgb(0, 105, 214) !important]
然后把backelite-sonar-objective-c-plugin-0.6.3.jar放到sonarqube的extensions/plugins中,然后重启镜像.
效果展示
[color=rgb(0, 105, 214) !important]
[color=rgb(0, 105, 214) !important]
制作镜像
sonarqube原生不支持中文、并且没有oc插件.可以把汉化中文包和oc插件打包成新的docker镜像
把sonar-l10n-zh-plugin-1.16.jar、backelite-sonar-objective-c-plugin-0.6.3.jar和dockerfile放到一个目录下
dockfile:
FROM sonarqube
ADD sonar
-
l10n
-
zh
-
plugin
-
1.16
.
jar
/
opt
/
sonarqube
/
extensions
/
plugins
/
ADD backelite
-
sonar
-
objective
-
c
-
plugin
-
0.6
.
3
.
jar
/
opt
/
sonarqube
/
extensions
/
plugins
/
执行:docker build -t sonarqube:zh .
jenkins持续集成
使用Android项目为例,首先需要在Jenkins中安装sonarqube插件,然后在系统设置中配置SonarQube的servers地址
[color=rgb(0, 105, 214) !important]
[color=rgb(0, 105, 214) !important]
在构建处选择Execute SonarQube Scanner中配置如下
[color=rgb(0, 105, 214) !important]
[color=rgb(0, 105, 214) !important]
[color=rgb(0, 105, 214) !important]
[color=rgb(0, 105, 214) !important]
[color=rgb(0, 105, 214) !important]
结语
SonarQube是一款优秀代码扫描工具,可以通过静态扫码代码的方式发现编码问题,代码扫描是一种低成本高收益的方式,在持续集成中是必不可少的环节.
更多python学习资料可关注：gzitcast
