egcli

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)