mateuscppoi/sonarqube

SonarQube 7.8 Community with mc1arke Branch Plugin 镜像文档

镜像概述

本镜像基于SonarQube 7.8 Community版本构建，集成了mc1arke分支插件，旨在为开发团队提供代码质量和安全分析能力，同时支持多分支项目的代码检测与管理，帮助团队在开发过程中及时发现并修复代码问题。

核心功能与特性

• 代码质量分析：支持对多种编程语言（如Java、Python、JavaScript等）的代码进行质量检测，包括代码规范、漏洞、重复代码、复杂度等维度分析。
• 多分支支持：通过mc1arke分支插件，实现对Git等版本控制系统中多分支的代码分析，支持分支间质量对比与管理。
• 社区版基础功能：包含SonarQube社区版核心功能，如质量门禁、问题跟踪、报告生成等。
• 轻量级部署：基于Docker容器化部署，简化环境配置，支持快速启动与集成。

使用场景与适用范围

• 开发团队代码质量监控：适用于中小型开发团队对项目代码进行持续质量检测，确保代码符合团队规范。
• 多分支项目管理：针对采用GitFlow等多分支开发模式的项目，支持对feature、release、hotfix等分支进行独立分析与质量跟踪。
• CI/CD流程集成：可集成到Jenkins、GitLab CI等持续集成/持续部署流程中，实现代码提交或合并时的自动质量检测。

使用方法与配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name sonarqube-7.8-branch \
  -p 9000:9000 \
  -e SONARQUBE_JDBC_URL=jdbc:postgresql://<db-host>:5432/sonar \
  -e SONARQUBE_JDBC_USERNAME=<db-username> \
  -e SONARQUBE_JDBC_PASSWORD=<db-password> \
  -v sonarqube_data:/opt/sonarqube/data \
  -v sonarqube_extensions:/opt/sonarqube/extensions \
  -v sonarqube_logs:/opt/sonarqube/logs \
  docker.xuanyuan.run/sonarqube:7.8-community-with-mc1arke-branch-plugin

Docker Compose 配置示例

yaml
version: '3'
services:
  sonarqube:
    image: docker.xuanyuan.run/sonarqube:7.8-community-with-mc1arke-branch-plugin
    container_name: sonarqube-7.8-branch
    ports:
      - "9000:9000"
    environment:
      - SONARQUBE_JDBC_URL=jdbc:postgresql://db:5432/sonar
      - SONARQUBE_JDBC_USERNAME=sonar
      - SONARQUBE_JDBC_PASSWORD=sonar
    volumes:
      - sonarqube_data:/opt/sonarqube/data
      - sonarqube_extensions:/opt/sonarqube/extensions
      - sonarqube_logs:/opt/sonarqube/logs
    depends_on:
      - db
  db:
    image: docker.xuanyuan.run/postgres:11
    container_name: sonarqube-db
    environment:
      - POSTGRES_USER=sonar
      - POSTGRES_PASSWORD=sonar
      - POSTGRES_DB=sonar
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  sonarqube_data:
  sonarqube_extensions:
  sonarqube_logs:
  postgres_data:

关键配置参数说明

分支插件使用说明

1. 启动容器后，访问http://<host>:9000，使用默认账号（admin/admin）登录。
2. 在项目配置中，启用分支分析功能（路径：项目设置 > 分支）。
3. 通过Sonar Scanner提交代码分析时，指定分支参数：sonar.branch.name=<branch-name>。
4. 在SonarQube界面中，可切换不同分支查看分析结果，对比分支间质量差异。

注意事项

• 本镜像基于SonarQube 7.8 Community版，需搭配兼容的数据库（PostgreSQL 9.6+或MySQL 5.6-8.0）。
• 首次启动时，需等待数据库初始化完成，服务可能需要1-2分钟启动。
• 生产环境建议配置持久化存储卷，避免数据丢失。