linux服務器安裝SonarQube代碼檢測工具的詳細步驟

Posted on by

背景

最近公司技術大佬同事告知，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

[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
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，交互式輸入上面看到的初始密碼
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代碼檢測工具的文章就介紹到這瞭,更多相關linux服務器安裝SonarQube內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet！

推薦閱讀：