プライベート・エンドポイントのインストールおよび使用
IBM Cloud コマンド・ライン・インターフェース (CLI) を使用している状況でデータに対する制御とセキュリティーを向上させるには、IBM Cloud エンドポイントへの接続にプライベート経路を使用するという方法があります。 インターネットからは、プライベート・ルートにアクセスすることも到達することもできません。 IBM Cloud のプライベート・エンドポイント機能を使用することで、パブリック・ネットワークの脅威からデータを保護し、プライベート・ネットワークを論理的に拡張できます。
CLI は、IBM Cloud® プラットフォームによって提供されているプライベート・エンドポイントのサポートを使用します。 コア CLI で使用されているプラットフォーム・サービスは、プライベート・エンドポイントのサポートを提供しています。
開始前に
まず、アカウントで仮想ルーティングとフォワーディングを有効にし、 IBM Cloud プライベート・サービス・エンドポイントの使用を有効にします。 プライベート接続オプションをサポートするためにアカウントをセットアップする方法について詳しくは、VRF エンドポイントおよびサービス・エンドポイントの有効化を参照してください。 VRF の有効化に加えて、 ibmcloud
のプライベート・ネットワーク上で作業する必要があります。 詳しくは、IBM Cloud VPN への接続方法を参照してください。
IBM Cloud でのプライベート接続について詳しくは、サービス・エンドポイントを使用したサービスへの安全なアクセスを参照してください。
シェルからのインストール
ご使用の OS 用の最新の CLI をシェルから手動でインストールするには、対象 OS 向けの以下のコマンドを使用します。
root 権限が使用される可能性があるためシェルからはインストールしたくない場合、インストーラーをダウンロードして実行できます。
-
Mac の場合、以下のコマンドをコマンド・ラインにコピー・アンド・ペーストして実行します。
curl -fsSL https://ibm-cloud-cli-installer-scripts.s3.private.us.cloud-object-storage.appdomain.cloud/osx_private | sh
-
Mac の場合、 IBM Cloud Virtual Private Cloud から、以下のコマンドをコピーしてコマンド・ラインに貼り付け、実行します。
curl -fsSL https://ibm-cloud-cli-installer-scripts.s3.direct.us.cloud-object-storage.appdomain.cloud/osx_vpc | sh
-
Linux™ の場合、以下のコマンドをコマンド・ラインにコピー・アンド・ペーストして実行します。
curl -fsSL https://ibm-cloud-cli-installer-scripts.s3.private.us.cloud-object-storage.appdomain.cloud/linux_private | sh
-
Linux の場合、 IBM Cloud Virtual Private Cloud から、以下のコマンドをコピーしてコマンド・ラインに貼り付け、実行します。
curl -fsSL https://ibm-cloud-cli-installer-scripts.s3.direct.us.cloud-object-storage.appdomain.cloud/linux_vpc | sh
-
Windows™の場合、以下のコマンドを Windows™ PowerShell コマンド・プロンプトにコピー・アンド・ペーストして実行します。
iex (New-Object Net.WebClient).DownloadString('https://ibm-cloud-cli-installer-scripts.s3.private.us.cloud-object-storage.appdomain.cloud/powershell_private')
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
-
Windows™の場合、 IBM Cloud Virtual Private Cloud から、以下のコマンドを Windows™ PowerShell コマンド・プロンプトにコピー・アンド・ペーストして実行します。
iex (New-Object Net.WebClient).DownloadString('https://ibm-cloud-cli-installer-scripts.s3.direct.us.cloud-object-storage.appdomain.cloud/powershell_vpc')
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 をインストールするには、以下の手順を実行します。
-
ダウンロードを開始するため、ご使用の OS のインストーラーを選択します。 サポートされているオペレーティング・システムは、macOS X 64 ビット、Windows™ 64 ビット、Linux™ x86 64 ビット、Linux™ LE 64 ビット (ppc64le)、および System/390 Linux™ です。
-
インストーラーを次のように実行します。
- Mac および Windows™ の場合、インストーラーを実行します。
- Linux™ の場合、パッケージを解凍し、
install
スクリプトを実行します。
インストーラー:
-
CLI を使用して IBM Cloud にログインします。
ibmcloud login
これで、IBM Cloud リソースを管理する準備ができました。
ibmcloud help
を実行し、コマンド説明を表示します。フェデレーテッド ID を使用している場合には、ワンタイム・パスコードまたは API キーを使用してログインします。
プライベート・エンドポイント用のパッケージの以前のリリースからのインストール
これらのパッケージを以前のリリースからインストールする場合、次のテンプレートに従って、ダウンロードするパッケージのプライベート・エンドポイント・リンクを作成します。release_tag 部分は、ダウンロードするリリース・バージョンに置き換えてください。
以前のリリースを表示するには、公式の ibm-cloud-cli-releases GitHub リポジトリーにアクセスします。
Mac OS X 64 ビット
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/IBM_Cloud_CLI_<release_tag>.pkg
Windows™ 64 ビット
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/IBM_Cloud_CLI_<release_tag>_amd64.exe
Windows™ 32 ビット
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/IBM_Cloud_CLI_<release_tag>_386.exe
Linux™ 64 ビット
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/IBM_Cloud_CLI_<release_tag>_amd64.tar.gz
Linux™ 32 ビット
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/IBM_Cloud_CLI_<release_tag>_386.tar.gz
PowerLinux™ 64 ビット
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/IBM_Cloud_CLI_<release_tag>_ppc64le.tar.gz
System/390 Linux™ 64 ビット
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/IBM_Cloud_CLI_<release_tag>_s390x.tar.gz
カスタム・ディレクトリーへのインストール
インストーラーまたはシェル・スクリプトを使用して IBM Cloud CLI をインストールする場合、システム・ディレクトリーにインストールされます。 別のディレクトリーを指定する場合は、以下の手順を実行します。
IBM Cloud CLI をカスタム・ディレクトリーにインストールすると、ibmcloud update
コマンドを使用して CLI を更新できません。
-
ご使用のプラットフォームに合ったバイナリーを選択して、ダウンロードを開始します。 サポートされるプラットフォームは、macOS、linux32、linux64、ppc64le、win32、win64、および s390x です。
-
指定したディレクトリーにパッケージを解凍します。
以下の解凍済みコンテンツを確認できます。
Linux™ および Mac の場合:
IBM_Cloud_CLI ├── LICENSE ├── NOTICE ├── autocomplete │ ├── bash_autocomplete │ └── zsh_autocomplete └── ibmcloud
Windows™ の場合:
IBM_Cloud_CLI ├── LICENSE ├── NOTICE └── ibmcloud.exe
-
PATH
環境変数に追加し、shell オートコンプリート機能を有効にします。{YOUR_DIRECTORY}/IBM_CLOUD_CLI
をPATH
環境変数に追加します。
バイナリー・ファイル
- Mac OS X 64 ビット
- Windows™ 64 ビット
- Windows™ 32 ビット
- Linux™ 64 ビット
- Linux™ 64 ビット ARM
- Linux™ 32 ビット
- PowerLinux™ 64 ビット
- System/390 Linux™ 64 ビット
バイナリーを以前のリリースからインストールする場合、次のテンプレートに従って、ダウンロードするバイナリーのプライベート・エンドポイント・リンクを作成します。release_tag 部分は、ダウンロードするリリース・バージョンに置き換えてください。
以前のリリースを表示するには、公式の ibm-cloud-cli-releases Github リポジトリーにアクセスします。
Mac OS X 64 ビット
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/binaries/IBM_Cloud_CLI_<release_tag>_macos.tgz
Windows 64-bit
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/binaries/IBM_Cloud_CLI_<release_tag>_windows_amd64.zip
Windows 32-bit
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/binaries/IBM_Cloud_CLI_<release_tag>_windows_386.zip
Linux 64-bit
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/binaries/IBM_Cloud_CLI_<release_tag>_linux_amd64.tgz
Linux 32-bit
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/binaries/IBM_Cloud_CLI_<release_tag>_linux_386.tgz
Power Linux 64 ビット
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/binaries/IBM_Cloud_CLI_<release_tag>_linux_ppc64le.tgz
System/390 Linux 64 ビット
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/binaries/IBM_Cloud_CLI_<release_tag>_linux_s390x.tgz
CLI でのプライベート・エンドポイントの使用
CLI でプライベート・エンドポイントを使用する方法、およびプライベート・エンドポイントをサポートするコマンドのリストについては、プライベート・エンドポイントを使用した CLI へのログインを参照してください。