linux伺服器安裝SonarQube程式碼檢測工具的詳細步驟

2022-07-15 14:06:17

背景

最近公司技術大佬同事告知，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內容請搜尋it145.com以前的文章或繼續瀏覽下面的相關文章希望大家以後多多支援it145.com！