/eclcli

Enterprise Cloud CLI

Primary LanguagePythonApache License 2.0Apache-2.0

Enterprise Cloud CLI

Enterprise Cloud CLI (a.k.a eclcli) is an OpenStackClient based command-line client for NTT Communications' Enterprise Cloud 2.0 that brings the command set for Baremetal, Compute, SSS, Image, Network, Block Storage and various other APIs together in a single shell with a uniform command structure.

The primary goal is to provide a unified user experience for various services provide in ECL2.0 through a uniform command structure.

Getting Started

Enterprise Cloud CLI can be installed from PyPI using pip.

$ pip install eclcli

Yet it is strongly advised to use virtualenv to avoid conflicts with system packages, in short:

$ virtualenv .venv
$ source .venv/bin/activate
$ pip install --upgrade eclcli

For experienced users we suggest using pyenv with pyenv-virtualenv plugin:

Configuration

Before you are able to use CLI you must configure it.

The CLI is configured via command-line, environment variables and ~/.config/ecl/clouds.yaml file.

Authentication using username/password is most commonly used.

$ export OS_USERNAME=<username>
$ export OS_PASSWORD=<password>
$ export OS_TENANT_ID=<tenant_id>
$ export OS_AUTH_URL=<auth_url>
$ export OS_PROJECT_DOMAIN_ID=default
$ export OS_USER_DOMAIN_ID=default

In certain cases it may be more convenient to use file based configuration using file ~/.config/ecl/clouds.yaml.

For more information see ECL tutorial page. Notice, though, that you may need to use --os-cloud option parameter to specify which credentials to use from the file.

Listing command references

There are a few variants on getting help. A list of global options are supported with --help.

$ ecl --help

There is also a help command that can be used to get help text for a specific command.

$ ecl help baremetal server create

Usage

$ ecl command list
# Returns all available commands

$ ecl baremetal server list
# Returns list of baremetal servers

$ ecl help baremetal
# Returns help for any command

Documentation

Please find more usage documentation on official site.

Support

ECL2.0 users can raise requests via NTT Communications' ticket portal.

Contact

Contributing

Please contribute using Github Flow Create a branch, add commits, and open a pull request.

License

  • Apache 2.0