Using the CLI

This tool allows the manipulation of all Metal Cloud elements via the command line.

Installation

Download the latest release for your operating system.

Mac OS X

brew tap metalsoft-io/homebrew-repo
brew install metalcloud-cli

CentOS/Redhat Linux distribution

Use the latest release for your platform https://github.com/metalsoft-io/metalcloud-cli/releases/latest

sudo yum install $(curl -s https://api.github.com/repos/metalsoft-io/metalcloud-cli/releases/latest | grep -i browser_download_url | grep "amd64" | grep -i linux | grep rpm | head -n 1 | cut -d'"' -f4)

Debian/Ubuntu distributions

curl -skL $(curl -s https://api.github.com/repos/metalsoft-io/metalcloud-cli/releases/latest | grep -i browser_download_url  | grep "$(dpkg --print-architecture)" | grep deb | head -n 1 | cut -d'"' -f4) -o metalcloud-cli.deb && sudo dpkg -i metalcloud-cli.deb

Windows

Binaries are available here. Simply run the exe directly.

Build from source/go get

You can also use go get, on any platform where golang is installed to retrieve the latest executable:

go get github.com/metalsoft-io/metalcloud-cli

Retrieving the API key and endpoint and configuring the environment variables

1. In the MetalSoft Web UI click on the user icon at the top right corner. Then go to API credentials → APY key

• Copy the api key. Its format should be <number>:<letters>.
• Copy the endpoint. Its format should be https://api.environment.hostname.

2. Configure credentials as environment variables (for Windows, use SET rather than export).

export METALCLOUD_API_KEY="your key" # example value: "1:e5fa44f2b31c1fb553b6021e7360d07d5d91ff5e"
export METALCLOUD_ENDPOINT="your api endpoint" # example value: "https://api.demo.metalsoft.io"
export METALCLOUD_INSECURE_SKIP_VERIFY=false #defaults to false

Getting a list of supported commands

Use metalcloud-cli help for a list of supported commands.

To see the complete documentation for the CLI visit:

• Metalcloud CLI Documentation