背景

最近公司技术大佬同事告知，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，这是百度云网盘下载链接。
链接：pan.baidu.com/s/1UcP38rBi… 提取码：1234

步骤

1、安装jdk

[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

[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      # mysql的服务器ip地址，若mysql服务器有多个ip地址，那么这个地址将非常重要
port=3306
user=mysql      # mysqld程序启动后将在该账户下执行；mysqld必须从root账户启动才能在启动后切换到另一个账户下执行；mysqld_safe脚本将默认使用-user=mysql选项来启动mysqld程序。
basedir=/usr/local/mysql      # 根目录
datadir=/data/mysql      # 从给定目录读取数据库文件
socket=/tmp/mysql.sock        # 为mysql客户程序与服务器之间的本地通信指定一个套接字文件，仅适用于linux（unix）系统，默认设置一般是/var/lib/mysql/mysql.sock文件。
log-error=/data/mysql/mysql.err
pid-file=/data/mysql/mysql.pid
#character config
character_set_server=utf8mb4      # 默认的内部操作字符集
symbolic-links=0      # 符号连接，如果设置为1，则mysql数据库和表里的数据支持储存在datadir目录之外的路径下，默认都是0（较新版本的mysql下默认是1）
explicit_defaults_for_timestamp=true      # 官方解释：https://dev.mysql.com/doc/refman/5.7/en/server-system-variables.html#sysvar_explicit_defaults_for_timestamp

[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，交互式输入上面看到的初始密码

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

[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启动，该服务会马上自动关掉。

[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。

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的配置文件

[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的插件目录内：

[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重启服务

最后我们访问http://服务器ip:9000/sonar就可以看到中文页面了。

linux服务器安装SonarQube代码检测工具

背景