Getting started

Getting started

Atlas Cloud gives you virtual machines, networks, object storage, and managed Kubernetes in the is1 zone. You can drive it from the web console or from the command line. This page sets up the command-line path.

Prerequisites

• An Atlas Cloud account. Sign up here.
• API credentials (an API key and a secret key). See API Credentials to generate them.

Command-line tool (cmk)

Atlas Cloud runs on Apache CloudStack, and the official command-line client is CloudMonkey (cmk). Source and releases are at github.com/apache/cloudstack-cloudmonkey.

Install

Download the 6.5.0 binary for your platform from the GitHub release. The release assets are named cmk.<os>.<arch>, for example cmk.linux.x86-64, cmk.linux.arm64, cmk.darwin.arm64, or cmk.darwin.x86-64.

# Pick the asset that matches your OS and architecture
case "$(uname -s)" in
  Linux)  OS=linux ;;
  Darwin) OS=darwin ;;
esac
case "$(uname -m)" in
  arm64|aarch64) ARCH=arm64 ;;
  x86_64|amd64)  ARCH=x86-64 ;;
esac
 
curl -fsSL "https://github.com/apache/cloudstack-cloudmonkey/releases/download/6.5.0/cmk.${OS}.${ARCH}" -o cmk

Verify the download against the SHA-256 published for that asset on the release page before installing it, and only install on a match:

EXPECTED_SHA256=<paste the SHA-256 published for cmk.${OS}.${ARCH} on the release page>
echo "${EXPECTED_SHA256}  cmk" | sha256sum -c -
 
sudo install -m 0755 cmk /usr/local/bin/cmk   # drop sudo if you already own /usr/local/bin

Point it at Atlas and authenticate

Pass your credentials through environment variables rather than typing them on the command line, so they do not land in your shell history or the process table:

export CLOUDSTACK_API_KEY=...     # your API key
export CLOUDSTACK_SECRET_KEY=...  # your secret key
 
cmk set url https://sky.runatlas.is/client/api
cmk set apikey "$CLOUDSTACK_API_KEY"
cmk set secretkey "$CLOUDSTACK_SECRET_KEY"
cmk set output json
cmk sync

Confirm it works by listing zones:

cmk list zones

You should see a zone named is1.

Next steps

• Creating your first cloud service to launch your first VM and reach it over a public IP.
• The Instances and Guest Networks sections for the compute and networking building blocks.