This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Deploying AnchoreCTL

In this section you will learn how to deploy and configure AnchoreCTL, the Anchore Enterprise Command Line Interface.

AnchoreCTL is published as a simple binary available for download either from your Anchore Enterprise deployment or Anchore’s release site.

Using AnchoreCTL, you can manage and inspect all aspects of your Anchore Enterprise deployments, either as a manual human-readable configuration/instrumentation/control tool or as a CLI that is designed to be used in scripted environments such as CI/CD and other automation environments.

Installation

AnchoreCTL’s major and minor release version coincides with the release version of Anchore Enterprise, however patch versions may differ. For example,

  • Enterprise v5.21.0
  • AnchoreCTL v5.21.0

Important: AnchoreCTL should be version-aligned with Anchore Enterprise for major/minor releases. Please refer to the Enterprise Release Notes for the supported version of AnchoreCTL.

MacOS / Linux

Download a local (from your Anchore deployment) or remote (from Anchore servers) version without installation:

Linux Intel/AMD64 [Local]

curl -X GET "https://my-anchore.example.com/v2/system/anchorectl?operating_system=linux&architecture=amd64" -H "accept: */*" | tar -zx anchorectl

[Remote]

curl -o anchorectl.tar.gz https://anchorectl-releases.anchore.io/anchorectl/v5.21.0/anchorectl_5.21.0_linux_amd64.tar.gz

MacOS Intel/AMD64 [Local]

curl -X GET "https://my-anchore.example.com/v2/system/anchorectl?operating_system=darwin&architecture=amd64" -H "accept: */*"

[Remote]

curl -o anchorectl.tar.gz https://anchorectl-releases.anchore.io/anchorectl/v5.21.0/anchorectl_5.21.0_darwin_amd64.tar.gz

MacOS ARM/M-Series [Local]

curl -X GET "https://my-anchore.example.com/v2/system/anchorectl?operating_system=darwin&architecture=arm64" -H "accept: */*"

[Remote]

curl -o anchorectl.tar.gz https://anchorectl-releases.anchore.io/anchorectl/v5.21.0/anchorectl_5.21.0_darwin_arm64.tar.gz

Windows

For windows, you must specify the version of AnchoreCTL to download if using a script. [Local]

curl -X GET "https://my-anchore.example.com/v2/system/anchorectl?operating_system=windows&architecture=amd64" -H "accept: */*"

[Remote]

curl -o anchorectl.zip https://anchorectl-releases.anchore.io/anchorectl/v5.21.0/anchorectl_5.21.0_windows_amd64.zip

Installing a specific AnchoreCTL version

Replace <DESTINATION_DIR> with /usr/local/bin (for example)

curl -sSfL  https://anchorectl-releases.anchore.io/anchorectl/install.sh  | sh -s -- -b <DESTINATION_DIR> v5.21.0

Configuration

Once AnchoreCTL has been installed, learn about AnchoreCTL Configuration.