johnz216/sonarqube

SonarQube with LDAP and Custom Plugins 镜像文档

镜像概述

本镜像提供预配置的SonarQube环境，集成LDAP认证功能并支持自定义插件，旨在简化企业级代码质量分析平台的部署流程，实现集中化用户认证与代码质量监控。

核心功能与特性

• LDAP认证集成：通过环境变量配置，支持与LDAP服务器对接，实现用户身份统一管理
• 自定义插件支持：允许集成第三方或自定义SonarQube插件，扩展代码分析能力
• 环境变量配置：通过环境变量灵活配置LDAP连接参数，无需修改配置文件
• 即开即用：预配置基础环境，减少部署复杂度

使用场景与适用范围

• 企业内部代码质量监控平台，需与公司LDAP/Active Directory集成实现用户认证
• 需要扩展SonarQube功能的团队（如添加特定语言分析插件、安全规则插件等）
• 快速部署SonarQube实例进行代码质量评估与持续集成流程集成

使用方法与配置说明

环境变量配置

以下环境变量用于配置LDAP连接及基础参数：

Docker部署示例

1. 使用docker run命令部署

bash
docker run -d \
  -p 9000:9000 \
  -e LDAP_URL=ldap://ldap.example.com \
  -e LDAP_PORT=389 \
  -e LDAP_BIND_DN=cn=sonarqube,dc=example,dc=com \
  -e LDAP_BASE_DN=dc=example,dc=com \
  -e LDAP_PASSWORD=example_password \
  -e DOMAIN_NAME=example.com \
  -e LDAP_GROUP_BASE_DN=ou=sonar-users,dc=example,dc=com \
  --name sonarqube-ldap \
  [镜像名称]

2. 使用docker-compose部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  sonarqube:
    image: [镜像名称]
    ports:
      - "9000:9000"
    environment:
      - LDAP_URL=ldap://ldap.example.com
      - LDAP_PORT=389
      - LDAP_BIND_DN=cn=sonarqube,dc=example,dc=com
      - LDAP_BASE_DN=dc=example,dc=com
      - LDAP_PASSWORD=example_password
      - DOMAIN_NAME=example.com
      - LDAP_GROUP_BASE_DN=ou=sonar-users,dc=example,dc=com
    restart: always
    container_name: sonarqube-ldap

启动服务：

bash
docker-compose up -d

访问与验证

部署完成后，通过http://localhost:9000访问SonarQube界面，使用LDAP用户凭证登录，验证认证功能是否正常。