IBM Cloud Docs
プライベート・エンドポイントのインストールおよび使用

プライベート・エンドポイントのインストールおよび使用

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 をインストールするには、以下の手順を実行します。

  1. ダウンロードを開始するため、ご使用の OS のインストーラーを選択します。 サポートされているオペレーティング・システムは、macOS X 64 ビット、Windows™ 64 ビット、Linux™ x86 64 ビット、Linux™ LE 64 ビット (ppc64le)、および System/390 Linux™ です。

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

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

    インストーラー:

  3. 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 を更新できません。

  1. ご使用のプラットフォームに合ったバイナリーを選択して、ダウンロードを開始します。 サポートされるプラットフォームは、macOS、linux32、linux64、ppc64le、win32、win64、および s390x です。

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

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

    Linux™ および Mac の場合:

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

    Windows™ の場合:

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

    • {YOUR_DIRECTORY}/IBM_CLOUD_CLIPATH 環境変数に追加します。

バイナリー・ファイル

バイナリーを以前のリリースからインストールする場合、次のテンプレートに従って、ダウンロードするバイナリーのプライベート・エンドポイント・リンクを作成します。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 へのログインを参照してください。