Skip to main content

Anchore Service CLI

Project description

Overview

The Anchore CLI provides a command line interface on top of the Anchore Engine REST API.

Using the Anchore CLI users can manage and inspect images, policies, subscriptions and registries.

Installing Anchore CLI from source

The Anchore CLI can be installed from source using the Python pip utility

git clone https://github.com/anchore/anchore-cli
cd anchore-cli
pip install --user --upgrade .

Or can be installed from the installed form source from the Python PyPI package repository.

Installing Anchore CLI on CentOS and Red Hat Enterprise Linux

yum install epel-release
yum install python-pip
pip install anchorecli

Installing Anchore CLI on Debian and Ubuntu

apt-get update
apt-get install python-pip
pip install anchorecli

Installing Anchore CLI on Mac OS / OS X

Use Python’s pip package manager:

sudo easy_install pip
pip install --user anchorecli
export PATH=${PATH}:${HOME}/Library/Python/2.7/bin

To ensure anchore-cli is readily available in subsequent terminal sessions, remember to add that last line to your shell profile (.bash_profile or equivalent).

To update anchore-cli later:

pip install --user --upgrade anchorecli

Configuring the Anchore CLI

By default the Anchore CLI will try to connect to the Anchore Engine at http://localhost/v1 with no authentication. The username, password and URL for the server can be passed to the Anchore CLI as command line arguments.

--u   TEXT   Username     eg. admin
--p   TEXT   Password     eg. foobar
--url TEXT   Service URL  eg. http://localhost:8228/v1

Rather than passing these parameters for every call to the cli they can be stores as environment variables.

ANCHORE_CLI_URL=http://myserver.example.com:8228/v1
ANCHORE_CLI_USER=admin
ANCHORE_CLI_PASS=foobar

Command line examples

Add an image to the Anchore Engine

anchore-cli image add docker.io/library/debian:latest

List images analyzed by the Anchore Engine

anchore-cli image list

Get a specific image and see when its status goes to analyzed

anchore-cli image get docker.io/library/debian:latest

Perform a vulnerability scan on an image

anchore-cli image vuln docker.io/library/debian:latest os

List operating system packages present in an image

anchore-cli image content docker.io/library/debian:latest os

Subscribe to receive webhook notifications when new CVEs are added to an update

anchore-cli subscription activate vuln_update docker.io/library/debian:latest

More Information

For further details on use of the Anchore CLI with the Anchore Engine please refer to the Anchore Engine Wiki

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

anchorecli-0.1.3.tar.gz (19.0 kB view details)

Uploaded Source

Built Distribution

anchorecli-0.1.3-py2-none-any.whl (21.1 kB view details)

Uploaded Python 2

File details

Details for the file anchorecli-0.1.3.tar.gz.

File metadata

  • Download URL: anchorecli-0.1.3.tar.gz
  • Upload date:
  • Size: 19.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for anchorecli-0.1.3.tar.gz
Algorithm Hash digest
SHA256 9a898fb75194d65699883c741ca7f38934d8ddb1a30ea1ce15db0e02ec9d116f
MD5 1b5764cd24fd4f6a999731cffacd7604
BLAKE2b-256 aa94d129299248b4b22a63df819fd981fbc8aced6cd7f3bb21b540cce39dc31e

See more details on using hashes here.

File details

Details for the file anchorecli-0.1.3-py2-none-any.whl.

File metadata

File hashes

Hashes for anchorecli-0.1.3-py2-none-any.whl
Algorithm Hash digest
SHA256 d8455543a057bb69b6851c41c7d24663f813d02ef9007780ff8b205c830c2b7c
MD5 c4bc04bbe08480b1bfe416bd5d2ba326
BLAKE2b-256 fb50b930c24eeac59a4bda6322dcbe47c9039b5745969ff8da3e2b85e52dc8c5

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page