Mac环境下SonarQube的安装与使用

  1. 云栖社区>
  2. 博客>
  3. 正文

Mac环境下SonarQube的安装与使用

小鲜女他爸 2018-09-02 21:50:00 浏览952
展开阅读全文

SonarQube是一个用于代码质量管理的开源平台,可以快速的定位代码中潜在的或者明显的错误,支持包括java,C#,C/C++,PL/SQL,Cobol,JavaScrip,Groovy等等二十几种编程语言.

准备工作

1.SonarQube
2.Sonar-Scanner
3.mysql数据库(忽略安装过程)


安装

1.下载SonarQube之后,打开bin目录下的对应OS文件夹,如:

     cd /Users/cw/Downloads/sonarqube-7.3/bin/macosx-universal-64
     sonar.sh start
img_f618ddfdc6c035d96ac4a364e7b7f6c3.png
image.png

2.打开浏览器,访问SonarQube:http://localhost:9000,如出现下图则代表SonarQube启动成功

img_98a2fe5ea3a514a544fa5be571396238.png
image.png


配置

  1. 打开mysql并新建一个数据库,数据库名称可任意指定。
  2. 打开SonarQube安装目录下的sonar.properties文件,目录为:

    /path to your SoaneQube location directory/conf/sonar.properties
  1. 在sonar.properties文件中mysql下oracle前添加如下信息

    sonar.jdbc.url=jdbc:mysql:/localhost:3306/sonar?useUnicode=true&characterEncoding=utf8&rewriteBatchedStatements=true&useConfigs=maxPerformance
    sonar.jdbc.username=root
    sonar.jdbc.password=password
    sonar.sorceEncoding=UTF-8
    sonar.login=admin
    sonar.password=admin

sonar.jdbc.url是你的mysql数据库连接url,sonar.jdbc.username是mysql数据库用户名,sonar.jdbc.password是数据库用户密码,sonar.login是SonarQube的登录用户名,sonar.password是SonarQube的登录密码。
4.重启SonarQube服务

    sonar.sh restart

img_b82353a0176935e08f626f677aec30ca.png
image.png

5.打开浏览器,再次访问SonarQube:http://localhost:9000,会稍微有点慢,因为需要初始化SonarQube数据库
6.初始化成功后登录
img_2b7d99580ae6c67ecc483cd5e4e5b584.png
image.png

点击位置Log in进入登录页
img_5792ca3570794297122ef422f8b19332.png
image.png

输入admin/admin登录
7.安装中文语言包:
img_1f5d2a5c2ed72220dc595f2b2b2cbf9c.png
image.png

如图,先点击位置1,再点击位置2,在位置3中输入chinese,即可看见Chinese Pack,最后点击位置4以安装中文语言包。等待安装完成。出现如下图界面即安装完成:
img_0e3c9c1ab9c69ea803877e89d11385f2.png
image.png

点击restart重启SonarQube服务器。
img_879028c17581bd70f279258fec1499af.png
image.png

重启完成后即可看见中文界面。

使用

  1. 下载Sonar-Scanner
    2.下载完成后打开Sonar-Scanner目录下sonar-runner.properties文件,目录如:

    /Users/cw/Documents/devtools/sonar/sonar-scanner-2.8/conf/sonar-scanner.properties 

3.在mysql节点下添加如下信息

    sonar.jdbc.url=jdbc:mysql:/localhost:3306/sonar?useUnicode=true&characterEncoding=utf8&rewriteBatchedStatements=true&useConfigs=maxPerformance
    sonar.jdbc.username=root
    sonar.jdbc.password=password
注意:如果待测试项目与SonarQube服务不在同一台机器,则需要添加SonarQube服务的IP:
    #----- Default SonarQube server
    sonar.host.url=http://XXX.XXX.XXX.XXX:9000
  1. 配置环境变量
    打开终端进行如下操作:

    vim ~/.bash_profile
    在文件末尾添加如下字段:
    export SONAR_RUNNER_HOME=path to your Sonar-Scanner directory
    export PATH=$PATH:$SONAR_RUNNER_HOME/bin
    保存修改
    使配置立即生效:source ~/.bash_profile
  1. 测试Sonar-Scanner
    打开终端输入如下命令

   sonar-runner -version

出现如下图则代表配置成功


img_8b1cbb02cc3939c760383becd8184332.png
image.png

6.打开待测试的项目根目录,新建sonar-project.properties文件并输入如下信息
1). SonarQube版本7以下:

    # must be unique in a given SonarQube instance
    sonar.projectKey=my:project
    # this is the name displayed in the SonarQube UI
    sonar.projectName=i2work-operation
    sonar.projectVersion=1.0
     # Path is relative to the sonar-project.properties file. Replace "\" by "/" on Windows.
    # Since SonarQube 4.2, this property is optional if sonar.modules is set. 
    # If not set, SonarQube starts looking for source code from the directory containing 
    # the sonar-project.properties file.
    sonar.sources=src
    # Encoding of the source code. Default is default system encoding
    #sonar.sourceEncoding=UTF-8

2). SonarQube版本7以上:

    # must be unique in a given SonarQube instance
    sonar.projectKey=my:project
    # this is the name displayed in the SonarQube UI
    sonar.projectName=i2work-operation
    sonar.projectVersion=1.0
    # Path is relative to the sonar-project.properties file. Replace "\" by "/" on Windows.
    # Since SonarQube 4.2, this property is optional if sonar.modules is set. 
    # If not set, SonarQube starts looking for source code from the directory containing 
    # the sonar-project.properties file.
    sonar.sources=src
    # Encoding of the source code. Default is default system encoding
    #sonar.sourceEncoding=UTF-8
    #path to your project build output path
    sonar.java.binaries=target/classes

其中:sonar.projectName是项目名字,sonar.sources=是源文件所在的目录,SonarQube新版相对于之前的版本新增要求必须指定项目class文件的目录,如果不配置会报错。

  1. 打开终端,进入待测试项目根目录,执行如下命令:

    sonar-runner

执行完成后会出现下图内容


img_2861a020cf4ccd5d20e0caa2827525b3.png
image.png

执行过程中可能会出现如下图所示类型的错误:


img_31fa43b6fbb870943ac464585e3030ca.png
image.png

这是因为SonarScanner在扫描过程中发现了.svn文件,于是启动了自己的SVN插件,去访问SVN,但是又没有对应SVN路径的授权所以就报错。
解决方式:
  1. 打开sonarqube的控制台,使用admin登录后 按下图所示顺序进行操作


    img_b71609f2751f4b9a7722505a80d46ecd.png
    image.png

    在配置->SCM菜单中将Disable the SCM Sensor设置为TRUE,并在下面的SVN配置选项中配置自己的SVN路径及访问账号密码等信息。

  2. 打开SonarQube:http://localhost:9000
    按图示顺序依次点击,即可看见正在分析中的后台任务
    img_2eaca4b35dad2cc710356b861abb566b.png
    image.png

    分析一般会持续10分钟左右,待分析完成后回到SonarQube主页即项目页,即可看见项目的分析结果,如图:
    img_9cdabc296a9bc06168929652c54fafb1.png
    image.png

    点击项目名即可进入查看分析报告的详细信息。

预知更多使用,请登录官网自行学习。

  1. http://www.sonarqube.org/
  2. http://docs.sonarqube.org/display/SONAR/Analyzing+with+SonarQube+Scanner

网友评论

登录后评论
0/500
评论
小鲜女他爸
+ 关注