SonarQube配置与使用指南

### 一、环境准备
为了顺利配置和使用SonarQube，需要满足以下前提条件：
- 具备基本的Linux操作技能。
- 需要安装一个关系型数据库系统，例如Oracle、MySQL等。
- 支持的Java环境：Oracle JRE 7u75+ 或 OpenJDK 7u55+。
- MySQL版本要求：5.1 和 5.5，SonarQube 3.5+ 支持 MySQL 5，而 4.4+ 支持 MySQL 5.7。
- 浏览器支持：IE11+、Chrome 或 Firefox。
- 系统至少需要1GB以上的内存。
- 示例配置环境：CentOS 7（其他Linux发行版类似）。

### 二、执行样本分析
1. 下载并解压SonarQube 5.3，假设解压后的目录位于/etc/sonarqube。
2. 启动SonarQube服务器，执行命令：/etc/sonarqube/bin/[OS]/sonar.sh start。
3. 使用命令/etc/sonarqube/bin/[OS]/sonar.sh status检查SonarQube服务器的状态。
4. 下载并解压SonarQube Scanner至/etc/sonar-runner，这是用于运行项目分析的客户端工具。
5. 下载并解压一个待分析的项目实例，假设放置于/etc/sonar-examples。
6. 分析一个Java示例项目，进入项目目录并执行分析命令：
- $ cd /etc/sonar-examples/projects/languages/java/sonar-runner/java-sonar-runner-simple
- $ /etc/sonar-runner/bin/sonar-runner
7. 访问 http://localhost:9000 查看分析结果，默认的系统管理员账户为admin/admin。

### 三、数据库配置
SonarQube默认使用H2内存数据库，但建议配置为持久化的关系型数据库，如MySQL、SQL Server或Oracle。配置要点如下：
- 数据库字符集必须设置为UTF-8，语言设置为英语。
- 对于MySQL数据库，必须使用InnoDB存储引擎。
- 示例配置（以本地MySQL为例）：创建名为sonar的数据库，使用InnoDB存储引擎。
- 编辑/etc/sonarqube/conf/sonar.properties文件，取消注释并填写相应的数据库连接信息：
- sonar.jdbc.username=[数据库用户名]
- sonar.jdbc.password=[数据库密码]
- sonar.jdbc.url=jdbc:mysql://localhost:3306/sonar?useUnicode=true&characterEncoding=utf8&rewriteBatchedStatements=true&useCOnfigs=maxPerformance
- 执行/etc/sonarqube/bin/[OS]/sonar.sh restart重启SonarQube服务。

### 四、解析sonar-project.properties文件
在进行项目分析时，可以通过sonar-project.properties文件指定项目的分析参数，包括但不限于项目键、显示名称、版本、源代码路径、编程语言等。例如：
- sonar.projectKey=org.sonarqube:java-simple-sq-scanner # 项目键，在SonarQube中必须唯一。
- sonar.projectName=Java :: Simple Project Not Compiled :: SonarQube Scanner # 项目显示名称。
- sonar.projectVersion=1.0 # 项目版本。
- sonar.sources=src # 源代码路径，相对路径。
- sonar.language=java # 编程语言。
- sonar.sourceEncoding=UTF-8 # 源代码文件编码。

### 五、插件安装
在SonarQube管理控制台中，可以通过Administrator -> System -> Update Center -> Available访问插件市场，安装所需的语言插件后重启SonarQube服务即可生效。