IBM Cloud Docs
スタンドアロン IBM Cloud CLI のインストール

スタンドアロン IBM Cloud CLI のインストール

IBM Cloud® コマンド・ライン・インターフェースには、IBM Cloud リソースを管理するためのコマンドが備わっています。 スタンドアロン IBM Cloud CLI をインストールすると、推奨されているプラグインまたはツールをまったく含まない CLI のみを取得します。

最新の IBM Cloud CLI と、 IBM Cloud用のアプリケーションを開発するための他の推奨プラグインおよびツールの両方をインストールする場合は、 IBM Cloud CLI での作業の開始 および プラグインを使用した IBM Cloud CLI の拡張 を参照してください。

開始前に

32 ビット・バージョン、または IBM Cloud Dedicated 環境用の最新バージョン以外の旧バージョンを使用する必要がある場合は、 IBM Cloud CLI リリースを参照してください。

インストーラーを使用したインストール

最新のスタンドアロン IBM Cloud CLI をインストールするには、以下の手順を実行します。

  1. ブラウザーを使用して公式 ibm-cloud-cli-releases GitHub リポジトリーにアクセスし、ご使用の OS のインストーラーを選択してダウンロードを開始します。 サポートされているオペレーティング・システムは、 macOS X 64 ビット、Windows™ 64 ビット、 Linux™ x86 64 ビット、および Linux™ LE 64 ビット (ppc64le) です。

  2. インストーラーを次のように実行します。

    • Mac および Windows™ の場合、インストーラーを実行します。
    • Linux™ の場合、パッケージを解凍し、install スクリプトを実行します。
  3. IBM Cloudにログインします:

    ibmcloud login
    

    これで、IBM Cloud リソースを管理する準備ができました。 ibmcloud help を実行し、コマンド説明を表示します。

    フェデレーテッド ID を使用している場合には、ワンタイム・パスコードまたは API キーを使用してログインします。

シェルからのインストール

ご使用の OS 用の最新の CLI をシェルから手動でインストールするには、対象 OS 向けの以下のコマンドを使用します。

root 権限を使用する可能性があるためシェルからインストールしたくない場合、インストーラーをダウンロードして実行できます。

  • Mac の場合、以下のコマンドを端末にコピー・アンド・ペーストして実行します。

    curl -fsSL https://clis.cloud.ibm.com/install/osx | sh
    
  • Linux™ の場合、以下のコマンドをコピーして端末に貼り付け、実行します。

    curl -fsSL https://clis.cloud.ibm.com/install/linux | sh
    
  • Windows™の場合、以下のコマンドをコピーして Windows™ PowerShell 5 端末コンソールに貼り付け、実行します。

    iex (New-Object Net.WebClient).DownloadString('https://clis.cloud.ibm.com/install/powershell')
    

    The underlying connection was closed: An unexpected error occurred on a send などのエラーが出る場合、.Net Framework 4.5 以降がインストールされていることを確認してください。 また、以下のコマンドを実行して、TLS 1.2 プロトコルを有効にしてください。

    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
    

カスタム・ディレクトリーへのインストール

インストーラーまたはシェル・スクリプトを使用して IBM Cloud CLI をインストールする場合、システム・ディレクトリーにインストールされます。 別のディレクトリーを指定する場合は、以下の手順を実行します。

IBM Cloud CLI をカスタム・ディレクトリーにインストールすると、ibmcloud update コマンドを使用して CLI を更新できません。

  1. ブラウザーを使用して公式 ibm-cloud-cli-releases GitHub リポジトリーにアクセスし、ご使用のプラットフォームに合ったバイナリーを選択してダウンロードを開始します。 サポートされるプラットフォームは、macOS、linux32、linux64、ppc64le、win32、および win64 です。

  2. 指定したディレクトリーにパッケージを解凍します。

    以下の解凍済みコンテンツを確認できます。

    Linux™ および Mac の場合:

    IBM_Cloud_CLI
    ├── LICENSE
    ├── NOTICE
    ├── autocomplete
    │   ├── bash_autocomplete
    │   └── zsh_autocomplete
    ├── ibmcloud
    └── ibmcloud-analytics
    

    Windows™ の場合:

    IBM_Cloud_CLI
    ├── LICENSE
    ├── NOTICE
    ├── ibmcloud-analytics.exe
    └── ibmcloud.exe
    
  3. PATH 環境変数に追加し、shell オートコンプリート機能を有効にします。

IBM Cloud CLI の更新

最新バージョンの CLI を使用する必要があります。 最新バージョンを使用していない場合、以下のコマンドを実行して CLI を更新します。

ibmcloud update

使用している IBM Cloud CLI バージョンを判別するには、以下のコマンドを実行します。

ibmcloud -v

現行リリースを実行している場合には、以下の出力が表示されます。

Checking for updates...
No update required. Your CLI is already up-to-date.

新しい IBM Cloud CLI リリースに関する通知を受け取るには、 IBM Cloud CLI リリース・リポジトリーにサブスクライブします。