docker scout quickview

描述镜像快速概览
用法docker scout quickview [IMAGE|DIRECTORY|ARCHIVE]
别名
docker scout qv

描述

docker scout quickview 命令显示镜像的快速概览。它会显示指定镜像中的漏洞摘要以及来自基础镜像的漏洞。如果可用,还会显示基础镜像刷新和更新建议。

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

支持以下制品类型

  • 镜像
  • 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:// 使用本地目录或文件
  • sbom:// SPDX 文件或带有 SPDX 谓词的 in-toto 证明文件,或 syft json SBOM 文件。如果使用 sbom:// 前缀且未定义文件,则将尝试从标准输入读取。

选项

选项默认值描述
--env环境名称
--ignore-suppressed根据指定的例外范围过滤在 Scout 例外中找到的 CVE
--latest最新的已索引镜像
--only-policy逗号分隔的要评估的策略列表
--only-vex-affected根据状态为 "不受影响" 的 VEX 语句过滤 CVE
--orgDocker 组织的命名空间
-o, --output将报告写入文件
--platform要分析的镜像平台
--ref如果提供的 tarball 包含多个引用,则使用的引用。
只能与 archive 一起使用
--vex-author接受的 VEX 声明作者列表
--vex-location包含 VEX 声明的目录或文件的文件位置

示例

镜像快速概览

$ docker scout quickview golang:1.19.4
    ...Pulling
    ✓ Pulled
    ✓ SBOM of image already cached, 278 packages indexed

  Your image  golang:1.19.4                          │    5C     3H     6M    63L
  Base image  buildpack-deps:bullseye-scm            │    5C     1H     3M    48L     6?
  Refreshed base image  buildpack-deps:bullseye-scm  │    0C     0H     0M    42L
                                                     │    -5     -1     -3     -6     -6
  Updated base image  buildpack-deps:sid-scm         │    0C     0H     1M    29L
                                                     │    -5     -1     -2    -19     -6

最近构建镜像的快速概览

$ docker scout qv

来自 SPDX 文件的快速概览

$  syft -o spdx-json alpine:3.16.1 | docker scout quickview sbom://
 ✔ Loaded image                                                                                                                              alpine:3.16.1
 ✔ Parsed image                                                                    sha256:3d81c46cd8756ddb6db9ec36fa06a6fb71c287fb265232ba516739dc67a5f07d
 ✔ Cataloged contents                                                                     274a317d88b54f9e67799244a1250cad3fe7080f45249fa9167d1f871218d35f
   ├── ✔ Packages                        [14 packages]
   ├── ✔ File digests                    [75 files]
   ├── ✔ File metadata                   [75 locations]
   └── ✔ Executables                     [16 executables]

  Target   │ <stdin>        │    1C     2H     8M     0L
    digest │  274a317d88b5  │