General usage

Granted Docker is installed on your machine, download Meterian convenience script docker-scan.sh.

Render the script executable and simply invoke a one-time analysis of any given Docker image by executing docker-scan.sh (the target image must be already pulled on you machine)

$ ./docker-scan.sh redis:latest

Following this invocation the analysis kicks off and a link to the final results is displayed right at the end. Here is a sample:

Meterian Docker Scanner v1.1.3, build e9ca5c9-260
© 2017-2022 Meterian Ltd - All rights reserved

Account: "Meterian Team Account"
- Minimum scores:  
  - security:  90
  - stability: 90
  - licensing: 90

Project information:
- url:    docker:redis
- branch: latest
- commit: 495732ba570db6a3626370a1fb949e98273a13d41eb3e26f7ecb1f6e31ad4041

Scanning image: redis:latest

Preparing 3 scanners to the task...
Scanning - completed 1 out of 3 scans...
Scanning - completed 2 out of 3 scans...
Scanning - completed 3 out of 3 scans...
Merging results from 3 scanners...
Image scan was successful!

Analysing packages on Meterian...
Analysing vulnerabilities on Meterian...
Analysis completed!

Final results: 
- security:	0	(minimum: 95)
- stability:	97	(minimum: 95)
- licensing:	100	(minimum: 95)

Full report available at: 
https://www.meterian.com/projects/?pid=77621462-b218-4295-b15c-830467f554ef&branch=latest

Build unsuccessful!
Failed checks: [security]

Analyses need to be authenticated hence you will need to provide a valid token through the environment variable METERIAN_API_TOKEN to execute one.

The script essentially runs the official container scanner Docker image meterian/cs-engine:latest taking care of essential volume maps and environment variables presets for you.

Through Docker, the script will ensure to pull the latest version of container scanner image for you if it is not already pulled on your system. Subsequent invocations of the script will not ensure this. Newer versions of the image should be pulled with the docker pull command

$ docker pull meterian/cs-engine:latest

Operational flags and overrides

The Meterian docker-scan script allows to provide different levels of verbosity of the output prompts seen above. Invoke the script with the flag

• --info for additional information logs to be displayed

• --debug for complete debug logs to be displayed

Operational overrides are available through the environment variables

Name	Description
DSE_SCAN_TIMEOUT_MINUTES	Set this variable to override the time limit for single image scans. The default time limit is 10 minutes
METERIAN_ENV	For on-premises instances of Meterian set this variable to target the right subdomain of the site where your instance runs
METERIAN_PROTO	For on-premises instances of Meterian set this variable to target the right HTTP protocol of the site where your instance runs
METERIAN_DOMAIN	For on-premises instances of Meterian set this variable to target the right domain of the site where your instance runs