当前位置：首页 > server > anz > 详细页面

linux服务器安装SonarQube代码检测工具的详细步骤

时间：2022-07-17来源：www.pcxitongcheng.com作者：电脑系统城

步骤
- 1、安装jdk
- 2、安装配置mysql5.7
- 3、安装SonarQube
- 4、配置数据库和SonarQube
- 5、安装中文语音包

背景

最近公司技术大佬同事告知，sonarlint可以用来检测代码是否有问题，并且能将其集成到Jenkins里面。本着好奇的心思来研究了一下，花了点时间将其在linux服务器上搭建完毕，网上可以查到的文章和教程资料并不少，但是很多写的不是很完美，会很容易踩坑，所以这里把本次成功的步骤记录下，并且把安装前注意的点接下来介绍下。

注意（重点）

这里需要注意，任何一个步骤错，都可能会导致服务起不来：

SonarLint是IDEA的插件，linux服务器上安装的是Sonarqube；
SonarQube安装之前需要事先安装好java环境和mysql，三者有很强的版本对应关系；
SonarQube在我写这篇文章时已经迭代到了8.99版本，但是7.8及以下的版本才支持jdk8，如果是7.9及以后版本的，只支持jdk11。这不算什么问题，即使你的环境是jdk8，你想用7.9以上的SonarQube也是可以的，只需要服务器上装个jdk11，让SonarQube指定jdk11就行了；
SonarQube在7.9版本开始不再支持mysql。我平时用的mysql更多一些，而且我们的环境也正好是jdk8，所以不难看出，我的当下使用的SonarQube版本肯定是要小于等于7.8了。我本次使用的各版本的安装包为：jdk-8u221-linux-x64.tar.gz、mysql-5.7.35-el7-x86_64.tar.gz、sonarqube-7.7.zip，这是百度云网盘下载链接。

链接: https://pan.baidu.com/s/1wpj-Q2ausDDc4XVAKJo9IQ?pwd=yxvt

提取码: yxvt

步骤

1、安装jdk

1
2
3
4
5
6
7
8
9
10
11
12 [root@localhost ~]# cd /usr # 将jdk安装包放到/usr下并安装在此
[root@localhost usr]# tar -xf jdk-8u221-linux-x64.tar.gz
[root@localhost usr]# vim /etc/profile # 输入以下三行环境变量
export JAVA_HOME=/usr/jdk1.8.0_221
export PATH=$JAVA_HOME/bin:$PATH
export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar

[root@localhost usr]# source /etc/profile # 使环境变量配置文件生效
[root@localhost usr]# java -version # 弹出下面的三行内容说明jdk安装成功
java version "1.8.0_221"
Java(TM) SE Runtime Environment (build 1.8.0_221-b11)
Java HotSpot(TM) 64-Bit Server VM (build 25.221-b11, mixed mode)

2、安装配置mysql5.7

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31 [root@localhost ~]# cd /usr/local # 本次将mysql安装包放到了/usr/local下并安装在此
[root@localhost local]# tar -xf mysql-5.7.35-el7-x86_64.tar.gz
[root@localhost local]# mv mysql-5.7.35-el7-x86_64 mysql # 给目录改个简单的名
[root@localhost local]# groupadd mysql # 创建个mysql用户组
[root@localhost local]# useradd -r -g mysql mysql # 创建个mysql组的用户mysql
[root@localhost local]# mkdir -p /data/mysql # 创建个数据库数据目录
[root@localhost local]# chown mysql:mysql -R /data/mysql # 将此数据目录的所属主和所属组分配给mysql

[root@localhost local]# vim /etc/my.cnf # 只保留以下13行内容，注意这里面的键值对要正确，默认跟着我的操作没问题
[mysqld]
bind-address=0.0.0.0
port=3306
user=mysql
basedir=/usr/local/mysql
datadir=/data/mysql
socket=/tmp/mysql.sock
log-error=/data/mysql/mysql.err
pid-file=/data/mysql/mysql.pid
#character config
character_set_server=utf8mb4
symbolic-links=0
explicit_defaults_for_timestamp=true

[root@localhost local]# cd /usr/local/mysql/bin/
[root@localhost bin]# ./mysqld --defaults-file=/etc/my.cnf --basedir=/usr/local/mysql/ --datadir=/data/mysql/ --user=mysql --initialize
[root@localhost bin]# cat /data/mysql/mysql.err # 页面输出内容最后一行查看并记下来数据库初始密码
[root@localhost bin]# ln -s /usr/local/mysql/bin/mysql /usr/bin # 创建mysql短链接方便启动
[root@localhost bin]# cp /usr/local/mysql/support-files/mysql.server /etc/init.d/mysql
[root@localhost bin]# service mysql start # 启动mysql，会有成功的提示
[root@localhost bin]# ps -ef|grep mysql # 查得到mysql进程说明启动成功
[root@localhost bin]# mysql -u root -p # 登录mysql，交互式输入上面看到的初始密码

