Skip to content

Files

Latest commit

 

History

History
71 lines (50 loc) · 3.07 KB

scout_recommendations.md

File metadata and controls

71 lines (50 loc) · 3.07 KB

docker scout recommendations

Display available base image updates and remediation recommendations

Options

Name Type Default Description
--only-refresh Only display base image refresh recommendations
--only-update Only display base image update recommendations
--org string Namespace of the Docker organization
-o, --output string Write the report to a file
--platform string Platform of image to analyze
--ref string Reference to use if the provided tarball contains multiple references.
Can only be used with archive
--tag string Specify tag

Description

The docker scout recommendations command display recommendations for base images updates. It analyzes the image and display recommendations to refresh or update the base image. For each recommendation it shows a list of benefits, such as fewer vulnerabilities or smaller image size.

If no image is specified, the most recently built image is used.

The following artifact types are supported:

  • Images
  • OCI layout directories
  • Tarball archives, as created by docker save
  • Local directory or file

By default, the tool expects an image reference, such as:

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

If the artifact you want to analyze is an OCI directory, a tarball archive, a local file or directory, or if you want to control from where the image will be resolved, you must prefix the reference with one of the following:

  • image:// (default) use a local image, or fall back to a registry lookup
  • local:// use an image from the local image store (don't do a registry lookup)
  • registry:// use an image from a registry (don't use a local image)
  • oci-dir:// use an OCI layout directory
  • archive:// use a tarball archive, as created by docker save
  • fs:// use a local directory or file

Examples

Display base image update recommendations

$ docker scout recommendations golang:1.19.4

Display base image refresh only recommendations

$ docker scout recommendations --only-refresh golang:1.19.4

Display base image update only recommendations

$ docker scout recommendations --only-update golang:1.19.4