nexus-iq-cli

Nexus Iq Cli Docker 镜像

该Docker镜像封装Sonatype IQ CLI,用于对挂载工作区中的文件执行组件智能评估。

5 次收藏下载次数: 0状态:社区镜像维护者:sonatype仓库类型:镜像最近更新:
下载命令
点击查看

nexus-iq-cli Docker镜像文档

镜像概述和主要用途

nexus-iq-cli是基于Sonatype IQ CLI的Docker镜像,用于对挂载工作区中的文件执行组件智能评估。该镜像通过与Sonatype IQ Server交互,实现组件策略合规性检查,并生成评估报告。主要用途包括组件安全扫描、策略评估及合规性验证,支持集成到CI/CD流程中实现自动化检查。

核心功能和特性

  • 对指定文件或目录进行组件智能评估
  • 支持Docker镜像扫描(本地镜像、公共/私有仓库镜像)
  • 收集Git版本信息(提交哈希、仓库URL)并发送至IQ Server
  • 生成机器可读的JSON格式评估结果
  • 多阶段分析支持(develop、source、build等阶段)
  • 可配置的策略评估失败条件(如警告触发失败)
  • 支持代理服务器配置及认证

使用场景和适用范围

  • 开发阶段组件安全扫描与策略验证
  • CI/CD流水线集成,自动化组件合规检查
  • Docker镜像发布前安全评估
  • 多环境(开发、构建、发布)组件策略评估
  • 应用部署前组件合规性验证
  • 第三方依赖组件风险评估

详细使用方法和配置说明

基本使用方式

bash
docker run docker.xuanyuan.run/sonatype/nexus-iq-cli /sonatype/evaluate [选项] <待扫描文件或目录>

Docker Run示例

扫描本地文件目录

将主机mycontent目录挂载为容器/target,评估结果输出到主机myresults目录:

bash
docker run -v mycontent:/target -v myresults:/sonatype/reports docker.xuanyuan.run/sonatype/nexus-iq-cli /sonatype/evaluate \
  -s https://iq.myCompany.com \
  -a user:password \
  -i WEBAPP \
  /target/our-web-app.war

含空格路径处理

若目标路径包含空格,需使用单引号包裹并转义空格:

bash
docker run ... '/target\ folder/our-web-app.war'

参数说明

必选参数

选项描述示例
-s, --server-url <http[s]://...>IQ Server的URL地址-s https://iq.example.com
-a, --authentication <username:password>IQ Server认证凭据-a admin:password123
-i, --application-id <app ID>IQ Server上的应用公开ID-i MY-WEB-APP

可选参数

选项描述默认值示例
-t, --stage <stage>分析阶段,可选值:develop、source、build、stage-release、release、operatebuild-t release
-O, --organization-id <organization ID>IQ Server组织ID(用于自动创建应用)无-O ORG123
-r, --result-file </path/to/file.json>策略评估结果JSON文件路径无-r /sonatype/reports/result.json
-w, --fail-on-policy-warnings策略警告时触发失败false-w
-e, --ignore-system-errors忽略系统错误(IO、网络等)false-e
-E, --ignore-scanning-errors忽略扫描错误(损坏文件等)false-E
-p, --proxy <host[:port]>代理服务器地址无-p proxy.example.com:8080
-U, --proxy-user <username:password>代理服务器认证凭据无-U proxyuser:proxypass
-X, --debug启用调试日志(可能泄露敏感信息)false-X
-h, --help显示帮助信息false-h
-ra, --reachability运行可达性分析无-ra
-rn, --reachability-namespaces <namespace>指定可达性分析命名空间(可多次指定)无-rn com.example -rn org.springframework

Git信息收集

通过设置GIT_DIR环境变量,可收集Git信息(提交哈希、仓库URL)并发送至IQ Server。需确保挂载的工作区包含.git目录。

示例:

bash
docker run --env GIT_DIR=/target/.git -v $(pwd):/target docker.xuanyuan.run/sonatype/nexus-iq-cli /sonatype/evaluate \
  -s https://iq.myCompany.com \
  -a user:password \
  -i iq-application \
  '/target/**/*.jar'

Docker镜像扫描

支持扫描本地Docker镜像或远程仓库镜像(公共/私有),需挂载Docker守护进程套接字(/var/run/docker.sock)。

环境变量

环境变量描述适用场景
NEXUS_CONTAINER_IMAGE_REGISTRY_USER私有镜像仓库用户名扫描私有仓库镜像时
NEXUS_CONTAINER_IMAGE_REGISTRY_PASSWORD私有镜像仓库密码扫描私有仓库镜像时

扫描示例

扫描本地Docker镜像

bash
docker run --rm \
  -v ~/sonatype/reports:/sonatype/reports \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker.xuanyuan.run/sonatype/nexus-iq-cli /sonatype/evaluate \
  -s https://iq.server \
  -a user:password \
  -i app-name \
  container:alpine:3.6

扫描远程私有镜像

bash
docker run --rm \
  -v ~/sonatype/reports:/sonatype/reports \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e NEXUS_CONTAINER_IMAGE_REGISTRY_USER=registry-user \
  -e NEXUS_CONTAINER_IMAGE_REGISTRY_PASSWORD=registry-pass \
  docker.xuanyuan.run/sonatype/nexus-iq-cli /sonatype/evaluate \
  -s https://iq.server \
  -a user:password \
  -i app-name \
  container:https://registry.example.com/private/alpine:3.6

旧版本兼容性(1.183.0及更早)

需额外挂载/tmp目录:

bash
docker run --rm \
  -v ~/sonatype/reports:/sonatype/reports \
  -v /tmp:/tmp \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker.xuanyuan.run/sonatype/nexus-iq-cli /sonatype/evaluate \
  -s https://iq.server \
  -a user:password \
  -i app-name \
  container:alpine:3.6

自定义挂载路径可通过NEXUS_CONTAINER_SCANNING_MOUNT_PATH环境变量配置:

bash
docker run --rm \
  -e NEXUS_CONTAINER_SCANNING_MOUNT_PATH=/custom/tmp \
  -v /custom/tmp:/custom/tmp \
  ...

注意:Docker镜像扫描功能暂不支持Windows系统。

发布说明

  • nexus-iq-cli Docker镜像完整发布说明:链接
  • Sonatype IQ Server完整发布说明:链接

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 nexus-iq-cli 镜像标签

docker pull docker.xuanyuan.run/sonatype/nexus-iq-cli:<标签>

DockerHub 原生拉取命令

docker pull sonatype/nexus-iq-cli:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告