1、概述
Sonar (SonarQube)是一个开源平台,用于持续检查代码质量,不只是一个质量数据报告工具,更是代码质量管理平台。
支持Java, C#, C/C++, PL/SQL, Cobol, JavaScrip, Groovy 等等二十几种编程语言的代码质量管理与检测。
2、实例组件
SonarQube 实例包含三个组件:
1、SonarQube server运行以下进程:
为 SonarQube 用户界面提供服务的 Web Server。
基于 Elasticsearch 的Search Server。
负责处理代码分析报告并将其保存在 SonarQube 数据库中的compute engine(计算引擎)。
2、存储以下内容的数据库:
代码扫描期间生成的代码质量和安全性指标和问题。
SonarQube 实例配置。
3、在您的构建或持续集成服务器上运行的一个或多个Scanner(扫描器)来分析项目。
3、搭建前准备
服务器要求:由于sonar使用嵌入式elasticsearch,主机要符合es生产模式要求和文件描述符配置。需要以root身份运行一下参数:
sysctl -w vm.max_map_count=262144
sysctl -w fs.file-max=65536
ulimit -n 65536
ulimit -u 4096
sonarqube需要数据库的支持:
微软 SqlServer
Oracle
PostgreSQL
MySQL(sonarqube7.9以上已不再支持mysql数据库)服务版本 sonarqube:8.9.1-community (192.168.1.20) postgresql:latest (192.168.1.20)jenkins+gogs搭建代码自动化运维部署平台
二、Docker搭建PostgreSQL数据库
mkdir -p /server/docker/postgresql/data
docker run --name postgresql -p 5432:5432 \
-e POSTGRES_PASSWORD=123456 \
-e PGDATA=/var/lib/postgresql/data/pgdata \
-v /etc/localtime:/etc/localtime:or \
-v /server/docker/postgresql/data:/var/lib/postgresql/data \
-itd postgres
创建sonar数据库及用户名密码:
登录数据库:psql
psql -d [databasename] #登录其他数据库
创建用户:create user sonar password 'sonar';
参照template0(模板数据库)创建用户数据库:
create database sonar template template0 owner sonar;
将sonar数据库的所有权限都赋予sonar用户:
grant all privileges on database sonar to sonar;
三、Docker搭建SonarQube1、搭建sonarqube
启动测试sonar,并复制文件到宿主机,做目录映射:
docker run -d --name sonar -p 9000:9000 sonarqube:8.9.1-community
mkdir -p /server/docker/sonarqubedocker cp sonar:/opt/sonarqube/conf /server/docker/sonarqubedocker cp sonar:/opt/sonarqube/data /server/docker/sonarqubedocker cp sonar:/opt/sonarqube/logs /server/docker/sonarqubedocker cp sonar:/opt/sonarqube/extensions /server/docker/sonarqubedocker rm -f sonar #删除测试sonarqube
启动正式sonar:
docker run -d --name sonar -p 9000:9000 \
-e SONARQUBE_JDBC_URL=jdbc:postgresql://192.168.1.20:5432/sonar \
-e SONARQUBE_JDBC_USERNAME=sonar \
-e SONARQUBE_JDBC_PASSWORD=sonar \
-v /etc/localtime:/etc/localtime:or \
-v /server/docker/sonarqube/conf:/opt/sonarqube/conf \
-v /server/docker/sonarqube/data:/opt/sonarqube/data \
-v /server/docker/sonarqube/logs:/opt/sonarqube/log \
-v /server/docker/sonarqube/extensions:/opt/sonarqube/extensions \
-itd sonarqube:8.9.1-community
SONARQUBE_JDBC_URL=jdbc:postgresql://192.168.1.20:5432/sonar #postgresql的ip、端口、数据库名
SONARQUBE_JDBC_USERNAME=sonar #postgresql的用户名
SONARQUBE_JDBC_PASSWORD=sonar #postgresql的密码
-v /etc/localtime:/etc/localtime:or #容器跟宿主机时间同步
访问sonar:192.168.1.20:9000默认账户名密码:admin/admin
administrator——marketplace——plugins搜索Chinese——Chinese pack,install——restart server重启
汉化完成:
登录Jenkins管理页面,插件管理——安装插件“sonarqube scanner”
Jenkins系统管理——系统设置——SonarQube servers——add sonarqube
Server authentication token是sonarqube服务的登录凭证,登录到sonarqube页面,创建用户token,然后填到此处即可:
系统管理——全局工具配置——SonarQube Scanner——选择自动安装
进入项目配置中,构建——增加构建步骤——选择“Execute SonarQube Scanner”
然后配置 Execute SonarQube Scanner分析源码:
Analysis properties 填写配置:
sonar.projectKey=
sonar.projectName= #这个可自定义,报告发送到sonarqube后,sonarqube将创建以此命名的projectsonar.projectVersion=1.0 #项目版本号sonar.language=java #表示分析java源代码sonar.java.source=11 #表示jdk版本sonar.java.binaries=gateway-service #jenkins项目中有多个项目名,就写需要构建jar包的那个项目名;只有一个项目就写“.”。sonar.sources=gateway-service/src #表示源代码目录sonar.sourceEncoding=UTF-8sonar.scm.disabled=true
4、查看分析结果
选择分支构建jenkins 项目后,分析结果将发送到sonarqube:
点击SonarQube将进入sonar 分析结果页面:
jenkins+sonar审查源码完成。
五、jenkins+sonarqube搭建过程遇到的报错