1
2
3
4
5
6 mysql> SET PASSWORD = PASSWORD('123456'); # 更新密码，这里更新的123456，根据自己需要更新
mysql> ALTER USER 'root'@'localhost' PASSWORD EXPIRE NEVER; # 设置root密码永不过期
mysql> FLUSH PRIVILEGES; # 刷新
mysql> use mysql # 访问mysql库，设置可以远程登录
mysql> update user set host = '%' where user = 'root'; # 使root能在任何host访问
mysql> FLUSH PRIVILEGES; # 刷新完毕后，可以使用Navicat远程登录mysql，我这里为了方便就执行了

3、安装SonarQube

1
2
3
4
5 [root@localhost ~]# yum -y install unzip
[root@localhost ~]# mkdir /home/software # 本次将SonarQube放到了该目录下，并安装在此
[root@localhost ~]# cd /home/software
[root@localhost software]# unzip sonarqube-7.7.zip
[root@localhost software]# cd sonarqube-7.7/bin/linux-x86-64/

这时候如果我们启动SonarQube可以发现是无法启动成功的，因为SonarQube里面包含了ElasticSearch插件，而Elasticsearch插件我们知道使用root用户无法启动的，所以SonarQube也不能使用root启动，使用root启动，该服务会马上自动关掉。

1
2
3
4
5
6 [root@localhost ~]# useradd conan # 新建个用户conan
[root@localhost ~]# chown -R conan:conan /home/software/sonarqube-7.7
[root@localhost ~]# su - conan # 切换为用户conan
[conan@localhost ~]$ cd /home/software/sonarqube-7.7/bin/linux-x86-64/
[conan@localhost linux-x86-64]$ ./sonar.sh start # 使用conan启动服务
[root@localhost ~]# ss -ntulp | grep 9000 # 可以查到SonarQube已经启动成功

这时候我们已经可以使用浏览器访问SonarQube的web页面了。
SonarQube地址：http://服务器ip:9000/在右上角有login选项，账号密码默认都是admin。

4、配置数据库和SonarQube

在数据里面创建新库sonar，创建用户sonar。

1
2
3
4
5 mysql> CREATE DATABASE sonar CHARACTER SET utf8 COLLATE utf8_general_ci;
mysql> CREATE USER 'sonar' IDENTIFIED BY 'sonar';
mysql> GRANT ALL ON sonar.* TO 'sonar'@'%' IDENTIFIED BY '123456';
mysql> GRANT ALL ON sonar.* TO 'sonar'@'localhost' IDENTIFIED BY '123456';
mysql> FLUSH PRIVILEGES;

修改SonarQube的配置文件

1
2
3
4
5
6
7
8
9
10
11
12
13 [root@localhost ~]# vim /home/software/sonarqube-7.7/conf/sonar.properties # 写入以下8行
sonar.jdbc.username=sonar
sonar.jdbc.password=123456
sonar.jdbc.url=jdbc:mysql://192.168.0.149:3306/sonar?useUnicode=true&characterEncoding=utf8&rewriteBatchedStatements=true&useConfigs=maxPerformance&useSSL=false
sonar.path.data=/home/software/sonarqube-7.7/data
sonar.path.temp=/home/software/sonarqube-7.7/temp
sonar.web.host=192.168.0.149
sonar.web.port=9000
sonar.web.context=/sonar

[root@localhost ~]# su - conan # 切换为用户conan
[conan@localhost ~]$ cd /home/software/sonarqube-7.7/bin/linux-x86-64/
[conan@localhost linux-x86-64]$ ./sonar.sh restart # 使用conan重启服务

这个时候我们访问： http://服务器ip:9000/sonar 可以登录页面。

5、安装中文语音包

使用默认的账号密码 admin 可以 login，然后我们搜索 chinese 可以看到中文包，但是安装的话是安装不了的，因为中文包也有版本，需要和 SonarQube 版本对应，而在这里的web页面安装的中文包的版本是最新的版本，写着“Support SonarQube 9.5”，所以安装的话和我们的 SonarQube 不匹配会报错。（下图是已经安装过的对应版本的截图）。

这就需要我们去网上找中文包：github.com/xuhuisheng/…在该页面可以看到版本对应关系：即本次 7.7版本的SonarQube 对应的是 1.27 的中文安装包。

所以我们下载去历史提交找到对应的jar包：Releases · xuhuisheng/sonar-l10n-zh (github.com)本次是：sonar-l10n-zh-plugin-1.27.jar

然后将其放到SonarQube的插件目录内：

1
2
3
4 [root@localhost ~]# mv sonar-l10n-zh-plugin-1.27.jar /home/software/sonarqube-7.7/extensions/plugins
[root@localhost ~]# su - conan # 切换为用户conan
[conan@localhost ~]$ cd /home/software/sonarqube-7.7/bin/linux-x86-64/
[conan@localhost linux-x86-64]$ ./sonar.sh restart # 使用conan重启服务