Docker Scout 快速视图

描述镜像的快速概览
用法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 证明文件或syftjson SBOM 文件 如果sbom://prefix,如果文件未定义,则它将尝试从 standard input 中读取它。

选项

选择违约描述
--env环境名称
--ignore-suppressed根据指定的异常范围筛选在 Scout 异常中发现的 CVE
--latest最新索引镜像
--only-policy要评估的策略的逗号分隔列表
--only-vex-affected按状态不受影响的 VEX 语句筛选 CVE
--orgDocker 组织的命名空间
-o, --output将报表写入文件
--platform镜像分析平台
--ref如果提供的 tarball 包含多个引用,则使用 Reference。
只能与存档一起使用
--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  │