安裝獨立式 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 版本儲存庫。