Skip to main content

CLI for Enterprise Cloud 2.0

Project description

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.

Contributing

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

License

  • Apache 2.0

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

eclcli-4.6.0.tar.gz (417.3 kB view details)

Uploaded Source

Built Distribution

eclcli-4.6.0-py3-none-any.whl (621.1 kB view details)

Uploaded Python 3

File details

Details for the file eclcli-4.6.0.tar.gz.

File metadata

  • Download URL: eclcli-4.6.0.tar.gz
  • Upload date:
  • Size: 417.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.21

File hashes

Hashes for eclcli-4.6.0.tar.gz
Algorithm Hash digest
SHA256 71d7223d86e60874618c999e9c6281b1d601a5887ece32f3dcd399cf5576a5f9
MD5 6b8f9f0323f698afe75a91fd7dffd17d
BLAKE2b-256 bd369964a5a95ff80a02a1366960107808718b093b835f965a641f7b7527731d

See more details on using hashes here.

File details

Details for the file eclcli-4.6.0-py3-none-any.whl.

File metadata

  • Download URL: eclcli-4.6.0-py3-none-any.whl
  • Upload date:
  • Size: 621.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.21

File hashes

Hashes for eclcli-4.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 67394533193600ba576dd967a695de8de8e2d26ba066816ea248c38c13b05505
MD5 305ef94612cc7d84ec3fa9e34c89d5c7
BLAKE2b-256 11f95aa1f53e0acf06fd0b567f0a14919c10e45e6f5de6937f29e91e29ea2f6e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page