要求
- 至少1G以上內存,推薦為2G
- Java:Oracle JRE 7u75+,OpenJDK 7u75+
- 數據庫:
- Microsoft SQL Server 2008/2012/2014
- MySQL 5.1/5.5
- Oracle 11g/12c(Oracle 11.2.x drivers))
- PostgreSQL 8.x/9.x
注:使用Microsoft SQL Server時,數據庫的排序規則必須為“大小寫敏感”(CS)和“重音敏感”(AS),如下圖中選擇的“Chinese_PRC_CS_AS”:
安裝
1. 新建數據庫方案
以Oracle為例,創建數據庫方案
執行以下語句,新建sonarqube表空間和用戶,並授予相應的權限
CREATE TABLESPACE sonarqube
DATAFILE '/opt/oracle/oradata/orcl/sonarqube.dbf' SIZE 512M
AUTOEXTEND ON NEXT 512M MAXSIZE 20480M;
CREATE USER sonarqube IDENTIFIED BY sonarqube;
GRANT CONNECT, RESOURCE ,DBA TO sonarqube;
2. 安裝SonarQube
解壓sonarqube.zip壓縮包到指定位置
配置數據庫連接
打開 <安裝目錄>/conf/sonar.properties 文件配置數據庫連接,文件中含有每一種數據庫連接的樣例,根據需要取消掉指定行前面的注釋,配置正確的連接,用戶名,密碼即可,這里我們使用的是Oracle數據庫,取消sonar.jdbc.username、sonar.jdbc.password、sonar.jdbc.url(Oracle)行注釋,如下:
sonar.jdbc.username=sonarqube
sonar.jdbc.password=sonarqube
sonar.jdbc.url=jdbc:oracle:thin:@192.168.5.13:1521/orcl
添加JDBC驅動
SonarQube自帶除了Oracle以外的數據庫驅動,需要將Oralce JDBC驅動拷貝到 <安裝目錄>/extensions/jdbc-driver/oracle 目錄下
注:不支持ojdbc14.jar驅動,12.1.0.1和12.1.0.2的驅動含有bug,不建議使用,另外,僅支持thin模式連接,不支持OCI
啟動SonarQube服務器
默認端口為9000,默認路徑為:/sonar,可以在<安裝目錄>/conf/sonar.properties文件中配置,如下:
sonar.web.host=127.0.0.1
sonar.web.port=9000
sonar.web.context=/sonar
執行 <安裝目錄>/bin/windows-x86-XX/StartSonar.bat 腳本來啟動服務器,然后就可以通過http://localhost:9000來訪問SonarQube服務器(管理員賬戶用戶名密碼admin/admin),首次訪問因為需要初始化數據庫所以會比較慢。
安裝SonarQube服務
以管理員身份運行 <安裝目錄>/bin/windows-x86-XX/InstallNTService.bat 即可將SonarQube作為服務安裝在Windows上
然后修改服務運行時的登錄用戶,如下:
運行 <安裝目錄>/bin/windows-x86-XX/StartNTService.bat 腳本可以啟動SonarQube服務。
插件
SonarQube本身並不具備任何的代碼檢查規則,所有的規則都是以插件的形式安裝到SonarQube服務器中的,為此,SonarQube也提供了Web端的界面進行插件管理,可以進行插件的安裝、卸載、升級。
登錄SonarQube后,在Web界面中單擊上方"Administration"-->"System"-->"Update Center"進入更新中心,可以進行插件的管理及系統的升級,如下:
下載、安裝、卸載、升級插件都可以在這里完成,SonarQube的插件不僅僅是代碼檢查規則,還包括語言包等一些輔助功能的插件,點擊安裝,下載完成后重啟服務即可。
在更新中心中管理插件需要聯網下載插件,下載完成的插件保存在 <安裝目錄>/extensions/downloads文件夾下,若是沒有網絡環境,則可將下載完成的插件(*.jar文件)拷貝到 <安裝目錄>/extensions/plugins文件夾下,重啟服務即可。