Enterprise Cloud CLI (a.k.a eclcli) is an OpenStackClient based command-line client for NTT DOCOMO BUSINESS' 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.
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 eclcliFor experienced users we suggest using pyenv with pyenv-virtualenv plugin:
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.
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$ ecl command list # Returns all available commands $ ecl baremetal server list # Returns list of baremetal servers $ ecl help baremetal # Returns help for any command
Please find more usage documentation on official site.
ECL2.0 users can raise requests via NTT DOCOMO BUSINESS' ticket portal.
Please contribute using Github Flow Create a branch, add commits, and open a pull request.
- Apache 2.0