philipssoftware/sonar-scanner

Docker Sonar Scanner 镜像文档

镜像概述

本镜像由Philips Software提供，包含https://docs.sonarqube.org/latest/analysis/scan/sonarscanner/工具，用于代码质量和安全性分析。镜像内置多种运行环境，方便在容器中直接执行代码扫描任务，适用于开发和CI/CD流程。

核心功能与特性

• 集成Sonar Scanner：支持代码质量检测、漏洞分析等核心功能
• 多语言环境：内置Java 11、Node.js 16、Python 2和Python 3运行环境
• 版本追踪：包含REPO和TAGS文件，便于版本管理和追溯
• 灵活配置：通过sonar-project.properties文件或命令行参数自定义扫描配置

使用场景

• 开发阶段本地代码质量检查
• CI/CD流水线集成，自动化代码扫描
• 多语言项目的统一代码质量分析环境

使用方法

镜像获取

镜像托管于Docker Hub：https://hub.docker.com/r/philipssoftware/sonar-scanner/

基本使用命令

bash
docker run -v $(pwd):/root/src \
           -w /root/src \
           docker.xuanyuan.run/philipssoftware/sonar-scanner \
           sonar-scanner -Dsonar.login=<sonar登录ID> \
                         -Dsonar.host.url=<sonar服务URL>

参数说明

• -v $(pwd):/root/src：挂载当前项目目录到容器内/root/src路径
• -w /root/src：设置工作目录为项目挂载路径
• sonar.login：SonarQube服务的登录凭证
• sonar.host.url：SonarQube服务的访问地址

配置文件

扫描器会自动读取项目根目录下的sonar-project.properties文件，建议在此文件中配置项目基本信息（如项目键、名称、源代码目录等）。

镜像内容

核心组件

• Sonar Scanner
• Java 11
• Node.js 16
• Python 2.x 和 Python 3.x

特殊文件

REPO

包含构建该镜像的GitHub仓库地址及具体commit-sha：

bash
$ docker run philipssoftware/sonar-scanner cat REPO
https://github.com/philips-software/docker-sonar-scanner/tree/facb2271e5a563e5d6f65ca3f475cefac37b8b6c

TAGS

包含镜像构建时的所有相关标签，用于版本固定：

bash
$ docker run philipssoftware/sonar-scanner:4 cat TAGS
sonar-scanner sonar-scanner:4 sonar-scanner:4.7 sonar-scanner:4.7.0 sonar-scanner:4.7.0.2747

建议生产环境使用TAGS文件中最后一个最具体的标签，确保版本稳定性。

可用标签

sonar-scanner

• sonar-scanner
• sonar-scanner:4
• sonar-scanner:4.7
• sonar-scanner:4.7.0
• sonar-scanner:4.7.0.2747
  对应Dockerfile：4/Dockerfile

为什么选择本镜像

我们需要在容器中集成常用工具（如jq、aws-cli、curl等）以简化开发流程。将这些工具预安装到镜像中，避免每次使用时重复配置，提高工作效率，因此构建了自定义Docker镜像定义。

已知问题

无已知问题

问题反馈

如遇到问题，请在https://github.com/philips-software/docker-sonar-scanner/issues提交报告。

作者

• Jeroen Knoops <***>
• Gertjan Maaas <***>

许可证

MIT许可证，详见LICENSE文件

Philips Forest

本模块是Philips Forest的一部分。

                                                     ___                   _
                                                    / __\__  _ __ ___  ___| |_
                                                   / _\/ _ \| '__/ _ \/ __| __|
                                                  / / | (_) | | |  __/\__ \ |_
                                                  \/   \___/|_|  \___||___/\__|  

                                                                 Infrastructure

可在Slack的docker-images频道与forestkeepers交流。