1 Oracle Compute CLIスタート・ガイド

Oracle Public Cloud Machineは、カスタマイズされたバージョンのOracle Compute Cloud Service (Oracle Compute)コマンドライン・インタフェース(CLI)をサポートします。 Oracle Compute CLIは、Oracle Compute REST APIによって実行できるすべてのアクションをサポートします。 CLIを使用して、様々なOracle Computeオブジェクトを管理します。この項では、Oracle Compute CLIの概要を示します。

トピック:

Oracle Public Cloud MachineのOracle Compute CLIについて

Oracle Compute Cloudサービスは、oracle-compute CLIツールをサポートします。このツールを使用して、インスタンス、ストレージ・ボリューム、オーケストレーションなどのOracle Computeオブジェクトを表示および管理します。

Oracle Compute Cloud Serviceとサポートされるオブジェクトの詳細は、『Oracle Compute Cloud Serviceの使用』のOracle Compute Cloud Serviceの使用のスタート・ガイドに関する項を参照してください。

CLIユーザーのロール

次のCLIユーザー・ロールがサポートされています。

テナント管理者(/tenant_name/username): 指定されたテナントの管理者。テナントの管理機能をすべて実行できます。テナント・ユーザー・ロールを持つユーザーを自分のテナントで作成できます。デフォルトのテナント管理ユーザーは、/tenant_name/administratorです。
テナント・ユーザー(/tenant_name/username): テナント・グループのユーザー。テナント内のVMやリソースを作成および使用できます。

ユーザー・ロールの詳細は、『Oracle Compute Cloud Serviceの使用』のOracle Compute Cloud Serviceのスタート・ガイドに関する項を参照してください。

Oracle Compute CLIを使用するための準備

Oracle Compute CLIツールをインストールする前に、Oracle Public Cloud Machineのインストール時に使用されるAPIサーバーのAPI URLを取得する必要があります。この情報は、Oracle Cloud管理者から入手できます。

このガイドの例では、次のAPIサーバー名を使用します。

api.oc.example.com

環境変数の設定

シェルで環境変数を設定すると、CLIコマンドで値を指定する必要がなくなります。

次の表に、環境変数をリストし、各変数について説明し、bashシェルを使用してホストで変数を設定するためのコマンドを示します。

名前説明コマンド

名前	説明	コマンド
ORACLE_COMPUTE_API	APIエンドポイントのURL この変数が設定されていない場合は、コマンド行で`-a`オプションを指定してAPIエンドポイントを指定する必要があります。	エクスポートORACLE_COMPUTE_API = `API URL` 例: `export ORACLE_COMPUTE_API="https://api.oc.example.com"` 環境変数をログイン・セッション間で維持するには、この行を`.bash_profile`または`.bashrc`ファイルに追加します。
ORACLE_COMPUTE_USER	Oracle Computeのユーザー名。この変数が設定されていない場合、コマンドラインで`-u`オプションを使用してユーザー名を指定する必要があります。	export ORACLE_COMPUTE_USER=`username` 例: `export ORACLE_COMPUTE_USER="mytenant/user"` ログイン・セッションをまたいで環境変数が維持されるようにするには、`.bash_profile`または`.bashrc`ファイルにこのラインを追加します。
ORACLE_COMPUTE_COOKIE	`oracle-compute auth`コマンドから受信される認証トークンの値。ユーザーの認証を参照してください。	export ORACLE_COMPUTE_COOKIE=`auth_token` ORACLE_COMPUTE_USERとORACLE_COMPUTE_COOKIEの両方が指定されている場合、ORACLE_COMPUTE_USERが優先されます。

ORACLE_COMPUTE_API

APIエンドポイントのURL

この変数が設定されていない場合は、コマンド行で-aオプションを指定してAPIエンドポイントを指定する必要があります。

エクスポートORACLE_COMPUTE_API = API URL

例:

export ORACLE_COMPUTE_API="https://api.oc.example.com"

環境変数をログイン・セッション間で維持するには、この行を.bash_profileまたは.bashrcファイルに追加します。

ORACLE_COMPUTE_USER

Oracle Computeのユーザー名。

この変数が設定されていない場合、コマンドラインで-uオプションを使用してユーザー名を指定する必要があります。

export ORACLE_COMPUTE_USER=username

例:

export ORACLE_COMPUTE_USER="mytenant/user"

ログイン・セッションをまたいで環境変数が維持されるようにするには、.bash_profileまたは.bashrcファイルにこのラインを追加します。

ORACLE_COMPUTE_COOKIE

oracle-compute authコマンドから受信される認証トークンの値。ユーザーの認証を参照してください。

export ORACLE_COMPUTE_COOKIE=auth_token

ORACLE_COMPUTE_USERとORACLE_COMPUTE_COOKIEの両方が指定されている場合、ORACLE_COMPUTE_USERが優先されます。

リモート・システムへのOracle Compute CLIのインストール

リモート・クライアント・システムにOracle Compute CLIをインストールするための前提条件を次に示します。

クライアント・システムにOracle Linux 6.3以降が必要です。
クライアント・システムにPython 2.6以降が必要ですが、Python 3.xは必要ありません。
スクリプトにクライアント・システムでのルート権限が必要です。

oracle-computeツールをインストールするには、次の手順を実行します。

前提条件のRPM (python-simplejson、python-dateutil、python-setuptools)をインストールします。
```
sudo yum install python-simplejson python-dateutil python-setuptools
```

インストール・スクリプトを取得し、実行可能にします。

wget http://API_URL/tools/Linux/install-IaaS-CLI.sh
chmod 555 install-IaaS-CLI.sh

インストール・スクリプトを実行します。
```
./install-IaaS-CLI.sh
```
ORACLE_COMPUTE_API変数が構成されていない場合は、./install-IaaS-CLI.sh http://API_URLを使用します。

注意:

ホストが既知のRedHat OSで実行されていなくても、スクリプトの-fオプションを使用するとスクリプトが強制実行されます。

インストール後、次のCLIツールを使用できます。

/usr/bin/oracle-compute