Installing the CLI

The MetalSoft CLI is a command-line tool that allows the manipulation of all Metal Cloud elements. The UI can perform most operations, but only the CLI can perform some, especially during the MetalSoft installation process, such as:

• Create users
• Install operating system templates
• Install extensions

It is also very useful for automating common tasks, so familiarization with it is worthwhile even if you carry out day-to-day activities via the UI.

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. Run the exe directly.

Build from source/go get

Alternatively, 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.

Pre-requisites checker

MetalSoft also provides a pre-requisites utility script. This helps verify that all the connectivity and performance requirements are met before starting the deployment.

For more information please visit:

• Environment Pre-requisites checker