docker scout quickview

描述映象快速概覽
用法docker scout quickview [IMAGE|DIRECTORY|ARCHIVE]
別名
docker scout qv

描述

docker scout quickview 命令顯示映象的快速概覽。它顯示指定映象中的漏洞摘要以及基礎映象中的漏洞。如果可用,它還會顯示基礎映象重新整理和更新建議。

如果未指定映象,則使用最近構建的映象。

支援以下工件型別:

  • 映象
  • OCI 佈局目錄
  • docker save 建立的 Tarball 存檔
  • 本地目錄或檔案

預設情況下,該工具需要一個映象引用,例如:

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

如果您要分析的工件是 OCI 目錄、tarball 存檔、本地檔案或目錄,或者如果您想控制映象的解析來源,則必須在引用前加上以下字首之一:

  • image:// (預設)使用本地映象,或回退到登錄檔查詢
  • local:// 使用本地映象儲存中的映象(不進行登錄檔查詢)
  • registry:// 使用登錄檔中的映象(不使用本地映象)
  • oci-dir:// 使用 OCI 佈局目錄
  • archive:// 使用由 docker save 建立的 tarball 存檔
  • 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  │