切换语言

Docker Scout SBOM

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

描述

该命令分析软件工件以生成 软件物料清单 （SBOM）。docker scout 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输出格式：
- 列表：镜像
的包列表- json：SBOM 的 json 表示-
spdx：SBOM 的 spdx 表示-
cyclonedx：SBOM 的旋风 dx 表示
--only-package-type以逗号分隔的包类型列表（如 apk、deb、rpm、npm、pypi、golang 等）
只能与 --format list 一起使用
-o, --output将报表写入文件
--platform镜像分析平台
--ref如果提供的 tarball 包含多个引用，则使用 Reference。
只能与存档一起使用

例子

显示包列表

$ 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