docker 侦察机 sbom

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

描述

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

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

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

支持以下工件类型：

  • 图片
  • OCI 布局目录
  • Tarball 档案，由以下人员创建docker save
  • 本地目录或文件

默认情况下，该工具需要图像参考，例如：

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

如果您要分析的工件是 OCI 目录、tarball 存档、本地文件或目录，或者如果您想控制解析图像的位置，则必须在引用中添加以下前缀之一：

  • image://（默认）使用本地映像，或回退到注册表查找
  • local://使用本地图像存储中的图像（不进行注册表查找）
  • registry://使用注册表中的映像（不要使用本地映像）
  • oci-dir://使用 OCI 布局目录
  • archive://使用 tarball 存档，由以下人员创建docker save
  • fs://使用本地目录或文件

选项

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

例子

显示包列表

$ 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