philipssoftware/blackduck

Philips Blackduck Docker镜像

镜像概述和主要用途

本镜像由Philips Software维护，包含Blackduck安全扫描工具及多种编程语言环境，旨在提供便捷的依赖安全扫描解决方案。通过集成Blackduck Detect工具，支持对源代码和Docker镜像进行依赖分析、漏洞检测及策略合规性检查，适用于开发和CI/CD流程中的安全检测环节。

核心功能和特性

• 多版本支持：提供Blackduck 7和8两个主要版本
• 多语言环境：包含Java、Node.js、Python、Golang及多个.NET Core版本（2.2.110、3.0.101、3.1.102、3.1.302等）
• 扫描能力：支持源代码扫描和Docker镜像扫描
• Air Gap模式：支持离线运行模式，无需互联网连接即可下载依赖
• 版本追踪：包含REPO和TAGS文件，用于追踪镜像构建版本和标签信息

支持的镜像版本和标签

当前可用版本及目录结构：

.
├── 7
│   ├── golang
│   ├── java
│   ├── node
│   ├── python
│   ├── dotnetcore-2.2.110
│   ├── dotnetcore-3.0.101
│   ├── dotnetcore-3.1.102
│   └── dotnetcore-3.1.302
├── 8
│   ├── golang
│   ├── java
│   ├── node
│   ├── python
│   ├── dotnetcore-2.2.110
│   ├── dotnetcore-3.0.101
│   ├── dotnetcore-3.1.102
│   └── dotnetcore-3.1.302

主要标签说明

• 基础镜像：blackduck、blackduck:7、blackduck:7.14、blackduck:7.14.0（基于Java环境）
• Node.js环境：blackduck:node、blackduck:7-node、blackduck:7.14-node、blackduck:7.14.0-node
• Python环境：blackduck:python、blackduck:7-python、blackduck:7.14-python、blackduck:7.14.0-python
• Golang环境：blackduck:golang、blackduck:7-golang、blackduck:7.14-golang、blackduck:7.14.0-golang
• .NET Core环境：
  • blackduck:dotnetcore-2.2.110、blackduck:7-dotnetcore-2.2等
  • blackduck:dotnetcore-3.0.101、blackduck:7.14-dotnetcore-3.0等
  • blackduck:dotnetcore-3.1.102、blackduck:7.14.0-dotnetcore-3.1.102等
  • blackduck:dotnetcore、blackduck:7-dotnetcore等（基于3.1.302版本）
• Docker扫描专用：blackduck:docker、blackduck:7-docker、blackduck:7.14-docker、blackduck:7.14.0-docker

注意：Blackduck 8.x版本已提供，但因部分常用参数已弃用，暂未设为latest标签。

使用方法和配置说明

镜像获取

镜像可从Docker Hub获取：https://hub.docker.com/r/philipssoftware/blackduck/

基本使用

查看帮助信息：

bash
docker run docker.xuanyuan.run/philipssoftware/blackduck:7 /app/detect.sh --help
docker run docker.xuanyuan.run/philipssoftware/blackduck:7 /app/detect.sh -hv

源代码扫描

将本地代码目录挂载到容器中，执行扫描：

bash
docker run -v $(pwd):/code docker.xuanyuan.run/philipssoftware/blackduck:7 /app/detect.sh \
  --blackduck.url=<your-blackduck-url> \  # Blackduck服务器URL
  --blackduck.api.token=<your-token> \    # Blackduck API令牌
  --detect.policy.check=true \            # 启用策略检查
  --detect.source.path=/code \            # 源代码路径（容器内路径）
  --detect.project.name=<your-project-name> \  # 项目名称
  --detect.project.version.name=<your-version>  # 项目版本

替换所有<your-xxxxx>为实际参数值。

Docker镜像扫描

共享Docker挂载方式

bash
docker run -v /var/run/docker.sock:/var/run/docker.sock --network="host" docker.xuanyuan.run/philipssoftware/blackduck:7-docker \
  /app/detect.sh --blackduck.url=<your-blackduck-url> --blackduck.api.token=<your-token> --detect.policy.check=true \
  --detect.project.name=<your-project-name> --detect.project.version.name=<your-version> --detect.docker.image=<your-image>

指定工作目录方式

bash
mkdir $(pwd)/shared  # 创建共享目录
docker run -v /var/run/docker.sock:/var/run/docker.sock -v $(pwd):$(pwd) --network="host" -w $(pwd) docker.xuanyuan.run/philipssoftware/blackduck:7-docker \
  /airgap/packaged-inspectors/docker/blackduck-docker-inspector.sh --blackduck.url=<your-blackduck-url> --blackduck.api.token=<your-token> \
  --detect.policy.check=true --detect.project.name=<your-project-name> --detect.project.version.name=<your-version> \
  --detect.docker.image=<your-image> --shared.dir.path.local=$(pwd)/shared  # 指定共享目录路径

Air Gap模式（离线运行）

通过设置环境变量DETECT_AIR_GAP=true启用离线模式，适用于无互联网访问环境（当前仅支持gradle检查器）：

bash
docker run -e DETECT_AIR_GAP=true -v $(pwd):/code docker.xuanyuan.run/philipssoftware/blackduck:6 /app/detect.sh \
  --blackduck.url=<your-blackduck-url> \
  --blackduck.api.token=<your-token> \
  --blackduck.trust.cert=true \  # 信任自签名证书（如需要）
  --detect.policy.check=true \
  --detect.source.path=/code \
  --detect.project.name=<your-project-name> \
  --detect.project.version.name=<your-version>

镜像内容说明

除Blackduck和Java 8外，镜像还包含以下文件：

REPO文件

记录镜像构建对应的GitHub仓库及提交SHA：

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

TAGS文件

记录镜像创建时的所有相关标签，用于版本固定：

bash
$ docker run philipssoftware/blackduck:6 cat TAGS
blackduck blackduck:6 blackduck:6.7 blackduck:6.7.0

生产环境中可使用此文件中的最具体标签（最后一个）固定镜像版本。

已知问题

• 当前基础镜像仅包含Java环境，使用yarn或npm的项目可能无法正常运行（需使用带Node.js环境的标签，如blackduck:node）。

问题反馈

如有问题，请在https://github.com/philips-software/docker-blackduck/issues提交。

许可证

本项目采用MIT许可证，详见LICENSE文件。