navneetlalg/sonarqube

这不是官方镜像。对于AMD64架构，建议优先使用hub.docker.com/_/sonarqube/

快速参考

• 问题反馈地址：[***]
• 支持架构：amd64、arm64

支持的标签及对应Dockerfile链接

• 9.2.3-community, 9.2-community, 9-community, community, latest
• 9.2.3-developer, 9.2-developer, 9-developer, developer
• 9.2.3-enterprise, 9.2-enterprise, 9-enterprise, enterprise
• 9.2.3-datacenter-app, 9.2-datacenter-app, 9-datacenter-app, datacenter-app
• 9.2.3-datacenter-search, 9.2-datacenter-search, 9-datacenter-search, datacenter-search

什么是SonarQube？

SonarQube是领先的代码质量与安全持续检查工具，可在代码审查过程中为开发团队提供指导。它支持27种编程语言，能与现有软件流水线集成，为开发人员提供清晰的问题修复指导，帮助团队交付更优质、更安全的软件。全球已有超过225,000次部署，服务于小型开发团队及大型组织，使所有团队和公司都能掌控并提升其代码质量与安全性。

如何使用此镜像

本镜像包含SonarQube的社区版、开发版、企业版和数据中心版。

Docker主机要求

由于SonarQube使用嵌入式Elasticsearch，确保Docker主机配置符合Elasticsearch生产模式要求和文件描述符配置。

例如，在Linux上，可通过以下命令（以root用户在主机上执行）为当前会话设置推荐值：

bash
sysctl -w vm.max_map_count=524288
sysctl -w fs.file-max=131072
ulimit -n 131072
ulimit -u 8192

试用SonarQube

要快速运行演示实例，请参阅试用SonarQube页面上的Docker使用方法。准备好进行更稳定的设置时，请阅读以下安装和配置部分。

安装

安装说明请参见安装服务器页面上的“从Docker镜像安装服务器”。

要使用数据中心版运行集群，请参阅集群安装服务器页面上的“从Docker镜像安装SonarQube”。

配置

数据库

默认情况下，镜像使用嵌入式H2数据库，不适用于生产环境。

警告：只有一个SonarQube实例可以连接到数据库模式。如果使用Docker Swarm或Kubernetes，确保多个SonarQube实例不会同时运行在同一数据库模式上。这会导致SonarQube行为不可预测且数据损坏。在SONAR-***解决前，没有防护措施。数据中心版也有相同限制，即同一时间只有一个集群可以连接到一个数据库模式。

按照[***]

使用卷

建议为以下目录创建卷：

• /opt/sonarqube/data：数据文件，如嵌入式H2数据库和Elasticsearch索引
• /opt/sonarqube/logs：包含SonarQube访问日志、Web进程日志、CE进程日志、Elasticsearch日志
• /opt/sonarqube/extensions：用于第三方插件

警告：不能在多个SonarQube实例上使用相同的卷。

升级

升级说明请参见升级服务器页面上的“从Docker镜像升级”。

高级配置

自定义镜像

在某些环境中，准备包含自定义配置的镜像可能更合理。实现此目的的Dockerfile可简单如下：

Dockerfile
FROM sonarqube:8.9-community
COPY sonar-custom-plugin-1.0.jar /opt/sonarqube/extensions/

然后可以通过以下命令构建并试用该镜像：

bash
$ docker build --tag=sonarqube-custom .
$ docker run -ti sonarqube-custom

避免SonarQube硬终止

SonarQube实例会优雅停止，等待所有进行中的任务完成。等待进行中任务完成可能需要较长时间，而Docker默认停止容器时不会等待这么久。为避免SonarQube实例在10秒后被Docker守护进程终止，最好使用--stop-timeout配置容器停止超时时间。例如：

bash
docker run --stop-timeout 3600 sonarqube

管理

管理指南可在此处找到。

许可证

SonarQube社区版基于GNU Lesser General Public License, Version 3.0许可。SonarQube开发版、企业版和数据中心版基于SonarSource条款与条件许可。

与所有Docker镜像一样，这些镜像可能还包含其他软件，这些软件可能受其他许可证约束（如基础发行版中的Bash等，以及主要软件的任何直接或间接依赖项）。

一些能够自动检测到的额外许可信息可在https://github.com/docker-library/repo-info/tree/master/repos/sonarqube%E4%B8%AD%E6%89%BE%E5%88%B0%E3%80%82

对于任何预构建镜像的使用，镜像用户有责任确保对该镜像的任何使用都符合其中包含的所有软件的相关许可证。