docker-docs/_vendor/github.com/docker/scout-cli/docs/scout_policy.md

docker scout policy

Evaluate policies against an image and display the policy evaluation results (experimental)

Options

Name	Type	Default	Description
-e, --exit-code			Return exit code '2' if policies are not met, '0' otherwise
--org	string		Namespace of the Docker organization
-o, --output	string		Write the report to a file
--platform	string		Platform of image to pull policy results from
--to-env	string		Name of the environment to compare to
--to-latest			Latest image processed to compare to

Description

The docker scout policy command evaluates policies against an image. The image analysis is uploaded to Docker Scout where policies get evaluated.

The policy evaluation results may take a few minutes to become available.

Examples

Evaluate policies against an image and display the results

$ docker scout policy dockerscoutpolicy/customers-api-service:0.0.1

Evaluate policies against an image for a specific organization

$ docker scout policy dockerscoutpolicy/customers-api-service:0.0.1 --org dockerscoutpolicy

Evaluate policies against an image with a specific platform

$ docker scout policy dockerscoutpolicy/customers-api-service:0.0.1 --platform linux/amd64

Compare policy results for a repository in a specific environment

$ docker scout policy dockerscoutpolicy/customers-api-service --to-env production