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 をプラグインで拡張する を参照してください。

開始前に

IBM Cloud 専用環境で、32ビット版や最新版以外の旧バージョンを使う必要がある場合は、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 リリースリポジトリを購読してください。