OpenStack コマンドラインクライアントのインストール

OpenStack コマンドラインクライアントのインストール

前提ソフトウェアと各 OpenStack クライアント用の Python パッケージをインストールします。

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

多くの Linux ディストリビューションには、コマンドラインクライアントのパッケージがあります。必要となるソフトウェアと合わせて、パッケージから直接インストールできます。詳細は Installing_from_packages を参照してください。

コマンドラインパッケージのソースパッケージをインストールする必要がある場合、コマンドラインクライアントを実行するために必要となるソフトウェアの一覧が以下の表にまとめられています。必要に応じてインストール手順が書かれています。

OpenStack コマンドラインクライアントの前提条件
前提 説明
Python 2.7 以降 Python 2.7、3.4、3.5 をサポートします。
setuptools パッケージ

Mac OS X に標準でインストールされます。

Linux ディストリビューションの多くは、setuptools を簡単にインストールするためのパッケージを提供しています。お使いのパッケージマネージャーで setuptools を検索してインストレーションパッケージを見つけてください。見つからない場合は、 Python Setuptools から直接 setuptools パッケージをダウンロードしてください。

Microsoft Windows で setuptools をインストールする推奨の方法は、 Python Setuptools のウェブサイトで提供されているドキュメントのとおりに行うことです。

もう 1 つの方法は、 Christoph Gohlke さんが管理している非公式バイナリーインストーラー を使用する方法です。

pip パッケージ

Linux、Mac OS X、Microsoft Windows システムにクライアントをインストールする場合、pip を使用します。これは使いやすく、 Python Package Index からきちんと最新版のクライアントを取得します。また、後から更新や削除することもできます。

インストール中にソースファイルをコンパイルするため、お使いのオペレーティングシステム環境に応じた、関連する Python 開発パッケージが必要になります。

Option 1: Install pip using get-pip.py

To install pip, securely download get-pip.py. Then run the following:

# python get-pip.py

For more details visit install pip.

Option 2: Install pip through the package manager for your system

Ubuntu または Debian

# apt install python-dev python-pip

Tempest の場合など、インストールするパッケージに応じて、依存関係によりオペレーティングシステムごとの追加パッケージが必要になるかもしれないことに注意してください。

Red Hat Enterprise Linux または CentOS

yum を使用してインストールできるパッケージがあります。

# yum install python-devel python-pip

Red Hat Enterprise Linux の場合、このコマンドは OpenStack のリポジトリーが有効化されていると仮定します。詳細は Installation Tutorial for Red Hat Enterprise Linux and CentOS を参照してください。

Installing_from_packages に記載されているように、yum を使用してインストールできるクライアントパッケージもあります。

Fedora

dnf を使用してインストールできるパッケージがあります。

# dnf install python-devel python-pip

SUSE Linux Enterprise Server

Open Build Service でパッケージが公開されており、これを使うと YaST や zypper を使ってパッケージをインストールできます。

まず、Installation Tutorial に記載されているとおり、Open Build Service のリポジトリーを追加します。

pip をインストールして、インストールするクライアントを管理します。

# zypper install python-devel python-pip

Installing_from_packages に記載されているように、zypper を使用してインストールできるクライアントパッケージもあります。

openSUSE

pip をインストールして、インストールするクライアントを管理することができます。

# zypper install python-devel python-pip

Installing_from_packages に記載されているように、zypper を使用してインストールできるクライアントパッケージもあります。

Another option for Microsoft Windows is to use the unofficial binary installer provided by Christoph Gohlke.

OpenStack client のインストール

以下の例は、pip を用いて OpenStack client をインストールするコマンドを示します。

# pip install python-openstackclient

以下の個別クライアントは、共通クライアントに置き換えられ、非推奨になりました。これらのクライアントをすべてインストールして学習する代わりに、OpenStack クライアントをインストールして使用することを推奨します。OpenStack クライアントにおいて十分にカバーされていないため、各プロジェクトのクライアントをインストールする必要があるかもしれません。各プロジェクトのクライアントをインストールする必要がある場合、以下の一覧を使用して、この pip installPROJECT の名前を置き換えてください。

# pip install python-PROJECTclient
  • barbican - Key Manager Service API
  • ceilometer - Telemetry API
  • cinder - Block Storage API および拡張
  • cloudkitty - Rating service API
  • designate - DNS service API
  • glance - Image service API
  • gnocchi - Telemetry API v3
  • heat - Orchestration API
  • magnum - コンテナー基盤管理サービス API
  • manila - Shared file systems API
  • mistral - Workflow service API
  • monasca - Monitoring API
  • murano - Application catalog API
  • neutron - Networking API
  • nova - Compute API および拡張
  • senlin - Clustering service API
  • swift - Object Storage API
  • trove - Database service API

pip を用いたインストール

Linux、Mac OS X、Microsoft Windows システムに OpenStack クライアントをインストールする場合、pip を使用します。これは使いやすく、きちんと最新版のクライアントを Python Package Index から取得します。また、パッケージを更新したり削除したりできます。

以下のコマンドを使用して、各クライアントをそれぞれインストールします。

  • Mac OS X または Linux の場合:

    # pip install python-PROJECTclient
    
  • Microsoft Windows の場合:

    C:\>pip install python-PROJECTclient
    

パッケージからのインストール

RDO、openSUSE、SUSE Linux Enterprise、Debian、Ubuntu は、pip なしで利用できるクライアントパッケージがあります。

注釈

パッケージのバージョンは、古いクライアントがインストールされる可能性があります。必ず最新版のクライアントをインストールしたい場合、pip を用いてクライアントをインストール する必要があるかもしれません。

  • Red Hat Enterprise Linux や CentOS の場合、yum を使用してクライアントのパッケージをインストールできます。

    # yum install python-PROJECTclient
    

    このコマンドは、お使いのディストリビューションの OpenStack リポジトリーが有効化されていると仮定します。詳細は Installation Tutorial for Red Hat Enterprise Linux and CentOS を参照してください。

  • Ubuntu と Debian の場合、apt-get を使用してパッケージバージョンからクライアントをインストールします。

    # apt-get install python-PROJECTclient
    
  • openSUSE の場合、zypper を使用して、ディストリビューションのパッケージサービスからクライアントをインストールします。

    # zypper install python-PROJECTclient
    
  • SUSE Linux Enterprise Server の場合、zypper を使用してパッケージバージョンからクライアントをインストールします。

    # zypper install python-PROJECTclient
    

    このコマンドは、お使いのディストリビューションの OpenStack リポジトリーが有効化されていると仮定します。詳細は Installation Tutorial for openSUSE and SUSE Linux Enterprise を参照してください。

クライアントの更新と削除

pip を用いてクライアントをアップグレードする場合、pip install コマンドに --upgrade オプションを追加します。

# pip install --upgrade python-PROJECTclient

pip を用いてクライアントを削除する場合、 pip uninstall コマンドを実行します。

# pip uninstall python-PROJECTclient

次の手順

クライアントコマンドを実行する前に、環境変数を設定するために、PROJECT-openrc.sh ファイルを作成して読み込む必要があります。詳細は OpenStack RC ファイルを用いた環境変数の設定 を参照してください。

Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.