ECL CLI のインストール ¶

前提ソフトウェアのインストール ¶

ECL CLI は OpenStack Client を基に作成されているため、前提となるソフトウェアは OpenStack Client に準拠します。以下の表は、 ECL CLI をインストールするために必要なソフトウェアとその説明の一覧です。

前提ソフトウェア	説明
Python	Python 3.7 以降かつ 3.9 以下をインストールしてください。
pip パッケージ	Linux、 Mac OS X、 Microsoft Windows システムに ECL CLI をインストールする場合、 pip を使用します。 pip により、 Python パッケージを簡単に追加、更新、削除することが可能です。 Linuxでは、お使いのオペレーティングシステム環境に応じた、関連する Python 開発パッケージが必要になります。お使いのシステムのパッケージマネージャーから pip をインストールします。 Ubuntu or Debian `# apt install python3.x-dev python3-pip` Red Hat Enterprise Linux, CentOS, Rocky Linux or Fedora `# yum install python3-devel python3-pip`

ECL CLI のインストール ¶

前提ソフトウェアがインストールされている場合、以下の各コマンドにより ECL CLI をインストールすることができます。

$ pip install eclcli

注釈

Windows の場合、インストール時に以下のようなエラーが発生する場合があります。その場合、エラーの指示に従って Microsoft Visual C++ をインストール後、再試行してください。

error: Microsoft Visual C++ 14.0 or greater is required. Get it with "Microsoft C++ Build Tools": https://visualstudio.microsoft.com/visual-cpp-build-tools/

環境変数の設定 ¶

インストールした ECL CLI を用いて各サービスをコマンドラインから操作する場合、ユーザ名やパスワード等の認証情報を環境変数に設定する必要があります。コマンドのオプションで認証情報を指定することもできますが、環境変数とその設定値を記述した環境ファイルを作成する方法が簡単です。環境変数の設定手順は以下の通りです。

1. clouds.yaml という名前のファイルを ~/.config/ecl に配置してください。 <テナント ID> <API 鍵> <API 秘密鍵> <リージョン> については、こちらのページを参考に取得してください。 OS_AUTH_URL はトークンを取得するための認証用 URL になります。

clouds.yaml の作成 ( Linux / Unix の場合 )¶

$ mkdir -p ~/.config/ecl/
$ touch ~/.config/ecl/clouds.yaml

clouds.yaml の内容 ( Linux / Unix の場合 )¶

clouds:
  jp1: # この部分はどのような文字列でもかまいません。下記設定を用いる場合 --os-cloud jp1 と指定します。
    auth:
      auth_url: https://keystone-<リージョン>-ecl.api.ntt.com/v3/
      tenant_id: <テナント ID>
      username: <API 鍵>
      password: <API 秘密鍵>
    project_domain_id: default
    user_domain_id: default
  jp2: # 下記設定を用いる場合 --os-cloud jp2 と指定します。
    auth:
      auth_url: https://keystone-<リージョン>-ecl.api.ntt.com/v3/
      tenant_id: <テナント ID>
      username: <API 鍵>
      password: <API 秘密鍵>
    project_domain_id: default
    user_domain_id: default
  us1:
    ...

2. ecl コマンド実行時に --os-cloud オプションを指定してください。上記のような clouds.yaml を作成した場合、

コマンドの実行 ( Linux / Unix の場合 )¶

ecl --os-cloud jp1

のように --os-cloud を指定することで、yaml に記載されているテナントに対してコマンドを実行します。

---

また、以下の手順でもユーザ名やパスワード等の認証情報を環境変数に設定できます。

1. テキストエディタで以下の様な環境設定用ファイルを作成してください。 <テナント ID> <API 鍵> <API 秘密鍵> <リージョン> については、こちらのページを参考に取得してください。 OS_AUTH_URL はトークンを取得するための認証用 URL になります。

eclrc.sh ( Linux / Unix の場合 )¶

export OS_TENANT_ID=<テナント ID>
export OS_USERNAME=<API 鍵>
export OS_PASSWORD=<API 秘密鍵>
export OS_AUTH_URL=https://keystone-<リージョン>-ecl.api.ntt.com/v3/
export OS_USER_DOMAIN_ID=default
export OS_PROJECT_DOMAIN_ID=default

eclrc.bat ( Windows の場合 )¶

@echo off
setx OS_TENANT_ID <テナント ID>
setx OS_USERNAME <API 鍵>
setx OS_PASSWORD <API 秘密鍵>
setx OS_AUTH_URL https://keystone-<リージョン>-ecl.api.ntt.com/v3/
setx OS_USER_DOMAIN_ID default
setx OS_PROJECT_DOMAIN_ID default

作成した環境ファイルをコマンドラインで読み込んでください。

環境変数の設定 ( Linux / Unix の場合 )¶

$ source eclrc.sh

環境変数の設定 ( Windows の場合 )¶

> eclrc.bat

注釈

Windows の場合は、コマンドプロンプトを立ち上げ直すことで環境変数が反映されます。

ECL CLI のインストール¶

前提ソフトウェアのインストール¶