安裝獨立式 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 金鑰進行登入

從 Shell 安裝

若要從 Shell 為您的 OS 手動安裝最新 CLI,請針對您的 OS 使用下列指令:

如果您不想從 shell 安裝,因為它可能使用 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
    

安裝至自訂目錄

當您使用安裝程式或 Shell Script 來安裝 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 版本儲存庫