cs

README

---

title: cs - the Exoscale companion for CloudStack

cs: Command-Line Interface for CloudStack

Like the Pythonic cs but in Go.

Installation

Grab it from the release section.

or build it yourself, it requires somes dependencies though to be pulled using dep.

Configuration

Create a config file cloudstack.ini or $HOME/.cloudstack.ini.

; Default region
[cloudstack]

; Exoscale credential
endpoint = https://api.exoscale.ch/compute
key = EXO...
secret = ...

theme = fruity


; Another region
[cloudstack:production]

endpoint = https://api.exoscale.ch/compute
key = EXO...
secret = ...

theme = vim


; global config for themes
[exoscale]
; Pygments theme, see: https://xyproto.github.io/splash/docs/
; dark
theme = monokai
; light
theme = tango
; no colors (only boldness is allowed)
theme = nocolors

Themes

Thanks to Alec Thomas' chroma, it supports many themes for your output:

• https://xyproto.github.io/splash/docs/
• https://help.farbox.com/pygments.html

Usage

Some of the flags around a command.

$ cs (-h | --help)              global help
$ cs <command> (-h | --help)    help of a specific command
$ cs <command> (-d | --debug)   show the command and its expected output
$ cs <command> (-D | --dry-run) show the signed command
$ cs (-r | --region) <region>   specify a different region, default `cloudstack`

Documentation

Overview

cs

Inspired by its older brother cs (https://pypi.org/project/cs) a convenient and flexible client for CloudStack tailored for Exoscale infrastructure.

Configuration

The best way is to have a cloudstack.ini file somewhere.

[exoscale]
theme = nocolors

[cloudstack]
endpoint = "https://api.exoscale.ch/compute"
key = "EXO..."
secret = "..."

then it's only a matter of following the help.