docker scout sbom

描述生成或显示镜像的 SBOM
用法docker scout sbom [IMAGE|DIRECTORY|ARCHIVE]

描述

docker scout sbom 命令用于分析软件工件以生成软件物料清单 (SBOM)。

SBOM 包含镜像中所有包的列表。您可以使用 --format 标志过滤命令的输出，仅显示特定类型的包。

如果未指定镜像，则使用最近构建的镜像。

支持以下工件类型：

  • 镜像
  • OCI layout 目录
  • Tarball 档案，由 docker save 创建
  • 本地目录或文件

默认情况下，该工具需要一个镜像引用，例如：

  • redis
  • curlimages/curl:7.87.0
  • mcr.microsoft.com/dotnet/runtime:7.0

如果您要分析的工件是 OCI 目录、tarball 档案、本地文件或目录，或者如果您想控制从何处解析镜像，则必须在引用前加上以下前缀之一：

  • image:// (默认) 使用本地镜像，或回退到注册表查找
  • local:// 使用本地镜像存储中的镜像 (不进行注册表查找)
  • registry:// 使用注册表中的镜像 (不使用本地镜像)
  • oci-dir:// 使用 OCI layout 目录
  • archive:// 使用 tarball 档案，由 docker save 创建
  • fs:// 使用本地目录或文件

选项

选项默认值描述
--formatjson输出格式
- list: 镜像的包列表
- json: SBOM 的 json 表示
- spdx: SBOM 的 spdx 表示
- cyclonedx: SBOM 的 cyclone dx 表示
--only-package-type逗号分隔的包类型列表（如 apk, deb, rpm, npm, pypi, golang 等）
只能与 --format list 一起使用
-o, --output将报告写入文件
--platform要分析的镜像平台
--ref如果提供的 tarball 包含多个引用，则使用的引用。
只能与 archive 一起使用

示例

显示包列表

$ docker scout sbom --format list alpine

仅显示特定类型的包

 $ docker scout sbom --format list --only-package-type apk alpine

以 JSON 格式显示完整的 SBOM

$ docker scout sbom alpine

显示最近构建的镜像的完整 SBOM

$ docker scout sbom

将 SBOM 写入文件

$ docker scout sbom --output alpine.sbom alpine