1. 項(xiàng)目概述為什么選擇 SonarQube 9.9.4 LTS如果你正在為團(tuán)隊(duì)尋找一個(gè)穩(wěn)定、可靠且免費(fèi)的代碼質(zhì)量與安全分析平臺(tái)那么 SonarQube 9.9.4 LTS 社區(qū)版絕對(duì)是一個(gè)繞不開的選項(xiàng)。我經(jīng)歷過從 7.x 版本一路升級(jí)到 9.x 的完整周期也踩過不少配置和集成的坑。這次選擇 9.9.4 LTS 進(jìn)行部署核心原因在于它的“長期支持”特性。LTS 版本意味著在接下來幾年內(nèi)你都能獲得官方的安全補(bǔ)丁和關(guān)鍵修復(fù)這對(duì)于生產(chǎn)環(huán)境至關(guān)重要避免了頻繁升級(jí)帶來的不穩(wěn)定風(fēng)險(xiǎn)。社區(qū)版雖然功能上比企業(yè)版有所限制比如缺少多分支分析、企業(yè)級(jí)安全規(guī)則等但其核心的靜態(tài)代碼分析、Bug 檢測、漏洞掃描、代碼異味Code Smell識(shí)別以及覆蓋率集成功能對(duì)于中小型團(tuán)隊(duì)或個(gè)人開發(fā)者來說已經(jīng)完全夠用甚至綽綽有余。它能幫你把代碼質(zhì)量的門檻從“能跑就行”提升到“清晰、安全、可維護(hù)”的工業(yè)級(jí)水準(zhǔn)。2. 環(huán)境準(zhǔn)備與前置依賴解析在真正動(dòng)手安裝 SonarQube 之前把地基打牢至關(guān)重要。很多安裝失敗的問題根源都在于前置環(huán)境沒有配置妥當(dāng)。SonarQube 9.9.4 本身是一個(gè) Java 應(yīng)用但它對(duì)運(yùn)行環(huán)境有比較具體的要求。2.1 操作系統(tǒng)與硬件要求官方推薦在 Linux 系統(tǒng)上運(yùn)行我這里以最常用的 Ubuntu Server 22.04 LTS 為例進(jìn)行說明。選擇 LTS 版本的操作系統(tǒng)也是為了與 SonarQube LTS 版本在穩(wěn)定性上對(duì)齊減少系統(tǒng)層面的意外。Windows 環(huán)境雖然也支持但通常用于開發(fā)測試生產(chǎn)部署還是 Linux 更主流、資源占用也更優(yōu)。硬件方面對(duì)于小團(tuán)隊(duì)或項(xiàng)目建議最低配置為 2 核 CPU 和 4GB 內(nèi)存。但請(qǐng)注意這是 SonarQube 服務(wù)器進(jìn)程本身的需求。如果你需要分析大型項(xiàng)目比如超過 50 萬行代碼或者同時(shí)運(yùn)行多個(gè)分析任務(wù)內(nèi)存最好提升到 8GB 或以上。磁盤空間則需要預(yù)留至少 10GB用于存放分析數(shù)據(jù)、插件和日志。實(shí)際使用中隨著分析歷史積累磁盤占用會(huì)緩慢增長建議監(jiān)控/opt/sonarqube/data目錄的大小。2.2 Java 運(yùn)行時(shí)環(huán)境 (JRE)這是最關(guān)鍵的一環(huán)。SonarQube 9.9.4必須運(yùn)行在 Java 17上。它不兼容 Java 8、Java 11 或更新的 Java 21。如果你系統(tǒng)上安裝了多個(gè) Java 版本必須確保 SonarQube 啟動(dòng)時(shí)使用的是正確的 Java 17。在 Ubuntu 22.04 上安裝 OpenJDK 17 最方便sudo apt update sudo apt install openjdk-17-jre-headless -y安裝后驗(yàn)證版本java -version輸出應(yīng)明確顯示openjdk version “17.x.x”。這里我推薦使用-headless版本因?yàn)樗话瑘D形界面相關(guān)的庫更輕量更適合服務(wù)器環(huán)境。2.3 數(shù)據(jù)庫準(zhǔn)備SonarQube 不支持內(nèi)置數(shù)據(jù)庫用于生產(chǎn)環(huán)境。社區(qū)版支持 PostgreSQL (9.6 或更高)、Microsoft SQL Server (2014 或更高) 和 Oracle。對(duì)于絕大多數(shù)場景PostgreSQL 是首選因?yàn)樗赓M(fèi)、開源且與 SonarQube 集成最成熟。我們需要安裝并配置一個(gè)專供 SonarQube 使用的 PostgreSQL 數(shù)據(jù)庫sudo apt install postgresql postgresql-contrib -y安裝完成后切換到postgres用戶來創(chuàng)建數(shù)據(jù)庫和用戶sudo -i -u postgres psql在 PostgreSQL 交互命令行中依次執(zhí)行以下 SQL 語句CREATE DATABASE sonarqube; CREATE USER sonarqube WITH ENCRYPTED PASSWORD ‘your_strong_password_here’; GRANT ALL PRIVILEGES ON DATABASE sonarqube TO sonarqube; ALTER DATABASE sonarqube OWNER TO sonarqube; \q exit這里有幾個(gè)細(xì)節(jié)需要注意密碼強(qiáng)度your_strong_password_here務(wù)必替換成一個(gè)高強(qiáng)度的密碼這是生產(chǎn)環(huán)境安全的基本要求。權(quán)限我們創(chuàng)建了專門的sonarqube用戶并賦予了它對(duì)sonarqube數(shù)據(jù)庫的所有權(quán)限。這種權(quán)限隔離比直接使用postgres超級(jí)用戶更安全。編碼PostgreSQL 默認(rèn)創(chuàng)建的數(shù)據(jù)庫編碼通常是正確的無需額外調(diào)整。如果遇到編碼問題可以在CREATE DATABASE時(shí)指定ENCODING ‘UTF8’。2.4 創(chuàng)建運(yùn)行用戶與目錄權(quán)限出于安全考慮絕對(duì)不要使用root用戶直接運(yùn)行 SonarQube。我們應(yīng)該創(chuàng)建一個(gè)專用的系統(tǒng)用戶sudo groupadd sonarqube sudo useradd -c “SonarQube” -d /opt/sonarqube -g sonarqube -s /bin/bash sonarqube sudo passwd sonarqube # 為用戶設(shè)置一個(gè)密碼用于后續(xù)sudo切換這里我們創(chuàng)建了sonarqube用戶組和用戶并將其主目錄設(shè)置為/opt/sonarqube這也是我們即將安裝 SonarQube 的位置。接下來下載 SonarQube 9.9.4 LTS 社區(qū)版的壓縮包。你可以從官網(wǎng)或國內(nèi)鏡像站獲取。使用wget下載sudo wget https://binaries.sonarsource.com/Distribution/sonarqube/sonarqube-9.9.4.87374.zip下載完成后將其解壓到/opt目錄并更改所有權(quán)sudo unzip sonarqube-9.9.4.87374.zip -d /opt/ sudo mv /opt/sonarqube-9.9.4.87374 /opt/sonarqube sudo chown -R sonarqube:sonarqube /opt/sonarqube sudo chmod -R 755 /opt/sonarqubechmod 755確保了目錄的可執(zhí)行權(quán)限這對(duì)于 SonarQube 啟動(dòng)腳本是必需的。3. SonarQube 核心配置詳解安裝文件就位后真正的個(gè)性化工作在于配置。SonarQube 的配置文件位于/opt/sonarqube/conf目錄下其中sonar.properties是主配置文件。3.1 數(shù)據(jù)庫連接配置用文本編輯器如nano或vim打開配置文件sudo nano /opt/sonarqube/conf/sonar.properties找到數(shù)據(jù)庫配置部分取消注釋并修改以下行# 使用 PostgreSQL sonar.jdbc.urljdbc:postgresql://localhost:5432/sonarqube # 數(shù)據(jù)庫用戶名 sonar.jdbc.usernamesonarqube # 數(shù)據(jù)庫密碼替換成你之前設(shè)置的強(qiáng)密碼 sonar.jdbc.passwordyour_strong_password_here注意配置文件中的密碼是明文存儲(chǔ)的。因此務(wù)必確保sonar.properties文件的權(quán)限設(shè)置為僅sonarqube用戶可讀sudo chmod 600 /opt/sonarqube/conf/sonar.properties。3.2 Web 服務(wù)與搜索引擎配置繼續(xù)在sonar.properties中配置# Web 服務(wù)器監(jiān)聽的地址和端口。0.0.0.0 表示監(jiān)聽所有網(wǎng)絡(luò)接口。 sonar.web.host0.0.0.0 sonar.web.port9000 # 嵌入式 Elasticsearch 的配置。SonarQube 使用 Elasticsearch 進(jìn)行搜索和索引。 sonar.search.hostlocalhost sonar.search.port9001 # 建議為 Elasticsearch 配置獨(dú)立的內(nèi)存根據(jù)服務(wù)器總內(nèi)存調(diào)整。 sonar.search.javaOpts-Xms512m -Xmx512m -XX:MaxDirectMemorySize256m -XX:HeapDumpOnOutOfMemoryError關(guān)于內(nèi)存配置這里有個(gè)經(jīng)驗(yàn)之談sonar.search.javaOpts中的-Xmx值最大堆內(nèi)存不宜設(shè)置得過大通常 512MB 到 1GB 對(duì)于社區(qū)版足夠。如果設(shè)置得太大可能會(huì)擠占 SonarQube 主進(jìn)程Web 容器的內(nèi)存導(dǎo)致整體性能下降。-XX:MaxDirectMemorySize256m這個(gè)參數(shù)對(duì)于 Elasticsearch 7 的運(yùn)行很重要?jiǎng)?wù)必加上。3.3 調(diào)整系統(tǒng)內(nèi)核參數(shù)SonarQube 在啟動(dòng)時(shí)特別是其內(nèi)置的 Elasticsearch 組件對(duì)系統(tǒng)虛擬內(nèi)存和線程數(shù)有限制要求。如果不調(diào)整可能會(huì)看到啟動(dòng)失敗的錯(cuò)誤日志。編輯系統(tǒng)限制配置文件sudo nano /etc/sysctl.conf在文件末尾添加vm.max_map_count262144 fs.file-max65536vm.max_map_count是 Elasticsearch 運(yùn)行的關(guān)鍵參數(shù)定義了進(jìn)程能擁有的最大內(nèi)存映射區(qū)域數(shù)量。保存后執(zhí)行sudo sysctl -p使配置立即生效。接著修改用戶資源限制sudo nano /etc/security/limits.conf在文件末尾添加sonarqube - nofile 65536 sonarqube - nproc 4096這為sonarqube用戶設(shè)置了最大文件打開數(shù)和最大進(jìn)程數(shù)。要使這個(gè)配置生效用戶必須通過 PAM 登錄。由于我們通常通過systemd服務(wù)啟動(dòng)這些限制可能不會(huì)自動(dòng)應(yīng)用。更可靠的方法是在systemd服務(wù)文件中直接設(shè)置我們會(huì)在下一節(jié)配置。4. 配置 Systemd 服務(wù)與啟動(dòng)使用systemd來管理 SonarQube 服務(wù)是最規(guī)范的方式可以實(shí)現(xiàn)開機(jī)自啟、日志集中管理、服務(wù)狀態(tài)監(jiān)控等。4.1 創(chuàng)建 Systemd 服務(wù)文件創(chuàng)建服務(wù)文件sudo nano /etc/systemd/system/sonarqube.service將以下內(nèi)容粘貼進(jìn)去。這份配置是我經(jīng)過多次調(diào)試后總結(jié)的包含了關(guān)鍵的環(huán)境變量和資源限制[Unit] DescriptionSonarQube service Aftersyslog.target network.target postgresql.service [Service] Typeforking # 關(guān)鍵指定運(yùn)行用戶和組 Usersonarqube Groupsonarqube # 關(guān)鍵設(shè)置資源限制覆蓋系統(tǒng)默認(rèn)值 LimitNOFILE65536 LimitNPROC4096 # 關(guān)鍵設(shè)置環(huán)境變量確保使用正確的 Java 17 Environment“JAVA_HOME/usr/lib/jvm/java-17-openjdk-amd64” Environment“SONARQUBE_HOME/opt/sonarqube” # 關(guān)鍵設(shè)置進(jìn)程的 umask影響創(chuàng)建文件的默認(rèn)權(quán)限 UMask0002 # 設(shè)置安全上下文防止生成核心轉(zhuǎn)儲(chǔ)文件 LimitCORE0 # 工作目錄 WorkingDirectory/opt/sonarqube # 啟動(dòng)腳本和參數(shù) ExecStart/opt/sonarqube/bin/linux-x86-64/sonar.sh start ExecStop/opt/sonarqube/bin/linux-x86-64/sonar.sh stop # 給進(jìn)程發(fā)送停止信號(hào)后等待 300 秒再強(qiáng)制殺死 TimeoutStopSec300 # 如果進(jìn)程崩潰在 5 秒后自動(dòng)重啟最多重啟 3 次 Restarton-failure RestartSec5 StartLimitIntervalSec0 [Install] WantedBymulti-user.target這份配置有幾個(gè)核心點(diǎn)Afterpostgresql.service確保 PostgreSQL 數(shù)據(jù)庫先啟動(dòng)SonarQube 再啟動(dòng)。LimitNOFILE和LimitNPROC直接在服務(wù)單元中設(shè)置這是最可靠的生效方式。JAVA_HOME顯式指定避免系統(tǒng)中有多個(gè) Java 版本時(shí)產(chǎn)生混淆。UMask0002這使得 SonarQube 創(chuàng)建的文件和目錄對(duì)同組用戶具有寫權(quán)限便于在需要時(shí)進(jìn)行調(diào)試或手動(dòng)操作。Restarton-failure實(shí)現(xiàn)進(jìn)程異常退出后的自動(dòng)恢復(fù)提高服務(wù)可用性。4.2 啟動(dòng)服務(wù)并驗(yàn)證保存服務(wù)文件后執(zhí)行以下命令# 重新加載 systemd 配置 sudo systemctl daemon-reload # 啟用開機(jī)自啟 sudo systemctl enable sonarqube.service # 啟動(dòng)服務(wù) sudo systemctl start sonarqube.service # 查看服務(wù)狀態(tài)和日志 sudo systemctl status sonarqube.service sudo journalctl -u sonarqube -f啟動(dòng)過程可能需要一兩分鐘。通過status命令你應(yīng)該看到active (running)狀態(tài)。通過journalctl跟蹤日志當(dāng)看到類似“SonarQube is up”的日志時(shí)說明啟動(dòng)成功。此時(shí)打開瀏覽器訪問http://你的服務(wù)器IP:9000。你應(yīng)該能看到 SonarQube 的登錄頁面。默認(rèn)的管理員賬號(hào)和密碼都是admin。首次登錄會(huì)強(qiáng)制要求修改密碼請(qǐng)務(wù)必設(shè)置一個(gè)強(qiáng)密碼。5. 安裝后配置與插件管理成功登錄后別急著分析代碼。先進(jìn)行一些基礎(chǔ)配置能讓后續(xù)使用更順暢。5.1 配置管理員密碼與項(xiàng)目分析令牌修改完初始 admin 密碼后我強(qiáng)烈建議為日常的項(xiàng)目分析創(chuàng)建一個(gè)專用的“服務(wù)賬戶”或使用“項(xiàng)目令牌”而不是一直使用 admin 賬號(hào)。點(diǎn)擊右上角頭像 -“My Account”。切換到“Security”標(biāo)簽頁。在 “Generate Tokens” 部分輸入令牌名稱如my-project-analysis點(diǎn)擊生成。務(wù)必立即復(fù)制生成的令牌字符串它只會(huì)顯示一次。這個(gè)令牌將用于 CI/CD 流水線如 Jenkins, GitLab CI或本地掃描命令中代替用戶名密碼進(jìn)行認(rèn)證。5.2 安裝中文語言包可選SonarQube 界面默認(rèn)是英文的。對(duì)于國內(nèi)團(tuán)隊(duì)安裝中文語言包能降低使用門檻。以 admin 身份登錄點(diǎn)擊頂部導(dǎo)航欄的“Administration”。選擇“Marketplace”標(biāo)簽頁。在 “Plugins” 頁面搜索“Chinese Pack”。找到官方提供的語言包插件點(diǎn)擊右側(cè)的“Install”按鈕。安裝完成后頁面會(huì)提示需要重啟 SonarQube 服務(wù)。在服務(wù)器上執(zhí)行sudo systemctl restart sonarqube。重啟后在“Configuration” - “General” - “Localization”中將 “Default language” 設(shè)置為 “中文”。5.3 理解內(nèi)置規(guī)則與質(zhì)量閾SonarQube 的核心價(jià)值在于其龐大的規(guī)則庫。社區(qū)版默認(rèn)就攜帶了數(shù)千條針對(duì) Java, JavaScript, TypeScript, Python, C#, Go 等多種語言的規(guī)則涵蓋 Bug、漏洞、代碼異味和安全熱點(diǎn)。作為管理員你需要關(guān)注“Quality Gates”和“Quality Profiles”。質(zhì)量閾定義了一個(gè)項(xiàng)目能否“通過”的質(zhì)量標(biāo)準(zhǔn)。例如你可以設(shè)置“新代碼的重復(fù)率不能超過3%”、“不能有阻斷級(jí)別的 Bug”等條件。項(xiàng)目分析報(bào)告會(huì)據(jù)此給出“通過”或“失敗”狀態(tài)。質(zhì)量配置定義了針對(duì)每種語言具體啟用哪些規(guī)則、規(guī)則的嚴(yán)重級(jí)別阻斷、嚴(yán)重、主要、次要、提示。默認(rèn)的 “Sonar way” 配置是一個(gè)很好的起點(diǎn)。我建議初期不要隨意禁用規(guī)則而是先了解每個(gè)規(guī)則報(bào)警的原因這本身就是一個(gè)學(xué)習(xí)代碼規(guī)范的過程。6. 實(shí)戰(zhàn)使用 Scanner 分析第一個(gè)項(xiàng)目服務(wù)器跑起來了現(xiàn)在我們來實(shí)際分析一個(gè)代碼項(xiàng)目。SonarQube 采用“掃描器”架構(gòu)服務(wù)器負(fù)責(zé)UI展示、規(guī)則管理和報(bào)告存儲(chǔ)而代碼分析工作由獨(dú)立的“掃描器”在本地或 CI 環(huán)境中完成。6.1 選擇合適的掃描器SonarQube 提供了多種掃描器最常用的是SonarScanner它是一個(gè)獨(dú)立的命令行工具。根據(jù)你的構(gòu)建工具也可以使用更集成的插件Maven 項(xiàng)目直接使用sonar-maven-plugin在pom.xml中配置即可無需單獨(dú)安裝 Scanner。Gradle 項(xiàng)目使用sonarqubeGradle 插件。.NET 項(xiàng)目使用SonarScanner for .NET。其他語言如 Python, Go, JS使用SonarScanner CLI。這里以最通用的SonarScanner CLI為例演示如何分析一個(gè)簡單的 Python 項(xiàng)目。6.2 安裝與配置 SonarScanner CLI在用于分析的機(jī)器上可以是你的開發(fā)機(jī)也可以是 CI 服務(wù)器下載并解壓 SonarScanner。# 下載請(qǐng)從官網(wǎng)獲取最新版鏈接 wget https://binaries.sonarsource.com/Distribution/sonar-scanner-cli/sonar-scanner-cli-5.0.1.3006-linux.zip unzip sonar-scanner-cli-5.0.1.3006-linux.zip -d /opt/ sudo mv /opt/sonar-scanner-5.0.1.3006-linux /opt/sonar-scanner將 Scanner 的bin目錄加入 PATHecho ‘export PATH$PATH:/opt/sonar-scanner/bin’ ~/.bashrc source ~/.bashrc驗(yàn)證安裝sonar-scanner -v。6.3 執(zhí)行代碼分析進(jìn)入你的項(xiàng)目根目錄創(chuàng)建一個(gè)sonar-project.properties文件。這是 Scanner 的配置文件。# 項(xiàng)目的唯一標(biāo)識(shí)符 sonar.projectKeymy-python-project # 項(xiàng)目在 SonarQube 界面上顯示的名稱 sonar.projectNameMy Python Project # 項(xiàng)目版本 sonar.projectVersion1.0 # 源代碼目錄相對(duì)于此配置文件 sonar.sources. # 需要排除的目錄支持通配符 sonar.exclusions**/test/**, **/*.pyc # 指定語言 sonar.languagepy # 指定源代碼編碼 sonar.sourceEncodingUTF-8 # SonarQube 服務(wù)器地址替換為你的服務(wù)器地址 sonar.host.urlhttp://your-sonarqube-server:9000 # 使用之前生成的令牌進(jìn)行認(rèn)證或使用用戶名密碼 sonar.loginsqp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx保存后在項(xiàng)目根目錄下直接運(yùn)行命令sonar-scanner掃描器會(huì)開始分析代碼并將結(jié)果上傳到 SonarQube 服務(wù)器。分析完成后控制臺(tái)會(huì)輸出一個(gè)指向本次分析結(jié)果的 URL。打開這個(gè) URL你就能在 SonarQube 的網(wǎng)頁界面上看到詳細(xì)的代碼質(zhì)量報(bào)告包括 Bug、漏洞、代碼異味、重復(fù)代碼、單元測試覆蓋率如果配置了等信息。7. 常見問題排查與性能調(diào)優(yōu)即使按照步驟操作在實(shí)際部署中也可能遇到問題。這里記錄幾個(gè)我遇到過的典型問題及其解決方法。7.1 服務(wù)啟動(dòng)失敗排查如果sudo systemctl status sonarqube顯示失敗按以下順序排查檢查日志這是第一步也是最重要的一步。使用sudo journalctl -u sonarqube -n 100查看最近100行日志或者sudo tail -f /opt/sonarqube/logs/sonar.log查看具體應(yīng)用日志。錯(cuò)誤信息通常很明確。數(shù)據(jù)庫連接問題日志中常見 “Cannot connect to database”。檢查PostgreSQL 服務(wù)是否運(yùn)行sudo systemctl status postgresql。sonar.properties中的數(shù)據(jù)庫 IP、端口、用戶名、密碼是否正確。PostgreSQL 的pg_hba.conf文件是否允許本地連接。確保有類似host all all 127.0.0.1/32 md5的行。使用psql -h localhost -U sonarqube -d sonarqube手動(dòng)測試連接。Elasticsearch 啟動(dòng)失敗日志中常見 “max virtual memory areas vm.max_map_count [65530] is too low”。這說明內(nèi)核參數(shù)沒生效。務(wù)必執(zhí)行sudo sysctl -p并確認(rèn)sysctl vm.max_map_count輸出為 262144。如果通過systemd啟動(dòng)確保服務(wù)文件中的LimitMEMLOCK已配置如前文所示。Java 版本錯(cuò)誤確認(rèn)java -version輸出是 17。檢查sonarqube.service文件中的JAVA_HOME環(huán)境變量路徑是否正確。7.2 Web 界面無法訪問防火墻檢查服務(wù)器防火墻是否開放了 9000 端口。對(duì)于 UFWUbuntusudo ufw allow 9000。綁定地址確認(rèn)sonar.properties中的sonar.web.host是0.0.0.0而不是127.0.0.1否則只能本機(jī)訪問。內(nèi)存不足如果服務(wù)器內(nèi)存太小如小于 2GBSonarQube 可能啟動(dòng)但極不穩(wěn)定Web 服務(wù)無響應(yīng)。檢查日志是否有OutOfMemoryError。需要調(diào)整conf/sonar.properties中的sonar.web.javaOpts和sonar.search.javaOpts適當(dāng)減小內(nèi)存分配或者直接升級(jí)服務(wù)器配置。7.3 分析過程緩慢或失敗掃描器內(nèi)存不足對(duì)于大型項(xiàng)目Scanner 進(jìn)程可能內(nèi)存不足。可以設(shè)置環(huán)境變量SONAR_SCANNER_OPTS”-Xmx2048m”來增加 Scanner 的堆內(nèi)存。服務(wù)器資源瓶頸分析時(shí)SonarQube 服務(wù)器的 CPU 和內(nèi)存使用率會(huì)飆升。如果多個(gè)項(xiàng)目同時(shí)分析容易導(dǎo)致隊(duì)列堆積或超時(shí)。建議在 CI/CD 流水線中錯(cuò)開分析任務(wù)或者升級(jí)服務(wù)器配置。網(wǎng)絡(luò)問題Scanner 需要將分析結(jié)果上傳到服務(wù)器。如果網(wǎng)絡(luò)延遲高或不穩(wěn)定可能導(dǎo)致上傳失敗。檢查 Scanner 日志中的網(wǎng)絡(luò)超時(shí)錯(cuò)誤。7.4 日常維護(hù)建議定期備份最重要的就是/opt/sonarqube/data目錄數(shù)據(jù)庫數(shù)據(jù)和/opt/sonarqube/extensions目錄插件。備份前最好停止 SonarQube 服務(wù)以保證數(shù)據(jù)一致性。日志清理SonarQube 的日志在/opt/sonarqube/logs下默認(rèn)會(huì)滾動(dòng)歸檔。可以配置conf/sonar.properties中的sonar.log.rollingPolicy來管理日志保留時(shí)間和大小。監(jiān)控健康狀態(tài)訪問http://your-server:9000/system需管理員權(quán)限可以查看系統(tǒng)健康狀態(tài)、JVM 內(nèi)存使用情況、數(shù)據(jù)庫連接池狀態(tài)等便于提前發(fā)現(xiàn)問題。謹(jǐn)慎升級(jí)插件尤其是核心語言插件如 Java、Python。在生產(chǎn)環(huán)境升級(jí)前最好在測試環(huán)境驗(yàn)證兼容性。SonarQube 的升級(jí)通常也建議先測試因?yàn)閿?shù)據(jù)庫 schema 可能有變更。部署 SonarQube 只是第一步讓它持續(xù)、穩(wěn)定地運(yùn)行并真正融入團(tuán)隊(duì)的開發(fā)流程成為代碼質(zhì)量守門員才是更大的價(jià)值所在。從我的經(jīng)驗(yàn)看初期可能會(huì)因?yàn)榇罅繗v史問題被暴露而感到壓力但堅(jiān)持下來團(tuán)隊(duì)的代碼規(guī)范意識(shí)和代碼健壯性會(huì)有肉眼可見的提升。