SonarQube 用于部署 Web 服务器,作为 SonarQube Server 使用,用于 Sonar 的配置管理、分析结果汇总展示;
SonarQube 主要分为四大版本,我们使用的社区版,截止发文时间,已经更新到 8.4 版本,此次以社区版的 7.8 版本作为示例;
环境要求:jdk1.8 以上;
如果下载最新版本 直接点击下图中 Download Community Edition
如果下载历史版本,点击最下方的 show all versions
点击后,下载到本地一个相应版本的 zip 文件;
解压缩后,进入 sonarqube-7.8 目录下,查看 bin 目录下,包含有 Linux、Mac、Windows 版本的文件夹
进入对应本机系统的文件夹,以 linux 为例,我们可以看到 sonar.sh 文件,执行./sonar.sh,我们可以看到./sonar.sh 可执行的命令;
console:启动 sonarqube,并打印启动日志,Ctrl+C,终止打印,同时 sonarqube 关闭;
start:启动 sonarqube,但不打印日志;
status:查询 sonarqube 运行状态
soanr 默认端口为 9000,浏览器录入 localhost:9000,访问 sonarqube;
sonar 初始用户为 admin,密码同样为 admin,点击登录,即可进入 sonarqube 页面;
sonar 启动后是一个英文版的页面,不符合我们的语言习惯,安装汉化插件可以对系统进行汉化处理;
如果是安装的最新版本的 soanrqube,安装汉化包,直接在 Administration>Marketplace 中搜索 “ch”,安装 Chinese Pack 插件,而后重启 sonarqube 即可;
但是对于 7.8 版本,因为是历史版本,最新的汉化插件并不适合,通过下表,我们可知,sonarqube7.8 版本对应的汉化包为 1.28 版本;
在此链接https://github.com/SonarQubeCommunity/sonar-l10n-zh1.28 版本的 jar 包;,下载
将下载好的 jar 包放在本地 sonarqube 插件目录 sonarqube-7.8/extensions/plugins 下,重启 sonarqube。
sonarqube 自带 H2 数据库,方便用户学习使用,但是使用 sonarqube 作为服务器使用,需要配置单独的数据库使用;
sonarqube7.8 版本支持 MS SQLserver、Oracle、Postgresql、MySQL 四种数据库,但是从 7.8 版本之后,sonarqube 不再支持 MySQL 数据库,
1,首先在数据库中建立 sonar 数据库
在 sonarqube 目录的 conf 下,sonar.properties 文件为 soanrqube 的配置文件,配置相应的数据库信息;
sonar.jdbc.url=jdbc:mysql://ip:port/sonar?useUnicode=true&characterEncoding=utf8&rewriteBatchedStatements=true&useConfigs=maxPerformance&useSSL=false
重启 sonarqube,启动成功后,我们查看数据库,可以看到在数据库中会生成的相关的表,如此 sonar 的数据库配置就完成了。
此外,我们可以自定义 sonarqube 的端口,在 sonar.properties 文件中配置 sonar.web.port,重启 sonarqube 即可。