cloudreach/sonarqube

定制化SonarQube镜像文档

镜像概述

本镜像为软件业务部门（Software Business Unit）定制，基于官方SonarQube构建，针对业务特定需求进行优化配置。主要用于代码质量分析、静态代码检测及持续集成流程中的代码质量管控，帮助团队确保代码符合业务规范与行业标准。

核心功能与特性

核心功能

• 支持多语言代码质量分析（Java、Python、JavaScript等主流开发语言）
• 静态代码检测，识别代码缺陷、安全漏洞及代码异味
• 代码覆盖率分析与报告生成
• 自定义质量门禁规则配置

定制特性

• 预集成业务部门专用代码规则插件
• 预设业务特定代码质量标准与阈值
• 优化CI/CD流程集成配置，支持主流构建工具（Jenkins、GitLab CI等）
• 增强日志输出与监控指标，便于问题排查

使用场景与适用范围

适用场景

• 开发团队日常代码提交前的本地质量检测
• 代码审查流程中的自动化质量评估
• CI/CD流水线中的代码质量门禁检查
• 项目版本发布前的代码质量合规性验证

适用范围

• 软件业务部门内部所有开发项目
• 需符合业务特定代码规范的应用系统
• 采用敏捷开发或DevOps流程的团队

使用方法与配置说明

基本使用（Docker Run）

bash
docker run -d \
  --name sonarqube-custom \
  -p 9000:9000 \
  -e SONAR_JDBC_URL=jdbc:postgresql://db-host:5432/sonar \
  -e SONAR_JDBC_USERNAME=sonar \
  -e SONAR_JDBC_PASSWORD=sonar-password \
  -v sonarqube_data:/opt/sonarqube/data \
  -v sonarqube_extensions:/opt/sonarqube/extensions \
  software-business-unit/sonarqube:latest

Docker Compose配置示例

yaml
version: '3'
services:
  sonarqube:
    image: software-business-unit/sonarqube:latest
    container_name: sonarqube-custom
    ports:
      - "9000:9000"
    environment:
      - SONAR_JDBC_URL=jdbc:postgresql://db:5432/sonar
      - SONAR_JDBC_USERNAME=sonar
      - SONAR_JDBC_PASSWORD=sonar-password
      - SONAR_WEB_CONTEXT=/sonarqube
    volumes:
      - sonarqube_data:/opt/sonarqube/data
      - sonarqube_extensions:/opt/sonarqube/extensions
    depends_on:
      - db
  db:
    image: postgres:13
    environment:
      - POSTGRES_USER=sonar
      - POSTGRES_PASSWORD=sonar-password
      - POSTGRES_DB=sonar
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  sonarqube_data:
  sonarqube_extensions:
  postgres_data:

环境变量配置

数据持久化

为确保数据不丢失，需挂载以下目录：

• /opt/sonarqube/data: 存储SonarQube数据（分析结果、配置等）
• /opt/sonarqube/extensions: 存储插件与扩展

业务规则配置

1. 登录SonarQube Web界面（默认地址：http://localhost:9000，初始账号admin/admin）
2. 进入质量配置 → 规则
3. 选择业务部门预设规则集（名称：Software-BU-Code-Rules）
4. 应用至目标项目或全局配置

注意事项

• 首次启动需等待3-5分钟初始化
• 建议使用PostgreSQL数据库（推荐版本12+）
• 生产环境需配置HTTPS与访问控制
• 插件更新需重启容器生效