egcli

a command line utility for interacting with Entanglement

this is very work in progress, and is currently mostly used for API testing. All subcommands return only JSON.

Usage

You will need an API key, which will be in the format of a URI starting with rhyzome://. This can be generated via the Entanglement console under IAM -> API Keys. Create a file at ~/.config/entanglement/cli.yaml looking something like this:

auth_uri:rhyzome://...

Then verify it works with egcli whoami

eg is an Entanglement Garden cli client
Usage:
 eg [command]
Available Commands:
 completion Generate the autocompletion script for the specified shell
 dev perform debug or development-related tasks
 help Help about any command
 instances Manage virtual machines
 networks Manage virtual networks
 version print the egcli version. may eventually include server version
 whoami Print information about the auth token
Flags:
 -h, --help help for eg
Use "eg [command] --help" for more information about a command.

some of the shortcomings

• Obviously the auth process sucks (see above). It would be nice to be able to do eg login
• Most commands return JSON. All commands should have multiple output formats including a human readable one (which will likely be a table for most subcommands)