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

IBM Cloud® コマンド・ライン・インターフェースには、IBM Cloud リソースを管理するためのコマンドが備わっています。スタンドアロン IBM Cloud CLIをインストールすると、推奨プラグインやツールは一切含まれず、CLI本体のみが提供される。

IBM Cloud 用のアプリケーションを開発するために、最新の IBM Cloud CLI とその他の推奨プラグインおよびツールの両方をインストールしたい場合は、「 Getting started with IBM Cloud CLI 」および「 Extending IBM Cloud CLI with plug-ins 」を参照してください。

開始前に

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

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

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

ブラウザーを使用して公式 ibm-cloud-cli-releases GitHub リポジトリーにアクセスし、ご使用の OS のインストーラーを選択してダウンロードを開始します。以下のオペレーティング・システムに対応しています： macOS X 64ビット、Windows™ 64ビット、 Linux™ x86 64ビット、 Linux™ LE 64ビット（ ppc64le ）。
インストーラーを次のように実行します。
- Mac および Windows™ の場合、インストーラーを実行します。
- Linux™ の場合、パッケージを解凍し、install スクリプトを実行します。
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 を更新できません。

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

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

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

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

PATH 環境変数に追加し、shell オートコンプリート機能を有効にします。
- {YOUR_DIRECTORY}/IBM_CLOUD_CLI を PATH 環境変数に追加します。
- shell オートコンプリート機能サポート (Mac および Linux™ のみ) については、IBM Cloud CLI の 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 releases リポジトリを購読してください。