liumiaocn/sonarqube

SonarQube Docker镜像

镜像概述

本镜像基于Alpine系统构建，旨在简化SonarQube在Linux环境中的部署流程。SonarQube是一款流行的开源代码质量分析工具，可用于检测代码中的漏洞、bug和代码异味，支持多种编程语言。本镜像提供灵活的数据库配置选项，满足不同场景需求。

核心功能与特性

• 轻量级基础：基于Alpine系统，镜像体积小，资源占用低
• 多数据库支持：默认集成H2数据库（适合快速测试），同时支持外部MariaDB/MySQL数据库（适合生产环境）
• 简单部署：通过环境变量即可配置数据库连接，无需复杂的手动配置
• 即开即用：无需额外依赖，通过简单命令即可启动SonarQube服务

使用场景

• 开发环境中快速启动SonarQube进行代码质量检测
• 持续集成/持续部署(CI/CD)流程中集成代码质量分析环节
• 小型团队或个人项目的代码质量监控工具部署

使用方法

1. 使用默认H2数据库（适合测试）

通过以下命令快速启动SonarQube，使用内置H2数据库：

bash
docker run --rm --name sonarqube \
    -p 9000:9000 -p 9092:9092 \
    liumiaocn/sonarqube:5.6.5

参数说明：

• --rm：容器停止后自动删除
• --name sonarqube：指定容器名称为sonarqube
• -p 9000:9000：映射Web界面端口
• -p 9092:9092：映射内部通信端口
• liumiaocn/sonarqube:5.6.5：镜像名称及版本

启动后，访问 http://localhost:9000 即可打开SonarQube界面，默认用户名/密码为 admin/admin。

2. 使用MariaDB或MySQL数据库（适合生产环境）

2.1 配置数据库

首先在MariaDB/MySQL中创建SonarQube所需的数据库和用户：

sql
-- 删除已存在的sonar数据库（如有）
DROP DATABASE if exists sonar;
-- 创建sonar数据库，使用utf8编码
CREATE DATABASE sonar CHARACTER SET utf8 COLLATE utf8_general_ci;
-- 删除已存在的sonar用户（如有）
DROP USER sonar;
-- 创建sonar用户并设置密码
CREATE USER 'sonar' IDENTIFIED BY 'sonar';
-- 授予sonar用户数据库权限
GRANT ALL ON sonar.* TO 'sonar'@'%' IDENTIFIED BY 'sonar';
GRANT ALL ON sonar.* TO 'sonar'@'localhost' IDENTIFIED BY 'sonar';
-- 刷新权限
FLUSH PRIVILEGES;

2.2 启动SonarQube容器

通过环境变量指定数据库连接信息：

bash
docker run --rm --name sonarqube \
    -p 9000:9000 -p 9092:9092 \
    -e SONARQUBE_JDBC_USERNAME=sonar \  # 数据库用户名
    -e SONARQUBE_JDBC_PASSWORD=sonar \  # 数据库密码
    -e SONARQUBE_JDBC_URL=jdbc:mysql://localhost/sonar \  # 数据库连接URL
    liumiaocn/sonarqube:5.6.5

环境变量说明：

• SONARQUBE_JDBC_USERNAME：数据库用户名（需与创建的用户一致）
• SONARQUBE_JDBC_PASSWORD：数据库密码（需与创建的用户密码一致）
• SONARQUBE_JDBC_URL：数据库连接URL，格式为 jdbc:mysql://<数据库地址>/<数据库名>

注意事项

• 生产环境建议使用外部MariaDB/MySQL数据库，H2数据库不适合高并发场景
• 确保数据库服务与SonarQube容器网络互通（如使用Docker网络或主机网络）
• 根据实际需求调整资源限制（如添加 -m 参数限制内存使用）