SonarQube 9.9 与 SonarScanner 4.8 环境部署指南
一、系统环境准备
SonarQube 对系统资源有特定要求，主要涉及内核参数的优化，以确保 Elasticsearch 能稳定运行。
# 编辑系统配置文件
cat <<EOF >> /etc/sysctl.d/sonar.conf
vm.max_map_count=262144
fs.file-max=65536
EOF
sysctl -p
# 设置文件描述符限制
cat <<EOF >> /etc/security/limits.conf
* soft nofile 65536
* hard nofile 65536
EOF
# 安装 OpenJDK 17
tar -xf openjdk-17_linux-x64.tar.gz -C /opt/
cat <<EOF >> /etc/profile.d/env_java.sh
export JAVA_HOME=/opt/jdk-17
export PATH=\$JAVA_HOME/bin:\$PATH
EOF
source /etc/profile.d/env_java.sh
二、配置 PostgreSQL 数据库
SonarQube 9.9 版本推荐使用 PostgreSQL 作为底层数据存储。
# 安装并初始化数据库
yum install -y postgresql14-server
/usr/pgsql-14/bin/postgresql-14-setup initdb
systemctl enable --now postgresql-14
# 创建专用数据库与账号
sudo -u postgres psql <<EOF
CREATE DATABASE sonar_db;
CREATE USER sonar_user WITH ENCRYPTED PASSWORD 'StrongPass123';
GRANT ALL PRIVILEGES ON DATABASE sonar_db TO sonar_user;
EOF
# 调整监听配置 (pg_hba.conf) 以允许 SonarQube 连接
sed -i "s/#listen_addresses = 'localhost'/listen_addresses = '*'/" /var/lib/pgsql/14/data/postgresql.conf
echo "host all all 0.0.0.0/0 md5" >> /var/lib/pgsql/14/data/pg_hba.conf
systemctl restart postgresql-14
三、部署 SonarQube 服务
SonarQube 不支持以 root 用户直接运行，务必使用非特权用户。
# 解压并授权
unzip sonarqube-9.9.zip -d /opt/
useradd sonarqube
chown -R sonarqube:sonarqube /opt/sonarqube-9.9
# 编辑配置文件
cat >> /opt/sonarqube-9.9/conf/sonar.properties <<EOF
sonar.jdbc.username=sonar_user
sonar.jdbc.password=StrongPass123
sonar.jdbc.url=jdbc:postgresql://localhost:5432/sonar_db
sonar.web.host=0.0.0.0
sonar.web.port=9000
EOF
# 启动服务
sudo -u sonarqube /opt/sonarqube-9.9/bin/linux-x86-64/sonar.sh start
服务启动后，通过浏览器访问 http://<服务器IP>:9000 进行初始化，初始凭据为 admin/admin。
四、安装 SonarScanner 客户端
SonarScanner 用于在 Jenkins 或其他构建工具中执行扫描分析。
# 下载并解压
wget https://binaries.sonarsource.com/Distribution/sonar-scanner-cli/sonar-scanner-cli-4.8.0.2856-linux.zip
unzip sonar-scanner-cli-4.8.0.2856-linux.zip -d /opt/
# 配置环境变量
echo 'export PATH=/opt/sonar-scanner-4.8/bin:$PATH' >> /etc/profile
source /etc/profile
# 验证安装
sonar-scanner --version
配置完成后，可在 SonarQube 控制台的"配置" -> "应用市场"中下载中文插件，安装后重启 SonarQube 服务即可生效。
