gsasig/hub-load

HUB Load 镜像文档

镜像概述

HUB Load是OPS团队（joel）提供的hub_load包的容器化版本，主要用于生成大量包含版本和组件的HUB项目，适用于测试HUB系统性能、生成测试数据等场景。

核心功能与特性

• 支持通过环境变量灵活配置扫描参数
• 可自定义项目版本数量、组件数量及代码位置数量
• 支持同步/异步扫描模式
• 提供代码片段扫描功能
• 支持指定Synopsys Detect版本
• 可配置CURL安全模式

使用场景

• HUB系统性能测试与压力测试
• 生成大量测试数据用于功能验证
• 验证HUB系统在高负载下的稳定性
• 测试不同扫描配置对结果的影响

环境变量配置

容器运行时可通过以下环境变量进行配置，默认值可根据需求覆盖：

使用方法

拉取镜像

bash
docker pull docker.xuanyuan.run/gsasig/hub-load

非交互式调用

使用默认参数提交扫描

bash
docker run --rm -e BD_HUB_URL=https://testhub.blackducksoftware.com \
                 -e API_TOKEN=<the-token> \
                 docker.xuanyuan.run/gsasig/hub-load \
                 /home/hub_load/submit_scans.sh

覆盖默认参数提交扫描

bash
docker run --rm -e BD_HUB_URL=https://testhub.blackducksoftware.com \
                 -e API_TOKEN=<the-token> \
                 -e MAX_SCANS=1 \
                 docker.xuanyuan.run/gsasig/hub-load \
                 /home/hub_load/submit_scans.sh

执行后输出示例：

Processing defaults

Submitting with the following parameters:

	 BD_HUB_URL https://ip-172-31-8-206.ec2.internal
	 API_TOKEN the-token
	 MAX_SCANS 1
	 MAX_CODELOCATIONS 1
	 MAX_COMPONENTS 150
	 MAX_VERSIONS 5
	 SYNCHRONOUS_SCANS yes

Starting ...
...
Total scans submitted: 1

交互式调用

bash
docker run -it --rm -e BD_HUB_URL=https://testhub.blackducksoftware.com \
                      -e API_TOKEN=<the-token> \
                      -e MAX_SCANS=1 \
                      docker.xuanyuan.run/gsasig/hub-load
root@714cf6d9a957:/# INTERACTIVE=yes /home/hub_load/submit_scans.sh 

执行后将提示输入各参数值：

Processing defaults

Enter value for BD_HUB_URL [https://testhub.blackducksoftware.com] 
Enter value for API_TOKEN [the-token] 
Enter value for MAX_SCANS [1] 
Enter value for MAX_CODELOCATIONS [1] 
Enter value for MAX_COMPONENTS [150] 
Enter value for MAX_VERSIONS [5] 
Enter value for SYNCHRONOUS_SCANS [yes]

Submitting with the following parameters:

	 BD_HUB_URL https://testhub.blackducksoftware.com
	 API_TOKEN the-token
	 MAX_SCANS 1
	 MAX_CODELOCATIONS 1
	 MAX_COMPONENTS 150
	 MAX_VERSIONS 5
	 SYNCHRONOUS_SCANS yes

Enter value for continue [Y] 
Starting ...

从源码构建

bash
git clone https://github.com/blackducksoftware/hub-load.git
cd hub-load/src
docker build -t <容器标签> . 

注意：构建过程会下载hub-load/src/packagelist中列出的归档文件，生成的容器大小约为5GB。

版本历史

• 2023年8月14日

  • 将基础镜像更新为ubuntu:jammy
  • 将Java版本更新至17
  • 添加源代码数据以支持代码片段扫描功能
  • 增加代码片段扫描能力

• 2021年3月22日

  • 更新detect.timeout参数（旧选项已弃用）
  • 添加INSECURE_CURL选项，用于在脚本和Synopsys Detect中为curl传递--insecure参数，默认值为'no'

• 2021年3月8日

  • 添加FAIL_ON_SEVERITIES参数，可以指定策略检查的严重级别以触发失败

• 2021年1月20日

  • 添加DETECT_VERSION参数，可指定Synopsys Detect版本（注意：参数可能随版本变化，可能与submit_scans.sh传递的参数不兼容）

• 2019年10月2日

  • 从scan.cli.sh切换到Synopsys Detect
  • 更新默认值
  • 从用户名/密码切换到api_token认证
  • 增加重复使用相同组件/jar进行扫描的支持
  • 从Detect日志输出中提取耗时（秒）
  • 增加同步扫描支持
  • 替换组件/jar下载源为S3上托管的7000+个jar的集合